From 5465475a70530926fe734d088cc87949e54d14e7 Mon Sep 17 00:00:00 2001
From: Eric Arellano <14852634+Eric-Arellano@users.noreply.github.com>
Date: Thu, 15 Feb 2024 15:30:01 -0500
Subject: [PATCH 1/4] Make 0.46 historical
---
docs/api/qiskit/0.46/_package.json | 4 +
docs/api/qiskit/0.46/_toc.json | 3633 +++++++++++++++
docs/api/qiskit/0.46/algorithms.md | 279 ++
docs/api/qiskit/0.46/assembler.md | 186 +
docs/api/qiskit/0.46/circuit.md | 357 ++
docs/api/qiskit/0.46/circuit_classical.md | 974 ++++
docs/api/qiskit/0.46/circuit_library.md | 1292 ++++++
docs/api/qiskit/0.46/circuit_singleton.md | 210 +
docs/api/qiskit/0.46/classicalfunction.md | 84 +
docs/api/qiskit/0.46/compiler.md | 310 ++
docs/api/qiskit/0.46/converters.md | 310 ++
docs/api/qiskit/0.46/dagcircuit.md | 54 +
docs/api/qiskit/0.46/exceptions.md | 72 +
docs/api/qiskit/0.46/execute.md | 183 +
docs/api/qiskit/0.46/extensions.md | 50 +
docs/api/qiskit/0.46/index.md | 64 +
docs/api/qiskit/0.46/opflow.md | 214 +
docs/api/qiskit/0.46/passmanager.md | 173 +
docs/api/qiskit/0.46/primitives.md | 146 +
docs/api/qiskit/0.46/providers.md | 509 +++
.../qiskit/0.46/providers_basic_provider.md | 52 +
docs/api/qiskit/0.46/providers_basicaer.md | 58 +
.../qiskit/0.46/providers_fake_provider.md | 265 ++
docs/api/qiskit/0.46/providers_models.md | 39 +
docs/api/qiskit/0.46/pulse.md | 2798 ++++++++++++
docs/api/qiskit/0.46/qasm.md | 54 +
docs/api/qiskit/0.46/qasm2.md | 539 +++
docs/api/qiskit/0.46/qasm3.md | 299 ++
.../0.46/qiskit.algorithms.AlgorithmJob.md | 168 +
.../qiskit.algorithms.AmplificationProblem.md | 93 +
.../qiskit.algorithms.AmplitudeAmplifier.md | 40 +
.../qiskit.algorithms.AmplitudeEstimation.md | 209 +
...it.algorithms.AmplitudeEstimationResult.md | 124 +
.../qiskit.algorithms.AmplitudeEstimator.md | 36 +
...kit.algorithms.AmplitudeEstimatorResult.md | 82 +
.../0.46/qiskit.algorithms.Eigensolver.md | 65 +
.../qiskit.algorithms.EigensolverResult.md | 60 +
.../qiskit.algorithms.EstimationProblem.md | 116 +
.../qiskit.algorithms.EvolutionProblem.md | 62 +
.../0.46/qiskit.algorithms.EvolutionResult.md | 43 +
...it.algorithms.FasterAmplitudeEstimation.md | 129 +
...orithms.FasterAmplitudeEstimationResult.md | 106 +
.../qiskit/0.46/qiskit.algorithms.Grover.md | 196 +
.../0.46/qiskit.algorithms.GroverResult.md | 86 +
...t.algorithms.HamiltonianPhaseEstimation.md | 90 +
...rithms.HamiltonianPhaseEstimationResult.md | 92 +
.../qiskit.algorithms.ImaginaryEvolver.md | 48 +
.../qiskit.algorithms.ImaginaryTimeEvolver.md | 42 +
...algorithms.IterativeAmplitudeEstimation.md | 141 +
...thms.IterativeAmplitudeEstimationResult.md | 130 +
...kit.algorithms.IterativePhaseEstimation.md | 92 +
...ms.MaximumLikelihoodAmplitudeEstimation.md | 175 +
...imumLikelihoodAmplitudeEstimationResult.md | 112 +
.../qiskit.algorithms.MinimumEigensolver.md | 67 +
...kit.algorithms.MinimumEigensolverResult.md | 60 +
.../qiskit.algorithms.NumPyEigensolver.md | 88 +
...skit.algorithms.NumPyMinimumEigensolver.md | 77 +
.../api/qiskit/0.46/qiskit.algorithms.PVQD.md | 232 +
.../0.46/qiskit.algorithms.PVQDResult.md | 42 +
.../0.46/qiskit.algorithms.PhaseEstimation.md | 128 +
...qiskit.algorithms.PhaseEstimationResult.md | 103 +
.../qiskit.algorithms.PhaseEstimationScale.md | 116 +
.../api/qiskit/0.46/qiskit.algorithms.QAOA.md | 252 ++
.../0.46/qiskit.algorithms.RealEvolver.md | 48 +
.../0.46/qiskit.algorithms.RealTimeEvolver.md | 42 +
...qiskit.algorithms.SciPyImaginaryEvolver.md | 52 +
.../qiskit.algorithms.SciPyRealEvolver.md | 52 +
.../qiskit.algorithms.TimeEvolutionProblem.md | 116 +
.../qiskit.algorithms.TimeEvolutionResult.md | 79 +
.../0.46/qiskit.algorithms.TrotterQRTE.md | 120 +
docs/api/qiskit/0.46/qiskit.algorithms.VQD.md | 243 +
.../0.46/qiskit.algorithms.VQDResult.md | 108 +
docs/api/qiskit/0.46/qiskit.algorithms.VQE.md | 270 ++
.../qiskit/0.46/qiskit.algorithms.VarQITE.md | 56 +
.../qiskit/0.46/qiskit.algorithms.VarQRTE.md | 56 +
...kit.algorithms.eigensolvers.Eigensolver.md | 61 +
...gorithms.eigensolvers.EigensolverResult.md | 48 +
...lgorithms.eigensolvers.NumPyEigensolver.md | 84 +
...hms.eigensolvers.NumPyEigensolverResult.md | 54 +
.../qiskit.algorithms.eigensolvers.VQD.md | 173 +
...iskit.algorithms.eigensolvers.VQDResult.md | 90 +
.../0.46/qiskit.algorithms.eigensolvers.md | 38 +
...orithms.gradients.BaseEstimatorGradient.md | 98 +
.../qiskit.algorithms.gradients.BaseQGT.md | 115 +
...lgorithms.gradients.BaseSamplerGradient.md | 76 +
...ithms.gradients.EstimatorGradientResult.md | 44 +
...s.gradients.FiniteDiffEstimatorGradient.md | 107 +
...hms.gradients.FiniteDiffSamplerGradient.md | 96 +
...thms.gradients.LinCombEstimatorGradient.md | 104 +
.../qiskit.algorithms.gradients.LinCombQGT.md | 124 +
...rithms.gradients.LinCombSamplerGradient.md | 84 +
...s.gradients.ParamShiftEstimatorGradient.md | 106 +
...hms.gradients.ParamShiftSamplerGradient.md | 84 +
.../0.46/qiskit.algorithms.gradients.QFI.md | 77 +
.../qiskit.algorithms.gradients.QFIResult.md | 44 +
.../qiskit.algorithms.gradients.QGTResult.md | 52 +
...thms.gradients.ReverseEstimatorGradient.md | 104 +
.../qiskit.algorithms.gradients.ReverseQGT.md | 100 +
...orithms.gradients.SPSAEstimatorGradient.md | 96 +
...lgorithms.gradients.SPSASamplerGradient.md | 85 +
...orithms.gradients.SamplerGradientResult.md | 44 +
.../0.46/qiskit.algorithms.gradients.md | 76 +
...lgorithms.minimum_eigensolvers.AdaptVQE.md | 143 +
...hms.minimum_eigensolvers.AdaptVQEResult.md | 122 +
...minimum_eigensolvers.MinimumEigensolver.md | 61 +
...m_eigensolvers.MinimumEigensolverResult.md | 48 +
...um_eigensolvers.NumPyMinimumEigensolver.md | 71 +
...ensolvers.NumPyMinimumEigensolverResult.md | 54 +
...it.algorithms.minimum_eigensolvers.QAOA.md | 172 +
...eigensolvers.SamplingMinimumEigensolver.md | 59 +
...olvers.SamplingMinimumEigensolverResult.md | 66 +
...rithms.minimum_eigensolvers.SamplingVQE.md | 168 +
....minimum_eigensolvers.SamplingVQEResult.md | 112 +
...kit.algorithms.minimum_eigensolvers.VQE.md | 172 +
...gorithms.minimum_eigensolvers.VQEResult.md | 96 +
.../qiskit.algorithms.minimum_eigensolvers.md | 43 +
.../0.46/qiskit.algorithms.optimizers.ADAM.md | 282 ++
.../0.46/qiskit.algorithms.optimizers.AQGD.md | 241 +
.../qiskit.algorithms.optimizers.AskData.md | 43 +
.../qiskit.algorithms.optimizers.BOBYQA.md | 221 +
.../0.46/qiskit.algorithms.optimizers.CG.md | 224 +
.../qiskit.algorithms.optimizers.COBYLA.md | 222 +
.../0.46/qiskit.algorithms.optimizers.CRS.md | 233 +
.../qiskit.algorithms.optimizers.DIRECT_L.md | 235 +
...kit.algorithms.optimizers.DIRECT_L_RAND.md | 235 +
.../0.46/qiskit.algorithms.optimizers.ESCH.md | 235 +
.../0.46/qiskit.algorithms.optimizers.GSLS.md | 342 ++
...t.algorithms.optimizers.GradientDescent.md | 466 ++
...orithms.optimizers.GradientDescentState.md | 88 +
.../qiskit.algorithms.optimizers.IMFIL.md | 221 +
.../qiskit.algorithms.optimizers.ISRES.md | 233 +
.../qiskit.algorithms.optimizers.L_BFGS_B.md | 230 +
.../qiskit.algorithms.optimizers.Minimizer.md | 40 +
...iskit.algorithms.optimizers.NELDER_MEAD.md | 228 +
.../0.46/qiskit.algorithms.optimizers.NFT.md | 232 +
.../qiskit.algorithms.optimizers.Optimizer.md | 221 +
...t.algorithms.optimizers.OptimizerResult.md | 70 +
...it.algorithms.optimizers.OptimizerState.md | 70 +
...rithms.optimizers.OptimizerSupportLevel.md | 44 +
.../qiskit.algorithms.optimizers.POWELL.md | 223 +
.../qiskit.algorithms.optimizers.P_BFGS.md | 225 +
.../qiskit.algorithms.optimizers.QNSPSA.md | 416 ++
.../qiskit.algorithms.optimizers.SLSQP.md | 226 +
.../qiskit.algorithms.optimizers.SNOBFIT.md | 225 +
.../0.46/qiskit.algorithms.optimizers.SPSA.md | 399 ++
...it.algorithms.optimizers.SciPyOptimizer.md | 218 +
...lgorithms.optimizers.SteppableOptimizer.md | 396 ++
.../0.46/qiskit.algorithms.optimizers.TNC.md | 227 +
.../qiskit.algorithms.optimizers.TellData.md | 41 +
.../0.46/qiskit.algorithms.optimizers.UMDA.md | 307 ++
.../0.46/qiskit.algorithms.optimizers.md | 97 +
...optimizers.optimizer_utils.LearningRate.md | 56 +
...t.algorithms.optimizers.optimizer_utils.md | 28 +
...thms.state_fidelities.BaseStateFidelity.md | 71 +
...ithms.state_fidelities.ComputeUncompute.md | 117 +
...ms.state_fidelities.StateFidelityResult.md | 52 +
.../qiskit.algorithms.state_fidelities.md | 35 +
...ime_evolvers.trotterization.TrotterQRTE.md | 109 +
...algorithms.time_evolvers.trotterization.md | 22 +
...evolvers.variational.ForwardEulerSolver.md | 42 +
...variational.ImaginaryMcLachlanPrinciple.md | 56 +
...riational.ImaginaryVariationalPrinciple.md | 23 +
...vers.variational.RealMcLachlanPrinciple.md | 56 +
...rs.variational.RealVariationalPrinciple.md | 23 +
...olvers.variational.VariationalPrinciple.md | 93 +
...it.algorithms.time_evolvers.variational.md | 78 +
.../qiskit/0.46/qiskit.assembler.RunConfig.md | 106 +
.../0.46/qiskit.circuit.AncillaQubit.md | 55 +
.../0.46/qiskit.circuit.AncillaRegister.md | 90 +
.../0.46/qiskit.circuit.AnnotatedOperation.md | 84 +
docs/api/qiskit/0.46/qiskit.circuit.Bit.md | 50 +
.../qiskit/0.46/qiskit.circuit.BreakLoopOp.md | 345 ++
.../0.46/qiskit.circuit.CircuitInstruction.md | 82 +
.../0.46/qiskit.circuit.ClassicalRegister.md | 90 +
docs/api/qiskit/0.46/qiskit.circuit.Clbit.md | 55 +
.../0.46/qiskit.circuit.CommutationChecker.md | 46 +
.../0.46/qiskit.circuit.ContinueLoopOp.md | 349 ++
.../0.46/qiskit.circuit.ControlFlowOp.md | 353 ++
.../0.46/qiskit.circuit.ControlModifier.md | 36 +
.../0.46/qiskit.circuit.ControlledGate.md | 495 +++
docs/api/qiskit/0.46/qiskit.circuit.Delay.md | 350 ++
.../0.46/qiskit.circuit.EquivalenceLibrary.md | 184 +
.../qiskit/0.46/qiskit.circuit.ForLoopOp.md | 366 ++
docs/api/qiskit/0.46/qiskit.circuit.Gate.md | 427 ++
.../qiskit/0.46/qiskit.circuit.IfElseOp.md | 378 ++
.../qiskit/0.46/qiskit.circuit.Instruction.md | 331 ++
.../0.46/qiskit.circuit.InstructionSet.md | 121 +
.../0.46/qiskit.circuit.InverseModifier.md | 18 +
.../qiskit/0.46/qiskit.circuit.Operation.md | 55 +
.../qiskit/0.46/qiskit.circuit.Parameter.md | 258 ++
.../qiskit.circuit.ParameterExpression.md | 250 ++
.../0.46/qiskit.circuit.ParameterVector.md | 52 +
.../0.46/qiskit.circuit.PowerModifier.md | 26 +
.../0.46/qiskit.circuit.QuantumCircuit.md | 3922 +++++++++++++++++
.../0.46/qiskit.circuit.QuantumRegister.md | 90 +
docs/api/qiskit/0.46/qiskit.circuit.Qubit.md | 55 +
.../qiskit/0.46/qiskit.circuit.Register.md | 88 +
.../0.46/qiskit.circuit.SwitchCaseOp.md | 392 ++
.../qiskit/0.46/qiskit.circuit.WhileLoopOp.md | 367 ++
...uit.classicalfunction.BooleanExpression.md | 487 ++
...uit.classicalfunction.ClassicalFunction.md | 544 +++
...tion.ClassicalFunctionCompilerTypeError.md | 20 +
...calfunction.ClassicalFunctionParseError.md | 20 +
.../qiskit/0.46/qiskit.circuit.library.AND.md | 227 +
.../0.46/qiskit.circuit.library.Barrier.md | 311 ++
.../0.46/qiskit.circuit.library.C3SXGate.md | 176 +
.../0.46/qiskit.circuit.library.C3XGate.md | 187 +
.../0.46/qiskit.circuit.library.C4XGate.md | 191 +
.../0.46/qiskit.circuit.library.CCXGate.md | 243 +
.../0.46/qiskit.circuit.library.CCZGate.md | 196 +
...it.circuit.library.CDKMRippleCarryAdder.md | 283 ++
.../0.46/qiskit.circuit.library.CHGate.md | 211 +
.../0.46/qiskit.circuit.library.CPhaseGate.md | 222 +
.../0.46/qiskit.circuit.library.CRXGate.md | 213 +
.../0.46/qiskit.circuit.library.CRYGate.md | 213 +
.../0.46/qiskit.circuit.library.CRZGate.md | 215 +
.../0.46/qiskit.circuit.library.CSGate.md | 195 +
.../0.46/qiskit.circuit.library.CSXGate.md | 199 +
.../0.46/qiskit.circuit.library.CSdgGate.md | 195 +
.../0.46/qiskit.circuit.library.CSwapGate.md | 230 +
.../0.46/qiskit.circuit.library.CU1Gate.md | 212 +
.../0.46/qiskit.circuit.library.CU3Gate.md | 217 +
.../0.46/qiskit.circuit.library.CUGate.md | 207 +
.../0.46/qiskit.circuit.library.CXGate.md | 239 +
.../0.46/qiskit.circuit.library.CYGate.md | 209 +
.../0.46/qiskit.circuit.library.CZGate.md | 190 +
.../0.46/qiskit.circuit.library.DCXGate.md | 141 +
.../0.46/qiskit.circuit.library.Diagonal.md | 255 ++
.../qiskit.circuit.library.DiagonalGate.md | 137 +
.../qiskit.circuit.library.DraperQFTAdder.md | 254 ++
.../0.46/qiskit.circuit.library.ECRGate.md | 175 +
.../qiskit.circuit.library.EfficientSU2.md | 351 ++
...t.circuit.library.EvolvedOperatorAnsatz.md | 319 ++
.../qiskit.circuit.library.ExactReciprocal.md | 224 +
...it.circuit.library.ExcitationPreserving.md | 370 ++
.../qiskit.circuit.library.FourierChecking.md | 238 +
...ircuit.library.FunctionalPauliRotations.md | 188 +
.../qiskit/0.46/qiskit.circuit.library.GMS.md | 247 ++
.../qiskit/0.46/qiskit.circuit.library.GR.md | 241 +
.../qiskit/0.46/qiskit.circuit.library.GRX.md | 240 +
.../qiskit/0.46/qiskit.circuit.library.GRY.md | 240 +
.../qiskit/0.46/qiskit.circuit.library.GRZ.md | 240 +
.../qiskit.circuit.library.GlobalPhaseGate.md | 145 +
.../0.46/qiskit.circuit.library.GraphState.md | 245 +
.../qiskit.circuit.library.GroverOperator.md | 380 ++
.../0.46/qiskit.circuit.library.HGate.md | 173 +
...circuit.library.HRSCumulativeMultiplier.md | 277 ++
.../qiskit.circuit.library.HamiltonianGate.md | 181 +
...it.circuit.library.HiddenLinearFunction.md | 247 ++
.../0.46/qiskit.circuit.library.IGate.md | 156 +
.../qiskit/0.46/qiskit.circuit.library.IQP.md | 235 +
.../0.46/qiskit.circuit.library.Initialize.md | 170 +
.../qiskit.circuit.library.InnerProduct.md | 246 ++
...iskit.circuit.library.IntegerComparator.md | 201 +
.../0.46/qiskit.circuit.library.Isometry.md | 174 +
...circuit.library.LinearAmplitudeFunction.md | 283 ++
.../qiskit.circuit.library.LinearFunction.md | 251 ++
...it.circuit.library.LinearPauliRotations.md | 235 +
.../0.46/qiskit.circuit.library.MCMT.md | 263 ++
.../0.46/qiskit.circuit.library.MCMTVChain.md | 279 ++
.../qiskit.circuit.library.MCPhaseGate.md | 206 +
.../0.46/qiskit.circuit.library.MCXGate.md | 207 +
.../qiskit.circuit.library.MCXGrayCode.md | 171 +
.../qiskit.circuit.library.MCXRecursive.md | 179 +
.../0.46/qiskit.circuit.library.MCXVChain.md | 177 +
.../0.46/qiskit.circuit.library.MSGate.md | 123 +
.../0.46/qiskit.circuit.library.Measure.md | 316 ++
.../0.46/qiskit.circuit.library.NLocal.md | 462 ++
.../qiskit/0.46/qiskit.circuit.library.OR.md | 227 +
...skit.circuit.library.PauliEvolutionGate.md | 191 +
.../qiskit.circuit.library.PauliFeatureMap.md | 418 ++
.../0.46/qiskit.circuit.library.PauliGate.md | 148 +
.../qiskit.circuit.library.PauliTwoDesign.md | 329 ++
.../qiskit.circuit.library.Permutation.md | 229 +
.../qiskit.circuit.library.PermutationGate.md | 157 +
.../qiskit.circuit.library.PhaseEstimation.md | 246 ++
.../0.46/qiskit.circuit.library.PhaseGate.md | 203 +
.../qiskit.circuit.library.PhaseOracle.md | 283 ++
...skit.circuit.library.PiecewiseChebyshev.md | 241 +
...t.library.PiecewiseLinearPauliRotations.md | 278 ++
...brary.PiecewisePolynomialPauliRotations.md | 310 ++
...ircuit.library.PolynomialPauliRotations.md | 238 +
.../0.46/qiskit.circuit.library.QAOAAnsatz.md | 345 ++
.../qiskit/0.46/qiskit.circuit.library.QFT.md | 249 ++
.../qiskit.circuit.library.QuadraticForm.md | 272 ++
.../qiskit.circuit.library.QuantumVolume.md | 234 +
.../0.46/qiskit.circuit.library.RC3XGate.md | 123 +
.../0.46/qiskit.circuit.library.RCCXGate.md | 123 +
.../qiskit.circuit.library.RGQFTMultiplier.md | 256 ++
.../0.46/qiskit.circuit.library.RGate.md | 159 +
.../0.46/qiskit.circuit.library.RVGate.md | 166 +
.../0.46/qiskit.circuit.library.RXGate.md | 181 +
.../0.46/qiskit.circuit.library.RXXGate.md | 183 +
.../0.46/qiskit.circuit.library.RYGate.md | 181 +
.../0.46/qiskit.circuit.library.RYYGate.md | 183 +
.../0.46/qiskit.circuit.library.RZGate.md | 191 +
.../0.46/qiskit.circuit.library.RZXGate.md | 223 +
.../0.46/qiskit.circuit.library.RZZGate.md | 195 +
.../qiskit.circuit.library.RealAmplitudes.md | 389 ++
.../0.46/qiskit.circuit.library.Reset.md | 316 ++
.../0.46/qiskit.circuit.library.SGate.md | 160 +
.../0.46/qiskit.circuit.library.SXGate.md | 182 +
.../0.46/qiskit.circuit.library.SXdgGate.md | 148 +
.../0.46/qiskit.circuit.library.SdgGate.md | 160 +
...qiskit.circuit.library.StatePreparation.md | 211 +
.../0.46/qiskit.circuit.library.SwapGate.md | 181 +
.../0.46/qiskit.circuit.library.TGate.md | 160 +
.../0.46/qiskit.circuit.library.TdgGate.md | 160 +
.../0.46/qiskit.circuit.library.TwoLocal.md | 415 ++
.../0.46/qiskit.circuit.library.U1Gate.md | 208 +
.../0.46/qiskit.circuit.library.U2Gate.md | 187 +
.../0.46/qiskit.circuit.library.U3Gate.md | 204 +
.../0.46/qiskit.circuit.library.UCGate.md | 169 +
.../qiskit.circuit.library.UCPauliRotGate.md | 122 +
.../0.46/qiskit.circuit.library.UCRXGate.md | 121 +
.../0.46/qiskit.circuit.library.UCRYGate.md | 121 +
.../0.46/qiskit.circuit.library.UCRZGate.md | 121 +
.../0.46/qiskit.circuit.library.UGate.md | 187 +
.../qiskit.circuit.library.UnitaryGate.md | 209 +
.../qiskit.circuit.library.UnitaryOverlap.md | 256 ++
...kit.circuit.library.VBERippleCarryAdder.md | 255 ++
.../qiskit.circuit.library.WeightedAdder.md | 251 ++
.../0.46/qiskit.circuit.library.XGate.md | 191 +
.../qiskit/0.46/qiskit.circuit.library.XOR.md | 229 +
.../qiskit.circuit.library.XXMinusYYGate.md | 193 +
.../qiskit.circuit.library.XXPlusYYGate.md | 193 +
.../0.46/qiskit.circuit.library.YGate.md | 191 +
.../qiskit.circuit.library.ZFeatureMap.md | 367 ++
.../0.46/qiskit.circuit.library.ZGate.md | 199 +
.../qiskit.circuit.library.ZZFeatureMap.md | 372 ++
.../0.46/qiskit.circuit.library.iSwapGate.md | 180 +
.../0.46/qiskit.dagcircuit.DAGCircuit.md | 1026 +++++
.../0.46/qiskit.dagcircuit.DAGDepNode.md | 117 +
.../0.46/qiskit.dagcircuit.DAGDependency.md | 390 ++
.../0.46/qiskit.dagcircuit.DAGInNode.md | 55 +
.../qiskit/0.46/qiskit.dagcircuit.DAGNode.md | 45 +
.../0.46/qiskit.dagcircuit.DAGOpNode.md | 69 +
.../0.46/qiskit.dagcircuit.DAGOutNode.md | 55 +
.../qiskit.extensions.SingleQubitUnitary.md | 424 ++
.../qiskit/0.46/qiskit.extensions.Snapshot.md | 322 ++
.../qiskit/0.46/qiskit.opflow.OperatorBase.md | 420 ++
...qiskit.opflow.converters.AbelianGrouper.md | 74 +
...qiskit.opflow.converters.CircuitSampler.md | 108 +
.../qiskit.opflow.converters.ConverterBase.md | 44 +
...skit.opflow.converters.DictToCircuitSum.md | 50 +
...skit.opflow.converters.PauliBasisChange.md | 268 ++
...kit.opflow.converters.TwoQubitReduction.md | 50 +
.../qiskit/0.46/qiskit.opflow.converters.md | 52 +
.../qiskit.opflow.evolutions.EvolutionBase.md | 44 +
...skit.opflow.evolutions.EvolutionFactory.md | 48 +
.../qiskit.opflow.evolutions.EvolvedOp.md | 337 ++
...iskit.opflow.evolutions.MatrixEvolution.md | 44 +
...opflow.evolutions.PauliTrotterEvolution.md | 96 +
.../0.46/qiskit.opflow.evolutions.QDrift.md | 60 +
.../0.46/qiskit.opflow.evolutions.Suzuki.md | 69 +
.../0.46/qiskit.opflow.evolutions.Trotter.md | 40 +
...it.opflow.evolutions.TrotterizationBase.md | 56 +
...opflow.evolutions.TrotterizationFactory.md | 49 +
.../qiskit/0.46/qiskit.opflow.evolutions.md | 61 +
...opflow.expectations.AerPauliExpectation.md | 64 +
...kit.opflow.expectations.CVaRExpectation.md | 89 +
...kit.opflow.expectations.ExpectationBase.md | 64 +
....opflow.expectations.ExpectationFactory.md | 50 +
...t.opflow.expectations.MatrixExpectation.md | 64 +
...it.opflow.expectations.PauliExpectation.md | 68 +
.../qiskit/0.46/qiskit.opflow.expectations.md | 46 +
...qiskit.opflow.gradients.CircuitGradient.md | 53 +
.../qiskit.opflow.gradients.CircuitQFI.md | 53 +
.../qiskit.opflow.gradients.DerivativeBase.md | 102 +
.../0.46/qiskit.opflow.gradients.Gradient.md | 90 +
.../qiskit.opflow.gradients.GradientBase.md | 45 +
.../0.46/qiskit.opflow.gradients.Hessian.md | 87 +
.../qiskit.opflow.gradients.HessianBase.md | 43 +
...qiskit.opflow.gradients.NaturalGradient.md | 119 +
.../0.46/qiskit.opflow.gradients.QFI.md | 66 +
.../0.46/qiskit.opflow.gradients.QFIBase.md | 48 +
.../qiskit/0.46/qiskit.opflow.gradients.md | 132 +
.../0.46/qiskit.opflow.list_ops.ComposedOp.md | 254 ++
.../0.46/qiskit.opflow.list_ops.ListOp.md | 518 +++
.../0.46/qiskit.opflow.list_ops.SummedOp.md | 253 ++
.../0.46/qiskit.opflow.list_ops.TensoredOp.md | 218 +
.../api/qiskit/0.46/qiskit.opflow.list_ops.md | 54 +
.../qiskit.opflow.primitive_ops.CircuitOp.md | 338 ++
.../qiskit.opflow.primitive_ops.MatrixOp.md | 306 ++
.../qiskit.opflow.primitive_ops.PauliOp.md | 337 ++
.../qiskit.opflow.primitive_ops.PauliSumOp.md | 449 ++
...qiskit.opflow.primitive_ops.PrimitiveOp.md | 429 ++
....opflow.primitive_ops.TaperedPauliSumOp.md | 130 +
...iskit.opflow.primitive_ops.Z2Symmetries.md | 220 +
.../0.46/qiskit.opflow.primitive_ops.md | 51 +
...qiskit.opflow.state_fns.CVaRMeasurement.md | 352 ++
.../qiskit.opflow.state_fns.CircuitStateFn.md | 375 ++
.../qiskit.opflow.state_fns.DictStateFn.md | 307 ++
...qiskit.opflow.state_fns.OperatorStateFn.md | 272 ++
...it.opflow.state_fns.SparseVectorStateFn.md | 281 ++
.../0.46/qiskit.opflow.state_fns.StateFn.md | 461 ++
.../qiskit.opflow.state_fns.VectorStateFn.md | 306 ++
.../qiskit/0.46/qiskit.opflow.state_fns.md | 50 +
.../0.46/qiskit.passmanager.BaseController.md | 73 +
.../qiskit.passmanager.BasePassManager.md | 141 +
...iskit.passmanager.ConditionalController.md | 95 +
.../qiskit.passmanager.DoWhileController.md | 97 +
.../0.46/qiskit.passmanager.FlowController.md | 168 +
...qiskit.passmanager.FlowControllerLinear.md | 95 +
.../0.46/qiskit.passmanager.GenericPass.md | 97 +
.../qiskit.passmanager.PassManagerState.md | 40 +
.../0.46/qiskit.passmanager.PropertySet.md | 102 +
.../0.46/qiskit.passmanager.WorkflowStatus.md | 50 +
.../qiskit.primitives.BackendEstimator.md | 172 +
.../0.46/qiskit.primitives.BackendSampler.md | 153 +
.../0.46/qiskit.primitives.BaseEstimator.md | 132 +
.../0.46/qiskit.primitives.BaseSampler.md | 96 +
.../0.46/qiskit.primitives.Estimator.md | 137 +
.../0.46/qiskit.primitives.EstimatorResult.md | 81 +
.../qiskit/0.46/qiskit.primitives.Sampler.md | 105 +
.../0.46/qiskit.primitives.SamplerResult.md | 81 +
.../qiskit/0.46/qiskit.providers.Backend.md | 28 +
.../qiskit/0.46/qiskit.providers.BackendV1.md | 213 +
.../qiskit/0.46/qiskit.providers.BackendV2.md | 382 ++
.../qiskit.providers.BackendV2Converter.md | 333 ++
docs/api/qiskit/0.46/qiskit.providers.Job.md | 28 +
.../qiskit/0.46/qiskit.providers.JobStatus.md | 62 +
.../api/qiskit/0.46/qiskit.providers.JobV1.md | 170 +
.../qiskit/0.46/qiskit.providers.Options.md | 125 +
.../qiskit/0.46/qiskit.providers.Provider.md | 28 +
.../0.46/qiskit.providers.ProviderV1.md | 76 +
.../0.46/qiskit.providers.QubitProperties.md | 42 +
....providers.basic_provider.BasicProvider.md | 76 +
...iders.basic_provider.BasicProviderError.md | 20 +
...oviders.basic_provider.BasicProviderJob.md | 184 +
...providers.basic_provider.BasicSimulator.md | 413 ++
...qiskit.providers.basicaer.BasicAerError.md | 24 +
.../qiskit.providers.basicaer.BasicAerJob.md | 180 +
...kit.providers.basicaer.BasicAerProvider.md | 80 +
...skit.providers.basicaer.QasmSimulatorPy.md | 243 +
...oviders.basicaer.StatevectorSimulatorPy.md | 243 +
...t.providers.basicaer.UnitarySimulatorPy.md | 252 ++
.../qiskit.providers.convert_to_target.md | 26 +
...s.fake_provider.ConfigurableFakeBackend.md | 164 +
.../qiskit.providers.fake_provider.Fake1Q.md | 136 +
...kit.providers.fake_provider.FakeAlmaden.md | 175 +
...t.providers.fake_provider.FakeAlmadenV2.md | 361 ++
...skit.providers.fake_provider.FakeArmonk.md | 183 +
...it.providers.fake_provider.FakeArmonkV2.md | 355 ++
...skit.providers.fake_provider.FakeAthens.md | 179 +
...it.providers.fake_provider.FakeAthensV2.md | 351 ++
...it.providers.fake_provider.FakeAuckland.md | 351 ++
...providers.fake_provider.FakeBackend5QV2.md | 331 ++
...t.providers.fake_provider.FakeBackendV2.md | 331 ++
...iskit.providers.fake_provider.FakeBelem.md | 179 +
...kit.providers.fake_provider.FakeBelemV2.md | 351 ++
....providers.fake_provider.FakeBoeblingen.md | 189 +
...roviders.fake_provider.FakeBoeblingenV2.md | 361 ++
...skit.providers.fake_provider.FakeBogota.md | 179 +
...it.providers.fake_provider.FakeBogotaV2.md | 351 ++
...it.providers.fake_provider.FakeBrooklyn.md | 179 +
....providers.fake_provider.FakeBrooklynV2.md | 351 ++
....providers.fake_provider.FakeBurlington.md | 171 +
...roviders.fake_provider.FakeBurlingtonV2.md | 357 ++
...iskit.providers.fake_provider.FakeCairo.md | 179 +
...kit.providers.fake_provider.FakeCairoV2.md | 351 ++
...t.providers.fake_provider.FakeCambridge.md | 177 +
...providers.fake_provider.FakeCambridgeV2.md | 363 ++
....providers.fake_provider.FakeCasablanca.md | 179 +
...roviders.fake_provider.FakeCasablancaV2.md | 351 ++
...iskit.providers.fake_provider.FakeEssex.md | 173 +
...kit.providers.fake_provider.FakeEssexV2.md | 359 ++
...skit.providers.fake_provider.FakeGeneva.md | 351 ++
...t.providers.fake_provider.FakeGuadalupe.md | 179 +
...providers.fake_provider.FakeGuadalupeV2.md | 351 ++
...iskit.providers.fake_provider.FakeHanoi.md | 179 +
...kit.providers.fake_provider.FakeHanoiV2.md | 351 ++
...kit.providers.fake_provider.FakeJakarta.md | 179 +
...t.providers.fake_provider.FakeJakartaV2.md | 351 ++
...roviders.fake_provider.FakeJohannesburg.md | 175 +
...viders.fake_provider.FakeJohannesburgV2.md | 361 ++
...kit.providers.fake_provider.FakeKolkata.md | 179 +
...t.providers.fake_provider.FakeKolkataV2.md | 351 ++
...iskit.providers.fake_provider.FakeLagos.md | 179 +
...kit.providers.fake_provider.FakeLagosV2.md | 351 ++
...qiskit.providers.fake_provider.FakeLima.md | 179 +
...skit.providers.fake_provider.FakeLimaV2.md | 351 ++
...skit.providers.fake_provider.FakeLondon.md | 173 +
...it.providers.fake_provider.FakeLondonV2.md | 359 ++
...t.providers.fake_provider.FakeManhattan.md | 179 +
...providers.fake_provider.FakeManhattanV2.md | 351 ++
...skit.providers.fake_provider.FakeManila.md | 179 +
...it.providers.fake_provider.FakeManilaV2.md | 351 ++
...t.providers.fake_provider.FakeMelbourne.md | 140 +
...providers.fake_provider.FakeMelbourneV2.md | 351 ++
...it.providers.fake_provider.FakeMontreal.md | 179 +
....providers.fake_provider.FakeMontrealV2.md | 351 ++
...skit.providers.fake_provider.FakeMumbai.md | 179 +
...rs.fake_provider.FakeMumbaiFractionalCX.md | 327 ++
...it.providers.fake_provider.FakeMumbaiV2.md | 351 ++
...kit.providers.fake_provider.FakeNairobi.md | 179 +
...t.providers.fake_provider.FakeNairobiV2.md | 351 ++
...providers.fake_provider.FakeOpenPulse2Q.md | 149 +
...providers.fake_provider.FakeOpenPulse3Q.md | 147 +
...qiskit.providers.fake_provider.FakeOslo.md | 351 ++
...kit.providers.fake_provider.FakeOurense.md | 171 +
...t.providers.fake_provider.FakeOurenseV2.md | 357 ++
...iskit.providers.fake_provider.FakeParis.md | 191 +
...kit.providers.fake_provider.FakeParisV2.md | 363 ++
...iskit.providers.fake_provider.FakePerth.md | 351 ++
...roviders.fake_provider.FakePoughkeepsie.md | 144 +
...viders.fake_provider.FakePoughkeepsieV2.md | 351 ++
...skit.providers.fake_provider.FakePrague.md | 351 ++
...it.providers.fake_provider.FakeProvider.md | 82 +
....fake_provider.FakeProviderForBackendV2.md | 82 +
...oviders.fake_provider.FakeQasmSimulator.md | 138 +
...iskit.providers.fake_provider.FakeQuito.md | 179 +
...kit.providers.fake_provider.FakeQuitoV2.md | 351 ++
...t.providers.fake_provider.FakeRochester.md | 165 +
...providers.fake_provider.FakeRochesterV2.md | 351 ++
...qiskit.providers.fake_provider.FakeRome.md | 179 +
...skit.providers.fake_provider.FakeRomeV2.md | 351 ++
...providers.fake_provider.FakeRueschlikon.md | 140 +
...it.providers.fake_provider.FakeSantiago.md | 179 +
....providers.fake_provider.FakeSantiagoV2.md | 351 ++
....providers.fake_provider.FakeSherbrooke.md | 351 ++
...t.providers.fake_provider.FakeSingapore.md | 175 +
...providers.fake_provider.FakeSingaporeV2.md | 361 ++
...skit.providers.fake_provider.FakeSydney.md | 179 +
...it.providers.fake_provider.FakeSydneyV2.md | 351 ++
...it.providers.fake_provider.FakeTenerife.md | 142 +
...iskit.providers.fake_provider.FakeTokyo.md | 144 +
...kit.providers.fake_provider.FakeToronto.md | 179 +
...t.providers.fake_provider.FakeTorontoV2.md | 351 ++
...it.providers.fake_provider.FakeValencia.md | 179 +
....providers.fake_provider.FakeValenciaV2.md | 351 ++
...qiskit.providers.fake_provider.FakeVigo.md | 171 +
...skit.providers.fake_provider.FakeVigoV2.md | 357 ++
....providers.fake_provider.FakeWashington.md | 179 +
...roviders.fake_provider.FakeWashingtonV2.md | 351 ++
...it.providers.fake_provider.FakeYorktown.md | 173 +
....providers.fake_provider.FakeYorktownV2.md | 359 ++
...roviders.fake_provider.GenericBackendV2.md | 354 ++
...t.providers.models.BackendConfiguration.md | 138 +
...skit.providers.models.BackendProperties.md | 320 ++
.../qiskit.providers.models.BackendStatus.md | 70 +
.../0.46/qiskit.providers.models.Command.md | 71 +
.../qiskit.providers.models.GateConfig.md | 86 +
.../qiskit.providers.models.GateProperties.md | 83 +
.../0.46/qiskit.providers.models.JobStatus.md | 86 +
.../0.46/qiskit.providers.models.Nduv.md | 89 +
...viders.models.PulseBackendConfiguration.md | 284 ++
.../qiskit.providers.models.PulseDefaults.md | 64 +
...oviders.models.QasmBackendConfiguration.md | 204 +
.../qiskit.providers.models.UchannelLO.md | 79 +
.../qiskit.pulse.InstructionScheduleMap.md | 241 +
docs/api/qiskit/0.46/qiskit.pulse.Schedule.md | 498 +++
.../qiskit/0.46/qiskit.pulse.ScheduleBlock.md | 662 +++
.../qiskit.pulse.channels.AcquireChannel.md | 68 +
.../qiskit.pulse.channels.ControlChannel.md | 68 +
.../qiskit.pulse.channels.DriveChannel.md | 68 +
.../qiskit.pulse.channels.MeasureChannel.md | 68 +
.../0.46/qiskit.pulse.channels.MemorySlot.md | 68 +
.../qiskit.pulse.channels.RegisterSlot.md | 68 +
.../qiskit.pulse.channels.SnapshotChannel.md | 64 +
.../0.46/qiskit.pulse.instructions.Acquire.md | 289 ++
.../0.46/qiskit.pulse.instructions.Call.md | 303 ++
.../0.46/qiskit.pulse.instructions.Delay.md | 263 ++
.../0.46/qiskit.pulse.instructions.Play.md | 257 ++
.../qiskit.pulse.instructions.Reference.md | 268 ++
...skit.pulse.instructions.RelativeBarrier.md | 244 +
.../qiskit.pulse.instructions.SetFrequency.md | 265 ++
.../qiskit.pulse.instructions.SetPhase.md | 263 ++
...iskit.pulse.instructions.ShiftFrequency.md | 255 ++
.../qiskit.pulse.instructions.ShiftPhase.md | 267 ++
.../qiskit.pulse.instructions.Snapshot.md | 261 ++
.../qiskit.pulse.instructions.TimeBlockade.md | 280 ++
...qiskit.pulse.library.Constant_class.rst.md | 45 +
.../qiskit.pulse.library.Cos_class.rst.md | 44 +
.../qiskit.pulse.library.Drag_class.rst.md | 61 +
.../qiskit.pulse.library.GaussianDeriv.md | 44 +
.../qiskit.pulse.library.GaussianSquare.md | 79 +
...qiskit.pulse.library.GaussianSquareDrag.md | 90 +
...qiskit.pulse.library.Gaussian_class.rst.md | 50 +
.../qiskit.pulse.library.ParametricPulse.md | 138 +
...qiskit.pulse.library.Sawtooth_class.rst.md | 45 +
.../0.46/qiskit.pulse.library.SechDeriv.md | 44 +
.../0.46/qiskit.pulse.library.Sech_fun.rst.md | 53 +
.../qiskit.pulse.library.Sin_class.rst.md | 44 +
.../qiskit.pulse.library.Square_fun.rst.md | 45 +
.../qiskit.pulse.library.SymbolicPulse.md | 258 ++
...qiskit.pulse.library.Triangle_class.rst.md | 44 +
.../0.46/qiskit.pulse.library.Waveform.md | 113 +
...skit.pulse.library.gaussian_square_echo.md | 77 +
...qiskit.pulse.transforms.AlignEquispaced.md | 62 +
.../0.46/qiskit.pulse.transforms.AlignFunc.md | 82 +
.../0.46/qiskit.pulse.transforms.AlignLeft.md | 52 +
.../qiskit.pulse.transforms.AlignRight.md | 52 +
...qiskit.pulse.transforms.AlignSequential.md | 52 +
.../0.46/qiskit.qobj.GateCalibration.md | 65 +
.../0.46/qiskit.qobj.PulseLibraryItem.md | 63 +
docs/api/qiskit/0.46/qiskit.qobj.PulseQobj.md | 84 +
.../0.46/qiskit.qobj.PulseQobjConfig.md | 73 +
.../0.46/qiskit.qobj.PulseQobjExperiment.md | 66 +
.../qiskit.qobj.PulseQobjExperimentConfig.md | 64 +
.../0.46/qiskit.qobj.PulseQobjInstruction.md | 78 +
.../qiskit.qobj.QasmExperimentCalibrations.md | 62 +
docs/api/qiskit/0.46/qiskit.qobj.QasmQobj.md | 84 +
.../qiskit/0.46/qiskit.qobj.QasmQobjConfig.md | 75 +
.../0.46/qiskit.qobj.QasmQobjExperiment.md | 66 +
.../qiskit.qobj.QasmQobjExperimentConfig.md | 63 +
.../0.46/qiskit.qobj.QasmQobjInstruction.md | 73 +
.../0.46/qiskit.qobj.QobjExperimentHeader.md | 62 +
.../api/qiskit/0.46/qiskit.qobj.QobjHeader.md | 62 +
.../0.46/qiskit.qobj.QobjMeasurementOption.md | 63 +
.../0.46/qiskit.quantum_info.CNOTDihedral.md | 361 ++
.../qiskit/0.46/qiskit.quantum_info.Chi.md | 395 ++
.../qiskit/0.46/qiskit.quantum_info.Choi.md | 407 ++
.../0.46/qiskit.quantum_info.Clifford.md | 661 +++
.../0.46/qiskit.quantum_info.DensityMatrix.md | 703 +++
.../qiskit/0.46/qiskit.quantum_info.Kraus.md | 395 ++
.../0.46/qiskit.quantum_info.Operator.md | 488 ++
.../qiskit/0.46/qiskit.quantum_info.PTM.md | 403 ++
.../qiskit/0.46/qiskit.quantum_info.Pauli.md | 589 +++
.../0.46/qiskit.quantum_info.PauliList.md | 865 ++++
.../0.46/qiskit.quantum_info.Quaternion.md | 126 +
.../0.46/qiskit.quantum_info.ScalarOp.md | 302 ++
.../0.46/qiskit.quantum_info.SparsePauliOp.md | 881 ++++
.../qiskit.quantum_info.StabilizerState.md | 438 ++
.../0.46/qiskit.quantum_info.Statevector.md | 732 +++
.../0.46/qiskit.quantum_info.Stinespring.md | 399 ++
.../0.46/qiskit.quantum_info.SuperOp.md | 395 ++
.../0.46/qiskit.quantum_info.Z2Symmetries.md | 192 +
.../0.46/qiskit.quantum_info.pauli_basis.md | 31 +
.../qiskit.result.BaseReadoutMitigator.md | 69 +
...iskit.result.CorrelatedReadoutMitigator.md | 166 +
docs/api/qiskit/0.46/qiskit.result.Counts.md | 204 +
.../qiskit.result.LocalReadoutMitigator.md | 172 +
.../0.46/qiskit.result.ProbDistribution.md | 161 +
.../0.46/qiskit.result.QuasiDistribution.md | 199 +
docs/api/qiskit/0.46/qiskit.result.Result.md | 258 ++
.../qiskit/0.46/qiskit.result.ResultError.md | 34 +
.../qiskit.synthesis.EvolutionSynthesis.md | 56 +
.../0.46/qiskit.synthesis.LieTrotter.md | 79 +
.../qiskit.synthesis.MatrixExponential.md | 58 +
...iskit.synthesis.OneQubitEulerDecomposer.md | 106 +
.../0.46/qiskit.synthesis.ProductFormula.md | 66 +
.../qiskit/0.46/qiskit.synthesis.QDrift.md | 68 +
...it.synthesis.SolovayKitaevDecomposition.md | 93 +
.../0.46/qiskit.synthesis.SuzukiTrotter.md | 86 +
...iskit.synthesis.TwoQubitBasisDecomposer.md | 89 +
.../0.46/qiskit.synthesis.XXDecomposer.md | 41 +
.../0.46/qiskit.synthesis.unitary.aqc.AQC.md | 49 +
...ynthesis.unitary.aqc.ApproximateCircuit.md | 240 +
...esis.unitary.aqc.ApproximatingObjective.md | 74 +
...t.synthesis.unitary.aqc.CNOTUnitCircuit.md | 242 +
...synthesis.unitary.aqc.CNOTUnitObjective.md | 43 +
...is.unitary.aqc.DefaultCNOTUnitObjective.md | 85 +
...hesis.unitary.aqc.FastCNOTUnitObjective.md | 69 +
.../0.46/qiskit.transpiler.AnalysisPass.md | 109 +
.../0.46/qiskit.transpiler.CouplingMap.md | 426 ++
.../qiskit.transpiler.FencedDAGCircuit.md | 22 +
.../qiskit.transpiler.FencedPropertySet.md | 22 +
.../qiskit.transpiler.InstructionDurations.md | 116 +
...qiskit.transpiler.InstructionProperties.md | 52 +
.../qiskit/0.46/qiskit.transpiler.Layout.md | 267 ++
.../0.46/qiskit.transpiler.PassManager.md | 217 +
.../qiskit.transpiler.PassManagerConfig.md | 70 +
.../qiskit.transpiler.StagedPassManager.md | 241 +
.../qiskit/0.46/qiskit.transpiler.Target.md | 649 +++
.../qiskit.transpiler.TransformationPass.md | 109 +
.../0.46/qiskit.transpiler.TranspileLayout.md | 234 +
.../qiskit.transpiler.passes.ALAPSchedule.md | 130 +
....transpiler.passes.ALAPScheduleAnalysis.md | 133 +
...it.transpiler.passes.AQCSynthesisPlugin.md | 181 +
.../qiskit.transpiler.passes.ASAPSchedule.md | 134 +
....transpiler.passes.ASAPScheduleAnalysis.md | 133 +
.../qiskit.transpiler.passes.AlignMeasures.md | 165 +
.../qiskit.transpiler.passes.ApplyLayout.md | 121 +
...r.passes.BarrierBeforeFinalMeasurements.md | 103 +
.../qiskit.transpiler.passes.BasicSwap.md | 127 +
...iskit.transpiler.passes.BasisTranslator.md | 172 +
.../qiskit.transpiler.passes.CSPLayout.md | 118 +
...qiskit.transpiler.passes.CXCancellation.md | 113 +
...it.transpiler.passes.CheckGateDirection.md | 114 +
.../0.46/qiskit.transpiler.passes.CheckMap.md | 116 +
.../qiskit.transpiler.passes.Collect1qRuns.md | 105 +
...iskit.transpiler.passes.Collect2qBlocks.md | 105 +
...skit.transpiler.passes.CollectCliffords.md | 119 +
...ranspiler.passes.CollectLinearFunctions.md | 119 +
...t.transpiler.passes.CollectMultiQBlocks.md | 133 +
...t.transpiler.passes.CommutationAnalysis.md | 105 +
...anspiler.passes.CommutativeCancellation.md | 130 +
...r.passes.CommutativeInverseCancellation.md | 113 +
...transpiler.passes.Commuting2qGateRouter.md | 206 +
...kit.transpiler.passes.ConsolidateBlocks.md | 121 +
...transpiler.passes.ConstrainedReschedule.md | 175 +
...t.transpiler.passes.ContainsInstruction.md | 110 +
...nspiler.passes.ConvertConditionsToIfOps.md | 111 +
.../0.46/qiskit.transpiler.passes.CountOps.md | 103 +
...t.transpiler.passes.CountOpsLongestPath.md | 103 +
...spiler.passes.CrosstalkAdaptiveSchedule.md | 343 ++
.../qiskit.transpiler.passes.DAGFixedPoint.md | 103 +
...qiskit.transpiler.passes.DAGLongestPath.md | 101 +
.../qiskit.transpiler.passes.Decompose.md | 119 +
.../qiskit.transpiler.passes.DenseLayout.md | 125 +
.../0.46/qiskit.transpiler.passes.Depth.md | 105 +
...t.transpiler.passes.DynamicalDecoupling.md | 202 +
...nspiler.passes.EchoRZXWeylDecomposition.md | 128 +
...it.transpiler.passes.EnlargeWithAncilla.md | 119 +
.../qiskit.transpiler.passes.FixedPoint.md | 109 +
...transpiler.passes.FullAncillaAllocation.md | 141 +
.../qiskit.transpiler.passes.GateDirection.md | 153 +
.../qiskit.transpiler.passes.GatesInBasis.md | 108 +
...it.transpiler.passes.HighLevelSynthesis.md | 152 +
...qiskit.transpiler.passes.HoareOptimizer.md | 119 +
...nspiler.passes.InstructionDurationCheck.md | 118 +
...t.transpiler.passes.InverseCancellation.md | 123 +
...skit.transpiler.passes.Layout2qDistance.md | 110 +
...nspiler.passes.LinearFunctionsSynthesis.md | 124 +
...er.passes.LinearFunctionsToPermutations.md | 109 +
.../qiskit.transpiler.passes.LookaheadSwap.md | 145 +
...transpiler.passes.MergeAdjacentBarriers.md | 138 +
.../qiskit.transpiler.passes.MinimumPoint.md | 121 +
...t.transpiler.passes.NoiseAdaptiveLayout.md | 156 +
...skit.transpiler.passes.NormalizeRXAngle.md | 156 +
...skit.transpiler.passes.NumTensorFactors.md | 103 +
...iskit.transpiler.passes.Optimize1qGates.md | 158 +
...ler.passes.Optimize1qGatesDecomposition.md | 129 +
...passes.Optimize1qGatesSimpleCommutation.md | 123 +
...kit.transpiler.passes.OptimizeCliffords.md | 113 +
.../0.46/qiskit.transpiler.passes.PadDelay.md | 149 +
...ranspiler.passes.PadDynamicalDecoupling.md | 207 +
.../qiskit.transpiler.passes.PulseGates.md | 178 +
....transpiler.passes.RXCalibrationBuilder.md | 187 +
...transpiler.passes.RZXCalibrationBuilder.md | 199 +
...iler.passes.RZXCalibrationBuilderNoEcho.md | 201 +
...qiskit.transpiler.passes.RemoveBarriers.md | 124 +
...passes.RemoveDiagonalGatesBeforeMeasure.md | 115 +
...anspiler.passes.RemoveFinalMeasurements.md | 117 +
...ranspiler.passes.RemoveResetInZeroState.md | 113 +
....passes.ResetAfterMeasureSimplification.md | 103 +
.../qiskit.transpiler.passes.SabreLayout.md | 213 +
...qiskit.transpiler.passes.SabrePreLayout.md | 171 +
.../qiskit.transpiler.passes.SabreSwap.md | 178 +
.../qiskit.transpiler.passes.SetIOLatency.md | 116 +
.../qiskit.transpiler.passes.SetLayout.md | 126 +
.../0.46/qiskit.transpiler.passes.Size.md | 107 +
.../qiskit.transpiler.passes.SolovayKitaev.md | 206 +
...ranspiler.passes.SolovayKitaevSynthesis.md | 173 +
...qiskit.transpiler.passes.StochasticSwap.md | 139 +
....transpiler.passes.TemplateOptimization.md | 122 +
...it.transpiler.passes.TimeUnitConversion.md | 132 +
...iler.passes.TranslateParameterizedGates.md | 174 +
.../qiskit.transpiler.passes.TrivialLayout.md | 125 +
...skit.transpiler.passes.UnitarySynthesis.md | 135 +
...qiskit.transpiler.passes.Unroll3qOrMore.md | 124 +
...anspiler.passes.UnrollCustomDefinitions.md | 136 +
...qiskit.transpiler.passes.UnrollForLoops.md | 123 +
.../0.46/qiskit.transpiler.passes.Unroller.md | 131 +
.../qiskit.transpiler.passes.VF2Layout.md | 137 +
.../qiskit.transpiler.passes.VF2PostLayout.md | 139 +
...it.transpiler.passes.ValidatePulseGates.md | 132 +
.../0.46/qiskit.transpiler.passes.Width.md | 103 +
...nthesis.plugin.HighLevelSynthesisPlugin.md | 48 +
....plugin.HighLevelSynthesisPluginManager.md | 36 +
...synthesis.plugin.UnitarySynthesisPlugin.md | 200 +
...is.plugin.UnitarySynthesisPluginManager.md | 20 +
...s.plugin.unitary_synthesis_plugin_names.md | 26 +
...smanagers.plugin.PassManagerStagePlugin.md | 39 +
...rs.plugin.PassManagerStagePluginManager.md | 32 +
.../0.46/qiskit.utils.QuantumInstance.md | 316 ++
...kit.utils.mitigation.CompleteMeasFitter.md | 128 +
...kit.utils.mitigation.TensoredMeasFitter.md | 139 +
.../qiskit.visualization.array_to_latex.md | 51 +
...ualization.circuit.qcstyle.DefaultStyle.md | 161 +
.../qiskit.visualization.circuit_drawer.md | 91 +
.../0.46/qiskit.visualization.dag_drawer.md | 62 +
...iskit.visualization.pass_manager_drawer.md | 62 +
...it.visualization.plot_bloch_multivector.md | 85 +
.../qiskit.visualization.plot_bloch_vector.md | 62 +
...iskit.visualization.plot_circuit_layout.md | 62 +
.../qiskit.visualization.plot_coupling_map.md | 62 +
.../qiskit.visualization.plot_distribution.md | 79 +
.../qiskit.visualization.plot_error_map.md | 51 +
.../qiskit.visualization.plot_gate_map.md | 62 +
.../qiskit.visualization.plot_histogram.md | 84 +
.../qiskit.visualization.plot_state_city.md | 89 +
.../qiskit.visualization.plot_state_hinton.md | 62 +
...iskit.visualization.plot_state_paulivec.md | 92 +
...qiskit.visualization.plot_state_qsphere.md | 81 +
...qiskit.visualization.pulse.IQXDebugging.md | 113 +
.../qiskit.visualization.pulse.IQXSimple.md | 110 +
.../qiskit.visualization.pulse.IQXStandard.md | 110 +
.../0.46/qiskit.visualization.pulse_drawer.md | 323 ++
.../qiskit.visualization.timeline_drawer.md | 321 ++
...skit.visualization.visualize_transition.md | 39 +
docs/api/qiskit/0.46/qobj.md | 51 +
docs/api/qiskit/0.46/qpy.md | 1088 +++++
docs/api/qiskit/0.46/quantum_info.md | 944 ++++
docs/api/qiskit/0.46/result.md | 160 +
docs/api/qiskit/0.46/scheduler.md | 122 +
docs/api/qiskit/0.46/synthesis.md | 729 +++
docs/api/qiskit/0.46/synthesis_aqc.md | 168 +
docs/api/qiskit/0.46/tools.md | 140 +
docs/api/qiskit/0.46/tools_jupyter.md | 86 +
docs/api/qiskit/0.46/transpiler.md | 980 ++++
.../qiskit/0.46/transpiler_builtin_plugins.md | 8 +
docs/api/qiskit/0.46/transpiler_passes.md | 162 +
docs/api/qiskit/0.46/transpiler_plugins.md | 170 +
docs/api/qiskit/0.46/transpiler_preset.md | 398 ++
.../0.46/transpiler_synthesis_plugins.md | 169 +
docs/api/qiskit/0.46/utils.md | 712 +++
docs/api/qiskit/0.46/utils_mitigation.md | 37 +
docs/api/qiskit/0.46/visualization.md | 245 +
public/images/api/qiskit/0.46/circuit-1.png | Bin 0 -> 4978 bytes
public/images/api/qiskit/0.46/circuit-2.png | Bin 0 -> 3885 bytes
public/images/api/qiskit/0.46/circuit-3.png | Bin 0 -> 5628 bytes
public/images/api/qiskit/0.46/circuit-4.png | Bin 0 -> 27444 bytes
public/images/api/qiskit/0.46/circuit-5.png | Bin 0 -> 7137 bytes
.../api/qiskit/0.46/circuit_library-1.png | Bin 0 -> 5904 bytes
.../images/api/qiskit/0.46/converters-1.png | Bin 0 -> 8110 bytes
public/images/api/qiskit/0.46/depth.gif | Bin 0 -> 2874095 bytes
public/images/api/qiskit/0.46/mapping.png | Bin 0 -> 60165 bytes
.../0.46/providers_fake_provider-1_00.png | Bin 0 -> 12644 bytes
.../0.46/providers_fake_provider-1_01.png | Bin 0 -> 21668 bytes
.../0.46/providers_fake_provider-1_02.png | Bin 0 -> 14483 bytes
public/images/api/qiskit/0.46/pulse-1.png | Bin 0 -> 15975 bytes
public/images/api/qiskit/0.46/pulse-2.png | Bin 0 -> 16712 bytes
public/images/api/qiskit/0.46/pulse-3.png | Bin 0 -> 31312 bytes
public/images/api/qiskit/0.46/pulse-4.png | Bin 0 -> 11069 bytes
public/images/api/qiskit/0.46/pulse-5.png | Bin 0 -> 54614 bytes
public/images/api/qiskit/0.46/pulse-6.png | Bin 0 -> 19242 bytes
public/images/api/qiskit/0.46/pulse-7.png | Bin 0 -> 16404 bytes
public/images/api/qiskit/0.46/pulse-8.png | Bin 0 -> 11645 bytes
public/images/api/qiskit/0.46/pulse-9.png | Bin 0 -> 14096 bytes
public/images/api/qiskit/0.46/qasm3-1.png | Bin 0 -> 25454 bytes
.../0.46/qiskit-circuit-ControlledGate-1.png | Bin 0 -> 4422 bytes
.../0.46/qiskit-circuit-ControlledGate-2.png | Bin 0 -> 6965 bytes
.../0.46/qiskit-circuit-InstructionSet-1.png | Bin 0 -> 8858 bytes
.../0.46/qiskit-circuit-Operation-1.png | Bin 0 -> 5552 bytes
.../0.46/qiskit-circuit-Parameter-1_00.png | Bin 0 -> 1697 bytes
.../0.46/qiskit-circuit-Parameter-1_01.png | Bin 0 -> 5365 bytes
.../0.46/qiskit-circuit-QuantumCircuit-1.png | Bin 0 -> 6702 bytes
.../0.46/qiskit-circuit-QuantumCircuit-2.png | Bin 0 -> 15875 bytes
.../qiskit-circuit-QuantumCircuit-3_00.png | Bin 0 -> 3595 bytes
.../qiskit-circuit-QuantumCircuit-3_01.png | Bin 0 -> 3580 bytes
.../qiskit-circuit-QuantumCircuit-4_00.png | Bin 0 -> 3527 bytes
.../qiskit-circuit-QuantumCircuit-4_01.png | Bin 0 -> 3850 bytes
.../0.46/qiskit-circuit-QuantumCircuit-5.png | Bin 0 -> 3673 bytes
.../0.46/qiskit-circuit-QuantumCircuit-6.png | Bin 0 -> 4169 bytes
.../0.46/qiskit-circuit-library-AND-1.png | Bin 0 -> 16847 bytes
.../0.46/qiskit-circuit-library-AND-2.png | Bin 0 -> 17434 bytes
...skit-circuit-library-FourierChecking-1.png | Bin 0 -> 11424 bytes
.../0.46/qiskit-circuit-library-GMS-1.png | Bin 0 -> 12635 bytes
.../0.46/qiskit-circuit-library-GR-1.png | Bin 0 -> 18949 bytes
.../0.46/qiskit-circuit-library-GRX-1.png | Bin 0 -> 18704 bytes
.../0.46/qiskit-circuit-library-GRY-1.png | Bin 0 -> 18949 bytes
.../0.46/qiskit-circuit-library-GRZ-1.png | Bin 0 -> 12178 bytes
.../qiskit-circuit-library-GraphState-1.png | Bin 0 -> 15618 bytes
...circuit-library-HiddenLinearFunction-1.png | Bin 0 -> 12956 bytes
.../0.46/qiskit-circuit-library-IQP-1.png | Bin 0 -> 6586 bytes
.../0.46/qiskit-circuit-library-IQP-2.png | Bin 0 -> 14797 bytes
.../qiskit-circuit-library-InnerProduct-1.png | Bin 0 -> 14228 bytes
.../qiskit-circuit-library-MCMTVChain-1.png | Bin 0 -> 13705 bytes
.../0.46/qiskit-circuit-library-OR-1.png | Bin 0 -> 20190 bytes
.../0.46/qiskit-circuit-library-OR-2.png | Bin 0 -> 18418 bytes
...iskit-circuit-library-PauliTwoDesign-1.png | Bin 0 -> 10634 bytes
.../qiskit-circuit-library-Permutation-1.png | Bin 0 -> 9125 bytes
.../qiskit-circuit-library-Permutation-2.png | Bin 0 -> 15619 bytes
...skit-circuit-library-PermutationGate-1.png | Bin 0 -> 7652 bytes
...skit-circuit-library-PermutationGate-2.png | Bin 0 -> 15209 bytes
...skit-circuit-library-PhaseEstimation-1.png | Bin 0 -> 12047 bytes
...t-circuit-library-PiecewiseChebyshev-1.png | Bin 0 -> 7651 bytes
.../0.46/qiskit-circuit-library-QFT-1.png | Bin 0 -> 11619 bytes
.../0.46/qiskit-circuit-library-QFT-2.png | Bin 0 -> 11789 bytes
.../0.46/qiskit-circuit-library-QFT-3.png | Bin 0 -> 11890 bytes
...qiskit-circuit-library-QuantumVolume-1.png | Bin 0 -> 9480 bytes
...qiskit-circuit-library-QuantumVolume-2.png | Bin 0 -> 18170 bytes
.../0.46/qiskit-circuit-library-XOR-1.png | Bin 0 -> 12576 bytes
.../qiskit-pulse-library-SymbolicPulse-1.png | Bin 0 -> 11401 bytes
.../qiskit-quantum_info-Statevector-1.png | Bin 0 -> 7558 bytes
...spiler-passes-DynamicalDecoupling-1_00.png | Bin 0 -> 22803 bytes
...spiler-passes-DynamicalDecoupling-1_01.png | Bin 0 -> 23583 bytes
...ler-passes-PadDynamicalDecoupling-1_00.png | Bin 0 -> 22803 bytes
...ler-passes-PadDynamicalDecoupling-1_01.png | Bin 0 -> 23583 bytes
...kit-transpiler-passes-RemoveBarriers-1.png | Bin 0 -> 1561 bytes
.../qiskit-visualization-circuit_drawer-1.png | Bin 0 -> 3934 bytes
...visualization-plot_bloch_multivector-1.png | Bin 0 -> 92847 bytes
...visualization-plot_bloch_multivector-2.png | Bin 0 -> 95603 bytes
...skit-visualization-plot_bloch_vector-1.png | Bin 0 -> 73448 bytes
...skit-visualization-plot_bloch_vector-2.png | Bin 0 -> 74554 bytes
...it-visualization-plot_circuit_layout-1.png | Bin 0 -> 8112 bytes
...skit-visualization-plot_coupling_map-1.png | Bin 0 -> 8007 bytes
...t-visualization-plot_distribution-1_00.png | Bin 0 -> 16020 bytes
...t-visualization-plot_distribution-1_01.png | Bin 0 -> 20219 bytes
...t-visualization-plot_distribution-1_02.png | Bin 0 -> 20276 bytes
.../qiskit-visualization-plot_error_map-1.png | Bin 0 -> 37014 bytes
.../qiskit-visualization-plot_gate_map-1.png | Bin 0 -> 7345 bytes
...skit-visualization-plot_histogram-1_00.png | Bin 0 -> 12434 bytes
...skit-visualization-plot_histogram-1_01.png | Bin 0 -> 16199 bytes
...skit-visualization-plot_histogram-1_02.png | Bin 0 -> 16249 bytes
...qiskit-visualization-plot_state_city-1.png | Bin 0 -> 117324 bytes
...qiskit-visualization-plot_state_city-2.png | Bin 0 -> 159875 bytes
...skit-visualization-plot_state_hinton-1.png | Bin 0 -> 11116 bytes
...it-visualization-plot_state_paulivec-1.png | Bin 0 -> 17337 bytes
...it-visualization-plot_state_paulivec-2.png | Bin 0 -> 18522 bytes
...kit-visualization-plot_state_qsphere-1.png | Bin 0 -> 33861 bytes
...kit-visualization-plot_state_qsphere-2.png | Bin 0 -> 38572 bytes
.../qiskit-visualization-pulse_drawer-1.png | Bin 0 -> 63840 bytes
.../qiskit-visualization-pulse_drawer-2.png | Bin 0 -> 29394 bytes
.../qiskit-visualization-pulse_drawer-3.png | Bin 0 -> 79687 bytes
...qiskit-visualization-timeline_drawer-1.png | Bin 0 -> 29867 bytes
...qiskit-visualization-timeline_drawer-2.png | Bin 0 -> 7453 bytes
...qiskit-visualization-timeline_drawer-3.png | Bin 0 -> 69676 bytes
.../images/api/qiskit/0.46/transpiler-10.png | Bin 0 -> 7906 bytes
.../images/api/qiskit/0.46/transpiler-11.png | Bin 0 -> 32887 bytes
.../images/api/qiskit/0.46/transpiler-12.png | Bin 0 -> 8856 bytes
.../images/api/qiskit/0.46/transpiler-13.png | Bin 0 -> 32887 bytes
.../images/api/qiskit/0.46/transpiler-14.png | Bin 0 -> 19570 bytes
.../images/api/qiskit/0.46/transpiler-15.png | Bin 0 -> 8855 bytes
.../images/api/qiskit/0.46/transpiler-16.png | Bin 0 -> 91600 bytes
.../images/api/qiskit/0.46/transpiler-17.png | Bin 0 -> 35255 bytes
.../images/api/qiskit/0.46/transpiler-4.png | Bin 0 -> 6224 bytes
.../images/api/qiskit/0.46/transpiler-5.png | Bin 0 -> 19791 bytes
.../images/api/qiskit/0.46/transpiler-6.png | Bin 0 -> 9344 bytes
.../images/api/qiskit/0.46/transpiler-7.png | Bin 0 -> 11696 bytes
.../images/api/qiskit/0.46/transpiler-8.png | Bin 0 -> 8194 bytes
.../images/api/qiskit/0.46/transpiler-9.png | Bin 0 -> 8392 bytes
.../qiskit/0.46/transpiling_core_steps.png | Bin 0 -> 246632 bytes
.../api/qiskit/0.46/visualization-1.png | Bin 0 -> 10426 bytes
.../api/qiskit/0.46/visualization-2.png | Bin 0 -> 17293 bytes
.../api/qiskit/0.46/visualization-3.png | Bin 0 -> 10033 bytes
.../api/qiskit/0.46/visualization-4.png | Bin 0 -> 108756 bytes
.../api/qiskit/0.46/visualization-5.png | Bin 0 -> 113083 bytes
.../api/qiskit/0.46/visualization-6.png | Bin 0 -> 113083 bytes
931 files changed, 158491 insertions(+)
create mode 100644 docs/api/qiskit/0.46/_package.json
create mode 100644 docs/api/qiskit/0.46/_toc.json
create mode 100644 docs/api/qiskit/0.46/algorithms.md
create mode 100644 docs/api/qiskit/0.46/assembler.md
create mode 100644 docs/api/qiskit/0.46/circuit.md
create mode 100644 docs/api/qiskit/0.46/circuit_classical.md
create mode 100644 docs/api/qiskit/0.46/circuit_library.md
create mode 100644 docs/api/qiskit/0.46/circuit_singleton.md
create mode 100644 docs/api/qiskit/0.46/classicalfunction.md
create mode 100644 docs/api/qiskit/0.46/compiler.md
create mode 100644 docs/api/qiskit/0.46/converters.md
create mode 100644 docs/api/qiskit/0.46/dagcircuit.md
create mode 100644 docs/api/qiskit/0.46/exceptions.md
create mode 100644 docs/api/qiskit/0.46/execute.md
create mode 100644 docs/api/qiskit/0.46/extensions.md
create mode 100644 docs/api/qiskit/0.46/index.md
create mode 100644 docs/api/qiskit/0.46/opflow.md
create mode 100644 docs/api/qiskit/0.46/passmanager.md
create mode 100644 docs/api/qiskit/0.46/primitives.md
create mode 100644 docs/api/qiskit/0.46/providers.md
create mode 100644 docs/api/qiskit/0.46/providers_basic_provider.md
create mode 100644 docs/api/qiskit/0.46/providers_basicaer.md
create mode 100644 docs/api/qiskit/0.46/providers_fake_provider.md
create mode 100644 docs/api/qiskit/0.46/providers_models.md
create mode 100644 docs/api/qiskit/0.46/pulse.md
create mode 100644 docs/api/qiskit/0.46/qasm.md
create mode 100644 docs/api/qiskit/0.46/qasm2.md
create mode 100644 docs/api/qiskit/0.46/qasm3.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.AlgorithmJob.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.AmplificationProblem.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.AmplitudeAmplifier.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.AmplitudeEstimation.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.AmplitudeEstimationResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.AmplitudeEstimator.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.AmplitudeEstimatorResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.Eigensolver.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.EigensolverResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.EstimationProblem.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.EvolutionProblem.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.EvolutionResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.FasterAmplitudeEstimation.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.FasterAmplitudeEstimationResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.Grover.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.GroverResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.HamiltonianPhaseEstimation.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.HamiltonianPhaseEstimationResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.ImaginaryEvolver.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.ImaginaryTimeEvolver.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.IterativeAmplitudeEstimation.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.IterativeAmplitudeEstimationResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.IterativePhaseEstimation.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.MaximumLikelihoodAmplitudeEstimation.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.MaximumLikelihoodAmplitudeEstimationResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.MinimumEigensolver.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.MinimumEigensolverResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.NumPyEigensolver.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.NumPyMinimumEigensolver.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.PVQD.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.PVQDResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.PhaseEstimation.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.PhaseEstimationResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.PhaseEstimationScale.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.QAOA.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.RealEvolver.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.RealTimeEvolver.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.SciPyImaginaryEvolver.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.SciPyRealEvolver.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.TimeEvolutionProblem.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.TimeEvolutionResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.TrotterQRTE.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.VQD.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.VQDResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.VQE.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.VarQITE.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.VarQRTE.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.Eigensolver.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.EigensolverResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.NumPyEigensolver.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.NumPyEigensolverResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.VQD.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.VQDResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.gradients.BaseEstimatorGradient.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.gradients.BaseQGT.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.gradients.BaseSamplerGradient.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.gradients.EstimatorGradientResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.gradients.FiniteDiffEstimatorGradient.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.gradients.FiniteDiffSamplerGradient.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.gradients.LinCombEstimatorGradient.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.gradients.LinCombQGT.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.gradients.LinCombSamplerGradient.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.gradients.ParamShiftEstimatorGradient.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.gradients.ParamShiftSamplerGradient.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.gradients.QFI.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.gradients.QFIResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.gradients.QGTResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.gradients.ReverseEstimatorGradient.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.gradients.ReverseQGT.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.gradients.SPSAEstimatorGradient.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.gradients.SPSASamplerGradient.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.gradients.SamplerGradientResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.gradients.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.AdaptVQE.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.AdaptVQEResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.MinimumEigensolver.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.MinimumEigensolverResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolver.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolverResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.QAOA.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolver.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolverResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.SamplingVQE.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.VQE.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.VQEResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.ADAM.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.AQGD.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.AskData.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.BOBYQA.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.CG.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.COBYLA.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.CRS.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.DIRECT_L.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.DIRECT_L_RAND.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.ESCH.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.GSLS.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.GradientDescent.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.GradientDescentState.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.IMFIL.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.ISRES.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.L_BFGS_B.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.Minimizer.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.NELDER_MEAD.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.NFT.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.Optimizer.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.OptimizerResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.OptimizerState.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.OptimizerSupportLevel.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.POWELL.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.P_BFGS.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.QNSPSA.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.SLSQP.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.SNOBFIT.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.SPSA.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.SciPyOptimizer.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.SteppableOptimizer.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.TNC.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.TellData.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.UMDA.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.optimizer_utils.LearningRate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.optimizers.optimizer_utils.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.state_fidelities.BaseStateFidelity.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.state_fidelities.ComputeUncompute.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.state_fidelities.StateFidelityResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.state_fidelities.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.trotterization.TrotterQRTE.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.trotterization.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.ForwardEulerSolver.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.ImaginaryMcLachlanPrinciple.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.ImaginaryVariationalPrinciple.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.RealMcLachlanPrinciple.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.RealVariationalPrinciple.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.VariationalPrinciple.md
create mode 100644 docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.md
create mode 100644 docs/api/qiskit/0.46/qiskit.assembler.RunConfig.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.AncillaQubit.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.AncillaRegister.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.AnnotatedOperation.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.Bit.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.BreakLoopOp.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.CircuitInstruction.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.ClassicalRegister.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.Clbit.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.CommutationChecker.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.ContinueLoopOp.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.ControlFlowOp.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.ControlModifier.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.ControlledGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.Delay.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.EquivalenceLibrary.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.ForLoopOp.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.Gate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.IfElseOp.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.Instruction.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.InstructionSet.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.InverseModifier.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.Operation.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.Parameter.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.ParameterExpression.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.ParameterVector.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.PowerModifier.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.QuantumCircuit.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.QuantumRegister.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.Qubit.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.Register.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.SwitchCaseOp.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.WhileLoopOp.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.classicalfunction.BooleanExpression.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.classicalfunction.ClassicalFunction.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.classicalfunction.ClassicalFunctionCompilerTypeError.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.classicalfunction.ClassicalFunctionParseError.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.AND.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.Barrier.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.C3SXGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.C3XGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.C4XGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.CCXGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.CCZGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.CDKMRippleCarryAdder.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.CHGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.CPhaseGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.CRXGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.CRYGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.CRZGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.CSGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.CSXGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.CSdgGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.CSwapGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.CU1Gate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.CU3Gate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.CUGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.CXGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.CYGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.CZGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.DCXGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.Diagonal.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.DiagonalGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.DraperQFTAdder.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.ECRGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.EfficientSU2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.EvolvedOperatorAnsatz.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.ExactReciprocal.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.ExcitationPreserving.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.FourierChecking.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.FunctionalPauliRotations.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.GMS.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.GR.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.GRX.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.GRY.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.GRZ.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.GlobalPhaseGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.GraphState.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.GroverOperator.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.HGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.HRSCumulativeMultiplier.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.HamiltonianGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.HiddenLinearFunction.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.IGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.IQP.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.Initialize.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.InnerProduct.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.IntegerComparator.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.Isometry.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.LinearAmplitudeFunction.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.LinearFunction.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.LinearPauliRotations.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.MCMT.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.MCMTVChain.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.MCPhaseGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.MCXGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.MCXGrayCode.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.MCXRecursive.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.MCXVChain.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.MSGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.Measure.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.NLocal.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.OR.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.PauliEvolutionGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.PauliFeatureMap.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.PauliGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.PauliTwoDesign.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.Permutation.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.PermutationGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.PhaseEstimation.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.PhaseGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.PhaseOracle.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.PiecewiseChebyshev.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.PiecewiseLinearPauliRotations.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.PiecewisePolynomialPauliRotations.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.PolynomialPauliRotations.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.QAOAAnsatz.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.QFT.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.QuadraticForm.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.QuantumVolume.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.RC3XGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.RCCXGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.RGQFTMultiplier.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.RGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.RVGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.RXGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.RXXGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.RYGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.RYYGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.RZGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.RZXGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.RZZGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.RealAmplitudes.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.Reset.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.SGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.SXGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.SXdgGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.SdgGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.StatePreparation.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.SwapGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.TGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.TdgGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.TwoLocal.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.U1Gate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.U2Gate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.U3Gate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.UCGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.UCPauliRotGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.UCRXGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.UCRYGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.UCRZGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.UGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.UnitaryGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.UnitaryOverlap.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.VBERippleCarryAdder.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.WeightedAdder.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.XGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.XOR.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.XXMinusYYGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.XXPlusYYGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.YGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.ZFeatureMap.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.ZGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.ZZFeatureMap.md
create mode 100644 docs/api/qiskit/0.46/qiskit.circuit.library.iSwapGate.md
create mode 100644 docs/api/qiskit/0.46/qiskit.dagcircuit.DAGCircuit.md
create mode 100644 docs/api/qiskit/0.46/qiskit.dagcircuit.DAGDepNode.md
create mode 100644 docs/api/qiskit/0.46/qiskit.dagcircuit.DAGDependency.md
create mode 100644 docs/api/qiskit/0.46/qiskit.dagcircuit.DAGInNode.md
create mode 100644 docs/api/qiskit/0.46/qiskit.dagcircuit.DAGNode.md
create mode 100644 docs/api/qiskit/0.46/qiskit.dagcircuit.DAGOpNode.md
create mode 100644 docs/api/qiskit/0.46/qiskit.dagcircuit.DAGOutNode.md
create mode 100644 docs/api/qiskit/0.46/qiskit.extensions.SingleQubitUnitary.md
create mode 100644 docs/api/qiskit/0.46/qiskit.extensions.Snapshot.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.OperatorBase.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.converters.AbelianGrouper.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.converters.CircuitSampler.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.converters.ConverterBase.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.converters.DictToCircuitSum.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.converters.PauliBasisChange.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.converters.TwoQubitReduction.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.converters.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.evolutions.EvolutionBase.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.evolutions.EvolutionFactory.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.evolutions.EvolvedOp.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.evolutions.MatrixEvolution.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.evolutions.PauliTrotterEvolution.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.evolutions.QDrift.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.evolutions.Suzuki.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.evolutions.Trotter.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.evolutions.TrotterizationBase.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.evolutions.TrotterizationFactory.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.evolutions.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.expectations.AerPauliExpectation.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.expectations.CVaRExpectation.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.expectations.ExpectationBase.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.expectations.ExpectationFactory.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.expectations.MatrixExpectation.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.expectations.PauliExpectation.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.expectations.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.gradients.CircuitGradient.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.gradients.CircuitQFI.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.gradients.DerivativeBase.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.gradients.Gradient.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.gradients.GradientBase.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.gradients.Hessian.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.gradients.HessianBase.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.gradients.NaturalGradient.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.gradients.QFI.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.gradients.QFIBase.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.gradients.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.list_ops.ComposedOp.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.list_ops.ListOp.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.list_ops.SummedOp.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.list_ops.TensoredOp.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.list_ops.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.CircuitOp.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.MatrixOp.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.PauliOp.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.PauliSumOp.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.PrimitiveOp.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.TaperedPauliSumOp.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.Z2Symmetries.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.state_fns.CVaRMeasurement.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.state_fns.CircuitStateFn.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.state_fns.DictStateFn.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.state_fns.OperatorStateFn.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.state_fns.SparseVectorStateFn.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.state_fns.StateFn.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.state_fns.VectorStateFn.md
create mode 100644 docs/api/qiskit/0.46/qiskit.opflow.state_fns.md
create mode 100644 docs/api/qiskit/0.46/qiskit.passmanager.BaseController.md
create mode 100644 docs/api/qiskit/0.46/qiskit.passmanager.BasePassManager.md
create mode 100644 docs/api/qiskit/0.46/qiskit.passmanager.ConditionalController.md
create mode 100644 docs/api/qiskit/0.46/qiskit.passmanager.DoWhileController.md
create mode 100644 docs/api/qiskit/0.46/qiskit.passmanager.FlowController.md
create mode 100644 docs/api/qiskit/0.46/qiskit.passmanager.FlowControllerLinear.md
create mode 100644 docs/api/qiskit/0.46/qiskit.passmanager.GenericPass.md
create mode 100644 docs/api/qiskit/0.46/qiskit.passmanager.PassManagerState.md
create mode 100644 docs/api/qiskit/0.46/qiskit.passmanager.PropertySet.md
create mode 100644 docs/api/qiskit/0.46/qiskit.passmanager.WorkflowStatus.md
create mode 100644 docs/api/qiskit/0.46/qiskit.primitives.BackendEstimator.md
create mode 100644 docs/api/qiskit/0.46/qiskit.primitives.BackendSampler.md
create mode 100644 docs/api/qiskit/0.46/qiskit.primitives.BaseEstimator.md
create mode 100644 docs/api/qiskit/0.46/qiskit.primitives.BaseSampler.md
create mode 100644 docs/api/qiskit/0.46/qiskit.primitives.Estimator.md
create mode 100644 docs/api/qiskit/0.46/qiskit.primitives.EstimatorResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.primitives.Sampler.md
create mode 100644 docs/api/qiskit/0.46/qiskit.primitives.SamplerResult.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.Backend.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.BackendV1.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.BackendV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.BackendV2Converter.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.Job.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.JobStatus.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.JobV1.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.Options.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.Provider.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.ProviderV1.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.QubitProperties.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.basic_provider.BasicProvider.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.basic_provider.BasicProviderError.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.basic_provider.BasicProviderJob.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.basic_provider.BasicSimulator.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.basicaer.BasicAerError.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.basicaer.BasicAerJob.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.basicaer.BasicAerProvider.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.basicaer.QasmSimulatorPy.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.basicaer.StatevectorSimulatorPy.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.basicaer.UnitarySimulatorPy.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.convert_to_target.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.ConfigurableFakeBackend.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.Fake1Q.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAlmaden.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAlmadenV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeArmonk.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeArmonkV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAthens.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAthensV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAuckland.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBackend5QV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBackendV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBelem.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBelemV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBoeblingen.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBoeblingenV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBogota.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBogotaV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBrooklyn.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBrooklynV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBurlington.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBurlingtonV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCairo.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCairoV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCambridge.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCambridgeV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCasablanca.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCasablancaV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeEssex.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeEssexV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeGeneva.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeGuadalupe.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeGuadalupeV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeHanoi.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeHanoiV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeJakarta.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeJakartaV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeJohannesburg.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeJohannesburgV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeKolkata.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeKolkataV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLagos.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLagosV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLima.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLimaV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLondon.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLondonV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeManhattan.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeManhattanV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeManila.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeManilaV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMelbourne.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMelbourneV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMontreal.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMontrealV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMumbai.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMumbaiFractionalCX.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMumbaiV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeNairobi.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeNairobiV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOpenPulse2Q.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOpenPulse3Q.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOslo.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOurense.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOurenseV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeParis.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeParisV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakePerth.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakePoughkeepsie.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakePoughkeepsieV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakePrague.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeProvider.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeProviderForBackendV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeQasmSimulator.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeQuito.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeQuitoV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRochester.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRochesterV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRome.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRomeV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRueschlikon.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSantiago.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSantiagoV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSherbrooke.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSingapore.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSingaporeV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSydney.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSydneyV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeTenerife.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeTokyo.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeToronto.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeTorontoV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeValencia.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeValenciaV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeVigo.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeVigoV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeWashington.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeWashingtonV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeYorktown.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeYorktownV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.fake_provider.GenericBackendV2.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.models.BackendConfiguration.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.models.BackendProperties.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.models.BackendStatus.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.models.Command.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.models.GateConfig.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.models.GateProperties.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.models.JobStatus.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.models.Nduv.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.models.PulseBackendConfiguration.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.models.PulseDefaults.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.models.QasmBackendConfiguration.md
create mode 100644 docs/api/qiskit/0.46/qiskit.providers.models.UchannelLO.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.InstructionScheduleMap.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.Schedule.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.ScheduleBlock.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.channels.AcquireChannel.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.channels.ControlChannel.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.channels.DriveChannel.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.channels.MeasureChannel.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.channels.MemorySlot.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.channels.RegisterSlot.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.channels.SnapshotChannel.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.instructions.Acquire.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.instructions.Call.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.instructions.Delay.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.instructions.Play.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.instructions.Reference.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.instructions.RelativeBarrier.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.instructions.SetFrequency.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.instructions.SetPhase.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.instructions.ShiftFrequency.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.instructions.ShiftPhase.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.instructions.Snapshot.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.instructions.TimeBlockade.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.library.Constant_class.rst.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.library.Cos_class.rst.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.library.Drag_class.rst.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.library.GaussianDeriv.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.library.GaussianSquare.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.library.GaussianSquareDrag.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.library.Gaussian_class.rst.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.library.ParametricPulse.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.library.Sawtooth_class.rst.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.library.SechDeriv.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.library.Sech_fun.rst.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.library.Sin_class.rst.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.library.Square_fun.rst.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.library.SymbolicPulse.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.library.Triangle_class.rst.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.library.Waveform.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.library.gaussian_square_echo.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.transforms.AlignEquispaced.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.transforms.AlignFunc.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.transforms.AlignLeft.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.transforms.AlignRight.md
create mode 100644 docs/api/qiskit/0.46/qiskit.pulse.transforms.AlignSequential.md
create mode 100644 docs/api/qiskit/0.46/qiskit.qobj.GateCalibration.md
create mode 100644 docs/api/qiskit/0.46/qiskit.qobj.PulseLibraryItem.md
create mode 100644 docs/api/qiskit/0.46/qiskit.qobj.PulseQobj.md
create mode 100644 docs/api/qiskit/0.46/qiskit.qobj.PulseQobjConfig.md
create mode 100644 docs/api/qiskit/0.46/qiskit.qobj.PulseQobjExperiment.md
create mode 100644 docs/api/qiskit/0.46/qiskit.qobj.PulseQobjExperimentConfig.md
create mode 100644 docs/api/qiskit/0.46/qiskit.qobj.PulseQobjInstruction.md
create mode 100644 docs/api/qiskit/0.46/qiskit.qobj.QasmExperimentCalibrations.md
create mode 100644 docs/api/qiskit/0.46/qiskit.qobj.QasmQobj.md
create mode 100644 docs/api/qiskit/0.46/qiskit.qobj.QasmQobjConfig.md
create mode 100644 docs/api/qiskit/0.46/qiskit.qobj.QasmQobjExperiment.md
create mode 100644 docs/api/qiskit/0.46/qiskit.qobj.QasmQobjExperimentConfig.md
create mode 100644 docs/api/qiskit/0.46/qiskit.qobj.QasmQobjInstruction.md
create mode 100644 docs/api/qiskit/0.46/qiskit.qobj.QobjExperimentHeader.md
create mode 100644 docs/api/qiskit/0.46/qiskit.qobj.QobjHeader.md
create mode 100644 docs/api/qiskit/0.46/qiskit.qobj.QobjMeasurementOption.md
create mode 100644 docs/api/qiskit/0.46/qiskit.quantum_info.CNOTDihedral.md
create mode 100644 docs/api/qiskit/0.46/qiskit.quantum_info.Chi.md
create mode 100644 docs/api/qiskit/0.46/qiskit.quantum_info.Choi.md
create mode 100644 docs/api/qiskit/0.46/qiskit.quantum_info.Clifford.md
create mode 100644 docs/api/qiskit/0.46/qiskit.quantum_info.DensityMatrix.md
create mode 100644 docs/api/qiskit/0.46/qiskit.quantum_info.Kraus.md
create mode 100644 docs/api/qiskit/0.46/qiskit.quantum_info.Operator.md
create mode 100644 docs/api/qiskit/0.46/qiskit.quantum_info.PTM.md
create mode 100644 docs/api/qiskit/0.46/qiskit.quantum_info.Pauli.md
create mode 100644 docs/api/qiskit/0.46/qiskit.quantum_info.PauliList.md
create mode 100644 docs/api/qiskit/0.46/qiskit.quantum_info.Quaternion.md
create mode 100644 docs/api/qiskit/0.46/qiskit.quantum_info.ScalarOp.md
create mode 100644 docs/api/qiskit/0.46/qiskit.quantum_info.SparsePauliOp.md
create mode 100644 docs/api/qiskit/0.46/qiskit.quantum_info.StabilizerState.md
create mode 100644 docs/api/qiskit/0.46/qiskit.quantum_info.Statevector.md
create mode 100644 docs/api/qiskit/0.46/qiskit.quantum_info.Stinespring.md
create mode 100644 docs/api/qiskit/0.46/qiskit.quantum_info.SuperOp.md
create mode 100644 docs/api/qiskit/0.46/qiskit.quantum_info.Z2Symmetries.md
create mode 100644 docs/api/qiskit/0.46/qiskit.quantum_info.pauli_basis.md
create mode 100644 docs/api/qiskit/0.46/qiskit.result.BaseReadoutMitigator.md
create mode 100644 docs/api/qiskit/0.46/qiskit.result.CorrelatedReadoutMitigator.md
create mode 100644 docs/api/qiskit/0.46/qiskit.result.Counts.md
create mode 100644 docs/api/qiskit/0.46/qiskit.result.LocalReadoutMitigator.md
create mode 100644 docs/api/qiskit/0.46/qiskit.result.ProbDistribution.md
create mode 100644 docs/api/qiskit/0.46/qiskit.result.QuasiDistribution.md
create mode 100644 docs/api/qiskit/0.46/qiskit.result.Result.md
create mode 100644 docs/api/qiskit/0.46/qiskit.result.ResultError.md
create mode 100644 docs/api/qiskit/0.46/qiskit.synthesis.EvolutionSynthesis.md
create mode 100644 docs/api/qiskit/0.46/qiskit.synthesis.LieTrotter.md
create mode 100644 docs/api/qiskit/0.46/qiskit.synthesis.MatrixExponential.md
create mode 100644 docs/api/qiskit/0.46/qiskit.synthesis.OneQubitEulerDecomposer.md
create mode 100644 docs/api/qiskit/0.46/qiskit.synthesis.ProductFormula.md
create mode 100644 docs/api/qiskit/0.46/qiskit.synthesis.QDrift.md
create mode 100644 docs/api/qiskit/0.46/qiskit.synthesis.SolovayKitaevDecomposition.md
create mode 100644 docs/api/qiskit/0.46/qiskit.synthesis.SuzukiTrotter.md
create mode 100644 docs/api/qiskit/0.46/qiskit.synthesis.TwoQubitBasisDecomposer.md
create mode 100644 docs/api/qiskit/0.46/qiskit.synthesis.XXDecomposer.md
create mode 100644 docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.AQC.md
create mode 100644 docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.ApproximateCircuit.md
create mode 100644 docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.ApproximatingObjective.md
create mode 100644 docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.CNOTUnitCircuit.md
create mode 100644 docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.CNOTUnitObjective.md
create mode 100644 docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.DefaultCNOTUnitObjective.md
create mode 100644 docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.FastCNOTUnitObjective.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.AnalysisPass.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.CouplingMap.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.FencedDAGCircuit.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.FencedPropertySet.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.InstructionDurations.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.InstructionProperties.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.Layout.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.PassManager.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.PassManagerConfig.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.StagedPassManager.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.Target.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.TransformationPass.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.TranspileLayout.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.ALAPSchedule.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.ALAPScheduleAnalysis.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.AQCSynthesisPlugin.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.ASAPSchedule.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.ASAPScheduleAnalysis.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.AlignMeasures.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.ApplyLayout.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.BarrierBeforeFinalMeasurements.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.BasicSwap.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.BasisTranslator.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.CSPLayout.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.CXCancellation.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.CheckGateDirection.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.CheckMap.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.Collect1qRuns.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.Collect2qBlocks.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.CollectCliffords.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.CollectLinearFunctions.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.CollectMultiQBlocks.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.CommutationAnalysis.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.CommutativeCancellation.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.CommutativeInverseCancellation.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.Commuting2qGateRouter.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.ConsolidateBlocks.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.ConstrainedReschedule.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.ContainsInstruction.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.ConvertConditionsToIfOps.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.CountOps.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.CountOpsLongestPath.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.CrosstalkAdaptiveSchedule.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.DAGFixedPoint.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.DAGLongestPath.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.Decompose.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.DenseLayout.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.Depth.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.DynamicalDecoupling.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.EchoRZXWeylDecomposition.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.EnlargeWithAncilla.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.FixedPoint.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.FullAncillaAllocation.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.GateDirection.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.GatesInBasis.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.HighLevelSynthesis.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.HoareOptimizer.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.InstructionDurationCheck.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.InverseCancellation.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.Layout2qDistance.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.LinearFunctionsSynthesis.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.LinearFunctionsToPermutations.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.LookaheadSwap.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.MergeAdjacentBarriers.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.MinimumPoint.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.NoiseAdaptiveLayout.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.NormalizeRXAngle.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.NumTensorFactors.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.Optimize1qGates.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.Optimize1qGatesDecomposition.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.Optimize1qGatesSimpleCommutation.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.OptimizeCliffords.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.PadDelay.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.PadDynamicalDecoupling.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.PulseGates.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.RXCalibrationBuilder.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.RZXCalibrationBuilder.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.RZXCalibrationBuilderNoEcho.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.RemoveBarriers.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.RemoveDiagonalGatesBeforeMeasure.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.RemoveFinalMeasurements.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.RemoveResetInZeroState.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.ResetAfterMeasureSimplification.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.SabreLayout.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.SabrePreLayout.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.SabreSwap.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.SetIOLatency.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.SetLayout.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.Size.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.SolovayKitaev.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.SolovayKitaevSynthesis.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.StochasticSwap.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.TemplateOptimization.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.TimeUnitConversion.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.TranslateParameterizedGates.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.TrivialLayout.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.UnitarySynthesis.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.Unroll3qOrMore.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.UnrollCustomDefinitions.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.UnrollForLoops.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.Unroller.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.VF2Layout.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.VF2PostLayout.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.ValidatePulseGates.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.Width.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPlugin.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPluginManager.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPluginManager.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePlugin.md
create mode 100644 docs/api/qiskit/0.46/qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePluginManager.md
create mode 100644 docs/api/qiskit/0.46/qiskit.utils.QuantumInstance.md
create mode 100644 docs/api/qiskit/0.46/qiskit.utils.mitigation.CompleteMeasFitter.md
create mode 100644 docs/api/qiskit/0.46/qiskit.utils.mitigation.TensoredMeasFitter.md
create mode 100644 docs/api/qiskit/0.46/qiskit.visualization.array_to_latex.md
create mode 100644 docs/api/qiskit/0.46/qiskit.visualization.circuit.qcstyle.DefaultStyle.md
create mode 100644 docs/api/qiskit/0.46/qiskit.visualization.circuit_drawer.md
create mode 100644 docs/api/qiskit/0.46/qiskit.visualization.dag_drawer.md
create mode 100644 docs/api/qiskit/0.46/qiskit.visualization.pass_manager_drawer.md
create mode 100644 docs/api/qiskit/0.46/qiskit.visualization.plot_bloch_multivector.md
create mode 100644 docs/api/qiskit/0.46/qiskit.visualization.plot_bloch_vector.md
create mode 100644 docs/api/qiskit/0.46/qiskit.visualization.plot_circuit_layout.md
create mode 100644 docs/api/qiskit/0.46/qiskit.visualization.plot_coupling_map.md
create mode 100644 docs/api/qiskit/0.46/qiskit.visualization.plot_distribution.md
create mode 100644 docs/api/qiskit/0.46/qiskit.visualization.plot_error_map.md
create mode 100644 docs/api/qiskit/0.46/qiskit.visualization.plot_gate_map.md
create mode 100644 docs/api/qiskit/0.46/qiskit.visualization.plot_histogram.md
create mode 100644 docs/api/qiskit/0.46/qiskit.visualization.plot_state_city.md
create mode 100644 docs/api/qiskit/0.46/qiskit.visualization.plot_state_hinton.md
create mode 100644 docs/api/qiskit/0.46/qiskit.visualization.plot_state_paulivec.md
create mode 100644 docs/api/qiskit/0.46/qiskit.visualization.plot_state_qsphere.md
create mode 100644 docs/api/qiskit/0.46/qiskit.visualization.pulse.IQXDebugging.md
create mode 100644 docs/api/qiskit/0.46/qiskit.visualization.pulse.IQXSimple.md
create mode 100644 docs/api/qiskit/0.46/qiskit.visualization.pulse.IQXStandard.md
create mode 100644 docs/api/qiskit/0.46/qiskit.visualization.pulse_drawer.md
create mode 100644 docs/api/qiskit/0.46/qiskit.visualization.timeline_drawer.md
create mode 100644 docs/api/qiskit/0.46/qiskit.visualization.visualize_transition.md
create mode 100644 docs/api/qiskit/0.46/qobj.md
create mode 100644 docs/api/qiskit/0.46/qpy.md
create mode 100644 docs/api/qiskit/0.46/quantum_info.md
create mode 100644 docs/api/qiskit/0.46/result.md
create mode 100644 docs/api/qiskit/0.46/scheduler.md
create mode 100644 docs/api/qiskit/0.46/synthesis.md
create mode 100644 docs/api/qiskit/0.46/synthesis_aqc.md
create mode 100644 docs/api/qiskit/0.46/tools.md
create mode 100644 docs/api/qiskit/0.46/tools_jupyter.md
create mode 100644 docs/api/qiskit/0.46/transpiler.md
create mode 100644 docs/api/qiskit/0.46/transpiler_builtin_plugins.md
create mode 100644 docs/api/qiskit/0.46/transpiler_passes.md
create mode 100644 docs/api/qiskit/0.46/transpiler_plugins.md
create mode 100644 docs/api/qiskit/0.46/transpiler_preset.md
create mode 100644 docs/api/qiskit/0.46/transpiler_synthesis_plugins.md
create mode 100644 docs/api/qiskit/0.46/utils.md
create mode 100644 docs/api/qiskit/0.46/utils_mitigation.md
create mode 100644 docs/api/qiskit/0.46/visualization.md
create mode 100644 public/images/api/qiskit/0.46/circuit-1.png
create mode 100644 public/images/api/qiskit/0.46/circuit-2.png
create mode 100644 public/images/api/qiskit/0.46/circuit-3.png
create mode 100644 public/images/api/qiskit/0.46/circuit-4.png
create mode 100644 public/images/api/qiskit/0.46/circuit-5.png
create mode 100644 public/images/api/qiskit/0.46/circuit_library-1.png
create mode 100644 public/images/api/qiskit/0.46/converters-1.png
create mode 100644 public/images/api/qiskit/0.46/depth.gif
create mode 100644 public/images/api/qiskit/0.46/mapping.png
create mode 100644 public/images/api/qiskit/0.46/providers_fake_provider-1_00.png
create mode 100644 public/images/api/qiskit/0.46/providers_fake_provider-1_01.png
create mode 100644 public/images/api/qiskit/0.46/providers_fake_provider-1_02.png
create mode 100644 public/images/api/qiskit/0.46/pulse-1.png
create mode 100644 public/images/api/qiskit/0.46/pulse-2.png
create mode 100644 public/images/api/qiskit/0.46/pulse-3.png
create mode 100644 public/images/api/qiskit/0.46/pulse-4.png
create mode 100644 public/images/api/qiskit/0.46/pulse-5.png
create mode 100644 public/images/api/qiskit/0.46/pulse-6.png
create mode 100644 public/images/api/qiskit/0.46/pulse-7.png
create mode 100644 public/images/api/qiskit/0.46/pulse-8.png
create mode 100644 public/images/api/qiskit/0.46/pulse-9.png
create mode 100644 public/images/api/qiskit/0.46/qasm3-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-ControlledGate-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-ControlledGate-2.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-InstructionSet-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-Operation-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-Parameter-1_00.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-Parameter-1_01.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-QuantumCircuit-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-QuantumCircuit-2.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-QuantumCircuit-3_00.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-QuantumCircuit-3_01.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-QuantumCircuit-4_00.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-QuantumCircuit-4_01.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-QuantumCircuit-5.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-QuantumCircuit-6.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-AND-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-AND-2.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-FourierChecking-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-GMS-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-GR-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-GRX-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-GRY-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-GRZ-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-GraphState-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-HiddenLinearFunction-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-IQP-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-IQP-2.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-InnerProduct-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-MCMTVChain-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-OR-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-OR-2.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-PauliTwoDesign-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-Permutation-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-Permutation-2.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-PermutationGate-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-PermutationGate-2.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-PhaseEstimation-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-PiecewiseChebyshev-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-QFT-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-QFT-2.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-QFT-3.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-QuantumVolume-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-QuantumVolume-2.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-circuit-library-XOR-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-pulse-library-SymbolicPulse-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-quantum_info-Statevector-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-transpiler-passes-DynamicalDecoupling-1_00.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-transpiler-passes-DynamicalDecoupling-1_01.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-transpiler-passes-PadDynamicalDecoupling-1_00.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-transpiler-passes-PadDynamicalDecoupling-1_01.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-transpiler-passes-RemoveBarriers-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-circuit_drawer-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-plot_bloch_multivector-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-plot_bloch_multivector-2.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-plot_bloch_vector-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-plot_bloch_vector-2.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-plot_circuit_layout-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-plot_coupling_map-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-plot_distribution-1_00.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-plot_distribution-1_01.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-plot_distribution-1_02.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-plot_error_map-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-plot_gate_map-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-plot_histogram-1_00.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-plot_histogram-1_01.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-plot_histogram-1_02.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-plot_state_city-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-plot_state_city-2.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-plot_state_hinton-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-plot_state_paulivec-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-plot_state_paulivec-2.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-plot_state_qsphere-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-plot_state_qsphere-2.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-pulse_drawer-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-pulse_drawer-2.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-pulse_drawer-3.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-timeline_drawer-1.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-timeline_drawer-2.png
create mode 100644 public/images/api/qiskit/0.46/qiskit-visualization-timeline_drawer-3.png
create mode 100644 public/images/api/qiskit/0.46/transpiler-10.png
create mode 100644 public/images/api/qiskit/0.46/transpiler-11.png
create mode 100644 public/images/api/qiskit/0.46/transpiler-12.png
create mode 100644 public/images/api/qiskit/0.46/transpiler-13.png
create mode 100644 public/images/api/qiskit/0.46/transpiler-14.png
create mode 100644 public/images/api/qiskit/0.46/transpiler-15.png
create mode 100644 public/images/api/qiskit/0.46/transpiler-16.png
create mode 100644 public/images/api/qiskit/0.46/transpiler-17.png
create mode 100644 public/images/api/qiskit/0.46/transpiler-4.png
create mode 100644 public/images/api/qiskit/0.46/transpiler-5.png
create mode 100644 public/images/api/qiskit/0.46/transpiler-6.png
create mode 100644 public/images/api/qiskit/0.46/transpiler-7.png
create mode 100644 public/images/api/qiskit/0.46/transpiler-8.png
create mode 100644 public/images/api/qiskit/0.46/transpiler-9.png
create mode 100644 public/images/api/qiskit/0.46/transpiling_core_steps.png
create mode 100644 public/images/api/qiskit/0.46/visualization-1.png
create mode 100644 public/images/api/qiskit/0.46/visualization-2.png
create mode 100644 public/images/api/qiskit/0.46/visualization-3.png
create mode 100644 public/images/api/qiskit/0.46/visualization-4.png
create mode 100644 public/images/api/qiskit/0.46/visualization-5.png
create mode 100644 public/images/api/qiskit/0.46/visualization-6.png
diff --git a/docs/api/qiskit/0.46/_package.json b/docs/api/qiskit/0.46/_package.json
new file mode 100644
index 00000000000..cfb4023267e
--- /dev/null
+++ b/docs/api/qiskit/0.46/_package.json
@@ -0,0 +1,4 @@
+{
+ "name": "qiskit",
+ "version": "0.46.0"
+}
diff --git a/docs/api/qiskit/0.46/_toc.json b/docs/api/qiskit/0.46/_toc.json
new file mode 100644
index 00000000000..3bfafd17182
--- /dev/null
+++ b/docs/api/qiskit/0.46/_toc.json
@@ -0,0 +1,3633 @@
+{
+ "title": "Qiskit",
+ "children": [
+ {
+ "title": "qiskit",
+ "url": "/api/qiskit/0.46"
+ },
+ {
+ "title": "qiskit.algorithms",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/algorithms"
+ },
+ {
+ "title": "AlgorithmJob",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.AlgorithmJob"
+ },
+ {
+ "title": "AmplificationProblem",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.AmplificationProblem"
+ },
+ {
+ "title": "AmplitudeAmplifier",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.AmplitudeAmplifier"
+ },
+ {
+ "title": "AmplitudeEstimation",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.AmplitudeEstimation"
+ },
+ {
+ "title": "AmplitudeEstimationResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.AmplitudeEstimationResult"
+ },
+ {
+ "title": "AmplitudeEstimator",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.AmplitudeEstimator"
+ },
+ {
+ "title": "AmplitudeEstimatorResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.AmplitudeEstimatorResult"
+ },
+ {
+ "title": "Eigensolver",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.Eigensolver"
+ },
+ {
+ "title": "EigensolverResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.EigensolverResult"
+ },
+ {
+ "title": "EstimationProblem",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.EstimationProblem"
+ },
+ {
+ "title": "EvolutionProblem",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.EvolutionProblem"
+ },
+ {
+ "title": "EvolutionResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.EvolutionResult"
+ },
+ {
+ "title": "FasterAmplitudeEstimation",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.FasterAmplitudeEstimation"
+ },
+ {
+ "title": "FasterAmplitudeEstimationResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.FasterAmplitudeEstimationResult"
+ },
+ {
+ "title": "Grover",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.Grover"
+ },
+ {
+ "title": "GroverResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.GroverResult"
+ },
+ {
+ "title": "HamiltonianPhaseEstimation",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.HamiltonianPhaseEstimation"
+ },
+ {
+ "title": "HamiltonianPhaseEstimationResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.HamiltonianPhaseEstimationResult"
+ },
+ {
+ "title": "ImaginaryEvolver",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.ImaginaryEvolver"
+ },
+ {
+ "title": "ImaginaryTimeEvolver",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.ImaginaryTimeEvolver"
+ },
+ {
+ "title": "IterativeAmplitudeEstimation",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.IterativeAmplitudeEstimation"
+ },
+ {
+ "title": "IterativeAmplitudeEstimationResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.IterativeAmplitudeEstimationResult"
+ },
+ {
+ "title": "IterativePhaseEstimation",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.IterativePhaseEstimation"
+ },
+ {
+ "title": "MaximumLikelihoodAmplitudeEstimation",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.MaximumLikelihoodAmplitudeEstimation"
+ },
+ {
+ "title": "MaximumLikelihoodAmplitudeEstimationResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.MaximumLikelihoodAmplitudeEstimationResult"
+ },
+ {
+ "title": "MinimumEigensolver",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.MinimumEigensolver"
+ },
+ {
+ "title": "MinimumEigensolverResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.MinimumEigensolverResult"
+ },
+ {
+ "title": "NumPyEigensolver",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.NumPyEigensolver"
+ },
+ {
+ "title": "NumPyMinimumEigensolver",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.NumPyMinimumEigensolver"
+ },
+ {
+ "title": "PhaseEstimation",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.PhaseEstimation"
+ },
+ {
+ "title": "PhaseEstimationResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.PhaseEstimationResult"
+ },
+ {
+ "title": "PhaseEstimationScale",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.PhaseEstimationScale"
+ },
+ {
+ "title": "PVQD",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.PVQD"
+ },
+ {
+ "title": "PVQDResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.PVQDResult"
+ },
+ {
+ "title": "QAOA",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.QAOA"
+ },
+ {
+ "title": "RealEvolver",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.RealEvolver"
+ },
+ {
+ "title": "RealTimeEvolver",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.RealTimeEvolver"
+ },
+ {
+ "title": "SciPyImaginaryEvolver",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.SciPyImaginaryEvolver"
+ },
+ {
+ "title": "SciPyRealEvolver",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.SciPyRealEvolver"
+ },
+ {
+ "title": "TimeEvolutionProblem",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.TimeEvolutionProblem"
+ },
+ {
+ "title": "TimeEvolutionResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.TimeEvolutionResult"
+ },
+ {
+ "title": "TrotterQRTE",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.TrotterQRTE"
+ },
+ {
+ "title": "VarQITE",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.VarQITE"
+ },
+ {
+ "title": "VarQRTE",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.VarQRTE"
+ },
+ {
+ "title": "VQD",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.VQD"
+ },
+ {
+ "title": "VQDResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.VQDResult"
+ },
+ {
+ "title": "VQE",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.VQE"
+ },
+ {
+ "title": "qiskit.algorithms.eigensolvers",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.eigensolvers"
+ },
+ {
+ "title": "Eigensolver",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.eigensolvers.Eigensolver"
+ },
+ {
+ "title": "EigensolverResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.eigensolvers.EigensolverResult"
+ },
+ {
+ "title": "NumPyEigensolver",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.eigensolvers.NumPyEigensolver"
+ },
+ {
+ "title": "NumPyEigensolverResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.eigensolvers.NumPyEigensolverResult"
+ },
+ {
+ "title": "VQD",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.eigensolvers.VQD"
+ },
+ {
+ "title": "VQDResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.eigensolvers.VQDResult"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.algorithms.gradients",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.gradients"
+ },
+ {
+ "title": "BaseEstimatorGradient",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.gradients.BaseEstimatorGradient"
+ },
+ {
+ "title": "BaseQGT",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.gradients.BaseQGT"
+ },
+ {
+ "title": "BaseSamplerGradient",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.gradients.BaseSamplerGradient"
+ },
+ {
+ "title": "EstimatorGradientResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.gradients.EstimatorGradientResult"
+ },
+ {
+ "title": "FiniteDiffEstimatorGradient",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.gradients.FiniteDiffEstimatorGradient"
+ },
+ {
+ "title": "FiniteDiffSamplerGradient",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.gradients.FiniteDiffSamplerGradient"
+ },
+ {
+ "title": "LinCombEstimatorGradient",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.gradients.LinCombEstimatorGradient"
+ },
+ {
+ "title": "LinCombQGT",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.gradients.LinCombQGT"
+ },
+ {
+ "title": "LinCombSamplerGradient",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.gradients.LinCombSamplerGradient"
+ },
+ {
+ "title": "ParamShiftEstimatorGradient",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.gradients.ParamShiftEstimatorGradient"
+ },
+ {
+ "title": "ParamShiftSamplerGradient",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.gradients.ParamShiftSamplerGradient"
+ },
+ {
+ "title": "QFI",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.gradients.QFI"
+ },
+ {
+ "title": "QFIResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.gradients.QFIResult"
+ },
+ {
+ "title": "QGTResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.gradients.QGTResult"
+ },
+ {
+ "title": "ReverseEstimatorGradient",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.gradients.ReverseEstimatorGradient"
+ },
+ {
+ "title": "ReverseQGT",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.gradients.ReverseQGT"
+ },
+ {
+ "title": "SamplerGradientResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.gradients.SamplerGradientResult"
+ },
+ {
+ "title": "SPSAEstimatorGradient",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.gradients.SPSAEstimatorGradient"
+ },
+ {
+ "title": "SPSASamplerGradient",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.gradients.SPSASamplerGradient"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.algorithms.minimum_eigensolvers",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers"
+ },
+ {
+ "title": "AdaptVQE",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.AdaptVQE"
+ },
+ {
+ "title": "AdaptVQEResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.AdaptVQEResult"
+ },
+ {
+ "title": "MinimumEigensolver",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.MinimumEigensolver"
+ },
+ {
+ "title": "MinimumEigensolverResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.MinimumEigensolverResult"
+ },
+ {
+ "title": "NumPyMinimumEigensolver",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolver"
+ },
+ {
+ "title": "NumPyMinimumEigensolverResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolverResult"
+ },
+ {
+ "title": "QAOA",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.QAOA"
+ },
+ {
+ "title": "SamplingMinimumEigensolver",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolver"
+ },
+ {
+ "title": "SamplingMinimumEigensolverResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolverResult"
+ },
+ {
+ "title": "SamplingVQE",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.SamplingVQE"
+ },
+ {
+ "title": "SamplingVQEResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult"
+ },
+ {
+ "title": "VQE",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.VQE"
+ },
+ {
+ "title": "VQEResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.VQEResult"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.algorithms.optimizers",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers"
+ },
+ {
+ "title": "ADAM",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.ADAM"
+ },
+ {
+ "title": "AQGD",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.AQGD"
+ },
+ {
+ "title": "AskData",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.AskData"
+ },
+ {
+ "title": "BOBYQA",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.BOBYQA"
+ },
+ {
+ "title": "CG",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.CG"
+ },
+ {
+ "title": "COBYLA",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.COBYLA"
+ },
+ {
+ "title": "CRS",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.CRS"
+ },
+ {
+ "title": "DIRECT_L",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.DIRECT_L"
+ },
+ {
+ "title": "DIRECT_L_RAND",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.DIRECT_L_RAND"
+ },
+ {
+ "title": "ESCH",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.ESCH"
+ },
+ {
+ "title": "GradientDescent",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.GradientDescent"
+ },
+ {
+ "title": "GradientDescentState",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.GradientDescentState"
+ },
+ {
+ "title": "GSLS",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.GSLS"
+ },
+ {
+ "title": "IMFIL",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.IMFIL"
+ },
+ {
+ "title": "ISRES",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.ISRES"
+ },
+ {
+ "title": "L_BFGS_B",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.L_BFGS_B"
+ },
+ {
+ "title": "Minimizer",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.Minimizer"
+ },
+ {
+ "title": "NELDER_MEAD",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.NELDER_MEAD"
+ },
+ {
+ "title": "NFT",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.NFT"
+ },
+ {
+ "title": "Optimizer",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.Optimizer"
+ },
+ {
+ "title": "OptimizerResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.OptimizerResult"
+ },
+ {
+ "title": "OptimizerState",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.OptimizerState"
+ },
+ {
+ "title": "OptimizerSupportLevel",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.OptimizerSupportLevel"
+ },
+ {
+ "title": "P_BFGS",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.P_BFGS"
+ },
+ {
+ "title": "POWELL",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.POWELL"
+ },
+ {
+ "title": "QNSPSA",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.QNSPSA"
+ },
+ {
+ "title": "SciPyOptimizer",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.SciPyOptimizer"
+ },
+ {
+ "title": "SLSQP",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.SLSQP"
+ },
+ {
+ "title": "SNOBFIT",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.SNOBFIT"
+ },
+ {
+ "title": "SPSA",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.SPSA"
+ },
+ {
+ "title": "SteppableOptimizer",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.SteppableOptimizer"
+ },
+ {
+ "title": "TellData",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.TellData"
+ },
+ {
+ "title": "TNC",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.TNC"
+ },
+ {
+ "title": "UMDA",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.UMDA"
+ },
+ {
+ "title": "qiskit.algorithms.optimizers.optimizer_utils",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.optimizer_utils"
+ },
+ {
+ "title": "LearningRate",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.optimizers.optimizer_utils.LearningRate"
+ }
+ ]
+ }
+ ]
+ },
+ {
+ "title": "qiskit.algorithms.state_fidelities",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.state_fidelities"
+ },
+ {
+ "title": "BaseStateFidelity",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.state_fidelities.BaseStateFidelity"
+ },
+ {
+ "title": "ComputeUncompute",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.state_fidelities.ComputeUncompute"
+ },
+ {
+ "title": "StateFidelityResult",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.state_fidelities.StateFidelityResult"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.algorithms.time_evolvers.trotterization",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.time_evolvers.trotterization"
+ },
+ {
+ "title": "TrotterQRTE",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.time_evolvers.trotterization.TrotterQRTE"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.algorithms.time_evolvers.variational",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational"
+ },
+ {
+ "title": "ForwardEulerSolver",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.ForwardEulerSolver"
+ },
+ {
+ "title": "ImaginaryMcLachlanPrinciple",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.ImaginaryMcLachlanPrinciple"
+ },
+ {
+ "title": "ImaginaryVariationalPrinciple",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.ImaginaryVariationalPrinciple"
+ },
+ {
+ "title": "RealMcLachlanPrinciple",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.RealMcLachlanPrinciple"
+ },
+ {
+ "title": "RealVariationalPrinciple",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.RealVariationalPrinciple"
+ },
+ {
+ "title": "VariationalPrinciple",
+ "url": "/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.VariationalPrinciple"
+ }
+ ]
+ }
+ ]
+ },
+ {
+ "title": "qiskit.assembler",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/assembler"
+ },
+ {
+ "title": "RunConfig",
+ "url": "/api/qiskit/0.46/qiskit.assembler.RunConfig"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.circuit",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/circuit"
+ },
+ {
+ "title": "AncillaQubit",
+ "url": "/api/qiskit/0.46/qiskit.circuit.AncillaQubit"
+ },
+ {
+ "title": "AncillaRegister",
+ "url": "/api/qiskit/0.46/qiskit.circuit.AncillaRegister"
+ },
+ {
+ "title": "AnnotatedOperation",
+ "url": "/api/qiskit/0.46/qiskit.circuit.AnnotatedOperation"
+ },
+ {
+ "title": "Bit",
+ "url": "/api/qiskit/0.46/qiskit.circuit.Bit"
+ },
+ {
+ "title": "BreakLoopOp",
+ "url": "/api/qiskit/0.46/qiskit.circuit.BreakLoopOp"
+ },
+ {
+ "title": "CircuitInstruction",
+ "url": "/api/qiskit/0.46/qiskit.circuit.CircuitInstruction"
+ },
+ {
+ "title": "ClassicalRegister",
+ "url": "/api/qiskit/0.46/qiskit.circuit.ClassicalRegister"
+ },
+ {
+ "title": "Clbit",
+ "url": "/api/qiskit/0.46/qiskit.circuit.Clbit"
+ },
+ {
+ "title": "CommutationChecker",
+ "url": "/api/qiskit/0.46/qiskit.circuit.CommutationChecker"
+ },
+ {
+ "title": "ContinueLoopOp",
+ "url": "/api/qiskit/0.46/qiskit.circuit.ContinueLoopOp"
+ },
+ {
+ "title": "ControlFlowOp",
+ "url": "/api/qiskit/0.46/qiskit.circuit.ControlFlowOp"
+ },
+ {
+ "title": "ControlledGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.ControlledGate"
+ },
+ {
+ "title": "ControlModifier",
+ "url": "/api/qiskit/0.46/qiskit.circuit.ControlModifier"
+ },
+ {
+ "title": "Delay",
+ "url": "/api/qiskit/0.46/qiskit.circuit.Delay"
+ },
+ {
+ "title": "EquivalenceLibrary",
+ "url": "/api/qiskit/0.46/qiskit.circuit.EquivalenceLibrary"
+ },
+ {
+ "title": "ForLoopOp",
+ "url": "/api/qiskit/0.46/qiskit.circuit.ForLoopOp"
+ },
+ {
+ "title": "Gate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.Gate"
+ },
+ {
+ "title": "IfElseOp",
+ "url": "/api/qiskit/0.46/qiskit.circuit.IfElseOp"
+ },
+ {
+ "title": "Instruction",
+ "url": "/api/qiskit/0.46/qiskit.circuit.Instruction"
+ },
+ {
+ "title": "InstructionSet",
+ "url": "/api/qiskit/0.46/qiskit.circuit.InstructionSet"
+ },
+ {
+ "title": "InverseModifier",
+ "url": "/api/qiskit/0.46/qiskit.circuit.InverseModifier"
+ },
+ {
+ "title": "Operation",
+ "url": "/api/qiskit/0.46/qiskit.circuit.Operation"
+ },
+ {
+ "title": "Parameter",
+ "url": "/api/qiskit/0.46/qiskit.circuit.Parameter"
+ },
+ {
+ "title": "ParameterExpression",
+ "url": "/api/qiskit/0.46/qiskit.circuit.ParameterExpression"
+ },
+ {
+ "title": "ParameterVector",
+ "url": "/api/qiskit/0.46/qiskit.circuit.ParameterVector"
+ },
+ {
+ "title": "PowerModifier",
+ "url": "/api/qiskit/0.46/qiskit.circuit.PowerModifier"
+ },
+ {
+ "title": "qiskit.circuit.classical",
+ "url": "/api/qiskit/0.46/circuit_classical"
+ },
+ {
+ "title": "qiskit.circuit.singleton",
+ "url": "/api/qiskit/0.46/circuit_singleton"
+ },
+ {
+ "title": "QuantumCircuit",
+ "url": "/api/qiskit/0.46/qiskit.circuit.QuantumCircuit"
+ },
+ {
+ "title": "QuantumRegister",
+ "url": "/api/qiskit/0.46/qiskit.circuit.QuantumRegister"
+ },
+ {
+ "title": "Qubit",
+ "url": "/api/qiskit/0.46/qiskit.circuit.Qubit"
+ },
+ {
+ "title": "Register",
+ "url": "/api/qiskit/0.46/qiskit.circuit.Register"
+ },
+ {
+ "title": "SwitchCaseOp",
+ "url": "/api/qiskit/0.46/qiskit.circuit.SwitchCaseOp"
+ },
+ {
+ "title": "WhileLoopOp",
+ "url": "/api/qiskit/0.46/qiskit.circuit.WhileLoopOp"
+ },
+ {
+ "title": "qiskit.circuit.classicalfunction",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/classicalfunction"
+ },
+ {
+ "title": "BooleanExpression",
+ "url": "/api/qiskit/0.46/qiskit.circuit.classicalfunction.BooleanExpression"
+ },
+ {
+ "title": "ClassicalFunction",
+ "url": "/api/qiskit/0.46/qiskit.circuit.classicalfunction.ClassicalFunction"
+ },
+ {
+ "title": "ClassicalFunctionCompilerTypeError",
+ "url": "/api/qiskit/0.46/qiskit.circuit.classicalfunction.ClassicalFunctionCompilerTypeError"
+ },
+ {
+ "title": "ClassicalFunctionParseError",
+ "url": "/api/qiskit/0.46/qiskit.circuit.classicalfunction.ClassicalFunctionParseError"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.circuit.library",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/circuit_library"
+ },
+ {
+ "title": "AND",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.AND"
+ },
+ {
+ "title": "Barrier",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.Barrier"
+ },
+ {
+ "title": "C3SXGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.C3SXGate"
+ },
+ {
+ "title": "C3XGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.C3XGate"
+ },
+ {
+ "title": "C4XGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.C4XGate"
+ },
+ {
+ "title": "CCXGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.CCXGate"
+ },
+ {
+ "title": "CCZGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.CCZGate"
+ },
+ {
+ "title": "CDKMRippleCarryAdder",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.CDKMRippleCarryAdder"
+ },
+ {
+ "title": "CHGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.CHGate"
+ },
+ {
+ "title": "CPhaseGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.CPhaseGate"
+ },
+ {
+ "title": "CRXGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.CRXGate"
+ },
+ {
+ "title": "CRYGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.CRYGate"
+ },
+ {
+ "title": "CRZGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.CRZGate"
+ },
+ {
+ "title": "CSdgGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.CSdgGate"
+ },
+ {
+ "title": "CSGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.CSGate"
+ },
+ {
+ "title": "CSwapGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.CSwapGate"
+ },
+ {
+ "title": "CSXGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.CSXGate"
+ },
+ {
+ "title": "CU1Gate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.CU1Gate"
+ },
+ {
+ "title": "CU3Gate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.CU3Gate"
+ },
+ {
+ "title": "CUGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.CUGate"
+ },
+ {
+ "title": "CXGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.CXGate"
+ },
+ {
+ "title": "CYGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.CYGate"
+ },
+ {
+ "title": "CZGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.CZGate"
+ },
+ {
+ "title": "DCXGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.DCXGate"
+ },
+ {
+ "title": "Diagonal",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.Diagonal"
+ },
+ {
+ "title": "DiagonalGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.DiagonalGate"
+ },
+ {
+ "title": "DraperQFTAdder",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.DraperQFTAdder"
+ },
+ {
+ "title": "ECRGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.ECRGate"
+ },
+ {
+ "title": "EfficientSU2",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.EfficientSU2"
+ },
+ {
+ "title": "EvolvedOperatorAnsatz",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.EvolvedOperatorAnsatz"
+ },
+ {
+ "title": "ExactReciprocal",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.ExactReciprocal"
+ },
+ {
+ "title": "ExcitationPreserving",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.ExcitationPreserving"
+ },
+ {
+ "title": "FourierChecking",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.FourierChecking"
+ },
+ {
+ "title": "FunctionalPauliRotations",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.FunctionalPauliRotations"
+ },
+ {
+ "title": "GlobalPhaseGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.GlobalPhaseGate"
+ },
+ {
+ "title": "GMS",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.GMS"
+ },
+ {
+ "title": "GR",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.GR"
+ },
+ {
+ "title": "GraphState",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.GraphState"
+ },
+ {
+ "title": "GroverOperator",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.GroverOperator"
+ },
+ {
+ "title": "GRX",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.GRX"
+ },
+ {
+ "title": "GRY",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.GRY"
+ },
+ {
+ "title": "GRZ",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.GRZ"
+ },
+ {
+ "title": "HamiltonianGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.HamiltonianGate"
+ },
+ {
+ "title": "HGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.HGate"
+ },
+ {
+ "title": "HiddenLinearFunction",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.HiddenLinearFunction"
+ },
+ {
+ "title": "HRSCumulativeMultiplier",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.HRSCumulativeMultiplier"
+ },
+ {
+ "title": "IGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.IGate"
+ },
+ {
+ "title": "Initialize",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.Initialize"
+ },
+ {
+ "title": "InnerProduct",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.InnerProduct"
+ },
+ {
+ "title": "IntegerComparator",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.IntegerComparator"
+ },
+ {
+ "title": "IQP",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.IQP"
+ },
+ {
+ "title": "Isometry",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.Isometry"
+ },
+ {
+ "title": "iSwapGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.iSwapGate"
+ },
+ {
+ "title": "LinearAmplitudeFunction",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.LinearAmplitudeFunction"
+ },
+ {
+ "title": "LinearFunction",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.LinearFunction"
+ },
+ {
+ "title": "LinearPauliRotations",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.LinearPauliRotations"
+ },
+ {
+ "title": "MCMT",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.MCMT"
+ },
+ {
+ "title": "MCMTVChain",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.MCMTVChain"
+ },
+ {
+ "title": "MCPhaseGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.MCPhaseGate"
+ },
+ {
+ "title": "MCXGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.MCXGate"
+ },
+ {
+ "title": "MCXGrayCode",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.MCXGrayCode"
+ },
+ {
+ "title": "MCXRecursive",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.MCXRecursive"
+ },
+ {
+ "title": "MCXVChain",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.MCXVChain"
+ },
+ {
+ "title": "Measure",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.Measure"
+ },
+ {
+ "title": "MSGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.MSGate"
+ },
+ {
+ "title": "NLocal",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.NLocal"
+ },
+ {
+ "title": "OR",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.OR"
+ },
+ {
+ "title": "PauliEvolutionGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.PauliEvolutionGate"
+ },
+ {
+ "title": "PauliFeatureMap",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.PauliFeatureMap"
+ },
+ {
+ "title": "PauliGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.PauliGate"
+ },
+ {
+ "title": "PauliTwoDesign",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.PauliTwoDesign"
+ },
+ {
+ "title": "Permutation",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.Permutation"
+ },
+ {
+ "title": "PermutationGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.PermutationGate"
+ },
+ {
+ "title": "PhaseEstimation",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.PhaseEstimation"
+ },
+ {
+ "title": "PhaseGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.PhaseGate"
+ },
+ {
+ "title": "PhaseOracle",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.PhaseOracle"
+ },
+ {
+ "title": "PiecewiseChebyshev",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.PiecewiseChebyshev"
+ },
+ {
+ "title": "PiecewiseLinearPauliRotations",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.PiecewiseLinearPauliRotations"
+ },
+ {
+ "title": "PiecewisePolynomialPauliRotations",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.PiecewisePolynomialPauliRotations"
+ },
+ {
+ "title": "PolynomialPauliRotations",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.PolynomialPauliRotations"
+ },
+ {
+ "title": "QAOAAnsatz",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.QAOAAnsatz"
+ },
+ {
+ "title": "QFT",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.QFT"
+ },
+ {
+ "title": "QuadraticForm",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.QuadraticForm"
+ },
+ {
+ "title": "QuantumVolume",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.QuantumVolume"
+ },
+ {
+ "title": "RC3XGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.RC3XGate"
+ },
+ {
+ "title": "RCCXGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.RCCXGate"
+ },
+ {
+ "title": "RealAmplitudes",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.RealAmplitudes"
+ },
+ {
+ "title": "Reset",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.Reset"
+ },
+ {
+ "title": "RGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.RGate"
+ },
+ {
+ "title": "RGQFTMultiplier",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.RGQFTMultiplier"
+ },
+ {
+ "title": "RVGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.RVGate"
+ },
+ {
+ "title": "RXGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.RXGate"
+ },
+ {
+ "title": "RXXGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.RXXGate"
+ },
+ {
+ "title": "RYGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.RYGate"
+ },
+ {
+ "title": "RYYGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.RYYGate"
+ },
+ {
+ "title": "RZGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.RZGate"
+ },
+ {
+ "title": "RZXGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.RZXGate"
+ },
+ {
+ "title": "RZZGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.RZZGate"
+ },
+ {
+ "title": "SdgGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.SdgGate"
+ },
+ {
+ "title": "SGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.SGate"
+ },
+ {
+ "title": "StatePreparation",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.StatePreparation"
+ },
+ {
+ "title": "SwapGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.SwapGate"
+ },
+ {
+ "title": "SXdgGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.SXdgGate"
+ },
+ {
+ "title": "SXGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.SXGate"
+ },
+ {
+ "title": "TdgGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.TdgGate"
+ },
+ {
+ "title": "TGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.TGate"
+ },
+ {
+ "title": "TwoLocal",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.TwoLocal"
+ },
+ {
+ "title": "U1Gate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.U1Gate"
+ },
+ {
+ "title": "U2Gate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.U2Gate"
+ },
+ {
+ "title": "U3Gate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.U3Gate"
+ },
+ {
+ "title": "UCGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.UCGate"
+ },
+ {
+ "title": "UCPauliRotGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.UCPauliRotGate"
+ },
+ {
+ "title": "UCRXGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.UCRXGate"
+ },
+ {
+ "title": "UCRYGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.UCRYGate"
+ },
+ {
+ "title": "UCRZGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.UCRZGate"
+ },
+ {
+ "title": "UGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.UGate"
+ },
+ {
+ "title": "UnitaryGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.UnitaryGate"
+ },
+ {
+ "title": "UnitaryOverlap",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.UnitaryOverlap"
+ },
+ {
+ "title": "VBERippleCarryAdder",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.VBERippleCarryAdder"
+ },
+ {
+ "title": "WeightedAdder",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.WeightedAdder"
+ },
+ {
+ "title": "XGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.XGate"
+ },
+ {
+ "title": "XOR",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.XOR"
+ },
+ {
+ "title": "XXMinusYYGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.XXMinusYYGate"
+ },
+ {
+ "title": "XXPlusYYGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.XXPlusYYGate"
+ },
+ {
+ "title": "YGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.YGate"
+ },
+ {
+ "title": "ZFeatureMap",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.ZFeatureMap"
+ },
+ {
+ "title": "ZGate",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.ZGate"
+ },
+ {
+ "title": "ZZFeatureMap",
+ "url": "/api/qiskit/0.46/qiskit.circuit.library.ZZFeatureMap"
+ }
+ ]
+ }
+ ]
+ },
+ {
+ "title": "qiskit.compiler",
+ "url": "/api/qiskit/0.46/compiler"
+ },
+ {
+ "title": "qiskit.converters",
+ "url": "/api/qiskit/0.46/converters"
+ },
+ {
+ "title": "qiskit.dagcircuit",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/dagcircuit"
+ },
+ {
+ "title": "DAGCircuit",
+ "url": "/api/qiskit/0.46/qiskit.dagcircuit.DAGCircuit"
+ },
+ {
+ "title": "DAGDependency",
+ "url": "/api/qiskit/0.46/qiskit.dagcircuit.DAGDependency"
+ },
+ {
+ "title": "DAGDepNode",
+ "url": "/api/qiskit/0.46/qiskit.dagcircuit.DAGDepNode"
+ },
+ {
+ "title": "DAGInNode",
+ "url": "/api/qiskit/0.46/qiskit.dagcircuit.DAGInNode"
+ },
+ {
+ "title": "DAGNode",
+ "url": "/api/qiskit/0.46/qiskit.dagcircuit.DAGNode"
+ },
+ {
+ "title": "DAGOpNode",
+ "url": "/api/qiskit/0.46/qiskit.dagcircuit.DAGOpNode"
+ },
+ {
+ "title": "DAGOutNode",
+ "url": "/api/qiskit/0.46/qiskit.dagcircuit.DAGOutNode"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.exceptions",
+ "url": "/api/qiskit/0.46/exceptions"
+ },
+ {
+ "title": "qiskit.execute_function",
+ "url": "/api/qiskit/0.46/execute"
+ },
+ {
+ "title": "qiskit.extensions",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/extensions"
+ },
+ {
+ "title": "SingleQubitUnitary",
+ "url": "/api/qiskit/0.46/qiskit.extensions.SingleQubitUnitary"
+ },
+ {
+ "title": "Snapshot",
+ "url": "/api/qiskit/0.46/qiskit.extensions.Snapshot"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.opflow",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/opflow"
+ },
+ {
+ "title": "OperatorBase",
+ "url": "/api/qiskit/0.46/qiskit.opflow.OperatorBase"
+ },
+ {
+ "title": "qiskit.opflow.converters",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/qiskit.opflow.converters"
+ },
+ {
+ "title": "AbelianGrouper",
+ "url": "/api/qiskit/0.46/qiskit.opflow.converters.AbelianGrouper"
+ },
+ {
+ "title": "CircuitSampler",
+ "url": "/api/qiskit/0.46/qiskit.opflow.converters.CircuitSampler"
+ },
+ {
+ "title": "ConverterBase",
+ "url": "/api/qiskit/0.46/qiskit.opflow.converters.ConverterBase"
+ },
+ {
+ "title": "DictToCircuitSum",
+ "url": "/api/qiskit/0.46/qiskit.opflow.converters.DictToCircuitSum"
+ },
+ {
+ "title": "PauliBasisChange",
+ "url": "/api/qiskit/0.46/qiskit.opflow.converters.PauliBasisChange"
+ },
+ {
+ "title": "TwoQubitReduction",
+ "url": "/api/qiskit/0.46/qiskit.opflow.converters.TwoQubitReduction"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.opflow.evolutions",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/qiskit.opflow.evolutions"
+ },
+ {
+ "title": "EvolutionBase",
+ "url": "/api/qiskit/0.46/qiskit.opflow.evolutions.EvolutionBase"
+ },
+ {
+ "title": "EvolutionFactory",
+ "url": "/api/qiskit/0.46/qiskit.opflow.evolutions.EvolutionFactory"
+ },
+ {
+ "title": "EvolvedOp",
+ "url": "/api/qiskit/0.46/qiskit.opflow.evolutions.EvolvedOp"
+ },
+ {
+ "title": "MatrixEvolution",
+ "url": "/api/qiskit/0.46/qiskit.opflow.evolutions.MatrixEvolution"
+ },
+ {
+ "title": "PauliTrotterEvolution",
+ "url": "/api/qiskit/0.46/qiskit.opflow.evolutions.PauliTrotterEvolution"
+ },
+ {
+ "title": "QDrift",
+ "url": "/api/qiskit/0.46/qiskit.opflow.evolutions.QDrift"
+ },
+ {
+ "title": "Suzuki",
+ "url": "/api/qiskit/0.46/qiskit.opflow.evolutions.Suzuki"
+ },
+ {
+ "title": "Trotter",
+ "url": "/api/qiskit/0.46/qiskit.opflow.evolutions.Trotter"
+ },
+ {
+ "title": "TrotterizationBase",
+ "url": "/api/qiskit/0.46/qiskit.opflow.evolutions.TrotterizationBase"
+ },
+ {
+ "title": "TrotterizationFactory",
+ "url": "/api/qiskit/0.46/qiskit.opflow.evolutions.TrotterizationFactory"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.opflow.expectations",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/qiskit.opflow.expectations"
+ },
+ {
+ "title": "AerPauliExpectation",
+ "url": "/api/qiskit/0.46/qiskit.opflow.expectations.AerPauliExpectation"
+ },
+ {
+ "title": "CVaRExpectation",
+ "url": "/api/qiskit/0.46/qiskit.opflow.expectations.CVaRExpectation"
+ },
+ {
+ "title": "ExpectationBase",
+ "url": "/api/qiskit/0.46/qiskit.opflow.expectations.ExpectationBase"
+ },
+ {
+ "title": "ExpectationFactory",
+ "url": "/api/qiskit/0.46/qiskit.opflow.expectations.ExpectationFactory"
+ },
+ {
+ "title": "MatrixExpectation",
+ "url": "/api/qiskit/0.46/qiskit.opflow.expectations.MatrixExpectation"
+ },
+ {
+ "title": "PauliExpectation",
+ "url": "/api/qiskit/0.46/qiskit.opflow.expectations.PauliExpectation"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.opflow.gradients",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/qiskit.opflow.gradients"
+ },
+ {
+ "title": "CircuitGradient",
+ "url": "/api/qiskit/0.46/qiskit.opflow.gradients.CircuitGradient"
+ },
+ {
+ "title": "CircuitQFI",
+ "url": "/api/qiskit/0.46/qiskit.opflow.gradients.CircuitQFI"
+ },
+ {
+ "title": "DerivativeBase",
+ "url": "/api/qiskit/0.46/qiskit.opflow.gradients.DerivativeBase"
+ },
+ {
+ "title": "Gradient",
+ "url": "/api/qiskit/0.46/qiskit.opflow.gradients.Gradient"
+ },
+ {
+ "title": "GradientBase",
+ "url": "/api/qiskit/0.46/qiskit.opflow.gradients.GradientBase"
+ },
+ {
+ "title": "Hessian",
+ "url": "/api/qiskit/0.46/qiskit.opflow.gradients.Hessian"
+ },
+ {
+ "title": "HessianBase",
+ "url": "/api/qiskit/0.46/qiskit.opflow.gradients.HessianBase"
+ },
+ {
+ "title": "NaturalGradient",
+ "url": "/api/qiskit/0.46/qiskit.opflow.gradients.NaturalGradient"
+ },
+ {
+ "title": "QFI",
+ "url": "/api/qiskit/0.46/qiskit.opflow.gradients.QFI"
+ },
+ {
+ "title": "QFIBase",
+ "url": "/api/qiskit/0.46/qiskit.opflow.gradients.QFIBase"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.opflow.list_ops",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/qiskit.opflow.list_ops"
+ },
+ {
+ "title": "ComposedOp",
+ "url": "/api/qiskit/0.46/qiskit.opflow.list_ops.ComposedOp"
+ },
+ {
+ "title": "ListOp",
+ "url": "/api/qiskit/0.46/qiskit.opflow.list_ops.ListOp"
+ },
+ {
+ "title": "SummedOp",
+ "url": "/api/qiskit/0.46/qiskit.opflow.list_ops.SummedOp"
+ },
+ {
+ "title": "TensoredOp",
+ "url": "/api/qiskit/0.46/qiskit.opflow.list_ops.TensoredOp"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.opflow.primitive_ops",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/qiskit.opflow.primitive_ops"
+ },
+ {
+ "title": "CircuitOp",
+ "url": "/api/qiskit/0.46/qiskit.opflow.primitive_ops.CircuitOp"
+ },
+ {
+ "title": "MatrixOp",
+ "url": "/api/qiskit/0.46/qiskit.opflow.primitive_ops.MatrixOp"
+ },
+ {
+ "title": "PauliOp",
+ "url": "/api/qiskit/0.46/qiskit.opflow.primitive_ops.PauliOp"
+ },
+ {
+ "title": "PauliSumOp",
+ "url": "/api/qiskit/0.46/qiskit.opflow.primitive_ops.PauliSumOp"
+ },
+ {
+ "title": "PrimitiveOp",
+ "url": "/api/qiskit/0.46/qiskit.opflow.primitive_ops.PrimitiveOp"
+ },
+ {
+ "title": "TaperedPauliSumOp",
+ "url": "/api/qiskit/0.46/qiskit.opflow.primitive_ops.TaperedPauliSumOp"
+ },
+ {
+ "title": "Z2Symmetries",
+ "url": "/api/qiskit/0.46/qiskit.opflow.primitive_ops.Z2Symmetries"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.opflow.state_fns",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/qiskit.opflow.state_fns"
+ },
+ {
+ "title": "CircuitStateFn",
+ "url": "/api/qiskit/0.46/qiskit.opflow.state_fns.CircuitStateFn"
+ },
+ {
+ "title": "CVaRMeasurement",
+ "url": "/api/qiskit/0.46/qiskit.opflow.state_fns.CVaRMeasurement"
+ },
+ {
+ "title": "DictStateFn",
+ "url": "/api/qiskit/0.46/qiskit.opflow.state_fns.DictStateFn"
+ },
+ {
+ "title": "OperatorStateFn",
+ "url": "/api/qiskit/0.46/qiskit.opflow.state_fns.OperatorStateFn"
+ },
+ {
+ "title": "SparseVectorStateFn",
+ "url": "/api/qiskit/0.46/qiskit.opflow.state_fns.SparseVectorStateFn"
+ },
+ {
+ "title": "StateFn",
+ "url": "/api/qiskit/0.46/qiskit.opflow.state_fns.StateFn"
+ },
+ {
+ "title": "VectorStateFn",
+ "url": "/api/qiskit/0.46/qiskit.opflow.state_fns.VectorStateFn"
+ }
+ ]
+ }
+ ]
+ },
+ {
+ "title": "qiskit.passmanager",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/passmanager"
+ },
+ {
+ "title": "BaseController",
+ "url": "/api/qiskit/0.46/qiskit.passmanager.BaseController"
+ },
+ {
+ "title": "BasePassManager",
+ "url": "/api/qiskit/0.46/qiskit.passmanager.BasePassManager"
+ },
+ {
+ "title": "ConditionalController",
+ "url": "/api/qiskit/0.46/qiskit.passmanager.ConditionalController"
+ },
+ {
+ "title": "DoWhileController",
+ "url": "/api/qiskit/0.46/qiskit.passmanager.DoWhileController"
+ },
+ {
+ "title": "FlowController",
+ "url": "/api/qiskit/0.46/qiskit.passmanager.FlowController"
+ },
+ {
+ "title": "FlowControllerLinear",
+ "url": "/api/qiskit/0.46/qiskit.passmanager.FlowControllerLinear"
+ },
+ {
+ "title": "GenericPass",
+ "url": "/api/qiskit/0.46/qiskit.passmanager.GenericPass"
+ },
+ {
+ "title": "PassManagerState",
+ "url": "/api/qiskit/0.46/qiskit.passmanager.PassManagerState"
+ },
+ {
+ "title": "PropertySet",
+ "url": "/api/qiskit/0.46/qiskit.passmanager.PropertySet"
+ },
+ {
+ "title": "WorkflowStatus",
+ "url": "/api/qiskit/0.46/qiskit.passmanager.WorkflowStatus"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.primitives",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/primitives"
+ },
+ {
+ "title": "BackendEstimator",
+ "url": "/api/qiskit/0.46/qiskit.primitives.BackendEstimator"
+ },
+ {
+ "title": "BackendSampler",
+ "url": "/api/qiskit/0.46/qiskit.primitives.BackendSampler"
+ },
+ {
+ "title": "BaseEstimator",
+ "url": "/api/qiskit/0.46/qiskit.primitives.BaseEstimator"
+ },
+ {
+ "title": "BaseSampler",
+ "url": "/api/qiskit/0.46/qiskit.primitives.BaseSampler"
+ },
+ {
+ "title": "Estimator",
+ "url": "/api/qiskit/0.46/qiskit.primitives.Estimator"
+ },
+ {
+ "title": "EstimatorResult",
+ "url": "/api/qiskit/0.46/qiskit.primitives.EstimatorResult"
+ },
+ {
+ "title": "Sampler",
+ "url": "/api/qiskit/0.46/qiskit.primitives.Sampler"
+ },
+ {
+ "title": "SamplerResult",
+ "url": "/api/qiskit/0.46/qiskit.primitives.SamplerResult"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.providers",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/providers"
+ },
+ {
+ "title": "Backend",
+ "url": "/api/qiskit/0.46/qiskit.providers.Backend"
+ },
+ {
+ "title": "BackendV1",
+ "url": "/api/qiskit/0.46/qiskit.providers.BackendV1"
+ },
+ {
+ "title": "BackendV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.BackendV2"
+ },
+ {
+ "title": "BackendV2Converter",
+ "url": "/api/qiskit/0.46/qiskit.providers.BackendV2Converter"
+ },
+ {
+ "title": "convert_to_target",
+ "url": "/api/qiskit/0.46/qiskit.providers.convert_to_target"
+ },
+ {
+ "title": "Job",
+ "url": "/api/qiskit/0.46/qiskit.providers.Job"
+ },
+ {
+ "title": "JobStatus",
+ "url": "/api/qiskit/0.46/qiskit.providers.JobStatus"
+ },
+ {
+ "title": "JobV1",
+ "url": "/api/qiskit/0.46/qiskit.providers.JobV1"
+ },
+ {
+ "title": "Options",
+ "url": "/api/qiskit/0.46/qiskit.providers.Options"
+ },
+ {
+ "title": "Provider",
+ "url": "/api/qiskit/0.46/qiskit.providers.Provider"
+ },
+ {
+ "title": "ProviderV1",
+ "url": "/api/qiskit/0.46/qiskit.providers.ProviderV1"
+ },
+ {
+ "title": "QubitProperties",
+ "url": "/api/qiskit/0.46/qiskit.providers.QubitProperties"
+ },
+ {
+ "title": "qiskit.providers.basic_provider",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/providers_basic_provider"
+ },
+ {
+ "title": "BasicProvider",
+ "url": "/api/qiskit/0.46/qiskit.providers.basic_provider.BasicProvider"
+ },
+ {
+ "title": "BasicProviderError",
+ "url": "/api/qiskit/0.46/qiskit.providers.basic_provider.BasicProviderError"
+ },
+ {
+ "title": "BasicProviderJob",
+ "url": "/api/qiskit/0.46/qiskit.providers.basic_provider.BasicProviderJob"
+ },
+ {
+ "title": "BasicSimulator",
+ "url": "/api/qiskit/0.46/qiskit.providers.basic_provider.BasicSimulator"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.providers.basicaer",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/providers_basicaer"
+ },
+ {
+ "title": "BasicAerError",
+ "url": "/api/qiskit/0.46/qiskit.providers.basicaer.BasicAerError"
+ },
+ {
+ "title": "BasicAerJob",
+ "url": "/api/qiskit/0.46/qiskit.providers.basicaer.BasicAerJob"
+ },
+ {
+ "title": "BasicAerProvider",
+ "url": "/api/qiskit/0.46/qiskit.providers.basicaer.BasicAerProvider"
+ },
+ {
+ "title": "QasmSimulatorPy",
+ "url": "/api/qiskit/0.46/qiskit.providers.basicaer.QasmSimulatorPy"
+ },
+ {
+ "title": "StatevectorSimulatorPy",
+ "url": "/api/qiskit/0.46/qiskit.providers.basicaer.StatevectorSimulatorPy"
+ },
+ {
+ "title": "UnitarySimulatorPy",
+ "url": "/api/qiskit/0.46/qiskit.providers.basicaer.UnitarySimulatorPy"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.providers.fake_provider",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/providers_fake_provider"
+ },
+ {
+ "title": "ConfigurableFakeBackend",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.ConfigurableFakeBackend"
+ },
+ {
+ "title": "Fake1Q",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.Fake1Q"
+ },
+ {
+ "title": "FakeAlmaden",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAlmaden"
+ },
+ {
+ "title": "FakeAlmadenV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAlmadenV2"
+ },
+ {
+ "title": "FakeArmonk",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeArmonk"
+ },
+ {
+ "title": "FakeArmonkV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeArmonkV2"
+ },
+ {
+ "title": "FakeAthens",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAthens"
+ },
+ {
+ "title": "FakeAthensV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAthensV2"
+ },
+ {
+ "title": "FakeAuckland",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAuckland"
+ },
+ {
+ "title": "FakeBackend5QV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBackend5QV2"
+ },
+ {
+ "title": "FakeBackendV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBackendV2"
+ },
+ {
+ "title": "FakeBelem",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBelem"
+ },
+ {
+ "title": "FakeBelemV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBelemV2"
+ },
+ {
+ "title": "FakeBoeblingen",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBoeblingen"
+ },
+ {
+ "title": "FakeBoeblingenV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBoeblingenV2"
+ },
+ {
+ "title": "FakeBogota",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBogota"
+ },
+ {
+ "title": "FakeBogotaV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBogotaV2"
+ },
+ {
+ "title": "FakeBrooklyn",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBrooklyn"
+ },
+ {
+ "title": "FakeBrooklynV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBrooklynV2"
+ },
+ {
+ "title": "FakeBurlington",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBurlington"
+ },
+ {
+ "title": "FakeBurlingtonV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBurlingtonV2"
+ },
+ {
+ "title": "FakeCairo",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCairo"
+ },
+ {
+ "title": "FakeCairoV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCairoV2"
+ },
+ {
+ "title": "FakeCambridge",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCambridge"
+ },
+ {
+ "title": "FakeCambridgeV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCambridgeV2"
+ },
+ {
+ "title": "FakeCasablanca",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCasablanca"
+ },
+ {
+ "title": "FakeCasablancaV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCasablancaV2"
+ },
+ {
+ "title": "FakeEssex",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeEssex"
+ },
+ {
+ "title": "FakeEssexV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeEssexV2"
+ },
+ {
+ "title": "FakeGeneva",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeGeneva"
+ },
+ {
+ "title": "FakeGuadalupe",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeGuadalupe"
+ },
+ {
+ "title": "FakeGuadalupeV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeGuadalupeV2"
+ },
+ {
+ "title": "FakeHanoi",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeHanoi"
+ },
+ {
+ "title": "FakeHanoiV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeHanoiV2"
+ },
+ {
+ "title": "FakeJakarta",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeJakarta"
+ },
+ {
+ "title": "FakeJakartaV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeJakartaV2"
+ },
+ {
+ "title": "FakeJohannesburg",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeJohannesburg"
+ },
+ {
+ "title": "FakeJohannesburgV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeJohannesburgV2"
+ },
+ {
+ "title": "FakeKolkata",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeKolkata"
+ },
+ {
+ "title": "FakeKolkataV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeKolkataV2"
+ },
+ {
+ "title": "FakeLagos",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLagos"
+ },
+ {
+ "title": "FakeLagosV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLagosV2"
+ },
+ {
+ "title": "FakeLima",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLima"
+ },
+ {
+ "title": "FakeLimaV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLimaV2"
+ },
+ {
+ "title": "FakeLondon",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLondon"
+ },
+ {
+ "title": "FakeLondonV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLondonV2"
+ },
+ {
+ "title": "FakeManhattan",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeManhattan"
+ },
+ {
+ "title": "FakeManhattanV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeManhattanV2"
+ },
+ {
+ "title": "FakeManila",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeManila"
+ },
+ {
+ "title": "FakeManilaV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeManilaV2"
+ },
+ {
+ "title": "FakeMelbourne",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMelbourne"
+ },
+ {
+ "title": "FakeMelbourneV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMelbourneV2"
+ },
+ {
+ "title": "FakeMontreal",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMontreal"
+ },
+ {
+ "title": "FakeMontrealV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMontrealV2"
+ },
+ {
+ "title": "FakeMumbai",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMumbai"
+ },
+ {
+ "title": "FakeMumbaiFractionalCX",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMumbaiFractionalCX"
+ },
+ {
+ "title": "FakeMumbaiV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMumbaiV2"
+ },
+ {
+ "title": "FakeNairobi",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeNairobi"
+ },
+ {
+ "title": "FakeNairobiV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeNairobiV2"
+ },
+ {
+ "title": "FakeOpenPulse2Q",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOpenPulse2Q"
+ },
+ {
+ "title": "FakeOpenPulse3Q",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOpenPulse3Q"
+ },
+ {
+ "title": "FakeOslo",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOslo"
+ },
+ {
+ "title": "FakeOurense",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOurense"
+ },
+ {
+ "title": "FakeOurenseV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOurenseV2"
+ },
+ {
+ "title": "FakeParis",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeParis"
+ },
+ {
+ "title": "FakeParisV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeParisV2"
+ },
+ {
+ "title": "FakePerth",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakePerth"
+ },
+ {
+ "title": "FakePoughkeepsie",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakePoughkeepsie"
+ },
+ {
+ "title": "FakePoughkeepsieV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakePoughkeepsieV2"
+ },
+ {
+ "title": "FakePrague",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakePrague"
+ },
+ {
+ "title": "FakeProvider",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeProvider"
+ },
+ {
+ "title": "FakeProviderForBackendV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeProviderForBackendV2"
+ },
+ {
+ "title": "FakeQasmSimulator",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeQasmSimulator"
+ },
+ {
+ "title": "FakeQuito",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeQuito"
+ },
+ {
+ "title": "FakeQuitoV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeQuitoV2"
+ },
+ {
+ "title": "FakeRochester",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRochester"
+ },
+ {
+ "title": "FakeRochesterV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRochesterV2"
+ },
+ {
+ "title": "FakeRome",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRome"
+ },
+ {
+ "title": "FakeRomeV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRomeV2"
+ },
+ {
+ "title": "FakeRueschlikon",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRueschlikon"
+ },
+ {
+ "title": "FakeSantiago",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSantiago"
+ },
+ {
+ "title": "FakeSantiagoV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSantiagoV2"
+ },
+ {
+ "title": "FakeSherbrooke",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSherbrooke"
+ },
+ {
+ "title": "FakeSingapore",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSingapore"
+ },
+ {
+ "title": "FakeSingaporeV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSingaporeV2"
+ },
+ {
+ "title": "FakeSydney",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSydney"
+ },
+ {
+ "title": "FakeSydneyV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSydneyV2"
+ },
+ {
+ "title": "FakeTenerife",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeTenerife"
+ },
+ {
+ "title": "FakeTokyo",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeTokyo"
+ },
+ {
+ "title": "FakeToronto",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeToronto"
+ },
+ {
+ "title": "FakeTorontoV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeTorontoV2"
+ },
+ {
+ "title": "FakeValencia",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeValencia"
+ },
+ {
+ "title": "FakeValenciaV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeValenciaV2"
+ },
+ {
+ "title": "FakeVigo",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeVigo"
+ },
+ {
+ "title": "FakeVigoV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeVigoV2"
+ },
+ {
+ "title": "FakeWashington",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeWashington"
+ },
+ {
+ "title": "FakeWashingtonV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeWashingtonV2"
+ },
+ {
+ "title": "FakeYorktown",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeYorktown"
+ },
+ {
+ "title": "FakeYorktownV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.FakeYorktownV2"
+ },
+ {
+ "title": "GenericBackendV2",
+ "url": "/api/qiskit/0.46/qiskit.providers.fake_provider.GenericBackendV2"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.providers.models",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/providers_models"
+ },
+ {
+ "title": "BackendConfiguration",
+ "url": "/api/qiskit/0.46/qiskit.providers.models.BackendConfiguration"
+ },
+ {
+ "title": "BackendProperties",
+ "url": "/api/qiskit/0.46/qiskit.providers.models.BackendProperties"
+ },
+ {
+ "title": "BackendStatus",
+ "url": "/api/qiskit/0.46/qiskit.providers.models.BackendStatus"
+ },
+ {
+ "title": "Command",
+ "url": "/api/qiskit/0.46/qiskit.providers.models.Command"
+ },
+ {
+ "title": "GateConfig",
+ "url": "/api/qiskit/0.46/qiskit.providers.models.GateConfig"
+ },
+ {
+ "title": "GateProperties",
+ "url": "/api/qiskit/0.46/qiskit.providers.models.GateProperties"
+ },
+ {
+ "title": "JobStatus",
+ "url": "/api/qiskit/0.46/qiskit.providers.models.JobStatus"
+ },
+ {
+ "title": "Nduv",
+ "url": "/api/qiskit/0.46/qiskit.providers.models.Nduv"
+ },
+ {
+ "title": "PulseBackendConfiguration",
+ "url": "/api/qiskit/0.46/qiskit.providers.models.PulseBackendConfiguration"
+ },
+ {
+ "title": "PulseDefaults",
+ "url": "/api/qiskit/0.46/qiskit.providers.models.PulseDefaults"
+ },
+ {
+ "title": "QasmBackendConfiguration",
+ "url": "/api/qiskit/0.46/qiskit.providers.models.QasmBackendConfiguration"
+ },
+ {
+ "title": "UchannelLO",
+ "url": "/api/qiskit/0.46/qiskit.providers.models.UchannelLO"
+ }
+ ]
+ }
+ ]
+ },
+ {
+ "title": "qiskit.pulse",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/pulse"
+ },
+ {
+ "title": "Acquire",
+ "url": "/api/qiskit/0.46/qiskit.pulse.instructions.Acquire"
+ },
+ {
+ "title": "AcquireChannel",
+ "url": "/api/qiskit/0.46/qiskit.pulse.channels.AcquireChannel"
+ },
+ {
+ "title": "AlignEquispaced",
+ "url": "/api/qiskit/0.46/qiskit.pulse.transforms.AlignEquispaced"
+ },
+ {
+ "title": "AlignFunc",
+ "url": "/api/qiskit/0.46/qiskit.pulse.transforms.AlignFunc"
+ },
+ {
+ "title": "AlignLeft",
+ "url": "/api/qiskit/0.46/qiskit.pulse.transforms.AlignLeft"
+ },
+ {
+ "title": "AlignRight",
+ "url": "/api/qiskit/0.46/qiskit.pulse.transforms.AlignRight"
+ },
+ {
+ "title": "AlignSequential",
+ "url": "/api/qiskit/0.46/qiskit.pulse.transforms.AlignSequential"
+ },
+ {
+ "title": "Call",
+ "url": "/api/qiskit/0.46/qiskit.pulse.instructions.Call"
+ },
+ {
+ "title": "Constant",
+ "url": "/api/qiskit/0.46/qiskit.pulse.library.Constant_class.rst"
+ },
+ {
+ "title": "ControlChannel",
+ "url": "/api/qiskit/0.46/qiskit.pulse.channels.ControlChannel"
+ },
+ {
+ "title": "Cos",
+ "url": "/api/qiskit/0.46/qiskit.pulse.library.Cos_class.rst"
+ },
+ {
+ "title": "Delay",
+ "url": "/api/qiskit/0.46/qiskit.pulse.instructions.Delay"
+ },
+ {
+ "title": "Drag",
+ "url": "/api/qiskit/0.46/qiskit.pulse.library.Drag_class.rst"
+ },
+ {
+ "title": "DriveChannel",
+ "url": "/api/qiskit/0.46/qiskit.pulse.channels.DriveChannel"
+ },
+ {
+ "title": "Gaussian",
+ "url": "/api/qiskit/0.46/qiskit.pulse.library.Gaussian_class.rst"
+ },
+ {
+ "title": "gaussian_square_echo",
+ "url": "/api/qiskit/0.46/qiskit.pulse.library.gaussian_square_echo"
+ },
+ {
+ "title": "GaussianDeriv",
+ "url": "/api/qiskit/0.46/qiskit.pulse.library.GaussianDeriv"
+ },
+ {
+ "title": "GaussianSquare",
+ "url": "/api/qiskit/0.46/qiskit.pulse.library.GaussianSquare"
+ },
+ {
+ "title": "GaussianSquareDrag",
+ "url": "/api/qiskit/0.46/qiskit.pulse.library.GaussianSquareDrag"
+ },
+ {
+ "title": "InstructionScheduleMap",
+ "url": "/api/qiskit/0.46/qiskit.pulse.InstructionScheduleMap"
+ },
+ {
+ "title": "MeasureChannel",
+ "url": "/api/qiskit/0.46/qiskit.pulse.channels.MeasureChannel"
+ },
+ {
+ "title": "MemorySlot",
+ "url": "/api/qiskit/0.46/qiskit.pulse.channels.MemorySlot"
+ },
+ {
+ "title": "ParametricPulse",
+ "url": "/api/qiskit/0.46/qiskit.pulse.library.ParametricPulse"
+ },
+ {
+ "title": "Play",
+ "url": "/api/qiskit/0.46/qiskit.pulse.instructions.Play"
+ },
+ {
+ "title": "Reference",
+ "url": "/api/qiskit/0.46/qiskit.pulse.instructions.Reference"
+ },
+ {
+ "title": "RegisterSlot",
+ "url": "/api/qiskit/0.46/qiskit.pulse.channels.RegisterSlot"
+ },
+ {
+ "title": "RelativeBarrier",
+ "url": "/api/qiskit/0.46/qiskit.pulse.instructions.RelativeBarrier"
+ },
+ {
+ "title": "Sawtooth",
+ "url": "/api/qiskit/0.46/qiskit.pulse.library.Sawtooth_class.rst"
+ },
+ {
+ "title": "Schedule",
+ "url": "/api/qiskit/0.46/qiskit.pulse.Schedule"
+ },
+ {
+ "title": "ScheduleBlock",
+ "url": "/api/qiskit/0.46/qiskit.pulse.ScheduleBlock"
+ },
+ {
+ "title": "Sech",
+ "url": "/api/qiskit/0.46/qiskit.pulse.library.Sech_fun.rst"
+ },
+ {
+ "title": "SechDeriv",
+ "url": "/api/qiskit/0.46/qiskit.pulse.library.SechDeriv"
+ },
+ {
+ "title": "SetFrequency",
+ "url": "/api/qiskit/0.46/qiskit.pulse.instructions.SetFrequency"
+ },
+ {
+ "title": "SetPhase",
+ "url": "/api/qiskit/0.46/qiskit.pulse.instructions.SetPhase"
+ },
+ {
+ "title": "ShiftFrequency",
+ "url": "/api/qiskit/0.46/qiskit.pulse.instructions.ShiftFrequency"
+ },
+ {
+ "title": "ShiftPhase",
+ "url": "/api/qiskit/0.46/qiskit.pulse.instructions.ShiftPhase"
+ },
+ {
+ "title": "Sin",
+ "url": "/api/qiskit/0.46/qiskit.pulse.library.Sin_class.rst"
+ },
+ {
+ "title": "Snapshot",
+ "url": "/api/qiskit/0.46/qiskit.pulse.instructions.Snapshot"
+ },
+ {
+ "title": "SnapshotChannel",
+ "url": "/api/qiskit/0.46/qiskit.pulse.channels.SnapshotChannel"
+ },
+ {
+ "title": "Square",
+ "url": "/api/qiskit/0.46/qiskit.pulse.library.Square_fun.rst"
+ },
+ {
+ "title": "SymbolicPulse",
+ "url": "/api/qiskit/0.46/qiskit.pulse.library.SymbolicPulse"
+ },
+ {
+ "title": "TimeBlockade",
+ "url": "/api/qiskit/0.46/qiskit.pulse.instructions.TimeBlockade"
+ },
+ {
+ "title": "Triangle",
+ "url": "/api/qiskit/0.46/qiskit.pulse.library.Triangle_class.rst"
+ },
+ {
+ "title": "Waveform",
+ "url": "/api/qiskit/0.46/qiskit.pulse.library.Waveform"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.qasm",
+ "url": "/api/qiskit/0.46/qasm"
+ },
+ {
+ "title": "qiskit.qasm2",
+ "url": "/api/qiskit/0.46/qasm2"
+ },
+ {
+ "title": "qiskit.qasm3",
+ "url": "/api/qiskit/0.46/qasm3"
+ },
+ {
+ "title": "qiskit.qobj",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/qobj"
+ },
+ {
+ "title": "GateCalibration",
+ "url": "/api/qiskit/0.46/qiskit.qobj.GateCalibration"
+ },
+ {
+ "title": "PulseLibraryItem",
+ "url": "/api/qiskit/0.46/qiskit.qobj.PulseLibraryItem"
+ },
+ {
+ "title": "PulseQobj",
+ "url": "/api/qiskit/0.46/qiskit.qobj.PulseQobj"
+ },
+ {
+ "title": "PulseQobjConfig",
+ "url": "/api/qiskit/0.46/qiskit.qobj.PulseQobjConfig"
+ },
+ {
+ "title": "PulseQobjExperiment",
+ "url": "/api/qiskit/0.46/qiskit.qobj.PulseQobjExperiment"
+ },
+ {
+ "title": "PulseQobjExperimentConfig",
+ "url": "/api/qiskit/0.46/qiskit.qobj.PulseQobjExperimentConfig"
+ },
+ {
+ "title": "PulseQobjInstruction",
+ "url": "/api/qiskit/0.46/qiskit.qobj.PulseQobjInstruction"
+ },
+ {
+ "title": "QasmExperimentCalibrations",
+ "url": "/api/qiskit/0.46/qiskit.qobj.QasmExperimentCalibrations"
+ },
+ {
+ "title": "QasmQobj",
+ "url": "/api/qiskit/0.46/qiskit.qobj.QasmQobj"
+ },
+ {
+ "title": "QasmQobjConfig",
+ "url": "/api/qiskit/0.46/qiskit.qobj.QasmQobjConfig"
+ },
+ {
+ "title": "QasmQobjExperiment",
+ "url": "/api/qiskit/0.46/qiskit.qobj.QasmQobjExperiment"
+ },
+ {
+ "title": "QasmQobjExperimentConfig",
+ "url": "/api/qiskit/0.46/qiskit.qobj.QasmQobjExperimentConfig"
+ },
+ {
+ "title": "QasmQobjInstruction",
+ "url": "/api/qiskit/0.46/qiskit.qobj.QasmQobjInstruction"
+ },
+ {
+ "title": "QobjExperimentHeader",
+ "url": "/api/qiskit/0.46/qiskit.qobj.QobjExperimentHeader"
+ },
+ {
+ "title": "QobjHeader",
+ "url": "/api/qiskit/0.46/qiskit.qobj.QobjHeader"
+ },
+ {
+ "title": "QobjMeasurementOption",
+ "url": "/api/qiskit/0.46/qiskit.qobj.QobjMeasurementOption"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.qpy",
+ "url": "/api/qiskit/0.46/qpy"
+ },
+ {
+ "title": "qiskit.quantum_info",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/quantum_info"
+ },
+ {
+ "title": "Chi",
+ "url": "/api/qiskit/0.46/qiskit.quantum_info.Chi"
+ },
+ {
+ "title": "Choi",
+ "url": "/api/qiskit/0.46/qiskit.quantum_info.Choi"
+ },
+ {
+ "title": "Clifford",
+ "url": "/api/qiskit/0.46/qiskit.quantum_info.Clifford"
+ },
+ {
+ "title": "CNOTDihedral",
+ "url": "/api/qiskit/0.46/qiskit.quantum_info.CNOTDihedral"
+ },
+ {
+ "title": "DensityMatrix",
+ "url": "/api/qiskit/0.46/qiskit.quantum_info.DensityMatrix"
+ },
+ {
+ "title": "Kraus",
+ "url": "/api/qiskit/0.46/qiskit.quantum_info.Kraus"
+ },
+ {
+ "title": "Operator",
+ "url": "/api/qiskit/0.46/qiskit.quantum_info.Operator"
+ },
+ {
+ "title": "Pauli",
+ "url": "/api/qiskit/0.46/qiskit.quantum_info.Pauli"
+ },
+ {
+ "title": "pauli_basis",
+ "url": "/api/qiskit/0.46/qiskit.quantum_info.pauli_basis"
+ },
+ {
+ "title": "PauliList",
+ "url": "/api/qiskit/0.46/qiskit.quantum_info.PauliList"
+ },
+ {
+ "title": "PTM",
+ "url": "/api/qiskit/0.46/qiskit.quantum_info.PTM"
+ },
+ {
+ "title": "Quaternion",
+ "url": "/api/qiskit/0.46/qiskit.quantum_info.Quaternion"
+ },
+ {
+ "title": "ScalarOp",
+ "url": "/api/qiskit/0.46/qiskit.quantum_info.ScalarOp"
+ },
+ {
+ "title": "SparsePauliOp",
+ "url": "/api/qiskit/0.46/qiskit.quantum_info.SparsePauliOp"
+ },
+ {
+ "title": "StabilizerState",
+ "url": "/api/qiskit/0.46/qiskit.quantum_info.StabilizerState"
+ },
+ {
+ "title": "Statevector",
+ "url": "/api/qiskit/0.46/qiskit.quantum_info.Statevector"
+ },
+ {
+ "title": "Stinespring",
+ "url": "/api/qiskit/0.46/qiskit.quantum_info.Stinespring"
+ },
+ {
+ "title": "SuperOp",
+ "url": "/api/qiskit/0.46/qiskit.quantum_info.SuperOp"
+ },
+ {
+ "title": "Z2Symmetries",
+ "url": "/api/qiskit/0.46/qiskit.quantum_info.Z2Symmetries"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.result",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/result"
+ },
+ {
+ "title": "BaseReadoutMitigator",
+ "url": "/api/qiskit/0.46/qiskit.result.BaseReadoutMitigator"
+ },
+ {
+ "title": "CorrelatedReadoutMitigator",
+ "url": "/api/qiskit/0.46/qiskit.result.CorrelatedReadoutMitigator"
+ },
+ {
+ "title": "Counts",
+ "url": "/api/qiskit/0.46/qiskit.result.Counts"
+ },
+ {
+ "title": "LocalReadoutMitigator",
+ "url": "/api/qiskit/0.46/qiskit.result.LocalReadoutMitigator"
+ },
+ {
+ "title": "ProbDistribution",
+ "url": "/api/qiskit/0.46/qiskit.result.ProbDistribution"
+ },
+ {
+ "title": "QuasiDistribution",
+ "url": "/api/qiskit/0.46/qiskit.result.QuasiDistribution"
+ },
+ {
+ "title": "Result",
+ "url": "/api/qiskit/0.46/qiskit.result.Result"
+ },
+ {
+ "title": "ResultError",
+ "url": "/api/qiskit/0.46/qiskit.result.ResultError"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.scheduler",
+ "url": "/api/qiskit/0.46/scheduler"
+ },
+ {
+ "title": "qiskit.synthesis",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/synthesis"
+ },
+ {
+ "title": "EvolutionSynthesis",
+ "url": "/api/qiskit/0.46/qiskit.synthesis.EvolutionSynthesis"
+ },
+ {
+ "title": "LieTrotter",
+ "url": "/api/qiskit/0.46/qiskit.synthesis.LieTrotter"
+ },
+ {
+ "title": "MatrixExponential",
+ "url": "/api/qiskit/0.46/qiskit.synthesis.MatrixExponential"
+ },
+ {
+ "title": "OneQubitEulerDecomposer",
+ "url": "/api/qiskit/0.46/qiskit.synthesis.OneQubitEulerDecomposer"
+ },
+ {
+ "title": "ProductFormula",
+ "url": "/api/qiskit/0.46/qiskit.synthesis.ProductFormula"
+ },
+ {
+ "title": "QDrift",
+ "url": "/api/qiskit/0.46/qiskit.synthesis.QDrift"
+ },
+ {
+ "title": "SolovayKitaevDecomposition",
+ "url": "/api/qiskit/0.46/qiskit.synthesis.SolovayKitaevDecomposition"
+ },
+ {
+ "title": "SuzukiTrotter",
+ "url": "/api/qiskit/0.46/qiskit.synthesis.SuzukiTrotter"
+ },
+ {
+ "title": "TwoQubitBasisDecomposer",
+ "url": "/api/qiskit/0.46/qiskit.synthesis.TwoQubitBasisDecomposer"
+ },
+ {
+ "title": "XXDecomposer",
+ "url": "/api/qiskit/0.46/qiskit.synthesis.XXDecomposer"
+ },
+ {
+ "title": "qiskit.synthesis.unitary.aqc",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/synthesis_aqc"
+ },
+ {
+ "title": "ApproximateCircuit",
+ "url": "/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.ApproximateCircuit"
+ },
+ {
+ "title": "ApproximatingObjective",
+ "url": "/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.ApproximatingObjective"
+ },
+ {
+ "title": "AQC",
+ "url": "/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.AQC"
+ },
+ {
+ "title": "CNOTUnitCircuit",
+ "url": "/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.CNOTUnitCircuit"
+ },
+ {
+ "title": "CNOTUnitObjective",
+ "url": "/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.CNOTUnitObjective"
+ },
+ {
+ "title": "DefaultCNOTUnitObjective",
+ "url": "/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.DefaultCNOTUnitObjective"
+ },
+ {
+ "title": "FastCNOTUnitObjective",
+ "url": "/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.FastCNOTUnitObjective"
+ }
+ ]
+ }
+ ]
+ },
+ {
+ "title": "qiskit.tools",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/tools"
+ },
+ {
+ "title": "qiskit.tools.jupyter",
+ "url": "/api/qiskit/0.46/tools_jupyter"
+ }
+ ]
+ },
+ {
+ "title": "qiskit.transpiler",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/transpiler"
+ },
+ {
+ "title": "AnalysisPass",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.AnalysisPass"
+ },
+ {
+ "title": "CouplingMap",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.CouplingMap"
+ },
+ {
+ "title": "FencedDAGCircuit",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.FencedDAGCircuit"
+ },
+ {
+ "title": "FencedPropertySet",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.FencedPropertySet"
+ },
+ {
+ "title": "InstructionDurations",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.InstructionDurations"
+ },
+ {
+ "title": "InstructionProperties",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.InstructionProperties"
+ },
+ {
+ "title": "Layout",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.Layout"
+ },
+ {
+ "title": "PassManager",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.PassManager"
+ },
+ {
+ "title": "PassManagerConfig",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.PassManagerConfig"
+ },
+ {
+ "title": "StagedPassManager",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.StagedPassManager"
+ },
+ {
+ "title": "Target",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.Target"
+ },
+ {
+ "title": "TransformationPass",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.TransformationPass"
+ },
+ {
+ "title": "TranspileLayout",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.TranspileLayout"
+ },
+ {
+ "title": "qiskit.transpiler.passes",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/transpiler_passes"
+ },
+ {
+ "title": "ALAPSchedule",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.ALAPSchedule"
+ },
+ {
+ "title": "ALAPScheduleAnalysis",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.ALAPScheduleAnalysis"
+ },
+ {
+ "title": "AlignMeasures",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.AlignMeasures"
+ },
+ {
+ "title": "ApplyLayout",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.ApplyLayout"
+ },
+ {
+ "title": "AQCSynthesisPlugin",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.AQCSynthesisPlugin"
+ },
+ {
+ "title": "ASAPSchedule",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.ASAPSchedule"
+ },
+ {
+ "title": "ASAPScheduleAnalysis",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.ASAPScheduleAnalysis"
+ },
+ {
+ "title": "BarrierBeforeFinalMeasurements",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.BarrierBeforeFinalMeasurements"
+ },
+ {
+ "title": "BasicSwap",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.BasicSwap"
+ },
+ {
+ "title": "BasisTranslator",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.BasisTranslator"
+ },
+ {
+ "title": "CheckGateDirection",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.CheckGateDirection"
+ },
+ {
+ "title": "CheckMap",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.CheckMap"
+ },
+ {
+ "title": "Collect1qRuns",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.Collect1qRuns"
+ },
+ {
+ "title": "Collect2qBlocks",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.Collect2qBlocks"
+ },
+ {
+ "title": "CollectCliffords",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.CollectCliffords"
+ },
+ {
+ "title": "CollectLinearFunctions",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.CollectLinearFunctions"
+ },
+ {
+ "title": "CollectMultiQBlocks",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.CollectMultiQBlocks"
+ },
+ {
+ "title": "CommutationAnalysis",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.CommutationAnalysis"
+ },
+ {
+ "title": "CommutativeCancellation",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.CommutativeCancellation"
+ },
+ {
+ "title": "CommutativeInverseCancellation",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.CommutativeInverseCancellation"
+ },
+ {
+ "title": "Commuting2qGateRouter",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.Commuting2qGateRouter"
+ },
+ {
+ "title": "ConsolidateBlocks",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.ConsolidateBlocks"
+ },
+ {
+ "title": "ConstrainedReschedule",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.ConstrainedReschedule"
+ },
+ {
+ "title": "ContainsInstruction",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.ContainsInstruction"
+ },
+ {
+ "title": "ConvertConditionsToIfOps",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.ConvertConditionsToIfOps"
+ },
+ {
+ "title": "CountOps",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.CountOps"
+ },
+ {
+ "title": "CountOpsLongestPath",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.CountOpsLongestPath"
+ },
+ {
+ "title": "CrosstalkAdaptiveSchedule",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.CrosstalkAdaptiveSchedule"
+ },
+ {
+ "title": "CSPLayout",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.CSPLayout"
+ },
+ {
+ "title": "CXCancellation",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.CXCancellation"
+ },
+ {
+ "title": "DAGFixedPoint",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.DAGFixedPoint"
+ },
+ {
+ "title": "DAGLongestPath",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.DAGLongestPath"
+ },
+ {
+ "title": "Decompose",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.Decompose"
+ },
+ {
+ "title": "DenseLayout",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.DenseLayout"
+ },
+ {
+ "title": "Depth",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.Depth"
+ },
+ {
+ "title": "DynamicalDecoupling",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.DynamicalDecoupling"
+ },
+ {
+ "title": "EchoRZXWeylDecomposition",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.EchoRZXWeylDecomposition"
+ },
+ {
+ "title": "EnlargeWithAncilla",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.EnlargeWithAncilla"
+ },
+ {
+ "title": "FixedPoint",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.FixedPoint"
+ },
+ {
+ "title": "FullAncillaAllocation",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.FullAncillaAllocation"
+ },
+ {
+ "title": "GateDirection",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.GateDirection"
+ },
+ {
+ "title": "GatesInBasis",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.GatesInBasis"
+ },
+ {
+ "title": "HighLevelSynthesis",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.HighLevelSynthesis"
+ },
+ {
+ "title": "HoareOptimizer",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.HoareOptimizer"
+ },
+ {
+ "title": "InstructionDurationCheck",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.InstructionDurationCheck"
+ },
+ {
+ "title": "InverseCancellation",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.InverseCancellation"
+ },
+ {
+ "title": "Layout2qDistance",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.Layout2qDistance"
+ },
+ {
+ "title": "LinearFunctionsSynthesis",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.LinearFunctionsSynthesis"
+ },
+ {
+ "title": "LinearFunctionsToPermutations",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.LinearFunctionsToPermutations"
+ },
+ {
+ "title": "LookaheadSwap",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.LookaheadSwap"
+ },
+ {
+ "title": "MergeAdjacentBarriers",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.MergeAdjacentBarriers"
+ },
+ {
+ "title": "MinimumPoint",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.MinimumPoint"
+ },
+ {
+ "title": "NoiseAdaptiveLayout",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.NoiseAdaptiveLayout"
+ },
+ {
+ "title": "NormalizeRXAngle",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.NormalizeRXAngle"
+ },
+ {
+ "title": "NumTensorFactors",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.NumTensorFactors"
+ },
+ {
+ "title": "Optimize1qGates",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.Optimize1qGates"
+ },
+ {
+ "title": "Optimize1qGatesDecomposition",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.Optimize1qGatesDecomposition"
+ },
+ {
+ "title": "Optimize1qGatesSimpleCommutation",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.Optimize1qGatesSimpleCommutation"
+ },
+ {
+ "title": "OptimizeCliffords",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.OptimizeCliffords"
+ },
+ {
+ "title": "PadDelay",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.PadDelay"
+ },
+ {
+ "title": "PadDynamicalDecoupling",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.PadDynamicalDecoupling"
+ },
+ {
+ "title": "PulseGates",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.PulseGates"
+ },
+ {
+ "title": "RemoveBarriers",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.RemoveBarriers"
+ },
+ {
+ "title": "RemoveDiagonalGatesBeforeMeasure",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.RemoveDiagonalGatesBeforeMeasure"
+ },
+ {
+ "title": "RemoveFinalMeasurements",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.RemoveFinalMeasurements"
+ },
+ {
+ "title": "RemoveResetInZeroState",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.RemoveResetInZeroState"
+ },
+ {
+ "title": "ResetAfterMeasureSimplification",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.ResetAfterMeasureSimplification"
+ },
+ {
+ "title": "RXCalibrationBuilder",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.RXCalibrationBuilder"
+ },
+ {
+ "title": "RZXCalibrationBuilder",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.RZXCalibrationBuilder"
+ },
+ {
+ "title": "RZXCalibrationBuilderNoEcho",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.RZXCalibrationBuilderNoEcho"
+ },
+ {
+ "title": "SabreLayout",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.SabreLayout"
+ },
+ {
+ "title": "SabrePreLayout",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.SabrePreLayout"
+ },
+ {
+ "title": "SabreSwap",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.SabreSwap"
+ },
+ {
+ "title": "SetIOLatency",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.SetIOLatency"
+ },
+ {
+ "title": "SetLayout",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.SetLayout"
+ },
+ {
+ "title": "Size",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.Size"
+ },
+ {
+ "title": "SolovayKitaev",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.SolovayKitaev"
+ },
+ {
+ "title": "SolovayKitaevSynthesis",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.SolovayKitaevSynthesis"
+ },
+ {
+ "title": "StochasticSwap",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.StochasticSwap"
+ },
+ {
+ "title": "TemplateOptimization",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.TemplateOptimization"
+ },
+ {
+ "title": "TimeUnitConversion",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.TimeUnitConversion"
+ },
+ {
+ "title": "TranslateParameterizedGates",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.TranslateParameterizedGates"
+ },
+ {
+ "title": "TrivialLayout",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.TrivialLayout"
+ },
+ {
+ "title": "UnitarySynthesis",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.UnitarySynthesis"
+ },
+ {
+ "title": "Unroll3qOrMore",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.Unroll3qOrMore"
+ },
+ {
+ "title": "UnrollCustomDefinitions",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.UnrollCustomDefinitions"
+ },
+ {
+ "title": "Unroller",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.Unroller"
+ },
+ {
+ "title": "UnrollForLoops",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.UnrollForLoops"
+ },
+ {
+ "title": "ValidatePulseGates",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.ValidatePulseGates"
+ },
+ {
+ "title": "VF2Layout",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.VF2Layout"
+ },
+ {
+ "title": "VF2PostLayout",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.VF2PostLayout"
+ },
+ {
+ "title": "Width",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.Width"
+ },
+ {
+ "title": "qiskit.transpiler.passes.synthesis.plugin",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/transpiler_synthesis_plugins"
+ },
+ {
+ "title": "HighLevelSynthesisPlugin",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPlugin"
+ },
+ {
+ "title": "HighLevelSynthesisPluginManager",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPluginManager"
+ },
+ {
+ "title": "unitary_synthesis_plugin_names",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names"
+ },
+ {
+ "title": "UnitarySynthesisPlugin",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin"
+ },
+ {
+ "title": "UnitarySynthesisPluginManager",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPluginManager"
+ }
+ ]
+ }
+ ]
+ },
+ {
+ "title": "qiskit.transpiler.preset_passmanagers",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/transpiler_preset"
+ },
+ {
+ "title": "qiskit.transpiler.preset_passmanagers.plugin",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/transpiler_plugins"
+ },
+ {
+ "title": "PassManagerStagePlugin",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePlugin"
+ },
+ {
+ "title": "PassManagerStagePluginManager",
+ "url": "/api/qiskit/0.46/qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePluginManager"
+ }
+ ]
+ }
+ ]
+ }
+ ]
+ },
+ {
+ "title": "qiskit.utils",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/utils"
+ },
+ {
+ "title": "QuantumInstance",
+ "url": "/api/qiskit/0.46/qiskit.utils.QuantumInstance"
+ },
+ {
+ "title": "qiskit.utils.mitigation",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/utils_mitigation"
+ },
+ {
+ "title": "CompleteMeasFitter",
+ "url": "/api/qiskit/0.46/qiskit.utils.mitigation.CompleteMeasFitter"
+ },
+ {
+ "title": "TensoredMeasFitter",
+ "url": "/api/qiskit/0.46/qiskit.utils.mitigation.TensoredMeasFitter"
+ }
+ ]
+ }
+ ]
+ },
+ {
+ "title": "qiskit.visualization",
+ "children": [
+ {
+ "title": "Overview",
+ "url": "/api/qiskit/0.46/visualization"
+ },
+ {
+ "title": "array_to_latex",
+ "url": "/api/qiskit/0.46/qiskit.visualization.array_to_latex"
+ },
+ {
+ "title": "circuit_drawer",
+ "url": "/api/qiskit/0.46/qiskit.visualization.circuit_drawer"
+ },
+ {
+ "title": "dag_drawer",
+ "url": "/api/qiskit/0.46/qiskit.visualization.dag_drawer"
+ },
+ {
+ "title": "DefaultStyle",
+ "url": "/api/qiskit/0.46/qiskit.visualization.circuit.qcstyle.DefaultStyle"
+ },
+ {
+ "title": "IQXDebugging",
+ "url": "/api/qiskit/0.46/qiskit.visualization.pulse.IQXDebugging"
+ },
+ {
+ "title": "IQXSimple",
+ "url": "/api/qiskit/0.46/qiskit.visualization.pulse.IQXSimple"
+ },
+ {
+ "title": "IQXStandard",
+ "url": "/api/qiskit/0.46/qiskit.visualization.pulse.IQXStandard"
+ },
+ {
+ "title": "pass_manager_drawer",
+ "url": "/api/qiskit/0.46/qiskit.visualization.pass_manager_drawer"
+ },
+ {
+ "title": "plot_bloch_multivector",
+ "url": "/api/qiskit/0.46/qiskit.visualization.plot_bloch_multivector"
+ },
+ {
+ "title": "plot_bloch_vector",
+ "url": "/api/qiskit/0.46/qiskit.visualization.plot_bloch_vector"
+ },
+ {
+ "title": "plot_circuit_layout",
+ "url": "/api/qiskit/0.46/qiskit.visualization.plot_circuit_layout"
+ },
+ {
+ "title": "plot_coupling_map",
+ "url": "/api/qiskit/0.46/qiskit.visualization.plot_coupling_map"
+ },
+ {
+ "title": "plot_distribution",
+ "url": "/api/qiskit/0.46/qiskit.visualization.plot_distribution"
+ },
+ {
+ "title": "plot_error_map",
+ "url": "/api/qiskit/0.46/qiskit.visualization.plot_error_map"
+ },
+ {
+ "title": "plot_gate_map",
+ "url": "/api/qiskit/0.46/qiskit.visualization.plot_gate_map"
+ },
+ {
+ "title": "plot_histogram",
+ "url": "/api/qiskit/0.46/qiskit.visualization.plot_histogram"
+ },
+ {
+ "title": "plot_state_city",
+ "url": "/api/qiskit/0.46/qiskit.visualization.plot_state_city"
+ },
+ {
+ "title": "plot_state_hinton",
+ "url": "/api/qiskit/0.46/qiskit.visualization.plot_state_hinton"
+ },
+ {
+ "title": "plot_state_paulivec",
+ "url": "/api/qiskit/0.46/qiskit.visualization.plot_state_paulivec"
+ },
+ {
+ "title": "plot_state_qsphere",
+ "url": "/api/qiskit/0.46/qiskit.visualization.plot_state_qsphere"
+ },
+ {
+ "title": "pulse_drawer",
+ "url": "/api/qiskit/0.46/qiskit.visualization.pulse_drawer"
+ },
+ {
+ "title": "timeline_drawer",
+ "url": "/api/qiskit/0.46/qiskit.visualization.timeline_drawer"
+ },
+ {
+ "title": "visualize_transition",
+ "url": "/api/qiskit/0.46/qiskit.visualization.visualize_transition"
+ }
+ ]
+ },
+ {
+ "title": "Release notes",
+ "children": [
+ {
+ "title": "0.46",
+ "url": "/api/qiskit/release-notes/0.46"
+ },
+ {
+ "title": "0.45",
+ "url": "/api/qiskit/release-notes/0.45"
+ },
+ {
+ "title": "0.44",
+ "url": "/api/qiskit/release-notes/0.44"
+ },
+ {
+ "title": "0.43",
+ "url": "/api/qiskit/release-notes/0.43"
+ },
+ {
+ "title": "0.42",
+ "url": "/api/qiskit/release-notes/0.42"
+ },
+ {
+ "title": "0.41",
+ "url": "/api/qiskit/release-notes/0.41"
+ },
+ {
+ "title": "0.40",
+ "url": "/api/qiskit/release-notes/0.40"
+ },
+ {
+ "title": "0.39",
+ "url": "/api/qiskit/release-notes/0.39"
+ },
+ {
+ "title": "0.38",
+ "url": "/api/qiskit/release-notes/0.38"
+ },
+ {
+ "title": "0.37",
+ "url": "/api/qiskit/release-notes/0.37"
+ },
+ {
+ "title": "0.36",
+ "url": "/api/qiskit/release-notes/0.36"
+ },
+ {
+ "title": "0.35",
+ "url": "/api/qiskit/release-notes/0.35"
+ },
+ {
+ "title": "0.34",
+ "url": "/api/qiskit/release-notes/0.34"
+ },
+ {
+ "title": "0.33",
+ "url": "/api/qiskit/release-notes/0.33"
+ },
+ {
+ "title": "0.32",
+ "url": "/api/qiskit/release-notes/0.32"
+ },
+ {
+ "title": "0.31",
+ "url": "/api/qiskit/release-notes/0.31"
+ },
+ {
+ "title": "0.30",
+ "url": "/api/qiskit/release-notes/0.30"
+ },
+ {
+ "title": "0.29",
+ "url": "/api/qiskit/release-notes/0.29"
+ },
+ {
+ "title": "0.28",
+ "url": "/api/qiskit/release-notes/0.28"
+ },
+ {
+ "title": "0.27",
+ "url": "/api/qiskit/release-notes/0.27"
+ },
+ {
+ "title": "0.26",
+ "url": "/api/qiskit/release-notes/0.26"
+ },
+ {
+ "title": "0.25",
+ "url": "/api/qiskit/release-notes/0.25"
+ },
+ {
+ "title": "0.24",
+ "url": "/api/qiskit/release-notes/0.24"
+ },
+ {
+ "title": "0.23",
+ "url": "/api/qiskit/release-notes/0.23"
+ },
+ {
+ "title": "0.22",
+ "url": "/api/qiskit/release-notes/0.22"
+ },
+ {
+ "title": "0.21",
+ "url": "/api/qiskit/release-notes/0.21"
+ },
+ {
+ "title": "0.20",
+ "url": "/api/qiskit/release-notes/0.20"
+ },
+ {
+ "title": "0.19",
+ "url": "/api/qiskit/release-notes/0.19"
+ },
+ {
+ "title": "0.18",
+ "url": "/api/qiskit/release-notes/0.18"
+ },
+ {
+ "title": "0.17",
+ "url": "/api/qiskit/release-notes/0.17"
+ },
+ {
+ "title": "0.16",
+ "url": "/api/qiskit/release-notes/0.16"
+ },
+ {
+ "title": "0.15",
+ "url": "/api/qiskit/release-notes/0.15"
+ },
+ {
+ "title": "0.14",
+ "url": "/api/qiskit/release-notes/0.14"
+ },
+ {
+ "title": "0.13",
+ "url": "/api/qiskit/release-notes/0.13"
+ },
+ {
+ "title": "0.12",
+ "url": "/api/qiskit/release-notes/0.12"
+ },
+ {
+ "title": "0.11",
+ "url": "/api/qiskit/release-notes/0.11"
+ },
+ {
+ "title": "0.10",
+ "url": "/api/qiskit/release-notes/0.10"
+ },
+ {
+ "title": "0.9",
+ "url": "/api/qiskit/release-notes/0.9"
+ },
+ {
+ "title": "0.8",
+ "url": "/api/qiskit/release-notes/0.8"
+ },
+ {
+ "title": "0.7",
+ "url": "/api/qiskit/release-notes/0.7"
+ },
+ {
+ "title": "0.6",
+ "url": "/api/qiskit/release-notes/0.6"
+ },
+ {
+ "title": "0.5",
+ "url": "/api/qiskit/release-notes/0.5"
+ }
+ ]
+ }
+ ],
+ "collapsed": true
+}
+
diff --git a/docs/api/qiskit/0.46/algorithms.md b/docs/api/qiskit/0.46/algorithms.md
new file mode 100644
index 00000000000..069d9bd0d13
--- /dev/null
+++ b/docs/api/qiskit/0.46/algorithms.md
@@ -0,0 +1,279 @@
+---
+title: algorithms
+description: API reference for qiskit.algorithms
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.algorithms
+---
+
+
+
+
+
+
+
+# Algorithms
+
+
+
+`qiskit.algorithms`
+
+
+ The [`qiskit.algorithms`](#module-qiskit.algorithms "qiskit.algorithms") module has been migrated to an independent package: [https://github.com/qiskit-community/qiskit-algorithms](https://github.com/qiskit-community/qiskit-algorithms). The current import path is deprecated and will be removed no earlier than 3 months after the release date. If your code uses primitives, you can run `pip install qiskit_algorithms` and import `from qiskit_algorithms` instead. If you use opflow/quantum instance-based algorithms, please update your code to use primitives following: [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) before migrating to the new package.
+
+
+It contains a collection of quantum algorithms, for use with quantum computers, to carry out research and investigate how to solve problems in different domains on near-term quantum devices with short depth circuits.
+
+Algorithms configuration includes the use of [`optimizers`](qiskit.algorithms.optimizers#module-qiskit.algorithms.optimizers "qiskit.algorithms.optimizers") which were designed to be swappable sub-parts of an algorithm. Any component and may be exchanged for a different implementation of the same component type in order to potentially alter the behavior and outcome of the algorithm.
+
+Quantum algorithms are run via a `QuantumInstance` which must be set with the desired backend where the algorithm’s circuits will be executed and be configured with a number of compile and runtime parameters controlling circuit compilation and execution. It ultimately uses [Terra](https://www.qiskit.org/terra) for the actual compilation and execution of the quantum circuits created by the algorithm and its components.
+
+## Algorithms
+
+It contains a variety of quantum algorithms and these have been grouped by logical function such as minimum eigensolvers and amplitude amplifiers.
+
+### Amplitude Amplifiers
+
+| | |
+| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
+| [`AmplificationProblem`](qiskit.algorithms.AmplificationProblem "qiskit.algorithms.AmplificationProblem") | The amplification problem is the input to amplitude amplification algorithms, like Grover. |
+| [`AmplitudeAmplifier`](qiskit.algorithms.AmplitudeAmplifier "qiskit.algorithms.AmplitudeAmplifier") | The interface for amplification algorithms. |
+| [`Grover`](qiskit.algorithms.Grover "qiskit.algorithms.Grover") | Grover's Search algorithm. |
+| [`GroverResult`](qiskit.algorithms.GroverResult "qiskit.algorithms.GroverResult") | Grover Result. |
+
+### Amplitude Estimators
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
+| [`AmplitudeEstimator`](qiskit.algorithms.AmplitudeEstimator "qiskit.algorithms.AmplitudeEstimator") | The Amplitude Estimation interface. |
+| [`AmplitudeEstimatorResult`](qiskit.algorithms.AmplitudeEstimatorResult "qiskit.algorithms.AmplitudeEstimatorResult") | The results object for amplitude estimation algorithms. |
+| [`AmplitudeEstimation`](qiskit.algorithms.AmplitudeEstimation "qiskit.algorithms.AmplitudeEstimation") | The Quantum Phase Estimation-based Amplitude Estimation algorithm. |
+| [`AmplitudeEstimationResult`](qiskit.algorithms.AmplitudeEstimationResult "qiskit.algorithms.AmplitudeEstimationResult") | The `AmplitudeEstimation` result object. |
+| [`EstimationProblem`](qiskit.algorithms.EstimationProblem "qiskit.algorithms.EstimationProblem") | The estimation problem is the input to amplitude estimation algorithm. |
+| [`FasterAmplitudeEstimation`](qiskit.algorithms.FasterAmplitudeEstimation "qiskit.algorithms.FasterAmplitudeEstimation") | The Faster Amplitude Estimation algorithm. |
+| [`FasterAmplitudeEstimationResult`](qiskit.algorithms.FasterAmplitudeEstimationResult "qiskit.algorithms.FasterAmplitudeEstimationResult") | The result object for the Faster Amplitude Estimation algorithm. |
+| [`IterativeAmplitudeEstimation`](qiskit.algorithms.IterativeAmplitudeEstimation "qiskit.algorithms.IterativeAmplitudeEstimation") | The Iterative Amplitude Estimation algorithm. |
+| [`IterativeAmplitudeEstimationResult`](qiskit.algorithms.IterativeAmplitudeEstimationResult "qiskit.algorithms.IterativeAmplitudeEstimationResult") | The `IterativeAmplitudeEstimation` result object. |
+| [`MaximumLikelihoodAmplitudeEstimation`](qiskit.algorithms.MaximumLikelihoodAmplitudeEstimation "qiskit.algorithms.MaximumLikelihoodAmplitudeEstimation") | The Maximum Likelihood Amplitude Estimation algorithm. |
+| [`MaximumLikelihoodAmplitudeEstimationResult`](qiskit.algorithms.MaximumLikelihoodAmplitudeEstimationResult "qiskit.algorithms.MaximumLikelihoodAmplitudeEstimationResult") | The `MaximumLikelihoodAmplitudeEstimation` result object. |
+
+### Eigensolvers
+
+Algorithms to find eigenvalues of an operator. For chemistry these can be used to find excited states of a molecule, and `qiskit-nature` has some algorithms that leverage chemistry specific knowledge to do this in that application domain.
+
+#### Primitive-based Eigensolvers
+
+These algorithms are based on the Qiskit Primitives, a new execution paradigm that replaces the use of [`QuantumInstance`](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance") in algorithms. To ensure continued support and development, we recommend using the primitive-based Eigensolvers in place of the legacy [`QuantumInstance`](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance")-based ones.
+
+| | |
+| ----------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
+| [`eigensolvers`](qiskit.algorithms.eigensolvers#module-qiskit.algorithms.eigensolvers "qiskit.algorithms.eigensolvers") | Eigensolvers Package (qiskit.algorithms.eigensolvers) |
+
+#### Legacy Eigensolvers
+
+These algorithms, still based on the [`QuantumInstance`](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance"), are superseded by the primitive-based versions in the section above but are still supported for now.
+
+| | |
+| ------------------------------------------------------------------------------------------------ | ---------------------------------------------------- |
+| [`Eigensolver`](qiskit.algorithms.Eigensolver "qiskit.algorithms.Eigensolver") | Deprecated: Eigensolver Interface. |
+| [`EigensolverResult`](qiskit.algorithms.EigensolverResult "qiskit.algorithms.EigensolverResult") | Deprecated: Eigensolver Result. |
+| [`NumPyEigensolver`](qiskit.algorithms.NumPyEigensolver "qiskit.algorithms.NumPyEigensolver") | Deprecated: NumPy Eigensolver algorithm. |
+| [`VQD`](qiskit.algorithms.VQD "qiskit.algorithms.VQD") | Deprecated: Variational Quantum Deflation algorithm. |
+| [`VQDResult`](qiskit.algorithms.VQDResult "qiskit.algorithms.VQDResult") | Deprecated: VQD Result. |
+
+### Time Evolvers
+
+Algorithms to evolve quantum states in time. Both real and imaginary time evolution is possible with algorithms that support them. For machine learning, Quantum Imaginary Time Evolution might be used to train Quantum Boltzmann Machine Neural Networks for example.
+
+#### Primitive-based Time Evolvers
+
+These algorithms are based on the Qiskit Primitives, a new execution paradigm that replaces the use of [`QuantumInstance`](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance") in algorithms. To ensure continued support and development, we recommend using the primitive-based Time Evolvers in place of the legacy [`QuantumInstance`](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance")-based ones.
+
+| | |
+| ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------- |
+| [`RealTimeEvolver`](qiskit.algorithms.RealTimeEvolver "qiskit.algorithms.RealTimeEvolver") | Interface for Quantum Real Time Evolution. |
+| [`ImaginaryTimeEvolver`](qiskit.algorithms.ImaginaryTimeEvolver "qiskit.algorithms.ImaginaryTimeEvolver") | Interface for Quantum Imaginary Time Evolution. |
+| [`TimeEvolutionResult`](qiskit.algorithms.TimeEvolutionResult "qiskit.algorithms.TimeEvolutionResult") | Class for holding time evolution result. |
+| [`TimeEvolutionProblem`](qiskit.algorithms.TimeEvolutionProblem "qiskit.algorithms.TimeEvolutionProblem") | Time evolution problem class. |
+| [`PVQD`](qiskit.algorithms.PVQD "qiskit.algorithms.PVQD") | The projected Variational Quantum Dynamics (p-VQD) Algorithm. |
+| [`PVQDResult`](qiskit.algorithms.PVQDResult "qiskit.algorithms.PVQDResult") | The result object for the p-VQD algorithm. |
+| [`SciPyImaginaryEvolver`](qiskit.algorithms.SciPyImaginaryEvolver "qiskit.algorithms.SciPyImaginaryEvolver") | Classical Evolver for imaginary time evolution. |
+| [`SciPyRealEvolver`](qiskit.algorithms.SciPyRealEvolver "qiskit.algorithms.SciPyRealEvolver") | Classical Evolver for real time evolution. |
+| [`VarQITE`](qiskit.algorithms.VarQITE "qiskit.algorithms.VarQITE") | Variational Quantum Imaginary Time Evolution algorithm. |
+| [`VarQRTE`](qiskit.algorithms.VarQRTE "qiskit.algorithms.VarQRTE") | Variational Quantum Real Time Evolution algorithm. |
+
+#### Legacy Time Evolvers
+
+These algorithms, still based on the [`QuantumInstance`](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance"), are superseded by the primitive-based versions in the section above but are still supported for now.
+
+| | |
+| --------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
+| [`RealEvolver`](qiskit.algorithms.RealEvolver "qiskit.algorithms.RealEvolver") | Deprecated: Interface for Quantum Real Time Evolution. |
+| [`ImaginaryEvolver`](qiskit.algorithms.ImaginaryEvolver "qiskit.algorithms.ImaginaryEvolver") | Deprecated: Interface for Quantum Imaginary Time Evolution. |
+| [`TrotterQRTE`](qiskit.algorithms.TrotterQRTE "qiskit.algorithms.TrotterQRTE") | Deprecated: Quantum Real Time Evolution using Trotterization. |
+| [`EvolutionResult`](qiskit.algorithms.EvolutionResult "qiskit.algorithms.EvolutionResult") | Deprecated: Class for holding evolution result. |
+| [`EvolutionProblem`](qiskit.algorithms.EvolutionProblem "qiskit.algorithms.EvolutionProblem") | Deprecated: Evolution problem class. |
+
+#### Variational Quantum Time Evolution
+
+Classes used by variational quantum time evolution algorithms - [`VarQITE`](qiskit.algorithms.VarQITE "qiskit.algorithms.VarQITE") and [`VarQRTE`](qiskit.algorithms.VarQRTE "qiskit.algorithms.VarQRTE").
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
+| [`time_evolvers.variational`](qiskit.algorithms.time_evolvers.variational#module-qiskit.algorithms.time_evolvers.variational "qiskit.algorithms.time_evolvers.variational") | Variational Quantum Time Evolutions (qiskit.algorithms.time\_evolvers.variational) |
+
+#### Trotterization-based Quantum Real Time Evolution
+
+Package for primitives-enabled Trotterization-based quantum time evolution algorithm - `TrotterQRTE`.
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
+| [`time_evolvers.trotterization`](qiskit.algorithms.time_evolvers.trotterization#module-qiskit.algorithms.time_evolvers.trotterization "qiskit.algorithms.time_evolvers.trotterization") | This package contains Trotterization-based Quantum Real Time Evolution algorithm. |
+
+### Gradients
+
+Algorithms to calculate the gradient of a quantum circuit.
+
+| | |
+| ----------------------------------------------------------------------------------------------------------- | --------------------------------------- |
+| [`gradients`](qiskit.algorithms.gradients#module-qiskit.algorithms.gradients "qiskit.algorithms.gradients") | Gradients (qiskit.algorithms.gradients) |
+
+### Minimum Eigensolvers
+
+Algorithms that can find the minimum eigenvalue of an operator.
+
+#### Primitive-based Minimum Eigensolvers
+
+These algorithms are based on the Qiskit Primitives, a new execution paradigm that replaces the use of [`QuantumInstance`](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance") in algorithms. To ensure continued support and development, we recommend using the primitive-based Minimum Eigensolvers in place of the legacy [`QuantumInstance`](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance")-based ones.
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
+| [`minimum_eigensolvers`](qiskit.algorithms.minimum_eigensolvers#module-qiskit.algorithms.minimum_eigensolvers "qiskit.algorithms.minimum_eigensolvers") | Minimum Eigensolvers Package (qiskit.algorithms.minimum\_eigensolvers) |
+
+#### Legacy Minimum Eigensolvers
+
+These algorithms, still based on the [`QuantumInstance`](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance"), are superseded by the primitive-based versions in the section above but are still supported for now.
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
+| [`MinimumEigensolver`](qiskit.algorithms.MinimumEigensolver "qiskit.algorithms.MinimumEigensolver") | Deprecated: Minimum Eigensolver Interface. |
+| [`MinimumEigensolverResult`](qiskit.algorithms.MinimumEigensolverResult "qiskit.algorithms.MinimumEigensolverResult") | Deprecated: Minimum Eigensolver Result. |
+| [`NumPyMinimumEigensolver`](qiskit.algorithms.NumPyMinimumEigensolver "qiskit.algorithms.NumPyMinimumEigensolver") | Deprecated: Numpy Minimum Eigensolver algorithm. |
+| [`QAOA`](qiskit.algorithms.QAOA "qiskit.algorithms.QAOA") | Deprecated: Quantum Approximate Optimization Algorithm. |
+| [`VQE`](qiskit.algorithms.VQE "qiskit.algorithms.VQE") | Deprecated: Variational Quantum Eigensolver algorithm. |
+
+### Optimizers
+
+Classical optimizers for use by quantum variational algorithms.
+
+| | |
+| --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`optimizers`](qiskit.algorithms.optimizers#module-qiskit.algorithms.optimizers "qiskit.algorithms.optimizers") | Optimizers (qiskit.algorithms.optimizers) It contains a variety of classical optimizers for use by quantum variational algorithms, such as VQE. Logically, these optimizers can be divided into two categories: |
+
+### Phase Estimators
+
+Algorithms that estimate the phases of eigenstates of a unitary.
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`HamiltonianPhaseEstimation`](qiskit.algorithms.HamiltonianPhaseEstimation "qiskit.algorithms.HamiltonianPhaseEstimation") | Run the Quantum Phase Estimation algorithm to find the eigenvalues of a Hermitian operator. |
+| [`HamiltonianPhaseEstimationResult`](qiskit.algorithms.HamiltonianPhaseEstimationResult "qiskit.algorithms.HamiltonianPhaseEstimationResult") | Store and manipulate results from running HamiltonianPhaseEstimation. |
+| [`PhaseEstimationScale`](qiskit.algorithms.PhaseEstimationScale "qiskit.algorithms.PhaseEstimationScale") | Set and use a bound on eigenvalues of a Hermitian operator in order to ensure phases are in the desired range and to convert measured phases into eigenvectors. |
+| [`PhaseEstimation`](qiskit.algorithms.PhaseEstimation "qiskit.algorithms.PhaseEstimation") | Run the Quantum Phase Estimation (QPE) algorithm. |
+| [`PhaseEstimationResult`](qiskit.algorithms.PhaseEstimationResult "qiskit.algorithms.PhaseEstimationResult") | Store and manipulate results from running PhaseEstimation. |
+| [`IterativePhaseEstimation`](qiskit.algorithms.IterativePhaseEstimation "qiskit.algorithms.IterativePhaseEstimation") | Run the Iterative quantum phase estimation (QPE) algorithm. |
+
+### State Fidelities
+
+Algorithms that compute the fidelity of pairs of quantum states.
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
+| [`state_fidelities`](qiskit.algorithms.state_fidelities#module-qiskit.algorithms.state_fidelities "qiskit.algorithms.state_fidelities") | State Fidelity Interfaces (qiskit.algorithms.state\_fidelities) |
+
+### Exceptions
+
+### AlgorithmError
+
+
+
+`qiskit.algorithms.AlgorithmError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/exceptions.py "view source code")
+
+For Algorithm specific errors.
+
+Set the error message.
+
+### Utility classes
+
+Utility classes used by algorithms (mainly for type-hinting purposes).
+
+| | |
+| --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
+| [`AlgorithmJob`](qiskit.algorithms.AlgorithmJob "qiskit.algorithms.AlgorithmJob")(function, \*args, \*\*kwargs) | This empty class is introduced for typing purposes. |
+
+### Utility functions
+
+Utility functions used by algorithms.
+
+### eval\_observables
+
+
+
+`qiskit.algorithms.eval_observables(quantum_instance, quantum_state, observables, expectation, threshold=1e-12)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/aux_ops_evaluator.py "view source code")
+
+Deprecated: Accepts a list or a dictionary of operators and calculates their expectation values - means and standard deviations. They are calculated with respect to a quantum state provided. A user can optionally provide a threshold value which filters mean values falling below the threshold.
+
+This function has been superseded by the `qiskit.algorithms.observables_evaluator.eval_observables()` function. It will be deprecated in a future release and subsequently removed after that.
+
+
+ The function `qiskit.algorithms.aux_ops_evaluator.eval_observables()` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. Instead, use the function `qiskit.algorithms.observables_evaluator.estimate_observables`. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+**Parameters**
+
+* **quantum\_instance** ([*QuantumInstance*](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance") *|*[*Backend*](qiskit.providers.Backend "qiskit.providers.Backend")) – A quantum instance used for calculations.
+* **quantum\_state** ([*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") *|*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *|*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")) – An unparametrized quantum circuit representing a quantum state that expectation values are computed against.
+* **observables** (*ListOrDict\[*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")*]*) – A list or a dictionary of operators whose expectation values are to be calculated.
+* **expectation** ([*ExpectationBase*](qiskit.opflow.expectations.ExpectationBase "qiskit.opflow.expectations.ExpectationBase")) – An instance of ExpectationBase which defines a method for calculating expectation values.
+* **threshold** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – A threshold value that defines which mean values should be neglected (helpful for ignoring numerical instabilities close to 0).
+
+**Returns**
+
+A list or a dictionary of tuples (mean, standard deviation).
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If a `quantum_state` with free parameters is provided.
+
+**Return type**
+
+ListOrDict\[[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)"), [complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")]]
+
+### estimate\_observables
+
+
+
+`qiskit.algorithms.estimate_observables(estimator, quantum_state, observables, parameter_values=None, threshold=1e-12)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/observables_evaluator.py "view source code")
+
+Accepts a sequence of operators and calculates their expectation values - means and metadata. They are calculated with respect to a quantum state provided. A user can optionally provide a threshold value which filters mean values falling below the threshold.
+
+**Parameters**
+
+* **estimator** ([*BaseEstimator*](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator")) – An estimator primitive used for calculations.
+* **quantum\_state** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – A (parameterized) quantum circuit preparing a quantum state that expectation values are computed against.
+* **observables** (*ListOrDict\[BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")*]*) – A list or a dictionary of operators whose expectation values are to be calculated.
+* **parameter\_values** (*Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – Optional list of parameters values to evaluate the quantum circuit on.
+* **threshold** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – A threshold value that defines which mean values should be neglected (helpful for ignoring numerical instabilities close to 0).
+
+**Returns**
+
+A list or a dictionary of tuples (mean, metadata).
+
+**Raises**
+
+[**AlgorithmError**](#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – If a primitive job is not successful.
+
+**Return type**
+
+ListOrDict\[[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)"), [dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)"), Any]]]
+
diff --git a/docs/api/qiskit/0.46/assembler.md b/docs/api/qiskit/0.46/assembler.md
new file mode 100644
index 00000000000..e41da15b1d5
--- /dev/null
+++ b/docs/api/qiskit/0.46/assembler.md
@@ -0,0 +1,186 @@
+---
+title: assembler
+description: API reference for qiskit.assembler
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.assembler
+---
+
+
+
+
+
+
+
+# Circuit and Schedule Assembler
+
+
+
+`qiskit.assembler`
+
+## Circuit Assembler
+
+### assemble\_circuits
+
+
+
+`qiskit.assembler.assemble_circuits(circuits, run_config, qobj_id, qobj_header)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/assembler/assemble_circuits.py "view source code")
+
+Assembles a list of circuits into a qobj that can be run on the backend.
+
+**Parameters**
+
+* **circuits** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")*]*) – circuit(s) to assemble
+* **run\_config** ([*RunConfig*](qiskit.assembler.RunConfig "qiskit.assembler.run_config.RunConfig")) – configuration of the runtime environment
+* **qobj\_id** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – identifier for the generated qobj
+* **qobj\_header** ([*QobjHeader*](qiskit.qobj.QobjHeader "qiskit.qobj.common.QobjHeader")) – header to pass to the results
+
+**Returns**
+
+The qobj to be run on the backends
+
+**Return type**
+
+[*QasmQobj*](qiskit.qobj.QasmQobj "qiskit.qobj.qasm_qobj.QasmQobj")
+
+**Examples**
+
+```python
+from qiskit.circuit import QuantumRegister, ClassicalRegister, QuantumCircuit
+from qiskit.assembler import assemble_circuits
+from qiskit.assembler.run_config import RunConfig
+# Build a circuit to convert into a Qobj
+q = QuantumRegister(2)
+c = ClassicalRegister(2)
+qc = QuantumCircuit(q, c)
+qc.h(q[0])
+qc.cx(q[0], q[1])
+qc.measure(q, c)
+# Assemble a Qobj from the input circuit
+qobj = assemble_circuits(circuits=[qc],
+ qobj_id="custom-id",
+ qobj_header=[],
+ run_config=RunConfig(shots=2000, memory=True, init_qubits=True))
+```
+
+## Schedule Assembler
+
+### assemble\_schedules
+
+
+
+`qiskit.assembler.assemble_schedules(schedules, qobj_id, qobj_header, run_config)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/assembler/assemble_schedules.py "view source code")
+
+Assembles a list of schedules into a qobj that can be run on the backend.
+
+**Parameters**
+
+* **schedules** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock") *|*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule") *|*[*Instruction*](pulse#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction") *|*[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*,* [*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule") *|*[*Instruction*](pulse#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")*]]*) – Schedules to assemble.
+* **qobj\_id** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Identifier for the generated qobj.
+* **qobj\_header** ([*QobjHeader*](qiskit.qobj.QobjHeader "qiskit.qobj.common.QobjHeader")) – Header to pass to the results.
+* **run\_config** ([*RunConfig*](qiskit.assembler.RunConfig "qiskit.assembler.run_config.RunConfig")) – Configuration of the runtime environment.
+
+**Returns**
+
+The Qobj to be run on the backends.
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – when frequency settings are not supplied.
+
+**Return type**
+
+[*PulseQobj*](qiskit.qobj.PulseQobj "qiskit.qobj.pulse_qobj.PulseQobj")
+
+**Examples**
+
+```python
+from qiskit import pulse
+from qiskit.assembler import assemble_schedules
+from qiskit.assembler.run_config import RunConfig
+# Construct a Qobj header for the output Qobj
+header = {"backend_name": "FakeOpenPulse2Q", "backend_version": "0.0.0"}
+# Build a configuration object for the output Qobj
+config = RunConfig(shots=1024,
+ memory=False,
+ meas_level=1,
+ meas_return='avg',
+ memory_slot_size=100,
+ parametric_pulses=[],
+ init_qubits=True,
+ qubit_lo_freq=[4900000000.0, 5000000000.0],
+ meas_lo_freq=[6500000000.0, 6600000000.0],
+ schedule_los=[])
+# Build a Pulse schedule to assemble into a Qobj
+schedule = pulse.Schedule()
+schedule += pulse.Play(pulse.Waveform([0.1] * 16, name="test0"),
+ pulse.DriveChannel(0),
+ name="test1")
+schedule += pulse.Play(pulse.Waveform([0.1] * 16, name="test1"),
+ pulse.DriveChannel(0),
+ name="test2")
+schedule += pulse.Play(pulse.Waveform([0.5] * 16, name="test0"),
+ pulse.DriveChannel(0),
+ name="test1")
+# Assemble a Qobj from the schedule.
+pulseQobj = assemble_schedules(schedules=[schedule],
+ qobj_id="custom-id",
+ qobj_header=header,
+ run_config=config)
+```
+
+## Disassembler
+
+### disassemble
+
+
+
+`qiskit.assembler.disassemble(qobj)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/assembler/disassemble.py "view source code")
+
+Disassemble a qobj and return the circuits or pulse schedules, run\_config, and user header.
+
+
+ `disassemble(assemble(qc))` is not guaranteed to produce an exactly equal circuit to the input, due to limitations in the [`QasmQobj`](qiskit.qobj.QasmQobj "qiskit.qobj.QasmQobj") format that need to be maintained for backend system compatibility. This is most likely to be the case when using newer features of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"). In most cases, the output should be equivalent, if not quite equal.
+
+
+**Parameters**
+
+**qobj** (*Qobj*) – The input qobj object to disassemble
+
+**Returns**
+
+The disassembled program which consists of:
+
+> * programs: A list of quantum circuits or pulse schedules
+> * run\_config: The dict of the run config
+> * user\_qobj\_header: The dict of any user headers in the qobj
+
+**Return type**
+
+Union\[CircuitModule, PulseModule]
+
+**Examples**
+
+```python
+from qiskit.circuit import QuantumRegister, ClassicalRegister, QuantumCircuit
+from qiskit.compiler.assembler import assemble
+from qiskit.assembler.disassemble import disassemble
+# Create a circuit to assemble into a qobj
+q = QuantumRegister(2)
+c = ClassicalRegister(2)
+qc = QuantumCircuit(q, c)
+qc.h(q[0])
+qc.cx(q[0], q[1])
+qc.measure(q, c)
+# Assemble the circuit into a Qobj
+qobj = assemble(qc, shots=2000, memory=True)
+# Disassemble the qobj back into a circuit
+circuits, run_config_out, headers = disassemble(qobj)
+```
+
+## RunConfig
+
+| | |
+| -------------------------------------------------------------------------------------------------------------- | ---------------------------- |
+| [`RunConfig`](qiskit.assembler.RunConfig "qiskit.assembler.RunConfig")(\[shots, seed\_simulator, memory, ...]) | Class for Run Configuration. |
+
diff --git a/docs/api/qiskit/0.46/circuit.md b/docs/api/qiskit/0.46/circuit.md
new file mode 100644
index 00000000000..0f3a54be0dd
--- /dev/null
+++ b/docs/api/qiskit/0.46/circuit.md
@@ -0,0 +1,357 @@
+---
+title: circuit
+description: API reference for qiskit.circuit
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.circuit
+---
+
+
+
+
+
+
+
+# Quantum Circuits
+
+
+
+`qiskit.circuit`
+
+## Overview
+
+The fundamental element of quantum computing is the **quantum circuit**. A quantum circuit is a computational routine consisting of coherent quantum operations on quantum data, such as qubits. It is an ordered sequence of quantum gates, measurements and resets, which may be conditioned on real-time classical computation. A set of quantum gates is said to be universal if any unitary transformation of the quantum data can be efficiently approximated arbitrarily well as a sequence of gates in the set. Any quantum program can be represented by a sequence of quantum circuits and classical near-time computation.
+
+In Qiskit, this core element is represented by the [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") class. Below is an example of a quantum circuit that makes a three-qubit GHZ state defined as:
+
+$$
+|\psi\rangle = \left(|000\rangle+|111\rangle\right)/\sqrt{2}
+$$
+
+```python
+from qiskit import QuantumCircuit
+# Create a circuit with a register of three qubits
+circ = QuantumCircuit(3)
+# H gate on qubit 0, putting this qubit in a superposition of |0> + |1>.
+circ.h(0)
+# A CX (CNOT) gate on control qubit 0 and target qubit 1 generating a Bell state.
+circ.cx(0, 1)
+# CX (CNOT) gate on control qubit 0 and target qubit 2 resulting in a GHZ state.
+circ.cx(0, 2)
+# Draw the circuit
+circ.draw('mpl')
+```
+
+
+
+## Supplementary Information
+
+### Quantum Circuit with conditionals
+
+When building a quantum circuit, there can be interest in applying a certain gate only if a classical register has a specific value. This can be done with the [`InstructionSet.c_if()`](qiskit.circuit.InstructionSet#c_if "qiskit.circuit.InstructionSet.c_if") method.
+
+In the following example, we start with a single-qubit circuit formed by only a Hadamard gate ([`HGate`](qiskit.circuit.library.HGate "qiskit.circuit.library.HGate")), in which we expect to get $|0\rangle$ and $|1\rangle$ with equal probability.
+
+```python
+from qiskit import transpile, QuantumRegister, ClassicalRegister, QuantumCircuit
+qr = QuantumRegister(1)
+cr = ClassicalRegister(1)
+qc = QuantumCircuit(qr, cr)
+qc.h(0)
+qc.measure(0, 0)
+qc.draw('mpl')
+```
+
+
+
+```python
+from qiskit.providers.basic_provider import BasicSimulator
+backend = BasicSimulator()
+tqc = transpile(qc, backend)
+counts = backend.run(tqc).result().get_counts()
+
+print(counts)
+```
+
+```python
+{'0': 524, '1': 500}
+```
+
+Now, we add an [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.library.XGate") only if the value of the [`ClassicalRegister`](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister") is 0. That way, if the state is $|0\rangle$, it will be changed to $|1\rangle$ and if the state is $|1\rangle$, it will not be changed at all, so the final state will always be $|1\rangle$.
+
+```python
+from qiskit import transpile, QuantumRegister, ClassicalRegister, QuantumCircuit
+
+qr = QuantumRegister(1)
+cr = ClassicalRegister(1)
+qc = QuantumCircuit(qr, cr)
+qc.h(0)
+qc.measure(0, 0)
+
+qc.x(0).c_if(cr, 0)
+qc.measure(0, 0)
+
+qc.draw('mpl')
+```
+
+
+
+```python
+from qiskit.providers.basic_provider import BasicSimulator
+backend = BasicSimulator()
+tqc = transpile(qc, backend)
+counts = backend.run(tqc).result().get_counts()
+
+print(counts)
+```
+
+```python
+{'1': 1024}
+```
+
+### Quantum Circuit Properties
+
+When constructing quantum circuits, there are several properties that help quantify the “size” of the circuits, and their ability to be run on a noisy quantum device. Some of these, like number of qubits, are straightforward to understand, while others like depth and number of tensor components require a bit more explanation. Here we will explain all of these properties, and, in preparation for understanding how circuits change when run on actual devices, highlight the conditions under which they change.
+
+Consider the following circuit:
+
+```python
+from qiskit import QuantumCircuit
+qc = QuantumCircuit(12)
+for idx in range(5):
+ qc.h(idx)
+ qc.cx(idx, idx+5)
+
+qc.cx(1, 7)
+qc.x(8)
+qc.cx(1, 9)
+qc.x(7)
+qc.cx(1, 11)
+qc.swap(6, 11)
+qc.swap(6, 9)
+qc.swap(6, 10)
+qc.x(6)
+qc.draw('mpl')
+```
+
+
+
+From the plot, it is easy to see that this circuit has 12 qubits, and a collection of Hadamard, CNOT, X, and SWAP gates. But how to quantify this programmatically? Because we can do single-qubit gates on all the qubits simultaneously, the number of qubits in this circuit is equal to the **width** of the circuit:
+
+```python
+qc.width()
+```
+
+```python
+12
+```
+
+We can also just get the number of qubits directly:
+
+```python
+qc.num_qubits
+```
+
+```python
+12
+```
+
+
+ For a quantum circuit composed from just qubits, the circuit width is equal to the number of qubits. This is the definition used in quantum computing. However, for more complicated circuits with classical registers, and classically controlled gates, this equivalence breaks down. As such, from now on we will not refer to the number of qubits in a quantum circuit as the width.
+
+
+It is also straightforward to get the number and type of the gates in a circuit using [`QuantumCircuit.count_ops()`](qiskit.circuit.QuantumCircuit#count_ops "qiskit.circuit.QuantumCircuit.count_ops"):
+
+```python
+qc.count_ops()
+```
+
+```python
+OrderedDict([('cx', 8), ('h', 5), ('x', 3), ('swap', 3)])
+```
+
+We can also get just the raw count of operations by computing the circuits [`QuantumCircuit.size()`](qiskit.circuit.QuantumCircuit#size "qiskit.circuit.QuantumCircuit.size"):
+
+```python
+qc.size()
+```
+
+```python
+19
+```
+
+A particularly important circuit property is known as the circuit **depth**. The depth of a quantum circuit is a measure of how many “layers” of quantum gates, executed in parallel, it takes to complete the computation defined by the circuit. Because quantum gates take time to implement, the depth of a circuit roughly corresponds to the amount of time it takes the quantum computer to execute the circuit. Thus, the depth of a circuit is one important quantity used to measure if a quantum circuit can be run on a device.
+
+The depth of a quantum circuit has a mathematical definition as the longest path in a directed acyclic graph (DAG). However, such a definition is a bit hard to grasp, even for experts. Fortunately, the depth of a circuit can be easily understood by anyone familiar with playing [Tetris](https://en.wikipedia.org/wiki/Tetris). Lets see how to compute this graphically:
+
+
+
+We can verify our graphical result using [`QuantumCircuit.depth()`](qiskit.circuit.QuantumCircuit#depth "qiskit.circuit.QuantumCircuit.depth"):
+
+```python
+qc.depth()
+```
+
+```python
+9
+```
+
+## Quantum Circuit API
+
+### Quantum Circuit Construction
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")(\*regs\[, name, global\_phase, ...]) | Create a new circuit. |
+| [`QuantumRegister`](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister")(\[size, name, bits]) | Implement a quantum register. |
+| [`Qubit`](qiskit.circuit.Qubit "qiskit.circuit.Qubit")(\[register, index]) | Implement a quantum bit. |
+| [`ClassicalRegister`](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister")(\[size, name, bits]) | Implement a classical register. |
+| [`Clbit`](qiskit.circuit.Clbit "qiskit.circuit.Clbit")(\[register, index]) | Implement a classical bit. |
+| [`AncillaRegister`](qiskit.circuit.AncillaRegister "qiskit.circuit.AncillaRegister")(\[size, name, bits]) | Implement an ancilla register. |
+| [`AncillaQubit`](qiskit.circuit.AncillaQubit "qiskit.circuit.AncillaQubit")(\[register, index]) | A qubit used as ancillary qubit. |
+| [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")(operation\[, qubits, clbits]) | A single instruction in a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), comprised of the `operation` and various operands. |
+| [`Register`](qiskit.circuit.Register "qiskit.circuit.Register")(\[size, name, bits]) | Implement a generic register. |
+| [`Bit`](qiskit.circuit.Bit "qiskit.circuit.Bit")(\[register, index]) | Implement a generic bit. |
+
+### Gates and Instructions
+
+| | |
+| -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
+| [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate")(name, num\_qubits, params\[, label, ...]) | Unitary gate. |
+| [`ControlledGate`](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")(name, num\_qubits, params\[, ...]) | Controlled unitary gate. |
+| [`Delay`](qiskit.circuit.Delay "qiskit.circuit.Delay")(duration\[, unit]) | Do nothing and just delay/wait/idle for a specified duration. |
+| [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction")(name, num\_qubits, num\_clbits, params) | Generic quantum instruction. |
+| [`InstructionSet`](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")(\*\[, resource\_requester]) | Instruction collection, and their contexts. |
+| [`Operation`](qiskit.circuit.Operation "qiskit.circuit.Operation")() | Quantum Operation Interface Class. |
+| [`EquivalenceLibrary`](qiskit.circuit.EquivalenceLibrary "qiskit.circuit.EquivalenceLibrary")(\*\[, base]) | A library providing a one-way mapping of Gates to their equivalent implementations as QuantumCircuits. |
+
+### Control Flow Operations
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`ControlFlowOp`](qiskit.circuit.ControlFlowOp "qiskit.circuit.ControlFlowOp")(name, num\_qubits, num\_clbits, ...) | Abstract class to encapsulate all control flow operations. |
+| [`IfElseOp`](qiskit.circuit.IfElseOp "qiskit.circuit.IfElseOp")(condition, true\_body\[, false\_body, ...]) | A circuit operation which executes a program (`true_body`) if a provided condition (`condition`) evaluates to true, and optionally evaluates another program (`false_body`) otherwise. |
+| [`WhileLoopOp`](qiskit.circuit.WhileLoopOp "qiskit.circuit.WhileLoopOp")(condition, body\[, label]) | A circuit operation which repeatedly executes a subcircuit (`body`) until a condition (`condition`) evaluates as False. |
+| [`ForLoopOp`](qiskit.circuit.ForLoopOp "qiskit.circuit.ForLoopOp")(indexset, loop\_parameter, body\[, ...]) | A circuit operation which repeatedly executes a subcircuit (`body`) parameterized by a parameter `loop_parameter` through the set of integer values provided in `indexset`. |
+| [`SwitchCaseOp`](qiskit.circuit.SwitchCaseOp "qiskit.circuit.SwitchCaseOp")(target, cases, \*\[, label]) | A circuit operation that executes one particular circuit block based on matching a given `target` against an ordered list of `values`. |
+| [`BreakLoopOp`](qiskit.circuit.BreakLoopOp "qiskit.circuit.BreakLoopOp")(num\_qubits, num\_clbits\[, label]) | A circuit operation which, when encountered, jumps to the end of the nearest enclosing loop. |
+| [`ContinueLoopOp`](qiskit.circuit.ContinueLoopOp "qiskit.circuit.ContinueLoopOp")(num\_qubits, num\_clbits\[, label]) | A circuit operation which, when encountered, moves to the next iteration of the nearest enclosing loop. |
+
+The [`SwitchCaseOp`](qiskit.circuit.SwitchCaseOp "qiskit.circuit.SwitchCaseOp") also understands a special value:
+
+**qiskit.circuit.CASE\_DEFAULT**
+
+A special object that represents the “default” case of a switch statement. If you use this as a case target, it must be the last case, and will match anything that wasn’t already matched. For example:
+
+```python
+from qiskit import QuantumCircuit, QuantumRegister, ClassicalRegister
+from qiskit.circuit import SwitchCaseOp, CASE_DEFAULT
+
+body0 = QuantumCircuit(2, 2)
+body0.x(0)
+body1 = QuantumCircuit(2, 2)
+body1.z(0)
+body2 = QuantumCircuit(2, 2)
+body2.cx(0, 1)
+
+qr, cr = QuantumRegister(2), ClassicalRegister(2)
+qc = QuantumCircuit(qr, cr)
+qc.switch(cr, [(0, body0), (1, body1), (CASE_DEFAULT, body2)], qr, cr)
+```
+
+When using the builder interface of [`QuantumCircuit.switch()`](qiskit.circuit.QuantumCircuit#switch "qiskit.circuit.QuantumCircuit.switch"), this can also be accessed as the `DEFAULT` attribute of the bound case-builder object, such as:
+
+```python
+from qiskit import QuantumCircuit, QuantumRegister, ClassicalRegister
+
+qr, cr = QuantumRegister(2), ClassicalRegister(2)
+qc = QuantumCircuit(qr, cr)
+with qc.switch(cr) as case:
+ with case(0):
+ qc.x(0)
+ with case(1):
+ qc.z(0)
+ with case(case.DEFAULT):
+ qc.cx(0, 1)
+```
+
+### Parametric Quantum Circuits
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
+| [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter")(name, \*\[, uuid]) | Parameter Class for variable parameters. |
+| [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector")(name\[, length]) | ParameterVector class to quickly generate lists of parameters. |
+| [`ParameterExpression`](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")(symbol\_map, expr) | ParameterExpression class to enable creating expressions of Parameters. |
+
+### Random Circuits
+
+### random\_circuit
+
+
+
+`qiskit.circuit.random.random_circuit(num_qubits, depth, max_operands=4, measure=False, conditional=False, reset=False, seed=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/random/utils.py "view source code")
+
+Generate random circuit of arbitrary size and form.
+
+This function will generate a random circuit by randomly selecting gates from the set of standard gates in `qiskit.circuit.library.standard_gates`. For example:
+
+```python
+from qiskit.circuit.random import random_circuit
+
+circ = random_circuit(2, 2, measure=True)
+circ.draw(output='mpl')
+```
+
+
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of quantum wires
+* **depth** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – layers of operations (i.e. critical path length)
+* **max\_operands** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – maximum qubit operands of each gate (between 1 and 4)
+* **measure** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if True, measure all qubits at the end
+* **conditional** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if True, insert middle measurements and conditionals
+* **reset** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if True, insert middle resets
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – sets random seed (optional)
+
+**Returns**
+
+constructed circuit
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**CircuitError**](#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – when invalid options given
+
+### Circuit Analysis
+
+| | |
+| ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
+| [`CommutationChecker`](qiskit.circuit.CommutationChecker "qiskit.circuit.CommutationChecker")() | This code is essentially copy-pasted from commutative\_analysis.py. |
+
+### Annotated Operations
+
+| | |
+| ----------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| [`AnnotatedOperation`](qiskit.circuit.AnnotatedOperation "qiskit.circuit.AnnotatedOperation")(base\_op, modifiers) | Annotated operation. |
+| [`ControlModifier`](qiskit.circuit.ControlModifier "qiskit.circuit.ControlModifier")(\[num\_ctrl\_qubits, ctrl\_state]) | Control modifier: specifies that the operation is controlled by `num_ctrl_qubits` and has control state `ctrl_state`. |
+| [`PowerModifier`](qiskit.circuit.PowerModifier "qiskit.circuit.PowerModifier")(power) | Power modifier: specifies that the operation is raised to the power `power`. |
+| [`InverseModifier`](qiskit.circuit.InverseModifier "qiskit.circuit.InverseModifier")() | Inverse modifier: specifies that the operation is inverted. |
+
+### Exceptions
+
+Almost all circuit functions and methods will raise a [`CircuitError`](#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") when encountering an error that is particular to usage of Qiskit (as opposed to regular typing or indexing problems, which will typically raise the corresponding standard Python error).
+
+### CircuitError
+
+
+
+`qiskit.circuit.CircuitError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/exceptions.py "view source code")
+
+Base class for errors raised while processing a circuit.
+
+Set the error message.
+
diff --git a/docs/api/qiskit/0.46/circuit_classical.md b/docs/api/qiskit/0.46/circuit_classical.md
new file mode 100644
index 00000000000..844cf16d370
--- /dev/null
+++ b/docs/api/qiskit/0.46/circuit_classical.md
@@ -0,0 +1,974 @@
+---
+title: classical
+description: API reference for qiskit.circuit.classical
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.circuit.classical
+---
+
+
+
+
+
+
+
+# Classical expressions
+
+
+
+`qiskit.circuit.classical`
+
+This module contains an exploratory representation of runtime operations on classical values during circuit execution.
+
+Currently, only simple expressions on bits and registers that result in a Boolean value are supported, and these are only valid for use in the conditions of [`QuantumCircuit.if_test()`](qiskit.circuit.QuantumCircuit#if_test "qiskit.circuit.QuantumCircuit.if_test") ([`IfElseOp`](qiskit.circuit.IfElseOp "qiskit.circuit.IfElseOp")) and [`QuantumCircuit.while_loop()`](qiskit.circuit.QuantumCircuit#while_loop "qiskit.circuit.QuantumCircuit.while_loop") ([`WhileLoopOp`](qiskit.circuit.WhileLoopOp "qiskit.circuit.WhileLoopOp")), and in the target of [`QuantumCircuit.switch()`](qiskit.circuit.QuantumCircuit#switch "qiskit.circuit.QuantumCircuit.switch") ([`SwitchCaseOp`](qiskit.circuit.SwitchCaseOp "qiskit.circuit.SwitchCaseOp")).
+
+
+ This is an exploratory module, and while we will commit to the standard Qiskit deprecation policy within it, please be aware that the module will be deliberately limited in scope at the start, and early versions may not evolve cleanly into the final version. It is possible that various components of this module will be replaced (subject to deprecations) instead of improved into a new form.
+
+ The type system and expression tree will be expanded over time, and it is possible that the allowed types of some operations may need to change between versions of Qiskit as the classical processing capabilities develop.
+
+
+
+
+
+
+## Expressions
+
+
+
+`qiskit.circuit.classical.expr`
+
+The necessary components for building expressions are all exported from the [`expr`](#module-qiskit.circuit.classical.expr "qiskit.circuit.classical.expr") namespace within [`qiskit.circuit.classical`](#module-qiskit.circuit.classical "qiskit.circuit.classical"), so you can choose whether to use qualified access (for example [`expr.Value`](#qiskit.circuit.classical.expr.Value "qiskit.circuit.classical.expr.expr.Value")) or import the names you need directly and call them without the prefix.
+
+There are two pathways for constructing expressions. The classes that form [the representation of the expression system](#circuit-classical-expressions-expr-representation) have constructors that perform zero type checking; it is up to the caller to ensure that they are building valid objects. For a more user-friendly interface to direct construction, there are helper functions associated with most of the classes that do type validation and inference. These are described below, in [Construction](#circuit-classical-expressions-expr-construction).
+
+
+
+### Representation
+
+The expression system is based on tree representation. All nodes in the tree are final (uninheritable) instances of the abstract base class:
+
+
+
+`qiskit.circuit.classical.expr.Expr`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/expr.py "view source code")
+
+Root base class of all nodes in the expression tree. The base case should never be instantiated directly.
+
+This must not be subclassed by users; subclasses form the internal data of the representation of expressions, and it does not make sense to add more outside of Qiskit library code.
+
+All subclasses are responsible for setting their `type` attribute in their `__init__`, and should not call the parent initialiser.
+
+These objects are mutable and should not be reused in a different location without a copy.
+
+The entry point from general circuit objects to the expression system is by wrapping the object in a [`Var`](#qiskit.circuit.classical.expr.Var "qiskit.circuit.classical.expr.Var") node and associating a [`Type`](#qiskit.circuit.classical.types.Type "qiskit.circuit.classical.types.Type") with it.
+
+
+
+`final class qiskit.circuit.classical.expr.Var(var, type)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/expr.py "view source code")
+
+A classical variable.
+
+Similarly, literals used in comparison (such as integers) should be lifted to [`Value`](#qiskit.circuit.classical.expr.Value "qiskit.circuit.classical.expr.Value") nodes with associated types.
+
+
+
+`final class qiskit.circuit.classical.expr.Value(value, type)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/expr.py "view source code")
+
+A single scalar value.
+
+The operations traditionally associated with pre-, post- or infix operators in programming are represented by the [`Unary`](#qiskit.circuit.classical.expr.Unary "qiskit.circuit.classical.expr.Unary") and [`Binary`](#qiskit.circuit.classical.expr.Binary "qiskit.circuit.classical.expr.Binary") nodes as appropriate. These each take an operation type code, which are exposed as enumerations inside each class as [`Unary.Op`](#qiskit.circuit.classical.expr.Unary.Op "qiskit.circuit.classical.expr.Unary.Op") and [`Binary.Op`](#qiskit.circuit.classical.expr.Binary.Op "qiskit.circuit.classical.expr.Binary.Op") respectively.
+
+
+
+`final class qiskit.circuit.classical.expr.Unary(op, operand, type)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/expr.py "view source code")
+
+A unary expression.
+
+**Parameters**
+
+* **op** ([*Unary.Op*](#qiskit.circuit.classical.expr.Unary.Op "qiskit.circuit.classical.expr.Unary.Op")) – The opcode describing which operation is being done.
+* **operand** ([*Expr*](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.Expr")) – The operand of the operation.
+* **type** ([*Type*](#qiskit.circuit.classical.types.Type "qiskit.circuit.classical.types.types.Type")) – The resolved type of the result.
+
+
+
+`Op(value)`
+
+Enumeration of the opcodes for unary operations.
+
+The bitwise negation [`BIT_NOT`](#qiskit.circuit.classical.expr.Unary.Op.BIT_NOT "qiskit.circuit.classical.expr.Unary.Op.BIT_NOT") takes a single bit or an unsigned integer of known width, and returns a value of the same type.
+
+The logical negation [`LOGIC_NOT`](#qiskit.circuit.classical.expr.Unary.Op.LOGIC_NOT "qiskit.circuit.classical.expr.Unary.Op.LOGIC_NOT") takes an input that is implicitly coerced to a Boolean, and returns a Boolean.
+
+
+
+### BIT\_NOT
+
+`= 1`
+
+Bitwise negation. `~operand`.
+
+
+
+### LOGIC\_NOT
+
+`= 2`
+
+Logical negation. `!operand`.
+
+
+
+`final class qiskit.circuit.classical.expr.Binary(op, left, right, type)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/expr.py "view source code")
+
+A binary expression.
+
+**Parameters**
+
+* **op** ([*Binary.Op*](#qiskit.circuit.classical.expr.Binary.Op "qiskit.circuit.classical.expr.Binary.Op")) – The opcode describing which operation is being done.
+* **left** ([*Expr*](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.Expr")) – The left-hand operand.
+* **right** ([*Expr*](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.Expr")) – The right-hand operand.
+* **type** ([*Type*](#qiskit.circuit.classical.types.Type "qiskit.circuit.classical.types.types.Type")) – The resolved type of the result.
+
+
+
+`Op(value)`
+
+Enumeration of the opcodes for binary operations.
+
+The bitwise operations [`BIT_AND`](#qiskit.circuit.classical.expr.Binary.Op.BIT_AND "qiskit.circuit.classical.expr.Binary.Op.BIT_AND"), [`BIT_OR`](#qiskit.circuit.classical.expr.Binary.Op.BIT_OR "qiskit.circuit.classical.expr.Binary.Op.BIT_OR") and [`BIT_XOR`](#qiskit.circuit.classical.expr.Binary.Op.BIT_XOR "qiskit.circuit.classical.expr.Binary.Op.BIT_XOR") apply to two operands of the same type, which must be a single bit or an unsigned integer of fixed width. The resultant type is the same as the two input types.
+
+The logical operations [`LOGIC_AND`](#qiskit.circuit.classical.expr.Binary.Op.LOGIC_AND "qiskit.circuit.classical.expr.Binary.Op.LOGIC_AND") and [`LOGIC_OR`](#qiskit.circuit.classical.expr.Binary.Op.LOGIC_OR "qiskit.circuit.classical.expr.Binary.Op.LOGIC_OR") first implicitly coerce their arguments to Booleans, and then apply the logical operation. The resultant type is always Boolean.
+
+The binary mathematical relations [`EQUAL`](#qiskit.circuit.classical.expr.Binary.Op.EQUAL "qiskit.circuit.classical.expr.Binary.Op.EQUAL"), [`NOT_EQUAL`](#qiskit.circuit.classical.expr.Binary.Op.NOT_EQUAL "qiskit.circuit.classical.expr.Binary.Op.NOT_EQUAL"), [`LESS`](#qiskit.circuit.classical.expr.Binary.Op.LESS "qiskit.circuit.classical.expr.Binary.Op.LESS"), [`LESS_EQUAL`](#qiskit.circuit.classical.expr.Binary.Op.LESS_EQUAL "qiskit.circuit.classical.expr.Binary.Op.LESS_EQUAL"), [`GREATER`](#qiskit.circuit.classical.expr.Binary.Op.GREATER "qiskit.circuit.classical.expr.Binary.Op.GREATER") and [`GREATER_EQUAL`](#qiskit.circuit.classical.expr.Binary.Op.GREATER_EQUAL "qiskit.circuit.classical.expr.Binary.Op.GREATER_EQUAL") take unsigned integers (with an implicit cast to make them the same width), and return a Boolean.
+
+
+
+### BIT\_AND
+
+`= 1`
+
+Bitwise “and”. `lhs & rhs`.
+
+
+
+### BIT\_OR
+
+`= 2`
+
+Bitwise “or”. `lhs | rhs`.
+
+
+
+### BIT\_XOR
+
+`= 3`
+
+Bitwise “exclusive or”. `lhs ^ rhs`.
+
+
+
+### LOGIC\_AND
+
+`= 4`
+
+Logical “and”. `lhs && rhs`.
+
+
+
+### LOGIC\_OR
+
+`= 5`
+
+Logical “or”. `lhs || rhs`.
+
+
+
+### EQUAL
+
+`= 6`
+
+Numeric equality. `lhs == rhs`.
+
+
+
+### NOT\_EQUAL
+
+`= 7`
+
+Numeric inequality. `lhs != rhs`.
+
+
+
+### LESS
+
+`= 8`
+
+Numeric less than. `lhs < rhs`.
+
+
+
+### LESS\_EQUAL
+
+`= 9`
+
+Numeric less than or equal to. `lhs <= rhs`
+
+
+
+### GREATER
+
+`= 10`
+
+Numeric greater than. `lhs > rhs`.
+
+
+
+### GREATER\_EQUAL
+
+`= 11`
+
+Numeric greater than or equal to. `lhs >= rhs`.
+
+When constructing expressions, one must ensure that the types are valid for the operation. Attempts to construct expressions with invalid types will raise a regular Python `TypeError`.
+
+Expressions in this system are defined to act only on certain sets of types. However, values may be cast to a suitable supertype in order to satisfy the typing requirements. In these cases, a node in the expression tree is used to represent the promotion. In all cases where operations note that they “implicitly cast” or “coerce” their arguments, the expression tree must have this node representing the conversion.
+
+
+
+`final class qiskit.circuit.classical.expr.Cast(operand, type, implicit=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/expr.py "view source code")
+
+A cast from one type to another, implied by the use of an expression in a different context.
+
+
+
+### Construction
+
+Constructing the tree representation directly is verbose and easy to make a mistake with the typing. In many cases, much of the typing can be inferred, scalar values can automatically be promoted to [`Value`](#qiskit.circuit.classical.expr.Value "qiskit.circuit.classical.expr.Value") instances, and any required promotions can be resolved into suitable [`Cast`](#qiskit.circuit.classical.expr.Cast "qiskit.circuit.classical.expr.Cast") nodes.
+
+The functions and methods described in this section are a more user-friendly way to build the expression tree, while staying close to the internal representation. All these functions will automatically lift valid Python scalar values into corresponding [`Var`](#qiskit.circuit.classical.expr.Var "qiskit.circuit.classical.expr.Var") or [`Value`](#qiskit.circuit.classical.expr.Value "qiskit.circuit.classical.expr.Value") objects, and will resolve any required implicit casts on your behalf.
+
+### lift
+
+
+
+`qiskit.circuit.classical.expr.lift(value, /, type=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/constructors.py "view source code")
+
+Lift the given Python `value` to a [`Value`](#qiskit.circuit.classical.expr.Value "qiskit.circuit.classical.expr.expr.Value") or [`Var`](#qiskit.circuit.classical.expr.Var "qiskit.circuit.classical.expr.expr.Var").
+
+If an explicit `type` is given, the typing in the output will reflect that.
+
+**Examples**
+
+Lifting simple circuit objects to be [`Var`](#qiskit.circuit.classical.expr.Var "qiskit.circuit.classical.expr.expr.Var") instances:
+
+```python
+>>> from qiskit.circuit import Clbit, ClassicalRegister
+>>> from qiskit.circuit.classical import expr
+>>> expr.lift(Clbit())
+Var(, Bool())
+>>> expr.lift(ClassicalRegister(3, "c"))
+Var(ClassicalRegister(3, "c"), Uint(3))
+```
+
+The type of the return value can be influenced, if the given value could be interpreted losslessly as the given type (use [`cast()`](#qiskit.circuit.classical.expr.cast "qiskit.circuit.classical.expr.cast") to perform a full set of casting operations, include lossy ones):
+
+```python
+>>> from qiskit.circuit import ClassicalRegister
+>>> from qiskit.circuit.classical import expr, types
+>>> expr.lift(ClassicalRegister(3, "c"), types.Uint(5))
+Var(ClassicalRegister(3, "c"), Uint(5))
+>>> expr.lift(5, types.Uint(4))
+Value(5, Uint(4))
+```
+
+**Return type**
+
+[Expr](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.Expr")
+
+You can manually specify casts in cases where the cast is allowed in explicit form, but may be lossy (such as the cast of a higher precision [`Uint`](#qiskit.circuit.classical.types.Uint "qiskit.circuit.classical.types.Uint") to a lower precision one).
+
+### cast
+
+
+
+`qiskit.circuit.classical.expr.cast(operand, type, /)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/constructors.py "view source code")
+
+Create an explicit cast from the given value to the given type.
+
+**Examples**
+
+Add an explicit cast node that explicitly casts a higher precision type to a lower precision one:
+
+```python
+>>> from qiskit.circuit.classical import expr, types
+>>> value = expr.value(5, types.Uint(32))
+>>> expr.cast(value, types.Uint(8))
+Cast(Value(5, types.Uint(32)), types.Uint(8), implicit=False)
+```
+
+**Return type**
+
+[*Expr*](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.expr.Expr")
+
+There are helper constructor functions for each of the unary operations.
+
+### bit\_not
+
+
+
+`qiskit.circuit.classical.expr.bit_not(operand, /)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/constructors.py "view source code")
+
+Create a bitwise ‘not’ expression node from the given value, resolving any implicit casts and lifting the value into a [`Value`](#qiskit.circuit.classical.expr.Value "qiskit.circuit.classical.expr.Value") node if required.
+
+**Examples**
+
+Bitwise negation of a [`ClassicalRegister`](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister"):
+
+```python
+>>> from qiskit.circuit import ClassicalRegister
+>>> from qiskit.circuit.classical import expr
+>>> expr.bit_not(ClassicalRegister(3, "c"))
+Unary(Unary.Op.BIT_NOT, Var(ClassicalRegister(3, 'c'), Uint(3)), Uint(3))
+```
+
+**Return type**
+
+[*Expr*](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.expr.Expr")
+
+### logic\_not
+
+
+
+`qiskit.circuit.classical.expr.logic_not(operand, /)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/constructors.py "view source code")
+
+Create a logical ‘not’ expression node from the given value, resolving any implicit casts and lifting the value into a [`Value`](#qiskit.circuit.classical.expr.Value "qiskit.circuit.classical.expr.Value") node if required.
+
+**Examples**
+
+Logical negation of a [`ClassicalRegister`](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister"):
+
+```python
+>>> from qiskit.circuit import ClassicalRegister
+>>> from qiskit.circuit.classical import expr
+>>> expr.logic_not(ClassicalRegister(3, "c"))
+Unary(Unary.Op.LOGIC_NOT, Cast(Var(ClassicalRegister(3, 'c'), Uint(3)), Bool(), implicit=True), Bool())
+```
+
+**Return type**
+
+[*Expr*](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.expr.Expr")
+
+Similarly, the binary operations and relations have helper functions defined.
+
+### bit\_and
+
+
+
+`qiskit.circuit.classical.expr.bit_and(left, right, /)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/constructors.py "view source code")
+
+Create a bitwise ‘and’ expression node from the given value, resolving any implicit casts and lifting the values into [`Value`](#qiskit.circuit.classical.expr.Value "qiskit.circuit.classical.expr.Value") nodes if required.
+
+**Examples**
+
+Bitwise ‘and’ of a classical register and an integer literal:
+
+```python
+>>> from qiskit.circuit import ClassicalRegister
+>>> from qiskit.circuit.classical import expr
+>>> expr.bit_and(ClassicalRegister(3, "c"), 0b111)
+Binary(Binary.Op.BIT_AND, Var(ClassicalRegister(3, 'c'), Uint(3)), Value(7, Uint(3)), Uint(3))
+```
+
+**Return type**
+
+[*Expr*](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.expr.Expr")
+
+### bit\_or
+
+
+
+`qiskit.circuit.classical.expr.bit_or(left, right, /)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/constructors.py "view source code")
+
+Create a bitwise ‘or’ expression node from the given value, resolving any implicit casts and lifting the values into [`Value`](#qiskit.circuit.classical.expr.Value "qiskit.circuit.classical.expr.Value") nodes if required.
+
+**Examples**
+
+Bitwise ‘or’ of a classical register and an integer literal:
+
+```python
+>>> from qiskit.circuit import ClassicalRegister
+>>> from qiskit.circuit.classical import expr
+>>> expr.bit_or(ClassicalRegister(3, "c"), 0b101)
+Binary(Binary.Op.BIT_OR, Var(ClassicalRegister(3, 'c'), Uint(3)), Value(5, Uint(3)), Uint(3))
+```
+
+**Return type**
+
+[*Expr*](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.expr.Expr")
+
+### bit\_xor
+
+
+
+`qiskit.circuit.classical.expr.bit_xor(left, right, /)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/constructors.py "view source code")
+
+Create a bitwise ‘exclusive or’ expression node from the given value, resolving any implicit casts and lifting the values into [`Value`](#qiskit.circuit.classical.expr.Value "qiskit.circuit.classical.expr.Value") nodes if required.
+
+**Examples**
+
+Bitwise ‘exclusive or’ of a classical register and an integer literal:
+
+```python
+>>> from qiskit.circuit import ClassicalRegister
+>>> from qiskit.circuit.classical import expr
+>>> expr.bit_xor(ClassicalRegister(3, "c"), 0b101)
+Binary(Binary.Op.BIT_XOR, Var(ClassicalRegister(3, 'c'), Uint(3)), Value(5, Uint(3)), Uint(3))
+```
+
+**Return type**
+
+[*Expr*](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.expr.Expr")
+
+### logic\_and
+
+
+
+`qiskit.circuit.classical.expr.logic_and(left, right, /)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/constructors.py "view source code")
+
+Create a logical ‘and’ expression node from the given value, resolving any implicit casts and lifting the values into [`Value`](#qiskit.circuit.classical.expr.Value "qiskit.circuit.classical.expr.Value") nodes if required.
+
+**Examples**
+
+Logical ‘and’ of two classical bits:
+
+```python
+>>> from qiskit.circuit import Clbit
+>>> from qiskit.circuit.classical import expr
+>>> expr.logical_and(Clbit(), Clbit())
+Binary(Binary.Op.LOGIC_AND, Var(, Bool()), Var(, Bool()), Bool())
+```
+
+**Return type**
+
+[*Expr*](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.expr.Expr")
+
+### logic\_or
+
+
+
+`qiskit.circuit.classical.expr.logic_or(left, right, /)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/constructors.py "view source code")
+
+Create a logical ‘or’ expression node from the given value, resolving any implicit casts and lifting the values into [`Value`](#qiskit.circuit.classical.expr.Value "qiskit.circuit.classical.expr.Value") nodes if required.
+
+**Examples**
+
+Logical ‘or’ of two classical bits
+
+```python
+>>> from qiskit.circuit import Clbit
+>>> from qiskit.circuit.classical import expr
+>>> expr.logical_and(Clbit(), Clbit())
+Binary(Binary.Op.LOGIC_OR, Var(, Bool()), Var(, Bool()), Bool())
+```
+
+**Return type**
+
+[*Expr*](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.expr.Expr")
+
+### equal
+
+
+
+`qiskit.circuit.classical.expr.equal(left, right, /)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/constructors.py "view source code")
+
+Create an ‘equal’ expression node from the given value, resolving any implicit casts and lifting the values into [`Value`](#qiskit.circuit.classical.expr.Value "qiskit.circuit.classical.expr.Value") nodes if required.
+
+**Examples**
+
+Equality between a classical register and an integer:
+
+```python
+>>> from qiskit.circuit import ClassicalRegister
+>>> from qiskit.circuit.classical import expr
+>>> expr.equal(ClassicalRegister(3, "c"), 7)
+Binary(Binary.Op.EQUAL, Var(ClassicalRegister(3, "c"), Uint(3)), Value(7, Uint(3)), Uint(3))
+```
+
+**Return type**
+
+[*Expr*](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.expr.Expr")
+
+### not\_equal
+
+
+
+`qiskit.circuit.classical.expr.not_equal(left, right, /)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/constructors.py "view source code")
+
+Create a ‘not equal’ expression node from the given value, resolving any implicit casts and lifting the values into [`Value`](#qiskit.circuit.classical.expr.Value "qiskit.circuit.classical.expr.Value") nodes if required.
+
+**Examples**
+
+Inequality between a classical register and an integer:
+
+```python
+>>> from qiskit.circuit import ClassicalRegister
+>>> from qiskit.circuit.classical import expr
+>>> expr.not_equal(ClassicalRegister(3, "c"), 7)
+Binary(Binary.Op.NOT_EQUAL, Var(ClassicalRegister(3, "c"), Uint(3)), Value(7, Uint(3)), Uint(3))
+```
+
+**Return type**
+
+[*Expr*](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.expr.Expr")
+
+### less
+
+
+
+`qiskit.circuit.classical.expr.less(left, right, /)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/constructors.py "view source code")
+
+Create a ‘less than’ expression node from the given value, resolving any implicit casts and lifting the values into [`Value`](#qiskit.circuit.classical.expr.Value "qiskit.circuit.classical.expr.Value") nodes if required.
+
+**Examples**
+
+Query if a classical register is less than an integer:
+
+```python
+>>> from qiskit.circuit import ClassicalRegister
+>>> from qiskit.circuit.classical import expr
+>>> expr.less(ClassicalRegister(3, "c"), 5)
+Binary(Binary.Op.LESS, Var(ClassicalRegister(3, "c"), Uint(3)), Value(5, Uint(3)), Uint(3))
+```
+
+**Return type**
+
+[*Expr*](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.expr.Expr")
+
+### less\_equal
+
+
+
+`qiskit.circuit.classical.expr.less_equal(left, right, /)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/constructors.py "view source code")
+
+Create a ‘less than or equal to’ expression node from the given value, resolving any implicit casts and lifting the values into [`Value`](#qiskit.circuit.classical.expr.Value "qiskit.circuit.classical.expr.Value") nodes if required.
+
+**Examples**
+
+Query if a classical register is less than or equal to another:
+
+```python
+>>> from qiskit.circuit import ClassicalRegister
+>>> from qiskit.circuit.classical import expr
+>>> expr.less(ClassicalRegister(3, "a"), ClassicalRegister(3, "b"))
+Binary(Binary.Op.LESS_EQUAL, Var(ClassicalRegister(3, "a"), Uint(3)), Var(ClassicalRegister(3, "b"), Uint(3)), Uint(3))
+```
+
+**Return type**
+
+[*Expr*](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.expr.Expr")
+
+### greater
+
+
+
+`qiskit.circuit.classical.expr.greater(left, right, /)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/constructors.py "view source code")
+
+Create a ‘greater than’ expression node from the given value, resolving any implicit casts and lifting the values into [`Value`](#qiskit.circuit.classical.expr.Value "qiskit.circuit.classical.expr.Value") nodes if required.
+
+**Examples**
+
+Query if a classical register is greater than an integer:
+
+```python
+>>> from qiskit.circuit import ClassicalRegister
+>>> from qiskit.circuit.classical import expr
+>>> expr.less(ClassicalRegister(3, "c"), 5)
+Binary(Binary.Op.GREATER, Var(ClassicalRegister(3, "c"), Uint(3)), Value(5, Uint(3)), Uint(3))
+```
+
+**Return type**
+
+[*Expr*](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.expr.Expr")
+
+### greater\_equal
+
+
+
+`qiskit.circuit.classical.expr.greater_equal(left, right, /)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/constructors.py "view source code")
+
+Create a ‘greater than or equal to’ expression node from the given value, resolving any implicit casts and lifting the values into [`Value`](#qiskit.circuit.classical.expr.Value "qiskit.circuit.classical.expr.Value") nodes if required.
+
+**Examples**
+
+Query if a classical register is greater than or equal to another:
+
+```python
+>>> from qiskit.circuit import ClassicalRegister
+>>> from qiskit.circuit.classical import expr
+>>> expr.less(ClassicalRegister(3, "a"), ClassicalRegister(3, "b"))
+Binary(Binary.Op.GREATER_EQUAL, Var(ClassicalRegister(3, "a"), Uint(3)), Var(ClassicalRegister(3, "b"), Uint(3)), Uint(3))
+```
+
+**Return type**
+
+[*Expr*](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.expr.Expr")
+
+Qiskit’s legacy method for specifying equality conditions for use in conditionals is to use a two-tuple of a [`Clbit`](qiskit.circuit.Clbit "qiskit.circuit.Clbit") or [`ClassicalRegister`](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister") and an integer. This represents an exact equality condition, and there are no ways to specify any other relations. The helper function [`lift_legacy_condition()`](#qiskit.circuit.classical.expr.lift_legacy_condition "qiskit.circuit.classical.expr.lift_legacy_condition") converts this legacy format into the new expression syntax.
+
+### lift\_legacy\_condition
+
+
+
+`qiskit.circuit.classical.expr.lift_legacy_condition(condition, /)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/constructors.py "view source code")
+
+Lift a legacy two-tuple equality condition into a new-style [`Expr`](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.Expr").
+
+**Examples**
+
+Taking an old-style conditional instruction and getting an [`Expr`](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.Expr") from its condition:
+
+```python
+from qiskit.circuit import ClassicalRegister
+from qiskit.circuit.library import HGate
+from qiskit.circuit.classical import expr
+
+cr = ClassicalRegister(2)
+instr = HGate().c_if(cr, 3)
+
+lifted = expr.lift_legacy_condition(instr.condition)
+```
+
+**Return type**
+
+[Expr](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.Expr")
+
+### Working with the expression tree
+
+A typical consumer of the expression tree wants to recursively walk through the tree, potentially statefully, acting on each node differently depending on its type. This is naturally a double-dispatch problem; the logic of ‘what is to be done’ is likely stateful and users should be free to define their own operations, yet each node defines ‘what is being acted on’. We enable this double dispatch by providing a base visitor class for the expression tree.
+
+
+
+`qiskit.circuit.classical.expr.ExprVisitor`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/visitors.py "view source code")
+
+Base class for visitors to the [`Expr`](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.Expr") tree. Subclasses should override whichever of the `visit_*` methods that they are able to handle, and should be organised such that non-existent methods will never be called.
+
+### visit\_binary
+
+
+
+`visit_binary(node, /)`
+
+**Return type**
+
+*\_T\_co*
+
+### visit\_cast
+
+
+
+`visit_cast(node, /)`
+
+**Return type**
+
+*\_T\_co*
+
+### visit\_generic
+
+
+
+`visit_generic(node, /)`
+
+**Return type**
+
+*\_T\_co*
+
+### visit\_unary
+
+
+
+`visit_unary(node, /)`
+
+**Return type**
+
+*\_T\_co*
+
+### visit\_value
+
+
+
+`visit_value(node, /)`
+
+**Return type**
+
+*\_T\_co*
+
+### visit\_var
+
+
+
+`visit_var(node, /)`
+
+**Return type**
+
+*\_T\_co*
+
+Consumers of the expression tree should subclass the visitor, and override the `visit_*` methods that they wish to handle. Any non-overridden methods will call [`visit_generic()`](#qiskit.circuit.classical.expr.ExprVisitor.visit_generic "qiskit.circuit.classical.expr.ExprVisitor.visit_generic"), which unless overridden will raise a `RuntimeError` to ensure that you are aware if new nodes have been added to the expression tree that you are not yet handling.
+
+For the convenience of simple visitors that only need to inspect the variables in an expression and not the general structure, the iterator method [`iter_vars()`](#qiskit.circuit.classical.expr.iter_vars "qiskit.circuit.classical.expr.iter_vars") is provided.
+
+### iter\_vars
+
+
+
+`qiskit.circuit.classical.expr.iter_vars(node)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/visitors.py "view source code")
+
+Get an iterator over the [`Var`](#qiskit.circuit.classical.expr.Var "qiskit.circuit.classical.expr.expr.Var") nodes referenced at any level in the given [`Expr`](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.expr.Expr").
+
+**Examples**
+
+Print out the name of each [`ClassicalRegister`](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister") encountered:
+
+```python
+from qiskit.circuit import ClassicalRegister
+from qiskit.circuit.classical import expr
+
+cr1 = ClassicalRegister(3, "a")
+cr2 = ClassicalRegister(3, "b")
+
+for node in expr.iter_vars(expr.bit_and(expr.bit_not(cr1), cr2)):
+ if isinstance(node.var, ClassicalRegister):
+ print(node.var.name)
+```
+
+**Return type**
+
+[*Iterator*](https://docs.python.org/3/library/typing.html#typing.Iterator "(in Python v3.12)")\[[*Var*](#qiskit.circuit.classical.expr.Var "qiskit.circuit.classical.expr.expr.Var")]
+
+Two expressions can be compared for direct structural equality by using the built-in Python `==` operator. In general, though, one might want to compare two expressions slightly more semantically, allowing that the [`Var`](#qiskit.circuit.classical.expr.Var "qiskit.circuit.classical.expr.Var") nodes inside them are bound to different memory-location descriptions between two different circuits. In this case, one can use [`structurally_equivalent()`](#qiskit.circuit.classical.expr.structurally_equivalent "qiskit.circuit.classical.expr.structurally_equivalent") with two suitable “key” functions to do the comparison.
+
+### structurally\_equivalent
+
+
+
+`qiskit.circuit.classical.expr.structurally_equivalent(left, right, left_var_key=None, right_var_key=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/expr/visitors.py "view source code")
+
+Do these two expressions have exactly the same tree structure, up to some key function for the [`Var`](#qiskit.circuit.classical.expr.Var "qiskit.circuit.classical.expr.expr.Var") objects?
+
+In other words, are these two expressions the exact same trees, except we compare the `Var.var` fields by calling the appropriate `*_var_key` function on them, and comparing that output for equality. This function does not allow any semantic “equivalences” such as asserting that `a == b` is equivalent to `b == a`; the evaluation order of the operands could, in general, cause such a statement to be false (consider hypothetical `extern` functions that access global state).
+
+There’s no requirements on the key functions, except that their outputs should have general `__eq__` methods. If a key function returns `None`, the variable will be used verbatim instead.
+
+**Parameters**
+
+* **left** ([*expr.Expr*](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.expr.Expr")) – one of the [`Expr`](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.expr.Expr") nodes.
+* **right** ([*expr.Expr*](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.expr.Expr")) – the other [`Expr`](#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.expr.Expr") node.
+* **left\_var\_key** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")*\[\[*[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")*],* [*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")*] | None*) – a callable whose output should be used when comparing `Var.var` attributes. If this argument is `None` or its output is `None` for a given variable in `left`, the variable will be used verbatim.
+* **right\_var\_key** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")*\[\[*[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")*],* [*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")*] | None*) – same as `left_var_key`, but used on the variables in `right` instead.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+**Examples**
+
+Comparing two expressions for structural equivalence, with no remapping of the variables. These are different because the different [`Clbit`](qiskit.circuit.Clbit "qiskit.circuit.Clbit") instances compare differently:
+
+```python
+>>> from qiskit.circuit import Clbit
+>>> from qiskit.circuit.classical import expr
+>>> left_bits = [Clbit(), Clbit()]
+>>> right_bits = [Clbit(), Clbit()]
+>>> left = expr.logic_and(expr.logic_not(left_bits[0]), left_bits[1])
+>>> right = expr.logic_and(expr.logic_not(right_bits[0]), right_bits[1])
+>>> expr.structurally_equivalent(left, right)
+False
+```
+
+Comparing the same two expressions, but this time using mapping functions that associate the bits with simple indices:
+
+```python
+>>> left_key = {var: i for i, var in enumerate(left_bits)}.get
+>>> right_key = {var: i for i, var in enumerate(right_bits)}.get
+>>> expr.structurally_equivalent(left, right, left_key, right_key)
+True
+```
+
+
+
+
+
+## Typing
+
+
+
+`qiskit.circuit.classical.types`
+
+The type system of the expression tree is exposed through this module. This is inherently linked to the expression system in the [`expr`](#module-qiskit.circuit.classical.expr "qiskit.circuit.classical.expr") module, as most expressions can only be understood with the context of the types that they act on.
+
+All types inherit from an abstract base class:
+
+
+
+`qiskit.circuit.classical.types.Type`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/types/types.py "view source code")
+
+Root base class of all nodes in the type tree. The base case should never be instantiated directly.
+
+This must not be subclassed by users; subclasses form the internal data of the representation of expressions, and it does not make sense to add more outside of Qiskit library code.
+
+Types should be considered immutable objects, and you must not mutate them. It is permissible to reuse a [`Type`](#qiskit.circuit.classical.types.Type "qiskit.circuit.classical.types.Type") that you take from another object without copying it, and generally this will be the best approach for performance. [`Type`](#qiskit.circuit.classical.types.Type "qiskit.circuit.classical.types.Type") objects are designed to be small amounts of data, and it’s best to point to the same instance of the data where possible rather than heap-allocating a new version of the same thing. Where possible, the class constructors will return singleton instances to facilitate this.
+
+The two different types available are for Booleans (corresponding to [`Clbit`](qiskit.circuit.Clbit "qiskit.circuit.Clbit") and the literals `True` and `False`), and unsigned integers (corresponding to [`ClassicalRegister`](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister") and Python integers).
+
+
+
+`final class qiskit.circuit.classical.types.Bool`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/types/types.py "view source code")
+
+The Boolean type. This has exactly two values: `True` and `False`.
+
+
+
+`final class qiskit.circuit.classical.types.Uint(width)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/types/types.py "view source code")
+
+An unsigned integer of fixed bit width.
+
+Note that [`Uint`](#qiskit.circuit.classical.types.Uint "qiskit.circuit.classical.types.Uint") defines a family of types parametrised by their width; it is not one single type, which may be slightly different to the ‘classical’ programming languages you are used to.
+
+There are some functions on these types exposed here as well. These are mostly expected to be used only in manipulations of the expression tree; users who are building expressions using the [user-facing construction interface](#circuit-classical-expressions-expr-construction) should not need to use these.
+
+The type system is equipped with a partial ordering, where $a < b$ is interpreted as “$a$ is a strict subtype of $b$”. Note that the partial ordering is a subset of the directed graph that describes the allowed explicit casting operations between types. The partial ordering defines when one type may be lossless directly interpreted as another.
+
+The low-level interface to querying the subtyping relationship is the [`order()`](#qiskit.circuit.classical.types.order "qiskit.circuit.classical.types.order") function.
+
+### order
+
+
+
+`qiskit.circuit.classical.types.order(left, right, /)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/types/ordering.py "view source code")
+
+Get the ordering relationship between the two types as an enumeration value.
+
+**Examples**
+
+Compare two [`Uint`](#qiskit.circuit.classical.types.Uint "qiskit.circuit.classical.types.Uint") types of different widths:
+
+```python
+>>> from qiskit.circuit.classical import types
+>>> types.order(types.Uint(8), types.Uint(16))
+Ordering.LESS
+```
+
+Compare two types that have no ordering between them:
+
+```python
+>>> types.order(types.Uint(8), types.Bool())
+Ordering.NONE
+```
+
+**Return type**
+
+[*Ordering*](#qiskit.circuit.classical.types.Ordering "qiskit.circuit.classical.types.ordering.Ordering")
+
+The return value is an enumeration [`Ordering`](#qiskit.circuit.classical.types.Ordering "qiskit.circuit.classical.types.Ordering") that describes what, if any, subtyping relationship exists between the two types.
+
+
+
+`qiskit.circuit.classical.types.Ordering(value)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/types/ordering.py "view source code")
+
+Enumeration listing the possible relations between two types. Types only have a partial ordering, so it’s possible for two types to have no sub-typing relationship.
+
+Note that the sub-/supertyping relationship is not the same as whether a type can be explicitly cast from one to another.
+
+Some helper methods are then defined in terms of this low-level [`order()`](#qiskit.circuit.classical.types.order "qiskit.circuit.classical.types.order") primitive:
+
+### is\_subtype
+
+
+
+`qiskit.circuit.classical.types.is_subtype(left, right, /, strict=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/types/ordering.py "view source code")
+
+Does the relation $\text{left} \le \text{right}$ hold? If there is no ordering relation between the two types, then this returns `False`. If `strict`, then the equality is also forbidden.
+
+**Examples**
+
+Check if one type is a subclass of another:
+
+```python
+>>> from qiskit.circuit.classical import types
+>>> types.is_subtype(types.Uint(8), types.Uint(16))
+True
+```
+
+Check if one type is a strict subclass of another:
+
+```python
+>>> types.is_subtype(types.Bool(), types.Bool())
+True
+>>> types.is_subtype(types.Bool(), types.Bool(), strict=True)
+False
+```
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### is\_supertype
+
+
+
+`qiskit.circuit.classical.types.is_supertype(left, right, /, strict=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/types/ordering.py "view source code")
+
+Does the relation $\text{left} \ge \text{right}$ hold? If there is no ordering relation between the two types, then this returns `False`. If `strict`, then the equality is also forbidden.
+
+**Examples**
+
+Check if one type is a superclass of another:
+
+```python
+>>> from qiskit.circuit.classical import types
+>>> types.is_supertype(types.Uint(8), types.Uint(16))
+False
+```
+
+Check if one type is a strict superclass of another:
+
+```python
+>>> types.is_supertype(types.Bool(), types.Bool())
+True
+>>> types.is_supertype(types.Bool(), types.Bool(), strict=True)
+False
+```
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### greater
+
+
+
+`qiskit.circuit.classical.types.greater(left, right, /)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classical/types/ordering.py "view source code")
+
+Get the greater of the two types, assuming that there is an ordering relation between them. Technically, this is a slightly restricted version of the concept of the ‘meet’ of the two types in that the return value must be one of the inputs. In practice in the type system there is no concept of a ‘sum’ type, so the ‘meet’ exists if and only if there is an ordering between the two types, and is equal to the greater of the two types.
+
+**Returns**
+
+The greater of the two types.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – if there is no ordering relation between the two types.
+
+**Return type**
+
+[*Type*](#qiskit.circuit.classical.types.Type "qiskit.circuit.classical.types.types.Type")
+
+**Examples**
+
+Find the greater of two [`Uint`](#qiskit.circuit.classical.types.Uint "qiskit.circuit.classical.types.Uint") types:
+
+```python
+>>> from qiskit.circuit.classical import types
+>>> types.greater(types.Uint(8), types.Uint(16))
+types.Uint(16)
+```
+
diff --git a/docs/api/qiskit/0.46/circuit_library.md b/docs/api/qiskit/0.46/circuit_library.md
new file mode 100644
index 00000000000..463777ab094
--- /dev/null
+++ b/docs/api/qiskit/0.46/circuit_library.md
@@ -0,0 +1,1292 @@
+---
+title: library
+description: API reference for qiskit.circuit.library
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.circuit.library
+---
+
+
+
+
+
+
+
+# Circuit Library
+
+
+
+`qiskit.circuit.library`
+
+The circuit library is a collection of well-studied and valuable circuits, directives, and gates. We call them valuable for different reasons, for instance they can serve as building blocks for algorithms or they are circuits that we think are hard to simulate classically.
+
+Each element can be plugged into a circuit using the [`QuantumCircuit.append()`](qiskit.circuit.QuantumCircuit#append "qiskit.circuit.QuantumCircuit.append") method and so the circuit library allows users to program at higher levels of abstraction. For example, to append a multi-controlled CNOT:
+
+```python
+from qiskit.circuit.library import MCXGate
+gate = MCXGate(4)
+
+from qiskit import QuantumCircuit
+circuit = QuantumCircuit(5)
+circuit.append(gate, [0, 1, 4, 2, 3])
+circuit.draw('mpl')
+```
+
+
+
+The library is organized in several sections.
+
+## Standard gates
+
+These operations are reversible unitary gates and they all subclass [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate"). As a consequence, they all have the methods [`to_matrix()`](qiskit.circuit.Gate#to_matrix "qiskit.circuit.Gate.to_matrix"), [`power()`](qiskit.circuit.Gate#power "qiskit.circuit.Gate.power"), and [`control()`](qiskit.circuit.Gate#control "qiskit.circuit.Gate.control"), which we can generally only apply to unitary operations.
+
+For example:
+
+```python
+from qiskit.circuit.library import XGate
+gate = XGate()
+print(gate.to_matrix()) # X gate
+print(gate.power(1/2).to_matrix()) # √X gate
+print(gate.control(1).to_matrix()) # CX (controlled X) gate
+```
+
+```python
+[[0.+0.j 1.+0.j]
+ [1.+0.j 0.+0.j]]
+[[0.5+0.5j 0.5-0.5j]
+ [0.5-0.5j 0.5+0.5j]]
+[[1.+0.j 0.+0.j 0.+0.j 0.+0.j]
+ [0.+0.j 0.+0.j 0.+0.j 1.+0.j]
+ [0.+0.j 0.+0.j 1.+0.j 0.+0.j]
+ [0.+0.j 1.+0.j 0.+0.j 0.+0.j]]
+```
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
+| [`C3XGate`](qiskit.circuit.library.C3XGate "qiskit.circuit.library.C3XGate")(\*args\[, \_force\_mutable]) | The X gate controlled on 3 qubits. |
+| [`C3SXGate`](qiskit.circuit.library.C3SXGate "qiskit.circuit.library.C3SXGate")(\*args\[, \_force\_mutable]) | The 3-qubit controlled sqrt-X gate. |
+| [`C4XGate`](qiskit.circuit.library.C4XGate "qiskit.circuit.library.C4XGate")(\*args\[, \_force\_mutable]) | The 4-qubit controlled X gate. |
+| [`CCXGate`](qiskit.circuit.library.CCXGate "qiskit.circuit.library.CCXGate")(\*args\[, \_force\_mutable]) | CCX gate, also known as Toffoli gate. |
+| [`DCXGate`](qiskit.circuit.library.DCXGate "qiskit.circuit.library.DCXGate")(\*args\[, \_force\_mutable]) | Double-CNOT gate. |
+| [`CHGate`](qiskit.circuit.library.CHGate "qiskit.circuit.library.CHGate")(\*args\[, \_force\_mutable]) | Controlled-Hadamard gate. |
+| [`CPhaseGate`](qiskit.circuit.library.CPhaseGate "qiskit.circuit.library.CPhaseGate")(theta\[, label, ctrl\_state, ...]) | Controlled-Phase gate. |
+| [`CRXGate`](qiskit.circuit.library.CRXGate "qiskit.circuit.library.CRXGate")(theta\[, label, ctrl\_state, ...]) | Controlled-RX gate. |
+| [`CRYGate`](qiskit.circuit.library.CRYGate "qiskit.circuit.library.CRYGate")(theta\[, label, ctrl\_state, ...]) | Controlled-RY gate. |
+| [`CRZGate`](qiskit.circuit.library.CRZGate "qiskit.circuit.library.CRZGate")(theta\[, label, ctrl\_state, ...]) | Controlled-RZ gate. |
+| [`CSGate`](qiskit.circuit.library.CSGate "qiskit.circuit.library.CSGate")(\*args\[, \_force\_mutable]) | Controlled-S gate. |
+| [`CSdgGate`](qiskit.circuit.library.CSdgGate "qiskit.circuit.library.CSdgGate")(\*args\[, \_force\_mutable]) | Controlled-S^dagger gate. |
+| [`CSwapGate`](qiskit.circuit.library.CSwapGate "qiskit.circuit.library.CSwapGate")(\*args\[, \_force\_mutable]) | Controlled-SWAP gate, also known as the Fredkin gate. |
+| [`CSXGate`](qiskit.circuit.library.CSXGate "qiskit.circuit.library.CSXGate")(\*args\[, \_force\_mutable]) | Controlled-√X gate. |
+| [`CUGate`](qiskit.circuit.library.CUGate "qiskit.circuit.library.CUGate")(theta, phi, lam, gamma\[, label, ...]) | Controlled-U gate (4-parameter two-qubit gate). |
+| [`CU1Gate`](qiskit.circuit.library.CU1Gate "qiskit.circuit.library.CU1Gate")(theta\[, label, ctrl\_state, ...]) | Controlled-U1 gate. |
+| [`CU3Gate`](qiskit.circuit.library.CU3Gate "qiskit.circuit.library.CU3Gate")(theta, phi, lam\[, label, ...]) | Controlled-U3 gate (3-parameter two-qubit gate). |
+| [`CXGate`](qiskit.circuit.library.CXGate "qiskit.circuit.library.CXGate")(\*args\[, \_force\_mutable]) | Controlled-X gate. |
+| [`CYGate`](qiskit.circuit.library.CYGate "qiskit.circuit.library.CYGate")(\*args\[, \_force\_mutable]) | Controlled-Y gate. |
+| [`CZGate`](qiskit.circuit.library.CZGate "qiskit.circuit.library.CZGate")(\*args\[, \_force\_mutable]) | Controlled-Z gate. |
+| [`CCZGate`](qiskit.circuit.library.CCZGate "qiskit.circuit.library.CCZGate")(\*args\[, \_force\_mutable]) | CCZ gate. |
+| [`ECRGate`](qiskit.circuit.library.ECRGate "qiskit.circuit.library.ECRGate")(\*args\[, \_force\_mutable]) | An echoed cross-resonance gate. |
+| [`HGate`](qiskit.circuit.library.HGate "qiskit.circuit.library.HGate")(\*args\[, \_force\_mutable]) | Single-qubit Hadamard gate. |
+| [`IGate`](qiskit.circuit.library.IGate "qiskit.circuit.library.IGate")(\*args\[, \_force\_mutable]) | Identity gate. |
+| [`MSGate`](qiskit.circuit.library.MSGate "qiskit.circuit.library.MSGate")(num\_qubits, theta\[, label]) | MSGate has been deprecated. |
+| [`PhaseGate`](qiskit.circuit.library.PhaseGate "qiskit.circuit.library.PhaseGate")(theta\[, label, duration, unit]) | Single-qubit rotation about the Z axis. |
+| [`RCCXGate`](qiskit.circuit.library.RCCXGate "qiskit.circuit.library.RCCXGate")(\*args\[, \_force\_mutable]) | The simplified Toffoli gate, also referred to as Margolus gate. |
+| [`RC3XGate`](qiskit.circuit.library.RC3XGate "qiskit.circuit.library.RC3XGate")(\*args\[, \_force\_mutable]) | The simplified 3-controlled Toffoli gate. |
+| [`RGate`](qiskit.circuit.library.RGate "qiskit.circuit.library.RGate")(theta, phi\[, label, duration, unit]) | Rotation θ around the cos(φ)x + sin(φ)y axis. |
+| [`RXGate`](qiskit.circuit.library.RXGate "qiskit.circuit.library.RXGate")(theta\[, label, duration, unit]) | Single-qubit rotation about the X axis. |
+| [`RXXGate`](qiskit.circuit.library.RXXGate "qiskit.circuit.library.RXXGate")(theta\[, label, duration, unit]) | A parametric 2-qubit $X \otimes X$ interaction (rotation about XX). |
+| [`RYGate`](qiskit.circuit.library.RYGate "qiskit.circuit.library.RYGate")(theta\[, label, duration, unit]) | Single-qubit rotation about the Y axis. |
+| [`RYYGate`](qiskit.circuit.library.RYYGate "qiskit.circuit.library.RYYGate")(theta\[, label, duration, unit]) | A parametric 2-qubit $Y \otimes Y$ interaction (rotation about YY). |
+| [`RZGate`](qiskit.circuit.library.RZGate "qiskit.circuit.library.RZGate")(phi\[, label, duration, unit]) | Single-qubit rotation about the Z axis. |
+| [`RZZGate`](qiskit.circuit.library.RZZGate "qiskit.circuit.library.RZZGate")(theta\[, label, duration, unit]) | A parametric 2-qubit $Z \otimes Z$ interaction (rotation about ZZ). |
+| [`RZXGate`](qiskit.circuit.library.RZXGate "qiskit.circuit.library.RZXGate")(theta\[, label, duration, unit]) | A parametric 2-qubit $Z \otimes X$ interaction (rotation about ZX). |
+| [`XXMinusYYGate`](qiskit.circuit.library.XXMinusYYGate "qiskit.circuit.library.XXMinusYYGate")(theta\[, beta, label, ...]) | XX-YY interaction gate. |
+| [`XXPlusYYGate`](qiskit.circuit.library.XXPlusYYGate "qiskit.circuit.library.XXPlusYYGate")(theta\[, beta, label, duration, ...]) | XX+YY interaction gate. |
+| [`SGate`](qiskit.circuit.library.SGate "qiskit.circuit.library.SGate")(\*args\[, \_force\_mutable]) | Single qubit S gate (Z\*\*0.5). |
+| [`SdgGate`](qiskit.circuit.library.SdgGate "qiskit.circuit.library.SdgGate")(\*args\[, \_force\_mutable]) | Single qubit S-adjoint gate (\~Z\*\*0.5). |
+| [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")(\*args\[, \_force\_mutable]) | The SWAP gate. |
+| [`iSwapGate`](qiskit.circuit.library.iSwapGate "qiskit.circuit.library.iSwapGate")(\*args\[, \_force\_mutable]) | iSWAP gate. |
+| [`SXGate`](qiskit.circuit.library.SXGate "qiskit.circuit.library.SXGate")(\*args\[, \_force\_mutable]) | The single-qubit Sqrt(X) gate ($\sqrt{X}$). |
+| [`SXdgGate`](qiskit.circuit.library.SXdgGate "qiskit.circuit.library.SXdgGate")(\*args\[, \_force\_mutable]) | The inverse single-qubit Sqrt(X) gate. |
+| [`TGate`](qiskit.circuit.library.TGate "qiskit.circuit.library.TGate")(\*args\[, \_force\_mutable]) | Single qubit T gate (Z\*\*0.25). |
+| [`TdgGate`](qiskit.circuit.library.TdgGate "qiskit.circuit.library.TdgGate")(\*args\[, \_force\_mutable]) | Single qubit T-adjoint gate (\~Z\*\*0.25). |
+| [`UGate`](qiskit.circuit.library.UGate "qiskit.circuit.library.UGate")(theta, phi, lam\[, label, duration, unit]) | Generic single-qubit rotation gate with 3 Euler angles. |
+| [`U1Gate`](qiskit.circuit.library.U1Gate "qiskit.circuit.library.U1Gate")(theta\[, label, duration, unit]) | Single-qubit rotation about the Z axis. |
+| [`U2Gate`](qiskit.circuit.library.U2Gate "qiskit.circuit.library.U2Gate")(phi, lam\[, label, duration, unit]) | Single-qubit rotation about the X+Z axis. |
+| [`U3Gate`](qiskit.circuit.library.U3Gate "qiskit.circuit.library.U3Gate")(theta, phi, lam\[, label, duration, unit]) | Generic single-qubit rotation gate with 3 Euler angles. |
+| [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.library.XGate")(\*args\[, \_force\_mutable]) | The single-qubit Pauli-X gate ($\sigma_x$). |
+| [`YGate`](qiskit.circuit.library.YGate "qiskit.circuit.library.YGate")(\*args\[, \_force\_mutable]) | The single-qubit Pauli-Y gate ($\sigma_y$). |
+| [`ZGate`](qiskit.circuit.library.ZGate "qiskit.circuit.library.ZGate")(\*args\[, \_force\_mutable]) | The single-qubit Pauli-Z gate ($\sigma_z$). |
+| [`GlobalPhaseGate`](qiskit.circuit.library.GlobalPhaseGate "qiskit.circuit.library.GlobalPhaseGate")(phase\[, label, duration, unit]) | The global phase gate ($e^{i\theta}$). |
+
+## Standard Directives
+
+Directives are operations to the quantum stack that are meant to be interpreted by the backend or the transpiler. In general, the transpiler or backend might optionally ignore them if there is no implementation for them.
+
+| | |
+| --------------------------------------------------------------------------------------------------- | -------------------- |
+| [`Barrier`](qiskit.circuit.library.Barrier "qiskit.circuit.library.Barrier")(num\_qubits\[, label]) | Barrier instruction. |
+
+## Standard Operations
+
+Operations are non-reversible changes in the quantum state of the circuit.
+
+| | |
+| ------------------------------------------------------------------------------------------------------ | ----------------------------------------------- |
+| [`Measure`](qiskit.circuit.library.Measure "qiskit.circuit.library.Measure")(\[label, duration, unit]) | Quantum measurement in the computational basis. |
+| [`Reset`](qiskit.circuit.library.Reset "qiskit.circuit.library.Reset")(\[label, duration, unit]) | Qubit reset. |
+
+## Generalized Gates
+
+These “gates” (many are [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") subclasses) allow to set the amount of qubits involved at instantiation time.
+
+```python
+from qiskit.circuit.library import Diagonal
+
+diagonal = Diagonal([1, 1])
+print(diagonal.num_qubits)
+
+diagonal = Diagonal([1, 1, 1, 1])
+print(diagonal.num_qubits)
+```
+
+```python
+1
+2
+```
+
+| | | | |
+| ------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | - | ----------------------------------- |
+| [`Diagonal`](qiskit.circuit.library.Diagonal "qiskit.circuit.library.Diagonal")(diag) | Diagonal circuit. | | |
+| [`DiagonalGate`](qiskit.circuit.library.DiagonalGate "qiskit.circuit.library.DiagonalGate")(diag) | Gate implementing a diagonal transformation. | | |
+| [`MCMT`](qiskit.circuit.library.MCMT "qiskit.circuit.library.MCMT")(gate, num\_ctrl\_qubits, num\_target\_qubits) | The multi-controlled multi-target gate, for an arbitrary singly controlled target gate. | | |
+| [`MCMTVChain`](qiskit.circuit.library.MCMTVChain "qiskit.circuit.library.MCMTVChain")(gate, num\_ctrl\_qubits, ...) | The MCMT implementation using the CCX V-chain. | | |
+| [`Permutation`](qiskit.circuit.library.Permutation "qiskit.circuit.library.Permutation")(num\_qubits\[, pattern, seed]) | An n\_qubit circuit that permutes qubits. | | |
+| [`PermutationGate`](qiskit.circuit.library.PermutationGate "qiskit.circuit.library.PermutationGate")(pattern) | A gate that permutes qubits. | | |
+| [`GMS`](qiskit.circuit.library.GMS "qiskit.circuit.library.GMS")(num\_qubits, theta) | Global Mølmer–Sørensen gate. | | |
+| [`GR`](qiskit.circuit.library.GR "qiskit.circuit.library.GR")(num\_qubits, theta, phi) | Global R gate. | | |
+| [`GRX`](qiskit.circuit.library.GRX "qiskit.circuit.library.GRX")(num\_qubits, theta) | Global RX gate. | | |
+| [`GRY`](qiskit.circuit.library.GRY "qiskit.circuit.library.GRY")(num\_qubits, theta) | Global RY gate. | | |
+| [`GRZ`](qiskit.circuit.library.GRZ "qiskit.circuit.library.GRZ")(num\_qubits, phi) | Global RZ gate. | | |
+| [`MCPhaseGate`](qiskit.circuit.library.MCPhaseGate "qiskit.circuit.library.MCPhaseGate")(lam, num\_ctrl\_qubits\[, label, ...]) | Multi-controlled-Phase gate. | | |
+| [`MCXGate`](qiskit.circuit.library.MCXGate "qiskit.circuit.library.MCXGate")(\[num\_ctrl\_qubits, label, ...]) | The general, multi-controlled X gate. | | |
+| [`MCXGrayCode`](qiskit.circuit.library.MCXGrayCode "qiskit.circuit.library.MCXGrayCode")(\[num\_ctrl\_qubits, label, ...]) | Implement the multi-controlled X gate using the Gray code. | | |
+| [`MCXRecursive`](qiskit.circuit.library.MCXRecursive "qiskit.circuit.library.MCXRecursive")(\[num\_ctrl\_qubits, label, ...]) | Implement the multi-controlled X gate using recursion. | | |
+| [`MCXVChain`](qiskit.circuit.library.MCXVChain "qiskit.circuit.library.MCXVChain")(\[num\_ctrl\_qubits, dirty\_ancillas, ...]) | Implement the multi-controlled X gate using a V-chain of CX gates. | | |
+| [`RVGate`](qiskit.circuit.library.RVGate "qiskit.circuit.library.RVGate")(v\_x, v\_y, v\_z\[, basis]) | Rotation around arbitrary rotation axis $v$ where \$ | v | \$ is angle of rotation in radians. |
+| [`PauliGate`](qiskit.circuit.library.PauliGate "qiskit.circuit.library.PauliGate")(label) | A multi-qubit Pauli gate. | | |
+| [`LinearFunction`](qiskit.circuit.library.LinearFunction "qiskit.circuit.library.LinearFunction")(linear\[, validate\_input]) | A linear reversible circuit on n qubits. | | |
+| [`Isometry`](qiskit.circuit.library.Isometry "qiskit.circuit.library.Isometry")(isometry, num\_ancillas\_zero, ...\[, ...]) | Decomposition of arbitrary isometries from $m$ to $n$ qubits. | | |
+| [`UnitaryGate`](qiskit.circuit.library.UnitaryGate "qiskit.circuit.library.UnitaryGate")(data\[, label, check\_input]) | Class quantum gates specified by a unitary matrix. | | |
+| [`UCGate`](qiskit.circuit.library.UCGate "qiskit.circuit.library.UCGate")(gate\_list\[, up\_to\_diagonal]) | Uniformly controlled gate (also called multiplexed gate). | | |
+| [`UCPauliRotGate`](qiskit.circuit.library.UCPauliRotGate "qiskit.circuit.library.UCPauliRotGate")(angle\_list, rot\_axis) | Uniformly controlled Pauli rotations. | | |
+| [`UCRXGate`](qiskit.circuit.library.UCRXGate "qiskit.circuit.library.UCRXGate")(angle\_list) | Uniformly controlled Pauli-X rotations. | | |
+| [`UCRYGate`](qiskit.circuit.library.UCRYGate "qiskit.circuit.library.UCRYGate")(angle\_list) | Uniformly controlled Pauli-Y rotations. | | |
+| [`UCRZGate`](qiskit.circuit.library.UCRZGate "qiskit.circuit.library.UCRZGate")(angle\_list) | Uniformly controlled Pauli-Z rotations. | | |
+
+## Boolean Logic Circuits
+
+These are [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") subclasses that implement boolean logic operations, such as the logical or of a set of qubit states.
+
+| | |
+| ------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |
+| [`AND`](qiskit.circuit.library.AND "qiskit.circuit.library.AND")(num\_variable\_qubits\[, flags, mcx\_mode]) | A circuit implementing the logical AND operation on a number of qubits. |
+| [`OR`](qiskit.circuit.library.OR "qiskit.circuit.library.OR")(num\_variable\_qubits\[, flags, mcx\_mode]) | A circuit implementing the logical OR operation on a number of qubits. |
+| [`XOR`](qiskit.circuit.library.XOR "qiskit.circuit.library.XOR")(num\_qubits\[, amount, seed]) | An n\_qubit circuit for bitwise xor-ing the input with some integer `amount`. |
+| [`InnerProduct`](qiskit.circuit.library.InnerProduct "qiskit.circuit.library.InnerProduct")(num\_qubits) | A 2n-qubit Boolean function that computes the inner product of two n-qubit vectors over $F_2$. |
+
+## Basis Change Circuits
+
+These circuits allow basis transformations of the qubit states. For example, in the case of the Quantum Fourier Transform (QFT), it transforms between the computational basis and the Fourier basis.
+
+| | |
+| ------------------------------------------------------------------------------------------------------------ | ---------------------------------- |
+| [`QFT`](qiskit.circuit.library.QFT "qiskit.circuit.library.QFT")(\[num\_qubits, approximation\_degree, ...]) | Quantum Fourier Transform Circuit. |
+
+## Arithmetic Circuits
+
+These [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")s perform classical arithmetic, such as addition or multiplication.
+
+### Amplitude Functions
+
+| | |
+| ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
+| [`LinearAmplitudeFunction`](qiskit.circuit.library.LinearAmplitudeFunction "qiskit.circuit.library.LinearAmplitudeFunction")(num\_state\_qubits, ...) | A circuit implementing a (piecewise) linear function on qubit amplitudes. |
+
+### Functional Pauli Rotations
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------- |
+| [`FunctionalPauliRotations`](qiskit.circuit.library.FunctionalPauliRotations "qiskit.circuit.library.FunctionalPauliRotations")(\[num\_state\_qubits, ...]) | Base class for functional Pauli rotations. |
+| [`LinearPauliRotations`](qiskit.circuit.library.LinearPauliRotations "qiskit.circuit.library.LinearPauliRotations")(\[num\_state\_qubits, ...]) | Linearly-controlled X, Y or Z rotation. |
+| [`PolynomialPauliRotations`](qiskit.circuit.library.PolynomialPauliRotations "qiskit.circuit.library.PolynomialPauliRotations")(\[num\_state\_qubits, ...]) | A circuit implementing polynomial Pauli rotations. |
+| [`PiecewiseLinearPauliRotations`](qiskit.circuit.library.PiecewiseLinearPauliRotations "qiskit.circuit.library.PiecewiseLinearPauliRotations")(\[...]) | Piecewise-linearly-controlled Pauli rotations. |
+| [`PiecewisePolynomialPauliRotations`](qiskit.circuit.library.PiecewisePolynomialPauliRotations "qiskit.circuit.library.PiecewisePolynomialPauliRotations")(\[...]) | Piecewise-polynomially-controlled Pauli rotations. |
+| [`PiecewiseChebyshev`](qiskit.circuit.library.PiecewiseChebyshev "qiskit.circuit.library.PiecewiseChebyshev")(f\_x\[, degree, ...]) | Piecewise Chebyshev approximation to an input function. |
+
+### Adders
+
+| | |
+| ----------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
+| [`DraperQFTAdder`](qiskit.circuit.library.DraperQFTAdder "qiskit.circuit.library.DraperQFTAdder")(num\_state\_qubits\[, kind, name]) | A circuit that uses QFT to perform in-place addition on two qubit registers. |
+| [`CDKMRippleCarryAdder`](qiskit.circuit.library.CDKMRippleCarryAdder "qiskit.circuit.library.CDKMRippleCarryAdder")(num\_state\_qubits\[, ...]) | A ripple-carry circuit to perform in-place addition on two qubit registers. |
+| [`VBERippleCarryAdder`](qiskit.circuit.library.VBERippleCarryAdder "qiskit.circuit.library.VBERippleCarryAdder")(num\_state\_qubits\[, ...]) | The VBE ripple carry adder \[1]. |
+| [`WeightedAdder`](qiskit.circuit.library.WeightedAdder "qiskit.circuit.library.WeightedAdder")(\[num\_state\_qubits, weights, name]) | A circuit to compute the weighted sum of qubit registers. |
+
+### Multipliers
+
+| | |
+| -------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
+| [`HRSCumulativeMultiplier`](qiskit.circuit.library.HRSCumulativeMultiplier "qiskit.circuit.library.HRSCumulativeMultiplier")(num\_state\_qubits\[, ...]) | A multiplication circuit to store product of two input registers out-of-place. |
+| [`RGQFTMultiplier`](qiskit.circuit.library.RGQFTMultiplier "qiskit.circuit.library.RGQFTMultiplier")(num\_state\_qubits\[, ...]) | A QFT multiplication circuit to store product of two input registers out-of-place. |
+
+### Comparators
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- |
+| [`IntegerComparator`](qiskit.circuit.library.IntegerComparator "qiskit.circuit.library.IntegerComparator")(\[num\_state\_qubits, value, ...]) | Integer Comparator. |
+
+### Functions on binary variables
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
+| [`QuadraticForm`](qiskit.circuit.library.QuadraticForm "qiskit.circuit.library.QuadraticForm")(\[num\_result\_qubits, ...]) | Implements a quadratic form on binary variables encoded in qubit registers. |
+
+### Other arithmetic functions
+
+| | |
+| ----------------------------------------------------------------------------------------------------------------------------------------- | ---------------- |
+| [`ExactReciprocal`](qiskit.circuit.library.ExactReciprocal "qiskit.circuit.library.ExactReciprocal")(num\_state\_qubits, scaling\[, ...]) | Exact reciprocal |
+
+## Particular Quantum Circuits
+
+| | |
+| ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| [`FourierChecking`](qiskit.circuit.library.FourierChecking "qiskit.circuit.library.FourierChecking")(f, g) | Fourier checking circuit. |
+| [`GraphState`](qiskit.circuit.library.GraphState "qiskit.circuit.library.GraphState")(adjacency\_matrix) | Circuit to prepare a graph state. |
+| [`HiddenLinearFunction`](qiskit.circuit.library.HiddenLinearFunction "qiskit.circuit.library.HiddenLinearFunction")(adjacency\_matrix) | Circuit to solve the hidden linear function problem. |
+| [`IQP`](qiskit.circuit.library.IQP "qiskit.circuit.library.IQP")(interactions) | Instantaneous quantum polynomial (IQP) circuit. |
+| [`QuantumVolume`](qiskit.circuit.library.QuantumVolume "qiskit.circuit.library.QuantumVolume")(num\_qubits\[, depth, seed, ...]) | A quantum volume model circuit. |
+| [`PhaseEstimation`](qiskit.circuit.library.PhaseEstimation "qiskit.circuit.library.PhaseEstimation")(num\_evaluation\_qubits, unitary) | Phase Estimation circuit. |
+| [`GroverOperator`](qiskit.circuit.library.GroverOperator "qiskit.circuit.library.GroverOperator")(oracle\[, state\_preparation, ...]) | The Grover operator. |
+| [`PhaseOracle`](qiskit.circuit.library.PhaseOracle "qiskit.circuit.library.PhaseOracle")(expression\[, synthesizer, var\_order]) | Phase Oracle. |
+| [`EvolvedOperatorAnsatz`](qiskit.circuit.library.EvolvedOperatorAnsatz "qiskit.circuit.library.EvolvedOperatorAnsatz")(\[operators, reps, ...]) | The evolved operator ansatz. |
+| [`PauliEvolutionGate`](qiskit.circuit.library.PauliEvolutionGate "qiskit.circuit.library.PauliEvolutionGate")(operator\[, time, label, ...]) | Time-evolution of an operator consisting of Paulis. |
+| [`HamiltonianGate`](qiskit.circuit.library.HamiltonianGate "qiskit.circuit.library.HamiltonianGate")(data, time\[, label]) | Class for representing evolution by a Hamiltonian operator as a gate. |
+| [`UnitaryOverlap`](qiskit.circuit.library.UnitaryOverlap "qiskit.circuit.library.UnitaryOverlap")(unitary1, unitary2\[, ...]) | Circuit that returns the overlap between two unitaries $U_2^{\dag} U_1$. |
+
+## N-local circuits
+
+These `BlueprintCircuit` subclasses are used as parameterized models (a.k.a. ansatzes or variational forms) in variational algorithms. They are heavily used in near-term algorithms in e.g. Chemistry, Physics or Optimization.
+
+| | |
+| ---------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
+| [`NLocal`](qiskit.circuit.library.NLocal "qiskit.circuit.library.NLocal")(\[num\_qubits, rotation\_blocks, ...]) | The n-local circuit class. |
+| [`TwoLocal`](qiskit.circuit.library.TwoLocal "qiskit.circuit.library.TwoLocal")(\[num\_qubits, rotation\_blocks, ...]) | The two-local circuit. |
+| [`PauliTwoDesign`](qiskit.circuit.library.PauliTwoDesign "qiskit.circuit.library.PauliTwoDesign")(\[num\_qubits, reps, seed, ...]) | The Pauli Two-Design ansatz. |
+| [`RealAmplitudes`](qiskit.circuit.library.RealAmplitudes "qiskit.circuit.library.RealAmplitudes")(\[num\_qubits, entanglement, ...]) | The real-amplitudes 2-local circuit. |
+| [`EfficientSU2`](qiskit.circuit.library.EfficientSU2 "qiskit.circuit.library.EfficientSU2")(\[num\_qubits, su2\_gates, ...]) | The hardware efficient SU(2) 2-local circuit. |
+| [`ExcitationPreserving`](qiskit.circuit.library.ExcitationPreserving "qiskit.circuit.library.ExcitationPreserving")(\[num\_qubits, mode, ...]) | The heuristic excitation-preserving wave function ansatz. |
+| [`QAOAAnsatz`](qiskit.circuit.library.QAOAAnsatz "qiskit.circuit.library.QAOAAnsatz")(\[cost\_operator, reps, ...]) | A generalized QAOA quantum circuit with a support of custom initial states and mixers. |
+
+## Data encoding circuits
+
+These `BlueprintCircuit` encode classical data in quantum states and are used as feature maps for classification.
+
+| | |
+| -------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
+| [`PauliFeatureMap`](qiskit.circuit.library.PauliFeatureMap "qiskit.circuit.library.PauliFeatureMap")(\[feature\_dimension, reps, ...]) | The Pauli Expansion circuit. |
+| [`ZFeatureMap`](qiskit.circuit.library.ZFeatureMap "qiskit.circuit.library.ZFeatureMap")(feature\_dimension\[, reps, ...]) | The first order Pauli Z-evolution circuit. |
+| [`ZZFeatureMap`](qiskit.circuit.library.ZZFeatureMap "qiskit.circuit.library.ZZFeatureMap")(feature\_dimension\[, reps, ...]) | Second-order Pauli-Z evolution circuit. |
+| [`StatePreparation`](qiskit.circuit.library.StatePreparation "qiskit.circuit.library.StatePreparation")(params\[, num\_qubits, ...]) | Complex amplitude state preparation. |
+| [`Initialize`](qiskit.circuit.library.Initialize "qiskit.circuit.library.Initialize")(params\[, num\_qubits, normalize]) | Complex amplitude initialization. |
+
+## Template circuits
+
+Templates are functions that return circuits that compute the identity. They are used at circuit optimization where matching part of the template allows the compiler to replace the match with the inverse of the remainder from the template.
+
+In this example, the identity constant in a template is checked:
+
+```python
+from qiskit.circuit.library.templates import template_nct_4b_1
+from qiskit.quantum_info import Operator
+import numpy as np
+
+template = template_nct_4b_1()
+
+identity = np.identity(2 ** len(template.qubits), dtype=complex)
+data = Operator(template).data
+np.allclose(data, identity) # True, template_nct_4b_1 is the identity
+```
+
+### NCT (Not-CNOT-Toffoli) template circuits
+
+Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.library.XGate"), [`CXGate`](qiskit.circuit.library.CXGate "qiskit.circuit.library.CXGate"), and [`CCXGate`](qiskit.circuit.library.CCXGate "qiskit.circuit.library.CCXGate") (Toffoli) gates.
+
+**Reference:** Maslov, D. and Dueck, G. W. and Miller, D. M., Techniques for the synthesis of reversible Toffoli networks, 2007 [http://dx.doi.org/10.1145/1278349.1278355](http://dx.doi.org/10.1145/1278349.1278355)
+
+### template\_nct\_2a\_1
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_2a_1()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_2a_1.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_2a\_2
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_2a_2()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_2a_2.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_2a\_3
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_2a_3()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_2a_3.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_4a\_1
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_4a_1()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_4a_1.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_4a\_2
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_4a_2()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_4a_2.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_4a\_3
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_4a_3()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_4a_3.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_4b\_1
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_4b_1()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_4b_1.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_4b\_2
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_4b_2()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_4b_2.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_5a\_1
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_5a_1()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_5a_1.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_5a\_2
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_5a_2()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_5a_2.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_5a\_3
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_5a_3()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_5a_3.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_5a\_4
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_5a_4()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_5a_4.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_6a\_1
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_6a_1()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_6a_1.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_6a\_2
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_6a_2()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_6a_2.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_6a\_3
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_6a_3()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_6a_3.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_6a\_4
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_6a_4()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_6a_4.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_6b\_1
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_6b_1()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_6b_1.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_6b\_2
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_6b_2()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_6b_2.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_6c\_1
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_6c_1()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_6c_1.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_7a\_1
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_7a_1()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_7a_1.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_7b\_1
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_7b_1()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_7b_1.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_7c\_1
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_7c_1()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_7c_1.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_7d\_1
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_7d_1()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_7d_1.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_7e\_1
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_7e_1()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_7e_1.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_9a\_1
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_9a_1()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_9a_1.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_9c\_1
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_9c_1()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_9c_1.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_9c\_2
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_9c_2()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_9c_2.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_9c\_3
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_9c_3()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_9c_3.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_9c\_4
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_9c_4()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_9c_4.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_9c\_5
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_9c_5()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_9c_5.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_9c\_6
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_9c_6()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_9c_6.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_9c\_7
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_9c_7()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_9c_7.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_9c\_8
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_9c_8()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_9c_8.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_9c\_9
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_9c_9()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_9c_9.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_9c\_10
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_9c_10()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_9c_10.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_9c\_11
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_9c_11()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_9c_11.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_9c\_12
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_9c_12()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_9c_12.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_9d\_1
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_9d_1()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_9d_1.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_9d\_2
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_9d_2()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_9d_2.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_9d\_3
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_9d_3()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_9d_3.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_9d\_4
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_9d_4()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_9d_4.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_9d\_5
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_9d_5()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_9d_5.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_9d\_6
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_9d_6()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_9d_6.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_9d\_7
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_9d_7()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_9d_7.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_9d\_8
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_9d_8()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_9d_8.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_9d\_9
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_9d_9()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_9d_9.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### template\_nct\_9d\_10
+
+
+
+`qiskit.circuit.library.templates.nct.template_nct_9d_10()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/nct/template_nct_9d_10.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### Clifford template circuits
+
+Template circuits over Clifford gates.
+
+### clifford\_2\_1
+
+
+
+`qiskit.circuit.library.clifford_2_1()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/clifford/clifford_2_1.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### clifford\_2\_2
+
+
+
+`qiskit.circuit.library.clifford_2_2()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/clifford/clifford_2_2.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### clifford\_2\_3
+
+
+
+`qiskit.circuit.library.clifford_2_3()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/clifford/clifford_2_3.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### clifford\_2\_4
+
+
+
+`qiskit.circuit.library.clifford_2_4()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/clifford/clifford_2_4.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### clifford\_3\_1
+
+
+
+`qiskit.circuit.library.clifford_3_1()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/clifford/clifford_3_1.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### clifford\_4\_1
+
+
+
+`qiskit.circuit.library.clifford_4_1()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/clifford/clifford_4_1.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### clifford\_4\_2
+
+
+
+`qiskit.circuit.library.clifford_4_2()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/clifford/clifford_4_2.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### clifford\_4\_3
+
+
+
+`qiskit.circuit.library.clifford_4_3()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/clifford/clifford_4_3.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### clifford\_4\_4
+
+
+
+`qiskit.circuit.library.clifford_4_4()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/clifford/clifford_4_4.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### clifford\_5\_1
+
+
+
+`qiskit.circuit.library.clifford_5_1()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/clifford/clifford_5_1.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### clifford\_6\_1
+
+
+
+`qiskit.circuit.library.clifford_6_1()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/clifford/clifford_6_1.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### clifford\_6\_2
+
+
+
+`qiskit.circuit.library.clifford_6_2()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/clifford/clifford_6_2.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### clifford\_6\_3
+
+
+
+`qiskit.circuit.library.clifford_6_3()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/clifford/clifford_6_3.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### clifford\_6\_4
+
+
+
+`qiskit.circuit.library.clifford_6_4()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/clifford/clifford_6_4.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### clifford\_6\_5
+
+
+
+`qiskit.circuit.library.clifford_6_5()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/clifford/clifford_6_5.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### clifford\_8\_1
+
+
+
+`qiskit.circuit.library.clifford_8_1()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/clifford/clifford_8_1.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### clifford\_8\_2
+
+
+
+`qiskit.circuit.library.clifford_8_2()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/clifford/clifford_8_2.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### clifford\_8\_3
+
+
+
+`qiskit.circuit.library.clifford_8_3()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/clifford/clifford_8_3.py "view source code")
+
+**Returns**
+
+template as a quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### RZXGate template circuits
+
+Template circuits with [`RZXGate`](qiskit.circuit.library.RZXGate "qiskit.circuit.library.RZXGate").
+
+### rzx\_yz
+
+
+
+`qiskit.circuit.library.rzx_yz(theta=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/rzx/rzx_yz.py "view source code")
+
+Template for CX - RYGate - CX.
+
+### rzx\_xz
+
+
+
+`qiskit.circuit.library.rzx_xz(theta=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/rzx/rzx_xz.py "view source code")
+
+Template for CX - RXGate - CX.
+
+### rzx\_cy
+
+
+
+`qiskit.circuit.library.rzx_cy(theta=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/rzx/rzx_cy.py "view source code")
+
+Template for CX - RYGate - CX.
+
+### rzx\_zz1
+
+
+
+`qiskit.circuit.library.rzx_zz1(theta=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/rzx/rzx_zz1.py "view source code")
+
+Template for CX - RZGate - CX.
+
+### rzx\_zz2
+
+
+
+`qiskit.circuit.library.rzx_zz2(theta=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/rzx/rzx_zz2.py "view source code")
+
+Template for CX - RZGate - CX.
+
+### rzx\_zz3
+
+
+
+`qiskit.circuit.library.rzx_zz3(theta=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/templates/rzx/rzx_zz3.py "view source code")
+
+Template for CX - RZGate - CX.
+
diff --git a/docs/api/qiskit/0.46/circuit_singleton.md b/docs/api/qiskit/0.46/circuit_singleton.md
new file mode 100644
index 00000000000..cd7dceddb72
--- /dev/null
+++ b/docs/api/qiskit/0.46/circuit_singleton.md
@@ -0,0 +1,210 @@
+---
+title: singleton
+description: API reference for qiskit.circuit.singleton
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.circuit.singleton
+---
+
+
+
+
+
+
+
+# Singleton instructions
+
+
+
+`qiskit.circuit.singleton`
+
+The machinery in this module is for defining subclasses of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") and [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate") that preferentially return a shared immutable singleton instance when instantiated. Taking the example of [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.library.XGate"), the final user-facing result is that:
+
+* There is a regular class called `XGate`, which derives from [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate").
+* Doing something like `XGate(label="my_gate")` produces an object whose type is exactly `XGate`, and all the mutability works completely as expected; all the methods resolve to exactly those defined by [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.library.XGate"), [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate"), or parents.
+* Doing `XGate()` produces a singleton object whose type is a synthetic `_SingletonXGate` class, which derives [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.library.XGate") but overrides [`__setattr__()`](https://docs.python.org/3/reference/datamodel.html#object.__setattr__ "(in Python v3.12)") to make itself immutable. The object itself has precisely the same instance attributes as `XGate()` would have if there was no singleton handling. This object will return itself under [`copy()`](https://docs.python.org/3/library/copy.html#copy.copy "(in Python v3.12)"), [`deepcopy()`](https://docs.python.org/3/library/copy.html#copy.deepcopy "(in Python v3.12)") and roundtrip through [`pickle`](https://docs.python.org/3/library/pickle.html#module-pickle "(in Python v3.12)").
+
+The same can be true for, for example, [`Measure`](qiskit.circuit.library.Measure "qiskit.circuit.library.Measure"), except that it’s a subclass of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") only, and not [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate").
+
+
+ The classes in this module are for advanced use, because they are closely entwined with the heart of Qiskit’s data model for circuits.
+
+
+From a library-author perspective, the minimum that is needed to enhance a [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate") or [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") with this behaviour is to inherit from [`SingletonGate`](#qiskit.circuit.singleton.SingletonGate "qiskit.circuit.singleton.SingletonGate") ([`SingletonInstruction`](#qiskit.circuit.singleton.SingletonInstruction "qiskit.circuit.singleton.SingletonInstruction")) instead of [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate") ([`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction")), and for the `__init__` method to have defaults for all of its arguments (these will be the state of the singleton instance). For example:
+
+```python
+class XGate(SingletonGate):
+ def __init__(self, label=None):
+ super().__init__("x", 1, [], label=label)
+
+assert XGate() is XGate()
+```
+
+## Interface
+
+The public classes correspond to the standard classes [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") and [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate"), respectively, and are subclasses of these.
+
+
+
+`qiskit.circuit.singleton.SingletonInstruction(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/singleton.py "view source code")
+
+A base class to use for [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") objects that by default are singleton instances.
+
+This class should be used for instruction classes that have fixed definitions and do not contain any unique state. The canonical example of something like this is [`Measure`](qiskit.circuit.library.Measure "qiskit.circuit.library.Measure") which has an immutable definition and any instance of [`Measure`](qiskit.circuit.library.Measure "qiskit.circuit.library.Measure") is the same. Using singleton instructions as a base class for these types of gate classes provides a large advantage in the memory footprint of multiple instructions.
+
+The exception to be aware of with this class though are the [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") attributes [`label`](qiskit.circuit.Instruction#label "qiskit.circuit.Instruction.label"), [`condition`](qiskit.circuit.Instruction#condition "qiskit.circuit.Instruction.condition"), [`duration`](qiskit.circuit.Instruction#duration "qiskit.circuit.Instruction.duration"), and [`unit`](qiskit.circuit.Instruction#unit "qiskit.circuit.Instruction.unit") which can be set differently for specific instances of gates. For [`SingletonInstruction`](#qiskit.circuit.singleton.SingletonInstruction "qiskit.circuit.singleton.SingletonInstruction") usage to be sound setting these attributes is not available and they can only be set at creation time, or on an object that has been specifically made mutable using [`to_mutable()`](qiskit.circuit.Instruction#to_mutable "qiskit.circuit.Instruction.to_mutable"). If any of these attributes are used during creation, then instead of using a single shared global instance of the same gate a new separate instance will be created.
+
+
+
+`qiskit.circuit.singleton.SingletonGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/singleton.py "view source code")
+
+A base class to use for [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate") objects that by default are singleton instances.
+
+This class is very similar to [`SingletonInstruction`](#qiskit.circuit.singleton.SingletonInstruction "qiskit.circuit.singleton.SingletonInstruction"), except implies unitary [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate") semantics as well. The same caveats around setting attributes in that class apply here as well.
+
+
+
+`qiskit.circuit.singleton.SingletonControlledGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/singleton.py "view source code")
+
+A base class to use for [`ControlledGate`](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate") objects that by default are singleton instances
+
+This class is very similar to [`SingletonInstruction`](#qiskit.circuit.singleton.SingletonInstruction "qiskit.circuit.singleton.SingletonInstruction"), except implies unitary [`ControlledGate`](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate") semantics as well. The same caveats around setting attributes in that class apply here as well.
+
+When inheriting from one of these classes, the produced class will have an eagerly created singleton instance that will be returned whenever the class is constructed with arguments that have been defined to be singletons. Typically this will be the defaults. These instances are immutable; attempts to modify their properties will raise [`TypeError`](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)").
+
+*All* subclasses of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") have a [`mutable`](qiskit.circuit.Instruction#mutable "qiskit.circuit.Instruction.mutable") property. For most instructions this is `True`, while for the singleton instances it is `False`. One can use the [`to_mutable()`](qiskit.circuit.Instruction#to_mutable "qiskit.circuit.Instruction.to_mutable") method to get a version of the instruction that is owned and safe to mutate.
+
+The singleton instances are not exact instances of their base class; they are special subclasses that cannot construct new objects. This means that:
+
+```python
+type(XGate()) is not XGate
+```
+
+You should not rely on [`type`](https://docs.python.org/3/library/functions.html#type "(in Python v3.12)") having an exact value; use [`isinstance()`](https://docs.python.org/3/library/functions.html#isinstance "(in Python v3.12)") instead for type checking. If you need to reliably retrieve the base class from an [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction"), see the [`Instruction.base_class`](qiskit.circuit.Instruction#base_class "qiskit.circuit.Instruction.base_class") attribute; singleton instances set this correctly. For most cases in using Qiskit, [`Instruction.name`](qiskit.circuit.Instruction#name "qiskit.circuit.Instruction.name") is a more suitable determiner of what an instruction “means” in a circuit.
+
+### Deriving new singletons
+
+The simplest example of deriving a new singleton instruction is simply to inherit from the correct base and supply an [`__init__()`](https://docs.python.org/3/reference/datamodel.html#object.__init__ "(in Python v3.12)") method that has immutable defaults for any arguments. For example:
+
+```python
+from qiskit.circuit.singleton import SingletonInstruction
+
+class MyInstruction(SingletonInstruction):
+ def __init__(self, label=None):
+ super().__init__("my_instruction", 1, 0, label=label)
+
+assert MyInstruction() is MyInstruction()
+assert MyInstruction(label="some label") is not MyInstruction()
+assert MyInstruction(label="some label").mutable
+```
+
+The singleton instance will use all the constructor’s defaults.
+
+You can also derive from an instruction that is itself a singleton. The singleton nature of the class will be inherited, though the singleton instances of the two classes will be different:
+
+```python
+class MyOtherInstruction(MyInstruction):
+ pass
+
+assert MyOtherInstruction() is MyOtherInstruction()
+assert MyOtherInstruction() is not MyInstruction()
+```
+
+If for some reason you want to derive from [`SingletonInstruction`](#qiskit.circuit.singleton.SingletonInstruction "qiskit.circuit.singleton.SingletonInstruction"), or one of the related or subclasses but *do not* want the default singleton instance to be created, such as if you are defining a new abstract base class, you can set the keyword argument `create_default_singleton=False` in the class definition:
+
+```python
+class NotASingleton(SingletonInstruction, create_default_singleton=False):
+ def __init__(self):
+ return super().__init__("my_mutable", 1, 0, [])
+
+assert NotASingleton() is not NotASingleton()
+```
+
+If your constructor does not have defaults for all its arguments, you must set `create_default_singleton=False`.
+
+Subclasses of [`SingletonInstruction`](#qiskit.circuit.singleton.SingletonInstruction "qiskit.circuit.singleton.SingletonInstruction") and the other associated classes can control how their constructor’s arguments are interpreted, in order to help the singleton machinery return the singleton even in the case than an optional argument is explicitly set to its default.
+
+### \_singleton\_lookup\_key
+
+
+
+`static SingletonInstruction._singleton_lookup_key(*_args, **_kwargs)`
+
+Given the arguments to the constructor, return a key tuple that identifies the singleton instance to retrieve, or `None` if the arguments imply that a mutable object must be created.
+
+For performance, as a special case, this method will not be called if the class constructor was given zero arguments (e.g. the construction `XGate()` will not call this method, but `XGate(label=None)` will), and the default singleton will immediately be returned.
+
+This static method can (and probably should) be overridden by subclasses. The derived signature should match the class’s `__init__`; this method should then examine the arguments to determine whether it requires mutability, or what the cache key (if any) should be.
+
+The function should return either `None` or valid `dict` key (i.e. hashable and implements equality). Returning `None` means that the created instance must be mutable. No further singleton-based processing will be done, and the class creation will proceed as if there was no singleton handling. Otherwise, the returned key can be anything hashable and no special meaning is ascribed to it. Whenever this method returns the same key, the same singleton instance will be returned. We suggest that you use a tuple of the values of all arguments that can be set while maintaining the singleton nature.
+
+Only keys that match the default arguments or arguments given to `additional_singletons` at class-creation time will actually return singletons; other values will return a standard mutable instance.
+
+
+ The singleton machinery will handle an unhashable return from this function gracefully by returning a mutable instance. Subclasses should ensure that their key is hashable in the happy path, but they do not need to manually verify that the user-supplied arguments are hashable. For example, it’s safe to implement this as:
+
+ ```python
+ @staticmethod
+ def _singleton_lookup_key(*args, **kwargs):
+ return None if kwargs else args
+ ```
+
+ even though a user might give some unhashable type as one of the `args`.
+
+
+This is set by all Qiskit standard-library gates such that the `label` and similar keyword arguments are ignored in the key calculation if they are their defaults, or a mutable instance is returned if they are not.
+
+You can also specify other combinations of constructor arguments to produce singleton instances for, using the `additional_singletons` argument in the class definition. This takes an iterable of `(args, kwargs)` tuples, and will build singletons equivalent to `cls(*args, **kwargs)`. You do not need to handle the case of the default arguments with this. For example, given a class definition:
+
+```python
+class MySingleton(SingletonGate, additional_singletons=[((2,), {"label": "two"})]):
+ def __init__(self, n=1, label=None):
+ super().__init__("my", n, [], label=label)
+
+ @staticmethod
+ def _singleton_lookup_key(n=1, label=None):
+ return (n, label)
+```
+
+there will be two singleton instances instantiated. One corresponds to `n=1` and `label=None`, and the other to `n=2` and `label="two"`. Whenever `MySingleton` is constructed with arguments consistent with one of those two cases, the relevant singleton will be returned. For example:
+
+```python
+assert MySingleton() is MySingleton(1, label=None)
+assert MySingleton(2, "two") is MySingleton(n=2, label="two")
+```
+
+The case of the class being instantiated with zero arguments is handled specially to allow an absolute fast-path for inner-loop performance (although the general machinery is not desperately slow anyway).
+
+## Implementation
+
+
+ This section is primarily developer documentation for the code; none of the machinery described here is public, and it is not safe to inherit from any of it directly.
+
+
+There are several moving parts to tackle here. The behaviour of having `XGate()` return some singleton object that is an (inexact) instance of [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.library.XGate") but *without* calling `__init__` requires us to override [`type.__call__`](https://docs.python.org/3/library/functions.html#type "(in Python v3.12)"). This means that [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.library.XGate") must have a metaclass that defines `__call__` to return the singleton instance.
+
+Next, we need to ensure that there *is* a singleton instance for `XGate()` to return. This can be done dynamically on each call (i.e. check if the instance exists and create it if not), but since we also want that instance to be very special, it’s easier to hook in and create it during the definition of the `XGate` type object. This also has the advantage that we do not need to make the singleton object pickleable; we only need to specify where to retrieve it from during the unpickle, because the creation of the base type object will recreate the singleton.
+
+We want the singleton instance to:
+
+* be immutable; it should reject all attempts to mutate itself.
+* have exactly the same state as an `XGate()` would have had if there was no singleton handling.
+
+We do this in a three-step procedure:
+
+1. Before creating any singletons, we separately define the overrides needed to make an [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") and a [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate") immutable. This is `_SingletonInstructionOverrides` and the other `_*Overrides` classes.
+2. While we are creating the `XGate` type object, we dynamically *also* create a subclass of it that has the immutable overrides in its method-resolution order in the correct place. These override the standard methods / properties that are defined on the mutable gate (we do not attempt to override any cases where the type object we are creating has extra inplace methods).
+3. We can’t instantiate this new subclass, because when it calls `XGate.__init__`, it will attempt to set some attributes, and these will be rejected by immutability. Instead, we first create a completely regular `XGate` instance, and then we dynamically change its type to the singleton class, freezing it.
+
+We could do this entirely within the metaclass machinery, but that would require `XGate` to be defined as something like:
+
+```python
+class XGate(Gate, metaclass=_SingletonMeta, overrides=_SingletonGateOverrides): ...
+```
+
+which is super inconvenient (or we’d have to have `_SingletonMeta` do a bunch of fragile introspection). Instead, we use the [`abc.ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")/[`abc.ABCMeta`](https://docs.python.org/3/library/abc.html#abc.ABCMeta "(in Python v3.12)") pattern of defining a concrete middle class ([`SingletonGate`](#qiskit.circuit.singleton.SingletonGate "qiskit.circuit.singleton.SingletonGate") in the [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.library.XGate") case) that sets the metaclass, selects the overrides to be applied, and has an [`__init_subclass__()`](https://docs.python.org/3/reference/datamodel.html#object.__init_subclass__ "(in Python v3.12)") that applies the singleton-subclass-creation steps above. The overrides are in separate classes so that *mutable* [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.library.XGate") instances do not have them in their own method-resolution orders; doing this is easier to implement, but requires all the setters and checkers to dance around at runtime trying to validate whether mutating the instance is allowed.
+
+Finally, to actually build all this machinery up, the base is `_SingletonMeta`, which is a metaclass compatible with any metaclass of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction"). This defines the [`__call__()`](https://docs.python.org/3/reference/datamodel.html#object.__call__ "(in Python v3.12)") machinery that overrides [`type.__call__`](https://docs.python.org/3/library/functions.html#type "(in Python v3.12)") to return the singleton instances. The other component of it is its [`__new__()`](https://docs.python.org/3/reference/datamodel.html#object.__new__ "(in Python v3.12)"), which is called (non-trivially) during the creation of [`SingletonGate`](#qiskit.circuit.singleton.SingletonGate "qiskit.circuit.singleton.SingletonGate") and [`SingletonInstruction`](#qiskit.circuit.singleton.SingletonInstruction "qiskit.circuit.singleton.SingletonInstruction") with its `overrides` keyword argument set to define the `__init_subclass__` of those classes with the above properties. We use the metaclass to add this method dynamically, because the [`__init_subclass__()`](https://docs.python.org/3/reference/datamodel.html#object.__init_subclass__ "(in Python v3.12)") machinery wants to be abstract, closing over the `overrides` and the base class, but still able to call [`super`](https://docs.python.org/3/library/functions.html#super "(in Python v3.12)"). It’s more convenient to do this dynamically, closing over the desired class variable and using the two-argument form of [`super`](https://docs.python.org/3/library/functions.html#super "(in Python v3.12)"), since the zero-argument form does magic introspection based on where its containing function was defined.
+
+Handling multiple singletons requires storing the initialization arguments in some form, to allow the [`to_mutable()`](qiskit.circuit.Instruction#to_mutable "qiskit.circuit.Instruction.to_mutable") method and pickling to be defined. We do this as a lookup dictionary on the singleton *type object*. This is logically an instance attribute, but because we need to dynamically switch in the dynamic \_Singleton type onto an instance of the base type, that gets rather complex; either we have to require that the base already has an instance dictionary, or we risk breaking the `__slots__` layout during the switch. Since the singletons have lifetimes that last until garbage collection of their base class’s type object, we can fake out this instance dictionary using a type-object dictionary that maps instance pointers to the data we want to store. An alternative would be to build a new type object for each individual singleton that closes over (or stores) the initializer arguments, but type objects are quite heavy and the principle is largely same anyway.
+
diff --git a/docs/api/qiskit/0.46/classicalfunction.md b/docs/api/qiskit/0.46/classicalfunction.md
new file mode 100644
index 00000000000..affc59df4fe
--- /dev/null
+++ b/docs/api/qiskit/0.46/classicalfunction.md
@@ -0,0 +1,84 @@
+---
+title: classicalfunction
+description: API reference for qiskit.circuit.classicalfunction
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.circuit.classicalfunction
+---
+
+
+
+
+
+
+
+# ClassicalFunction compiler
+
+
+
+`qiskit.circuit.classicalfunction`
+
+## Overview
+
+The classical function compiler provides the necessary tools to map a classical potentially irreversible functions into quantum circuits. Below is a simple example of how to synthesize a simple boolean function defined using Python into a QuantumCircuit:
+
+> ```python
+> from qiskit.circuit.classicalfunction import classical_function
+> from qiskit.circuit.classicalfunction.types import Int1
+>
+> @classical_function
+> def grover_oracle(a: Int1, b: Int1, c: Int1, d: Int1) -> Int1:
+> return (not a and b and not c and d)
+>
+> quantum_circuit = grover_oracle.synth(registerless=False)
+> quantum_circuit.draw('text')
+>
+> a: ──o──
+> │
+> b: ──■──
+> │
+> c: ──o──
+> │
+> d: ──■──
+> ┌─┴─┐
+> return: ┤ X ├
+> └───┘
+> ```
+
+Following Qiskit’s little-endian bit ordering convention, the left-most bit (`a`) is the most significant bit and the right-most bit (`d`) is the least significant bit.
+
+## Supplementary Information
+
+### Tweedledum
+
+Tweedledum is a C++-17 header-only library that implements a large set of reversible (and quantum) synthesis, optimization, and mapping algorithms. The classical function compiler relies on it and its dependencies to both represent logic networks and synthesize them into quantum circuits.
+
+### ClassicalFunction data types
+
+At the moment, the only type supported by the classical\_function compilers is `qiskit.circuit.classicalfunction.types.Int1`. The classical function function to parse *must* include type hints (just `Int1` for now). The resulting gate will be a gate in the size of the sum of all the parameters and the return.
+
+The type `Int1` means the classical function will only operate at bit level.
+
+## ClassicalFunction compiler API
+
+
+
+### classical\_function
+
+Decorator for a classical function that returns a ClassicalFunction object.
+
+### ClassicalFunction
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
+| [`ClassicalFunction`](qiskit.circuit.classicalfunction.ClassicalFunction "qiskit.circuit.classicalfunction.ClassicalFunction")(source\[, name]) | Represent a classical function and its logic network. |
+| [`BooleanExpression`](qiskit.circuit.classicalfunction.BooleanExpression "qiskit.circuit.classicalfunction.BooleanExpression")(expression\[, name, var\_order]) | The Boolean Expression gate. |
+
+### Exceptions
+
+| | |
+| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
+| [`ClassicalFunctionCompilerTypeError`](qiskit.circuit.classicalfunction.ClassicalFunctionCompilerTypeError "qiskit.circuit.classicalfunction.ClassicalFunctionCompilerTypeError")(\*message) | ClassicalFunction compiler type error. |
+| [`ClassicalFunctionParseError`](qiskit.circuit.classicalfunction.ClassicalFunctionParseError "qiskit.circuit.classicalfunction.ClassicalFunctionParseError")(\*message) | ClassicalFunction compiler parse error. |
+| [`ClassicalFunctionCompilerTypeError`](qiskit.circuit.classicalfunction.ClassicalFunctionCompilerTypeError "qiskit.circuit.classicalfunction.ClassicalFunctionCompilerTypeError")(\*message) | ClassicalFunction compiler type error. |
+
diff --git a/docs/api/qiskit/0.46/compiler.md b/docs/api/qiskit/0.46/compiler.md
new file mode 100644
index 00000000000..d4b64eb6edd
--- /dev/null
+++ b/docs/api/qiskit/0.46/compiler.md
@@ -0,0 +1,310 @@
+---
+title: compiler
+description: API reference for qiskit.compiler
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.compiler
+---
+
+
+
+
+
+
+
+# Compilation Routines
+
+
+
+`qiskit.compiler`
+
+## Circuit and Pulse Compilation Functions
+
+### assemble
+
+
+
+`qiskit.compiler.assemble(experiments, backend=None, qobj_id=None, qobj_header=None, shots=None, memory=False, seed_simulator=None, qubit_lo_freq=None, meas_lo_freq=None, qubit_lo_range=None, meas_lo_range=None, schedule_los=None, meas_level=MeasLevel.CLASSIFIED, meas_return=MeasReturnType.AVERAGE, meas_map=None, memory_slot_size=100, rep_time=None, rep_delay=None, parameter_binds=None, parametric_pulses=None, init_qubits=True, **run_config)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/compiler/assembler.py "view source code")
+
+Assemble a list of circuits or pulse schedules into a `Qobj`.
+
+This function serializes the payloads, which could be either circuits or schedules, to create `Qobj` “experiments”. It further annotates the experiment payload with header and configurations.
+
+NOTE: Backend.options is not used within assemble. The required values (previously given by backend.set\_options) should be manually extracted from options and supplied directly when calling.
+
+**Parameters**
+
+* **experiments** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")*] |* [*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")*] |* [*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock")*]*) – Circuit(s) or pulse schedule(s) to execute
+
+* **backend** ([*Backend*](qiskit.providers.Backend "qiskit.providers.backend.Backend") *| None*) – If set, some runtime options are automatically grabbed from `backend.configuration()` and `backend.defaults()`. If any other option is explicitly set (e.g., `rep_time`), it will override the backend’s. If any other options is set in the run\_config, it will also override the backend’s.
+
+* **qobj\_id** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – String identifier to annotate the `Qobj`
+
+* **qobj\_header** ([*QobjHeader*](qiskit.qobj.QobjHeader "qiskit.qobj.common.QobjHeader") *|*[*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)") *| None*) – User input that will be inserted in `Qobj` header, and will also be copied to the corresponding Result header. Headers do not affect the run.
+
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – Number of repetitions of each circuit, for sampling. Default: 1024 or `max_shots` from the backend configuration, whichever is smaller
+
+* **memory** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – If `True`, per-shot measurement bitstrings are returned as well (provided the backend supports it). For OpenPulse jobs, only measurement level 2 supports this option.
+
+* **seed\_simulator** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – Random seed to control sampling, for when backend is a simulator
+
+* **qubit\_lo\_freq** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – List of job level qubit drive LO frequencies in Hz. Overridden by `schedule_los` if specified. Must have length `n_qubits.`
+
+* **meas\_lo\_freq** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – List of measurement LO frequencies in Hz. Overridden by `schedule_los` if specified. Must have length `n_qubits.`
+
+* **qubit\_lo\_range** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – List of job level drive LO ranges each of form `[range_min, range_max]` in Hz. Used to validate `qubit_lo_freq`. Must have length `n_qubits.`
+
+* **meas\_lo\_range** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – List of job level measurement LO ranges each of form `[range_min, range_max]` in Hz. Used to validate `meas_lo_freq`. Must have length `n_qubits.`
+
+* **schedule\_los** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[PulseChannel,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | LoConfig] |* [*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[PulseChannel,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | LoConfig | None*) – Experiment level (ie circuit or schedule) LO frequency configurations for qubit drive and measurement channels. These values override the job level values from `default_qubit_los` and `default_meas_los`. Frequencies are in Hz. Settable for OpenQASM 2 and pulse jobs.
+
+* **meas\_level** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| MeasLevel*) – Set the appropriate level of the measurement output for pulse experiments.
+
+* **meas\_return** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| MeasReturnType*) –
+
+ Level of measurement data for the backend to return.
+
+ **For `meas_level` 0 and 1:**
+
+ * `single` returns information from every shot.
+ * `avg` returns average measurement output (averaged over number of shots).
+
+* **meas\_map** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit")*]] | None*) – List of lists, containing qubits that must be measured together.
+
+* **memory\_slot\_size** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Size of each memory slot if the output is Level 0.
+
+* **rep\_time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time per program execution in seconds. Must be from the list provided by the backend (`backend.configuration().rep_times`). Defaults to the first entry.
+
+* **rep\_delay** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Delay between programs in seconds. Only supported on certain backends (if `backend.configuration().dynamic_reprate_enabled=True`). If supported, `rep_delay` will be used instead of `rep_time` and must be from the range supplied by the backend (`backend.configuration().rep_delay_range`). Default is given by `backend.configuration().default_rep_delay`.
+
+* **parameter\_binds** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.parameter.Parameter")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – List of Parameter bindings over which the set of experiments will be executed. Each list element (bind) should be of the form \{Parameter1: value1, Parameter2: value2, …}. All binds will be executed across all experiments; e.g., if parameter\_binds is a length-n list, and there are m experiments, a total of m x n experiments will be run (one for each experiment/bind pair).
+
+* **parametric\_pulses** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*] | None*) –
+
+ A list of pulse shapes which are supported internally on the backend. Example:
+
+ ```python
+ ['gaussian', 'constant']
+ ```
+
+* **init\_qubits** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to reset the qubits to the ground state for each shot. Default: `True`.
+
+* **\*\*run\_config** ([*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")) – Extra arguments used to configure the run (e.g., for Aer configurable backends). Refer to the backend documentation for details on these arguments.
+
+**Returns**
+
+A `Qobj` that can be run on a backend. Depending on the type of input, this will be either a `QasmQobj` or a `PulseQobj`.
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input cannot be interpreted as either circuits or schedules
+
+**Return type**
+
+[*QasmQobj*](qiskit.qobj.QasmQobj "qiskit.qobj.qasm_qobj.QasmQobj") | [*PulseQobj*](qiskit.qobj.PulseQobj "qiskit.qobj.pulse_qobj.PulseQobj")
+
+### schedule
+
+
+
+`qiskit.compiler.schedule(circuits, backend=None, inst_map=None, meas_map=None, dt=None, method=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/compiler/scheduler.py "view source code")
+
+Schedule a circuit to a pulse `Schedule`, using the backend, according to any specified methods. Supported methods are documented in `qiskit.scheduler.schedule_circuit`.
+
+**Parameters**
+
+* **circuits** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")*]*) – The quantum circuit or circuits to translate
+* **backend** ([*Backend*](qiskit.providers.Backend "qiskit.providers.backend.Backend") *| None*) – A backend instance, which contains hardware-specific data required for scheduling
+* **inst\_map** ([*InstructionScheduleMap*](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.instruction_schedule_map.InstructionScheduleMap") *| None*) – Mapping of circuit operations to pulse schedules. If `None`, defaults to the `backend`’s `instruction_schedule_map`
+* **meas\_map** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]] | None*) – List of sets of qubits that must be measured together. If `None`, defaults to the `backend`’s `meas_map`
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The output sample rate of backend control electronics. For scheduled circuits which contain time information, dt is required. If not provided, it will be obtained from the backend configuration
+* **method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*] | None*) – Optionally specify a particular scheduling method
+
+**Returns**
+
+A pulse `Schedule` that implements the input circuit
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If `inst_map` and `meas_map` are not passed and `backend` is not passed
+
+**Return type**
+
+[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")]
+
+### transpile
+
+
+
+`qiskit.compiler.transpile(circuits, backend=None, basis_gates=None, inst_map=None, coupling_map=None, backend_properties=None, initial_layout=None, layout_method=None, routing_method=None, translation_method=None, scheduling_method=None, instruction_durations=None, dt=None, approximation_degree=1.0, timing_constraints=None, seed_transpiler=None, optimization_level=None, callback=None, output_name=None, unitary_synthesis_method='default', unitary_synthesis_plugin_config=None, target=None, hls_config=None, init_method=None, optimization_method=None, ignore_backend_supplied_default_methods=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/compiler/transpiler.py "view source code")
+
+Transpile one or more circuits, according to some desired transpilation targets.
+
+Transpilation is potentially done in parallel using multiprocessing when `circuits` is a list with > 1 [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") object depending on the local environment and configuration.
+
+**Parameters**
+
+* **circuits** (*\_CircuitT*) – Circuit(s) to transpile
+
+* **backend** ([*Backend*](qiskit.providers.Backend "qiskit.providers.backend.Backend") *| None*) – If set, the transpiler will compile the input circuit to this target device. If any other option is explicitly set (e.g., `coupling_map`), it will override the backend’s.
+
+* **basis\_gates** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*] | None*) – List of basis gate names to unroll to (e.g: `['u1', 'u2', 'u3', 'cx']`). If `None`, do not unroll.
+
+* **inst\_map** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*InstructionScheduleMap*](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.instruction_schedule_map.InstructionScheduleMap")*] | None*) – Mapping of unrolled gates to pulse schedules. If this is not provided, transpiler tries to get from the backend. If any user defined calibration is found in the map and this is used in a circuit, transpiler attaches the custom gate definition to the circuit. This enables one to flexibly override the low-level instruction implementation. This feature is available iff the backend supports the pulse gate experiment.
+
+* **coupling\_map** ([*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.coupling.CouplingMap") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]] | None*) –
+
+ Directed coupling map (perhaps custom) to target in mapping. If the coupling map is symmetric, both directions need to be specified.
+
+ Multiple formats are supported:
+
+ 1. `CouplingMap` instance
+ 2. List, must be given as an adjacency matrix, where each entry specifies all directed two-qubit interactions supported by backend, e.g: `[[0, 1], [0, 3], [1, 2], [1, 5], [2, 5], [4, 1], [5, 3]]`
+
+* **backend\_properties** ([*BackendProperties*](qiskit.providers.models.BackendProperties "qiskit.providers.models.backendproperties.BackendProperties") *| None*) – properties returned by a backend, including information on gate errors, readout errors, qubit coherence times, etc. Find a backend that provides this information with: `backend.properties()`
+
+* **initial\_layout** ([*Layout*](qiskit.transpiler.Layout "qiskit.transpiler.layout.Layout") *|*[*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)") *| None*) –
+
+ Initial position of virtual qubits on physical qubits. If this layout makes the circuit compatible with the coupling\_map constraints, it will be used. The final layout is not guaranteed to be the same, as the transpiler may permute qubits through swaps or other means. Multiple formats are supported:
+
+ 1. `Layout` instance
+
+ 2. Dict \* virtual to physical:
+
+ ```python
+ {qr[0]: 0,
+ qr[1]: 3,
+ qr[2]: 5}
+ ```
+
+ * physical to virtual:
+
+ ```python
+ {0: qr[0],
+ 3: qr[1],
+ 5: qr[2]}
+ ```
+
+ 3. List
+
+ * virtual to physical:
+
+ ```python
+ [0, 3, 5] # virtual qubits are ordered (in addition to named)
+ ```
+
+ * physical to virtual:
+
+ ```python
+ [qr[0], None, None, qr[1], None, qr[2]]
+ ```
+
+* **layout\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of layout selection pass (‘trivial’, ‘dense’, ‘noise\_adaptive’, ‘sabre’). This can also be the external plugin name to use for the `layout` stage. You can see a list of installed plugins by using [`list_stage_plugins()`](transpiler_plugins#qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins "qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins") with `"layout"` for the `stage_name` argument.
+
+* **routing\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of routing pass (‘basic’, ‘lookahead’, ‘stochastic’, ‘sabre’, ‘none’). Note This can also be the external plugin name to use for the `routing` stage. You can see a list of installed plugins by using [`list_stage_plugins()`](transpiler_plugins#qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins "qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins") with `"routing"` for the `stage_name` argument.
+
+* **translation\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of translation pass (‘unroller’, ‘translator’, ‘synthesis’) This can also be the external plugin name to use for the `translation` stage. You can see a list of installed plugins by using [`list_stage_plugins()`](transpiler_plugins#qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins "qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins") with `"translation"` for the `stage_name` argument.
+
+* **scheduling\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of scheduling pass. \* `'as_soon_as_possible'`: Schedule instructions greedily, as early as possible on a qubit resource. (alias: `'asap'`) \* `'as_late_as_possible'`: Schedule instructions late, i.e. keeping qubits in the ground state when possible. (alias: `'alap'`) If `None`, no scheduling will be done. This can also be the external plugin name to use for the `scheduling` stage. You can see a list of installed plugins by using [`list_stage_plugins()`](transpiler_plugins#qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins "qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins") with `"scheduling"` for the `stage_name` argument.
+
+* **instruction\_durations** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None,* [*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]] |* [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None]] |* [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]] |* [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] |* [*InstructionDurations*](qiskit.transpiler.InstructionDurations "qiskit.transpiler.instruction_durations.InstructionDurations") *| None*) – Durations of instructions. Applicable only if scheduling\_method is specified. The gate lengths defined in `backend.properties` are used as default. They are overwritten if this `instruction_durations` is specified. The format of `instruction_durations` must be as follows. The instruction\_durations must be given as a list of tuples \[(instruction\_name, qubits, duration, unit), …]. | \[(‘cx’, \[0, 1], 12.3, ‘ns’), (‘u3’, \[0], 4.56, ‘ns’)] | \[(‘cx’, \[0, 1], 1000), (‘u3’, \[0], 300)] If unit is omitted, the default is ‘dt’, which is a sample time depending on backend. If the time unit is ‘dt’, the duration must be an integer.
+
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – Backend sample time (resolution) in seconds. If `None` (default), `backend.configuration().dt` is used.
+
+* **approximation\_degree** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – heuristic dial used for circuit approximation (1.0=no approximation, 0.0=maximal approximation)
+
+* **timing\_constraints** ([*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) –
+
+ An optional control hardware restriction on instruction time resolution. A quantum computer backend may report a set of restrictions, namely:
+
+ * granularity: An integer value representing minimum pulse gate resolution in units of `dt`. A user-defined pulse gate should have duration of a multiple of this granularity value.
+ * min\_length: An integer value representing minimum pulse gate length in units of `dt`. A user-defined pulse gate should be longer than this length.
+ * pulse\_alignment: An integer value representing a time resolution of gate instruction starting time. Gate instruction should start at time which is a multiple of the alignment value.
+ * acquire\_alignment: An integer value representing a time resolution of measure instruction starting time. Measure instruction should start at time which is a multiple of the alignment value.
+
+ This information will be provided by the backend configuration. If the backend doesn’t have any restriction on the instruction time allocation, then `timing_constraints` is None and no adjustment will be performed.
+
+* **seed\_transpiler** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – Sets random seed for the stochastic parts of the transpiler
+
+* **optimization\_level** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) –
+
+ How much optimization to perform on the circuits. Higher levels generate more optimized circuits, at the expense of longer transpilation time.
+
+ * 0: no optimization
+ * 1: light optimization
+ * 2: heavy optimization
+ * 3: even heavier optimization
+
+ If `None`, level 1 will be chosen as default.
+
+* **callback** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")*\[\[BasePass,* [*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*PropertySet*](qiskit.passmanager.PropertySet "qiskit.passmanager.compilation_status.PropertySet")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*],* [*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")*] | None*) –
+
+ A callback function that will be called after each pass execution. The function will be called with 5 keyword arguments, | `pass_`: the pass being run. | `dag`: the dag output of the pass. | `time`: the time to execute the pass. | `property_set`: the property set. | `count`: the index for the pass execution. The exact arguments passed expose the internals of the pass manager, and are subject to change as the pass manager internals change. If you intend to reuse a callback function over multiple releases, be sure to check that the arguments being passed are the same. To use the callback feature, define a function that will take in kwargs dict and access the variables. For example:
+
+ ```python
+ def callback_func(**kwargs):
+ pass_ = kwargs['pass_']
+ dag = kwargs['dag']
+ time = kwargs['time']
+ property_set = kwargs['property_set']
+ count = kwargs['count']
+ ...
+ transpile(circ, callback=callback_func)
+ ```
+
+* **output\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*] | None*) – A list with strings to identify the output circuits. The length of the list should be exactly the length of the `circuits` parameter.
+
+* **unitary\_synthesis\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the unitary synthesis method to use. By default `'default'` is used. You can see a list of installed plugins with [`unitary_synthesis_plugin_names()`](qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names "qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names").
+
+* **unitary\_synthesis\_plugin\_config** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *| None*) – An optional configuration dictionary that will be passed directly to the unitary synthesis plugin. By default this setting will have no effect as the default unitary synthesis method does not take custom configuration. This should only be necessary when a unitary synthesis plugin is specified with the `unitary_synthesis` argument. As this is custom for each unitary synthesis plugin refer to the plugin documentation for how to use this option.
+
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.target.Target") *| None*) – A backend transpiler target. Normally this is specified as part of the `backend` argument, but if you have manually constructed a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object you can specify it manually here. This will override the target from `backend`.
+
+* **hls\_config** (*HLSConfig | None*) – An optional configuration class `HLSConfig` that will be passed directly to `HighLevelSynthesis` transformation pass. This configuration class allows to specify for various high-level objects the lists of synthesis algorithms and their parameters.
+
+* **init\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The plugin name to use for the `init` stage. By default an external plugin is not used. You can see a list of installed plugins by using [`list_stage_plugins()`](transpiler_plugins#qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins "qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins") with `"init"` for the stage name argument.
+
+* **optimization\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The plugin name to use for the `optimization` stage. By default an external plugin is not used. You can see a list of installed plugins by using [`list_stage_plugins()`](transpiler_plugins#qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins "qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins") with `"optimization"` for the `stage_name` argument.
+
+* **ignore\_backend\_supplied\_default\_methods** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If set to `True` any default methods specified by a backend will be ignored. Some backends specify alternative default methods to support custom compilation target-specific passes/plugins which support backend-specific compilation techniques. If you’d prefer that these defaults were not used this option is used to disable those backend-specific defaults.
+
+**Returns**
+
+The transpiled circuit(s).
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – in case of bad inputs to transpiler (like conflicting parameters) or errors in passes
+
+**Return type**
+
+*\_CircuitT*
+
+### sequence
+
+
+
+`qiskit.compiler.sequence(scheduled_circuits, backend=None, inst_map=None, meas_map=None, dt=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/compiler/sequencer.py "view source code")
+
+Schedule a scheduled circuit to a pulse `Schedule`, using the backend.
+
+**Parameters**
+
+* **scheduled\_circuits** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")*]*) – Scheduled circuit(s) to be translated
+* **backend** ([*Backend*](qiskit.providers.Backend "qiskit.providers.backend.Backend") *| None*) – A backend instance, which contains hardware-specific data required for scheduling
+* **inst\_map** ([*InstructionScheduleMap*](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.instruction_schedule_map.InstructionScheduleMap") *| None*) – Mapping of circuit operations to pulse schedules. If `None`, defaults to the `backend`’s `instruction_schedule_map`
+* **meas\_map** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]] | None*) – List of sets of qubits that must be measured together. If `None`, defaults to the `backend`’s `meas_map`
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The output sample rate of backend control electronics. For scheduled circuits which contain time information, dt is required. If not provided, it will be obtained from the backend configuration
+
+**Returns**
+
+A pulse `Schedule` that implements the input circuit
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If `inst_map` and `meas_map` are not passed and `backend` is not passed
+
+**Return type**
+
+[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")]
+
diff --git a/docs/api/qiskit/0.46/converters.md b/docs/api/qiskit/0.46/converters.md
new file mode 100644
index 00000000000..bf6bd7e0ff7
--- /dev/null
+++ b/docs/api/qiskit/0.46/converters.md
@@ -0,0 +1,310 @@
+---
+title: converters
+description: API reference for qiskit.converters
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.converters
+---
+
+
+
+
+
+
+
+# Circuit Converters
+
+
+
+`qiskit.converters`
+
+### circuit\_to\_dag
+
+
+
+`qiskit.converters.circuit_to_dag(circuit, copy_operations=True, *, qubit_order=None, clbit_order=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/converters/circuit_to_dag.py "view source code")
+
+Build a [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") object from a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit").
+
+**Parameters**
+
+* **circuit** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – the input circuit.
+* **copy\_operations** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Deep copy the operation objects in the [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") for the output [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit"). This should only be set to `False` if the input [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") will not be used anymore as the operations in the output [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") will be shared instances and modifications to operations in the [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") will be reflected in the [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") (and vice versa).
+* **qubit\_order** (*Iterable\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*] or None*) – the order that the qubits should be indexed in the output DAG. Defaults to the same order as in the circuit.
+* **clbit\_order** (*Iterable\[*[*Clbit*](qiskit.circuit.Clbit "qiskit.circuit.Clbit")*] or None*) – the order that the clbits should be indexed in the output DAG. Defaults to the same order as in the circuit.
+
+**Returns**
+
+the DAG representing the input circuit.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – if the `qubit_order` or `clbit_order` parameters do not match the bits in the circuit.
+
+**Example**
+
+```python
+from qiskit import QuantumRegister, ClassicalRegister, QuantumCircuit
+from qiskit.dagcircuit import DAGCircuit
+from qiskit.converters import circuit_to_dag
+
+q = QuantumRegister(3, 'q')
+c = ClassicalRegister(3, 'c')
+circ = QuantumCircuit(q, c)
+circ.h(q[0])
+circ.cx(q[0], q[1])
+circ.measure(q[0], c[0])
+circ.rz(0.5, q[1]).c_if(c, 2)
+dag = circuit_to_dag(circ)
+```
+
+### dag\_to\_circuit
+
+
+
+`qiskit.converters.dag_to_circuit(dag, copy_operations=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/converters/dag_to_circuit.py "view source code")
+
+Build a `QuantumCircuit` object from a `DAGCircuit`.
+
+**Parameters**
+
+* **dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – the input dag.
+* **copy\_operations** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Deep copy the operation objects in the [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") for the output [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"). This should only be set to `False` if the input [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") will not be used anymore as the operations in the output [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") will be shared instances and modifications to operations in the [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") will be reflected in the [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") (and vice versa).
+
+**Returns**
+
+the circuit representing the input dag.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Example**
+
+```python
+from qiskit import QuantumRegister, ClassicalRegister, QuantumCircuit
+from qiskit.dagcircuit import DAGCircuit
+from qiskit.converters import circuit_to_dag
+from qiskit.circuit.library.standard_gates import CHGate, U2Gate, CXGate
+from qiskit.converters import dag_to_circuit
+
+q = QuantumRegister(3, 'q')
+c = ClassicalRegister(3, 'c')
+circ = QuantumCircuit(q, c)
+circ.h(q[0])
+circ.cx(q[0], q[1])
+circ.measure(q[0], c[0])
+circ.rz(0.5, q[1]).c_if(c, 2)
+dag = circuit_to_dag(circ)
+circuit = dag_to_circuit(dag)
+circuit.draw('mpl')
+```
+
+
+
+### circuit\_to\_instruction
+
+
+
+`qiskit.converters.circuit_to_instruction(circuit, parameter_map=None, equivalence_library=None, label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/converters/circuit_to_instruction.py "view source code")
+
+Build an [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") object from a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit").
+
+The instruction is anonymous (not tied to a named quantum register), and so can be inserted into another circuit. The instruction will have the same string name as the circuit.
+
+**Parameters**
+
+* **circuit** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – the input circuit.
+* **parameter\_map** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – For parameterized circuits, a mapping from parameters in the circuit to parameters to be used in the instruction. If None, existing circuit parameters will also parameterize the instruction.
+* **equivalence\_library** ([*EquivalenceLibrary*](qiskit.circuit.EquivalenceLibrary "qiskit.circuit.EquivalenceLibrary")) – Optional equivalence library where the converted instruction will be registered.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Optional instruction label.
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if parameter\_map is not compatible with circuit
+
+**Returns**
+
+an instruction equivalent to the action of the input circuit. Upon decomposition, this instruction will yield the components comprising the original circuit.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Example**
+
+```python
+from qiskit import QuantumRegister, ClassicalRegister, QuantumCircuit
+from qiskit.converters import circuit_to_instruction
+
+q = QuantumRegister(3, 'q')
+c = ClassicalRegister(3, 'c')
+circ = QuantumCircuit(q, c)
+circ.h(q[0])
+circ.cx(q[0], q[1])
+circ.measure(q[0], c[0])
+circ.rz(0.5, q[1]).c_if(c, 2)
+circuit_to_instruction(circ)
+```
+
+### circuit\_to\_gate
+
+
+
+`qiskit.converters.circuit_to_gate(circuit, parameter_map=None, equivalence_library=None, label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/converters/circuit_to_gate.py "view source code")
+
+Build a [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate") object from a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit").
+
+The gate is anonymous (not tied to a named quantum register), and so can be inserted into another circuit. The gate will have the same string name as the circuit.
+
+**Parameters**
+
+* **circuit** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – the input circuit.
+* **parameter\_map** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – For parameterized circuits, a mapping from parameters in the circuit to parameters to be used in the gate. If None, existing circuit parameters will also parameterize the Gate.
+* **equivalence\_library** ([*EquivalenceLibrary*](qiskit.circuit.EquivalenceLibrary "qiskit.circuit.EquivalenceLibrary")) – Optional equivalence library where the converted gate will be registered.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Optional gate label.
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if circuit is non-unitary or if parameter\_map is not compatible with circuit
+
+**Returns**
+
+a Gate equivalent to the action of the input circuit. Upon decomposition, this gate will yield the components comprising the original circuit.
+
+**Return type**
+
+[Gate](qiskit.circuit.Gate "qiskit.circuit.Gate")
+
+### ast\_to\_dag
+
+
+
+`qiskit.converters.ast_to_dag(ast)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/converters/ast_to_dag.py "view source code")
+
+Build a `DAGCircuit` object from an AST `Node` object.
+
+
+ The function `qiskit.converters.ast_to_dag.ast_to_dag()` is deprecated as of qiskit 0.46. It will be removed in the 1.0.0 release. Instead use the qiskit.qasm2.dump() or qiskit.qasm2.dumps() function
+
+
+**Parameters**
+
+**ast** (*Program*) – a Program Node of an AST (parser’s output)
+
+**Returns**
+
+the DAG representing an OpenQASM’s AST
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the AST is malformed.
+
+**Example**
+
+```python
+from qiskit.converters import ast_to_dag
+from qiskit import qasm, QuantumCircuit, ClassicalRegister, QuantumRegister
+
+q = QuantumRegister(3, 'q')
+c = ClassicalRegister(3, 'c')
+circ = QuantumCircuit(q, c)
+circ.h(q[0])
+circ.cx(q[0], q[1])
+circ.measure(q[0], c[0])
+circ.rz(0.5, q[1]).c_if(c, 2)
+qasm_str = circ.qasm()
+ast = qasm.Qasm(data=qasm_str).parse()
+dag = ast_to_dag(ast)
+```
+
+### dagdependency\_to\_circuit
+
+
+
+`qiskit.converters.dagdependency_to_circuit(dagdependency)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/converters/dagdependency_to_circuit.py "view source code")
+
+Build a `QuantumCircuit` object from a `DAGDependency`.
+
+**Parameters**
+
+**dagdependency** ([*DAGDependency*](qiskit.dagcircuit.DAGDependency "qiskit.dagcircuit.DAGDependency")) – the input dag.
+
+**Returns**
+
+the circuit representing the input dag dependency.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### circuit\_to\_dagdependency
+
+
+
+`qiskit.converters.circuit_to_dagdependency(circuit, create_preds_and_succs=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/converters/circuit_to_dagdependency.py "view source code")
+
+Build a `DAGDependency` object from a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit").
+
+**Parameters**
+
+* **circuit** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – the input circuit.
+* **create\_preds\_and\_succs** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – whether to construct lists of predecessors and successors for every node.
+
+**Returns**
+
+the DAG representing the input circuit as a dag dependency.
+
+**Return type**
+
+[DAGDependency](qiskit.dagcircuit.DAGDependency "qiskit.dagcircuit.DAGDependency")
+
+### dag\_to\_dagdependency
+
+
+
+`qiskit.converters.dag_to_dagdependency(dag, create_preds_and_succs=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/converters/dag_to_dagdependency.py "view source code")
+
+Build a `DAGDependency` object from a `DAGCircuit`.
+
+**Parameters**
+
+* **dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – the input dag.
+* **create\_preds\_and\_succs** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – whether to construct lists of predecessors and successors for every node.
+
+**Returns**
+
+the DAG representing the input circuit as a dag dependency.
+
+**Return type**
+
+[DAGDependency](qiskit.dagcircuit.DAGDependency "qiskit.dagcircuit.DAGDependency")
+
+### dagdependency\_to\_dag
+
+
+
+`qiskit.converters.dagdependency_to_dag(dagdependency)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/converters/dagdependency_to_dag.py "view source code")
+
+Build a `DAGCircuit` object from a `DAGDependency`.
+
+**Parameters**
+
+**dependency** (*dag*) – the input dag.
+
+**Returns**
+
+the DAG representing the input circuit.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
diff --git a/docs/api/qiskit/0.46/dagcircuit.md b/docs/api/qiskit/0.46/dagcircuit.md
new file mode 100644
index 00000000000..1df38534736
--- /dev/null
+++ b/docs/api/qiskit/0.46/dagcircuit.md
@@ -0,0 +1,54 @@
+---
+title: dagcircuit
+description: API reference for qiskit.dagcircuit
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.dagcircuit
+---
+
+
+
+
+
+
+
+# DAG Circuits
+
+
+
+`qiskit.dagcircuit`
+
+## Circuits as Directed Acyclic Graphs
+
+| | |
+| ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
+| [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")() | Quantum circuit as a directed acyclic graph. |
+| [`DAGNode`](qiskit.dagcircuit.DAGNode "qiskit.dagcircuit.DAGNode")(\[nid]) | Parent class for DAGOpNode, DAGInNode, and DAGOutNode. |
+| [`DAGOpNode`](qiskit.dagcircuit.DAGOpNode "qiskit.dagcircuit.DAGOpNode")(op\[, qargs, cargs, dag]) | Object to represent an Instruction at a node in the DAGCircuit. |
+| [`DAGInNode`](qiskit.dagcircuit.DAGInNode "qiskit.dagcircuit.DAGInNode")(wire) | Object to represent an incoming wire node in the DAGCircuit. |
+| [`DAGOutNode`](qiskit.dagcircuit.DAGOutNode "qiskit.dagcircuit.DAGOutNode")(wire) | Object to represent an outgoing wire node in the DAGCircuit. |
+| [`DAGDepNode`](qiskit.dagcircuit.DAGDepNode "qiskit.dagcircuit.DAGDepNode")(\[type, op, name, qargs, cargs, ...]) | Object to represent the information at a node in the DAGDependency(). |
+| [`DAGDependency`](qiskit.dagcircuit.DAGDependency "qiskit.dagcircuit.DAGDependency")() | Object to represent a quantum circuit as a Directed Acyclic Graph (DAG) via operation dependencies (i.e. |
+
+## Exceptions
+
+### DAGCircuitError
+
+
+
+`qiskit.dagcircuit.DAGCircuitError(*msg)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/dagcircuit/exceptions.py "view source code")
+
+Base class for errors raised by the DAGCircuit object.
+
+Set the error message.
+
+### DAGDependencyError
+
+
+
+`qiskit.dagcircuit.DAGDependencyError(*msg)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/dagcircuit/exceptions.py "view source code")
+
+Base class for errors raised by the DAGDependency object.
+
+Set the error message.
+
diff --git a/docs/api/qiskit/0.46/exceptions.md b/docs/api/qiskit/0.46/exceptions.md
new file mode 100644
index 00000000000..983b3da06c8
--- /dev/null
+++ b/docs/api/qiskit/0.46/exceptions.md
@@ -0,0 +1,72 @@
+---
+title: exceptions
+description: API reference for qiskit.exceptions
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.exceptions
+---
+
+
+
+
+
+
+
+# Top-level exceptions
+
+
+
+`qiskit.exceptions`
+
+All Qiskit-related errors raised by Qiskit are subclasses of the base:
+
+### QiskitError
+
+
+
+`qiskit.exceptions.QiskitError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/exceptions.py "view source code")
+
+Base class for errors raised by Qiskit.
+
+Set the error message.
+
+
+ Errors that are just general programming errors, such as incorrect typing, may still raise standard Python errors such as `TypeError`. [`QiskitError`](#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") is generally for errors raised in usage that is particular to Qiskit.
+
+
+Many of the Qiskit subpackages define their own more granular error, to help in catching only the subset of errors you care about. For example, [`qiskit.circuit`](circuit#module-qiskit.circuit "qiskit.circuit") almost exclusively uses [`CircuitError`](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError"), while both [`QASM2ExportError`](qasm2#qiskit.qasm2.QASM2ExportError "qiskit.qasm2.QASM2ExportError") and [`QASM2ParseError`](qasm2#qiskit.qasm2.QASM2ParseError "qiskit.qasm2.QASM2ParseError") derive from [`QASM2Error`](qasm2#qiskit.qasm2.QASM2Error "qiskit.qasm2.QASM2Error") in [`qiskit.qasm2`](qasm2#module-qiskit.qasm2 "qiskit.qasm2"), which is in turn a type of [`QiskitError`](#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError").
+
+Qiskit has several optional features that depend on other packages that are not required for a minimal install. You can read more about those, and ways to check for their presence, in [`qiskit.utils.optionals`](utils#module-qiskit.utils.optionals "qiskit.utils.optionals"). Trying to use a feature that requires an optional extra will raise a particular error, which subclasses both [`QiskitError`](#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") and the Python built-in `ImportError`.
+
+### MissingOptionalLibraryError
+
+
+
+`qiskit.exceptions.MissingOptionalLibraryError(libname, name, pip_install=None, msg=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/exceptions.py "view source code")
+
+Raised when an optional library is missing.
+
+Set the error message. :param libname: Name of missing library :param name: Name of class, function, module that uses this library :param pip\_install: pip install command, if any :param msg: Descriptive message, if any
+
+Two more uncommon errors relate to failures in reading user-configuration files, or specifying a filename that cannot be used:
+
+### QiskitUserConfigError
+
+
+
+`qiskit.exceptions.QiskitUserConfigError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/exceptions.py "view source code")
+
+Raised when an error is encountered reading a user config file.
+
+Set the error message.
+
+### InvalidFileError
+
+
+
+`qiskit.exceptions.InvalidFileError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/exceptions.py "view source code")
+
+Raised when the file provided is not valid for the specific task.
+
+Set the error message.
+
diff --git a/docs/api/qiskit/0.46/execute.md b/docs/api/qiskit/0.46/execute.md
new file mode 100644
index 00000000000..963a49fe490
--- /dev/null
+++ b/docs/api/qiskit/0.46/execute.md
@@ -0,0 +1,183 @@
+---
+title: execute_function
+description: API reference for qiskit.execute_function
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.execute_function
+---
+
+
+
+
+
+
+
+# Executing Experiments
+
+
+
+`qiskit.execute_function`
+
+### execute
+
+
+
+`qiskit.execute_function.execute(experiments, backend, basis_gates=None, coupling_map=None, backend_properties=None, initial_layout=None, seed_transpiler=None, optimization_level=None, pass_manager=None, shots=None, memory=None, seed_simulator=None, default_qubit_los=None, default_meas_los=None, qubit_lo_range=None, meas_lo_range=None, schedule_los=None, meas_level=None, meas_return=None, memory_slots=None, memory_slot_size=None, rep_time=None, rep_delay=None, parameter_binds=None, schedule_circuit=False, inst_map=None, meas_map=None, scheduling_method=None, init_qubits=None, **run_config)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/execute_function.py "view source code")
+
+Execute a list of [`qiskit.circuit.QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") or [`qiskit.pulse.Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") on a backend.
+
+The execution is asynchronous, and a handle to a job instance is returned.
+
+
+ The function `qiskit.execute_function.execute()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. This function combines `transpile` and `backend.run`, which is covered by `Sampler` [`primitives`](primitives#module-qiskit.primitives "qiskit.primitives"). Alternatively, you can also run [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") followed by `backend.run()`.
+
+
+**Parameters**
+
+* **experiments** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*] or* [*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule")*]*) – Circuit(s) or pulse schedule(s) to execute
+
+* **backend** ([*Backend*](qiskit.providers.Backend "qiskit.providers.Backend")) – Backend to execute circuits on. Transpiler options are automatically grabbed from backend.configuration() and backend.properties(). If any other option is explicitly set (e.g. coupling\_map), it will override the backend’s.
+
+* **basis\_gates** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – List of basis gate names to unroll to. e.g: `['u1', 'u2', 'u3', 'cx']`. If `None`, do not unroll.
+
+* **coupling\_map** ([*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) –
+
+ Coupling map (perhaps custom) to target in mapping. Multiple formats are supported:
+
+ 1. [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") instance
+ 2. `list`: must be given as an adjacency matrix, where each entry specifies all two-qubit interactions supported by backend e.g: `[[0, 1], [0, 3], [1, 2], [1, 5], [2, 5], [4, 1], [5, 3]]`
+
+* **backend\_properties** ([*BackendProperties*](qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties")) – Properties returned by a backend, including information on gate errors, readout errors, qubit coherence times, etc. Find a backend that provides this information with: `backend.properties()`
+
+* **initial\_layout** ([*Layout*](qiskit.transpiler.Layout "qiskit.transpiler.Layout") *or*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) –
+
+ Initial position of virtual qubits on physical qubits. If this layout makes the circuit compatible with the coupling\_map constraints, it will be used. The final layout is not guaranteed to be the same, as the transpiler may permute qubits through swaps or other means.
+
+ Multiple formats are supported:
+
+ 1. [`qiskit.transpiler.Layout`](qiskit.transpiler.Layout "qiskit.transpiler.Layout") instance
+
+ 2. `dict`:
+
+ * virtual to physical:
+
+ ```python
+ {qr[0]: 0,
+ qr[1]: 3,
+ qr[2]: 5}
+ ```
+
+ * physical to virtual:
+
+ ```python
+ {0: qr[0],
+ 3: qr[1],
+ 5: qr[2]}
+ ```
+
+ 3. `list`:
+
+ * virtual to physical:
+
+ ```python
+ [0, 3, 5] # virtual qubits are ordered (in addition to named)
+ ```
+
+ * physical to virtual:
+
+ ```python
+ [qr[0], None, None, qr[1], None, qr[2]]
+ ```
+
+* **seed\_transpiler** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Sets random seed for the stochastic parts of the transpiler
+
+* **optimization\_level** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) –
+
+ How much optimization to perform on the circuits. Higher levels generate more optimized circuits, at the expense of longer transpilation time.
+
+ * 0: no optimization
+ * 1: light optimization
+ * 2: heavy optimization
+ * 3: even heavier optimization
+
+ If None, level 1 will be chosen as default.
+
+* **pass\_manager** ([*PassManager*](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager")) – The pass manager to use during transpilation. If this arg is present, auto-selection of pass manager based on the transpile options will be turned off and this pass manager will be used directly.
+
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of repetitions of each circuit, for sampling. Default: 1024
+
+* **memory** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, per-shot measurement bitstrings are returned as well (provided the backend supports it). For OpenPulse jobs, only measurement level 2 supports this option. Default: False
+
+* **seed\_simulator** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Random seed to control sampling, for when backend is a simulator
+
+* **default\_qubit\_los** (*Optional\[List\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]]*) – List of job level qubit drive LO frequencies in Hz. Overridden by `schedule_los` if specified. Must have length `n_qubits`.
+
+* **default\_meas\_los** (*Optional\[List\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]]*) – List of job level measurement LO frequencies in Hz. Overridden by `schedule_los` if specified. Must have length `n_qubits`.
+
+* **qubit\_lo\_range** (*Optional\[List\[List\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]]]*) – List of job level drive LO ranges each of form `[range_min, range_max]` in Hz. Used to validate `qubit_lo_freq`. Must have length `n_qubits`.
+
+* **meas\_lo\_range** (*Optional\[List\[List\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]]]*) – List of job level measurement LO ranges each of form `[range_min, range_max]` in Hz. Used to validate `meas_lo_freq`. Must have length `n_qubits`.
+
+* **schedule\_los** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) –
+
+ Experiment level (ie circuit or schedule) LO frequency configurations for qubit drive and measurement channels. These values override the job level values from `default_qubit_los` and `default_meas_los`. Frequencies are in Hz. Settable for qasm and pulse jobs.
+
+ If a single LO config or dict is used, the values are set at job level. If a list is used, the list must be the size of the number of experiments in the job, except in the case of a single experiment. In this case, a frequency sweep will be assumed and one experiment will be created for every list entry.
+
+ Not every channel is required to be specified. If not specified, the backend default value will be used.
+
+* **meas\_level** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or MeasLevel*) – Set the appropriate level of the measurement output for pulse experiments.
+
+* **meas\_return** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or MeasReturn*) – Level of measurement data for the backend to return For `meas_level` 0 and 1: `"single"` returns information from every shot. `"avg"` returns average measurement output (averaged over number of shots).
+
+* **memory\_slots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of classical memory slots used in this job.
+
+* **memory\_slot\_size** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Size of each memory slot if the output is Level 0.
+
+* **rep\_time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time per program execution in seconds. Must be from the list provided by the backend (`backend.configuration().rep_times`). Defaults to the first entry.
+
+* **rep\_delay** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Delay between programs in seconds. Only supported on certain backends (`backend.configuration().dynamic_reprate_enabled` ). If supported, `rep_delay` will be used instead of `rep_time` and must be from the range supplied by the backend (`backend.configuration().rep_delay_range`). Default is given by `backend.configuration().default_rep_delay`.
+
+* **parameter\_binds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*]*) – List of Parameter bindings over which the set of experiments will be executed. Each list element (bind) should be of the form `{Parameter1: value1, Parameter2: value2, ...}`. All binds will be executed across all experiments, e.g. if parameter\_binds is a length-$n$ list, and there are $m$ experiments, a total of $m \times n$ experiments will be run (one for each experiment/bind pair).
+
+* **schedule\_circuit** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If `True`, `experiments` will be converted to [`qiskit.pulse.Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects prior to execution.
+
+* **inst\_map** ([*InstructionScheduleMap*](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap")) – Mapping of circuit operations to pulse schedules. If None, defaults to the `instruction_schedule_map` of `backend`.
+
+* **meas\_map** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*(*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*(*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*))*) – List of sets of qubits that must be measured together. If None, defaults to the `meas_map` of `backend`.
+
+* **scheduling\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*(*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*)*) – Optionally specify a particular scheduling method.
+
+* **init\_qubits** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to reset the qubits to the ground state for each shot. Default: `True`.
+
+* **run\_config** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – Extra arguments used to configure the run (e.g. for Aer configurable backends). Refer to the backend documentation for details on these arguments. Note: for now, these keyword arguments will both be copied to the Qobj config, and passed to backend.run()
+
+**Returns**
+
+returns job instance derived from Job
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the execution cannot be interpreted as either circuits or schedules
+
+**Example**
+
+Construct a 5-qubit GHZ circuit and execute 4321 shots on a backend.
+
+```python
+from qiskit import QuantumCircuit, execute, BasicAer
+
+backend = BasicAer.get_backend('qasm_simulator')
+
+qc = QuantumCircuit(5, 5)
+qc.h(0)
+qc.cx(0, range(1, 5))
+qc.measure_all()
+
+job = execute(qc, backend, shots=4321)
+```
+
diff --git a/docs/api/qiskit/0.46/extensions.md b/docs/api/qiskit/0.46/extensions.md
new file mode 100644
index 00000000000..edc82a15983
--- /dev/null
+++ b/docs/api/qiskit/0.46/extensions.md
@@ -0,0 +1,50 @@
+---
+title: extensions
+description: API reference for qiskit.extensions
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.extensions
+---
+
+
+
+
+
+
+
+# Quantum Circuit Extensions
+
+
+
+`qiskit.extensions`
+
+## Unitary Extensions
+
+| | |
+| ---------------------------------------------------------------------------------------------------------------------------------- | --------------------- |
+| [`SingleQubitUnitary`](qiskit.extensions.SingleQubitUnitary "qiskit.extensions.SingleQubitUnitary")(unitary\_matrix\[, mode, ...]) | Single-qubit unitary. |
+
+## Simulator Extensions
+
+| | |
+| ----------------------------------------------------------------------------------------------------------------- | ------------------------------- |
+| [`Snapshot`](qiskit.extensions.Snapshot "qiskit.extensions.Snapshot")(label\[, snapshot\_type, num\_qubits, ...]) | Simulator snapshot instruction. |
+
+## Exceptions
+
+The additional gates in this module will tend to raise a custom exception when they encounter problems.
+
+### ExtensionError
+
+
+
+`qiskit.extensions.ExtensionError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/extensions/exceptions.py "view source code")
+
+Base class for errors raised by extensions module.
+
+Set the error message.
+
+
+ The class `qiskit.extensions.exceptions.ExtensionError` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release.
+
+
diff --git a/docs/api/qiskit/0.46/index.md b/docs/api/qiskit/0.46/index.md
new file mode 100644
index 00000000000..bf7f3e9df70
--- /dev/null
+++ b/docs/api/qiskit/0.46/index.md
@@ -0,0 +1,64 @@
+---
+title: qiskit
+description: API reference for qiskit
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit
+---
+
+
+
+# API Reference
+
+* [Quantum Circuits (`qiskit.circuit`)](circuit)
+* [Circuit Library (`qiskit.circuit.library`)](circuit_library)
+* [Classical expressions (`qiskit.circuit.classical`)](circuit_classical)
+* [Singleton instructions (`qiskit.circuit.singleton`)](circuit_singleton)
+* [Compilation Routines (`qiskit.compiler`)](compiler)
+* [Executing Experiments (`qiskit.execute_function`)](execute)
+* [Visualizations (`qiskit.visualization`)](visualization)
+* [ClassicalFunction compiler (`qiskit.circuit.classicalfunction`)](classicalfunction)
+* [Circuit Converters (`qiskit.converters`)](converters)
+* [Circuit and Schedule Assembler (`qiskit.assembler`)](assembler)
+* [DAG Circuits (`qiskit.dagcircuit`)](dagcircuit)
+* [Quantum Circuit Extensions (`qiskit.extensions`)](extensions)
+* [Passmanager (`qiskit.passmanager`)](passmanager)
+* [Providers Interface (`qiskit.providers`)](providers)
+* [Writing a New Provider](providers#writing-a-new-provider)
+* [Migrating between Backend API Versions](providers#migrating-between-backend-api-versions)
+* [BasicAer: Python-based Simulators (`qiskit.providers.basicaer`)](providers_basicaer)
+* [BasicProvider: Python-based Simulators (`qiskit.providers.basic_provider`)](providers_basic_provider)
+* [Fake Provider (`qiskit.providers.fake_provider`)](providers_fake_provider)
+* [Backend Objects (`qiskit.providers.models`)](providers_models)
+* [Pulse (`qiskit.pulse`)](pulse)
+* [Circuit Scheduler (`qiskit.scheduler`)](scheduler)
+* [Circuit Synthesis (`qiskit.synthesis`)](synthesis)
+* [Primitives (`qiskit.primitives`)](primitives)
+* [OpenQASM 2 (`qiskit.qasm2`)](qasm2)
+* [OpenQASM 3 (`qiskit.qasm3`)](qasm3)
+* [Qasm (`qiskit.qasm`)](qasm)
+* [Qobj (`qiskit.qobj`)](qobj)
+* [QPY serialization (`qiskit.qpy`)](qpy)
+* [Quantum Information (`qiskit.quantum_info`)](quantum_info)
+* [Experiment Results (`qiskit.result`)](result)
+* [Qiskit Tools (`qiskit.tools`)](tools)
+* [Jupyter Tools (`qiskit.tools.jupyter`)](tools_jupyter)
+* [Transpiler (`qiskit.transpiler`)](transpiler)
+* [Transpiler Passes (`qiskit.transpiler.passes`)](transpiler_passes)
+* [Preset Passmanagers (`qiskit.transpiler.preset_passmanagers`)](transpiler_preset)
+* [Transpiler Stage Plugin Interface (`qiskit.transpiler.preset_passmanagers.plugin`)](transpiler_plugins)
+* [Synthesis Plugins (`qiskit.transpiler.passes.synthesis.plugin`)](transpiler_synthesis_plugins)
+* [Built-in Transpiler Synthesis Plugins](transpiler_builtin_plugins)
+* [Utilities (`qiskit.utils`)](utils)
+* [Measurement Mitigation Utils (`qiskit.utils.mitigation`)](utils_mitigation)
+* [Top-level exceptions (`qiskit.exceptions`)](exceptions)
+
+## Deprecated Modules
+
+
+ These modules are going to be removed in Qiskit 1.0. Consider pinning `qiskit~=0.45` in your dependencies if you need them.
+
+
+* [Algorithms (`qiskit.algorithms`)](algorithms)
+* [Operators (`qiskit.opflow`)](opflow)
+
diff --git a/docs/api/qiskit/0.46/opflow.md b/docs/api/qiskit/0.46/opflow.md
new file mode 100644
index 00000000000..b4f9e0a0651
--- /dev/null
+++ b/docs/api/qiskit/0.46/opflow.md
@@ -0,0 +1,214 @@
+---
+title: opflow
+description: API reference for qiskit.opflow
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.opflow
+---
+
+
+
+
+
+
+
+# Operators
+
+
+
+`qiskit.opflow`
+
+
+ The [`qiskit.opflow`](#module-qiskit.opflow "qiskit.opflow") module is deprecated and will be removed no earlier than 3 months after the release date. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+Operators and State functions are the building blocks of Quantum Algorithms.
+
+A library for Quantum Algorithms & Applications is more than a collection of algorithms wrapped in Python functions. It needs to provide tools to make writing algorithms simple and easy. This is the layer of modules between the circuits and algorithms, providing the language and computational primitives for QA\&A research.
+
+We call this layer the Operator Flow. It works by unifying computation with theory through the common language of functions and operators, in a way which preserves physical intuition and programming freedom. In the Operator Flow, we construct functions over binary variables, manipulate those functions with operators, and evaluate properties of these functions with measurements.
+
+The Operator Flow is meant to serve as a lingua franca between the theory and implementation of Quantum Algorithms & Applications. Meaning, the ultimate goal is that when theorists speak their theory in the Operator Flow, they are speaking valid implementation, and when the engineers speak their implementation in the Operator Flow, they are speaking valid physical formalism. To be successful, it must be fast and physically formal enough for theorists to find it easier and more natural than hacking Matlab or NumPy, and the engineers must find it straightforward enough that they can learn it as a typical software library, and learn the physics naturally and effortlessly as they learn the code. There can never be a point where we say “below this level this is all hacked out, don’t come down here, stay in the interface layer above.” It all must be clear and learnable.
+
+Before getting into the details of the code, it’s important to note that three mathematical concepts unpin the Operator Flow. We derive most of the inspiration for the code structure from [John Watrous’s formalism](https://cs.uwaterloo.ca/~watrous/TQI/) (but do not follow it exactly), so it may be worthwhile to review Chapters I and II, which are free online, if you feel the concepts are not clicking.
+
+1\. An n-qubit State function is a complex function over n binary variables, which we will often refer to as *n-qubit binary strings*. For example, the traditional quantum “zero state” is a 1-qubit state function, with a definition of f(0) = 1 and f(1) = 0.
+
+2\. An n-qubit Operator is a linear function taking n-qubit state functions to n-qubit state functions. For example, the Pauli X Operator is defined by f(Zero) = One and f(One) = Zero. Equivalently, an Operator can be defined as a complex function over two n-qubit binary strings, and it is sometimes convenient to picture things this way. By this definition, our Pauli X can be defined by its typical matrix elements, f(0, 0) = 0, f(1, 0) = 1, f(0, 1) = 1, f(1, 1) = 0.
+
+3\. An n-qubit Measurement is a functional taking n-qubit State functions to complex values. For example, a Pauli Z Measurement can be defined by f(Zero) = 0 and f(One) = 1.
+
+
+ While every effort has been made to make programming the Operator Flow similar to mathematical notation, in some places our hands are tied by the design of Python. In particular, when using mathematical operators such as `+` and `^` (tensor product), beware that these follow [Python operator precedence rules](https://docs.python.org/3/reference/expressions.html#operator-precedence). For example, `I^X + X^I` will actually be interpreted as `I ^ (X+X) ^ I == 2 * I^X^I`. In these cases, you should use extra parentheses, like `(I ^ X) + (X ^ I)`, or use the relevant method calls.
+
+
+Below, you’ll find a base class for all Operators, some convenience immutable global variables which simplify Operator construction, and two groups of submodules: Operators and Converters.
+
+## Operator Base Class
+
+The OperatorBase serves as the base class for all Operators, State functions and measurements, and enforces the presence and consistency of methods to manipulate these objects conveniently.
+
+| | |
+| --------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
+| [`OperatorBase`](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")() | Deprecated: A base class for all Operators: PrimitiveOps, StateFns, ListOps, etc. |
+
+
+
+## Operator Globals
+
+The `operator_globals` is a set of immutable Operator instances that are convenient building blocks to reach for while working with the Operator flow.
+
+**One qubit Pauli operators:**
+
+`X`, `Y`, `Z`, `I`
+
+**Clifford+T, and some other common non-parameterized gates:**
+
+`CX`, `S`, `H`, `T`, `Swap`, `CZ`
+
+**One qubit states:**
+
+`Zero`, `One`, `Plus`, `Minus`
+
+## Submodules
+
+### Operators
+
+The Operators submodules include the PrimitiveOp, ListOp, and StateFn class groups which represent the primary Operator modules.
+
+| | |
+| --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
+| [`primitive_ops`](qiskit.opflow.primitive_ops#module-qiskit.opflow.primitive_ops "qiskit.opflow.primitive_ops") | Primitive Operators (qiskit.opflow\.primitive\_ops) |
+| [`list_ops`](qiskit.opflow.list_ops#module-qiskit.opflow.list_ops "qiskit.opflow.list_ops") | List Operators (qiskit.opflow\.list\_ops) |
+| [`state_fns`](qiskit.opflow.state_fns#module-qiskit.opflow.state_fns "qiskit.opflow.state_fns") | State Functions (qiskit.opflow\.state\_fns) |
+
+### Converters
+
+The Converter submodules include objects which manipulate Operators, usually recursing over an Operator structure and changing certain Operators’ representation. For example, the [`PauliExpectation`](qiskit.opflow.expectations.PauliExpectation "qiskit.opflow.expectations.PauliExpectation") traverses an Operator structure, and replaces all of the [`OperatorStateFn`](qiskit.opflow.state_fns.OperatorStateFn "qiskit.opflow.state_fns.OperatorStateFn") measurements containing non-diagonal Pauli terms into diagonalizing circuits following by [`OperatorStateFn`](qiskit.opflow.state_fns.OperatorStateFn "qiskit.opflow.state_fns.OperatorStateFn") measurement containing only diagonal Paulis.
+
+| | |
+| ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
+| [`converters`](qiskit.opflow.converters#module-qiskit.opflow.converters "qiskit.opflow.converters") | Converters (qiskit.opflow\.converters) |
+| [`evolutions`](qiskit.opflow.evolutions#module-qiskit.opflow.evolutions "qiskit.opflow.evolutions") | Operator Evolutions (qiskit.opflow\.evolutions) |
+| [`expectations`](qiskit.opflow.expectations#module-qiskit.opflow.expectations "qiskit.opflow.expectations") | Expectations (qiskit.opflow\.expectations) |
+| [`gradients`](qiskit.opflow.gradients#module-qiskit.opflow.gradients "qiskit.opflow.gradients") | Gradients (qiskit.opflow\.gradients) |
+
+## Utility functions
+
+### commutator
+
+
+
+`qiskit.opflow.commutator(op_a, op_b)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/utils.py "view source code")
+
+Deprecated: Compute commutator of op\_a and op\_b.
+
+$$
+AB - BA.
+$$
+
+
+ The function `qiskit.opflow.utils.commutator()` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **op\_a** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – Operator A
+* **op\_b** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – Operator B
+
+**Returns**
+
+the commutator
+
+**Return type**
+
+[OperatorBase](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")
+
+### anti\_commutator
+
+
+
+`qiskit.opflow.anti_commutator(op_a, op_b)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/utils.py "view source code")
+
+Deprecated: Compute anti-commutator of op\_a and op\_b.
+
+$$
+AB + BA.
+$$
+
+
+ The function `qiskit.opflow.utils.anti_commutator()` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **op\_a** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – Operator A
+* **op\_b** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – Operator B
+
+**Returns**
+
+the anti-commutator
+
+**Return type**
+
+[OperatorBase](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")
+
+### double\_commutator
+
+
+
+`qiskit.opflow.double_commutator(op_a, op_b, op_c, sign=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/utils.py "view source code")
+
+Deprecated: Compute symmetric double commutator of op\_a, op\_b and op\_c. See McWeeny chapter 13.6 Equation of motion methods (page 479)
+
+If sign is False, it returns
+
+$$
+[[A, B], C]/2 + [A, [B, C]]/2
+= (2ABC + 2CBA - BAC - CAB - ACB - BCA)/2.
+$$
+
+If sign is True, it returns
+
+$$
+\lbrace[A, B], C\rbrace/2 + \lbrace A, [B, C]\rbrace/2
+= (2ABC - 2CBA - BAC + CAB - ACB + BCA)/2.
+
+
+$$
+
+
+ The function `qiskit.opflow.utils.double_commutator()` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **op\_a** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – Operator A
+* **op\_b** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – Operator B
+* **op\_c** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – Operator C
+* **sign** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – False anti-commutes, True commutes
+
+**Returns**
+
+the double commutator
+
+**Return type**
+
+[OperatorBase](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")
+
+## Exceptions
+
+### OpflowError
+
+
+
+`qiskit.opflow.OpflowError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/exceptions.py "view source code")
+
+Deprecated: For Opflow specific errors.
+
+Set the error message.
+
+
+ The class `qiskit.opflow.exceptions.OpflowError` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
diff --git a/docs/api/qiskit/0.46/passmanager.md b/docs/api/qiskit/0.46/passmanager.md
new file mode 100644
index 00000000000..d50b5df0a65
--- /dev/null
+++ b/docs/api/qiskit/0.46/passmanager.md
@@ -0,0 +1,173 @@
+---
+title: passmanager
+description: API reference for qiskit.passmanager
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.passmanager
+---
+
+
+
+
+
+
+
+# Passmanager
+
+
+
+`qiskit.passmanager`
+
+## Overview
+
+The Qiskit pass manager is somewhat inspired by the [LLVM compiler](https://llvm.org/), but it is designed to take a Python object as an input instead of plain source code.
+
+The pass manager converts the input Python object into an intermediate representation (IR), and it can be optimized and get lowered with a variety of transformations over multiple passes. The pass manager framework may employ multiple IRs with interleaved conversion passes, depending on the context of the optimization.
+
+
+ Currently there is no actual use/design of multiple IRs in the builtin Qiskit pass managers. The implementation of the `passmanager` module is agnostic to actual IR types (i.e. no strict type check is performed), and the pass manager works as long as the IR implements all methods required by subsequent passes. A concrete design for the use of multiple IRs might be provided in the future release.
+
+
+The passes may consume the hardware constraints that the Qiskit backend may provide. Finally, the IR is converted back to some Python object. Note that the input type and output type are not necessarily the same.
+
+Compilation in the pass manager is a chain of `Task` executions that take an IR and output a new IR with some optimization or data analysis. An atomic task is a *pass* which is a subclass of [`GenericPass`](qiskit.passmanager.GenericPass "qiskit.passmanager.GenericPass") that implements a `run()` method that performs some work on the received IR. A set of passes may form a *flow controller*, which is a subclass of [`BaseController`](qiskit.passmanager.BaseController "qiskit.passmanager.BaseController"), which can implement arbitrary compilation-state-dependent logic for deciding which pass will get run next. Passes share intermediate data via the [`PropertySet`](qiskit.passmanager.PropertySet "qiskit.passmanager.PropertySet") object which is a free-form dictionary. A pass can populate the property set dictionary during the task execution. A flow controller can also consume the property set to control the pass execution, but this access must be read-only. The property set is portable and handed over from pass to pass at execution. In addition to the property set, tasks also receive a [`WorkflowStatus`](qiskit.passmanager.WorkflowStatus "qiskit.passmanager.WorkflowStatus") data structure. This object is initialized when the pass manager is run and handed over to underlying tasks. The status is updated after every pass is run, and contains information about the pipeline state (number of passes run, failure state, and so on) as opposed to the [`PropertySet`](qiskit.passmanager.PropertySet "qiskit.passmanager.PropertySet"), which contains information about the IR being optimized.
+
+A pass manager is a wrapper of the flow controller, with responsibilities of
+
+* Scheduling optimization tasks,
+* Converting an input Python object to a particular Qiskit IR,
+* Initializing a property set and workflow status,
+* Running scheduled tasks to apply a series of transformations to the IR,
+* Converting the IR back to an output Python object.
+
+This indicates that the flow controller itself is type-agnostic, and a developer must implement a subclass of the [`BasePassManager`](qiskit.passmanager.BasePassManager "qiskit.passmanager.BasePassManager") to manage the data conversion steps. This *veil of ignorance* allows us to choose the most efficient data representation for a particular pass manager task, while we can reuse the flow control machinery for different input and output types.
+
+A single flow controller always takes a single IR object, and returns a single IR object. Parallelism for multiple input objects is supported by the [`BasePassManager`](qiskit.passmanager.BasePassManager "qiskit.passmanager.BasePassManager") by broadcasting the flow controller via the `qiskit.tools.parallel_map()` function.
+
+## Examples
+
+We look into a toy optimization task, namely, preparing a row of numbers and remove a digit if the number is five. Such task might be easily done by converting the input numbers into string. We use the pass manager framework here, putting the efficiency aside for a moment to learn how to build a custom Qiskit compiler.
+
+```python
+from qiskit.passmanager import BasePassManager, GenericPass, ConditionalController
+
+class ToyPassManager(BasePassManager):
+
+ def _passmanager_frontend(self, input_program: int, **kwargs) -> str:
+ return str(input_program)
+
+ def _passmanager_backend(self, passmanager_ir: str, in_program: int, **kwargs) -> int:
+ return int(passmanager_ir)
+```
+
+This pass manager inputs and outputs an integer number, while performing the optimization tasks on a string data. Hence, input, IR, output type are integer, string, integer, respectively. The `_passmanager_frontend()` method defines the conversion from the input data to IR, and `_passmanager_backend()` defines the conversion from the IR to output data. The pass manager backend is also given an `in_program` parameter that contains the original `input_program` to the front end, for referencing any original metadata of the input program for the final conversion.
+
+Next, we implement a pass that removes a digit when the number is five.
+
+```python
+class RemoveFive(GenericPass):
+
+ def run(self, passmanager_ir: str):
+ return passmanager_ir.replace("5", "")
+
+task = RemoveFive()
+```
+
+Finally, we instantiate a pass manager and schedule the task with it. Running the pass manager with random row of numbers returns new numbers that don’t contain five.
+
+```python
+pm = ToyPassManager()
+pm.append(task)
+
+pm.run([123456789, 45654, 36785554])
+```
+
+Output:
+
+```python
+[12346789, 464, 36784]
+```
+
+Now we consider the case of conditional execution. We avoid execution of the “remove five” task when the input number is six digits or less. Such control can be implemented by a flow controller. We start from an analysis pass that provides the flow controller with information about the number of digits.
+
+```python
+class CountDigits(GenericPass):
+
+ def run(self, passmanager_ir: str):
+ self.property_set["ndigits"] = len(passmanager_ir)
+
+analysis_task = CountDigits()
+```
+
+Then, we wrap the remove five task with the [`ConditionalController`](qiskit.passmanager.ConditionalController "qiskit.passmanager.ConditionalController") that runs the stored tasks only when the condition is met.
+
+```python
+def digit_condition(property_set):
+ # Return True when condition is met.
+ return property_set["ndigits"] > 6
+
+conditional_task = ConditionalController(
+ tasks=[RemoveFive()],
+ condition=digit_condition,
+)
+```
+
+As before, we schedule these passes with the pass manager and run.
+
+```python
+pm = ToyPassManager()
+pm.append(analysis_task)
+pm.append(conditional_task)
+
+pm.run([123456789, 45654, 36785554])
+```
+
+Output:
+
+```python
+[12346789, 45654, 36784]
+```
+
+The “remove five” task is triggered only for the first and third input values, which have more than six digits.
+
+With the pass manager framework, a developer can flexibly customize the optimization task by combining multiple passes and flow controllers. See details for following class API documentations.
+
+## Interface
+
+### Base classes
+
+| | |
+| ---------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- |
+| [`BasePassManager`](qiskit.passmanager.BasePassManager "qiskit.passmanager.BasePassManager")(\[tasks, max\_iteration]) | Pass manager base class. |
+| [`BaseController`](qiskit.passmanager.BaseController "qiskit.passmanager.BaseController")(\[options]) | Base class of controller. |
+| [`GenericPass`](qiskit.passmanager.GenericPass "qiskit.passmanager.GenericPass")() | Base class of a single pass manager task. |
+
+### Flow controllers
+
+| | |
+| ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| [`FlowController`](qiskit.passmanager.FlowController "qiskit.passmanager.FlowController")(\[options]) | A legacy factory for other flow controllers. |
+| [`FlowControllerLinear`](qiskit.passmanager.FlowControllerLinear "qiskit.passmanager.FlowControllerLinear")(\[tasks, options]) | A standard flow controller that runs tasks one after the other. |
+| [`ConditionalController`](qiskit.passmanager.ConditionalController "qiskit.passmanager.ConditionalController")(\[tasks, condition, ...]) | A flow controller runs the pipeline once if the condition is true, or does nothing if the condition is false. |
+| [`DoWhileController`](qiskit.passmanager.DoWhileController "qiskit.passmanager.DoWhileController")(\[tasks, do\_while, options]) | Run the given tasks in a loop until the `do_while` condition on the property set becomes `False`. |
+
+### Compilation state
+
+| | |
+| -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
+| [`PropertySet`](qiskit.passmanager.PropertySet "qiskit.passmanager.PropertySet") | A default dictionary-like object. |
+| [`WorkflowStatus`](qiskit.passmanager.WorkflowStatus "qiskit.passmanager.WorkflowStatus")(\[count, completed\_passes, ...]) | Collection of compilation status of workflow, i.e. pass manager run. |
+| [`PassManagerState`](qiskit.passmanager.PassManagerState "qiskit.passmanager.PassManagerState")(workflow\_status, property\_set) | A portable container object that pass manager tasks communicate through generator. |
+
+### Exceptions
+
+### PassManagerError
+
+
+
+`qiskit.passmanager.PassManagerError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/passmanager/exceptions.py "view source code")
+
+Pass manager error.
+
+Set the error message.
+
diff --git a/docs/api/qiskit/0.46/primitives.md b/docs/api/qiskit/0.46/primitives.md
new file mode 100644
index 00000000000..dc91d1f7812
--- /dev/null
+++ b/docs/api/qiskit/0.46/primitives.md
@@ -0,0 +1,146 @@
+---
+title: primitives
+description: API reference for qiskit.primitives
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.primitives
+---
+
+
+
+
+
+
+
+
+
+# Primitives
+
+
+
+`qiskit.primitives`
+
+## Overview of Estimator
+
+Estimator class estimates expectation values of quantum circuits and observables.
+
+An estimator is initialized with an empty parameter set. The estimator is used to create a [`JobV1`](qiskit.providers.JobV1 "qiskit.providers.JobV1"), via the [`qiskit.primitives.Estimator.run()`](qiskit.primitives.Estimator#run "qiskit.primitives.Estimator.run") method. This method is called with the following parameters
+
+* quantum circuits ($\psi_i(\theta)$): list of (parameterized) quantum circuits (a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") objects).
+* observables ($H_j$): a list of [`SparsePauliOp`](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp") objects.
+* parameter values ($\theta_k$): list of sets of values to be bound to the parameters of the quantum circuits (list of list of float).
+
+The method returns a [`JobV1`](qiskit.providers.JobV1 "qiskit.providers.JobV1") object, calling [`qiskit.providers.JobV1.result()`](qiskit.providers.JobV1#result "qiskit.providers.JobV1.result") yields the a list of expectation values plus optional metadata like confidence intervals for the estimation.
+
+$$
+\langle\psi_i(\theta_k)|H_j|\psi_i(\theta_k)\rangle
+$$
+
+Here is an example of how the estimator is used.
+
+```python
+from qiskit.primitives import Estimator
+from qiskit.circuit.library import RealAmplitudes
+from qiskit.quantum_info import SparsePauliOp
+
+psi1 = RealAmplitudes(num_qubits=2, reps=2)
+psi2 = RealAmplitudes(num_qubits=2, reps=3)
+
+H1 = SparsePauliOp.from_list([("II", 1), ("IZ", 2), ("XI", 3)])
+H2 = SparsePauliOp.from_list([("IZ", 1)])
+H3 = SparsePauliOp.from_list([("ZI", 1), ("ZZ", 1)])
+
+theta1 = [0, 1, 1, 2, 3, 5]
+theta2 = [0, 1, 1, 2, 3, 5, 8, 13]
+theta3 = [1, 2, 3, 4, 5, 6]
+
+estimator = Estimator()
+
+# calculate [ ]
+job = estimator.run([psi1], [H1], [theta1])
+job_result = job.result() # It will block until the job finishes.
+print(f"The primitive-job finished with result {job_result}"))
+
+# calculate [ ,
+# ,
+# ]
+job2 = estimator.run([psi1, psi2, psi1], [H1, H2, H3], [theta1, theta2, theta3])
+job_result = job2.result()
+print(f"The primitive-job finished with result {job_result}")
+```
+
+
+
+## Overview of Sampler
+
+Sampler class calculates probabilities or quasi-probabilities of bitstrings from quantum circuits.
+
+A sampler is initialized with an empty parameter set. The sampler is used to create a [`JobV1`](qiskit.providers.JobV1 "qiskit.providers.JobV1"), via the [`qiskit.primitives.Sampler.run()`](qiskit.primitives.Sampler#run "qiskit.primitives.Sampler.run") method. This method is called with the following parameters
+
+* quantum circuits ($\psi_i(\theta)$): list of (parameterized) quantum circuits. (a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") objects)
+* parameter values ($\theta_k$): list of sets of parameter values to be bound to the parameters of the quantum circuits. (list of list of float)
+
+The method returns a [`JobV1`](qiskit.providers.JobV1 "qiskit.providers.JobV1") object, calling [`qiskit.providers.JobV1.result()`](qiskit.providers.JobV1#result "qiskit.providers.JobV1.result") yields a [`SamplerResult`](qiskit.primitives.SamplerResult "qiskit.primitives.SamplerResult") object, which contains probabilities or quasi-probabilities of bitstrings, plus optional metadata like error bars in the samples.
+
+Here is an example of how sampler is used.
+
+```python
+from qiskit.primitives import Sampler
+from qiskit import QuantumCircuit
+from qiskit.circuit.library import RealAmplitudes
+
+# a Bell circuit
+bell = QuantumCircuit(2)
+bell.h(0)
+bell.cx(0, 1)
+bell.measure_all()
+
+# two parameterized circuits
+pqc = RealAmplitudes(num_qubits=2, reps=2)
+pqc.measure_all()
+pqc2 = RealAmplitudes(num_qubits=2, reps=3)
+pqc2.measure_all()
+
+theta1 = [0, 1, 1, 2, 3, 5]
+theta2 = [0, 1, 2, 3, 4, 5, 6, 7]
+
+# initialization of the sampler
+sampler = Sampler()
+
+# Sampler runs a job on the Bell circuit
+job = sampler.run(circuits=[bell], parameter_values=[[]], parameters=[[]])
+job_result = job.result()
+print([q.binary_probabilities() for q in job_result.quasi_dists])
+
+# Sampler runs a job on the parameterized circuits
+job2 = sampler.run(
+ circuits=[pqc, pqc2],
+ parameter_values=[theta1, theta2],
+ parameters=[pqc.parameters, pqc2.parameters])
+job_result = job2.result()
+print([q.binary_probabilities() for q in job_result.quasi_dists])
+```
+
+## Estimator
+
+| | |
+| ----------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
+| [`BaseEstimator`](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator")(\*\[, options]) | Estimator base class. |
+| [`Estimator`](qiskit.primitives.Estimator "qiskit.primitives.Estimator")(\*\[, options]) | Reference implementation of [`BaseEstimator`](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator"). |
+| [`BackendEstimator`](qiskit.primitives.BackendEstimator "qiskit.primitives.BackendEstimator")(backend\[, options, ...]) | Evaluates expectation value using Pauli rotation gates. |
+
+## Sampler
+
+| | |
+| ----------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`BaseSampler`](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler")(\*\[, options]) | Sampler base class |
+| [`Sampler`](qiskit.primitives.Sampler "qiskit.primitives.Sampler")(\*\[, options]) | Sampler class. |
+| [`BackendSampler`](qiskit.primitives.BackendSampler "qiskit.primitives.BackendSampler")(backend\[, options, ...]) | A [`BaseSampler`](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler") implementation that provides an interface for leveraging the sampler interface from any backend. |
+
+## Results
+
+| | |
+| ------------------------------------------------------------------------------------------------------------ | -------------------- |
+| [`EstimatorResult`](qiskit.primitives.EstimatorResult "qiskit.primitives.EstimatorResult")(values, metadata) | Result of Estimator. |
+| [`SamplerResult`](qiskit.primitives.SamplerResult "qiskit.primitives.SamplerResult")(quasi\_dists, metadata) | Result of Sampler. |
+
diff --git a/docs/api/qiskit/0.46/providers.md b/docs/api/qiskit/0.46/providers.md
new file mode 100644
index 00000000000..eeee0fc05fb
--- /dev/null
+++ b/docs/api/qiskit/0.46/providers.md
@@ -0,0 +1,509 @@
+---
+title: providers
+description: API reference for qiskit.providers
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.providers
+---
+
+
+
+
+
+
+
+# Providers Interface
+
+
+
+`qiskit.providers`
+
+This module contains the classes used to build external providers for Terra. A provider is anything that provides an external service to Terra. The typical example of this is a Backend provider which provides [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") objects which can be used for executing [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") and/or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects. This module contains the abstract classes which are used to define the interface between a provider and terra.
+
+## Version Support
+
+Each providers interface abstract class is individually versioned. When we need to make a change to an interface a new abstract class will be created to define the new interface. These interface changes are not guaranteed to be backwards compatible between versions.
+
+### Version Changes
+
+Each minor version release of qiskit-terra **may** increment the version of any providers interface a single version number. It will be an aggregate of all the interface changes for that release on that interface.
+
+### Version Support Policy
+
+To enable providers to have time to adjust to changes in this interface Terra will support multiple versions of each class at once. Given the nature of one version per release the version deprecation policy is a bit more conservative than the standard deprecation policy. Terra will support a provider interface version for a minimum of 3 minor releases or the first release after 6 months from the release that introduced a version, whichever is longer, prior to a potential deprecation. After that the standard deprecation policy will apply to that interface version. This will give providers and users sufficient time to adapt to potential breaking changes in the interface. So for example lets say in 0.19.0 `BackendV2` is introduced and in the 3 months after the release of 0.19.0 we release 0.20.0, 0.21.0, and 0.22.0, then 7 months after 0.19.0 we release 0.23.0. In 0.23.0 we can deprecate BackendV2, and it needs to still be supported and can’t be removed until the deprecation policy completes.
+
+It’s worth pointing out that Terra’s version support policy doesn’t mean providers themselves will have the same support story, they can (and arguably should) update to newer versions as soon as they can, the support window is just for Terra’s supported versions. Part of this lengthy window prior to deprecation is to give providers enough time to do their own deprecation of a potential end user impacting change in a user facing part of the interface prior to bumping their version. For example, let’s say we changed the signature to `Backend.run()` in `BackendV34` in a backwards incompatible way. Before Aer could update its [`AerSimulator`](https://qiskit.org/ecosystem/aer/stubs/qiskit_aer.AerSimulator.html#qiskit_aer.AerSimulator "(in Qiskit Aer v0.13.1)") class to be based on version 34 they’d need to deprecate the old signature prior to switching over. The changeover for Aer is not guaranteed to be lockstep with Terra so we need to ensure there is a sufficient amount of time for Aer to complete its deprecation cycle prior to removing version 33 (ie making version 34 mandatory/the minimum version).
+
+## Abstract Classes
+
+### Provider
+
+| | |
+| --------------------------------------------------------------------------- | ------------------------------------------------------------- |
+| [`Provider`](qiskit.providers.Provider "qiskit.providers.Provider")() | Base common type for all versioned Provider abstract classes. |
+| [`ProviderV1`](qiskit.providers.ProviderV1 "qiskit.providers.ProviderV1")() | Base class for a Backend Provider. |
+
+### Backend
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend")() | Base common type for all versioned Backend abstract classes. |
+| [`BackendV1`](qiskit.providers.BackendV1 "qiskit.providers.BackendV1")(configuration\[, provider]) | Abstract class for Backends |
+| [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2")(\[provider, name, description, ...]) | Abstract class for Backends |
+| [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties")(\[t1, t2, frequency]) | A representation of the properties of a qubit on a backend. |
+| [`BackendV2Converter`](qiskit.providers.BackendV2Converter "qiskit.providers.BackendV2Converter")(backend\[, name\_mapping, ...]) | A converter class that takes a [`BackendV1`](qiskit.providers.BackendV1 "qiskit.providers.BackendV1") instance and wraps it in a [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") interface. |
+| [`convert_to_target`](qiskit.providers.convert_to_target "qiskit.providers.convert_to_target")(configuration\[, ...]) | Uses configuration, properties and pulse defaults to construct and return Target class. |
+
+### Options
+
+| | |
+| ---------------------------------------------------------------------------- | ------------------- |
+| [`Options`](qiskit.providers.Options "qiskit.providers.Options")(\*\*kwargs) | Base options object |
+
+### Job
+
+| | |
+| ---------------------------------------------------------------------------------------- | -------------------------------------------------------- |
+| [`Job`](qiskit.providers.Job "qiskit.providers.Job")() | Base common type for all versioned Job abstract classes. |
+| [`JobV1`](qiskit.providers.JobV1 "qiskit.providers.JobV1")(backend, job\_id, \*\*kwargs) | Class to handle jobs |
+
+### Job Status
+
+| | |
+| ----------------------------------------------------------------------------- | ------------------------------------- |
+| [`JobStatus`](qiskit.providers.JobStatus "qiskit.providers.JobStatus")(value) | Class for job status enumerated type. |
+
+### Exceptions
+
+### QiskitBackendNotFoundError
+
+
+
+`qiskit.providers.QiskitBackendNotFoundError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/exceptions.py "view source code")
+
+Base class for errors raised while looking for a backend.
+
+Set the error message.
+
+### BackendPropertyError
+
+
+
+`qiskit.providers.BackendPropertyError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/exceptions.py "view source code")
+
+Base class for errors raised while looking for a backend property.
+
+Set the error message.
+
+### JobError
+
+
+
+`qiskit.providers.JobError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/exceptions.py "view source code")
+
+Base class for errors raised by Jobs.
+
+Set the error message.
+
+### JobTimeoutError
+
+
+
+`qiskit.providers.JobTimeoutError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/exceptions.py "view source code")
+
+Base class for timeout errors raised by jobs.
+
+Set the error message.
+
+### BackendConfigurationError
+
+
+
+`qiskit.providers.BackendConfigurationError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/exceptions.py "view source code")
+
+Base class for errors raised by the BackendConfiguration.
+
+Set the error message.
+
+# Writing a New Provider
+
+If you have a quantum device or simulator that you would like to integrate with Qiskit you will need to write a provider. A provider will provide Terra with a method to get available [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") objects. The [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") object provides both information describing a backend and its operation for the [`transpiler`](transpiler#module-qiskit.transpiler "qiskit.transpiler") so that circuits can be compiled to something that is optimized and can execute on the backend. It also provides the [`run()`](qiskit.providers.BackendV2#run "qiskit.providers.BackendV2.run") method which can run the [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") objects and/or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects. This enables users and other Qiskit APIs, such as [`execute()`](execute#qiskit.execute_function.execute "qiskit.execute_function.execute") and higher level algorithms in [`qiskit.algorithms`](algorithms#module-qiskit.algorithms "qiskit.algorithms"), to get results from executing circuits on devices in a standard fashion regardless of how the backend is implemented. At a high level the basic steps for writing a provider are:
+
+> * Implement a [`ProviderV1`](qiskit.providers.ProviderV1 "qiskit.providers.ProviderV1") subclass that handles access to the backend(s).
+>
+> * Implement a [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") subclass and its [`run()`](qiskit.providers.BackendV2#run "qiskit.providers.BackendV2.run") method.
+>
+> * Add any custom gates for the backend’s basis to the session [`EquivalenceLibrary`](qiskit.circuit.EquivalenceLibrary "qiskit.circuit.EquivalenceLibrary") instance.
+>
+> * Implement a [`JobV1`](qiskit.providers.JobV1 "qiskit.providers.JobV1") subclass that handles interacting with a running job.
+
+For a simple example of a provider, see the [qiskit-aqt-provider](https://github.com/Qiskit-Partners/qiskit-aqt-provider)
+
+
+
+## Provider
+
+A provider class serves a single purpose: to get backend objects that enable executing circuits on a device or simulator. The expectation is that any required credentials and/or authentication will be handled in the initialization of a provider object. The provider object will then provide a list of backends, and methods to filter and acquire backends (using the provided credentials if required). An example provider class looks like:
+
+```python
+from qiskit.providers import ProviderV1 as Provider
+from qiskit.providers.providerutils import filter_backends
+
+from .backend import MyBackend
+
+class MyProvider(Provider):
+
+ def __init__(self, token=None):
+ super().__init__()
+ self.token = token
+ self.backends = [MyBackend(provider=self)]
+
+ def backends(self, name=None, **kwargs):
+ if name:
+ backends = [
+ backend for backend in backends if backend.name() == name]
+ return filter_backends(backends, filters=filters, **kwargs)
+```
+
+Ensure that any necessary information for authentication (if required) are present in the class and that the backends method matches the required interface. The rest is up to the specific provider on how to implement.
+
+
+
+## Backend
+
+The backend classes are the core to the provider. These classes are what provide the interface between Qiskit and the hardware or simulator that will execute circuits. This includes providing the necessary information to describe a backend to the compiler so that it can embed and optimize any circuit for the backend. There are 4 required things in every backend object: a [`target`](qiskit.providers.BackendV2#target "qiskit.providers.BackendV2.target") property to define the model of the backend for the compiler, a [`max_circuits`](qiskit.providers.BackendV2#max_circuits "qiskit.providers.BackendV2.max_circuits") property to define a limit on the number of circuits the backend can execute in a single batch job (if there is no limit `None` can be used), a [`run()`](qiskit.providers.BackendV2#run "qiskit.providers.BackendV2.run") method to accept job submissions, and a [`_default_options`](qiskit.providers.BackendV2#_default_options "qiskit.providers.BackendV2._default_options") method to define the user configurable options and their default values. For example, a minimum working example would be something like:
+
+```python
+from qiskit.providers import BackendV2 as Backend
+from qiskit.transpiler import Target
+from qiskit.providers import Options
+from qiskit.circuit import Parameter, Measure
+from qiskit.circuit.library import PhaseGate, SXGate, UGate, CXGate, IGate
+
+
+class Mybackend(Backend):
+
+ def __init__(self):
+ super().__init__()
+
+ # Create Target
+ self._target = Target("Target for My Backend")
+ # Instead of None for this and below instructions you can define
+ # a qiskit.transpiler.InstructionProperties object to define properties
+ # for an instruction.
+ lam = Parameter("λ")
+ p_props = {(qubit,): None for qubit in range(5)}
+ self._target.add_instruction(PhaseGate(lam), p_props)
+ sx_props = {(qubit,): None for qubit in range(5)}
+ self._target.add_instruction(SXGate(), sx_props)
+ phi = Parameter("φ")
+ theta = Parameter("ϴ")
+ u_props = {(qubit,): None for qubit in range(5)}
+ self._target.add_instruction(UGate(theta, phi, lam), u_props)
+ cx_props = {edge: None for edge in [(0, 1), (1, 2), (2, 3), (3, 4)]}
+ self._target.add_instruction(CXGate(), cx_props)
+ meas_props = {(qubit,): None for qubit in range(5)}
+ self._target.add_instruction(Measure(), meas_props)
+ id_props = {(qubit,): None for qubit in range(5)}
+ self._target.add_instruction(IGate(), id_props)
+
+ # Set option validators
+ self.options.set_validator("shots", (1, 4096))
+ self.options.set_validator("memory", bool)
+
+ @property
+ def target(self):
+ return self._target
+
+ @property
+ def max_circuits(self):
+ return 1024
+
+ @classmethod
+ def _default_options(cls):
+ return Options(shots=1024, memory=False)
+
+ def run(circuits, **kwargs):
+ # serialize circuits submit to backend and create a job
+ for kwarg in kwargs:
+ if not hasattr(kwarg, self.options):
+ warnings.warn(
+ "Option %s is not used by this backend" % kwarg,
+ UserWarning, stacklevel=2)
+ options = {
+ 'shots': kwargs.get('shots', self.options.shots),
+ 'memory': kwargs.get('memory', self.options.shots),
+ }
+ job_json = convert_to_wire_format(circuit, options)
+ job_handle = submit_to_backend(job_jsonb)
+ return MyJob(self. job_handle, job_json, circuit)
+```
+
+### Transpiler Interface
+
+The key piece of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") object is how it describes itself to the compiler. This is handled with the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") class which defines a model of a backend for the transpiler. A backend object will need to return a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object from the [`target`](qiskit.providers.BackendV2#target "qiskit.providers.BackendV2.target") attribute which the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function will use as its model of a backend target for compilation.
+
+
+
+#### Custom Basis Gates
+
+1. If your backend doesn’t use gates in the Qiskit circuit library ([`qiskit.circuit.library`](circuit_library#module-qiskit.circuit.library "qiskit.circuit.library")) you can integrate support for this into your provider. The basic method for doing this is first to define a [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate") subclass for each custom gate in the basis set. For example:
+
+ ```python
+ import numpy as np
+
+ from qiskit.circuit import Gate
+ from qiskit.circuit import QuantumCircuit
+
+ class SYGate(Gate):
+ def __init__(self, label=None):
+ super().__init__("sy", 1, [], label=label)
+
+ def _define(self):
+ qc = QuantumCircuit(1)
+ q.ry(np.pi / 2, 0)
+ self.definition = qc
+ ```
+
+ The key thing to ensure is that for any custom gates in your Backend’s basis set your custom gate’s name attribute (the first param on `super().__init__()` in the `__init__` definition above) does not conflict with the name of any other gates. The name attribute is what is used to identify the gate in the basis set for the transpiler. If there is a conflict the transpiler will not know which gate to use.
+
+2. Add the custom gate to the target for your backend. This can be done with the [`Target.add_instruction()`](qiskit.transpiler.Target#add_instruction "qiskit.transpiler.Target.add_instruction") method. You’ll need to add an instance of `SYGate` and its parameters to the target so the transpiler knows it exists. For example, assuming this is part of your [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") implementation for your backend:
+
+ ```python
+ from qiskit.transpiler import InstructionProperties
+
+ sy_props = {
+ (0,): InstructionProperties(duration=2.3e-6, error=0.0002)
+ (1,): InstructionProperties(duration=2.1e-6, error=0.0001)
+ (2,): InstructionProperties(duration=2.5e-6, error=0.0003)
+ (3,): InstructionProperties(duration=2.2e-6, error=0.0004)
+ }
+ self.target.add_instruction(SYGate(), sy_props)
+ ```
+
+ The keys in `sy_props` define the qubits where the backend `SYGate` can be used on, and the values define the properties of `SYGate` on that qubit. For multiqubit gates the tuple keys contain all qubit combinations the gate works on (order is significant, i.e. `(0, 1)` is different from `(1, 0)`).
+
+3. After you’ve defined the custom gates to use for the backend’s basis set then you need to add equivalence rules to the standard equivalence library so that the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function and [`transpiler`](transpiler#module-qiskit.transpiler "qiskit.transpiler") module can convert an arbitrary circuit using the custom basis set. This can be done by defining equivalent circuits, in terms of the custom gate, for standard gates. Typically if you can convert from a [`CXGate`](qiskit.circuit.library.CXGate "qiskit.circuit.library.CXGate") (if your basis doesn’t include a standard 2 qubit gate) and some commonly used single qubit rotation gates like the [`HGate`](qiskit.circuit.library.HGate "qiskit.circuit.library.HGate") and [`UGate`](qiskit.circuit.library.UGate "qiskit.circuit.library.UGate") that should be sufficient for the transpiler to translate any circuit into the custom basis gates. But, the more equivalence rules that are defined from standard gates to your basis the more efficient translation from an arbitrary circuit to the target basis will be (although not always, and there is a diminishing margin of return).
+
+ For example, if you were to add some rules for the above custom `SYGate` we could define the [`U2Gate`](qiskit.circuit.library.U2Gate "qiskit.circuit.library.U2Gate") and [`HGate`](qiskit.circuit.library.HGate "qiskit.circuit.library.HGate"):
+
+ ```python
+ from qiskit.circuit.equivalence_library import SessionEquivalenceLibrary
+ from qiskit.circuit.library import HGate
+ from qiskit.circuit.library import ZGate
+ from qiskit.circuit.library import RZGate
+ from qiskit.circuit.library import U2Gate
+
+
+ # H => Z SY
+ q = qiskit.QuantumRegister(1, "q")
+ def_sy_h = qiskit.QuantumCircuit(q)
+ def_sy_h.append(ZGate(), [q[0]], [])
+ def_sy_h.append(SYGate(), [q[0]], [])
+ SessionEquivalenceLibrary.add_equivalence(
+ HGate(), def_sy_h)
+
+ # u2 => Z SY Z
+ phi = qiskit.circuit.Parameter('phi')
+ lam = qiskit.circuit.Parameter('lambda')
+ q = qiskit.QuantumRegister(1, "q")
+ def_sy_u2 = qiskit.QuantumCircuit(q)
+ def_sy_u2.append(RZGate(lam), [q[0]], [])
+ def_sy_u2.append(SYGate(), [q[0]], [])
+ def_sy_u2.append(RZGate(phi), [q[0]], [])
+ SessionEquivalenceLibrary.add_equivalence(
+ U2Gate(phi, lam), def_sy_u2)
+ ```
+
+ You will want this to be run on import so that as soon as the provider’s package is imported it will be run. This will ensure that any time the [`BasisTranslator`](qiskit.transpiler.passes.BasisTranslator "qiskit.transpiler.passes.BasisTranslator") pass is run with the custom gates the equivalence rules are defined.
+
+ It’s also worth noting that depending on the basis you’re using, some optimization passes in the transpiler, such as [`Optimize1qGatesDecomposition`](qiskit.transpiler.passes.Optimize1qGatesDecomposition "qiskit.transpiler.passes.Optimize1qGatesDecomposition"), may not be able to operate with your custom basis. For our `SYGate` example, the [`Optimize1qGatesDecomposition`](qiskit.transpiler.passes.Optimize1qGatesDecomposition "qiskit.transpiler.passes.Optimize1qGatesDecomposition") will not be able to simplify runs of single qubit gates into the SY basis. This is because the `OneQubitEulerDecomposer` class does not know how to work in the SY basis. To solve this the `SYGate` class would need to be added to Qiskit and `OneQubitEulerDecomposer` updated to support decomposing to the `SYGate`. Longer term that is likely a better direction for custom basis gates and contributing the definitions and support in the transpiler will ensure that it continues to be well supported by Qiskit moving forward.
+
+
+
+#### Custom Transpiler Passes
+
+The transpiler supports the ability for backends to provide custom transpiler stage implementations to facilitate hardware specific optimizations and circuit transformations. Currently there are two stages supported, `get_translation_stage_plugin()` and `get_scheduling_stage_plugin()` which allow a backend to specify string plugin names to be used as the default translation and scheduling stages, respectively. These hook points in a [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") class can be used if your backend has requirements for compilation that are not met by the current backend/[`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") interface. Please also consider submitting a Github issue describing your use case as there is interest in improving these interfaces to be able to describe more hardware architectures in greater depth.
+
+To leverage these hook points you just need to add the methods to your [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") implementation and have them return a string plugin name. For example:
+
+```python
+class Mybackend(BackendV2):
+
+ def get_scheduling_stage_plugin(self):
+ return "SpecialDD"
+
+ def get_translation_stage_plugin(self):
+ return "BasisTranslatorWithCustom1qOptimization"
+```
+
+This snippet of a backend implementation will now have the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function use the `SpecialDD` plugin for the scheduling stage and the `BasisTranslatorWithCustom1qOptimization` plugin for the translation stage by default when the target is set to `Mybackend`. Note that users may override these choices by explicitly selecting a different plugin name. For this interface to work though transpiler stage plugins must be implemented for the returned plugin name. You can refer to [`qiskit.transpiler.preset_passmanagers.plugin`](transpiler_plugins#module-qiskit.transpiler.preset_passmanagers.plugin "qiskit.transpiler.preset_passmanagers.plugin") module documentation for details on how to implement plugins. The typical expectation is that if your backend requires custom passes as part of a compilation stage the provider package will include the transpiler stage plugins that use those passes. However, this is not required and any valid method (from a built-in method or external plugin) can be used.
+
+This way if these two compilation steps are **required** for running or providing efficient output on `Mybackend` the transpiler will be able to perform these custom steps without any manual user input.
+
+### Run Method
+
+Of key importance is the [`run()`](qiskit.providers.BackendV2#run "qiskit.providers.BackendV2.run") method, which is used to actually submit circuits to a device or simulator. The run method handles submitting the circuits to the backend to be executed and returning a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object. Depending on the type of backend this typically involves serializing the circuit object into the API format used by a backend. For example, on IBMQ backends from the `qiskit-ibmq-provider` package this involves converting from a quantum circuit and options into a [qobj](https://arxiv.org/abs/1809.03452) JSON payload and submitting that to the IBM Quantum API. Since every backend interface is different (and in the case of the local simulators serialization may not be needed) it is expected that the backend’s [`run`](qiskit.providers.BackendV2#run "qiskit.providers.BackendV2.run") method will handle this conversion.
+
+An example run method would be something like:
+
+```python
+def run(self, circuits. **kwargs):
+ for kwarg in kwargs:
+ if not hasattr(kwarg, self.options):
+ warnings.warn(
+ "Option %s is not used by this backend" % kwarg,
+ UserWarning, stacklevel=2)
+ options = {
+ 'shots': kwargs.get('shots', self.options.shots)
+ 'memory': kwargs.get('memory', self.options.shots),
+ }
+ job_json = convert_to_wire_format(circuit, options)
+ job_handle = submit_to_backend(job_jsonb)
+ return MyJob(self. job_handle, job_json, circuit)
+```
+
+
+
+### Options
+
+There are often several options for a backend that control how a circuit is run. The typical example of this is something like the number of `shots` which is how many times the circuit is to be executed. The options available for a backend are defined using an [`Options`](qiskit.providers.Options "qiskit.providers.Options") object. This object is initially created by the [`_default_options`](qiskit.providers.BackendV2#_default_options "qiskit.providers.BackendV2._default_options") method of a Backend class. The default options returns an initialized [`Options`](qiskit.providers.Options "qiskit.providers.Options") object with all the default values for all the options a backend supports. For example, if the backend supports only supports `shots` the [`_default_options`](qiskit.providers.BackendV2#_default_options "qiskit.providers.BackendV2._default_options") method would look like:
+
+```python
+@classmethod
+def _default_options(cls):
+ return Options(shots=1024)
+```
+
+You can also set validators on an [`Options`](qiskit.providers.Options "qiskit.providers.Options") object to provide limits and validation on user provided values based on what’s acceptable for your backend. For example, if the `"shots"` option defined above can be set to any value between 1 and 4096 you can set the validator on the options object for you backend with:
+
+```python
+self.options.set_validator("shots", (1, 4096))
+```
+
+you can refer to the [`set_validator()`](qiskit.providers.Options#set_validator "qiskit.providers.Options.set_validator") documentation for a full list of validation options.
+
+
+
+## Job
+
+The output from the [`run`](qiskit.providers.BackendV2#run "qiskit.providers.BackendV2.run") method is a [`JobV1`](qiskit.providers.JobV1 "qiskit.providers.JobV1") object. Each provider is expected to implement a custom job subclass that defines the behavior for the provider. There are 2 types of jobs depending on the backend’s execution method, either a sync or async. By default jobs are considered async and the expectation is that it represents a handle to the async execution of the circuits submitted with `Backend.run()`. An async job object provides users the ability to query the status of the execution, cancel a running job, and block until the execution is finished. The [`result`](qiskit.providers.JobV1#result "qiskit.providers.JobV1.result") is the primary user facing method which will block until the execution is complete and then will return a [`Result`](qiskit.result.Result "qiskit.result.Result") object with results of the job.
+
+For some backends (mainly local simulators) the execution of circuits is a synchronous operation and there is no need to return a handle to a running job elsewhere. For sync jobs its expected that the [`run`](qiskit.providers.BackendV1#run "qiskit.providers.BackendV1.run") method on the backend will block until a [`Result`](qiskit.result.Result "qiskit.result.Result") object is generated and the sync job will return with that inner [`Result`](qiskit.result.Result "qiskit.result.Result") object.
+
+An example job class for an async API based backend would look something like:
+
+```python
+from qiskit.providers import JobV1 as Job
+from qiskit.providers import JobError
+from qiskit.providers import JobTimeoutError
+from qiskit.providers.jobstatus import JobStatus
+from qiskit.result import Result
+
+
+class MyJob(Job):
+ def __init__(self, backend, job_id, job_json, circuits):
+ super().__init__(backend, job_id)
+ self._backend = backend
+ self.job_json = job_json
+ self.circuits = circuits
+
+ def _wait_for_result(self, timeout=None, wait=5):
+ start_time = time.time()
+ result = None
+ while True:
+ elapsed = time.time() - start_time
+ if timeout and elapsed >= timeout:
+ raise JobTimeoutError('Timed out waiting for result')
+ result = get_job_status(self._job_id)
+ if result['status'] == 'complete':
+ break
+ if result['status'] == 'error':
+ raise JobError('Job error')
+ time.sleep(wait)
+ return result
+
+ def result(self, timeout=None, wait=5):
+ result = self._wait_for_result(timeout, wait)
+ results = [{'success': True, 'shots': len(result['counts']),
+ 'data': result['counts']}]
+ return Result.from_dict({
+ 'results': results,
+ 'backend_name': self._backend.configuration().backend_name,
+ 'backend_version': self._backend.configuration().backend_version,
+ 'job_id': self._job_id,
+ 'qobj_id': ', '.join(x.name for x in self.circuits),
+ 'success': True,
+ })
+
+ def status(self):
+ result = get_job_status(self._job_id)
+ if result['status'] == 'running':
+ status = JobStatus.RUNNING
+ elif result['status'] == 'complete':
+ status = JobStatus.DONE
+ else:
+ status = JobStatus.ERROR
+ return status
+
+def submit(self):
+ raise NotImplementedError
+```
+
+and for a sync job:
+
+```python
+class MySyncJob(Job):
+ _async = False
+
+ def __init__(self, backend, job_id, result):
+ super().__init__(backend, job_id)
+ self._result = result
+
+ def submit(self):
+ return
+
+ def result(self):
+ return self._result
+
+ def status(self):
+ return JobStatus.DONE
+```
+
+## Primitives
+
+While not directly part of the provider interface, the [`qiskit.primitives`](primitives#module-qiskit.primitives "qiskit.primitives") module is tightly coupled with providers. Specifically the primitive interfaces, such as [`BaseSampler`](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler") and [`BaseEstimator`](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator"), are designed to enable provider implementations to provide custom implementations which are optimized for the provider’s backends. This can include customizations like circuit transformations, additional pre- and post-processing, batching, caching, error mitigation, etc. The concept of the [`qiskit.primitives`](primitives#module-qiskit.primitives "qiskit.primitives") module is to explicitly enable this as the primitive objects are higher level abstractions to produce processed higher level outputs (such as probability distributions and expectation values) that abstract away the mechanics of getting the best result efficiently, to concentrate on higher level applications using these outputs.
+
+For example, if your backends were well suited to leverage [mthree](https://github.com/Qiskit-Partners/mthree/) measurement mitigation to improve the quality of the results, you could implement a provider-specific [`Sampler`](qiskit.primitives.Sampler "qiskit.primitives.Sampler") implementation that leverages the `M3Mitigation` class internally to run the circuits and return quasi-probabilities directly from mthree in the result. Doing this would enable algorithms from [`qiskit.algorithms`](algorithms#module-qiskit.algorithms "qiskit.algorithms") to get the best results with mitigation applied directly from your backends. You can refer to the documentation in [`qiskit.primitives`](primitives#module-qiskit.primitives "qiskit.primitives") on how to write custom implementations. Also the built-in implementations: [`Sampler`](qiskit.primitives.Sampler "qiskit.primitives.Sampler"), [`Estimator`](qiskit.primitives.Estimator "qiskit.primitives.Estimator"), [`BackendSampler`](qiskit.primitives.BackendSampler "qiskit.primitives.BackendSampler"), and [`BackendEstimator`](qiskit.primitives.BackendEstimator "qiskit.primitives.BackendEstimator") can serve as references/models on how to implement these as well.
+
+# Migrating between Backend API Versions
+
+
+
+## BackendV1 -> BackendV2
+
+The [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") class re-defined user access for most properties of a backend to make them work with native Qiskit data structures and have flatter access patterns. However this means when using a provider that upgrades from [`BackendV1`](qiskit.providers.BackendV1 "qiskit.providers.BackendV1") to [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") existing access patterns will need to be adjusted. It is expected for existing providers to deprecate the old access where possible to provide a graceful migration, but eventually users will need to adjust code. The biggest change to adapt to in [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") is that most of the information accessible about a backend is contained in its [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object and the backend’s attributes often query its [`target`](qiskit.providers.BackendV2#target "qiskit.providers.BackendV2.target") attribute to return information, however in many cases the attributes only provide a subset of information the target can contain. For example, `backend.coupling_map` returns a [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") constructed from the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") accessible in the [`target`](qiskit.providers.BackendV2#target "qiskit.providers.BackendV2.target") attribute, however the target may contain instructions that operate on more than two qubits (which can’t be represented in a [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")) or has instructions that only operate on a subset of qubits (or two qubit links for a two qubit instruction) which won’t be detailed in the full coupling map returned by [`coupling_map`](qiskit.providers.BackendV2#coupling_map "qiskit.providers.BackendV2.coupling_map"). So depending on your use case it might be necessary to look deeper than just the equivalent access with [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2").
+
+Below is a table of example access patterns in [`BackendV1`](qiskit.providers.BackendV1 "qiskit.providers.BackendV1") and the new form with [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2"):
+
+| [`BackendV1`](qiskit.providers.BackendV1 "qiskit.providers.BackendV1") | [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") | Notes |
+| ---------------------------------------------------------------------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `backend.configuration().n_qubits` | `backend.num_qubits` | |
+| `backend.configuration().coupling_map` | `backend.coupling_map` | The return from [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") is a [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object. while in [`BackendV1`](qiskit.providers.BackendV1 "qiskit.providers.BackendV1") it is an edge list. Also this is just a view of the information contained in `backend.target` which may only be a subset of the information contained in [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object. |
+| `backend.configuration().backend_name` | `backend.name` | |
+| `backend.configuration().backend_version` | `backend.backend_version` | The [`version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version") attribute represents the version of the abstract [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") interface the object implements while [`backend_version`](qiskit.providers.BackendV2#backend_version "qiskit.providers.BackendV2.backend_version") is metadata about the version of the backend itself. |
+| `backend.configuration().basis_gates` | `backend.operation_names` | The [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") return is a list of operation names contained in the `backend.target` attribute. The [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") may contain more information that can be expressed by this list of names. For example, that some operations only work on a subset of qubits or that some names implement the same gate with different parameters. |
+| `backend.configuration().dt` | `backend.dt` | |
+| `backend.configuration().dtm` | `backend.dtm` | |
+| `backend.configuration().max_experiments` | `backend.max_circuits` | |
+| `backend.configuration().online_date` | `backend.online_date` | |
+| `InstructionDurations.from_backend(backend)` | `backend.instruction_durations` | |
+| `backend.defaults().instruction_schedule_map` | `backend.instruction_schedule_map` | |
+| `backend.properties().t1(0)` | `backend.qubit_properties(0).t1` | |
+| `backend.properties().t2(0)` | `backend.qubit_properties(0).t2` | |
+| `backend.properties().frequency(0)` | `backend.qubit_properties(0).frequency` | |
+| `backend.properties().readout_error(0)` | `backend.target["measure"][(0,)].error` | In [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") the error rate for the [`Measure`](qiskit.circuit.library.Measure "qiskit.circuit.library.Measure") operation on a given qubit is used to model the readout error. However a [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") can implement multiple measurement types and list them separately in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"). |
+| `backend.properties().readout_length(0)` | `backend.target["measure"][(0,)].duration` | In [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") the duration for the [`Measure`](qiskit.circuit.library.Measure "qiskit.circuit.library.Measure") operation on a given qubit is used to model the readout length. However, a [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") can implement multiple measurement types and list them separately in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"). |
+
+There is also a [`BackendV2Converter`](qiskit.providers.BackendV2Converter "qiskit.providers.BackendV2Converter") class available that enables you to wrap a [`BackendV1`](qiskit.providers.BackendV1 "qiskit.providers.BackendV1") object with a [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") interface.
+
diff --git a/docs/api/qiskit/0.46/providers_basic_provider.md b/docs/api/qiskit/0.46/providers_basic_provider.md
new file mode 100644
index 00000000000..df53414332b
--- /dev/null
+++ b/docs/api/qiskit/0.46/providers_basic_provider.md
@@ -0,0 +1,52 @@
+---
+title: basic_provider
+description: API reference for qiskit.providers.basic_provider
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.providers.basic_provider
+---
+
+
+
+
+
+
+
+# BasicProvider: Python-based Simulators
+
+
+
+`qiskit.providers.basic_provider`
+
+A module of Python-based quantum simulators. Simulators can be accessed via the BasicProvider provider, e.g.:
+
+```python
+from qiskit.providers.basic_provider import BasicProvider
+
+backend = BasicProvider().get_backend('basic_simulator')
+```
+
+## Simulators
+
+| | |
+| ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
+| [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator")(\[provider, target]) | Python implementation of a basic (non-efficient) quantum simulator. |
+
+## Provider
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------ | ----------------------------- |
+| [`BasicProvider`](qiskit.providers.basic_provider.BasicProvider "qiskit.providers.basic_provider.BasicProvider")() | Provider for test simulators. |
+
+## Job Class
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
+| [`BasicProviderJob`](qiskit.providers.basic_provider.BasicProviderJob "qiskit.providers.basic_provider.BasicProviderJob")(backend, job\_id, result) | BasicProviderJob class. |
+
+## Exceptions
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------- |
+| [`BasicProviderError`](qiskit.providers.basic_provider.BasicProviderError "qiskit.providers.basic_provider.BasicProviderError")(\*message) | Base class for errors raised by the Basic Provider. |
+
diff --git a/docs/api/qiskit/0.46/providers_basicaer.md b/docs/api/qiskit/0.46/providers_basicaer.md
new file mode 100644
index 00000000000..086ed85ad18
--- /dev/null
+++ b/docs/api/qiskit/0.46/providers_basicaer.md
@@ -0,0 +1,58 @@
+---
+title: basicaer
+description: API reference for qiskit.providers.basicaer
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.providers.basicaer
+---
+
+
+
+
+
+
+
+# BasicAer: Python-based Simulators
+
+
+
+`qiskit.providers.basicaer`
+
+
+ The [`qiskit.providers.basicaer`](#module-qiskit.providers.basicaer "qiskit.providers.basicaer") module is deprecated as of Qiskit 0.46 and will be removed in Qiskit 1.0. Its functionality has been replaced by the new [`qiskit.providers.basic_provider`](providers_basic_provider#module-qiskit.providers.basic_provider "qiskit.providers.basic_provider") module and the [`qiskit.quantum_info`](quantum_info#module-qiskit.quantum_info "qiskit.quantum_info") module.
+
+
+A module of Python-based quantum simulators. Simulators are accessed via the BasicAer provider, e.g.:
+
+```python
+from qiskit import BasicAer
+
+backend = BasicAer.get_backend('qasm_simulator')
+```
+
+## Simulators
+
+| | |
+| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
+| [`QasmSimulatorPy`](qiskit.providers.basicaer.QasmSimulatorPy "qiskit.providers.basicaer.QasmSimulatorPy")(\[configuration, provider]) | Python implementation of an OpenQASM 2 simulator. |
+| [`StatevectorSimulatorPy`](qiskit.providers.basicaer.StatevectorSimulatorPy "qiskit.providers.basicaer.StatevectorSimulatorPy")(\[configuration, provider]) | Python statevector simulator. |
+| [`UnitarySimulatorPy`](qiskit.providers.basicaer.UnitarySimulatorPy "qiskit.providers.basicaer.UnitarySimulatorPy")(\[configuration, provider]) | Python implementation of a unitary simulator. |
+
+## Provider
+
+| | |
+| --------------------------------------------------------------------------------------------------------------- | -------------------------------- |
+| [`BasicAerProvider`](qiskit.providers.basicaer.BasicAerProvider "qiskit.providers.basicaer.BasicAerProvider")() | Provider for Basic Aer backends. |
+
+## Job Class
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------ | ------------------ |
+| [`BasicAerJob`](qiskit.providers.basicaer.BasicAerJob "qiskit.providers.basicaer.BasicAerJob")(backend, job\_id, result) | BasicAerJob class. |
+
+## Exceptions
+
+| | |
+| --------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
+| [`BasicAerError`](qiskit.providers.basicaer.BasicAerError "qiskit.providers.basicaer.BasicAerError")(\*message) | Base class for errors raised by Basic Aer. |
+
diff --git a/docs/api/qiskit/0.46/providers_fake_provider.md b/docs/api/qiskit/0.46/providers_fake_provider.md
new file mode 100644
index 00000000000..e03e312b370
--- /dev/null
+++ b/docs/api/qiskit/0.46/providers_fake_provider.md
@@ -0,0 +1,265 @@
+---
+title: fake_provider
+description: API reference for qiskit.providers.fake_provider
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.providers.fake_provider
+---
+
+
+
+
+
+
+
+# Fake Provider
+
+
+
+`qiskit.providers.fake_provider`
+
+## Overview
+
+The fake provider module contains fake providers, fake backends and other simulated backend implementations. The fake backends are built to mimic the behaviors of IBM Quantum systems using system snapshots. The system snapshots contain important information about the quantum system such as coupling map, basis gates, qubit properties (T1, T2, error rate, etc.) which are useful for testing the transpiler and performing noisy simulation of the system.
+
+## Example Usage
+
+Here is an example of using a fake backend for transpilation and simulation.
+
+```python
+from qiskit import QuantumCircuit
+from qiskit.providers.fake_provider import FakeManilaV2
+from qiskit import transpile
+from qiskit.tools.visualization import plot_histogram
+
+
+# Get a fake backend from the fake provider
+backend = FakeManilaV2()
+
+# Create a simple circuit
+circuit = QuantumCircuit(3)
+circuit.h(0)
+circuit.cx(0,1)
+circuit.cx(0,2)
+circuit.measure_all()
+circuit.draw('mpl')
+
+# Transpile the ideal circuit to a circuit that can be directly executed by the backend
+transpiled_circuit = transpile(circuit, backend)
+transpiled_circuit.draw('mpl')
+
+# Run the transpiled circuit using the simulated fake backend
+job = backend.run(transpiled_circuit)
+counts = job.result().get_counts()
+plot_histogram(counts)
+```
+
+
+
+
+
+
+
+
+ Please note that the simulation is done using a noise model generated from system snapshots obtained in the past (sometimes a few years ago) and the results are not representative of the latest behaviours of the real quantum system which the fake backend is mimicking. If you want to run noisy simulations to compare with the real quantum system, please follow steps below to generate a simulator mimics a real quantum system with the latest calibration results.
+
+ ```python
+ from qiskit.providers.ibmq import IBMQ
+ from qiskit_aer import AerSimulator
+
+ # get a real backend from a real provider
+ provider = IBMQ.load_account()
+ backend = provider.get_backend('ibmq_manila')
+
+ # generate a simulator that mimics the real quantum system with the latest calibration results
+ backend_sim = AerSimulator.from_backend(backend)
+ ```
+
+
+## Fake Providers
+
+Fake providers provide access to a list of fake backends.
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
+| [`FakeProviderForBackendV2`](qiskit.providers.fake_provider.FakeProviderForBackendV2 "qiskit.providers.fake_provider.FakeProviderForBackendV2")() | Fake provider containing fake V2 backends. |
+| [`FakeProvider`](qiskit.providers.fake_provider.FakeProvider "qiskit.providers.fake_provider.FakeProvider")() | Fake provider containing fake V1 backends. |
+
+## Fake Backends
+
+### Fake V2 Backends
+
+Fake V2 backends are fake backends with IBM Quantum systems snapshots implemented with [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.backend.BackendV2") interface. They are all subclasses of [`FakeBackendV2`](qiskit.providers.fake_provider.FakeBackendV2 "qiskit.providers.fake_provider.FakeBackendV2").
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
+| [`FakeAlmadenV2`](qiskit.providers.fake_provider.FakeAlmadenV2 "qiskit.providers.fake_provider.FakeAlmadenV2")() | A fake Almaden V2 backend. |
+| [`FakeArmonkV2`](qiskit.providers.fake_provider.FakeArmonkV2 "qiskit.providers.fake_provider.FakeArmonkV2")() | A fake 1 qubit backend. |
+| [`FakeAthensV2`](qiskit.providers.fake_provider.FakeAthensV2 "qiskit.providers.fake_provider.FakeAthensV2")() | A fake 5 qubit backend. |
+| [`FakeAuckland`](qiskit.providers.fake_provider.FakeAuckland "qiskit.providers.fake_provider.FakeAuckland")() | A fake 27 qubit backend. |
+| [`FakeBelemV2`](qiskit.providers.fake_provider.FakeBelemV2 "qiskit.providers.fake_provider.FakeBelemV2")() | A fake 5 qubit backend. |
+| [`FakeBoeblingenV2`](qiskit.providers.fake_provider.FakeBoeblingenV2 "qiskit.providers.fake_provider.FakeBoeblingenV2")() | A fake Boeblingen V2 backend. |
+| [`FakeBogotaV2`](qiskit.providers.fake_provider.FakeBogotaV2 "qiskit.providers.fake_provider.FakeBogotaV2")() | A fake 5 qubit backend. |
+| [`FakeBrooklynV2`](qiskit.providers.fake_provider.FakeBrooklynV2 "qiskit.providers.fake_provider.FakeBrooklynV2")() | A fake Brooklyn V2 backend. |
+| [`FakeBurlingtonV2`](qiskit.providers.fake_provider.FakeBurlingtonV2 "qiskit.providers.fake_provider.FakeBurlingtonV2")() | A fake 5 qubit backend. |
+| [`FakeCairoV2`](qiskit.providers.fake_provider.FakeCairoV2 "qiskit.providers.fake_provider.FakeCairoV2")() | A fake 27 qubit backend. |
+| [`FakeCambridgeV2`](qiskit.providers.fake_provider.FakeCambridgeV2 "qiskit.providers.fake_provider.FakeCambridgeV2")() | A fake Cambridge backend. |
+| [`FakeCasablancaV2`](qiskit.providers.fake_provider.FakeCasablancaV2 "qiskit.providers.fake_provider.FakeCasablancaV2")() | A fake 7 qubit backend. |
+| [`FakeEssexV2`](qiskit.providers.fake_provider.FakeEssexV2 "qiskit.providers.fake_provider.FakeEssexV2")() | A fake 5 qubit backend. |
+| [`FakeGeneva`](qiskit.providers.fake_provider.FakeGeneva "qiskit.providers.fake_provider.FakeGeneva")() | A fake 27 qubit backend. |
+| [`FakeGuadalupeV2`](qiskit.providers.fake_provider.FakeGuadalupeV2 "qiskit.providers.fake_provider.FakeGuadalupeV2")() | A fake 16 qubit backend. |
+| [`FakeHanoiV2`](qiskit.providers.fake_provider.FakeHanoiV2 "qiskit.providers.fake_provider.FakeHanoiV2")() | A fake 27 qubit backend. |
+| [`FakeJakartaV2`](qiskit.providers.fake_provider.FakeJakartaV2 "qiskit.providers.fake_provider.FakeJakartaV2")() | A fake 7 qubit V2 backend. |
+| [`FakeJohannesburgV2`](qiskit.providers.fake_provider.FakeJohannesburgV2 "qiskit.providers.fake_provider.FakeJohannesburgV2")() | A fake Johannesburg V2 backend. |
+| [`FakeKolkataV2`](qiskit.providers.fake_provider.FakeKolkataV2 "qiskit.providers.fake_provider.FakeKolkataV2")() | A fake 27 qubit backend. |
+| [`FakeLagosV2`](qiskit.providers.fake_provider.FakeLagosV2 "qiskit.providers.fake_provider.FakeLagosV2")() | A fake 7 qubit backend. |
+| [`FakeLimaV2`](qiskit.providers.fake_provider.FakeLimaV2 "qiskit.providers.fake_provider.FakeLimaV2")() | A fake 5 qubit backend. |
+| [`FakeLondonV2`](qiskit.providers.fake_provider.FakeLondonV2 "qiskit.providers.fake_provider.FakeLondonV2")() | A fake 5 qubit backend. |
+| [`FakeManhattanV2`](qiskit.providers.fake_provider.FakeManhattanV2 "qiskit.providers.fake_provider.FakeManhattanV2")() | A fake Manhattan backend. |
+| [`FakeManilaV2`](qiskit.providers.fake_provider.FakeManilaV2 "qiskit.providers.fake_provider.FakeManilaV2")() | A fake 5 qubit backend. |
+| [`FakeMelbourneV2`](qiskit.providers.fake_provider.FakeMelbourneV2 "qiskit.providers.fake_provider.FakeMelbourneV2")() | A fake 14 qubit backend. |
+| [`FakeMontrealV2`](qiskit.providers.fake_provider.FakeMontrealV2 "qiskit.providers.fake_provider.FakeMontrealV2")() | A fake 27 qubit backend. |
+| [`FakeMumbaiV2`](qiskit.providers.fake_provider.FakeMumbaiV2 "qiskit.providers.fake_provider.FakeMumbaiV2")() | A fake 27 qubit backend. |
+| [`FakeNairobiV2`](qiskit.providers.fake_provider.FakeNairobiV2 "qiskit.providers.fake_provider.FakeNairobiV2")() | A fake 7 qubit backend. |
+| [`FakeOslo`](qiskit.providers.fake_provider.FakeOslo "qiskit.providers.fake_provider.FakeOslo")() | A fake 7 qubit backend. |
+| [`FakeOurenseV2`](qiskit.providers.fake_provider.FakeOurenseV2 "qiskit.providers.fake_provider.FakeOurenseV2")() | A fake 5 qubit backend. |
+| [`FakeParisV2`](qiskit.providers.fake_provider.FakeParisV2 "qiskit.providers.fake_provider.FakeParisV2")() | A fake Paris backend. |
+| [`FakePerth`](qiskit.providers.fake_provider.FakePerth "qiskit.providers.fake_provider.FakePerth")() | A fake 7 qubit backend. |
+| [`FakePrague`](qiskit.providers.fake_provider.FakePrague "qiskit.providers.fake_provider.FakePrague")() | A fake 33 qubit backend. |
+| [`FakePoughkeepsieV2`](qiskit.providers.fake_provider.FakePoughkeepsieV2 "qiskit.providers.fake_provider.FakePoughkeepsieV2")() | A fake Poughkeepsie backend. |
+| [`FakeQuitoV2`](qiskit.providers.fake_provider.FakeQuitoV2 "qiskit.providers.fake_provider.FakeQuitoV2")() | A fake 5 qubit backend. |
+| [`FakeRochesterV2`](qiskit.providers.fake_provider.FakeRochesterV2 "qiskit.providers.fake_provider.FakeRochesterV2")() | A fake Rochester backend. |
+| [`FakeRomeV2`](qiskit.providers.fake_provider.FakeRomeV2 "qiskit.providers.fake_provider.FakeRomeV2")() | A fake 5 qubit backend. |
+| [`FakeSantiagoV2`](qiskit.providers.fake_provider.FakeSantiagoV2 "qiskit.providers.fake_provider.FakeSantiagoV2")() | A fake Santiago backend. |
+| [`FakeSherbrooke`](qiskit.providers.fake_provider.FakeSherbrooke "qiskit.providers.fake_provider.FakeSherbrooke")() | A fake 127 qubit backend. |
+| [`FakeSingaporeV2`](qiskit.providers.fake_provider.FakeSingaporeV2 "qiskit.providers.fake_provider.FakeSingaporeV2")() | A fake Singapore backend. |
+| [`FakeSydneyV2`](qiskit.providers.fake_provider.FakeSydneyV2 "qiskit.providers.fake_provider.FakeSydneyV2")() | A fake 27 qubit backend. |
+| [`FakeTorontoV2`](qiskit.providers.fake_provider.FakeTorontoV2 "qiskit.providers.fake_provider.FakeTorontoV2")() | A fake 27 qubit backend. |
+| [`FakeValenciaV2`](qiskit.providers.fake_provider.FakeValenciaV2 "qiskit.providers.fake_provider.FakeValenciaV2")() | A fake 5 qubit backend. |
+| [`FakeVigoV2`](qiskit.providers.fake_provider.FakeVigoV2 "qiskit.providers.fake_provider.FakeVigoV2")() | A fake 5 qubit backend. |
+| [`FakeWashingtonV2`](qiskit.providers.fake_provider.FakeWashingtonV2 "qiskit.providers.fake_provider.FakeWashingtonV2")() | A fake 127 qubit backend. |
+| [`FakeYorktownV2`](qiskit.providers.fake_provider.FakeYorktownV2 "qiskit.providers.fake_provider.FakeYorktownV2")() | A fake 5 qubit backend. |
+
+### Fake V1 Backends
+
+Fake V1 backends are fake backends with IBM Quantum systems snapshots implemented with [`BackendV1`](qiskit.providers.BackendV1 "qiskit.providers.backend.BackendV1") interface.
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------- | ---------------------------- |
+| [`FakeAlmaden`](qiskit.providers.fake_provider.FakeAlmaden "qiskit.providers.fake_provider.FakeAlmaden")() | A fake Almaden backend. |
+| [`FakeArmonk`](qiskit.providers.fake_provider.FakeArmonk "qiskit.providers.fake_provider.FakeArmonk")() | A fake 1 qubit backend. |
+| [`FakeAthens`](qiskit.providers.fake_provider.FakeAthens "qiskit.providers.fake_provider.FakeAthens")() | A fake 5 qubit backend. |
+| [`FakeBelem`](qiskit.providers.fake_provider.FakeBelem "qiskit.providers.fake_provider.FakeBelem")() | A fake 5 qubit backend. |
+| [`FakeBoeblingen`](qiskit.providers.fake_provider.FakeBoeblingen "qiskit.providers.fake_provider.FakeBoeblingen")() | A fake Boeblingen backend. |
+| [`FakeBogota`](qiskit.providers.fake_provider.FakeBogota "qiskit.providers.fake_provider.FakeBogota")() | A fake 5 qubit backend. |
+| [`FakeBrooklyn`](qiskit.providers.fake_provider.FakeBrooklyn "qiskit.providers.fake_provider.FakeBrooklyn")() | A fake Brooklyn backend. |
+| [`FakeBurlington`](qiskit.providers.fake_provider.FakeBurlington "qiskit.providers.fake_provider.FakeBurlington")() | A fake 5 qubit backend. |
+| [`FakeCairo`](qiskit.providers.fake_provider.FakeCairo "qiskit.providers.fake_provider.FakeCairo")() | A fake 27 qubit backend. |
+| [`FakeCambridge`](qiskit.providers.fake_provider.FakeCambridge "qiskit.providers.fake_provider.FakeCambridge")() | A fake Cambridge backend. |
+| [`FakeCasablanca`](qiskit.providers.fake_provider.FakeCasablanca "qiskit.providers.fake_provider.FakeCasablanca")() | A fake 7 qubit backend. |
+| [`FakeEssex`](qiskit.providers.fake_provider.FakeEssex "qiskit.providers.fake_provider.FakeEssex")() | A fake 5 qubit backend. |
+| [`FakeGuadalupe`](qiskit.providers.fake_provider.FakeGuadalupe "qiskit.providers.fake_provider.FakeGuadalupe")() | A fake 16 qubit backend. |
+| [`FakeHanoi`](qiskit.providers.fake_provider.FakeHanoi "qiskit.providers.fake_provider.FakeHanoi")() | A fake 27 qubit backend. |
+| [`FakeJakarta`](qiskit.providers.fake_provider.FakeJakarta "qiskit.providers.fake_provider.FakeJakarta")() | A fake 7 qubit backend. |
+| [`FakeJohannesburg`](qiskit.providers.fake_provider.FakeJohannesburg "qiskit.providers.fake_provider.FakeJohannesburg")() | A fake Johannesburg backend. |
+| [`FakeKolkata`](qiskit.providers.fake_provider.FakeKolkata "qiskit.providers.fake_provider.FakeKolkata")() | A fake 27 qubit backend. |
+| [`FakeLagos`](qiskit.providers.fake_provider.FakeLagos "qiskit.providers.fake_provider.FakeLagos")() | A fake 7 qubit backend. |
+| [`FakeLima`](qiskit.providers.fake_provider.FakeLima "qiskit.providers.fake_provider.FakeLima")() | A fake 5 qubit backend. |
+| [`FakeLondon`](qiskit.providers.fake_provider.FakeLondon "qiskit.providers.fake_provider.FakeLondon")() | A fake 5 qubit backend. |
+| [`FakeManhattan`](qiskit.providers.fake_provider.FakeManhattan "qiskit.providers.fake_provider.FakeManhattan")() | A fake Manhattan backend. |
+| [`FakeManila`](qiskit.providers.fake_provider.FakeManila "qiskit.providers.fake_provider.FakeManila")() | A fake 5 qubit backend. |
+| [`FakeMelbourne`](qiskit.providers.fake_provider.FakeMelbourne "qiskit.providers.fake_provider.FakeMelbourne")() | A fake 14 qubit backend. |
+| [`FakeMontreal`](qiskit.providers.fake_provider.FakeMontreal "qiskit.providers.fake_provider.FakeMontreal")() | A fake 27 qubit backend. |
+| [`FakeMumbai`](qiskit.providers.fake_provider.FakeMumbai "qiskit.providers.fake_provider.FakeMumbai")() | A fake 27 qubit backend. |
+| [`FakeNairobi`](qiskit.providers.fake_provider.FakeNairobi "qiskit.providers.fake_provider.FakeNairobi")() | A fake 7 qubit backend. |
+| [`FakeOurense`](qiskit.providers.fake_provider.FakeOurense "qiskit.providers.fake_provider.FakeOurense")() | A fake 5 qubit backend. |
+| [`FakeParis`](qiskit.providers.fake_provider.FakeParis "qiskit.providers.fake_provider.FakeParis")() | A fake Paris backend. |
+| [`FakePoughkeepsie`](qiskit.providers.fake_provider.FakePoughkeepsie "qiskit.providers.fake_provider.FakePoughkeepsie")() | A fake Poughkeepsie backend. |
+| [`FakeQuito`](qiskit.providers.fake_provider.FakeQuito "qiskit.providers.fake_provider.FakeQuito")() | A fake 5 qubit backend. |
+| [`FakeRochester`](qiskit.providers.fake_provider.FakeRochester "qiskit.providers.fake_provider.FakeRochester")() | A fake Rochester backend. |
+| [`FakeRome`](qiskit.providers.fake_provider.FakeRome "qiskit.providers.fake_provider.FakeRome")() | A fake 5 qubit backend. |
+| [`FakeRueschlikon`](qiskit.providers.fake_provider.FakeRueschlikon "qiskit.providers.fake_provider.FakeRueschlikon")() | A fake 16 qubit backend. |
+| [`FakeSantiago`](qiskit.providers.fake_provider.FakeSantiago "qiskit.providers.fake_provider.FakeSantiago")() | A fake Santiago backend. |
+| [`FakeSingapore`](qiskit.providers.fake_provider.FakeSingapore "qiskit.providers.fake_provider.FakeSingapore")() | A fake Singapore backend. |
+| [`FakeSydney`](qiskit.providers.fake_provider.FakeSydney "qiskit.providers.fake_provider.FakeSydney")() | A fake 27 qubit backend. |
+| [`FakeTenerife`](qiskit.providers.fake_provider.FakeTenerife "qiskit.providers.fake_provider.FakeTenerife")() | A fake 5 qubit backend. |
+| [`FakeTokyo`](qiskit.providers.fake_provider.FakeTokyo "qiskit.providers.fake_provider.FakeTokyo")() | A fake 20 qubit backend. |
+| [`FakeToronto`](qiskit.providers.fake_provider.FakeToronto "qiskit.providers.fake_provider.FakeToronto")() | A fake 27 qubit backend. |
+| [`FakeValencia`](qiskit.providers.fake_provider.FakeValencia "qiskit.providers.fake_provider.FakeValencia")() | A fake 5 qubit backend. |
+| [`FakeVigo`](qiskit.providers.fake_provider.FakeVigo "qiskit.providers.fake_provider.FakeVigo")() | A fake 5 qubit backend. |
+| [`FakeWashington`](qiskit.providers.fake_provider.FakeWashington "qiskit.providers.fake_provider.FakeWashington")() | A fake 127 qubit backend. |
+| [`FakeYorktown`](qiskit.providers.fake_provider.FakeYorktown "qiskit.providers.fake_provider.FakeYorktown")() | A fake 5 qubit backend. |
+
+## Special Fake Backends
+
+Special fake backends are fake backends that were created for special testing purposes.
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
+| [`FakeQasmSimulator`](qiskit.providers.fake_provider.FakeQasmSimulator "qiskit.providers.fake_provider.FakeQasmSimulator")() | A fake simulator backend. |
+| [`FakeOpenPulse2Q`](qiskit.providers.fake_provider.FakeOpenPulse2Q "qiskit.providers.fake_provider.FakeOpenPulse2Q")() | A fake 2 qubit backend for pulse test. |
+| [`FakeOpenPulse3Q`](qiskit.providers.fake_provider.FakeOpenPulse3Q "qiskit.providers.fake_provider.FakeOpenPulse3Q")() | Trivial extension of the FakeOpenPulse2Q. |
+| [`Fake1Q`](qiskit.providers.fake_provider.Fake1Q "qiskit.providers.fake_provider.Fake1Q")() | A fake 1Q backend. |
+| [`FakeBackendV2`](qiskit.providers.fake_provider.FakeBackendV2 "qiskit.providers.fake_provider.FakeBackendV2")() | A mock backend that doesn't implement run() to test compatibility with Terra internals. |
+| [`FakeBackend5QV2`](qiskit.providers.fake_provider.FakeBackend5QV2 "qiskit.providers.fake_provider.FakeBackend5QV2")(\[bidirectional]) | A mock backend that doesn't implement run() to test compatibility with Terra internals. |
+| [`FakeMumbaiFractionalCX`](qiskit.providers.fake_provider.FakeMumbaiFractionalCX "qiskit.providers.fake_provider.FakeMumbaiFractionalCX")() | A fake mumbai backend. |
+| [`ConfigurableFakeBackend`](qiskit.providers.fake_provider.ConfigurableFakeBackend "qiskit.providers.fake_provider.ConfigurableFakeBackend")(name, n\_qubits\[, ...]) | Configurable backend. |
+| [`GenericBackendV2`](qiskit.providers.fake_provider.GenericBackendV2 "qiskit.providers.fake_provider.GenericBackendV2")(num\_qubits\[, basis\_gates, ...]) | Generic [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") implementation with a configurable constructor. |
+
+## Fake Backend Base Classes
+
+The fake backends based on IBM hardware are based on a set of base classes:
+
+
+
+`qiskit.providers.fake_provider.fake_backend.FakeBackendV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/fake_backend.py "view source code")
+
+A fake backend class for testing and noisy simulation using real backend snapshots.
+
+The class inherits [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") class. This version differs from earlier [`FakeBackend`](#qiskit.providers.fake_provider.FakeBackend "qiskit.providers.fake_provider.FakeBackend") (V1) class in a few aspects. Firstly, configuration attribute no longer exists. Instead, attributes exposing equivalent required immutable properties of the backend device are added. For example `fake_backend.configuration().n_qubits` is accessible from `fake_backend.num_qubits` now. Secondly, this version removes extra abstractions [`FakeQasmBackend`](#qiskit.providers.fake_provider.FakeQasmBackend "qiskit.providers.fake_provider.FakeQasmBackend") and [`FakePulseBackend`](#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.FakePulseBackend") that were present in V1.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+
+
+`qiskit.providers.fake_provider.FakeBackend(configuration, time_alive=10)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/fake_backend.py "view source code")
+
+This is a dummy backend just for testing purposes.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+
+
+`qiskit.providers.fake_provider.FakeQasmBackend`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/fake_qasm_backend.py "view source code")
+
+A fake OpenQASM backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+
+
+`qiskit.providers.fake_provider.FakePulseBackend`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/fake_pulse_backend.py "view source code")
+
+A fake pulse backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
diff --git a/docs/api/qiskit/0.46/providers_models.md b/docs/api/qiskit/0.46/providers_models.md
new file mode 100644
index 00000000000..0816d353708
--- /dev/null
+++ b/docs/api/qiskit/0.46/providers_models.md
@@ -0,0 +1,39 @@
+---
+title: models
+description: API reference for qiskit.providers.models
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.providers.models
+---
+
+
+
+
+
+
+
+# Backend Objects
+
+
+
+`qiskit.providers.models`
+
+Qiskit schema-conformant objects used by the backends and providers.
+
+## Backend Objects
+
+| | |
+| -------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
+| [`BackendConfiguration`](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")(backend\_name, ...\[, ...]) | Backwards compat shim representing an abstract backend configuration. |
+| [`BackendProperties`](qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties")(backend\_name, ...) | Class representing backend properties |
+| [`BackendStatus`](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")(backend\_name, backend\_version, ...) | Class representing Backend Status. |
+| [`QasmBackendConfiguration`](qiskit.providers.models.QasmBackendConfiguration "qiskit.providers.models.QasmBackendConfiguration")(backend\_name, ...) | Class representing an OpenQASM 2.0 Backend Configuration. |
+| [`PulseBackendConfiguration`](qiskit.providers.models.PulseBackendConfiguration "qiskit.providers.models.PulseBackendConfiguration")(backend\_name, ...) | Static configuration state for an OpenPulse enabled backend. |
+| [`UchannelLO`](qiskit.providers.models.UchannelLO "qiskit.providers.models.UchannelLO")(q, scale) | Class representing a U Channel LO |
+| [`GateConfig`](qiskit.providers.models.GateConfig "qiskit.providers.models.GateConfig")(name, parameters, qasm\_def\[, ...]) | Class representing a Gate Configuration |
+| [`PulseDefaults`](qiskit.providers.models.PulseDefaults "qiskit.providers.models.PulseDefaults")(qubit\_freq\_est, meas\_freq\_est, ...) | Description of default settings for Pulse systems. |
+| [`Command`](qiskit.providers.models.Command "qiskit.providers.models.Command")(name\[, qubits, sequence]) | Class representing a Command. |
+| [`JobStatus`](qiskit.providers.models.JobStatus "qiskit.providers.models.JobStatus")(job\_id, status, status\_msg, \*\*kwargs) | Model for JobStatus. |
+| [`GateProperties`](qiskit.providers.models.GateProperties "qiskit.providers.models.GateProperties")(qubits, gate, parameters, ...) | Class representing a gate's properties |
+| [`Nduv`](qiskit.providers.models.Nduv "qiskit.providers.models.Nduv")(date, name, unit, value) | Class representing name-date-unit-value |
+
diff --git a/docs/api/qiskit/0.46/pulse.md b/docs/api/qiskit/0.46/pulse.md
new file mode 100644
index 00000000000..5ffda402d4f
--- /dev/null
+++ b/docs/api/qiskit/0.46/pulse.md
@@ -0,0 +1,2798 @@
+---
+title: pulse
+description: API reference for qiskit.pulse
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.pulse
+---
+
+
+
+
+
+
+
+# Pulse
+
+
+
+`qiskit.pulse`
+
+Qiskit-Pulse is a pulse-level quantum programming kit. This lower level of programming offers the user more control than programming with [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")s.
+
+Extracting the greatest performance from quantum hardware requires real-time pulse-level instructions. Pulse answers that need: it enables the quantum physicist *user* to specify the exact time dynamics of an experiment. It is especially powerful for error mitigation techniques.
+
+The input is given as arbitrary, time-ordered signals (see: [Instructions](#pulse-insts)) scheduled in parallel over multiple virtual hardware or simulator resources (see: [Channels](#pulse-channels)). The system also allows the user to recover the time dynamics of the measured output.
+
+This is sufficient to allow the quantum physicist to explore and correct for noise in a quantum system.
+
+
+
+
+
+
+
+## Instructions
+
+
+
+`qiskit.pulse.instructions`
+
+The `instructions` module holds the various [`Instruction`](#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.Instruction")s which are supported by Qiskit Pulse. Instructions have operands, which typically include at least one [`Channel`](#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel") specifying where the instruction will be applied.
+
+Every instruction has a duration, whether explicitly included as an operand or implicitly defined. For instance, a [`ShiftPhase`](qiskit.pulse.instructions.ShiftPhase "qiskit.pulse.instructions.ShiftPhase") instruction can be instantiated with operands *phase* and *channel*, for some float `phase` and a [`Channel`](#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel") `channel`:
+
+```python
+ShiftPhase(phase, channel)
+```
+
+The duration of this instruction is implicitly zero. On the other hand, the [`Delay`](qiskit.pulse.instructions.Delay "qiskit.pulse.instructions.Delay") instruction takes an explicit duration:
+
+```python
+Delay(duration, channel)
+```
+
+An instruction can be added to a [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule"), which is a sequence of scheduled Pulse `Instruction` s over many channels. `Instruction` s and `Schedule` s implement the same interface.
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`Acquire`](qiskit.pulse.instructions.Acquire "qiskit.pulse.instructions.Acquire")(duration, channel\[, mem\_slot, ...]) | The Acquire instruction is used to trigger the ADC associated with a particular qubit; e.g. |
+| [`Call`](qiskit.pulse.instructions.Call "qiskit.pulse.instructions.Call")(subroutine\[, value\_dict, name]) | Pulse `Call` instruction. |
+| [`Reference`](qiskit.pulse.instructions.Reference "qiskit.pulse.instructions.Reference")(name, \*extra\_keys) | Pulse compiler directive that refers to a subroutine. |
+| [`Delay`](qiskit.pulse.instructions.Delay "qiskit.pulse.instructions.Delay")(duration, channel\[, name]) | A blocking instruction with no other effect. |
+| [`Play`](qiskit.pulse.instructions.Play "qiskit.pulse.instructions.Play")(pulse, channel\[, name]) | This instruction is responsible for applying a pulse on a channel. |
+| [`RelativeBarrier`](qiskit.pulse.instructions.RelativeBarrier "qiskit.pulse.instructions.RelativeBarrier")(\*channels\[, name]) | Pulse `RelativeBarrier` directive. |
+| [`SetFrequency`](qiskit.pulse.instructions.SetFrequency "qiskit.pulse.instructions.SetFrequency")(frequency, channel\[, name]) | Set the channel frequency. |
+| [`ShiftFrequency`](qiskit.pulse.instructions.ShiftFrequency "qiskit.pulse.instructions.ShiftFrequency")(frequency, channel\[, name]) | Shift the channel frequency away from the current frequency. |
+| [`SetPhase`](qiskit.pulse.instructions.SetPhase "qiskit.pulse.instructions.SetPhase")(phase, channel\[, name]) | The set phase instruction sets the phase of the proceeding pulses on that channel to `phase` radians. |
+| [`ShiftPhase`](qiskit.pulse.instructions.ShiftPhase "qiskit.pulse.instructions.ShiftPhase")(phase, channel\[, name]) | The shift phase instruction updates the modulation phase of proceeding pulses played on the same [`Channel`](#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel"). |
+| [`Snapshot`](qiskit.pulse.instructions.Snapshot "qiskit.pulse.instructions.Snapshot")(label\[, snapshot\_type, name]) | An instruction targeted for simulators, to capture a moment in the simulation. |
+| [`TimeBlockade`](qiskit.pulse.instructions.TimeBlockade "qiskit.pulse.instructions.TimeBlockade")(duration, channel\[, name]) | Pulse `TimeBlockade` directive. |
+
+These are all instances of the same base class:
+
+
+
+`qiskit.pulse.instructions.Instruction(operands, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/instructions/instruction.py "view source code")
+
+The smallest schedulable unit: a single instruction. It has a fixed duration and specified channels.
+
+Instruction initializer.
+
+**Parameters**
+
+* **operands** ([*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")) – The argument list.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Optional display name for this instruction.
+
+
+
+
+
+## Pulse Library
+
+
+
+`qiskit.pulse.library`
+
+This library provides Pulse users with convenient methods to build Pulse waveforms.
+
+A pulse programmer can choose from one of several [Pulse Models](#pulse-models) such as [`Waveform`](qiskit.pulse.library.Waveform "qiskit.pulse.library.Waveform") and [`SymbolicPulse`](qiskit.pulse.library.SymbolicPulse "qiskit.pulse.library.SymbolicPulse") to create a pulse program. The [`Waveform`](qiskit.pulse.library.Waveform "qiskit.pulse.library.Waveform") model directly stores the waveform data points in each class instance. This model provides the most flexibility to express arbitrary waveforms and allows a rapid prototyping of new control techniques. However, this model is typically memory inefficient and might be hard to scale to large-size quantum processors. Several waveform subclasses are defined by [Waveform Pulse Representation](#waveforms), but a user can also directly instantiate the [`Waveform`](qiskit.pulse.library.Waveform "qiskit.pulse.library.Waveform") class with `samples` argument which is usually a complex numpy array or any kind of array-like data.
+
+In contrast, the [`SymbolicPulse`](qiskit.pulse.library.SymbolicPulse "qiskit.pulse.library.SymbolicPulse") model only stores the function and its parameters that generate the waveform in a class instance. It thus provides greater memory efficiency at the price of less flexibility in the waveform. This model also defines a small set of pulse subclasses in [Parametric Pulse Representation](#symbolic-pulses) which are commonly used in superconducting quantum processors. An instance of these subclasses can be serialized in the [QPY Format](qpy#qpy-format) while keeping the memory-efficient parametric representation of waveforms. Note that [`Waveform`](qiskit.pulse.library.Waveform "qiskit.pulse.library.Waveform") object can be generated from an instance of a [`SymbolicPulse`](qiskit.pulse.library.SymbolicPulse "qiskit.pulse.library.SymbolicPulse") which will set values for the parameters and sample the parametric expression to create the [`Waveform`](qiskit.pulse.library.Waveform "qiskit.pulse.library.Waveform").
+
+
+
+### Pulse Models
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
+| [`Waveform`](qiskit.pulse.library.Waveform "qiskit.pulse.library.Waveform")(samples\[, name, epsilon, ...]) | A pulse specified completely by complex-valued samples; each sample is played for the duration of the backend cycle-time, dt. |
+| [`SymbolicPulse`](qiskit.pulse.library.SymbolicPulse "qiskit.pulse.library.SymbolicPulse")(pulse\_type, duration\[, ...]) | The pulse representation model with parameters and symbolic expressions. |
+| [`ParametricPulse`](qiskit.pulse.library.ParametricPulse "qiskit.pulse.library.ParametricPulse")(duration\[, name, ...]) | The abstract superclass for parametric pulses. |
+
+
+
+### Waveform Pulse Representation
+
+### constant
+
+
+
+`qiskit.pulse.library.constant(duration, amp, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/discrete.py "view source code")
+
+Generates constant-sampled [`Waveform`](qiskit.pulse.library.Waveform "qiskit.pulse.library.Waveform").
+
+For $A=$ `amp`, samples from the function:
+
+$$
+f(x) = A
+$$
+
+
+ The function `qiskit.pulse.library.discrete.constant()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. The discrete pulses library, including constant() is deprecated. Instead, use the SymbolicPulse library to create the waveform with pulse.Constant(…).get\_waveform(). Note that complex value support for the amp parameter is deprecated in the SymbolicPulse library. Use two float values for (amp, angle) instead of complex amp
+
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Duration of pulse. Must be greater than zero.
+* **amp** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")) – Complex pulse amplitude.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of pulse.
+
+**Return type**
+
+[*Waveform*](qiskit.pulse.library.Waveform "qiskit.pulse.library.waveform.Waveform")
+
+### zero
+
+
+
+`qiskit.pulse.library.zero(duration, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/discrete.py "view source code")
+
+Generates zero-sampled [`Waveform`](qiskit.pulse.library.Waveform "qiskit.pulse.library.Waveform").
+
+Samples from the function:
+
+$$
+f(x) = 0
+$$
+
+
+ The function `qiskit.pulse.library.discrete.zero()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. The discrete pulses library, including zero() is deprecated. Instead, use the SymbolicPulse library to create the waveform with pulse.Constant(amp=0,…).get\_waveform().
+
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Duration of pulse. Must be greater than zero.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of pulse.
+
+**Return type**
+
+[*Waveform*](qiskit.pulse.library.Waveform "qiskit.pulse.library.waveform.Waveform")
+
+### square
+
+
+
+`qiskit.pulse.library.square(duration, amp, freq=None, phase=0, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/discrete.py "view source code")
+
+Generates square wave [`Waveform`](qiskit.pulse.library.Waveform "qiskit.pulse.library.Waveform").
+
+For $A=$ `amp`, $T=$ `period`, and $\phi=$ `phase`, applies the midpoint sampling strategy to generate a discrete pulse sampled from the continuous function:
+
+$$
+f(x) = A \text{sign}\left[ \sin\left(\frac{2 \pi x}{T} + 2\phi\right) \right]
+$$
+
+with the convention $\text{sign}(0) = 1$.
+
+
+ The function `qiskit.pulse.library.discrete.square()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. The discrete pulses library, including square() is deprecated. Instead, use the SymbolicPulse library to create the waveform with pulse.Square(…).get\_waveform(). Note that pulse.Square() does not support complex values for amp, and that the phase is defined differently. See documentation.
+
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Duration of pulse. Must be greater than zero.
+* **amp** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")) – Pulse amplitude. Wave range is $[-$ `amp` $,$ `amp` $]$.
+* **freq** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Pulse frequency, units of 1./dt. If `None` defaults to 1./duration.
+* **phase** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Pulse phase.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of pulse.
+
+**Return type**
+
+[*Waveform*](qiskit.pulse.library.Waveform "qiskit.pulse.library.waveform.Waveform")
+
+### sawtooth
+
+
+
+`qiskit.pulse.library.sawtooth(duration, amp, freq=None, phase=0, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/discrete.py "view source code")
+
+Generates sawtooth wave [`Waveform`](qiskit.pulse.library.Waveform "qiskit.pulse.library.Waveform").
+
+For $A=$ `amp`, $T=$ `period`, and $\phi=$ `phase`, applies the midpoint sampling strategy to generate a discrete pulse sampled from the continuous function:
+
+$$
+f(x) = 2 A \left( g(x) - \left\lfloor \frac{1}{2} + g(x) \right\rfloor\right)
+$$
+
+where $g(x) = x/T + \phi/\pi$.
+
+
+ The function `qiskit.pulse.library.discrete.sawtooth()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. The discrete pulses library, including sawtooth() is deprecated. Instead, use the SymbolicPulse library to create the waveform with pulse.Sawtooth(…).get\_waveform(). Note that pulse.Sawtooth() does not support complex values for amp. Instead, use two float values for (amp, angle). Also note that the phase is defined differently, such that 2\*pi phase shifts by a full cycle.
+
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Duration of pulse. Must be greater than zero.
+* **amp** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")) – Pulse amplitude. Wave range is $[-$ `amp` $,$ `amp` $]$.
+* **freq** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Pulse frequency, units of 1./dt. If `None` defaults to 1./duration.
+* **phase** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Pulse phase.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of pulse.
+
+**Return type**
+
+[*Waveform*](qiskit.pulse.library.Waveform "qiskit.pulse.library.waveform.Waveform")
+
+**Example**
+
+```python
+import matplotlib.pyplot as plt
+from qiskit.pulse.library import sawtooth
+import numpy as np
+
+duration = 100
+amp = 1
+freq = 1 / duration
+sawtooth_wave = np.real(sawtooth(duration, amp, freq).samples)
+plt.plot(range(duration), sawtooth_wave)
+plt.show()
+```
+
+
+
+### triangle
+
+
+
+`qiskit.pulse.library.triangle(duration, amp, freq=None, phase=0, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/discrete.py "view source code")
+
+Generates triangle wave [`Waveform`](qiskit.pulse.library.Waveform "qiskit.pulse.library.Waveform").
+
+For $A=$ `amp`, $T=$ `period`, and $\phi=$ `phase`, applies the midpoint sampling strategy to generate a discrete pulse sampled from the continuous function:
+
+$$
+f(x) = A \left(-2\left|\text{sawtooth}(x, A, T, \phi)\right| + 1\right)
+$$
+
+This a non-sinusoidal wave with linear ramping.
+
+
+ The function `qiskit.pulse.library.discrete.triangle()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. The discrete pulses library, including triangle() is deprecated. Instead, use the SymbolicPulse library to create the waveform with pulse.Triangle(…).get\_waveform(). Note that pulse.Triangle() does not support complex values for amp. Instead, use two float values for (amp, angle).
+
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Duration of pulse. Must be greater than zero.
+* **amp** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")) – Pulse amplitude. Wave range is $[-$ `amp` $,$ `amp` $]$.
+* **freq** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Pulse frequency, units of 1./dt. If `None` defaults to 1./duration.
+* **phase** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Pulse phase.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of pulse.
+
+**Return type**
+
+[*Waveform*](qiskit.pulse.library.Waveform "qiskit.pulse.library.waveform.Waveform")
+
+**Example**
+
+```python
+import matplotlib.pyplot as plt
+from qiskit.pulse.library import triangle
+import numpy as np
+
+duration = 100
+amp = 1
+freq = 1 / duration
+triangle_wave = np.real(triangle(duration, amp, freq).samples)
+plt.plot(range(duration), triangle_wave)
+plt.show()
+```
+
+
+
+### cos
+
+
+
+`qiskit.pulse.library.cos(duration, amp, freq=None, phase=0, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/discrete.py "view source code")
+
+Generates cosine wave [`Waveform`](qiskit.pulse.library.Waveform "qiskit.pulse.library.Waveform").
+
+For $A=$ `amp`, $\omega=$ `freq`, and $\phi=$ `phase`, applies the midpoint sampling strategy to generate a discrete pulse sampled from the continuous function:
+
+$$
+f(x) = A \cos(2 \pi \omega x + \phi)
+$$
+
+
+ The function `qiskit.pulse.library.discrete.cos()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. The discrete pulses library, including cos() is deprecated. Instead, use the SymbolicPulse library to create the waveform with pulse.Cos(…).get\_waveform(). Note that pulse.Cos() does not support complex values for amp. Instead, use two float values for (amp, angle).
+
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Duration of pulse. Must be greater than zero.
+* **amp** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")) – Pulse amplitude.
+* **freq** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Pulse frequency, units of 1/dt. If `None` defaults to single cycle.
+* **phase** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Pulse phase.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of pulse.
+
+**Return type**
+
+[*Waveform*](qiskit.pulse.library.Waveform "qiskit.pulse.library.waveform.Waveform")
+
+### sin
+
+
+
+`qiskit.pulse.library.sin(duration, amp, freq=None, phase=0, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/discrete.py "view source code")
+
+Generates sine wave [`Waveform`](qiskit.pulse.library.Waveform "qiskit.pulse.library.Waveform").
+
+For $A=$ `amp`, $\omega=$ `freq`, and $\phi=$ `phase`, applies the midpoint sampling strategy to generate a discrete pulse sampled from the continuous function:
+
+$$
+f(x) = A \sin(2 \pi \omega x + \phi)
+$$
+
+
+ The function `qiskit.pulse.library.discrete.sin()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. The discrete pulses library, including sin() is deprecated. Instead, use the SymbolicPulse library to create the waveform with pulse.Sin(…).get\_waveform(). Note that pulse.Sin() does not support complex values for amp. Instead, use two float values for (amp, angle).
+
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Duration of pulse. Must be greater than zero.
+* **amp** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")) – Pulse amplitude.
+* **freq** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Pulse frequency, units of 1/dt. If `None` defaults to single cycle.
+* **phase** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Pulse phase.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of pulse.
+
+**Return type**
+
+[*Waveform*](qiskit.pulse.library.Waveform "qiskit.pulse.library.waveform.Waveform")
+
+### gaussian
+
+
+
+`qiskit.pulse.library.gaussian(duration, amp, sigma, name=None, zero_ends=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/discrete.py "view source code")
+
+Generates unnormalized gaussian [`Waveform`](qiskit.pulse.library.Waveform "qiskit.pulse.library.Waveform").
+
+For $A=$ `amp` and $\sigma=$ `sigma`, applies the `midpoint` sampling strategy to generate a discrete pulse sampled from the continuous function:
+
+$$
+f(x) = A\exp\left(\left(\frac{x - \mu}{2\sigma}\right)^2 \right),
+$$
+
+with the center $\mu=$ `duration/2`.
+
+If `zero_ends==True`, each output sample $y$ is modified according to:
+
+$$
+y \mapsto A\frac{y-y^*}{A-y^*},
+$$
+
+where $y^*$ is the value of the endpoint samples. This sets the endpoints to $0$ while preserving the amplitude at the center. If $A=y^*$, $y$ is set to $1$. By default, the endpoints are at `x = -1, x = duration + 1`.
+
+Integrated area under the full curve is `amp * np.sqrt(2*np.pi*sigma**2)`
+
+
+ The function `qiskit.pulse.library.discrete.gaussian()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. The discrete pulses library, including gaussian() is deprecated. Instead, use the SymbolicPulse library to create the waveform with pulse.Gaussian(…).get\_waveform(). Note that complex value support for the amp parameter is deprecated in the SymbolicPulse library. It is therefore recommended to use two float values for (amp, angle) instead of complex amp
+
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Duration of pulse. Must be greater than zero.
+* **amp** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")) – Pulse amplitude at `duration/2`.
+* **sigma** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Width (standard deviation) of pulse.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of pulse.
+* **zero\_ends** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, zero ends at `x = -1, x = duration + 1`, but rescale to preserve amp.
+
+**Return type**
+
+[*Waveform*](qiskit.pulse.library.Waveform "qiskit.pulse.library.waveform.Waveform")
+
+### gaussian\_deriv
+
+
+
+`qiskit.pulse.library.gaussian_deriv(duration, amp, sigma, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/discrete.py "view source code")
+
+Generates unnormalized gaussian derivative [`Waveform`](qiskit.pulse.library.Waveform "qiskit.pulse.library.Waveform").
+
+For $A=$ `amp` and $\sigma=$ `sigma` applies the midpoint sampling strategy to generate a discrete pulse sampled from the continuous function:
+
+$$
+f(x) = -A\frac{(x - \mu)}{\sigma^2}\exp
+ \left(-\frac{1}{2}\left(\frac{x - \mu}{\sigma}\right)^2 \right)
+$$
+
+i.e. the derivative of the Gaussian function, with center $\mu=$ `duration/2`.
+
+
+ The function `qiskit.pulse.library.discrete.gaussian_deriv()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. The discrete pulses library, including gaussian\_deriv() is deprecated. Instead, use the SymbolicPulse library to create the waveform with pulse.GaussianDeriv(…).get\_waveform(). Note that pulse.GaussianDeriv() does not support complex values for amp. Instead, use two float values for (amp, angle).
+
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Duration of pulse. Must be greater than zero.
+* **amp** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")) – Pulse amplitude of corresponding Gaussian at the pulse center (`duration/2`).
+* **sigma** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Width (standard deviation) of pulse.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of pulse.
+
+**Return type**
+
+[*Waveform*](qiskit.pulse.library.Waveform "qiskit.pulse.library.waveform.Waveform")
+
+### sech
+
+
+
+`qiskit.pulse.library.sech(duration, amp, sigma, name=None, zero_ends=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/discrete.py "view source code")
+
+Generates unnormalized sech [`Waveform`](qiskit.pulse.library.Waveform "qiskit.pulse.library.Waveform").
+
+For $A=$ `amp` and $\sigma=$ `sigma`, applies the `midpoint` sampling strategy to generate a discrete pulse sampled from the continuous function:
+
+$$
+f(x) = A\text{sech}\left(\frac{x-\mu}{\sigma} \right)
+$$
+
+with the center $\mu=$ `duration/2`.
+
+If `zero_ends==True`, each output sample $y$ is modified according to:
+
+$$
+y \mapsto A\frac{y-y^*}{A-y^*},
+$$
+
+where $y^*$ is the value of the endpoint samples. This sets the endpoints to $0$ while preserving the amplitude at the center. If $A=y^*$, $y$ is set to $1$. By default, the endpoints are at `x = -1, x = duration + 1`.
+
+
+ The function `qiskit.pulse.library.discrete.sech()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. The discrete pulses library, including sech() is deprecated. Instead, use the SymbolicPulse library to create the waveform with pulse.Sech(…).get\_waveform(). Note that pulse.Sech() does not support complex values for amp. Instead, use two float values for (amp, angle).
+
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Duration of pulse. Must be greater than zero.
+* **amp** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")) – Pulse amplitude at duration/2.
+* **sigma** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Width (standard deviation) of pulse.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Name of pulse.
+* **zero\_ends** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, zero ends at `x = -1, x = duration + 1`, but rescale to preserve amp.
+
+**Return type**
+
+[*Waveform*](qiskit.pulse.library.Waveform "qiskit.pulse.library.waveform.Waveform")
+
+### sech\_deriv
+
+
+
+`qiskit.pulse.library.sech_deriv(duration, amp, sigma, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/discrete.py "view source code")
+
+Generates unnormalized sech derivative [`Waveform`](qiskit.pulse.library.Waveform "qiskit.pulse.library.Waveform").
+
+For $A=$ `amp`, $\sigma=$ `sigma`, and center $\mu=$ `duration/2`, applies the midpoint sampling strategy to generate a discrete pulse sampled from the continuous function:
+
+$$
+f(x) = \frac{d}{dx}\left[A\text{sech}\left(\frac{x-\mu}{\sigma} \right)\right],
+
+
+$$
+
+i.e. the derivative of $\text{sech}$.
+
+
+ The function `qiskit.pulse.library.discrete.sech_deriv()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. The discrete pulses library, including sech\_deriv() is deprecated. Instead, use the SymbolicPulse library to create the waveform with pulse.SechDeriv(…).get\_waveform(). Note that pulse.SechDeriv() does not support complex values for amp. Instead, use two float values for (amp, angle).
+
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Duration of pulse. Must be greater than zero.
+* **amp** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")) – Pulse amplitude at center.
+* **sigma** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Width (standard deviation) of pulse.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Name of pulse.
+
+**Return type**
+
+[*Waveform*](qiskit.pulse.library.Waveform "qiskit.pulse.library.waveform.Waveform")
+
+### gaussian\_square
+
+
+
+`qiskit.pulse.library.gaussian_square(duration, amp, sigma, risefall=None, width=None, name=None, zero_ends=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/discrete.py "view source code")
+
+Generates gaussian square [`Waveform`](qiskit.pulse.library.Waveform "qiskit.pulse.library.Waveform").
+
+For $d=$ `duration`, $A=$ `amp`, $\sigma=$ `sigma`, and $r=$ `risefall`, applies the `midpoint` sampling strategy to generate a discrete pulse sampled from the continuous function:
+
+$$
+f(x) = \begin{cases}
+ g(x - r) ) & x\leq r \\
+ A & r\leq x\leq d-r \\
+ g(x - (d - r)) & d-r\leq x
+ \end{cases}
+$$
+
+where $g(x)$ is the Gaussian function sampled from in [`gaussian()`](#qiskit.pulse.library.gaussian "qiskit.pulse.library.gaussian") with $A=$ `amp`, $\mu=1$, and $\sigma=$ `sigma`. I.e. $f(x)$ represents a square pulse with smooth Gaussian edges.
+
+If `zero_ends == True`, the samples for the Gaussian ramps are remapped as in [`gaussian()`](#qiskit.pulse.library.gaussian "qiskit.pulse.library.gaussian").
+
+
+ The function `qiskit.pulse.library.discrete.gaussian_square()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. The discrete pulses library, including gaussian\_square() is deprecated. Instead, use the SymbolicPulse library to create the waveform with pulse.GaussianSquare(…).get\_waveform(). Note that complex value support for the amp parameter is deprecated in the SymbolicPulse library. It is therefore recommended to use two float values for (amp, angle) instead of complex amp
+
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Duration of pulse. Must be greater than zero.
+* **amp** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")) – Pulse amplitude.
+* **sigma** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Width (standard deviation) of Gaussian rise/fall portion of the pulse.
+* **risefall** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – Number of samples over which pulse rise and fall happen. Width of square portion of pulse will be `duration-2*risefall`.
+* **width** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The duration of the embedded square pulse. Only one of `width` or `risefall` should be specified as the functional form requires `width = duration - 2 * risefall`.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of pulse.
+* **zero\_ends** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, zero ends at `x = -1, x = duration + 1`, but rescale to preserve amp.
+
+**Raises**
+
+[**PulseError**](#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – If `risefall` and `width` arguments are inconsistent or not enough info.
+
+**Return type**
+
+[*Waveform*](qiskit.pulse.library.Waveform "qiskit.pulse.library.waveform.Waveform")
+
+### drag
+
+
+
+`qiskit.pulse.library.drag(duration, amp, sigma, beta, name=None, zero_ends=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/discrete.py "view source code")
+
+Generates Y-only correction DRAG [`Waveform`](qiskit.pulse.library.Waveform "qiskit.pulse.library.Waveform") for standard nonlinear oscillator (SNO) \[1].
+
+For $A=$ `amp`, $\sigma=$ `sigma`, and $\beta=$ `beta`, applies the `midpoint` sampling strategy to generate a discrete pulse sampled from the continuous function:
+
+$$
+f(x) = g(x) + i \beta h(x),
+$$
+
+where $g(x)$ is the function sampled in [`gaussian()`](#qiskit.pulse.library.gaussian "qiskit.pulse.library.gaussian"), and $h(x)$ is the function sampled in [`gaussian_deriv()`](#qiskit.pulse.library.gaussian_deriv "qiskit.pulse.library.gaussian_deriv").
+
+If `zero_ends == True`, the samples from $g(x)$ are remapped as in [`gaussian()`](#qiskit.pulse.library.gaussian "qiskit.pulse.library.gaussian").
+
+
+ The function `qiskit.pulse.library.discrete.drag()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. The discrete pulses library, including drag() is deprecated. Instead, use the SymbolicPulse library to create the waveform with pulse.Drag(…).get\_waveform(). Note that complex value support for the amp parameter is deprecated in the SymbolicPulse library. It is therefore recommended to use two float values for (amp, angle) instead of complex amp
+
+
+**References**
+
+1. [*Gambetta, J. M., Motzoi, F., Merkel, S. T. & Wilhelm, F. K. “Analytic control methods for high-fidelity unitary operations in a weakly nonlinear oscillator.” Phys. Rev. A 83, 012308 (2011).*](http://dx.doi.org/10.1103/PhysRevA.83.012308)
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Duration of pulse. Must be greater than zero.
+* **amp** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")) – Pulse amplitude at center `duration/2`.
+* **sigma** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Width (standard deviation) of pulse.
+* **beta** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Y correction amplitude. For the SNO this is $\beta=-\frac{\lambda_1^2}{4\Delta_2}$. Where $\lambda_1$ is the relative coupling strength between the first excited and second excited states and $\Delta_2$ is the detuning between the respective excited states.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of pulse.
+* **zero\_ends** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, zero ends at `x = -1, x = duration + 1`, but rescale to preserve amp.
+
+**Return type**
+
+[*Waveform*](qiskit.pulse.library.Waveform "qiskit.pulse.library.waveform.Waveform")
+
+
+
+### Parametric Pulse Representation
+
+| | |
+| -------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`Constant`](qiskit.pulse.library.Constant_class.rst#qiskit.pulse.library.Constant "qiskit.pulse.library.Constant")(duration, amp\[, angle, name, ...]) | A simple constant pulse, with an amplitude value and a duration: |
+| [`Drag`](qiskit.pulse.library.Drag_class.rst#qiskit.pulse.library.Drag "qiskit.pulse.library.Drag")(duration, amp, sigma, beta\[, angle, ...]) | The Derivative Removal by Adiabatic Gate (DRAG) pulse is a standard Gaussian pulse with an additional Gaussian derivative component and lifting applied. |
+| [`Gaussian`](qiskit.pulse.library.Gaussian_class.rst#qiskit.pulse.library.Gaussian "qiskit.pulse.library.Gaussian")(duration, amp, sigma\[, angle, ...]) | A lifted and truncated pulse envelope shaped according to the Gaussian function whose mean is centered at the center of the pulse (duration / 2): |
+| [`GaussianSquare`](qiskit.pulse.library.GaussianSquare "qiskit.pulse.library.GaussianSquare")(duration, amp, sigma\[, ...]) | A square pulse with a Gaussian shaped risefall on both sides lifted such that its first sample is zero. |
+| [`GaussianSquareDrag`](qiskit.pulse.library.GaussianSquareDrag "qiskit.pulse.library.GaussianSquareDrag")(duration, amp, sigma, beta) | A square pulse with a Drag shaped rise and fall |
+| [`gaussian_square_echo`](qiskit.pulse.library.gaussian_square_echo "qiskit.pulse.library.gaussian_square_echo")(duration, amp, sigma\[, ...]) | An echoed Gaussian square pulse with an active tone overlaid on it. |
+| [`GaussianDeriv`](qiskit.pulse.library.GaussianDeriv "qiskit.pulse.library.GaussianDeriv")(duration, amp, sigma\[, angle, ...]) | An unnormalized Gaussian derivative pulse. |
+| [`Sin`](qiskit.pulse.library.Sin_class.rst#qiskit.pulse.library.Sin "qiskit.pulse.library.Sin")(duration, amp, phase\[, freq, angle, ...]) | A sinusoidal pulse. |
+| [`Cos`](qiskit.pulse.library.Cos_class.rst#qiskit.pulse.library.Cos "qiskit.pulse.library.Cos")(duration, amp, phase\[, freq, angle, ...]) | A cosine pulse. |
+| [`Sawtooth`](qiskit.pulse.library.Sawtooth_class.rst#qiskit.pulse.library.Sawtooth "qiskit.pulse.library.Sawtooth")(duration, amp, phase\[, freq, ...]) | A sawtooth pulse. |
+| [`Triangle`](qiskit.pulse.library.Triangle_class.rst#qiskit.pulse.library.Triangle "qiskit.pulse.library.Triangle")(duration, amp, phase\[, freq, ...]) | A triangle wave pulse. |
+| [`Square`](qiskit.pulse.library.Square_fun.rst#qiskit.pulse.library.Square "qiskit.pulse.library.Square")(duration, amp, phase\[, freq, angle, ...]) | A square wave pulse. |
+| [`Sech`](qiskit.pulse.library.Sech_fun.rst#qiskit.pulse.library.Sech "qiskit.pulse.library.Sech")(duration, amp, sigma\[, angle, name, ...]) | An unnormalized sech pulse. |
+| [`SechDeriv`](qiskit.pulse.library.SechDeriv "qiskit.pulse.library.SechDeriv")(duration, amp, sigma\[, angle, ...]) | An unnormalized sech derivative pulse. |
+
+
+
+
+
+
+
+## Channels
+
+
+
+`qiskit.pulse.channels`
+
+Pulse is meant to be agnostic to the underlying hardware implementation, while still allowing low-level control. Therefore, our signal channels are *virtual* hardware channels. The backend which executes our programs is responsible for mapping these virtual channels to the proper physical channel within the quantum control hardware.
+
+Channels are characterized by their type and their index. Channels include:
+
+* transmit channels, which should subclass `PulseChannel`
+* receive channels, such as [`AcquireChannel`](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+* non-signal “channels” such as [`SnapshotChannel`](qiskit.pulse.channels.SnapshotChannel "qiskit.pulse.channels.SnapshotChannel"), [`MemorySlot`](qiskit.pulse.channels.MemorySlot "qiskit.pulse.channels.MemorySlot") and `RegisterChannel`.
+
+Novel channel types can often utilize the [`ControlChannel`](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel"), but if this is not sufficient, new channel types can be created. Then, they must be supported in the PulseQobj schema and the assembler. Channels are characterized by their type and their index. See each channel type below to learn more.
+
+| | |
+| ---------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
+| [`DriveChannel`](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")(\*args, \*\*kwargs) | Drive channels transmit signals to qubits which enact gate operations. |
+| [`MeasureChannel`](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")(\*args, \*\*kwargs) | Measure channels transmit measurement stimulus pulses for readout. |
+| [`AcquireChannel`](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")(\*args, \*\*kwargs) | Acquire channels are used to collect data. |
+| [`ControlChannel`](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")(\*args, \*\*kwargs) | Control channels provide supplementary control over the qubit to the drive channel. |
+| [`RegisterSlot`](qiskit.pulse.channels.RegisterSlot "qiskit.pulse.channels.RegisterSlot")(\*args, \*\*kwargs) | Classical resister slot channels represent classical registers (low-latency classical memory). |
+| [`MemorySlot`](qiskit.pulse.channels.MemorySlot "qiskit.pulse.channels.MemorySlot")(\*args, \*\*kwargs) | Memory slot channels represent classical memory storage. |
+| [`SnapshotChannel`](qiskit.pulse.channels.SnapshotChannel "qiskit.pulse.channels.SnapshotChannel")(\*args, \*\*kwargs) | Snapshot channels are used to specify instructions for simulators. |
+
+All channels are children of the same abstract base class:
+
+
+
+`qiskit.pulse.channels.Channel(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/channels.py "view source code")
+
+Base class of channels. Channels provide a Qiskit-side label for typical quantum control hardware signal channels. The final label -> physical channel mapping is the responsibility of the hardware backend. For instance, `DriveChannel(0)` holds instructions which the backend should map to the signal line driving gate operations on the qubit labeled (indexed) 0.
+
+When serialized channels are identified by their serialized name ``. The type of the channel is interpreted from the prefix, and the index often (but not always) maps to the qubit index. All concrete channel classes must have a `prefix` class attribute (and instances of that class have an index attribute). Base classes which have `prefix` set to `None` are prevented from being instantiated.
+
+To implement a new channel inherit from [`Channel`](#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel") and provide a unique string identifier for the `prefix` class attribute.
+
+Channel class.
+
+**Parameters**
+
+**index** – Index of channel.
+
+
+
+## Schedules
+
+Schedules are Pulse programs. They describe instruction sequences for the control hardware. The Schedule is one of the most fundamental objects to this pulse-level programming module. A `Schedule` is a representation of a *program* in Pulse. Each schedule tracks the time of each instruction occuring in parallel over multiple signal *channels*.
+
+| | |
+| -------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule")(\*schedules\[, name, metadata]) | A quantum program *schedule* with exact time constraints for its instructions, operating over all input signal *channels* and supporting special syntaxes for building. |
+| [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock")(\[name, metadata, ...]) | Time-ordered sequence of instructions with alignment context. |
+
+
+
+
+
+## Pulse Transforms
+
+
+
+`qiskit.pulse.transforms`
+
+The pulse transforms provide transformation routines to reallocate and optimize pulse programs for backends.
+
+
+
+### Alignments
+
+The alignment transforms define alignment policies of instructions in [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"). These transformations are called to create [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule")s from [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock")s.
+
+| | |
+| ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| [`AlignEquispaced`](qiskit.pulse.transforms.AlignEquispaced "qiskit.pulse.transforms.AlignEquispaced")(duration) | Align instructions with equispaced interval within a specified duration. |
+| [`AlignFunc`](qiskit.pulse.transforms.AlignFunc "qiskit.pulse.transforms.AlignFunc")(duration, func) | Allocate instructions at position specified by callback function. |
+| [`AlignLeft`](qiskit.pulse.transforms.AlignLeft "qiskit.pulse.transforms.AlignLeft")() | Align instructions in as-soon-as-possible manner. |
+| [`AlignRight`](qiskit.pulse.transforms.AlignRight "qiskit.pulse.transforms.AlignRight")() | Align instructions in as-late-as-possible manner. |
+| [`AlignSequential`](qiskit.pulse.transforms.AlignSequential "qiskit.pulse.transforms.AlignSequential")() | Align instructions sequentially. |
+
+These are all subtypes of the abstract base class [`AlignmentKind`](#qiskit.pulse.transforms.AlignmentKind "qiskit.pulse.transforms.AlignmentKind").
+
+
+
+`qiskit.pulse.transforms.AlignmentKind(context_params)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/transforms/alignments.py "view source code")
+
+An abstract class for schedule alignment.
+
+Create new context.
+
+
+
+### Canonicalization
+
+The canonicalization transforms convert schedules to a form amenable for execution on OpenPulse backends.
+
+### add\_implicit\_acquires
+
+
+
+`qiskit.pulse.transforms.add_implicit_acquires(schedule, meas_map)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/transforms/canonicalization.py "view source code")
+
+Return a new schedule with implicit acquires from the measurement mapping replaced by explicit ones.
+
+
+ Since new acquires are being added, Memory Slots will be set to match the qubit index. This may overwrite your specification.
+
+
+**Parameters**
+
+* **schedule** ([*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule") *|*[*Instruction*](#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")) – Schedule to be aligned.
+* **meas\_map** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]]*) – List of lists of qubits that are measured together.
+
+**Returns**
+
+A `Schedule` with the additional acquisition instructions.
+
+**Return type**
+
+[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")
+
+### align\_measures
+
+
+
+`qiskit.pulse.transforms.align_measures(schedules, inst_map=None, cal_gate='u3', max_calibration_duration=None, align_time=None, align_all=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/transforms/canonicalization.py "view source code")
+
+Return new schedules where measurements occur at the same physical time.
+
+This transformation will align the first [`Acquire`](qiskit.pulse.instructions.Acquire "qiskit.pulse.instructions.Acquire") on every channel to occur at the same time.
+
+Minimum measurement wait time (to allow for calibration pulses) is enforced and may be set with `max_calibration_duration`.
+
+By default only instructions containing a [`AcquireChannel`](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel") or [`MeasureChannel`](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel") will be shifted. If you wish to keep the relative timing of all instructions in the schedule set `align_all=True`.
+
+This method assumes that `MeasureChannel(i)` and `AcquireChannel(i)` correspond to the same qubit and the acquire/play instructions should be shifted together on these channels.
+
+```python
+from qiskit import pulse
+from qiskit.pulse import transforms
+
+d0 = pulse.DriveChannel(0)
+m0 = pulse.MeasureChannel(0)
+a0 = pulse.AcquireChannel(0)
+mem0 = pulse.MemorySlot(0)
+
+sched = pulse.Schedule()
+sched.append(pulse.Play(pulse.Constant(10, 0.5), d0), inplace=True)
+sched.append(pulse.Play(pulse.Constant(10, 1.), m0).shift(sched.duration), inplace=True)
+sched.append(pulse.Acquire(20, a0, mem0).shift(sched.duration), inplace=True)
+
+sched_shifted = sched << 20
+
+aligned_sched, aligned_sched_shifted = transforms.align_measures([sched, sched_shifted])
+
+assert aligned_sched == aligned_sched_shifted
+```
+
+If it is desired to only shift acquisition and measurement stimulus instructions set the flag `align_all=False`:
+
+```python
+aligned_sched, aligned_sched_shifted = transforms.align_measures(
+ [sched, sched_shifted],
+ align_all=False,
+)
+
+assert aligned_sched != aligned_sched_shifted
+```
+
+**Parameters**
+
+* **schedules** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule") *|*[*Instruction*](#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")*]*) – Collection of schedules to be aligned together
+* **inst\_map** ([*InstructionScheduleMap*](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.instruction_schedule_map.InstructionScheduleMap") *| None*) – Mapping of circuit operations to pulse schedules
+* **cal\_gate** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the gate to inspect for the calibration time
+* **max\_calibration\_duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – If provided, inst\_map and cal\_gate will be ignored
+* **align\_time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – If provided, this will be used as final align time.
+* **align\_all** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – Shift all instructions in the schedule such that they maintain their relative alignment with the shifted acquisition instruction. If `False` only the acquisition and measurement pulse instructions will be shifted.
+
+**Returns**
+
+The input list of schedules transformed to have their measurements aligned.
+
+**Raises**
+
+[**PulseError**](#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – If the provided alignment time is negative.
+
+**Return type**
+
+[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")]
+
+### block\_to\_schedule
+
+
+
+`qiskit.pulse.transforms.block_to_schedule(block)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/transforms/canonicalization.py "view source code")
+
+Convert `ScheduleBlock` to `Schedule`.
+
+**Parameters**
+
+**block** ([*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock")) – A `ScheduleBlock` to convert.
+
+**Returns**
+
+Scheduled pulse program.
+
+**Raises**
+
+* [**UnassignedDurationError**](#qiskit.pulse.UnassignedDurationError "qiskit.pulse.UnassignedDurationError") – When any instruction duration is not assigned.
+* [**PulseError**](#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – When the alignment context duration is shorter than the schedule duration.
+
+**Return type**
+
+[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")
+
+
+ This transform may insert barriers in between contexts.
+
+
+### compress\_pulses
+
+
+
+`qiskit.pulse.transforms.compress_pulses(schedules)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/transforms/canonicalization.py "view source code")
+
+Optimization pass to replace identical pulses.
+
+**Parameters**
+
+**schedules** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")*]*) – Schedules to compress.
+
+**Returns**
+
+Compressed schedules.
+
+**Return type**
+
+[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")]
+
+### flatten
+
+
+
+`qiskit.pulse.transforms.flatten(program)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/transforms/canonicalization.py "view source code")
+
+Flatten (inline) any called nodes into a Schedule tree with no nested children.
+
+**Parameters**
+
+**program** ([*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")) – Pulse program to remove nested structure.
+
+**Returns**
+
+Flatten pulse program.
+
+**Raises**
+
+[**PulseError**](#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – When invalid data format is given.
+
+**Return type**
+
+[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")
+
+### inline\_subroutines
+
+
+
+`qiskit.pulse.transforms.inline_subroutines(program)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/transforms/canonicalization.py "view source code")
+
+Recursively remove call instructions and inline the respective subroutine instructions.
+
+Assigned parameter values, which are stored in the parameter table, are also applied. The subroutine is copied before the parameter assignment to avoid mutation problem.
+
+**Parameters**
+
+**program** ([*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule") *|*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock")) – A program which may contain the subroutine, i.e. `Call` instruction.
+
+**Returns**
+
+A schedule without subroutine.
+
+**Raises**
+
+[**PulseError**](#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – When input program is not valid data format.
+
+**Return type**
+
+[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule") | [*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock")
+
+### pad
+
+
+
+`qiskit.pulse.transforms.pad(schedule, channels=None, until=None, inplace=False, pad_with=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/transforms/canonicalization.py "view source code")
+
+Pad the input Schedule with `Delay``s on all unoccupied timeslots until ``schedule.duration` or `until` if not `None`.
+
+**Parameters**
+
+* **schedule** ([*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")) – Schedule to pad.
+* **channels** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*Channel*](#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*] | None*) – Channels to pad. Defaults to all channels in `schedule` if not provided. If the supplied channel is not a member of `schedule` it will be added.
+* **until** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – Time to pad until. Defaults to `schedule.duration` if not provided.
+* **inplace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Pad this schedule by mutating rather than returning a new schedule.
+* **pad\_with** ([*Type*](https://docs.python.org/3/library/typing.html#typing.Type "(in Python v3.12)")*\[*[*Instruction*](#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")*] | None*) – Pulse `Instruction` subclass to be used for padding. Default to [`Delay`](qiskit.pulse.instructions.Delay "qiskit.pulse.instructions.Delay") instruction.
+
+**Returns**
+
+The padded schedule.
+
+**Raises**
+
+[**PulseError**](#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – When non pulse instruction is set to pad\_with.
+
+**Return type**
+
+[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")
+
+### remove\_directives
+
+
+
+`qiskit.pulse.transforms.remove_directives(schedule)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/transforms/canonicalization.py "view source code")
+
+Remove directives.
+
+**Parameters**
+
+**schedule** ([*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")) – A schedule to remove compiler directives.
+
+**Returns**
+
+A schedule without directives.
+
+**Return type**
+
+[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")
+
+### remove\_trivial\_barriers
+
+
+
+`qiskit.pulse.transforms.remove_trivial_barriers(schedule)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/transforms/canonicalization.py "view source code")
+
+Remove trivial barriers with 0 or 1 channels.
+
+**Parameters**
+
+**schedule** ([*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")) – A schedule to remove trivial barriers.
+
+**Returns**
+
+A schedule without trivial barriers
+
+**Return type**
+
+schedule
+
+
+
+### DAG
+
+The DAG transforms create DAG representation of input program. This can be used for optimization of instructions and equality checks.
+
+### block\_to\_dag
+
+
+
+`qiskit.pulse.transforms.block_to_dag(block)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/transforms/dag.py "view source code")
+
+Convert schedule block instruction into DAG.
+
+`ScheduleBlock` can be represented as a DAG as needed. For example, equality of two programs are efficiently checked on DAG representation.
+
+```python
+with pulse.build() as sched1:
+ with pulse.align_left():
+ pulse.play(my_gaussian0, pulse.DriveChannel(0))
+ pulse.shift_phase(1.57, pulse.DriveChannel(2))
+ pulse.play(my_gaussian1, pulse.DriveChannel(1))
+
+with pulse.build() as sched2:
+ with pulse.align_left():
+ pulse.shift_phase(1.57, pulse.DriveChannel(2))
+ pulse.play(my_gaussian1, pulse.DriveChannel(1))
+ pulse.play(my_gaussian0, pulse.DriveChannel(0))
+```
+
+Here the `sched1 `` and ``sched2` are different implementations of the same program, but it is difficult to confirm on the list representation.
+
+Another example is instruction optimization.
+
+```python
+with pulse.build() as sched:
+ with pulse.align_left():
+ pulse.shift_phase(1.57, pulse.DriveChannel(1))
+ pulse.play(my_gaussian0, pulse.DriveChannel(0))
+ pulse.shift_phase(-1.57, pulse.DriveChannel(1))
+```
+
+In above program two `shift_phase` instructions can be cancelled out because they are consecutive on the same drive channel. This can be easily found on the DAG representation.
+
+**Parameters**
+
+**block** (*"ScheduleBlock"*) – A schedule block to be converted.
+
+**Returns**
+
+Instructions in DAG representation.
+
+**Raises**
+
+[**PulseError**](#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – When the context is invalid subclass.
+
+**Return type**
+
+[*PyDAG*](https://www.rustworkx.org/apiref/rustworkx.PyDAG.html#rustworkx.PyDAG "(in rustworkx v0.14.0)")
+
+
+
+### Composite transform
+
+A sequence of transformations to generate a target code.
+
+### target\_qobj\_transform
+
+
+
+`qiskit.pulse.transforms.target_qobj_transform(sched, remove_directives=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/transforms/base_transforms.py "view source code")
+
+A basic pulse program transformation for OpenPulse API execution.
+
+**Parameters**
+
+* **sched** ([*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock") *|*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule") *|*[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*,* [*Instruction*](#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")*] |* [*Instruction*](#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction") *|*[*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*,* [*Instruction*](#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")*] |* [*Instruction*](#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")*]*) – Input program to transform.
+* **remove\_directives** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Set True to remove compiler directives.
+
+**Returns**
+
+Transformed program for execution.
+
+**Return type**
+
+[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")
+
+
+
+
+
+## Pulse Builder
+
+Use the pulse builder DSL to write pulse programs with an imperative syntax.
+
+
+ The pulse builder interface is still in active development. It may have breaking API changes without deprecation warnings in future releases until otherwise indicated.
+
+
+The pulse builder provides an imperative API for writing pulse programs with less difficulty than the [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") API. It contextually constructs a pulse schedule and then emits the schedule for execution. For example, to play a series of pulses on channels is as simple as:
+
+```python
+from qiskit import pulse
+
+dc = pulse.DriveChannel
+d0, d1, d2, d3, d4 = dc(0), dc(1), dc(2), dc(3), dc(4)
+
+with pulse.build(name='pulse_programming_in') as pulse_prog:
+ pulse.play([1, 1, 1, 0, 0, 1, 1, 1, 0, 1, 1, 1, 0, 1, 0, 1, 0, 1, 1, 1, 0, 1, 1, 1], d0)
+ pulse.play([1, 0, 1, 0, 0, 0, 1, 0, 0, 1, 0, 0, 0, 1, 1, 0, 0, 0, 1, 0, 0, 0, 1, 0], d1)
+ pulse.play([1, 0, 1, 0, 0, 0, 1, 0, 0, 1, 1, 1, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 1, 0], d2)
+ pulse.play([1, 0, 1, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 1, 1, 0, 0, 0, 1, 0, 0, 0, 1, 0], d3)
+ pulse.play([1, 1, 1, 1, 0, 1, 1, 1, 0, 1, 1, 1, 0, 1, 0, 1, 0, 1, 1, 1, 0, 0, 1, 0], d4)
+
+pulse_prog.draw()
+```
+
+
+
+To begin pulse programming we must first initialize our program builder context with [`build()`](#qiskit.pulse.builder.build "qiskit.pulse.builder.build"), after which we can begin adding program statements. For example, below we write a simple program that [`play()`](#qiskit.pulse.builder.play "qiskit.pulse.builder.play")s a pulse:
+
+```python
+from qiskit import execute, pulse
+
+d0 = pulse.DriveChannel(0)
+
+with pulse.build() as pulse_prog:
+ pulse.play(pulse.Constant(100, 1.0), d0)
+
+pulse_prog.draw()
+```
+
+
+
+The builder initializes a [`pulse.Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule"), `pulse_prog` and then begins to construct the program within the context. The output pulse schedule will survive after the context is exited and can be executed like a normal Qiskit schedule using `qiskit.execute(pulse_prog, backend)`.
+
+Pulse programming has a simple imperative style. This leaves the programmer to worry about the raw experimental physics of pulse programming and not constructing cumbersome data structures.
+
+We can optionally pass a [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") to [`build()`](#qiskit.pulse.builder.build "qiskit.pulse.builder.build") to enable enhanced functionality. Below, we prepare a Bell state by automatically compiling the required pulses from their gate-level representations, while simultaneously applying a long decoupling pulse to a neighboring qubit. We terminate the experiment with a measurement to observe the state we prepared. This program which mixes circuits and pulses will be automatically lowered to be run as a pulse program:
+
+```python
+import math
+
+from qiskit import pulse
+from qiskit.providers.fake_provider import FakeOpenPulse3Q
+
+# TODO: This example should use a real mock backend.
+backend = FakeOpenPulse3Q()
+
+d2 = pulse.DriveChannel(2)
+
+with pulse.build(backend) as bell_prep:
+ pulse.u2(0, math.pi, 0)
+ pulse.cx(0, 1)
+
+with pulse.build(backend) as decoupled_bell_prep_and_measure:
+ # We call our bell state preparation schedule constructed above.
+ with pulse.align_right():
+ pulse.call(bell_prep)
+ pulse.play(pulse.Constant(bell_prep.duration, 0.02), d2)
+ pulse.barrier(0, 1, 2)
+ registers = pulse.measure_all()
+
+decoupled_bell_prep_and_measure.draw()
+```
+
+
+
+
+ Calling gates directly within the pulse builder namespace is deprecated as of qiskit 0.46.0.
+
+
+With the pulse builder we are able to blend programming on qubits and channels. While the pulse schedule is based on instructions that operate on channels, the pulse builder automatically handles the mapping from qubits to channels for you.
+
+In the example below we demonstrate some more features of the pulse builder:
+
+```python
+import math
+
+from qiskit import pulse, QuantumCircuit
+from qiskit.pulse import library
+from qiskit.providers.fake_provider import FakeOpenPulse2Q
+
+backend = FakeOpenPulse2Q()
+
+with pulse.build(backend) as pulse_prog:
+ # Create a pulse.
+ gaussian_pulse = library.gaussian(10, 1.0, 2)
+ # Get the qubit's corresponding drive channel from the backend.
+ d0 = pulse.drive_channel(0)
+ d1 = pulse.drive_channel(1)
+ # Play a pulse at t=0.
+ pulse.play(gaussian_pulse, d0)
+ # Play another pulse directly after the previous pulse at t=10.
+ pulse.play(gaussian_pulse, d0)
+ # The default scheduling behavior is to schedule pulses in parallel
+ # across channels. For example, the statement below
+ # plays the same pulse on a different channel at t=0.
+ pulse.play(gaussian_pulse, d1)
+
+ # We also provide pulse scheduling alignment contexts.
+ # The default alignment context is align_left.
+
+ # The sequential context schedules pulse instructions sequentially in time.
+ # This context starts at t=10 due to earlier pulses above.
+ with pulse.align_sequential():
+ pulse.play(gaussian_pulse, d0)
+ # Play another pulse after at t=20.
+ pulse.play(gaussian_pulse, d1)
+
+ # We can also nest contexts as each instruction is
+ # contained in its local scheduling context.
+ # The output of a child context is a context-schedule
+ # with the internal instructions timing fixed relative to
+ # one another. This is schedule is then called in the parent context.
+
+ # Context starts at t=30.
+ with pulse.align_left():
+ # Start at t=30.
+ pulse.play(gaussian_pulse, d0)
+ # Start at t=30.
+ pulse.play(gaussian_pulse, d1)
+ # Context ends at t=40.
+
+ # Alignment context where all pulse instructions are
+ # aligned to the right, ie., as late as possible.
+ with pulse.align_right():
+ # Shift the phase of a pulse channel.
+ pulse.shift_phase(math.pi, d1)
+ # Starts at t=40.
+ pulse.delay(100, d0)
+ # Ends at t=140.
+
+ # Starts at t=130.
+ pulse.play(gaussian_pulse, d1)
+ # Ends at t=140.
+
+ # Acquire data for a qubit and store in a memory slot.
+ pulse.acquire(100, 0, pulse.MemorySlot(0))
+
+ # We also support a variety of macros for common operations.
+
+ # Measure all qubits.
+ pulse.measure_all()
+
+ # Delay on some qubits.
+ # This requires knowledge of which channels belong to which qubits.
+ # delay for 100 cycles on qubits 0 and 1.
+ pulse.delay_qubits(100, 0, 1)
+
+ # Call a quantum circuit. The pulse builder lazily constructs a quantum
+ # circuit which is then transpiled and scheduled before inserting into
+ # a pulse schedule.
+ # NOTE: Quantum register indices correspond to physical qubit indices.
+ qc = QuantumCircuit(2, 2)
+ qc.cx(0, 1)
+ pulse.call(qc)
+ # Calling a small set of standard gates and decomposing to pulses is
+ # also supported with more natural syntax.
+ pulse.u3(0, math.pi, 0, 0)
+ pulse.cx(0, 1)
+
+
+ # It is also be possible to call a preexisting schedule
+ tmp_sched = pulse.Schedule()
+ tmp_sched += pulse.Play(gaussian_pulse, d0)
+ pulse.call(tmp_sched)
+
+ # We also support:
+
+ # frequency instructions
+ pulse.set_frequency(5.0e9, d0)
+
+ # phase instructions
+ pulse.shift_phase(0.1, d0)
+
+ # offset contexts
+ with pulse.phase_offset(math.pi, d0):
+ pulse.play(gaussian_pulse, d0)
+```
+
+
+ Calling gates directly within the pulse builder namespace is deprecated as of qiskit 0.46.0.
+
+
+The above is just a small taste of what is possible with the builder. See the rest of the module documentation for more information on its capabilities.
+
+### build
+
+
+
+`qiskit.pulse.builder.build(backend=None, schedule=None, name=None, default_alignment='left', default_transpiler_settings=None, default_circuit_scheduler_settings=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Create a context manager for launching the imperative pulse builder DSL.
+
+To enter a building context and starting building a pulse program:
+
+```python
+from qiskit import transpile, pulse
+from qiskit.providers.fake_provider import FakeOpenPulse2Q
+
+backend = FakeOpenPulse2Q()
+
+d0 = pulse.DriveChannel(0)
+
+with pulse.build() as pulse_prog:
+ pulse.play(pulse.Constant(100, 0.5), d0)
+```
+
+While the output program `pulse_prog` cannot be executed as we are using a mock backend. If a real backend is being used, executing the program is done with:
+
+```python
+backend.run(transpile(pulse_prog, backend))
+```
+
+
+ `qiskit.pulse.builder.build()`’s argument `default_circuit_scheduler_settings` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. setting parameter `default_circuit_scheduler_settings` in build() was used for gate operations, which are deprecated. pulse schedules should only be used for gate calibrations as part of a quantum circuit, and not vice versa
+
+
+
+ `qiskit.pulse.builder.build()`’s argument `default_transpiler_settings` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. setting parameter `default_transpiler_settings` in build() was used for gate operations, which are deprecated. pulse schedules should only be used for gate calibrations as part of a quantum circuit, and not vice versa
+
+
+**Parameters**
+
+* **backend** ([*Backend*](qiskit.providers.Backend "qiskit.providers.Backend")) – A Qiskit backend. If not supplied certain builder functionality will be unavailable.
+* **schedule** ([*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock") *| None*) – A pulse `ScheduleBlock` in which your pulse program will be built.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of pulse program to be built.
+* **default\_alignment** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*AlignmentKind*](#qiskit.pulse.transforms.AlignmentKind "qiskit.pulse.transforms.alignments.AlignmentKind") *| None*) – Default scheduling alignment for builder. One of `left`, `right`, `sequential` or an alignment context.
+* **default\_transpiler\_settings** ([*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")*] | None*) – Default settings for the transpiler.
+* **default\_circuit\_scheduler\_settings** ([*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")*] | None*) – Default settings for the circuit to pulse scheduler.
+
+**Returns**
+
+A new builder context which has the active builder initialized.
+
+**Return type**
+
+[*ContextManager*](https://docs.python.org/3/library/typing.html#typing.ContextManager "(in Python v3.12)")\[[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock")]
+
+### Channels
+
+Methods to return the correct channels for the respective qubit indices.
+
+```python
+from qiskit import pulse
+from qiskit.providers.fake_provider import FakeArmonk
+
+backend = FakeArmonk()
+
+with pulse.build(backend) as drive_sched:
+ d0 = pulse.drive_channel(0)
+ print(d0)
+```
+
+```python
+DriveChannel(0)
+```
+
+### acquire\_channel
+
+
+
+`qiskit.pulse.builder.acquire_channel(qubit)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Return `AcquireChannel` for `qubit` on the active builder backend.
+
+Examples:
+
+```python
+from qiskit import pulse
+from qiskit.providers.fake_provider import FakeOpenPulse2Q
+
+backend = FakeOpenPulse2Q()
+
+with pulse.build(backend):
+ assert pulse.acquire_channel(0) == pulse.AcquireChannel(0)
+```
+
+
+ Requires the active builder context to have a backend set.
+
+
+**Return type**
+
+[*AcquireChannel*](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channels
+
+
+
+`qiskit.pulse.builder.control_channels(*qubits)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Return `ControlChannel` for `qubit` on the active builder backend.
+
+Return the secondary drive channel for the given qubit – typically utilized for controlling multi-qubit interactions.
+
+Examples:
+
+```python
+from qiskit import pulse
+from qiskit.providers.fake_provider import FakeOpenPulse2Q
+
+backend = FakeOpenPulse2Q()
+with pulse.build(backend):
+ assert pulse.control_channels(0, 1) == [pulse.ControlChannel(0)]
+```
+
+
+ Requires the active builder context to have a backend set.
+
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of ordered qubits of the form (control\_qubit, target\_qubit).
+
+**Returns**
+
+List of control channels associated with the supplied ordered list of qubits.
+
+**Return type**
+
+[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*ControlChannel*](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`qiskit.pulse.builder.drive_channel(qubit)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Return `DriveChannel` for `qubit` on the active builder backend.
+
+Examples:
+
+```python
+from qiskit import pulse
+from qiskit.providers.fake_provider import FakeOpenPulse2Q
+
+backend = FakeOpenPulse2Q()
+
+with pulse.build(backend):
+ assert pulse.drive_channel(0) == pulse.DriveChannel(0)
+```
+
+
+ Requires the active builder context to have a backend set.
+
+
+**Return type**
+
+[*DriveChannel*](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`qiskit.pulse.builder.measure_channel(qubit)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Return `MeasureChannel` for `qubit` on the active builder backend.
+
+Examples:
+
+```python
+from qiskit import pulse
+from qiskit.providers.fake_provider import FakeOpenPulse2Q
+
+backend = FakeOpenPulse2Q()
+
+with pulse.build(backend):
+ assert pulse.measure_channel(0) == pulse.MeasureChannel(0)
+```
+
+
+ Requires the active builder context to have a backend set.
+
+
+**Return type**
+
+[*MeasureChannel*](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### Instructions
+
+Pulse instructions are available within the builder interface. Here’s an example:
+
+```python
+from qiskit import pulse
+from qiskit.providers.fake_provider import FakeArmonk
+
+backend = FakeArmonk()
+
+with pulse.build(backend) as drive_sched:
+ d0 = pulse.drive_channel(0)
+ a0 = pulse.acquire_channel(0)
+
+ pulse.play(pulse.library.Constant(10, 1.0), d0)
+ pulse.delay(20, d0)
+ pulse.shift_phase(3.14/2, d0)
+ pulse.set_phase(3.14, d0)
+ pulse.shift_frequency(1e7, d0)
+ pulse.set_frequency(5e9, d0)
+
+ with pulse.build() as temp_sched:
+ pulse.play(pulse.library.Gaussian(20, 1.0, 3.0), d0)
+ pulse.play(pulse.library.Gaussian(20, -1.0, 3.0), d0)
+
+ pulse.call(temp_sched)
+ pulse.acquire(30, a0, pulse.MemorySlot(0))
+
+drive_sched.draw()
+```
+
+
+
+### acquire
+
+
+
+`qiskit.pulse.builder.acquire(duration, qubit_or_channel, register, **metadata)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Acquire for a `duration` on a `channel` and store the result in a `register`.
+
+Examples:
+
+```python
+from qiskit import pulse
+
+acq0 = pulse.AcquireChannel(0)
+mem0 = pulse.MemorySlot(0)
+
+with pulse.build() as pulse_prog:
+ pulse.acquire(100, acq0, mem0)
+
+ # measurement metadata
+ kernel = pulse.configuration.Kernel('linear_discriminator')
+ pulse.acquire(100, acq0, mem0, kernel=kernel)
+```
+
+
+ The type of data acquire will depend on the execution `meas_level`.
+
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Duration to acquire data for
+* **qubit\_or\_channel** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*AcquireChannel*](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")) – Either the qubit to acquire data for or the specific [`AcquireChannel`](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel") to acquire on.
+* **register** (*StorageLocation*) – Location to store measured result.
+* **metadata** (*Kernel | Discriminator*) – Additional metadata for measurement. See [`Acquire`](qiskit.pulse.instructions.Acquire "qiskit.pulse.instructions.Acquire") for more information.
+
+**Raises**
+
+[**exceptions.PulseError**](#qiskit.pulse.PulseError "qiskit.pulse.exceptions.PulseError") – If the register type is not supported.
+
+### barrier
+
+
+
+`qiskit.pulse.builder.barrier(*channels_or_qubits, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Barrier directive for a set of channels and qubits.
+
+This directive prevents the compiler from moving instructions across the barrier. Consider the case where we want to enforce that one pulse happens after another on separate channels, this can be done with:
+
+```python
+from qiskit import pulse
+from qiskit.providers.fake_provider import FakeOpenPulse2Q
+
+backend = FakeOpenPulse2Q()
+
+d0 = pulse.DriveChannel(0)
+d1 = pulse.DriveChannel(1)
+
+with pulse.build(backend) as barrier_pulse_prog:
+ pulse.play(pulse.Constant(10, 1.0), d0)
+ pulse.barrier(d0, d1)
+ pulse.play(pulse.Constant(10, 1.0), d1)
+```
+
+Of course this could have been accomplished with:
+
+```python
+from qiskit.pulse import transforms
+
+with pulse.build(backend) as aligned_pulse_prog:
+ with pulse.align_sequential():
+ pulse.play(pulse.Constant(10, 1.0), d0)
+ pulse.play(pulse.Constant(10, 1.0), d1)
+
+barrier_pulse_prog = transforms.target_qobj_transform(barrier_pulse_prog)
+aligned_pulse_prog = transforms.target_qobj_transform(aligned_pulse_prog)
+
+assert barrier_pulse_prog == aligned_pulse_prog
+```
+
+The barrier allows the pulse compiler to take care of more advanced scheduling alignment operations across channels. For example in the case where we are calling an outside circuit or schedule and want to align a pulse at the end of one call:
+
+```python
+import math
+
+d0 = pulse.DriveChannel(0)
+
+with pulse.build(backend) as pulse_prog:
+ with pulse.align_right():
+ pulse.x(1)
+ # Barrier qubit 1 and d0.
+ pulse.barrier(1, d0)
+ # Due to barrier this will play before the gate on qubit 1.
+ pulse.play(pulse.Constant(10, 1.0), d0)
+ # This will end at the same time as the pulse above due to
+ # the barrier.
+ pulse.x(1)
+```
+
+
+ Requires the active builder context to have a backend set if qubits are barriered on.
+
+
+**Parameters**
+
+* **channels\_or\_qubits** ([*Channel*](#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Channels or qubits to barrier.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name for the barrier
+
+### call
+
+
+
+`qiskit.pulse.builder.call(target, name=None, value_dict=None, **kw_params)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Call the subroutine within the currently active builder context with arbitrary parameters which will be assigned to the target program.
+
+
+ If the `target` program is a [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), then a [`Reference`](qiskit.pulse.instructions.Reference "qiskit.pulse.instructions.Reference") instruction will be created and appended to the current context. The `target` program will be immediately assigned to the current scope as a subroutine. If the `target` program is [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule"), it will be wrapped by the [`Call`](qiskit.pulse.instructions.Call "qiskit.pulse.instructions.Call") instruction and appended to the current context to avoid a mixed representation of [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") and [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule"). If the `target` program is a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") it will be scheduled and the new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") will be added as a [`Call`](qiskit.pulse.instructions.Call "qiskit.pulse.instructions.Call") instruction.
+
+
+
+ QuantumCircuit type for the argument target is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. ScheduleBlock should only be used for gate calibrations in a quantum circuit. Thus, the called quantum circuit should be added to the main circuit instead of to the ScheduleBlock.
+
+
+**Examples**
+
+1. Calling a schedule block (recommended)
+
+```python
+from qiskit import circuit, pulse
+from qiskit.providers.fake_provider import FakeBogotaV2
+
+backend = FakeBogotaV2()
+
+with pulse.build() as x_sched:
+ pulse.play(pulse.Gaussian(160, 0.1, 40), pulse.DriveChannel(0))
+
+with pulse.build() as pulse_prog:
+ pulse.call(x_sched)
+
+print(pulse_prog)
+```
+
+```python
+ScheduleBlock(
+ ScheduleBlock(
+ Play(
+ Gaussian(duration=160, amp=(0.1+0j), sigma=40),
+ DriveChannel(0)
+ ),
+ name="block0",
+ transform=AlignLeft()
+ ),
+ name="block1",
+ transform=AlignLeft()
+)
+```
+
+The actual program is stored in the reference table attached to the schedule.
+
+```python
+print(pulse_prog.references)
+```
+
+```python
+ReferenceManager:
+ - ('block0', '634b3b50bd684e26a673af1fbd2d6c81'): ScheduleBlock(Play(Gaussian(...
+```
+
+In addition, you can call a parameterized target program with parameter assignment.
+
+```python
+amp = circuit.Parameter("amp")
+
+with pulse.build() as subroutine:
+ pulse.play(pulse.Gaussian(160, amp, 40), pulse.DriveChannel(0))
+
+with pulse.build() as pulse_prog:
+ pulse.call(subroutine, amp=0.1)
+ pulse.call(subroutine, amp=0.3)
+
+print(pulse_prog)
+```
+
+```python
+ScheduleBlock(
+ ScheduleBlock(
+ Play(
+ Gaussian(duration=160, amp=(0.1+0j), sigma=40),
+ DriveChannel(0)
+ ),
+ name="block2",
+ transform=AlignLeft()
+ ),
+ ScheduleBlock(
+ Play(
+ Gaussian(duration=160, amp=(0.3+0j), sigma=40),
+ DriveChannel(0)
+ ),
+ name="block2",
+ transform=AlignLeft()
+ ),
+ name="block3",
+ transform=AlignLeft()
+)
+```
+
+If there is a name collision between parameters, you can distinguish them by specifying each parameter object in a python dictionary. For example,
+
+```python
+amp1 = circuit.Parameter('amp')
+amp2 = circuit.Parameter('amp')
+
+with pulse.build() as subroutine:
+ pulse.play(pulse.Gaussian(160, amp1, 40), pulse.DriveChannel(0))
+ pulse.play(pulse.Gaussian(160, amp2, 40), pulse.DriveChannel(1))
+
+with pulse.build() as pulse_prog:
+ pulse.call(subroutine, value_dict={amp1: 0.1, amp2: 0.3})
+
+print(pulse_prog)
+```
+
+```python
+ScheduleBlock(
+ ScheduleBlock(
+ Play(Gaussian(duration=160, amp=(0.1+0j), sigma=40), DriveChannel(0)),
+ Play(Gaussian(duration=160, amp=(0.3+0j), sigma=40), DriveChannel(1)),
+ name="block4",
+ transform=AlignLeft()
+ ),
+ name="block5",
+ transform=AlignLeft()
+)
+```
+
+2. Calling a schedule
+
+```python
+x_sched = backend.instruction_schedule_map.get("x", (0,))
+
+with pulse.build(backend) as pulse_prog:
+ pulse.call(x_sched)
+
+print(pulse_prog)
+```
+
+```python
+ScheduleBlock(
+ Call(
+ Schedule(
+ (
+ 0,
+ Play(
+ Drag(
+ duration=160,
+ amp=(0.18989731546729305+0j),
+ sigma=40,
+ beta=-1.201258305015517,
+ name='drag_86a8'
+ ),
+ DriveChannel(0),
+ name='drag_86a8'
+ )
+ ),
+ name="x"
+ ),
+ name='x'
+ ),
+ name="block6",
+ transform=AlignLeft()
+)
+```
+
+Currently, the backend calibrated gates are provided in the form of [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule"). The parameter assignment mechanism is available also for schedules. However, the called schedule is not treated as a reference.
+
+
+ Calling a circuit from a schedule is deprecated as of qiskit 0.46.0. The Qiskit execution model has migrating toward the pulse gate model, where schedules are attached to circuits through the [`QuantumCircuit.add_calibration()`](qiskit.circuit.QuantumCircuit#add_calibration "qiskit.circuit.QuantumCircuit.add_calibration") method. Thus, instead of calling a circuit into the schedule, it should instead be added to the main circuit.
+
+
+**Parameters**
+
+* **target** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit") *|*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule") *|*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock") *| None*) – Target circuit or pulse schedule to call.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Optional. A unique name of subroutine if defined. When the name is explicitly provided, one cannot call different schedule blocks with the same name.
+* **value\_dict** ([*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – Optional. Parameters assigned to the `target` program. If this dictionary is provided, the `target` program is copied and then stored in the main built schedule and its parameters are assigned to the given values. This dictionary is keyed on [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects, allowing parameter name collision to be avoided.
+* **kw\_params** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Alternative way to provide parameters. Since this is keyed on the string parameter name, the parameters having the same name are all updated together. If you want to avoid name collision, use `value_dict` with [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects instead.
+
+### delay
+
+
+
+`qiskit.pulse.builder.delay(duration, channel, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Delay on a `channel` for a `duration`.
+
+Examples:
+
+```python
+from qiskit import pulse
+
+d0 = pulse.DriveChannel(0)
+
+with pulse.build() as pulse_prog:
+ pulse.delay(10, d0)
+```
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of cycles to delay for on `channel`.
+* **channel** ([*Channel*](#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")) – Channel to delay on.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the instruction.
+
+### play
+
+
+
+`qiskit.pulse.builder.play(pulse, channel, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Play a `pulse` on a `channel`.
+
+Examples:
+
+```python
+from qiskit import pulse
+
+d0 = pulse.DriveChannel(0)
+
+with pulse.build() as pulse_prog:
+ pulse.play(pulse.Constant(10, 1.0), d0)
+```
+
+**Parameters**
+
+* **pulse** (*Pulse |* [*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – Pulse to play.
+* **channel** (*PulseChannel*) – Channel to play pulse on.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the pulse.
+
+### reference
+
+
+
+`qiskit.pulse.builder.reference(name, *extra_keys)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Refer to undefined subroutine by string keys.
+
+A [`Reference`](qiskit.pulse.instructions.Reference "qiskit.pulse.instructions.Reference") instruction is implicitly created and a schedule can be separately registered to the reference at a later stage.
+
+```python
+from qiskit import pulse
+
+with pulse.build() as main_prog:
+ pulse.reference("x_gate", "q0")
+
+with pulse.build() as subroutine:
+ pulse.play(pulse.Gaussian(160, 0.1, 40), pulse.DriveChannel(0))
+
+main_prog.assign_references(subroutine_dict={("x_gate", "q0"): subroutine})
+```
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Name of subroutine.
+* **extra\_keys** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Helper keys to uniquely specify the subroutine.
+
+### set\_frequency
+
+
+
+`qiskit.pulse.builder.set_frequency(frequency, channel, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Set the `frequency` of a pulse `channel`.
+
+Examples:
+
+```python
+from qiskit import pulse
+
+d0 = pulse.DriveChannel(0)
+
+with pulse.build() as pulse_prog:
+ pulse.set_frequency(1e9, d0)
+```
+
+**Parameters**
+
+* **frequency** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Frequency in Hz to set channel to.
+* **channel** (*PulseChannel*) – Channel to set frequency of.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the instruction.
+
+### set\_phase
+
+
+
+`qiskit.pulse.builder.set_phase(phase, channel, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Set the `phase` of a pulse `channel`.
+
+Examples:
+
+```python
+import math
+
+from qiskit import pulse
+
+d0 = pulse.DriveChannel(0)
+
+with pulse.build() as pulse_prog:
+ pulse.set_phase(math.pi, d0)
+```
+
+**Parameters**
+
+* **phase** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Phase in radians to set channel carrier signal to.
+* **channel** (*PulseChannel*) – Channel to set phase of.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the instruction.
+
+### shift\_frequency
+
+
+
+`qiskit.pulse.builder.shift_frequency(frequency, channel, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Shift the `frequency` of a pulse `channel`.
+
+Examples:
+
+```python
+from qiskit import pulse
+
+d0 = pulse.DriveChannel(0)
+
+with pulse.build() as pulse_prog:
+ pulse.shift_frequency(1e9, d0)
+```
+
+**Parameters**
+
+* **frequency** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Frequency in Hz to shift channel frequency by.
+* **channel** (*PulseChannel*) – Channel to shift frequency of.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the instruction.
+
+### shift\_phase
+
+
+
+`qiskit.pulse.builder.shift_phase(phase, channel, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Shift the `phase` of a pulse `channel`.
+
+Examples:
+
+```python
+import math
+
+from qiskit import pulse
+
+d0 = pulse.DriveChannel(0)
+
+with pulse.build() as pulse_prog:
+ pulse.shift_phase(math.pi, d0)
+```
+
+**Parameters**
+
+* **phase** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Phase in radians to shift channel carrier signal by.
+* **channel** (*PulseChannel*) – Channel to shift phase of.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the instruction.
+
+### snapshot
+
+
+
+`qiskit.pulse.builder.snapshot(label, snapshot_type='statevector')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Simulator snapshot.
+
+Examples:
+
+```python
+from qiskit import pulse
+
+with pulse.build() as pulse_prog:
+ pulse.snapshot('first', 'statevector')
+```
+
+**Parameters**
+
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Label for snapshot.
+* **snapshot\_type** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Type of snapshot.
+
+### Contexts
+
+Builder aware contexts that modify the construction of a pulse program. For example an alignment context like [`align_right()`](#qiskit.pulse.builder.align_right "qiskit.pulse.builder.align_right") may be used to align all pulses as late as possible in a pulse program.
+
+```python
+from qiskit import pulse
+
+d0 = pulse.DriveChannel(0)
+d1 = pulse.DriveChannel(1)
+
+with pulse.build() as pulse_prog:
+ with pulse.align_right():
+ # this pulse will start at t=0
+ pulse.play(pulse.Constant(100, 1.0), d0)
+ # this pulse will start at t=80
+ pulse.play(pulse.Constant(20, 1.0), d1)
+
+pulse_prog.draw()
+```
+
+
+
+### align\_equispaced
+
+
+
+`qiskit.pulse.builder.align_equispaced(duration)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Equispaced alignment pulse scheduling context.
+
+Pulse instructions within this context are scheduled with the same interval spacing such that the total length of the context block is `duration`. If the total free `duration` cannot be evenly divided by the number of instructions within the context, the modulo is split and then prepended and appended to the returned schedule. Delay instructions are automatically inserted in between pulses.
+
+This context is convenient to write a schedule for periodical dynamic decoupling or the Hahn echo sequence.
+
+Examples:
+
+```python
+from qiskit import pulse
+
+d0 = pulse.DriveChannel(0)
+x90 = pulse.Gaussian(10, 0.1, 3)
+x180 = pulse.Gaussian(10, 0.2, 3)
+
+with pulse.build() as hahn_echo:
+ with pulse.align_equispaced(duration=100):
+ pulse.play(x90, d0)
+ pulse.play(x180, d0)
+ pulse.play(x90, d0)
+
+hahn_echo.draw()
+```
+
+
+
+**Parameters**
+
+**duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – Duration of this context. This should be larger than the schedule duration.
+
+**Yields**
+
+None
+
+**Return type**
+
+[*AlignmentKind*](#qiskit.pulse.transforms.AlignmentKind "qiskit.pulse.transforms.alignments.AlignmentKind")
+
+**Notes**
+
+The scheduling is performed for sub-schedules within the context rather than channel-wise. If you want to apply the equispaced context for each channel, you should use the context independently for channels.
+
+### align\_func
+
+
+
+`qiskit.pulse.builder.align_func(duration, func)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Callback defined alignment pulse scheduling context.
+
+Pulse instructions within this context are scheduled at the location specified by arbitrary callback function position that takes integer index and returns the associated fractional location within \[0, 1]. Delay instruction is automatically inserted in between pulses.
+
+This context may be convenient to write a schedule of arbitrary dynamical decoupling sequences such as Uhrig dynamical decoupling.
+
+Examples:
+
+```python
+import numpy as np
+from qiskit import pulse
+
+d0 = pulse.DriveChannel(0)
+x90 = pulse.Gaussian(10, 0.1, 3)
+x180 = pulse.Gaussian(10, 0.2, 3)
+
+def udd10_pos(j):
+ return np.sin(np.pi*j/(2*10 + 2))**2
+
+with pulse.build() as udd_sched:
+ pulse.play(x90, d0)
+ with pulse.align_func(duration=300, func=udd10_pos):
+ for _ in range(10):
+ pulse.play(x180, d0)
+ pulse.play(x90, d0)
+
+udd_sched.draw()
+```
+
+
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – Duration of context. This should be larger than the schedule duration.
+* **func** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")*\[\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – A function that takes an index of sub-schedule and returns the fractional coordinate of of that sub-schedule. The returned value should be defined within \[0, 1]. The pulse index starts from 1.
+
+**Yields**
+
+None
+
+**Return type**
+
+[*AlignmentKind*](#qiskit.pulse.transforms.AlignmentKind "qiskit.pulse.transforms.alignments.AlignmentKind")
+
+**Notes**
+
+The scheduling is performed for sub-schedules within the context rather than channel-wise. If you want to apply the numerical context for each channel, you need to apply the context independently to channels.
+
+### align\_left
+
+
+
+`qiskit.pulse.builder.align_left()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Left alignment pulse scheduling context.
+
+Pulse instructions within this context are scheduled as early as possible by shifting them left to the earliest available time.
+
+Examples:
+
+```python
+from qiskit import pulse
+
+d0 = pulse.DriveChannel(0)
+d1 = pulse.DriveChannel(1)
+
+with pulse.build() as pulse_prog:
+ with pulse.align_left():
+ # this pulse will start at t=0
+ pulse.play(pulse.Constant(100, 1.0), d0)
+ # this pulse will start at t=0
+ pulse.play(pulse.Constant(20, 1.0), d1)
+pulse_prog = pulse.transforms.block_to_schedule(pulse_prog)
+
+assert pulse_prog.ch_start_time(d0) == pulse_prog.ch_start_time(d1)
+```
+
+**Yields**
+
+None
+
+**Return type**
+
+[*ContextManager*](https://docs.python.org/3/library/typing.html#typing.ContextManager "(in Python v3.12)")\[None]
+
+### align\_right
+
+
+
+`qiskit.pulse.builder.align_right()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Right alignment pulse scheduling context.
+
+Pulse instructions within this context are scheduled as late as possible by shifting them right to the latest available time.
+
+Examples:
+
+```python
+from qiskit import pulse
+
+d0 = pulse.DriveChannel(0)
+d1 = pulse.DriveChannel(1)
+
+with pulse.build() as pulse_prog:
+ with pulse.align_right():
+ # this pulse will start at t=0
+ pulse.play(pulse.Constant(100, 1.0), d0)
+ # this pulse will start at t=80
+ pulse.play(pulse.Constant(20, 1.0), d1)
+pulse_prog = pulse.transforms.block_to_schedule(pulse_prog)
+
+assert pulse_prog.ch_stop_time(d0) == pulse_prog.ch_stop_time(d1)
+```
+
+**Yields**
+
+None
+
+**Return type**
+
+[*AlignmentKind*](#qiskit.pulse.transforms.AlignmentKind "qiskit.pulse.transforms.alignments.AlignmentKind")
+
+### align\_sequential
+
+
+
+`qiskit.pulse.builder.align_sequential()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Sequential alignment pulse scheduling context.
+
+Pulse instructions within this context are scheduled sequentially in time such that no two instructions will be played at the same time.
+
+Examples:
+
+```python
+from qiskit import pulse
+
+d0 = pulse.DriveChannel(0)
+d1 = pulse.DriveChannel(1)
+
+with pulse.build() as pulse_prog:
+ with pulse.align_sequential():
+ # this pulse will start at t=0
+ pulse.play(pulse.Constant(100, 1.0), d0)
+ # this pulse will also start at t=100
+ pulse.play(pulse.Constant(20, 1.0), d1)
+pulse_prog = pulse.transforms.block_to_schedule(pulse_prog)
+
+assert pulse_prog.ch_stop_time(d0) == pulse_prog.ch_start_time(d1)
+```
+
+**Yields**
+
+None
+
+**Return type**
+
+[*AlignmentKind*](#qiskit.pulse.transforms.AlignmentKind "qiskit.pulse.transforms.alignments.AlignmentKind")
+
+### circuit\_scheduler\_settings
+
+
+
+`qiskit.pulse.builder.circuit_scheduler_settings(**settings)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Set the currently active circuit scheduler settings for this context.
+
+
+ The function `qiskit.pulse.builder.circuit_scheduler_settings()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. This function was used for gate operations, which are deprecated. pulse schedules should only be used for gate calibrations as part of a quantum circuit, and not vice versa
+
+
+Examples:
+
+```python
+from qiskit import pulse
+from qiskit.providers.fake_provider import FakeOpenPulse2Q
+
+backend = FakeOpenPulse2Q()
+
+with pulse.build(backend):
+ print(pulse.active_circuit_scheduler_settings())
+ with pulse.circuit_scheduler_settings(method='alap'):
+ print(pulse.active_circuit_scheduler_settings())
+```
+
+```python
+{}
+{'method': 'alap'}
+```
+
+**Return type**
+
+[*ContextManager*](https://docs.python.org/3/library/typing.html#typing.ContextManager "(in Python v3.12)")\[None]
+
+### frequency\_offset
+
+
+
+`qiskit.pulse.builder.frequency_offset(frequency, *channels, compensate_phase=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Shift the frequency of inputs channels on entry into context and undo on exit.
+
+Examples:
+
+```python
+from qiskit import pulse
+
+d0 = pulse.DriveChannel(0)
+
+with pulse.build(backend) as pulse_prog:
+ # shift frequency by 1GHz
+ with pulse.frequency_offset(1e9, d0):
+ pulse.play(pulse.Constant(10, 1.0), d0)
+
+assert len(pulse_prog.instructions) == 3
+
+with pulse.build(backend) as pulse_prog:
+ # Shift frequency by 1GHz.
+ # Undo accumulated phase in the shifted frequency frame
+ # when exiting the context.
+ with pulse.frequency_offset(1e9, d0, compensate_phase=True):
+ pulse.play(pulse.Constant(10, 1.0), d0)
+
+assert len(pulse_prog.instructions) == 4
+```
+
+**Parameters**
+
+* **frequency** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Amount of frequency offset in Hz.
+* **channels** (*PulseChannel*) – Channels to offset frequency of.
+* **compensate\_phase** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Compensate for accumulated phase accumulated with respect to the channels’ frame at its initial frequency.
+
+**Yields**
+
+None
+
+**Return type**
+
+[*ContextManager*](https://docs.python.org/3/library/typing.html#typing.ContextManager "(in Python v3.12)")\[None]
+
+### phase\_offset
+
+
+
+`qiskit.pulse.builder.phase_offset(phase, *channels)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Shift the phase of input channels on entry into context and undo on exit.
+
+Examples:
+
+```python
+import math
+
+from qiskit import pulse
+
+d0 = pulse.DriveChannel(0)
+
+with pulse.build() as pulse_prog:
+ with pulse.phase_offset(math.pi, d0):
+ pulse.play(pulse.Constant(10, 1.0), d0)
+
+assert len(pulse_prog.instructions) == 3
+```
+
+**Parameters**
+
+* **phase** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Amount of phase offset in radians.
+* **channels** (*PulseChannel*) – Channels to offset phase of.
+
+**Yields**
+
+None
+
+**Return type**
+
+[*ContextManager*](https://docs.python.org/3/library/typing.html#typing.ContextManager "(in Python v3.12)")\[None]
+
+### transpiler\_settings
+
+
+
+`qiskit.pulse.builder.transpiler_settings(**settings)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Set the currently active transpiler settings for this context.
+
+
+ The function `qiskit.pulse.builder.transpiler_settings()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. This function was used for gate operations, which are deprecated. pulse schedules should only be used for gate calibrations as part of a quantum circuit, and not vice versa
+
+
+Examples:
+
+```python
+from qiskit import pulse
+from qiskit.providers.fake_provider import FakeOpenPulse2Q
+
+backend = FakeOpenPulse2Q()
+
+with pulse.build(backend):
+ print(pulse.active_transpiler_settings())
+ with pulse.transpiler_settings(optimization_level=3):
+ print(pulse.active_transpiler_settings())
+```
+
+```python
+{}
+{'optimization_level': 3}
+```
+
+**Return type**
+
+[*ContextManager*](https://docs.python.org/3/library/typing.html#typing.ContextManager "(in Python v3.12)")\[None]
+
+### Macros
+
+Macros help you add more complex functionality to your pulse program.
+
+```python
+from qiskit import pulse
+from qiskit.providers.fake_provider import FakeArmonk
+
+backend = FakeArmonk()
+
+with pulse.build(backend) as measure_sched:
+ mem_slot = pulse.measure(0)
+ print(mem_slot)
+```
+
+```python
+MemorySlot(0)
+```
+
+### measure
+
+
+
+`qiskit.pulse.builder.measure(qubits, registers=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Measure a qubit within the currently active builder context.
+
+At the pulse level a measurement is composed of both a stimulus pulse and an acquisition instruction which tells the systems measurement unit to acquire data and process it. We provide this measurement macro to automate the process for you, but if desired full control is still available with [`acquire()`](#qiskit.pulse.builder.acquire "qiskit.pulse.builder.acquire") and [`play()`](#qiskit.pulse.builder.play "qiskit.pulse.builder.play").
+
+To use the measurement it is as simple as specifying the qubit you wish to measure:
+
+```python
+from qiskit import pulse
+from qiskit.providers.fake_provider import FakeOpenPulse2Q
+
+backend = FakeOpenPulse2Q()
+
+qubit = 0
+
+with pulse.build(backend) as pulse_prog:
+ # Do something to the qubit.
+ qubit_drive_chan = pulse.drive_channel(0)
+ pulse.play(pulse.Constant(100, 1.0), qubit_drive_chan)
+ # Measure the qubit.
+ reg = pulse.measure(qubit)
+```
+
+For now it is not possible to do much with the handle to `reg` but in the future we will support using this handle to a result register to build up ones program. It is also possible to supply this register:
+
+```python
+with pulse.build(backend) as pulse_prog:
+ pulse.play(pulse.Constant(100, 1.0), qubit_drive_chan)
+ # Measure the qubit.
+ mem0 = pulse.MemorySlot(0)
+ reg = pulse.measure(qubit, mem0)
+
+assert reg == mem0
+```
+
+
+ Requires the active builder context to have a backend set.
+
+
+**Parameters**
+
+* **qubits** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] |* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Physical qubit to measure.
+* **registers** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[StorageLocation] | StorageLocation | None*) – Register to store result in. If not selected the current behavior is to return the `MemorySlot` with the same index as `qubit`. This register will be returned.
+
+**Returns**
+
+The `register` the qubit measurement result will be stored in.
+
+**Return type**
+
+[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[StorageLocation] | StorageLocation
+
+### measure\_all
+
+
+
+`qiskit.pulse.builder.measure_all()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Measure all qubits within the currently active builder context.
+
+A simple macro function to measure all of the qubits in the device at the same time. This is useful for handling device `meas_map` and single measurement constraints.
+
+Examples:
+
+```python
+from qiskit import pulse
+from qiskit.providers.fake_provider import FakeOpenPulse2Q
+
+backend = FakeOpenPulse2Q()
+
+with pulse.build(backend) as pulse_prog:
+ # Measure all qubits and return associated registers.
+ regs = pulse.measure_all()
+```
+
+
+ Requires the active builder context to have a backend set.
+
+
+**Returns**
+
+The `register`s the qubit measurement results will be stored in.
+
+**Return type**
+
+[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*MemorySlot*](qiskit.pulse.channels.MemorySlot "qiskit.pulse.channels.MemorySlot")]
+
+### delay\_qubits
+
+
+
+`qiskit.pulse.builder.delay_qubits(duration, *qubits)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Insert delays on all of the `channels.Channel`s that correspond to the input `qubits` at the same time.
+
+Examples:
+
+```python
+from qiskit import pulse
+from qiskit.providers.fake_provider import FakeOpenPulse3Q
+
+backend = FakeOpenPulse3Q()
+
+with pulse.build(backend) as pulse_prog:
+ # Delay for 100 cycles on qubits 0, 1 and 2.
+ regs = pulse.delay_qubits(100, 0, 1, 2)
+```
+
+
+ Requires the active builder context to have a backend set.
+
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Duration to delay for.
+* **qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Physical qubits to delay on. Delays will be inserted based on the channels returned by `pulse.qubit_channels()`.
+
+### Utilities
+
+The utility functions can be used to gather attributes about the backend and modify how the program is built.
+
+```python
+from qiskit import pulse
+
+from qiskit.providers.fake_provider import FakeArmonk
+
+backend = FakeArmonk()
+
+with pulse.build(backend) as u3_sched:
+ print('Number of qubits in backend: {}'.format(pulse.num_qubits()))
+
+ samples = 160
+ print('There are {} samples in {} seconds'.format(
+ samples, pulse.samples_to_seconds(160)))
+
+ seconds = 1e-6
+ print('There are {} seconds in {} samples.'.format(
+ seconds, pulse.seconds_to_samples(1e-6)))
+```
+
+```python
+Number of qubits in backend: 1
+There are 160 samples in 3.5555555555555554e-08 seconds
+There are 1e-06 seconds in 4500 samples.
+```
+
+### active\_backend
+
+
+
+`qiskit.pulse.builder.active_backend()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Get the backend of the currently active builder context.
+
+**Returns**
+
+**The active backend in the currently active**
+
+builder context.
+
+**Return type**
+
+[Backend](qiskit.providers.Backend "qiskit.providers.Backend")
+
+**Raises**
+
+[**exceptions.BackendNotSet**](#qiskit.pulse.BackendNotSet "qiskit.pulse.exceptions.BackendNotSet") – If the builder does not have a backend set.
+
+### active\_transpiler\_settings
+
+
+
+`qiskit.pulse.builder.active_transpiler_settings()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Return the current active builder context’s transpiler settings.
+
+
+ The function `qiskit.pulse.builder.active_transpiler_settings()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. This function was used for gate operations, which are deprecated. pulse schedules should only be used for gate calibrations as part of a quantum circuit, and not vice versa
+
+
+Examples:
+
+```python
+from qiskit import pulse
+from qiskit.providers.fake_provider import FakeOpenPulse2Q
+
+backend = FakeOpenPulse2Q()
+
+transpiler_settings = {'optimization_level': 3}
+
+with pulse.build(backend,
+ default_transpiler_settings=transpiler_settings):
+ print(pulse.active_transpiler_settings())
+```
+
+```python
+{'optimization_level': 3}
+```
+
+**Return type**
+
+[*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)"), [*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")]
+
+### active\_circuit\_scheduler\_settings
+
+
+
+`qiskit.pulse.builder.active_circuit_scheduler_settings()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Return the current active builder context’s circuit scheduler settings.
+
+
+ The function `qiskit.pulse.builder.active_circuit_scheduler_settings()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. This function was used for gate operations, which are deprecated. pulse schedules should only be used for gate calibrations as part of a quantum circuit, and not vice versa
+
+
+Examples:
+
+```python
+from qiskit import pulse
+from qiskit.providers.fake_provider import FakeOpenPulse2Q
+
+backend = FakeOpenPulse2Q()
+
+circuit_scheduler_settings = {'method': 'alap'}
+
+with pulse.build(
+ backend,
+ default_circuit_scheduler_settings=circuit_scheduler_settings):
+ print(pulse.active_circuit_scheduler_settings())
+```
+
+```python
+{'method': 'alap'}
+```
+
+**Return type**
+
+[*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)"), [*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")]
+
+### num\_qubits
+
+
+
+`qiskit.pulse.builder.num_qubits()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Return number of qubits in the currently active backend.
+
+Examples:
+
+```python
+from qiskit import pulse
+from qiskit.providers.fake_provider import FakeOpenPulse2Q
+
+backend = FakeOpenPulse2Q()
+
+with pulse.build(backend):
+ print(pulse.num_qubits())
+```
+
+```python
+2
+```
+
+
+ Requires the active builder context to have a backend set.
+
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### qubit\_channels
+
+
+
+`qiskit.pulse.builder.qubit_channels(qubit)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Returns the set of channels associated with a qubit.
+
+Examples:
+
+```python
+from qiskit import pulse
+from qiskit.providers.fake_provider import FakeOpenPulse2Q
+
+backend = FakeOpenPulse2Q()
+
+with pulse.build(backend):
+ print(pulse.qubit_channels(0))
+```
+
+```python
+{MeasureChannel(0), ControlChannel(0), DriveChannel(0), AcquireChannel(0), ControlChannel(1)}
+```
+
+
+ Requires the active builder context to have a backend set.
+
+
+
+ A channel may still be associated with another qubit in this list such as in the case where significant crosstalk exists.
+
+
+**Return type**
+
+[*Set*](https://docs.python.org/3/library/typing.html#typing.Set "(in Python v3.12)")\[[*Channel*](#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")]
+
+### samples\_to\_seconds
+
+
+
+`qiskit.pulse.builder.samples_to_seconds(samples)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Obtain the time in seconds that will elapse for the input number of samples on the active backend.
+
+**Parameters**
+
+**samples** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – Number of samples to convert to time in seconds.
+
+**Returns**
+
+The time that elapses in `samples`.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") | [*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+### seconds\_to\_samples
+
+
+
+`qiskit.pulse.builder.seconds_to_samples(seconds)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/builder.py "view source code")
+
+Obtain the number of samples that will elapse in `seconds` on the active backend.
+
+Rounds down.
+
+**Parameters**
+
+**seconds** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – Time in seconds to convert to samples.
+
+**Returns**
+
+The number of samples for the time to elapse
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") | [*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+## Configuration
+
+| | |
+| ------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap")() | Mapping from [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") [`qiskit.circuit.Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") names and qubits to [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") s. In particular, the mapping is formatted as type::. |
+
+## Exceptions
+
+### PulseError
+
+
+
+`qiskit.pulse.PulseError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/exceptions.py "view source code")
+
+Errors raised by the pulse module.
+
+Set the error message.
+
+### BackendNotSet
+
+
+
+`qiskit.pulse.BackendNotSet(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/exceptions.py "view source code")
+
+Raised if the builder context does not have a backend.
+
+Set the error message.
+
+### NoActiveBuilder
+
+
+
+`qiskit.pulse.NoActiveBuilder(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/exceptions.py "view source code")
+
+Raised if no builder context is active.
+
+Set the error message.
+
+### UnassignedDurationError
+
+
+
+`qiskit.pulse.UnassignedDurationError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/exceptions.py "view source code")
+
+Raised if instruction duration is unassigned.
+
+Set the error message.
+
+### UnassignedReferenceError
+
+
+
+`qiskit.pulse.UnassignedReferenceError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/exceptions.py "view source code")
+
+Raised if subroutine is unassigned.
+
+Set the error message.
+
diff --git a/docs/api/qiskit/0.46/qasm.md b/docs/api/qiskit/0.46/qasm.md
new file mode 100644
index 00000000000..43b68c777d1
--- /dev/null
+++ b/docs/api/qiskit/0.46/qasm.md
@@ -0,0 +1,54 @@
+---
+title: qasm
+description: API reference for qiskit.qasm
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.qasm
+---
+
+
+
+
+
+
+
+# Qasm
+
+
+
+`qiskit.qasm`
+
+
+ The [`qiskit.qasm`](#module-qiskit.qasm "qiskit.qasm") module has been deprecated and superseded by the [`qiskit.qasm2`](qasm2#module-qiskit.qasm2 "qiskit.qasm2") module which provides a faster more correct parser.
+
+
+## QASM Routines
+
+
+
+`qiskit.qasm.Qasm(filename=None, data=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qasm/qasm.py "view source code")
+
+OPENQASM circuit object.
+
+Create an OPENQASM circuit object.
+
+## Pygments
+
+
+
+`qiskit.qasm.OpenQASMLexer(*args, **kwds)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qasm/pygments/lexer.py "view source code")
+
+A pygments lexer for OpenQasm.
+
+
+
+`qiskit.qasm.QasmHTMLStyle`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qasm/pygments/lexer.py "view source code")
+
+A style for OpenQasm in a HTML env (e.g. Jupyter widget).
+
+
+
+`qiskit.qasm.QasmTerminalStyle`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qasm/pygments/lexer.py "view source code")
+
+A style for OpenQasm in a Terminal env (e.g. Jupyter print).
+
diff --git a/docs/api/qiskit/0.46/qasm2.md b/docs/api/qiskit/0.46/qasm2.md
new file mode 100644
index 00000000000..cb5c866feab
--- /dev/null
+++ b/docs/api/qiskit/0.46/qasm2.md
@@ -0,0 +1,539 @@
+---
+title: qasm2
+description: API reference for qiskit.qasm2
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.qasm2
+---
+
+
+
+
+
+
+
+# OpenQASM 2
+
+
+
+`qiskit.qasm2`
+
+Qiskit has support for interoperation with OpenQASM 2.0 programs, both [parsing into Qiskit formats](#qasm2-parse) and [exporting back to OpenQASM 2](#qasm2-export).
+
+
+ OpenQASM 2 is a simple language, and not suitable for general serialisation of Qiskit objects. See [some discussion of alternatives below](#qasm2-alternatives), if that is what you are looking for.
+
+
+
+
+## Parsing API
+
+This module contains two public functions, both of which create a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") from an OpenQASM 2 program. [`load()`](#qiskit.qasm2.load "qiskit.qasm2.load") takes a filename, while [`loads()`](#qiskit.qasm2.loads "qiskit.qasm2.loads") takes the program itself as a string. Their internals are very similar, so both offer almost the same API.
+
+### load
+
+
+
+`qiskit.qasm2.load(filename, *, include_path=('.',), include_input_directory='append', custom_instructions=(), custom_classical=(), strict=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qasm2/__init__.py "view source code")
+
+Parse an OpenQASM 2 program from a file into a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"). The given path should be ASCII or UTF-8 encoded, and contain the OpenQASM 2 program.
+
+**Parameters**
+
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*PathLike*](https://docs.python.org/3/library/os.html#os.PathLike "(in Python v3.12)")) – The OpenQASM 2 program in a string.
+* **include\_path** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*PathLike*](https://docs.python.org/3/library/os.html#os.PathLike "(in Python v3.12)")*]*) – order of directories to search when evaluating `include` statements.
+* **include\_input\_directory** ([*Literal*](https://docs.python.org/3/library/typing.html#typing.Literal "(in Python v3.12)")*\['append', 'prepend'] | None*) – Whether to add the directory of the input file to the `include_path`, and if so, whether to *append* it to search last, or *prepend* it to search first. Pass `None` to suppress adding this directory entirely.
+* **custom\_instructions** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*CustomInstruction*](#qiskit.qasm2.CustomInstruction "qiskit.qasm2.parse.CustomInstruction")*]*) – any custom constructors that should be used for specific gates or opaque instructions during circuit construction. See [Specifying custom instructions](#qasm2-custom-instructions) for more.
+* **custom\_classical** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*CustomClassical*](#qiskit.qasm2.CustomClassical "qiskit.qasm2.CustomClassical")*]*) – any custom classical functions that should be used during the parsing of classical expressions. See [Specifying custom classical functions](#qasm2-custom-classical) for more.
+* **strict** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – whether to run in [strict mode](#qasm2-strict-mode).
+
+**Returns**
+
+A circuit object representing the same OpenQASM 2 program.
+
+**Return type**
+
+[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+### loads
+
+
+
+`qiskit.qasm2.loads(string, *, include_path=('.',), custom_instructions=(), custom_classical=(), strict=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qasm2/__init__.py "view source code")
+
+Parse an OpenQASM 2 program from a string into a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit").
+
+**Parameters**
+
+* **string** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The OpenQASM 2 program in a string.
+* **include\_path** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*PathLike*](https://docs.python.org/3/library/os.html#os.PathLike "(in Python v3.12)")*]*) – order of directories to search when evaluating `include` statements.
+* **custom\_instructions** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*CustomInstruction*](#qiskit.qasm2.CustomInstruction "qiskit.qasm2.parse.CustomInstruction")*]*) – any custom constructors that should be used for specific gates or opaque instructions during circuit construction. See [Specifying custom instructions](#qasm2-custom-instructions) for more.
+* **custom\_classical** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*CustomClassical*](#qiskit.qasm2.CustomClassical "qiskit.qasm2.CustomClassical")*]*) – any custom classical functions that should be used during the parsing of classical expressions. See [Specifying custom classical functions](#qasm2-custom-classical) for more.
+* **strict** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – whether to run in [strict mode](#qasm2-strict-mode).
+
+**Returns**
+
+A circuit object representing the same OpenQASM 2 program.
+
+**Return type**
+
+[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+Both of these loading functions also take an argument `include_path`, which is an iterable of directory names to use when searching for files in `include` statements. The directories are tried from index 0 onwards, and the first match is used. The import `qelib1.inc` is treated specially; it is always found before looking in the include path, and contains exactly the content of the [paper describing the OpenQASM 2 language](https://arxiv.org/abs/1707.03429). The gates in this include file are mapped to circuit-library gate objects defined by Qiskit.
+
+
+
+### Specifying custom instructions
+
+You can extend the quantum components of the OpenQASM 2 language by passing an iterable of information on custom instructions as the argument `custom_instructions`. In files that have compatible definitions for these instructions, the given `constructor` will be used in place of whatever other handling [`qiskit.qasm2`](#module-qiskit.qasm2 "qiskit.qasm2") would have done. These instructions may optionally be marked as `builtin`, which causes them to not require an `opaque` or `gate` declaration, but they will silently ignore a compatible declaration. Either way, it is an error to provide a custom instruction that has a different number of parameters or qubits as a defined instruction in a parsed program. Each element of the argument iterable should be a particular data class:
+
+
+
+`qiskit.qasm2.CustomInstruction(name, num_params, num_qubits, constructor, builtin=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qasm2/parse.py "view source code")
+
+Information about a custom instruction that should be defined during the parse.
+
+The `name`, `num_params` and `num_qubits` fields are self-explanatory. The `constructor` field should be a callable object with signature `*args -> Instruction`, where each of the `num_params` `args` is a floating-point value. Most of the built-in Qiskit gate classes have this form.
+
+There is a final `builtin` field. This is optional, and if set true will cause the instruction to be defined and available within the parsing, even if there is no definition in any included OpenQASM 2 file.
+
+This can be particularly useful when trying to resolve ambiguities in the global-phase conventions of an OpenQASM 2 program. See [OpenQASM 2 Phase Conventions](#qasm2-phase-conventions) for more details.
+
+
+
+### Specifying custom classical functions
+
+Similar to the quantum extensions above, you can also extend the processing done to classical expressions (arguments to gates) by passing an iterable to the argument `custom_classical` to either loader. This needs the `name` (a valid OpenQASM 2 identifier), the number `num_params` of parameters it takes, and a Python callable that implements the function. The Python callable must be able to accept `num_params` positional floating-point arguments, and must return a float or integer (which will be converted to a float). Builtin functions cannot be overridden.
+
+
+
+`qiskit.qasm2.CustomClassical`
+
+Information about a custom classical function that should be defined in mathematical expressions.
+
+The given callable must be a Python function that takes num\_params floats, and returns a float. The name is the identifier that refers to it in the OpenQASM 2 program. This cannot clash with any defined gates.
+
+
+
+### Strict mode
+
+Both of the loader functions have an optional “strict” mode. By default, this parser is a little bit more relaxed than the official specification: it allows trailing commas in parameter lists; unnecessary (empty-statement) semicolons; the `OPENQASM 2.0;` version statement to be omitted; and a couple of other quality-of-life improvements without emitting any errors. You can use the letter-of-the-spec mode with `strict=True`.
+
+
+
+## Exporting API
+
+Similar to other serialisation modules in Python, this module offers two public functions: [`dump()`](#qiskit.qasm2.dump "qiskit.qasm2.dump") and [`dumps()`](#qiskit.qasm2.dumps "qiskit.qasm2.dumps"), which take a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") and write out a representative OpenQASM 2 program to a file-like object or return a string, respectively.
+
+### dump
+
+
+
+`qiskit.qasm2.dump(circuit, filename_or_stream, /)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qasm2/export.py "view source code")
+
+Dump a circuit as an OpenQASM 2 program to a file or stream.
+
+**Parameters**
+
+* **circuit** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – the [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") to be exported.
+* **filename\_or\_stream** ([*os.PathLike*](https://docs.python.org/3/library/os.html#os.PathLike "(in Python v3.12)") *|*[*io.TextIOBase*](https://docs.python.org/3/library/io.html#io.TextIOBase "(in Python v3.12)")) – either a path-like object (likely a [`str`](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") or [`pathlib.Path`](https://docs.python.org/3/library/pathlib.html#pathlib.Path "(in Python v3.12)")), or an already opened text-mode stream.
+
+**Raises**
+
+[**QASM2ExportError**](#qiskit.qasm2.QASM2ExportError "qiskit.qasm2.QASM2ExportError") – if the circuit cannot be represented by OpenQASM 2.
+
+### dumps
+
+
+
+`qiskit.qasm2.dumps(circuit, /)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qasm2/export.py "view source code")
+
+Export a circuit to an OpenQASM 2 program in a string.
+
+**Parameters**
+
+**circuit** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")) – the [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") to be exported.
+
+**Returns**
+
+An OpenQASM 2 string representing the circuit.
+
+**Raises**
+
+[**QASM2ExportError**](#qiskit.qasm2.QASM2ExportError "qiskit.qasm2.QASM2ExportError") – if the circuit cannot be represented by OpenQASM 2.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+## Errors
+
+This module defines a generic error type that derives from [`QiskitError`](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") that can be used as a catch when you care about failures emitted by the interoperation layer specifically.
+
+### QASM2Error
+
+
+
+`qiskit.qasm2.QASM2Error(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qasm2/exceptions.py "view source code")
+
+A general error raised by the OpenQASM 2 interoperation layer.
+
+Set the error message.
+
+In cases where the lexer or parser fails due to an invalid OpenQASM 2 file, the conversion functions will raise a more specific error with a message explaining what the failure is, and where in the file it occurred.
+
+### QASM2ParseError
+
+
+
+`qiskit.qasm2.QASM2ParseError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qasm2/exceptions.py "view source code")
+
+An error raised because of a failure to parse an OpenQASM 2 file.
+
+Set the error message.
+
+When the exporters fail to export a circuit, likely because it has structure that cannot be represented by OpenQASM 2.0, they will also emit a custom error.
+
+### QASM2ExportError
+
+
+
+`qiskit.qasm2.QASM2ExportError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qasm2/exceptions.py "view source code")
+
+An error raised because of a failure to convert a Qiskit object to an OpenQASM 2 form.
+
+Set the error message.
+
+
+
+## Examples
+
+### Exporting examples
+
+Export a simple [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") to an OpenQASM 2 string:
+
+```python
+import qiskit.qasm2
+from qiskit.circuit import QuantumCircuit
+
+qc = QuantumCircuit(2, 2)
+qc.h(0)
+qc.cx(0, 1)
+qc.measure([0, 1], [0, 1])
+print(qiskit.qasm2.dumps(qc))
+```
+
+```python
+OPENQASM 2.0;
+include "qelib1.inc";
+qreg q[2];
+creg c[2];
+h q[0];
+cx q[0],q[1];
+measure q[0] -> c[0];
+measure q[1] -> c[1];
+```
+
+Write out the same [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") to a given filename:
+
+```python
+qiskit.qasm2.dump(qc, "myfile.qasm")
+```
+
+Similarly, one can use general [`os.PathLike`](https://docs.python.org/3/library/os.html#os.PathLike "(in Python v3.12)") instances as the filename:
+
+```python
+import pathlib
+
+qiskit.qasm2.dump(qc, pathlib.Path.home() / "myfile.qasm")
+```
+
+One can also dump the text to an already-open stream:
+
+```python
+import io
+
+with io.StringIO() as stream:
+ qiskit.qasm2.dump(qc, stream)
+```
+
+### Parsing examples
+
+Use [`loads()`](#qiskit.qasm2.loads "qiskit.qasm2.loads") to import an OpenQASM 2 program in a string into a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"):
+
+```python
+import qiskit.qasm2
+program = """
+ OPENQASM 2.0;
+ include "qelib1.inc";
+ qreg q[2];
+ creg c[2];
+
+ h q[0];
+ cx q[0], q[1];
+
+ measure q -> c;
+"""
+circuit = qiskit.qasm2.loads(program)
+circuit.draw()
+```
+
+```python
+ ┌───┐ ┌─┐
+q_0: ┤ H ├──■──┤M├───
+ └───┘┌─┴─┐└╥┘┌─┐
+q_1: ─────┤ X ├─╫─┤M├
+ └───┘ ║ └╥┘
+c: 2/═══════════╩══╩═
+ 0 1
+```
+
+You can achieve the same thing if the program is stored in a file by using [`load()`](#qiskit.qasm2.load "qiskit.qasm2.load") instead, passing the filename as an argument:
+
+```python
+import qiskit.qasm2
+circuit = qiskit.qasm2.load("myfile.qasm")
+```
+
+OpenQASM 2 files can include other OpenQASM 2 files via the `include` statement. You can influence the search path used for finding these files with the `include_path` argument to both [`load()`](#qiskit.qasm2.load "qiskit.qasm2.load") and [`loads()`](#qiskit.qasm2.loads "qiskit.qasm2.loads"). By default, only the current working directory is searched.
+
+```python
+import qiskit.qasm2
+program = """
+ include "other.qasm";
+ // ... and so on
+"""
+circuit = qiskit.qasm2.loads(program, include_path=("/path/to/a", "/path/to/b", "."))
+```
+
+For [`load()`](#qiskit.qasm2.load "qiskit.qasm2.load") only, there is an extra argument `include_input_directory`, which can be used to either `'append'`, `'prepend'` or ignore (`None`) the directory of the loaded file in the include path. By default, this directory is appended to the search path, so it is tried last, but you can change this.
+
+```python
+import qiskit.qasm2
+filenames = ["./subdirectory/a.qasm", "/path/to/b.qasm", "~/my.qasm"]
+# Search the directory of each file before other parts of the include path.
+circuits = [
+ qiskit.qasm2.load(filename, include_input_directory="prepend") for filename in filenames
+]
+# Override the include path, and don't search the directory of each file unless it's in the
+# absolute path list.
+circuits = [
+ qiskit.qasm2.load(
+ filename,
+ include_path=("/usr/include/qasm", "~/qasm/include"),
+ include_input_directory=None,
+ )
+ for filename in filenames
+]
+```
+
+Sometimes you may want to influence the [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate") objects that the importer emits for given named instructions. Gates that are defined by the statement `include "qelib1.inc";` will automatically be associated with a suitable Qiskit circuit-library gate, but you can extend this:
+
+```python
+from qiskit.circuit import Gate
+from qiskit.qasm2 import loads, CustomInstruction
+
+class MyGate(Gate):
+ def __init__(self, theta):
+ super().__init__("my", 2, [theta])
+
+class Builtin(Gate):
+ def __init__(self):
+ super().__init__("builtin", 1, [])
+
+program = """
+ opaque my(theta) q1, q2;
+ qreg q[2];
+ my(0.5) q[0], q[1];
+ builtin q[0];
+"""
+customs = [
+ CustomInstruction(name="my", num_params=1, num_qubits=2, constructor=MyGate),
+ # Setting 'builtin=True' means the instruction doesn't require a declaration to be usable.
+ CustomInstruction("builtin", 0, 1, Builtin, builtin=True),
+]
+circuit = loads(program, custom_instructions=customs)
+```
+
+Similarly, you can add new classical functions used during the description of arguments to gates, both in the main body of the program (which come out constant-folded) and within the bodies of defined gates (which are computed on demand). Here we provide a Python version of `atan2(y, x)`, which mathematically is $\arctan(y/x)$ but correctly handling angle quadrants and infinities, and a custom `add_one` function:
+
+```python
+import math
+from qiskit.qasm2 import loads, CustomClassical
+
+program = """
+ include "qelib1.inc";
+ qreg q[2];
+ rx(atan2(pi, 3 + add_one(0.2))) q[0];
+ cx q[0], q[1];
+"""
+
+def add_one(x):
+ return x + 1
+
+customs = [
+ # `atan2` takes two parameters, and `math.atan2` implements it.
+ CustomClassical("atan2", 2, math.atan2),
+ # Our `add_one` takes only one parameter.
+ CustomClassical("add_one", 1, add_one),
+]
+circuit = loads(program, custom_classical=customs)
+```
+
+
+
+## OpenQASM 2 Phase Conventions
+
+As a language, OpenQASM 2 does not have a way to specify the global phase of a complete program, nor of particular gate definitions. This means that parsers of the language may interpret particular gates with a different global phase than what you might expect. For example, the *de facto* standard library of OpenQASM 2 `qelib1.inc` contains definitions of `u1` and `rz` as follows:
+
+```python
+gate u1(lambda) q {
+ U(0, 0, lambda) q;
+}
+
+gate rz(phi) a {
+ u1(phi) a;
+}
+```
+
+In other words, `rz` appears to be a direct alias for `u1`. However, the interpretation of `u1` is specified in [equation (3) of the paper describing the language](https://arxiv.org/abs/1707.03429) as
+
+$$
+u_1(\lambda) = \operatorname{diag}\bigl(1, e^{i\lambda}\bigr) \sim R_z(\lambda)
+$$
+
+where the $\sim$ symbol denotes equivalence only up to a global phase. When parsing OpenQASM 2, we need to choose how to handle a distinction between such gates; `u1` is defined in the prose to be different by a phase to `rz`, but the language is not designed to represent this.
+
+Qiskit’s default position is to interpret a usage of the standard-library `rz` using [`RZGate`](qiskit.circuit.library.RZGate "qiskit.circuit.library.RZGate"), and a usage of `u1` as using the phase-distinct [`U1Gate`](qiskit.circuit.library.U1Gate "qiskit.circuit.library.U1Gate"). If you wish to use the phase conventions more implied by a direct interpretation of the `gate` statements in the header file, you can use [`CustomInstruction`](#qiskit.qasm2.CustomInstruction "qiskit.qasm2.CustomInstruction") to override how Qiskit builds the circuit.
+
+For the standard `qelib1.inc` include there is only one point of difference, and so the override needed to switch its phase convention is:
+
+```python
+from qiskit import qasm2
+from qiskit.circuit.library import PhaseGate
+from qiskit.quantum_info import Operator
+
+program = """
+ OPENQASM 2.0;
+ include "qelib1.inc";
+ qreg q[1];
+ rz(pi / 2) q[0];
+"""
+
+custom = [
+ qasm2.CustomInstruction("rz", 1, 1, PhaseGate),
+]
+```
+
+This will use Qiskit’s [`PhaseGate`](qiskit.circuit.library.PhaseGate "qiskit.circuit.library.PhaseGate") class to represent the `rz` instruction, which is equal (including the phase) to [`U1Gate`](qiskit.circuit.library.U1Gate "qiskit.circuit.library.U1Gate"):
+
+```python
+Operator(qasm2.loads(program, custom_instructions=custom))
+```
+
+```python
+Operator([[1.000000e+00+0.j, 0.000000e+00+0.j],
+ [0.000000e+00+0.j, 6.123234e-17+1.j]],
+ input_dims=(2,), output_dims=(2,))
+```
+
+
+
+## Legacy Compatibility
+
+[`QuantumCircuit.from_qasm_str()`](qiskit.circuit.QuantumCircuit#from_qasm_str "qiskit.circuit.QuantumCircuit.from_qasm_str") and [`from_qasm_file()`](qiskit.circuit.QuantumCircuit#from_qasm_file "qiskit.circuit.QuantumCircuit.from_qasm_file") used to make a few additions on top of the raw specification. Qiskit originally tried to use OpenQASM 2 as a sort of serialisation format, and expanded its behaviour as Qiskit expanded. The new parser under all its defaults implements the specification more strictly.
+
+The complete legacy code-paths are
+
+```python
+from qiskit.converters import ast_to_dag, dag_to_circuit
+from qiskit.qasm import Qasm
+
+def from_qasm_file(path: str):
+ dag_to_circuit(ast_to_dag(Qasm(filename=path).parse()))
+
+def from_qasm_str(qasm_str: str):
+ dag_to_circuit(ast_to_dag(Qasm(data=qasm_str).parse()))
+```
+
+In particular, in the legacy importers:
+
+* **the include\_path is effectively:**
+
+ 1. `/qasm/libs`, where `` is the root of the installed `qiskit` package;
+ 2. the current working directory.
+
+* **there are additional instructions defined in `qelib1.inc`:**
+
+ **`csx a, b`**
+
+ Controlled $\sqrt X$ gate, corresponding to [`CSXGate`](qiskit.circuit.library.CSXGate "qiskit.circuit.library.CSXGate").
+
+ **`cu(theta, phi, lambda, gamma) c, t`**
+
+ The four-parameter version of a controlled-$U$, corresponding to [`CUGate`](qiskit.circuit.library.CUGate "qiskit.circuit.library.CUGate").
+
+ **`rxx(theta) a, b`**
+
+ Two-qubit rotation around the $XX$ axis, corresponding to [`RXXGate`](qiskit.circuit.library.RXXGate "qiskit.circuit.library.RXXGate").
+
+ **`rzz(theta) a, b`**
+
+ Two-qubit rotation around the $ZZ$ axis, corresponding to [`RZZGate`](qiskit.circuit.library.RZZGate "qiskit.circuit.library.RZZGate").
+
+ **`rccx a, b, c`**
+
+ The double-controlled $X$ gate, but with relative phase differences over the standard Toffoli gate. This *should* correspond to the Qiskit gate [`RCCXGate`](qiskit.circuit.library.RCCXGate "qiskit.circuit.library.RCCXGate"), but the legacy converter wouldn’t actually output this type.
+
+ **`rc3x a, b, c, d`**
+
+ The triple-controlled $X$ gate, but with relative phase differences over the standard definition. Corresponds to [`RC3XGate`](qiskit.circuit.library.RC3XGate "qiskit.circuit.library.RC3XGate").
+
+ **`c3x a, b, c, d`**
+
+ The triple-controlled $X$ gate, corresponding to [`C3XGate`](qiskit.circuit.library.C3XGate "qiskit.circuit.library.C3XGate").
+
+ **`c3sqrtx a, b, c, d`**
+
+ The triple-controlled $\sqrt X$ gate, corresponding to [`C3SXGate`](qiskit.circuit.library.C3SXGate "qiskit.circuit.library.C3SXGate").
+
+ **`c4x a, b, c, d, e`**
+
+ The quadruple-controlled $X$ gate., corresponding to [`C4XGate`](qiskit.circuit.library.C4XGate "qiskit.circuit.library.C4XGate").
+
+* if *any* `opaque` or `gate` definition was given for the name `delay`, they attempt to output a [`Delay`](qiskit.circuit.Delay "qiskit.circuit.Delay") instruction at each call. To function, this expects a definition compatible with `opaque delay(t) q;`, where the time `t` is given in units of `dt`. The importer will raise errors on construction if there was not exactly one parameter and one qubit, or if the parameter is not integer-valued.
+
+* the additional scientific-calculator functions `asin`, `acos` and `atan` are available.
+
+* the parsed grammar is effectively the same as [the strict mode of the new importers](#qasm2-strict-mode).
+
+You can emulate this behaviour in [`load()`](#qiskit.qasm2.load "qiskit.qasm2.load") and [`loads()`](#qiskit.qasm2.loads "qiskit.qasm2.loads") by setting include\_path appropriately (try inspecting the variable `qiskit.__file__` to find the installed location), and by passing a list of [`CustomInstruction`](#qiskit.qasm2.CustomInstruction "qiskit.qasm2.CustomInstruction") instances for each of the custom gates you care about. To make things easier we make three tuples available, which each contain one component of a configuration that is equivalent to Qiskit’s legacy converter behaviour.
+
+**qiskit.qasm2.LEGACY\_CUSTOM\_INSTRUCTIONS**
+
+A tuple containing the extra custom\_instructions that Qiskit’s legacy built-in converters used if `qelib1.inc` is included, and there is any definition of a `delay` instruction. The gates in the paper version of `qelib1.inc` and `delay` all require a compatible declaration statement to be present within the OpenQASM 2 program, but Qiskit’s legacy additions are all marked as builtins since they are not actually present in any include file this parser sees.
+
+**qiskit.qasm2.LEGACY\_CUSTOM\_CLASSICAL**
+
+A tuple containing the extra custom\_classical functions that Qiskit’s legacy built-in converters use beyond those specified by the paper. This is the three basic inverse trigonometric functions: $\asin$, $\acos$ and $\atan$.
+
+**qiskit.qasm2.LEGACY\_INCLUDE\_PATH**
+
+A tuple containing the exact include\_path used by the legacy Qiskit converter.
+
+On *all* the gates defined in Qiskit’s legacy version of `qelib1.inc` and the `delay` instruction, it does not matter how the gates are actually defined and used, the legacy importer will always attempt to output its custom objects for them. This can result in errors during the circuit construction, even after a successful parse. There is no way to emulate this buggy behaviour with [`qiskit.qasm2`](#module-qiskit.qasm2 "qiskit.qasm2"); only an `include "qelib1.inc";` statement or the custom\_instructions argument can cause built-in Qiskit instructions to be used, and the signatures of these match each other.
+
+
+ Circuits imported with [`load()`](#qiskit.qasm2.load "qiskit.qasm2.load") and [`loads()`](#qiskit.qasm2.loads "qiskit.qasm2.loads") with the above legacy-compatibility settings should compare equal to those created by Qiskit’s legacy importer, provided no non-`qelib1.inc` user gates are defined. User-defined gates are handled slightly differently in the new importer, and while they should have equivalent [`definition`](qiskit.circuit.Instruction#definition "qiskit.circuit.Instruction.definition") fields on inspection, this module uses a custom class to lazily load the definition when it is requested (like most Qiskit objects), rather than eagerly creating it during the parse. Qiskit’s comparison rules for gates will see these two objects as unequal, although any pass through [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") for a particular backend should produce the same output circuits.
+
+
+
+
+## Alternatives
+
+The parser components of this module started off as a separate PyPI package: [qiskit-qasm2](https://pypi.org/project/qiskit-qasm2/). This package at version 0.5.3 was vendored into Qiskit Terra 0.24. Any subsequent changes between the two packages may not necessarily be kept in sync.
+
+There is a newer version of the OpenQASM specification, version 3.0, which is described at [https://openqasm.com](https://openqasm.com). This includes far more facilities for high-level classical programming. Qiskit has some rudimentary support for OpenQASM 3 already; see [`qiskit.qasm3`](qasm3#module-qiskit.qasm3 "qiskit.qasm3") for that.
+
+OpenQASM 2 is not a suitable serialization language for Qiskit’s [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"). This module is provided for interoperability purposes, not as a general serialization format. If that is what you need, consider using [`qiskit.qpy`](qpy#module-qiskit.qpy "qiskit.qpy") instead.
+
diff --git a/docs/api/qiskit/0.46/qasm3.md b/docs/api/qiskit/0.46/qasm3.md
new file mode 100644
index 00000000000..dfedb2c5339
--- /dev/null
+++ b/docs/api/qiskit/0.46/qasm3.md
@@ -0,0 +1,299 @@
+---
+title: qasm3
+description: API reference for qiskit.qasm3
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.qasm3
+---
+
+
+
+
+
+
+
+# OpenQASM 3
+
+
+
+`qiskit.qasm3`
+
+Qiskit provides some tools for converting between [OpenQASM 3](https://openqasm.com) representations of quantum programs, and the [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") class. These will continue to evolve as Qiskit’s support for the dynamic-circuit capabilities expressed by OpenQASM 3 increases.
+
+## Exporting to OpenQASM 3
+
+The high-level functions are simply [`dump()`](#qiskit.qasm3.dump "qiskit.qasm3.dump") and [`dumps()`](#qiskit.qasm3.dumps "qiskit.qasm3.dumps"), which respectively export to a file (given as a filename) and to a Python string.
+
+### dump
+
+
+
+`qiskit.qasm3.dump(circuit, stream, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qasm3/__init__.py "view source code")
+
+Serialize a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") object as an OpenQASM 3 stream to file-like object.
+
+**Parameters**
+
+* **circuit** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – Circuit to serialize.
+* **stream** (*TextIOBase*) – stream-like object to dump the OpenQASM 3 serialization
+* **\*\*kwargs** – Arguments for the [`Exporter`](#qiskit.qasm3.Exporter "qiskit.qasm3.Exporter") constructor.
+
+### dumps
+
+
+
+`qiskit.qasm3.dumps(circuit, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qasm3/__init__.py "view source code")
+
+Serialize a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") object in an OpenQASM 3 string.
+
+**Parameters**
+
+* **circuit** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – Circuit to serialize.
+* **\*\*kwargs** – Arguments for the [`Exporter`](#qiskit.qasm3.Exporter "qiskit.qasm3.Exporter") constructor.
+
+**Returns**
+
+The OpenQASM 3 serialization
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+Both of these exporter functions are single-use wrappers around the main [`Exporter`](#qiskit.qasm3.Exporter "qiskit.qasm3.Exporter") class. For more complex exporting needs, including dumping multiple circuits in a single session, it may be more convenient or faster to use the complete interface.
+
+
+
+`qiskit.qasm3.Exporter(includes=('stdgates.inc', ), basis_gates=('U', ), disable_constants=False, alias_classical_registers=None, allow_aliasing=None, indent=' ', experimental=ExperimentalFeatures.None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qasm3/exporter.py "view source code")
+
+QASM3 exporter main class.
+
+**Parameters**
+
+* **includes** ([*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – the filenames that should be emitted as includes. These files will be parsed for gates, and any objects dumped from this exporter will use those definitions where possible.
+
+* **basis\_gates** ([*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – the basic defined gate set of the backend.
+
+* **disable\_constants** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if `True`, always emit floating-point constants for numeric parameter values. If `False` (the default), then values close to multiples of OpenQASM 3 constants (`pi`, `euler`, and `tau`) will be emitted in terms of those constants instead, potentially improving accuracy in the output.
+
+* **alias\_classical\_registers** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) –
+
+ If `True`, then bits may be contained in more than one register. If so, the registers will be emitted using “alias” definitions, which might not be well supported by consumers of OpenQASM 3.
+
+
+ **Parameter `allow_aliasing`**
+
+ A value for `allow_aliasing` overrides any value given here, and supersedes this parameter.
+
+
+* **allow\_aliasing** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) –
+
+ If `True`, then bits may be contained in more than one register. If so, the registers will be emitted using “alias” definitions, which might not be well supported by consumers of OpenQASM 3. Defaults to `False` or the value of `alias_classical_registers`.
+
+ New in version 0.25.0.
+
+* **indent** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – the indentation string to use for each level within an indented block. Can be set to the empty string to disable indentation.
+
+* **experimental** ([*ExperimentalFeatures*](#qiskit.qasm3.ExperimentalFeatures "qiskit.qasm3.experimental.ExperimentalFeatures")) – any experimental features to enable during the export. See [`ExperimentalFeatures`](#qiskit.qasm3.ExperimentalFeatures "qiskit.qasm3.ExperimentalFeatures") for more details.
+
+### dump
+
+
+
+`dump(circuit, stream)`
+
+Convert the circuit to OpenQASM 3, dumping the result to a file or text stream.
+
+### dumps
+
+
+
+`dumps(circuit)`
+
+Convert the circuit to OpenQASM 3, returning the result as a string.
+
+All of these interfaces will raise [`QASM3ExporterError`](#qiskit.qasm3.QASM3ExporterError "qiskit.qasm3.QASM3ExporterError") on failure.
+
+### QASM3ExporterError
+
+
+
+`qiskit.qasm3.QASM3ExporterError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qasm3/exceptions.py "view source code")
+
+An error raised during running the OpenQASM 3 exporter.
+
+Set the error message.
+
+### Experimental features
+
+The OpenQASM 3 language is still evolving as hardware capabilities improve, so there is no final syntax that Qiskit can reliably target. In order to represent the evolving language, we will sometimes release features before formal standardization, which may need to change as the review process in the OpenQASM 3 design committees progresses. By default, the exporters will only support standardised features of the language. To enable these early-release features, use the `experimental` keyword argument of [`dump()`](#qiskit.qasm3.dump "qiskit.qasm3.dump") and [`dumps()`](#qiskit.qasm3.dumps "qiskit.qasm3.dumps"). The available feature flags are:
+
+
+
+`qiskit.qasm3.ExperimentalFeatures(value)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qasm3/experimental.py "view source code")
+
+Flags for experimental features that the OpenQASM 3 exporter supports.
+
+These are experimental and are more liable to change, because the OpenQASM 3 specification has not formally accepted them yet, so the syntax may not be finalized.
+
+
+
+### SWITCH\_CASE\_V1
+
+`= 1`
+
+Support exporting switch-case statements as proposed by [https://github.com/openqasm/openqasm/pull/463](https://github.com/openqasm/openqasm/pull/463) at [commit bfa787aa3078](https://github.com/openqasm/openqasm/pull/463/commits/bfa787aa3078).
+
+If you want to enable multiple experimental features, you should combine the flags using the `|` operator, such as `flag1 | flag2`.
+
+For example, to perform an export using the early semantics of `switch` support:
+
+```python
+from qiskit import qasm3, QuantumCircuit, QuantumRegister, ClassicalRegister
+
+# Build the circuit
+qreg = QuantumRegister(3)
+creg = ClassicalRegister(3)
+qc = QuantumCircuit(qreg, creg)
+with qc.switch(creg) as case:
+ with case(0):
+ qc.x(0)
+ with case(1, 2):
+ qc.x(1)
+ with case(case.DEFAULT):
+ qc.x(2)
+
+# Export to an OpenQASM 3 string.
+qasm_string = qasm3.dumps(qc, experimental=qasm3.ExperimentalFeatures.SWITCH_CASE_V1)
+```
+
+
+ All features enabled by the experimental flags are naturally transient. If it becomes necessary to remove flags, they will be subject to [the standard Qiskit deprecation policy](https://github.com/Qiskit/qiskit/blob/main/DEPRECATION.md). We will leave these experimental flags in place for as long as is reasonable.
+
+ However, we cannot guarantee any support windows for *consumers* of OpenQASM 3 code generated using these experimental flags, if the OpenQASM 3 language specification changes the proposal that the flag is based on. It is possible that any tool you are using to consume OpenQASM 3 code created using these flags may update or remove their support while Qiskit continues to offer the flag. You should not rely on the resultant experimental OpenQASM 3 code for long-term storage of programs.
+
+
+## Importing from OpenQASM 3
+
+Currently only two high-level functions are offered, as Qiskit support for importing from OpenQASM 3 is in its infancy, and the implementation is expected to change significantly. The two functions are [`load()`](#qiskit.qasm3.load "qiskit.qasm3.load") and [`loads()`](#qiskit.qasm3.loads "qiskit.qasm3.loads"), which are direct counterparts of [`dump()`](#qiskit.qasm3.dump "qiskit.qasm3.dump") and [`dumps()`](#qiskit.qasm3.dumps "qiskit.qasm3.dumps"), respectively loading a program indirectly from a named file and directly from a given string.
+
+
+ While we are still in the exploratory release period, to use either function, the package `qiskit_qasm3_import` must be installed. This can be done by installing Qiskit Terra with the `qasm3-import` extra, such as by:
+
+ ```python
+ pip install qiskit-terra[qasm3-import]
+ ```
+
+ We expect that this functionality will eventually be merged into core Terra, and no longer require an optional import, but we do not yet have a timeline for this.
+
+
+### load
+
+
+
+`qiskit.qasm3.load(filename)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qasm3/__init__.py "view source code")
+
+Load an OpenQASM 3 program from the file `filename`.
+
+**Parameters**
+
+**filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – the filename to load the program from.
+
+**Returns**
+
+a circuit representation of the OpenQASM 3 program.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**QASM3ImporterError**](#qiskit.qasm3.QASM3ImporterError "qiskit.qasm3.QASM3ImporterError") – if the OpenQASM 3 file is invalid, or cannot be represented by a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit").
+
+### loads
+
+
+
+`qiskit.qasm3.loads(program)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qasm3/__init__.py "view source code")
+
+Load an OpenQASM 3 program from the given string.
+
+**Parameters**
+
+**program** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – the OpenQASM 3 program.
+
+**Returns**
+
+a circuit representation of the OpenQASM 3 program.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**QASM3ImporterError**](#qiskit.qasm3.QASM3ImporterError "qiskit.qasm3.QASM3ImporterError") – if the OpenQASM 3 file is invalid, or cannot be represented by a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit").
+
+Both of these two functions raise [`QASM3ImporterError`](#qiskit.qasm3.QASM3ImporterError "qiskit.qasm3.QASM3ImporterError") on failure.
+
+### QASM3ImporterError
+
+
+
+`qiskit.qasm3.QASM3ImporterError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qasm3/exceptions.py "view source code")
+
+An error raised during the OpenQASM 3 importer.
+
+Set the error message.
+
+For example, we can define a quantum program using OpenQASM 3, and use [`loads()`](#qiskit.qasm3.loads "qiskit.qasm3.loads") to directly convert it into a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"):
+
+```python
+import qiskit.qasm3
+
+program = """
+ OPENQASM 3.0;
+ include "stdgates.inc";
+
+ input float[64] a;
+ qubit[3] q;
+ bit[2] mid;
+ bit[3] out;
+
+ let aliased = q[0:1];
+
+ gate my_gate(a) c, t {
+ gphase(a / 2);
+ ry(a) c;
+ cx c, t;
+ }
+ gate my_phase(a) c {
+ ctrl @ inv @ gphase(a) c;
+ }
+
+ my_gate(a * 2) aliased[0], q[{1, 2}][0];
+ measure q[0] -> mid[0];
+ measure q[1] -> mid[1];
+
+ while (mid == "00") {
+ reset q[0];
+ reset q[1];
+ my_gate(a) q[0], q[1];
+ my_phase(a - pi/2) q[1];
+ mid[0] = measure q[0];
+ mid[1] = measure q[1];
+ }
+
+ if (mid[0]) {
+ let inner_alias = q[{0, 1}];
+ reset inner_alias;
+ }
+
+ out = measure q;
+"""
+circuit = qiskit.qasm3.loads(program)
+circuit.draw("mpl")
+```
+
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.AlgorithmJob.md b/docs/api/qiskit/0.46/qiskit.algorithms.AlgorithmJob.md
new file mode 100644
index 00000000000..1c28c725869
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.AlgorithmJob.md
@@ -0,0 +1,168 @@
+---
+title: AlgorithmJob
+description: API reference for qiskit.algorithms.AlgorithmJob
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.AlgorithmJob
+---
+
+# AlgorithmJob
+
+
+
+`qiskit.algorithms.AlgorithmJob(function, *args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/algorithm_job.py "view source code")
+
+Bases: `PrimitiveJob`
+
+This empty class is introduced for typing purposes.
+
+**Parameters**
+
+**function** – a callable function to execute the job.
+
+## Attributes
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### backend
+
+
+
+`backend()`
+
+Return the backend where this job was executed.
+
+**Return type**
+
+[*Backend*](qiskit.providers.Backend "qiskit.providers.backend.Backend")
+
+### cancel
+
+
+
+`cancel()`
+
+Attempt to cancel the job.
+
+### cancelled
+
+
+
+`cancelled()`
+
+Return whether the job has been cancelled.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### done
+
+
+
+`done()`
+
+Return whether the job has successfully run.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### in\_final\_state
+
+
+
+`in_final_state()`
+
+Return whether the job is in a final job state such as `DONE` or `ERROR`.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### job\_id
+
+
+
+`job_id()`
+
+Return a unique id identifying the job.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### result
+
+
+
+`result()`
+
+Return the results of the job.
+
+**Return type**
+
+*T*
+
+### running
+
+
+
+`running()`
+
+Return whether the job is actively running.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### status
+
+
+
+`status()`
+
+Return the status of the job, among the values of `JobStatus`.
+
+### submit
+
+
+
+`submit()`
+
+Submit the job to the backend for execution.
+
+### wait\_for\_final\_state
+
+
+
+`wait_for_final_state(timeout=None, wait=5, callback=None)`
+
+Poll the job status until it progresses to a final state such as `DONE` or `ERROR`.
+
+**Parameters**
+
+* **timeout** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – Seconds to wait for the job. If `None`, wait indefinitely.
+
+* **wait** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Seconds between queries.
+
+* **callback** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *| None*) –
+
+ Callback function invoked after each query. The following positional arguments are provided to the callback function:
+
+ * job\_id: Job ID
+ * job\_status: Status of the job from the last query
+ * job: This BaseJob instance
+
+ Note: different subclass might provide different arguments to the callback function.
+
+**Raises**
+
+[**JobTimeoutError**](providers#qiskit.providers.JobTimeoutError "qiskit.providers.JobTimeoutError") – If the job does not reach a final state before the specified timeout.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.AmplificationProblem.md b/docs/api/qiskit/0.46/qiskit.algorithms.AmplificationProblem.md
new file mode 100644
index 00000000000..426a92036ac
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.AmplificationProblem.md
@@ -0,0 +1,93 @@
+---
+title: AmplificationProblem
+description: API reference for qiskit.algorithms.AmplificationProblem
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.AmplificationProblem
+---
+
+# AmplificationProblem
+
+
+
+`qiskit.algorithms.AmplificationProblem(oracle, state_preparation=None, grover_operator=None, post_processing=None, objective_qubits=None, is_good_state=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/amplitude_amplifiers/amplification_problem.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+The amplification problem is the input to amplitude amplification algorithms, like Grover.
+
+This class contains all problem-specific information required to run an amplitude amplification algorithm. It minimally contains the Grover operator. It can further hold some post processing on the optimal bitstring.
+
+**Parameters**
+
+* **oracle** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *|*[*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector")) – The oracle reflecting about the bad states.
+* **state\_preparation** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| None*) – A circuit preparing the input state, referred to as $\mathcal{A}$. If None, a layer of Hadamard gates is used.
+* **grover\_operator** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| None*) – The Grover operator $\mathcal{Q}$ used as unitary in the phase estimation circuit. If None, this operator is constructed from the `oracle` and `state_preparation`.
+* **post\_processing** (*Callable\[\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*], Any] | None*) – A mapping applied to the most likely bitstring.
+* **objective\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – If set, specifies the indices of the qubits that should be measured. If None, all qubits will be measured. The `is_good_state` function will be applied on the measurement outcome of these qubits.
+* **is\_good\_state** (*Callable\[\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*],* [*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")*] |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*] |* [*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") *| None*) – A function to check whether a string represents a good state. By default if the `oracle` argument has an `evaluate_bitstring` method (currently only provided by the [`PhaseOracle`](qiskit.circuit.library.PhaseOracle "qiskit.circuit.library.PhaseOracle") class) this will be used, otherwise this kwarg is required and **must** be specified.
+
+## Attributes
+
+
+
+### grover\_operator
+
+Get the $\mathcal{Q}$ operator, or Grover operator.
+
+If the Grover operator is not set, we try to build it from the $\mathcal{A}$ operator and objective\_qubits. This only works if objective\_qubits is a list of integers.
+
+**Returns**
+
+The Grover operator, or None if neither the Grover operator nor the $\mathcal{A}$ operator is set.
+
+
+
+### is\_good\_state
+
+Check whether a provided bitstring is a good state or not.
+
+**Returns**
+
+A callable that takes in a bitstring and returns True if the measurement is a good state, False otherwise.
+
+
+
+### objective\_qubits
+
+The indices of the objective qubits.
+
+**Returns**
+
+The indices of the objective qubits as list of integers.
+
+
+
+### oracle
+
+Return the oracle.
+
+**Returns**
+
+The oracle.
+
+
+
+### post\_processing
+
+Apply post processing to the input value.
+
+**Returns**
+
+A handle to the post processing function. Acts as identity by default.
+
+
+
+### state\_preparation
+
+Get the state preparation operator $\mathcal{A}$.
+
+**Returns**
+
+The $\mathcal{A}$ operator as QuantumCircuit.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.AmplitudeAmplifier.md b/docs/api/qiskit/0.46/qiskit.algorithms.AmplitudeAmplifier.md
new file mode 100644
index 00000000000..4b14d938e73
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.AmplitudeAmplifier.md
@@ -0,0 +1,40 @@
+---
+title: AmplitudeAmplifier
+description: API reference for qiskit.algorithms.AmplitudeAmplifier
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.AmplitudeAmplifier
+---
+
+# AmplitudeAmplifier
+
+
+
+`qiskit.algorithms.AmplitudeAmplifier`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/amplitude_amplifiers/amplitude_amplifier.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+The interface for amplification algorithms.
+
+## Methods
+
+### amplify
+
+
+
+`abstract amplify(amplification_problem)`
+
+Run the amplification algorithm.
+
+**Parameters**
+
+**amplification\_problem** ([*AmplificationProblem*](qiskit.algorithms.AmplificationProblem "qiskit.algorithms.amplitude_amplifiers.amplification_problem.AmplificationProblem")) – The amplification problem.
+
+**Returns**
+
+The result as a `AmplificationResult`, where e.g. the most likely state can be queried as `result.top_measurement`.
+
+**Return type**
+
+*AmplitudeAmplifierResult*
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.AmplitudeEstimation.md b/docs/api/qiskit/0.46/qiskit.algorithms.AmplitudeEstimation.md
new file mode 100644
index 00000000000..c844fb460d4
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.AmplitudeEstimation.md
@@ -0,0 +1,209 @@
+---
+title: AmplitudeEstimation
+description: API reference for qiskit.algorithms.AmplitudeEstimation
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.AmplitudeEstimation
+---
+
+# AmplitudeEstimation
+
+
+
+`qiskit.algorithms.AmplitudeEstimation(num_eval_qubits, phase_estimation_circuit=None, iqft=None, quantum_instance=None, sampler=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/amplitude_estimators/ae.py "view source code")
+
+Bases: [`AmplitudeEstimator`](qiskit.algorithms.AmplitudeEstimator "qiskit.algorithms.amplitude_estimators.amplitude_estimator.AmplitudeEstimator")
+
+The Quantum Phase Estimation-based Amplitude Estimation algorithm.
+
+This class implements the original Quantum Amplitude Estimation (QAE) algorithm, introduced by \[1]. This canonical version uses quantum phase estimation along with a set of $m$ additional evaluation qubits to find an estimate $\tilde{a}$, that is restricted to the grid
+
+$$
+\tilde{a} \in \{\sin^2(\pi y / 2^m) : y = 0, ..., 2^{m-1}\}
+$$
+
+More evaluation qubits produce a finer sampling grid, therefore the accuracy of the algorithm increases with $m$.
+
+Using a maximum likelihood post processing, this grid constraint can be circumvented. This improved estimator is implemented as well, see \[2] Appendix A for more detail.
+
+
+ This class does not support the [`EstimationProblem.is_good_state`](qiskit.algorithms.EstimationProblem#is_good_state "qiskit.algorithms.EstimationProblem.is_good_state") property, as for phase estimation-based QAE, the oracle that identifes the good states must be encoded in the Grover operator. To set custom oracles, the [`EstimationProblem.grover_operator`](qiskit.algorithms.EstimationProblem#grover_operator "qiskit.algorithms.EstimationProblem.grover_operator") attribute can be set directly.
+
+
+**References**
+
+**\[1]: Brassard, G., Hoyer, P., Mosca, M., & Tapp, A. (2000).**
+
+Quantum Amplitude Amplification and Estimation. [arXiv:quant-ph/0005055](http://arxiv.org/abs/quant-ph/0005055).
+
+**\[2]: Grinko, D., Gacon, J., Zoufal, C., & Woerner, S. (2019).**
+
+Iterative Quantum Amplitude Estimation. [arXiv:1912.05559](https://arxiv.org/abs/1912.05559).
+
+
+ `qiskit.algorithms.amplitude_estimators.ae.AmplitudeEstimation.__init__()`’s argument `quantum_instance` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. Instead, use the `sampler` argument. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+**Parameters**
+
+* **num\_eval\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of evaluation qubits.
+* **phase\_estimation\_circuit** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| None*) – The phase estimation circuit used to run the algorithm. Defaults to the standard phase estimation circuit from the circuit library, qiskit.circuit.library.PhaseEstimation when None.
+* **iqft** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| None*) – The inverse quantum Fourier transform component, defaults to using a standard implementation from qiskit.circuit.library.QFT when None.
+* **quantum\_instance** ([*QuantumInstance*](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance") *|*[*Backend*](qiskit.providers.Backend "qiskit.providers.Backend") *| None*) – Deprecated: The backend (or QuantumInstance) to execute the circuits on.
+* **sampler** ([*BaseSampler*](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler") *| None*) – A sampler primitive to evaluate the circuits.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If the number of evaluation qubits is smaller than 1.
+
+## Attributes
+
+
+
+### quantum\_instance
+
+Get the quantum instance.
+
+
+ The property `qiskit.algorithms.amplitude_estimators.ae.AmplitudeEstimation.quantum_instance` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+**Returns**
+
+The quantum instance used to run this algorithm.
+
+**Type**
+
+Deprecated
+
+
+
+### sampler
+
+Get the sampler primitive.
+
+**Returns**
+
+The sampler primitive to evaluate the circuits.
+
+## Methods
+
+### compute\_confidence\_interval
+
+
+
+`static compute_confidence_interval(result, alpha=0.05, kind='likelihood_ratio')`
+
+Compute the (1 - alpha) confidence interval.
+
+**Parameters**
+
+* **result** ([*AmplitudeEstimationResult*](qiskit.algorithms.AmplitudeEstimationResult "qiskit.algorithms.amplitude_estimators.ae.AmplitudeEstimationResult")) – An amplitude estimation result for which to compute the confidence interval.
+* **alpha** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Confidence level: compute the (1 - alpha) confidence interval.
+* **kind** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The method to compute the confidence interval, can be ‘fisher’, ‘observed\_fisher’ or ‘likelihood\_ratio’ (default)
+
+**Returns**
+
+The (1 - alpha) confidence interval of the specified kind.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – If the confidence interval method kind is not implemented.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)"), [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")]
+
+### compute\_mle
+
+
+
+`static compute_mle(result, apply_post_processing=False)`
+
+Compute the Maximum Likelihood Estimator (MLE).
+
+**Parameters**
+
+* **result** ([*AmplitudeEstimationResult*](qiskit.algorithms.AmplitudeEstimationResult "qiskit.algorithms.amplitude_estimators.ae.AmplitudeEstimationResult")) – An amplitude estimation result object.
+* **apply\_post\_processing** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, apply the post processing to the MLE before returning it.
+
+**Returns**
+
+The MLE for the provided result object.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+### construct\_circuit
+
+
+
+`construct_circuit(estimation_problem, measurement=False)`
+
+Construct the Amplitude Estimation quantum circuit.
+
+**Parameters**
+
+* **estimation\_problem** ([*EstimationProblem*](qiskit.algorithms.EstimationProblem "qiskit.algorithms.amplitude_estimators.estimation_problem.EstimationProblem")) – The estimation problem for which to construct the QAE circuit.
+* **measurement** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Boolean flag to indicate if measurements should be included in the circuit.
+
+**Returns**
+
+The QuantumCircuit object for the constructed circuit.
+
+**Return type**
+
+[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+### estimate
+
+
+
+`estimate(estimation_problem)`
+
+Run the amplitude estimation algorithm on provided estimation problem.
+
+**Parameters**
+
+**estimation\_problem** ([*EstimationProblem*](qiskit.algorithms.EstimationProblem "qiskit.algorithms.amplitude_estimators.estimation_problem.EstimationProblem")) – The estimation problem.
+
+**Returns**
+
+An amplitude estimation results object.
+
+**Raises**
+
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If state\_preparation or objective\_qubits are not set in the estimation\_problem.
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – A quantum instance or sampler must be provided.
+* [**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – Sampler job run error.
+
+**Return type**
+
+[*AmplitudeEstimationResult*](qiskit.algorithms.AmplitudeEstimationResult "qiskit.algorithms.amplitude_estimators.ae.AmplitudeEstimationResult")
+
+### evaluate\_measurements
+
+
+
+`evaluate_measurements(circuit_results, threshold=1e-06)`
+
+Evaluate the results from the circuit simulation.
+
+Given the probabilities from statevector simulation of the QAE circuit, compute the probabilities that the measurements y/gridpoints a are the best estimate.
+
+**Parameters**
+
+* **circuit\_results** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | np.ndarray*) – The circuit result from the QAE circuit. Can be either a counts dict or a statevector or a quasi-probabilities dict.
+* **threshold** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Measurements with probabilities below the threshold are discarded.
+
+**Returns**
+
+**Dictionaries containing the a gridpoints with respective probabilities and**
+
+y measurements with respective probabilities, in this order.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")\[[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)"), [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")], [dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")\[[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)"), [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")]]
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.AmplitudeEstimationResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.AmplitudeEstimationResult.md
new file mode 100644
index 00000000000..80b08e2a4dd
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.AmplitudeEstimationResult.md
@@ -0,0 +1,124 @@
+---
+title: AmplitudeEstimationResult
+description: API reference for qiskit.algorithms.AmplitudeEstimationResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.AmplitudeEstimationResult
+---
+
+# AmplitudeEstimationResult
+
+
+
+`qiskit.algorithms.AmplitudeEstimationResult`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/amplitude_estimators/ae.py "view source code")
+
+Bases: [`AmplitudeEstimatorResult`](qiskit.algorithms.AmplitudeEstimatorResult "qiskit.algorithms.amplitude_estimators.amplitude_estimator.AmplitudeEstimatorResult")
+
+The `AmplitudeEstimation` result object.
+
+## Attributes
+
+
+
+### circuit\_results
+
+Return the circuit results. Can be a statevector or counts dictionary.
+
+
+
+### confidence\_interval
+
+Return the confidence interval for the amplitude (95% interval by default).
+
+
+
+### confidence\_interval\_processed
+
+Return the post-processed confidence interval (95% interval by default).
+
+
+
+### estimation
+
+Return the estimation for the amplitude in $[0, 1]$.
+
+
+
+### estimation\_processed
+
+Return the estimation for the amplitude after the post-processing has been applied.
+
+
+
+### max\_probability
+
+Return the maximum sampling probability.
+
+
+
+### measurements
+
+Return the measurements as integers with their measurement probability.
+
+
+
+### mle
+
+Return the MLE for the amplitude, in $\[0, 1]\$.
+
+
+
+### mle\_processed
+
+Return the post-processed MLE for the amplitude.
+
+
+
+### num\_evaluation\_qubits
+
+Returns the number of evaluation qubits.
+
+
+
+### num\_oracle\_queries
+
+Return the number of Grover oracle queries.
+
+
+
+### post\_processing
+
+Return a handle to the post processing function.
+
+
+
+### samples
+
+Return the measurement samples with their measurement probability.
+
+
+
+### samples\_processed
+
+Return the post-processed measurement samples with their measurement probability.
+
+
+
+### shots
+
+Return the number of shots used. Is 1 for statevector-based simulations.
+
+## Methods
+
+### combine
+
+
+
+`combine(result)`
+
+Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Argument is None
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.AmplitudeEstimator.md b/docs/api/qiskit/0.46/qiskit.algorithms.AmplitudeEstimator.md
new file mode 100644
index 00000000000..821c503ac49
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.AmplitudeEstimator.md
@@ -0,0 +1,36 @@
+---
+title: AmplitudeEstimator
+description: API reference for qiskit.algorithms.AmplitudeEstimator
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.AmplitudeEstimator
+---
+
+# AmplitudeEstimator
+
+
+
+`qiskit.algorithms.AmplitudeEstimator`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/amplitude_estimators/amplitude_estimator.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+The Amplitude Estimation interface.
+
+## Methods
+
+### estimate
+
+
+
+`abstract estimate(estimation_problem)`
+
+Run the amplitude estimation algorithm.
+
+**Parameters**
+
+**estimation\_problem** ([*EstimationProblem*](qiskit.algorithms.EstimationProblem "qiskit.algorithms.amplitude_estimators.estimation_problem.EstimationProblem")) – An `EstimationProblem` containing all problem-relevant information such as the state preparation and the objective qubits.
+
+**Return type**
+
+[*AmplitudeEstimatorResult*](qiskit.algorithms.AmplitudeEstimatorResult "qiskit.algorithms.amplitude_estimators.amplitude_estimator.AmplitudeEstimatorResult")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.AmplitudeEstimatorResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.AmplitudeEstimatorResult.md
new file mode 100644
index 00000000000..5a0c1c7ded8
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.AmplitudeEstimatorResult.md
@@ -0,0 +1,82 @@
+---
+title: AmplitudeEstimatorResult
+description: API reference for qiskit.algorithms.AmplitudeEstimatorResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.AmplitudeEstimatorResult
+---
+
+# AmplitudeEstimatorResult
+
+
+
+`qiskit.algorithms.AmplitudeEstimatorResult`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/amplitude_estimators/amplitude_estimator.py "view source code")
+
+Bases: `AlgorithmResult`
+
+The results object for amplitude estimation algorithms.
+
+## Attributes
+
+
+
+### circuit\_results
+
+Return the circuit results. Can be a statevector or counts dictionary.
+
+
+
+### confidence\_interval
+
+Return the confidence interval for the amplitude (95% interval by default).
+
+
+
+### confidence\_interval\_processed
+
+Return the post-processed confidence interval (95% interval by default).
+
+
+
+### estimation
+
+Return the estimation for the amplitude in $[0, 1]$.
+
+
+
+### estimation\_processed
+
+Return the estimation for the amplitude after the post-processing has been applied.
+
+
+
+### num\_oracle\_queries
+
+Return the number of Grover oracle queries.
+
+
+
+### post\_processing
+
+Return a handle to the post processing function.
+
+
+
+### shots
+
+Return the number of shots used. Is 1 for statevector-based simulations.
+
+## Methods
+
+### combine
+
+
+
+`combine(result)`
+
+Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Argument is None
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.Eigensolver.md b/docs/api/qiskit/0.46/qiskit.algorithms.Eigensolver.md
new file mode 100644
index 00000000000..ad57568cab0
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.Eigensolver.md
@@ -0,0 +1,65 @@
+---
+title: Eigensolver
+description: API reference for qiskit.algorithms.Eigensolver
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.Eigensolver
+---
+
+# Eigensolver
+
+
+
+`qiskit.algorithms.Eigensolver`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/eigen_solvers/eigen_solver.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Deprecated: Eigensolver Interface.
+
+The Eigensolver interface has been superseded by the [`qiskit.algorithms.eigensolvers.Eigensolver`](qiskit.algorithms.eigensolvers.Eigensolver "qiskit.algorithms.eigensolvers.Eigensolver") interface. This interface will be deprecated in a future release and subsequently removed after that.
+
+Algorithms that can compute eigenvalues for an operator may implement this interface to allow different algorithms to be used interchangeably.
+
+
+ The class `qiskit.algorithms.eigen_solvers.eigen_solver.Eigensolver` is deprecated as of qiskit 0.24.0. It will be removed no earlier than 3 months after the release date. Instead, use the interface `qiskit.algorithms.eigensolvers.Eigensolver`. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+## Methods
+
+### compute\_eigenvalues
+
+
+
+`abstract compute_eigenvalues(operator, aux_operators=None)`
+
+Computes eigenvalues. Operator and aux\_operators can be supplied here and if not None will override any already set into algorithm so it can be reused with different operators. While an operator is required by algorithms, aux\_operators are optional. To ‘remove’ a previous aux\_operators array use an empty list here.
+
+**Parameters**
+
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")) – Qubit operator of the Observable
+* **aux\_operators** (*ListOrDict\[*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")*] | None*) – Optional list of auxiliary operators to be evaluated with the eigenstate of the minimum eigenvalue main result and their expectation values returned. For instance in chemistry these can be dipole operators, total particle count operators so we can get values for these at the ground state.
+
+**Returns**
+
+EigensolverResult
+
+**Return type**
+
+[EigensolverResult](qiskit.algorithms.EigensolverResult "qiskit.algorithms.EigensolverResult")
+
+### supports\_aux\_operators
+
+
+
+`classmethod supports_aux_operators()`
+
+Whether computing the expectation value of auxiliary operators is supported.
+
+**Returns**
+
+True if aux\_operator expectations can be evaluated, False otherwise
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.EigensolverResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.EigensolverResult.md
new file mode 100644
index 00000000000..03e7cb8b914
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.EigensolverResult.md
@@ -0,0 +1,60 @@
+---
+title: EigensolverResult
+description: API reference for qiskit.algorithms.EigensolverResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.EigensolverResult
+---
+
+# EigensolverResult
+
+
+
+`qiskit.algorithms.EigensolverResult`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/eigen_solvers/eigen_solver.py "view source code")
+
+Bases: `AlgorithmResult`
+
+Deprecated: Eigensolver Result.
+
+The EigensolverResult class has been superseded by the [`qiskit.algorithms.eigensolvers.EigensolverResult`](qiskit.algorithms.eigensolvers.EigensolverResult "qiskit.algorithms.eigensolvers.EigensolverResult") class. This class will be deprecated in a future release and subsequently removed after that.
+
+
+ The class `qiskit.algorithms.eigen_solvers.eigen_solver.EigensolverResult` is deprecated as of qiskit 0.24.0. It will be removed no earlier than 3 months after the release date. Instead, use the class `qiskit.algorithms.eigensolvers.EigensolverResult`. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+## Attributes
+
+
+
+### aux\_operator\_eigenvalues
+
+Return aux operator expectation values.
+
+These values are in fact tuples formatted as (mean, standard deviation).
+
+
+
+### eigenstates
+
+return eigen states
+
+
+
+### eigenvalues
+
+returns eigen values
+
+## Methods
+
+### combine
+
+
+
+`combine(result)`
+
+Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Argument is None
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.EstimationProblem.md b/docs/api/qiskit/0.46/qiskit.algorithms.EstimationProblem.md
new file mode 100644
index 00000000000..aeac7da70d1
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.EstimationProblem.md
@@ -0,0 +1,116 @@
+---
+title: EstimationProblem
+description: API reference for qiskit.algorithms.EstimationProblem
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.EstimationProblem
+---
+
+# EstimationProblem
+
+
+
+`qiskit.algorithms.EstimationProblem(state_preparation, objective_qubits, grover_operator=None, post_processing=None, is_good_state=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/amplitude_estimators/estimation_problem.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+The estimation problem is the input to amplitude estimation algorithm.
+
+This class contains all problem-specific information required to run an amplitude estimation algorithm. That means, it minimally contains the state preparation and the specification of the good state. It can further hold some post processing on the estimation of the amplitude or a custom Grover operator.
+
+**Parameters**
+
+* **state\_preparation** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – A circuit preparing the input state, referred to as $\mathcal{A}$.
+* **objective\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – A single qubit index or a list of qubit indices to specify which qubits to measure. The `is_good_state` function is applied on the bitstring of these objective qubits.
+* **grover\_operator** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| None*) – The Grover operator $\mathcal{Q}$ used as unitary in the phase estimation circuit.
+* **post\_processing** (*Callable\[\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – A mapping applied to the result of the algorithm $0 \leq a \leq 1$, usually used to map the estimate to a target interval. Defaults to the identity.
+* **is\_good\_state** (*Callable\[\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*],* [*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")*] | None*) – A function to check whether a string represents a good state. Defaults to all objective qubits being in state $|1\rangle$.
+
+## Attributes
+
+
+
+### grover\_operator
+
+Get the $\mathcal{Q}$ operator, or Grover operator.
+
+If the Grover operator is not set, we try to build it from the $\mathcal{A}$ operator and objective\_qubits. This only works if objective\_qubits is a list of integers.
+
+**Returns**
+
+The Grover operator, or None if neither the Grover operator nor the $\mathcal{A}$ operator is set.
+
+
+
+### has\_good\_state
+
+Check whether an [`is_good_state`](#qiskit.algorithms.EstimationProblem.is_good_state "qiskit.algorithms.EstimationProblem.is_good_state") function is set.
+
+Some amplitude estimators, such as [`AmplitudeEstimation`](qiskit.algorithms.AmplitudeEstimation "qiskit.algorithms.AmplitudeEstimation") do not support a custom implementation of the [`is_good_state`](#qiskit.algorithms.EstimationProblem.is_good_state "qiskit.algorithms.EstimationProblem.is_good_state") function, and can only handle the default.
+
+**Returns**
+
+`True`, if a custom [`is_good_state`](#qiskit.algorithms.EstimationProblem.is_good_state "qiskit.algorithms.EstimationProblem.is_good_state") is set, otherwise returns `False`.
+
+
+
+### is\_good\_state
+
+Checks whether a bitstring represents a good state.
+
+**Returns**
+
+Handle to the `is_good_state` callable.
+
+
+
+### objective\_qubits
+
+Get the criterion for a measurement outcome to be in a ‘good’ state.
+
+**Returns**
+
+The criterion as list of qubit indices.
+
+
+
+### post\_processing
+
+Apply post processing to the input value.
+
+**Returns**
+
+A handle to the post processing function. Acts as identity by default.
+
+
+
+### state\_preparation
+
+Get the $\mathcal{A}$ operator encoding the amplitude $a$.
+
+**Returns**
+
+The $\mathcal{A}$ operator as QuantumCircuit.
+
+## Methods
+
+### rescale
+
+
+
+`rescale(scaling_factor)`
+
+Rescale the good state amplitude in the estimation problem.
+
+**Parameters**
+
+**scaling\_factor** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The scaling factor in \[0, 1].
+
+**Returns**
+
+A rescaled estimation problem.
+
+**Return type**
+
+[*EstimationProblem*](#qiskit.algorithms.EstimationProblem "qiskit.algorithms.amplitude_estimators.estimation_problem.EstimationProblem")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.EvolutionProblem.md b/docs/api/qiskit/0.46/qiskit.algorithms.EvolutionProblem.md
new file mode 100644
index 00000000000..64be4821117
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.EvolutionProblem.md
@@ -0,0 +1,62 @@
+---
+title: EvolutionProblem
+description: API reference for qiskit.algorithms.EvolutionProblem
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.EvolutionProblem
+---
+
+# EvolutionProblem
+
+
+
+`qiskit.algorithms.EvolutionProblem(hamiltonian, time, initial_state=None, aux_operators=None, truncation_threshold=1e-12, t_param=None, param_value_dict=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/evolvers/evolution_problem.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Deprecated: Evolution problem class.
+
+The EvolutionProblem class has been superseded by the `qiskit.algorithms.time_evolvers.TimeEvolutionProblem` class. This class will be deprecated in a future release and subsequently removed after that.
+
+This class is the input to time evolution algorithms and must contain information on the total evolution time, a quantum state to be evolved and under which Hamiltonian the state is evolved.
+
+
+ The class `qiskit.algorithms.evolvers.evolution_problem.EvolutionProblem` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. Instead, use the class `qiskit.algorithms.time_evolvers.TimeEvolutionProblem`. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+**Parameters**
+
+* **hamiltonian** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")) – The Hamiltonian under which to evolve the system.
+* **time** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Total time of evolution.
+* **initial\_state** ([*StateFn*](qiskit.opflow.state_fns.StateFn "qiskit.opflow.state_fns.StateFn") *|*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| None*) – The quantum state to be evolved for methods like Trotterization. For variational time evolutions, where the evolution happens in an ansatz, this argument is not required.
+* **aux\_operators** (*ListOrDict\[*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")*] | None*) – Optional list of auxiliary operators to be evaluated with the evolved `initial_state` and their expectation values returned.
+* **truncation\_threshold** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Defines a threshold under which values can be assumed to be 0. Used when `aux_operators` is provided.
+* **t\_param** ([*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter") *| None*) – Time parameter in case of a time-dependent Hamiltonian. This free parameter must be within the `hamiltonian`.
+* **param\_value\_dict** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*,* [*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*] | None*) – Maps free parameters in the problem to values. Depending on the algorithm, it might refer to e.g. a Hamiltonian or an initial state.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If non-positive time of evolution is provided.
+
+## Attributes
+
+
+
+### time
+
+Returns time.
+
+## Methods
+
+### validate\_params
+
+
+
+`validate_params()`
+
+Checks if all parameters present in the Hamiltonian are also present in the dictionary that maps them to values.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If Hamiltonian parameters cannot be bound with data provided.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.EvolutionResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.EvolutionResult.md
new file mode 100644
index 00000000000..09ed5d3cd01
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.EvolutionResult.md
@@ -0,0 +1,43 @@
+---
+title: EvolutionResult
+description: API reference for qiskit.algorithms.EvolutionResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.EvolutionResult
+---
+
+# EvolutionResult
+
+
+
+`qiskit.algorithms.EvolutionResult(evolved_state, aux_ops_evaluated=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/evolvers/evolution_result.py "view source code")
+
+Bases: `AlgorithmResult`
+
+Deprecated: Class for holding evolution result.
+
+The EvolutionResult class has been superseded by the `qiskit.algorithms.time_evolvers.TimeEvolutionResult` class. This class will be deprecated in a future release and subsequently removed after that.
+
+
+ The class `qiskit.algorithms.evolvers.evolution_result.EvolutionResult` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. Instead, use the class `qiskit.algorithms.time_evolvers.TimeEvolutionResult`. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+**Parameters**
+
+* **evolved\_state** ([*StateFn*](qiskit.opflow.state_fns.StateFn "qiskit.opflow.state_fns.StateFn") *|*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *|*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")) – An evolved quantum state.
+* **aux\_ops\_evaluated** (*ListOrDict\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*,* [*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*]] | None*) – Optional list of observables for which expected values on an evolved state are calculated. These values are in fact tuples formatted as (mean, standard deviation).
+
+## Methods
+
+### combine
+
+
+
+`combine(result)`
+
+Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Argument is None
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.FasterAmplitudeEstimation.md b/docs/api/qiskit/0.46/qiskit.algorithms.FasterAmplitudeEstimation.md
new file mode 100644
index 00000000000..f05209412d3
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.FasterAmplitudeEstimation.md
@@ -0,0 +1,129 @@
+---
+title: FasterAmplitudeEstimation
+description: API reference for qiskit.algorithms.FasterAmplitudeEstimation
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.FasterAmplitudeEstimation
+---
+
+# FasterAmplitudeEstimation
+
+
+
+`qiskit.algorithms.FasterAmplitudeEstimation(delta, maxiter, rescale=True, quantum_instance=None, sampler=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/amplitude_estimators/fae.py "view source code")
+
+Bases: [`AmplitudeEstimator`](qiskit.algorithms.AmplitudeEstimator "qiskit.algorithms.amplitude_estimators.amplitude_estimator.AmplitudeEstimator")
+
+The Faster Amplitude Estimation algorithm.
+
+The Faster Amplitude Estimation (FAE) \[1] algorithm is a variant of Quantum Amplitude Estimation (QAE), where the Quantum Phase Estimation (QPE) by an iterative Grover search, similar to \[2].
+
+Due to the iterative version of the QPE, this algorithm does not require any additional qubits, as the originally proposed QAE \[3] and thus the resulting circuits are less complex.
+
+**References**
+
+**\[1]: K. Nakaji. Faster Amplitude Estimation, 2020;**
+
+[arXiv:2002.02417](https://arxiv.org/pdf/2003.02417.pdf)
+
+**\[2]: D. Grinko et al. Iterative Amplitude Estimation, 2019;**
+
+[arXiv:1912.05559](http://arxiv.org/abs/1912.05559)
+
+**\[3]: G. Brassard et al. Quantum Amplitude Amplification and Estimation, 2000;**
+
+[arXiv:quant-ph/0005055](http://arxiv.org/abs/quant-ph/0005055)
+
+
+ `qiskit.algorithms.amplitude_estimators.fae.FasterAmplitudeEstimation.__init__()`’s argument `quantum_instance` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. Instead, use the `sampler` argument. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+**Parameters**
+
+* **delta** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The probability that the true value is outside of the final confidence interval.
+* **maxiter** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of iterations, the maximal power of Q is 2 \*\* (maxiter - 1).
+* **rescale** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to rescale the problem passed to estimate.
+* **quantum\_instance** ([*QuantumInstance*](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance") *|*[*Backend*](qiskit.providers.Backend "qiskit.providers.Backend") *| None*) – Deprecated: The quantum instance or backend to run the circuits.
+* **sampler** ([*BaseSampler*](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler") *| None*) – A sampler primitive to evaluate the circuits.
+
+
+ This algorithm overwrites the number of shots set in the `quantum_instance` argument, but will reset them to the initial number after running.
+
+
+## Attributes
+
+
+
+### quantum\_instance
+
+Deprecated. Get the quantum instance.
+
+
+ The property `qiskit.algorithms.amplitude_estimators.fae.FasterAmplitudeEstimation.quantum_instance` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+**Returns**
+
+The quantum instance used to run this algorithm.
+
+
+
+### sampler
+
+Get the sampler primitive.
+
+**Returns**
+
+The sampler primitive to evaluate the circuits.
+
+## Methods
+
+### construct\_circuit
+
+
+
+`construct_circuit(estimation_problem, k, measurement=False)`
+
+Construct the circuit $Q^k X |0\rangle>$.
+
+The A operator is the unitary specifying the QAE problem and Q the associated Grover operator.
+
+**Parameters**
+
+* **estimation\_problem** ([*EstimationProblem*](qiskit.algorithms.EstimationProblem "qiskit.algorithms.EstimationProblem")) – The estimation problem for which to construct the circuit.
+* **k** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The power of the Q operator.
+* **measurement** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Boolean flag to indicate if measurements should be included in the circuits.
+
+**Returns**
+
+The circuit $Q^k X |0\rangle$.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") | [tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")]]
+
+### estimate
+
+
+
+`estimate(estimation_problem)`
+
+Run the amplitude estimation algorithm on provided estimation problem.
+
+**Parameters**
+
+**estimation\_problem** ([*EstimationProblem*](qiskit.algorithms.EstimationProblem "qiskit.algorithms.amplitude_estimators.estimation_problem.EstimationProblem")) – The estimation problem.
+
+**Returns**
+
+An amplitude estimation results object.
+
+**Raises**
+
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – A quantum instance or Sampler must be provided.
+* [**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – Sampler run error.
+
+**Return type**
+
+[*FasterAmplitudeEstimationResult*](qiskit.algorithms.FasterAmplitudeEstimationResult "qiskit.algorithms.amplitude_estimators.fae.FasterAmplitudeEstimationResult")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.FasterAmplitudeEstimationResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.FasterAmplitudeEstimationResult.md
new file mode 100644
index 00000000000..4dbb1d7c8d1
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.FasterAmplitudeEstimationResult.md
@@ -0,0 +1,106 @@
+---
+title: FasterAmplitudeEstimationResult
+description: API reference for qiskit.algorithms.FasterAmplitudeEstimationResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.FasterAmplitudeEstimationResult
+---
+
+# FasterAmplitudeEstimationResult
+
+
+
+`qiskit.algorithms.FasterAmplitudeEstimationResult`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/amplitude_estimators/fae.py "view source code")
+
+Bases: [`AmplitudeEstimatorResult`](qiskit.algorithms.AmplitudeEstimatorResult "qiskit.algorithms.amplitude_estimators.amplitude_estimator.AmplitudeEstimatorResult")
+
+The result object for the Faster Amplitude Estimation algorithm.
+
+## Attributes
+
+
+
+### circuit\_results
+
+Return the circuit results. Can be a statevector or counts dictionary.
+
+
+
+### confidence\_interval
+
+Return the confidence interval for the amplitude (95% interval by default).
+
+
+
+### confidence\_interval\_processed
+
+Return the post-processed confidence interval (95% interval by default).
+
+
+
+### estimation
+
+Return the estimation for the amplitude in $[0, 1]$.
+
+
+
+### estimation\_processed
+
+Return the estimation for the amplitude after the post-processing has been applied.
+
+
+
+### num\_first\_state\_steps
+
+Return the number of steps taken in the first step of algorithm.
+
+
+
+### num\_oracle\_queries
+
+Return the number of Grover oracle queries.
+
+
+
+### num\_steps
+
+Return the total number of steps taken in the algorithm.
+
+
+
+### post\_processing
+
+Return a handle to the post processing function.
+
+
+
+### shots
+
+Return the number of shots used. Is 1 for statevector-based simulations.
+
+
+
+### success\_probability
+
+Return the success probability of the algorithm.
+
+
+
+### theta\_intervals
+
+Return the confidence intervals for the angles in each iteration.
+
+## Methods
+
+### combine
+
+
+
+`combine(result)`
+
+Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Argument is None
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.Grover.md b/docs/api/qiskit/0.46/qiskit.algorithms.Grover.md
new file mode 100644
index 00000000000..b7db25ad874
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.Grover.md
@@ -0,0 +1,196 @@
+---
+title: Grover
+description: API reference for qiskit.algorithms.Grover
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.Grover
+---
+
+# Grover
+
+
+
+`qiskit.algorithms.Grover(iterations=None, growth_rate=None, sample_from_iterations=False, quantum_instance=None, sampler=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/amplitude_amplifiers/grover.py "view source code")
+
+Bases: [`AmplitudeAmplifier`](qiskit.algorithms.AmplitudeAmplifier "qiskit.algorithms.amplitude_amplifiers.amplitude_amplifier.AmplitudeAmplifier")
+
+Grover’s Search algorithm.
+
+
+ If you want to learn more about the theory behind Grover’s Search algorithm, check out the [Qiskit Textbook](https://qiskit.org/textbook/ch-algorithms/grover.html). or the [Qiskit Tutorials](https://qiskit.org/documentation/tutorials/algorithms/07_grover_examples.html) for more concrete how-to examples.
+
+
+Grover’s Search \[1, 2] is a well known quantum algorithm that can be used for searching through unstructured collections of records for particular targets with quadratic speedup compared to classical algorithms.
+
+Given a set $X$ of $N$ elements $X=\{x_1,x_2,\ldots,x_N\}$ and a boolean function $f : X \rightarrow \{0,1\}$, the goal of an unstructured-search problem is to find an element $x^* \in X$ such that $f(x^*)=1$.
+
+The search is called *unstructured* because there are no guarantees as to how the database is ordered. On a sorted database, for instance, one could perform binary search to find an element in $\mathbb{O}(\log N)$ worst-case time. Instead, in an unstructured-search problem, there is no prior knowledge about the contents of the database. With classical circuits, there is no alternative but to perform a linear number of queries to find the target element. Conversely, Grover’s Search algorithm allows to solve the unstructured-search problem on a quantum computer in $\mathcal{O}(\sqrt{N})$ queries.
+
+To carry out this search a so-called oracle is required, that flags a good element/state. The action of the oracle $\mathcal{S}_f$ is
+
+$$
+\mathcal{S}_f |x\rangle = (-1)^{f(x)} |x\rangle,
+$$
+
+i.e. it flips the phase of the state $|x\rangle$ if $x$ is a hit. The details of how $S_f$ works are unimportant to the algorithm; Grover’s search algorithm treats the oracle as a black box.
+
+This class supports oracles in form of a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit").
+
+With the given oracle, Grover’s Search constructs the Grover operator to amplify the amplitudes of the good states:
+
+$$
+\mathcal{Q} = H^{\otimes n} \mathcal{S}_0 H^{\otimes n} \mathcal{S}_f
+ = D \mathcal{S}_f,
+$$
+
+where $\mathcal{S}_0$ flips the phase of the all-zero state and acts as identity on all other states. Sometimes the first three operands are summarized as diffusion operator, which implements a reflection over the equal superposition state.
+
+If the number of solutions is known, we can calculate how often $\mathcal{Q}$ should be applied to find a solution with very high probability, see the method optimal\_num\_iterations. If the number of solutions is unknown, the algorithm tries different powers of Grover’s operator, see the iterations argument, and after each iteration checks if a good state has been measured using good\_state.
+
+The generalization of Grover’s Search, Quantum Amplitude Amplification \[3], uses a modified version of $\mathcal{Q}$ where the diffusion operator does not reflect about the equal superposition state, but another state specified via an operator $\mathcal{A}$:
+
+$$
+\mathcal{Q} = \mathcal{A} \mathcal{S}_0 \mathcal{A}^\dagger \mathcal{S}_f.
+$$
+
+For more information, see the [`GroverOperator`](qiskit.circuit.library.GroverOperator "qiskit.circuit.library.GroverOperator") in the circuit library.
+
+**References**
+
+**\[1]: L. K. Grover (1996), A fast quantum mechanical algorithm for database search,**
+
+[arXiv:quant-ph/9605043](https://arxiv.org/abs/quant-ph/9605043).
+
+**\[2]: I. Chuang & M. Nielsen, Quantum Computation and Quantum Information,**
+
+Cambridge: Cambridge University Press, 2000. Chapter 6.1.2.
+
+**\[3]: Brassard, G., Hoyer, P., Mosca, M., & Tapp, A. (2000).**
+
+Quantum Amplitude Amplification and Estimation. [arXiv:quant-ph/0005055](http://arxiv.org/abs/quant-ph/0005055).
+
+
+ `qiskit.algorithms.amplitude_amplifiers.grover.Grover.__init__()`’s argument `quantum_instance` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. Instead, use the `sampler` argument. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+**Parameters**
+
+* **iterations** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | Iterator\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] |* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – Specify the number of iterations/power of Grover’s operator to be checked. \* If an int, only one circuit is run with that power of the Grover operator. If the number of solutions is known, this option should be used with the optimal power. The optimal power can be computed with `Grover.optimal_num_iterations`. \* If a list, all the powers in the list are run in the specified order. \* If an iterator, the powers yielded by the iterator are checked, until a maximum number of iterations or maximum power is reached. \* If `None`, the [`AmplificationProblem`](qiskit.algorithms.AmplificationProblem "qiskit.algorithms.AmplificationProblem") provided must have an `is_good_state`, and circuits are run until that good state is reached.
+* **growth\_rate** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – If specified, the iterator is set to increasing powers of `growth_rate`, i.e. to `int(growth_rate ** 1), int(growth_rate ** 2), ...` until a maximum number of iterations is reached.
+* **sample\_from\_iterations** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, instead of taking the values in `iterations` as powers of the Grover operator, a random integer sample between 0 and smaller value than the iteration is used as a power, see \[1], Section 4.
+* **quantum\_instance** ([*QuantumInstance*](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance") *|*[*Backend*](qiskit.providers.Backend "qiskit.providers.Backend") *| None*) – Deprecated: A Quantum Instance or Backend to run the circuits.
+* **sampler** ([*BaseSampler*](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler") *| None*) – A Sampler to use for sampling the results of the circuits.
+
+**Raises**
+
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `growth_rate` is a float but not larger than 1.
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If both `iterations` and `growth_rate` is set.
+
+**References**
+
+**\[1]: Boyer et al., Tight bounds on quantum searching**
+
+[https://arxiv.org/abs/quant-ph/9605034](https://arxiv.org/abs/quant-ph/9605034)
+
+## Attributes
+
+
+
+### quantum\_instance
+
+Deprecated. Get the quantum instance.
+
+
+ The property `qiskit.algorithms.amplitude_amplifiers.grover.Grover.quantum_instance` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+**Returns**
+
+The quantum instance used to run this algorithm.
+
+
+
+### sampler
+
+Get the sampler.
+
+**Returns**
+
+The sampler used to run this algorithm.
+
+## Methods
+
+### amplify
+
+
+
+`amplify(amplification_problem)`
+
+Run the Grover algorithm.
+
+**Parameters**
+
+**amplification\_problem** ([*AmplificationProblem*](qiskit.algorithms.AmplificationProblem "qiskit.algorithms.amplitude_amplifiers.amplification_problem.AmplificationProblem")) – The amplification problem.
+
+**Returns**
+
+The result as a `GroverResult`, where e.g. the most likely state can be queried as `result.top_measurement`.
+
+**Raises**
+
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If a quantum instance or sampler is not set.
+* [**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – If a sampler job fails.
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – If `is_good_state` is not provided and is required (i.e. when iterations
+* **is None**\*\* or ****a list****)\*\* –
+
+**Return type**
+
+[*GroverResult*](qiskit.algorithms.GroverResult "qiskit.algorithms.amplitude_amplifiers.grover.GroverResult")
+
+### construct\_circuit
+
+
+
+`construct_circuit(problem, power=None, measurement=False)`
+
+Construct the circuit for Grover’s algorithm with `power` Grover operators.
+
+**Parameters**
+
+* **problem** ([*AmplificationProblem*](qiskit.algorithms.AmplificationProblem "qiskit.algorithms.AmplificationProblem")) – The amplification problem for the algorithm.
+* **power** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of times the Grover operator is repeated. If None, this argument is set to the first item in `iterations`.
+* **measurement** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Boolean flag to indicate if measurement should be included in the circuit.
+
+**Returns**
+
+the QuantumCircuit object for the constructed circuit
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If no power is passed and the iterations are not an integer.
+
+### optimal\_num\_iterations
+
+
+
+`static optimal_num_iterations(num_solutions, num_qubits)`
+
+Return the optimal number of iterations, if the number of solutions is known.
+
+**Parameters**
+
+* **num\_solutions** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of solutions.
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of qubits used to encode the states.
+
+**Returns**
+
+The optimal number of iterations for Grover’s algorithm to succeed.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.GroverResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.GroverResult.md
new file mode 100644
index 00000000000..2c282eeee73
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.GroverResult.md
@@ -0,0 +1,86 @@
+---
+title: GroverResult
+description: API reference for qiskit.algorithms.GroverResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.GroverResult
+---
+
+# GroverResult
+
+
+
+`qiskit.algorithms.GroverResult`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/amplitude_amplifiers/grover.py "view source code")
+
+Bases: `AmplitudeAmplifierResult`
+
+Grover Result.
+
+## Attributes
+
+
+
+### assignment
+
+The post-processed value of the most likely bitstring.
+
+**Returns**
+
+The output of the `post_processing` function of the respective `AmplificationProblem`, where the input is the `top_measurement`. The type is the same as the return type of the post-processing function.
+
+
+
+### circuit\_results
+
+Return the circuit results. Can be a statevector or counts dictionary.
+
+
+
+### iterations
+
+All the powers of the Grover operator that have been tried.
+
+**Returns**
+
+The powers of the Grover operator tested.
+
+
+
+### max\_probability
+
+Return the maximum sampling probability.
+
+
+
+### oracle\_evaluation
+
+Whether the classical oracle evaluation of the top measurement was True or False.
+
+**Returns**
+
+The classical oracle evaluation of the top measurement.
+
+
+
+### top\_measurement
+
+The most frequently measured output as bitstring.
+
+**Returns**
+
+The most frequently measured output state.
+
+## Methods
+
+### combine
+
+
+
+`combine(result)`
+
+Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Argument is None
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.HamiltonianPhaseEstimation.md b/docs/api/qiskit/0.46/qiskit.algorithms.HamiltonianPhaseEstimation.md
new file mode 100644
index 00000000000..17276958a9c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.HamiltonianPhaseEstimation.md
@@ -0,0 +1,90 @@
+---
+title: HamiltonianPhaseEstimation
+description: API reference for qiskit.algorithms.HamiltonianPhaseEstimation
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.HamiltonianPhaseEstimation
+---
+
+# HamiltonianPhaseEstimation
+
+
+
+`qiskit.algorithms.HamiltonianPhaseEstimation(num_evaluation_qubits, quantum_instance=None, sampler=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/phase_estimators/hamiltonian_phase_estimation.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Run the Quantum Phase Estimation algorithm to find the eigenvalues of a Hermitian operator.
+
+This class is nearly the same as [`PhaseEstimation`](qiskit.algorithms.PhaseEstimation "qiskit.algorithms.PhaseEstimation"), differing only in that the input in that class is a unitary operator, whereas here the input is a Hermitian operator from which a unitary will be obtained by scaling and exponentiating. The scaling is performed in order to prevent the phases from wrapping around $2\pi$. The problem of estimating eigenvalues $\lambda_j$ of the Hermitian operator $H$ is solved by running a circuit representing
+
+$$
+\exp(i b H) |\psi\rangle = \sum_j \exp(i b \lambda_j) c_j |\lambda_j\rangle,
+$$
+
+where the input state is
+
+$$
+|\psi\rangle = \sum_j c_j |\lambda_j\rangle,
+$$
+
+and $\lambda_j$ are the eigenvalues of $H$.
+
+Here, $b$ is a scaling factor sufficiently large to map positive $\lambda$ to $[0,\pi)$ and negative $\lambda$ to $[\pi,2\pi)$. Each time the circuit is run, one measures a phase corresponding to $lambda_j$ with probability $|c_j|^2$.
+
+If $H$ is a Pauli sum, the bound $b$ is computed from the sum of the absolute values of the coefficients of the terms. There is no way to reliably recover eigenvalues from phases very near the endpoints of these intervals. Because of this you should be aware that for degenerate cases, such as $H=Z$, the eigenvalues $\pm 1$ will be mapped to the same phase, $\pi$, and so cannot be distinguished. In this case, you need to specify a larger bound as an argument to the method `estimate`.
+
+This class uses and works together with [`PhaseEstimationScale`](qiskit.algorithms.PhaseEstimationScale "qiskit.algorithms.PhaseEstimationScale") to manage scaling the Hamiltonian and the phases that are obtained by the QPE algorithm. This includes setting, or computing, a bound on the eigenvalues of the operator, using this bound to obtain a scale factor, scaling the operator, and shifting and scaling the measured phases to recover the eigenvalues.
+
+Note that, although we speak of “evolving” the state according the Hamiltonian, in the present algorithm, we are not actually considering time evolution. Rather, the role of time is played by the scaling factor, which is chosen to best extract the eigenvalues of the Hamiltonian.
+
+A few of the ideas in the algorithm may be found in Ref. \[1].
+
+**Reference:**
+
+**\[1]: Quantum phase estimation of multiple eigenvalues for small-scale (noisy) experiments**
+
+T.E. O’Brien, B. Tarasinski, B.M. Terhal [arXiv:1809.09697](https://arxiv.org/abs/1809.09697)
+
+
+ `qiskit.algorithms.phase_estimators.hamiltonian_phase_estimation.HamiltonianPhaseEstimation.__init__()`’s argument `quantum_instance` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. Instead, use the `sampler` argument. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+**Parameters**
+
+* **num\_evaluation\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of qubits used in estimating the phase. The phase will be estimated as a binary string with this many bits.
+* **quantum\_instance** ([*QuantumInstance*](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance") *|*[*Backend*](qiskit.providers.Backend "qiskit.providers.Backend") *| None*) – Deprecated: The quantum instance on which the circuit will be run.
+* **sampler** ([*BaseSampler*](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler") *| None*) – The sampler primitive on which the circuit will be sampled.
+
+## Methods
+
+### estimate
+
+
+
+`estimate(hamiltonian, state_preparation=None, evolution=None, bound=None)`
+
+Run the Hamiltonian phase estimation algorithm.
+
+**Parameters**
+
+* **hamiltonian** ([*PauliOp*](qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.PauliOp") *|*[*MatrixOp*](qiskit.opflow.primitive_ops.MatrixOp "qiskit.opflow.primitive_ops.MatrixOp") *|*[*SummedOp*](qiskit.opflow.list_ops.SummedOp "qiskit.opflow.list_ops.SummedOp") *|*[*Pauli*](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli") *|*[*SparsePauliOp*](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp") *|*[*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")) – A Hermitian operator. If the algorithm is used with a `Sampler` primitive, the allowed types are `Pauli`, `SparsePauliOp`, and `PauliSumOp`. If the algorithm is used with a `QuantumInstance`, `PauliOp, ``MatrixOp`, `PauliSumOp`, and `SummedOp` types are allowed.
+* **state\_preparation** ([*StateFn*](qiskit.opflow.state_fns.StateFn "qiskit.opflow.state_fns.StateFn") *|*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *|*[*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") *| None*) – The `StateFn` to be prepared, whose eigenphase will be measured. If this parameter is omitted, no preparation circuit will be run and input state will be the all-zero state in the computational basis.
+* **evolution** ([*EvolutionSynthesis*](qiskit.synthesis.EvolutionSynthesis "qiskit.synthesis.EvolutionSynthesis") *|*[*EvolutionBase*](qiskit.opflow.evolutions.EvolutionBase "qiskit.opflow.evolutions.EvolutionBase") *| None*) – An evolution converter that generates a unitary from `hamiltonian`. If `None`, then the default `PauliTrotterEvolution` is used.
+* **bound** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – An upper bound on the absolute value of the eigenvalues of `hamiltonian`. If omitted, then `hamiltonian` must be a Pauli sum, or a `PauliOp`, in which case a bound will be computed. If `hamiltonian` is a `MatrixOp`, then `bound` may not be `None`. The tighter the bound, the higher the resolution of computed phases.
+
+**Returns**
+
+`HamiltonianPhaseEstimationResult` instance containing the result of the estimation and diagnostic information.
+
+**Raises**
+
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – If `evolution` is not of type `EvolutionSynthesis` when a `Sampler` is provided.
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – If `hamiltonian` type is not `Pauli` or `SparsePauliOp` or `PauliSumOp` when a `Sampler` is provided.
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `bound` is `None` and `hamiltonian` is not a Pauli sum, i.e. a `PauliSumOp` or a `SummedOp` whose terms are of type `PauliOp`.
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – If `evolution` is not of type `EvolutionBase` when no `Sampler` is provided.
+
+**Return type**
+
+[HamiltonianPhaseEstimationResult](qiskit.algorithms.HamiltonianPhaseEstimationResult "qiskit.algorithms.HamiltonianPhaseEstimationResult")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.HamiltonianPhaseEstimationResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.HamiltonianPhaseEstimationResult.md
new file mode 100644
index 00000000000..5b81fe777f5
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.HamiltonianPhaseEstimationResult.md
@@ -0,0 +1,92 @@
+---
+title: HamiltonianPhaseEstimationResult
+description: API reference for qiskit.algorithms.HamiltonianPhaseEstimationResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.HamiltonianPhaseEstimationResult
+---
+
+# HamiltonianPhaseEstimationResult
+
+
+
+`qiskit.algorithms.HamiltonianPhaseEstimationResult(phase_estimation_result, phase_estimation_scale, id_coefficient)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/phase_estimators/hamiltonian_phase_estimation_result.py "view source code")
+
+Bases: `AlgorithmResult`
+
+Store and manipulate results from running HamiltonianPhaseEstimation.
+
+This API of this class is nearly the same as PhaseEstimatorResult, differing only in the presence of an additional keyword argument in the methods. If scaled is False, then the phases are not translated and scaled to recover the eigenvalues of the Hamiltonian. Instead phi in $[0, 1)$ is returned, as is the case when then unitary is not derived from a Hamiltonian.
+
+This class is meant to be instantiated via HamiltonianPhaseEstimation.estimate.
+
+**Parameters**
+
+* **phase\_estimation\_result** ([*PhaseEstimationResult*](qiskit.algorithms.PhaseEstimationResult "qiskit.algorithms.PhaseEstimationResult")) – The result object returned by PhaseEstimation.estimate.
+* **phase\_estimation\_scale** ([*PhaseEstimationScale*](qiskit.algorithms.PhaseEstimationScale "qiskit.algorithms.PhaseEstimationScale")) – object used to scale phases to obtain eigenvalues.
+* **id\_coefficient** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The coefficient of the identity term in the Hamiltonian. Eigenvalues are computed without this term so that the coefficient must added to give correct eigenvalues. This is done automatically when retrieving eigenvalues.
+
+## Attributes
+
+
+
+### most\_likely\_eigenvalue
+
+The most likely eigenvalue of the Hamiltonian.
+
+This method calls most\_likely\_phase and scales the result to obtain an eigenvalue.
+
+**Returns**
+
+The most likely eigenvalue of the Hamiltonian.
+
+
+
+### phase
+
+The most likely phase of the unitary corresponding to the Hamiltonian.
+
+**Returns**
+
+The most likely phase.
+
+## Methods
+
+### combine
+
+
+
+`combine(result)`
+
+Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Argument is None
+
+### filter\_phases
+
+
+
+`filter_phases(cutoff=0.0, scaled=True, as_float=True)`
+
+Filter phases as does PhaseEstimatorResult.filter\_phases, with the addition that phi is shifted and translated to return eigenvalues of the Hamiltonian.
+
+**Parameters**
+
+* **cutoff** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Minimum weight of number of counts required to keep a bit string. The default value is 0.0.
+* **scaled** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If False, return phi in $[0, 1)$ rather than the eigenvalues of the Hamiltonian.
+* **as\_float** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, returned keys are floats in $[0.0, 1.0)$. If False returned keys are bit strings.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – if as\_float is False and scaled is True.
+
+**Returns**
+
+A dict of filtered phases.
+
+**Return type**
+
+Mapping\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") | [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)"), [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")]
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.ImaginaryEvolver.md b/docs/api/qiskit/0.46/qiskit.algorithms.ImaginaryEvolver.md
new file mode 100644
index 00000000000..27922a3abc0
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.ImaginaryEvolver.md
@@ -0,0 +1,48 @@
+---
+title: ImaginaryEvolver
+description: API reference for qiskit.algorithms.ImaginaryEvolver
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.ImaginaryEvolver
+---
+
+# ImaginaryEvolver
+
+
+
+`qiskit.algorithms.ImaginaryEvolver`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/evolvers/imaginary_evolver.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Deprecated: Interface for Quantum Imaginary Time Evolution.
+
+The ImaginaryEvolver interface has been superseded by the `qiskit.algorithms.time_evolvers.ImaginaryTimeEvolver` interface. This interface will be deprecated in a future release and subsequently removed after that.
+
+
+ The class `qiskit.algorithms.evolvers.imaginary_evolver.ImaginaryEvolver` is deprecated as of qiskit 0.24.0. It will be removed no earlier than 3 months after the release date. Instead, use the interface `qiskit.algorithms.time_evolvers.ImaginaryTimeEvolver`. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+## Methods
+
+### evolve
+
+
+
+`abstract evolve(evolution_problem)`
+
+Perform imaginary time evolution $\exp(-\tau H)|\Psi\rangle$.
+
+Evolves an initial state $|\Psi\rangle$ for an imaginary time $\tau$ under a Hamiltonian $H$, as provided in the `evolution_problem`.
+
+**Parameters**
+
+**evolution\_problem** ([*EvolutionProblem*](qiskit.algorithms.EvolutionProblem "qiskit.algorithms.evolvers.evolution_problem.EvolutionProblem")) – The definition of the evolution problem.
+
+**Returns**
+
+Evolution result which includes an evolved quantum state.
+
+**Return type**
+
+[*EvolutionResult*](qiskit.algorithms.EvolutionResult "qiskit.algorithms.evolvers.evolution_result.EvolutionResult")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.ImaginaryTimeEvolver.md b/docs/api/qiskit/0.46/qiskit.algorithms.ImaginaryTimeEvolver.md
new file mode 100644
index 00000000000..d69a3a74c68
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.ImaginaryTimeEvolver.md
@@ -0,0 +1,42 @@
+---
+title: ImaginaryTimeEvolver
+description: API reference for qiskit.algorithms.ImaginaryTimeEvolver
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.ImaginaryTimeEvolver
+---
+
+# ImaginaryTimeEvolver
+
+
+
+`qiskit.algorithms.ImaginaryTimeEvolver`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/time_evolvers/imaginary_time_evolver.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Interface for Quantum Imaginary Time Evolution.
+
+## Methods
+
+### evolve
+
+
+
+`abstract evolve(evolution_problem)`
+
+Perform imaginary time evolution $\exp(-\tau H)|\Psi\rangle$.
+
+Evolves an initial state $|\Psi\rangle$ for an imaginary time $\tau$ under a Hamiltonian $H$, as provided in the `evolution_problem`.
+
+**Parameters**
+
+**evolution\_problem** ([*TimeEvolutionProblem*](qiskit.algorithms.TimeEvolutionProblem "qiskit.algorithms.time_evolvers.time_evolution_problem.TimeEvolutionProblem")) – The definition of the evolution problem.
+
+**Returns**
+
+Evolution result which includes an evolved quantum state.
+
+**Return type**
+
+[*TimeEvolutionResult*](qiskit.algorithms.TimeEvolutionResult "qiskit.algorithms.time_evolvers.time_evolution_result.TimeEvolutionResult")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.IterativeAmplitudeEstimation.md b/docs/api/qiskit/0.46/qiskit.algorithms.IterativeAmplitudeEstimation.md
new file mode 100644
index 00000000000..6469f0cf473
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.IterativeAmplitudeEstimation.md
@@ -0,0 +1,141 @@
+---
+title: IterativeAmplitudeEstimation
+description: API reference for qiskit.algorithms.IterativeAmplitudeEstimation
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.IterativeAmplitudeEstimation
+---
+
+# IterativeAmplitudeEstimation
+
+
+
+`qiskit.algorithms.IterativeAmplitudeEstimation(epsilon_target, alpha, confint_method='beta', min_ratio=2, quantum_instance=None, sampler=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/amplitude_estimators/iae.py "view source code")
+
+Bases: [`AmplitudeEstimator`](qiskit.algorithms.AmplitudeEstimator "qiskit.algorithms.amplitude_estimators.amplitude_estimator.AmplitudeEstimator")
+
+The Iterative Amplitude Estimation algorithm.
+
+This class implements the Iterative Quantum Amplitude Estimation (IQAE) algorithm, proposed in \[1]. The output of the algorithm is an estimate that, with at least probability $1 - \alpha$, differs by epsilon to the target value, where both alpha and epsilon can be specified.
+
+It differs from the original QAE algorithm proposed by Brassard \[2] in that it does not rely on Quantum Phase Estimation, but is only based on Grover’s algorithm. IQAE iteratively applies carefully selected Grover iterations to find an estimate for the target amplitude.
+
+**References**
+
+**\[1]: Grinko, D., Gacon, J., Zoufal, C., & Woerner, S. (2019).**
+
+Iterative Quantum Amplitude Estimation. [arXiv:1912.05559](https://arxiv.org/abs/1912.05559).
+
+**\[2]: Brassard, G., Hoyer, P., Mosca, M., & Tapp, A. (2000).**
+
+Quantum Amplitude Amplification and Estimation. [arXiv:quant-ph/0005055](http://arxiv.org/abs/quant-ph/0005055).
+
+The output of the algorithm is an estimate for the amplitude a, that with at least probability 1 - alpha has an error of epsilon. The number of A operator calls scales linearly in 1/epsilon (up to a logarithmic factor).
+
+
+ `qiskit.algorithms.amplitude_estimators.iae.IterativeAmplitudeEstimation.__init__()`’s argument `quantum_instance` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. Instead, use the `sampler` argument. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+**Parameters**
+
+* **epsilon\_target** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Target precision for estimation target a, has values between 0 and 0.5
+* **alpha** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Confidence level, the target probability is 1 - alpha, has values between 0 and 1
+* **confint\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Statistical method used to estimate the confidence intervals in each iteration, can be ‘chernoff’ for the Chernoff intervals or ‘beta’ for the Clopper-Pearson intervals (default)
+* **min\_ratio** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Minimal q-ratio ($K_{i+1} / K_i$) for FindNextK
+* **quantum\_instance** ([*QuantumInstance*](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance") *|*[*Backend*](qiskit.providers.Backend "qiskit.providers.Backend") *| None*) – Deprecated: Quantum Instance or Backend
+* **sampler** ([*BaseSampler*](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler") *| None*) – A sampler primitive to evaluate the circuits.
+
+**Raises**
+
+* [**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – if the method to compute the confidence intervals is not supported
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If the target epsilon is not in (0, 0.5]
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If alpha is not in (0, 1)
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If confint\_method is not supported
+
+## Attributes
+
+
+
+### epsilon\_target
+
+Returns the target precision `epsilon_target` of the algorithm.
+
+**Returns**
+
+The target precision (which is half the width of the confidence interval).
+
+
+
+### quantum\_instance
+
+Deprecated. Get the quantum instance.
+
+
+ The property `qiskit.algorithms.amplitude_estimators.iae.IterativeAmplitudeEstimation.quantum_instance` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+**Returns**
+
+The quantum instance used to run this algorithm.
+
+
+
+### sampler
+
+Get the sampler primitive.
+
+**Returns**
+
+The sampler primitive to evaluate the circuits.
+
+## Methods
+
+### construct\_circuit
+
+
+
+`construct_circuit(estimation_problem, k=0, measurement=False)`
+
+Construct the circuit $\mathcal{Q}^k \mathcal{A} |0\rangle$.
+
+The A operator is the unitary specifying the QAE problem and Q the associated Grover operator.
+
+**Parameters**
+
+* **estimation\_problem** ([*EstimationProblem*](qiskit.algorithms.EstimationProblem "qiskit.algorithms.amplitude_estimators.estimation_problem.EstimationProblem")) – The estimation problem for which to construct the QAE circuit.
+* **k** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The power of the Q operator.
+* **measurement** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Boolean flag to indicate if measurements should be included in the circuits.
+
+**Returns**
+
+The circuit implementing $\mathcal{Q}^k \mathcal{A} |0\rangle$.
+
+**Return type**
+
+[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+### estimate
+
+
+
+`estimate(estimation_problem)`
+
+Run the amplitude estimation algorithm on provided estimation problem.
+
+**Parameters**
+
+**estimation\_problem** ([*EstimationProblem*](qiskit.algorithms.EstimationProblem "qiskit.algorithms.amplitude_estimators.estimation_problem.EstimationProblem")) – The estimation problem.
+
+**Returns**
+
+An amplitude estimation results object.
+
+**Raises**
+
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – A quantum instance or Sampler must be provided.
+* [**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – Sampler job run error.
+
+**Return type**
+
+[*IterativeAmplitudeEstimationResult*](qiskit.algorithms.IterativeAmplitudeEstimationResult "qiskit.algorithms.amplitude_estimators.iae.IterativeAmplitudeEstimationResult")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.IterativeAmplitudeEstimationResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.IterativeAmplitudeEstimationResult.md
new file mode 100644
index 00000000000..a15dbdf6a71
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.IterativeAmplitudeEstimationResult.md
@@ -0,0 +1,130 @@
+---
+title: IterativeAmplitudeEstimationResult
+description: API reference for qiskit.algorithms.IterativeAmplitudeEstimationResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.IterativeAmplitudeEstimationResult
+---
+
+# IterativeAmplitudeEstimationResult
+
+
+
+`qiskit.algorithms.IterativeAmplitudeEstimationResult`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/amplitude_estimators/iae.py "view source code")
+
+Bases: [`AmplitudeEstimatorResult`](qiskit.algorithms.AmplitudeEstimatorResult "qiskit.algorithms.amplitude_estimators.amplitude_estimator.AmplitudeEstimatorResult")
+
+The `IterativeAmplitudeEstimation` result object.
+
+## Attributes
+
+
+
+### alpha
+
+Return the confidence level $\alpha$.
+
+
+
+### circuit\_results
+
+Return the circuit results. Can be a statevector or counts dictionary.
+
+
+
+### confidence\_interval
+
+Return the confidence interval for the amplitude (95% interval by default).
+
+
+
+### confidence\_interval\_processed
+
+Return the post-processed confidence interval.
+
+
+
+### epsilon\_estimated
+
+Return the estimated half-width of the confidence interval.
+
+
+
+### epsilon\_estimated\_processed
+
+Return the post-processed estimated half-width of the confidence interval.
+
+
+
+### epsilon\_target
+
+Return the target half-width of the confidence interval.
+
+
+
+### estimate\_intervals
+
+Return the confidence intervals for the estimate in each iteration.
+
+
+
+### estimation
+
+Return the estimation for the amplitude in $[0, 1]$.
+
+
+
+### estimation\_processed
+
+Return the estimation for the amplitude after the post-processing has been applied.
+
+
+
+### num\_oracle\_queries
+
+Return the number of Grover oracle queries.
+
+
+
+### post\_processing
+
+Return a handle to the post processing function.
+
+
+
+### powers
+
+Return the powers of the Grover operator in each iteration.
+
+
+
+### ratios
+
+Return the ratios $K_{i+1}/K_{i}$ for each iteration $i$.
+
+
+
+### shots
+
+Return the number of shots used. Is 1 for statevector-based simulations.
+
+
+
+### theta\_intervals
+
+Return the confidence intervals for the angles in each iteration.
+
+## Methods
+
+### combine
+
+
+
+`combine(result)`
+
+Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Argument is None
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.IterativePhaseEstimation.md b/docs/api/qiskit/0.46/qiskit.algorithms.IterativePhaseEstimation.md
new file mode 100644
index 00000000000..3095e76d3f6
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.IterativePhaseEstimation.md
@@ -0,0 +1,92 @@
+---
+title: IterativePhaseEstimation
+description: API reference for qiskit.algorithms.IterativePhaseEstimation
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.IterativePhaseEstimation
+---
+
+# IterativePhaseEstimation
+
+
+
+`qiskit.algorithms.IterativePhaseEstimation(num_iterations, quantum_instance=None, sampler=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/phase_estimators/ipe.py "view source code")
+
+Bases: `PhaseEstimator`
+
+Run the Iterative quantum phase estimation (QPE) algorithm.
+
+Given a unitary circuit and a circuit preparing an eigenstate, return the phase of the eigenvalue as a number in $[0,1)$ using the iterative phase estimation algorithm.
+
+**\[1]: Dobsicek et al. (2006), Arbitrary accuracy iterative phase estimation algorithm as a two**
+
+qubit benchmark, [arxiv/quant-ph/0610214](https://arxiv.org/abs/quant-ph/0610214)
+
+
+ `qiskit.algorithms.phase_estimators.ipe.IterativePhaseEstimation.__init__()`’s argument `quantum_instance` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. Instead, use the `sampler` argument. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+**Parameters**
+
+* **num\_iterations** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of iterations (rounds) of the phase estimation to run.
+* **quantum\_instance** ([*QuantumInstance*](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance") *|*[*Backend*](qiskit.providers.Backend "qiskit.providers.Backend") *| None*) – Deprecated: The quantum instance on which the circuit will be run.
+* **sampler** ([*BaseSampler*](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler") *| None*) – The sampler primitive on which the circuit will be sampled.
+
+**Raises**
+
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – if num\_iterations is not greater than zero.
+* [**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – If neither sampler nor quantum instance is provided.
+
+## Methods
+
+### construct\_circuit
+
+
+
+`construct_circuit(unitary, state_preparation, k, omega=0.0, measurement=False)`
+
+Construct the kth iteration Quantum Phase Estimation circuit.
+
+For details of parameters, see Fig. 2 in [https://arxiv.org/pdf/quant-ph/0610214.pdf](https://arxiv.org/pdf/quant-ph/0610214.pdf).
+
+**Parameters**
+
+* **unitary** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")) – The circuit representing the unitary operator whose eigenvalue (via phase) will be measured.
+* **state\_preparation** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")) – The circuit that prepares the state whose eigenphase will be measured. If this parameter is omitted, no preparation circuit will be run and input state will be the all-zero state in the computational basis.
+* **k** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the iteration idx.
+* **omega** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the feedback angle.
+* **measurement** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Boolean flag to indicate if measurement should be included in the circuit.
+
+**Returns**
+
+the quantum circuit per iteration
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### estimate
+
+
+
+`estimate(unitary, state_preparation)`
+
+Estimate the eigenphase of the input unitary and initial-state pair.
+
+**Parameters**
+
+* **unitary** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")) – The circuit representing the unitary operator whose eigenvalue (via phase) will be measured.
+* **state\_preparation** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")) – The circuit that prepares the state whose eigenphase will be measured. If this parameter is omitted, no preparation circuit will be run and input state will be the all-zero state in the computational basis.
+
+**Returns**
+
+Estimated phase in an IterativePhaseEstimationResult object.
+
+**Raises**
+
+[**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – If neither sampler nor quantum instance is provided.
+
+**Return type**
+
+*IterativePhaseEstimationResult*
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.MaximumLikelihoodAmplitudeEstimation.md b/docs/api/qiskit/0.46/qiskit.algorithms.MaximumLikelihoodAmplitudeEstimation.md
new file mode 100644
index 00000000000..a3678f12946
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.MaximumLikelihoodAmplitudeEstimation.md
@@ -0,0 +1,175 @@
+---
+title: MaximumLikelihoodAmplitudeEstimation
+description: API reference for qiskit.algorithms.MaximumLikelihoodAmplitudeEstimation
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.MaximumLikelihoodAmplitudeEstimation
+---
+
+# MaximumLikelihoodAmplitudeEstimation
+
+
+
+`qiskit.algorithms.MaximumLikelihoodAmplitudeEstimation(evaluation_schedule, minimizer=None, quantum_instance=None, sampler=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/amplitude_estimators/mlae.py "view source code")
+
+Bases: [`AmplitudeEstimator`](qiskit.algorithms.AmplitudeEstimator "qiskit.algorithms.amplitude_estimators.amplitude_estimator.AmplitudeEstimator")
+
+The Maximum Likelihood Amplitude Estimation algorithm.
+
+This class implements the quantum amplitude estimation (QAE) algorithm without phase estimation, as introduced in \[1]. In comparison to the original QAE algorithm \[2], this implementation relies solely on different powers of the Grover operator and does not require additional evaluation qubits. Finally, the estimate is determined via a maximum likelihood estimation, which is why this class in named `MaximumLikelihoodAmplitudeEstimation`.
+
+**References**
+
+**\[1]: Suzuki, Y., Uno, S., Raymond, R., Tanaka, T., Onodera, T., & Yamamoto, N. (2019).**
+
+Amplitude Estimation without Phase Estimation. [arXiv:1904.10246](https://arxiv.org/abs/1904.10246).
+
+**\[2]: Brassard, G., Hoyer, P., Mosca, M., & Tapp, A. (2000).**
+
+Quantum Amplitude Amplification and Estimation. [arXiv:quant-ph/0005055](http://arxiv.org/abs/quant-ph/0005055).
+
+
+ `qiskit.algorithms.amplitude_estimators.mlae.MaximumLikelihoodAmplitudeEstimation.__init__()`’s argument `quantum_instance` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. Instead, use the `sampler` argument. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+**Parameters**
+
+* **evaluation\_schedule** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] |* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – If a list, the powers applied to the Grover operator. The list element must be non-negative. If a non-negative integer, an exponential schedule is used where the highest power is 2 to the integer minus 1: \[id, Q^2^0, …, Q^2^(evaluation\_schedule-1)].
+* **minimizer** (*MINIMIZER | None*) – A minimizer used to find the minimum of the likelihood function. Defaults to a brute search where the number of evaluation points is determined according to `evaluation_schedule`. The minimizer takes a function as first argument and a list of (float, float) tuples (as bounds) as second argument and returns a single float which is the found minimum.
+* **quantum\_instance** ([*QuantumInstance*](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance") *|*[*Backend*](qiskit.providers.Backend "qiskit.providers.Backend") *| None*) – Deprecated: Quantum Instance or Backend
+* **sampler** ([*BaseSampler*](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler") *| None*) – A sampler primitive to evaluate the circuits.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If the number of oracle circuits is smaller than 1.
+
+## Attributes
+
+
+
+### quantum\_instance
+
+Deprecated. Get the quantum instance.
+
+
+ The property `qiskit.algorithms.amplitude_estimators.mlae.MaximumLikelihoodAmplitudeEstimation.quantum_instance` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+**Returns**
+
+The quantum instance used to run this algorithm.
+
+
+
+### sampler
+
+Get the sampler primitive.
+
+**Returns**
+
+The sampler primitive to evaluate the circuits.
+
+## Methods
+
+### compute\_confidence\_interval
+
+
+
+`static compute_confidence_interval(result, alpha, kind='fisher', apply_post_processing=False)`
+
+Compute the alpha confidence interval using the method kind.
+
+The confidence level is (1 - alpha) and supported kinds are ‘fisher’, ‘likelihood\_ratio’ and ‘observed\_fisher’ with shorthand notations ‘fi’, ‘lr’ and ‘oi’, respectively.
+
+**Parameters**
+
+* **result** ([*MaximumLikelihoodAmplitudeEstimationResult*](qiskit.algorithms.MaximumLikelihoodAmplitudeEstimationResult "qiskit.algorithms.amplitude_estimators.mlae.MaximumLikelihoodAmplitudeEstimationResult")) – A maximum likelihood amplitude estimation result.
+* **alpha** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The confidence level.
+* **kind** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The method to compute the confidence interval. Defaults to ‘fisher’, which computes the theoretical Fisher information.
+* **apply\_post\_processing** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, apply post-processing to the confidence interval.
+
+**Returns**
+
+The specified confidence interval.
+
+**Raises**
+
+* [**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – If run() hasn’t been called yet.
+* [**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – If the method kind is not supported.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)"), [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")]
+
+### compute\_mle
+
+
+
+`compute_mle(circuit_results, estimation_problem, num_state_qubits=None, return_counts=False)`
+
+Compute the MLE via a grid-search.
+
+This is a stable approach if sufficient gridpoints are used.
+
+**Parameters**
+
+* **circuit\_results** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | np.ndarray]*) – A list of circuit outcomes. Can be counts or statevectors.
+* **estimation\_problem** ([*EstimationProblem*](qiskit.algorithms.EstimationProblem "qiskit.algorithms.EstimationProblem")) – The estimation problem containing the evaluation schedule and the number of likelihood function evaluations used to find the minimum.
+* **num\_state\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of state qubits, required for statevector simulations.
+* **return\_counts** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, returns the good counts.
+
+**Returns**
+
+The MLE for the provided result object.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") | [tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)"), [list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")]]
+
+### construct\_circuits
+
+
+
+`construct_circuits(estimation_problem, measurement=False)`
+
+Construct the Amplitude Estimation w/o QPE quantum circuits.
+
+**Parameters**
+
+* **estimation\_problem** ([*EstimationProblem*](qiskit.algorithms.EstimationProblem "qiskit.algorithms.amplitude_estimators.estimation_problem.EstimationProblem")) – The estimation problem for which to construct the QAE circuit.
+* **measurement** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Boolean flag to indicate if measurement should be included in the circuits.
+
+**Returns**
+
+A list with the QuantumCircuit objects for the algorithm.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[qiskit.circuit.quantumcircuit.QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")]
+
+### estimate
+
+
+
+`estimate(estimation_problem)`
+
+Run the amplitude estimation algorithm on provided estimation problem.
+
+**Parameters**
+
+**estimation\_problem** ([*EstimationProblem*](qiskit.algorithms.EstimationProblem "qiskit.algorithms.amplitude_estimators.estimation_problem.EstimationProblem")) – The estimation problem.
+
+**Returns**
+
+An amplitude estimation results object.
+
+**Raises**
+
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – A quantum instance or Sampler must be provided.
+* [**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – If state\_preparation is not set in estimation\_problem.
+* [**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – Sampler job run error
+
+**Return type**
+
+[*MaximumLikelihoodAmplitudeEstimationResult*](qiskit.algorithms.MaximumLikelihoodAmplitudeEstimationResult "qiskit.algorithms.amplitude_estimators.mlae.MaximumLikelihoodAmplitudeEstimationResult")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.MaximumLikelihoodAmplitudeEstimationResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.MaximumLikelihoodAmplitudeEstimationResult.md
new file mode 100644
index 00000000000..88a16515f26
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.MaximumLikelihoodAmplitudeEstimationResult.md
@@ -0,0 +1,112 @@
+---
+title: MaximumLikelihoodAmplitudeEstimationResult
+description: API reference for qiskit.algorithms.MaximumLikelihoodAmplitudeEstimationResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.MaximumLikelihoodAmplitudeEstimationResult
+---
+
+# MaximumLikelihoodAmplitudeEstimationResult
+
+
+
+`qiskit.algorithms.MaximumLikelihoodAmplitudeEstimationResult`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/amplitude_estimators/mlae.py "view source code")
+
+Bases: [`AmplitudeEstimatorResult`](qiskit.algorithms.AmplitudeEstimatorResult "qiskit.algorithms.amplitude_estimators.amplitude_estimator.AmplitudeEstimatorResult")
+
+The `MaximumLikelihoodAmplitudeEstimation` result object.
+
+## Attributes
+
+
+
+### circuit\_results
+
+Return the circuit results. Can be a statevector or counts dictionary.
+
+
+
+### confidence\_interval
+
+Return the confidence interval for the amplitude (95% interval by default).
+
+
+
+### confidence\_interval\_processed
+
+Return the post-processed confidence interval (95% interval by default).
+
+
+
+### estimation
+
+Return the estimation for the amplitude in $[0, 1]$.
+
+
+
+### estimation\_processed
+
+Return the estimation for the amplitude after the post-processing has been applied.
+
+
+
+### evaluation\_schedule
+
+Return the evaluation schedule for the powers of the Grover operator.
+
+
+
+### fisher\_information
+
+Return the Fisher information for the estimated amplitude.
+
+
+
+### good\_counts
+
+Return the percentage of good counts per circuit power.
+
+
+
+### minimizer
+
+Return the minimizer used for the search of the likelihood function.
+
+
+
+### num\_oracle\_queries
+
+Return the number of Grover oracle queries.
+
+
+
+### post\_processing
+
+Return a handle to the post processing function.
+
+
+
+### shots
+
+Return the number of shots used. Is 1 for statevector-based simulations.
+
+
+
+### theta
+
+Return the estimate for the angle $\theta$.
+
+## Methods
+
+### combine
+
+
+
+`combine(result)`
+
+Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Argument is None
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.MinimumEigensolver.md b/docs/api/qiskit/0.46/qiskit.algorithms.MinimumEigensolver.md
new file mode 100644
index 00000000000..9dd4b03ecfd
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.MinimumEigensolver.md
@@ -0,0 +1,67 @@
+---
+title: MinimumEigensolver
+description: API reference for qiskit.algorithms.MinimumEigensolver
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.MinimumEigensolver
+---
+
+# MinimumEigensolver
+
+
+
+`qiskit.algorithms.MinimumEigensolver`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/minimum_eigen_solvers/minimum_eigen_solver.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Deprecated: Minimum Eigensolver Interface.
+
+The Minimum Eigensolver interface has been superseded by the [`qiskit.algorithms.minimum_eigensolvers.MinimumEigensolver`](qiskit.algorithms.minimum_eigensolvers.MinimumEigensolver "qiskit.algorithms.minimum_eigensolvers.MinimumEigensolver") interface. This interface will be deprecated in a future release and subsequently removed after that.
+
+Algorithms that can compute a minimum eigenvalue for an operator may implement this interface to allow different algorithms to be used interchangeably.
+
+
+ The class `qiskit.algorithms.minimum_eigen_solvers.minimum_eigen_solver.MinimumEigensolver` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. Instead, use the interface `qiskit.algorithms.minimum_eigensolvers.MinimumEigensolver`. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+## Methods
+
+### compute\_minimum\_eigenvalue
+
+
+
+`abstract compute_minimum_eigenvalue(operator, aux_operators=None)`
+
+Computes minimum eigenvalue. Operator and aux\_operators can be supplied here and if not None will override any already set into algorithm so it can be reused with different operators. While an operator is required by algorithms, aux\_operators are optional. To ‘remove’ a previous aux\_operators array use an empty list here.
+
+**Parameters**
+
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")) – Qubit operator of the Observable
+* **aux\_operators** (*ListOrDict\[*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")*] | None*) – Optional list of auxiliary operators to be evaluated with the eigenstate of the minimum eigenvalue main result and their expectation values returned. For instance in chemistry these can be dipole operators, total particle count operators so we can get values for these at the ground state.
+
+**Returns**
+
+MinimumEigensolverResult
+
+**Return type**
+
+[MinimumEigensolverResult](qiskit.algorithms.MinimumEigensolverResult "qiskit.algorithms.MinimumEigensolverResult")
+
+### supports\_aux\_operators
+
+
+
+`classmethod supports_aux_operators()`
+
+Whether computing the expectation value of auxiliary operators is supported.
+
+If the minimum eigensolver computes an eigenstate of the main operator then it can compute the expectation value of the aux\_operators for that state. Otherwise they will be ignored.
+
+**Returns**
+
+True if aux\_operator expectations can be evaluated, False otherwise
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.MinimumEigensolverResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.MinimumEigensolverResult.md
new file mode 100644
index 00000000000..361249940ab
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.MinimumEigensolverResult.md
@@ -0,0 +1,60 @@
+---
+title: MinimumEigensolverResult
+description: API reference for qiskit.algorithms.MinimumEigensolverResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.MinimumEigensolverResult
+---
+
+# MinimumEigensolverResult
+
+
+
+`qiskit.algorithms.MinimumEigensolverResult`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/minimum_eigen_solvers/minimum_eigen_solver.py "view source code")
+
+Bases: `AlgorithmResult`
+
+Deprecated: Minimum Eigensolver Result.
+
+The MinimumEigensolverResult class has been superseded by the [`qiskit.algorithms.minimum_eigensolvers.MinimumEigensolverResult`](qiskit.algorithms.minimum_eigensolvers.MinimumEigensolverResult "qiskit.algorithms.minimum_eigensolvers.MinimumEigensolverResult") class. This class will be deprecated in a future release and subsequently removed after that.
+
+
+ The class `qiskit.algorithms.minimum_eigen_solvers.minimum_eigen_solver.MinimumEigensolverResult` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. Instead, use the class `qiskit.algorithms.minimum_eigensolvers.MinimumEigensolverResult`. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+## Attributes
+
+
+
+### aux\_operator\_eigenvalues
+
+Return aux operator expectation values.
+
+These values are in fact tuples formatted as (mean, standard deviation).
+
+
+
+### eigenstate
+
+return eigen state
+
+
+
+### eigenvalue
+
+returns eigen value
+
+## Methods
+
+### combine
+
+
+
+`combine(result)`
+
+Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Argument is None
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.NumPyEigensolver.md b/docs/api/qiskit/0.46/qiskit.algorithms.NumPyEigensolver.md
new file mode 100644
index 00000000000..10eac4810ba
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.NumPyEigensolver.md
@@ -0,0 +1,88 @@
+---
+title: NumPyEigensolver
+description: API reference for qiskit.algorithms.NumPyEigensolver
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.NumPyEigensolver
+---
+
+# NumPyEigensolver
+
+
+
+`qiskit.algorithms.NumPyEigensolver(k=1, filter_criterion=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/eigen_solvers/numpy_eigen_solver.py "view source code")
+
+Bases: [`Eigensolver`](qiskit.algorithms.Eigensolver "qiskit.algorithms.eigen_solvers.eigen_solver.Eigensolver")
+
+Deprecated: NumPy Eigensolver algorithm.
+
+The NumPyEigensolver class has been superseded by the [`qiskit.algorithms.eigensolvers.NumPyEigensolver`](qiskit.algorithms.eigensolvers.NumPyEigensolver "qiskit.algorithms.eigensolvers.NumPyEigensolver") class. This class will be deprecated in a future release and subsequently removed after that.
+
+NumPy Eigensolver computes up to the first $k$ eigenvalues of a complex-valued square matrix of dimension $n \times n$, with $k \leq n$.
+
+
+ Operators are automatically converted to SciPy’s `spmatrix` as needed and this conversion can be costly in terms of memory and performance as the operator size, mostly in terms of number of qubits it represents, gets larger.
+
+
+
+ The class `qiskit.algorithms.eigen_solvers.numpy_eigen_solver.NumPyEigensolver` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. Instead, use the class `qiskit.algorithms.eigensolvers.NumPyEigensolver`. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+**Parameters**
+
+* **k** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – How many eigenvalues are to be computed, has a min. value of 1.
+* **filter\_criterion** (*Callable\[\[*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *| np.ndarray,*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*, ListOrDict\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None],* [*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")*]*) – callable that allows to filter eigenvalues/eigenstates, only feasible eigenstates are returned in the results. The callable has the signature filter(eigenstate, eigenvalue, aux\_values) and must return a boolean to indicate whether to keep this value in the final returned result or not. If the number of elements that satisfies the criterion is smaller than k then the returned list has fewer elements and can even be empty.
+
+## Attributes
+
+
+
+### filter\_criterion
+
+returns the filter criterion if set
+
+
+
+### k
+
+returns k (number of eigenvalues requested)
+
+## Methods
+
+### compute\_eigenvalues
+
+
+
+`compute_eigenvalues(operator, aux_operators=None)`
+
+Computes eigenvalues. Operator and aux\_operators can be supplied here and if not None will override any already set into algorithm so it can be reused with different operators. While an operator is required by algorithms, aux\_operators are optional. To ‘remove’ a previous aux\_operators array use an empty list here.
+
+**Parameters**
+
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")) – Qubit operator of the Observable
+* **aux\_operators** (*ListOrDict\[*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")*] | None*) – Optional list of auxiliary operators to be evaluated with the eigenstate of the minimum eigenvalue main result and their expectation values returned. For instance in chemistry these can be dipole operators, total particle count operators so we can get values for these at the ground state.
+
+**Returns**
+
+EigensolverResult
+
+**Return type**
+
+[EigensolverResult](qiskit.algorithms.EigensolverResult "qiskit.algorithms.EigensolverResult")
+
+### supports\_aux\_operators
+
+
+
+`classmethod supports_aux_operators()`
+
+Whether computing the expectation value of auxiliary operators is supported.
+
+**Returns**
+
+True if aux\_operator expectations can be evaluated, False otherwise
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.NumPyMinimumEigensolver.md b/docs/api/qiskit/0.46/qiskit.algorithms.NumPyMinimumEigensolver.md
new file mode 100644
index 00000000000..8ebc24d2b58
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.NumPyMinimumEigensolver.md
@@ -0,0 +1,77 @@
+---
+title: NumPyMinimumEigensolver
+description: API reference for qiskit.algorithms.NumPyMinimumEigensolver
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.NumPyMinimumEigensolver
+---
+
+# NumPyMinimumEigensolver
+
+
+
+`qiskit.algorithms.NumPyMinimumEigensolver(filter_criterion=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/minimum_eigen_solvers/numpy_minimum_eigen_solver.py "view source code")
+
+Bases: [`MinimumEigensolver`](qiskit.algorithms.MinimumEigensolver "qiskit.algorithms.minimum_eigen_solvers.minimum_eigen_solver.MinimumEigensolver")
+
+Deprecated: Numpy Minimum Eigensolver algorithm.
+
+The NumPyMinimumEigensolver class has been superseded by the [`qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolver`](qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolver "qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolver") class. This class will be deprecated in a future release and subsequently removed after that.
+
+
+ The class `qiskit.algorithms.minimum_eigen_solvers.numpy_minimum_eigen_solver.NumPyMinimumEigensolver` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. Instead, use the class `qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolver`. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+**Parameters**
+
+**filter\_criterion** (*Callable\[\[*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *| np.ndarray,*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*, ListOrDict\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None],* [*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")*]*) – callable that allows to filter eigenvalues/eigenstates. The minimum eigensolver is only searching over feasible states and returns an eigenstate that has the smallest eigenvalue among feasible states. The callable has the signature filter(eigenstate, eigenvalue, aux\_values) and must return a boolean to indicate whether to consider this value or not. If there is no feasible element, the result can even be empty.
+
+## Attributes
+
+
+
+### filter\_criterion
+
+returns the filter criterion if set
+
+## Methods
+
+### compute\_minimum\_eigenvalue
+
+
+
+`compute_minimum_eigenvalue(operator, aux_operators=None)`
+
+Computes minimum eigenvalue. Operator and aux\_operators can be supplied here and if not None will override any already set into algorithm so it can be reused with different operators. While an operator is required by algorithms, aux\_operators are optional. To ‘remove’ a previous aux\_operators array use an empty list here.
+
+**Parameters**
+
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")) – Qubit operator of the Observable
+* **aux\_operators** (*ListOrDict\[*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")*] | None*) – Optional list of auxiliary operators to be evaluated with the eigenstate of the minimum eigenvalue main result and their expectation values returned. For instance in chemistry these can be dipole operators, total particle count operators so we can get values for these at the ground state.
+
+**Returns**
+
+MinimumEigensolverResult
+
+**Return type**
+
+[MinimumEigensolverResult](qiskit.algorithms.MinimumEigensolverResult "qiskit.algorithms.MinimumEigensolverResult")
+
+### supports\_aux\_operators
+
+
+
+`classmethod supports_aux_operators()`
+
+Whether computing the expectation value of auxiliary operators is supported.
+
+If the minimum eigensolver computes an eigenstate of the main operator then it can compute the expectation value of the aux\_operators for that state. Otherwise they will be ignored.
+
+**Returns**
+
+True if aux\_operator expectations can be evaluated, False otherwise
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.PVQD.md b/docs/api/qiskit/0.46/qiskit.algorithms.PVQD.md
new file mode 100644
index 00000000000..f6e2ec0719e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.PVQD.md
@@ -0,0 +1,232 @@
+---
+title: PVQD
+description: API reference for qiskit.algorithms.PVQD
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.PVQD
+---
+
+# PVQD
+
+
+
+`qiskit.algorithms.PVQD(fidelity, ansatz, initial_parameters, estimator=None, optimizer=None, num_timesteps=None, evolution=None, use_parameter_shift=True, initial_guess=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/time_evolvers/pvqd/pvqd.py "view source code")
+
+Bases: [`RealTimeEvolver`](qiskit.algorithms.RealTimeEvolver "qiskit.algorithms.time_evolvers.real_time_evolver.RealTimeEvolver")
+
+The projected Variational Quantum Dynamics (p-VQD) Algorithm.
+
+In each timestep, this algorithm computes the next state with a Trotter formula (specified by the `evolution` argument) and projects the timestep onto a variational form (`ansatz`). The projection is determined by maximizing the fidelity of the Trotter-evolved state and the ansatz, using a classical optimization routine. See Ref. \[1] for details.
+
+The following attributes can be set via the initializer but can also be read and updated once the PVQD object has been constructed.
+
+
+
+### ansatz
+
+The parameterized circuit representing the time-evolved state.
+
+**Type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+
+
+### initial\_parameters
+
+The parameters of the ansatz at time 0.
+
+**Type**
+
+np.ndarray
+
+
+
+### optimizer
+
+The classical optimization routine used to maximize the fidelity of the Trotter step and ansatz.
+
+**Type**
+
+Optional\[Union\[[Optimizer](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer"), [Minimizer](qiskit.algorithms.optimizers.Minimizer "qiskit.algorithms.optimizers.Minimizer")]]
+
+
+
+### num\_timesteps
+
+The number of timesteps to take. If None, it is automatically selected to achieve a timestep of approximately 0.01.
+
+**Type**
+
+Optional\[[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")]
+
+
+
+### evolution
+
+The method to perform the Trotter step. Defaults to first-order Lie-Trotter evolution.
+
+**Type**
+
+Optional\[[EvolutionSynthesis](qiskit.synthesis.EvolutionSynthesis "qiskit.synthesis.EvolutionSynthesis")]
+
+
+
+### use\_parameter\_shift
+
+If True, use the parameter shift rule for loss function gradients (if the ansatz supports).
+
+**Type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+
+
+### initial\_guess
+
+The starting point for the first classical optimization run, at time 0. Defaults to random values in $[-0.01, 0.01]$.
+
+**Type**
+
+Optional\[np.ndarray]
+
+**Example**
+
+This snippet computes the real time evolution of a quantum Ising model on two neighboring sites and keeps track of the magnetization.
+
+```python
+import numpy as np
+
+from qiskit.algorithms.state_fidelities import ComputeUncompute
+from qiskit.algorithms.time_evolvers import TimeEvolutionProblem, PVQD
+from qiskit.primitives import Estimator, Sampler
+from qiskit.circuit.library import EfficientSU2
+from qiskit.quantum_info import SparsePauliOp, Pauli
+from qiskit.algorithms.optimizers import L_BFGS_B
+
+sampler = Sampler()
+fidelity = ComputeUncompute(sampler)
+estimator = Estimator()
+hamiltonian = 0.1 * SparsePauliOp(["ZZ", "IX", "XI"])
+observable = Pauli("ZZ")
+ansatz = EfficientSU2(2, reps=1)
+initial_parameters = np.zeros(ansatz.num_parameters)
+
+time = 1
+optimizer = L_BFGS_B()
+
+# setup the algorithm
+pvqd = PVQD(
+ fidelity,
+ ansatz,
+ initial_parameters,
+ estimator,
+ num_timesteps=100,
+ optimizer=optimizer,
+)
+
+# specify the evolution problem
+problem = TimeEvolutionProblem(
+ hamiltonian, time, aux_operators=[hamiltonian, observable]
+)
+
+# and evolve!
+result = pvqd.evolve(problem)
+```
+
+**References**
+
+**\[1] Stefano Barison, Filippo Vicentini, and Giuseppe Carleo (2021), An efficient**
+
+quantum algorithm for the time evolution of parameterized circuits, [Quantum 5, 512](https://quantum-journal.org/papers/q-2021-07-28-512/).
+
+**Parameters**
+
+* **fidelity** ([*BaseStateFidelity*](qiskit.algorithms.state_fidelities.BaseStateFidelity "qiskit.algorithms.state_fidelities.BaseStateFidelity")) – A fidelity primitive used by the algorithm.
+* **ansatz** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – A parameterized circuit preparing the variational ansatz to model the time evolved quantum state.
+* **initial\_parameters** (*np.ndarray*) – The initial parameters for the ansatz. Together with the ansatz, these define the initial state of the time evolution.
+* **estimator** ([*BaseEstimator*](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator") *| None*) – An estimator primitive used for calculating expected values of auxiliary operators (if provided via the problem).
+* **optimizer** ([*Optimizer*](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer") *|*[*Minimizer*](qiskit.algorithms.optimizers.Minimizer "qiskit.algorithms.optimizers.Minimizer") *| None*) – The classical optimizers used to minimize the overlap between Trotterization and ansatz. Can be either a [`Optimizer`](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer") or a callable using the [`Minimizer`](qiskit.algorithms.optimizers.Minimizer "qiskit.algorithms.optimizers.Minimizer") protocol. This argument is optional since it is not required for [`get_loss()`](#qiskit.algorithms.PVQD.get_loss "qiskit.algorithms.PVQD.get_loss"), but it has to be set before [`evolve()`](#qiskit.algorithms.PVQD.evolve "qiskit.algorithms.PVQD.evolve") is called.
+* **num\_timesteps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of time steps. If `None` it will be set such that the timestep is close to 0.01.
+* **evolution** ([*EvolutionSynthesis*](qiskit.synthesis.EvolutionSynthesis "qiskit.synthesis.EvolutionSynthesis") *| None*) – The evolution synthesis to use for the construction of the Trotter step. Defaults to first-order Lie-Trotter decomposition, see also `evolution` for different options.
+* **use\_parameter\_shift** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, use the parameter shift rule to compute gradients. If False, the optimizer will not be passed a gradient callable. In that case, Qiskit optimizers will use a finite difference rule to approximate the gradients.
+* **initial\_guess** (*np.ndarray | None*) – The initial guess for the first VQE optimization. Afterwards the previous iteration result is used as initial guess. If None, this is set to a random vector with elements in the interval $[-0.01, 0.01]$.
+
+## Methods
+
+### evolve
+
+
+
+`evolve(evolution_problem)`
+
+Perform real time evolution $\exp(-i t H)|\Psi\rangle$.
+
+Evolves an initial state $|\Psi\rangle$ for a time $t$ under a Hamiltonian $H$, as provided in the `evolution_problem`.
+
+**Parameters**
+
+**evolution\_problem** ([*TimeEvolutionProblem*](qiskit.algorithms.TimeEvolutionProblem "qiskit.algorithms.time_evolvers.time_evolution_problem.TimeEvolutionProblem")) – The evolution problem containing the hamiltonian, total evolution time and observables to evaluate.
+
+**Returns**
+
+A result object containing the evolution information and evaluated observables.
+
+**Raises**
+
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `aux_operators` provided in the time evolution problem but no estimator provided to the algorithm.
+* [**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – If the evolution problem contains an initial state.
+
+**Return type**
+
+[*TimeEvolutionResult*](qiskit.algorithms.TimeEvolutionResult "qiskit.algorithms.time_evolvers.time_evolution_result.TimeEvolutionResult")
+
+### get\_loss
+
+
+
+`get_loss(hamiltonian, ansatz, dt, current_parameters)`
+
+Get a function to evaluate the infidelity between Trotter step and ansatz.
+
+**Parameters**
+
+* **hamiltonian** (*BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")) – The Hamiltonian under which to evolve.
+* **ansatz** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – The parameterized quantum circuit which attempts to approximate the time-evolved state.
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The time step.
+* **current\_parameters** (*np.ndarray*) – The current parameters.
+
+**Returns**
+
+**A callable to evaluate the infidelity and, if gradients are supported and required,**
+
+a second callable to evaluate the gradient of the infidelity.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[Callable\[\[np.ndarray], [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")], Callable\[\[np.ndarray], np.ndarray]] | None
+
+### step
+
+
+
+`step(hamiltonian, ansatz, theta, dt, initial_guess)`
+
+Perform a single time step.
+
+**Parameters**
+
+* **hamiltonian** (*BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")) – The Hamiltonian under which to evolve.
+* **ansatz** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – The parameterized quantum circuit which attempts to approximate the time-evolved state.
+* **theta** (*np.ndarray*) – The current parameters.
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The time step.
+* **initial\_guess** (*np.ndarray*) – The initial guess for the classical optimization of the fidelity between the next variational state and the Trotter-evolved last state. If None, this is set to a random vector with elements in the interval $[-0.01, 0.01]$.
+
+**Returns**
+
+A tuple consisting of the next parameters and the fidelity of the optimization.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[np.ndarray, [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")]
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.PVQDResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.PVQDResult.md
new file mode 100644
index 00000000000..4bae482a186
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.PVQDResult.md
@@ -0,0 +1,42 @@
+---
+title: PVQDResult
+description: API reference for qiskit.algorithms.PVQDResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.PVQDResult
+---
+
+# PVQDResult
+
+
+
+`qiskit.algorithms.PVQDResult(evolved_state, aux_ops_evaluated=None, times=None, parameters=None, fidelities=None, estimated_error=None, observables=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/time_evolvers/pvqd/pvqd_result.py "view source code")
+
+Bases: [`TimeEvolutionResult`](qiskit.algorithms.TimeEvolutionResult "qiskit.algorithms.time_evolvers.time_evolution_result.TimeEvolutionResult")
+
+The result object for the p-VQD algorithm.
+
+**Parameters**
+
+* **evolved\_state** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – An evolved quantum state.
+* **aux\_ops\_evaluated** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*,* [*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*]] | None*) – Optional list of observables for which expected values on an evolved state are calculated. These values are in fact tuples formatted as (mean, standard deviation).
+* **times** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – The times evaluated during the time integration.
+* **parameters** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[np.ndarray] | None*) – The parameter values at each evaluation time.
+* **fidelities** (*Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – The fidelity of the Trotter step and variational update at each iteration.
+* **estimated\_error** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The overall estimated error evaluated as one minus the product of all fidelities.
+* **observables** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – The value of the observables evaluated at each iteration.
+
+## Methods
+
+### combine
+
+
+
+`combine(result)`
+
+Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Argument is None
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.PhaseEstimation.md b/docs/api/qiskit/0.46/qiskit.algorithms.PhaseEstimation.md
new file mode 100644
index 00000000000..e32c2a64cb6
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.PhaseEstimation.md
@@ -0,0 +1,128 @@
+---
+title: PhaseEstimation
+description: API reference for qiskit.algorithms.PhaseEstimation
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.PhaseEstimation
+---
+
+# PhaseEstimation
+
+
+
+`qiskit.algorithms.PhaseEstimation(num_evaluation_qubits, quantum_instance=None, sampler=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/phase_estimators/phase_estimation.py "view source code")
+
+Bases: `PhaseEstimator`
+
+Run the Quantum Phase Estimation (QPE) algorithm.
+
+This runs QPE with a multi-qubit register for reading the phases \[1] of input states.
+
+The algorithm takes as input a unitary $U$ and a state $|\psi\rangle$, which may be written
+
+$$
+|\psi\rangle = \sum_j c_j |\phi_j\rangle,
+$$
+
+where $|\phi_j\rangle$ are eigenstates of $U$. We prepare the quantum register in the state $|\psi\rangle$ then apply $U$ leaving the register in the state
+
+$$
+U|\psi\rangle = \sum_j \exp(i \phi_j) c_j |\phi_j\rangle.
+$$
+
+In the ideal case, one then measures the phase $\phi_j$ with probability $|c_j|^2$. In practice, many (or all) of the bit strings may be measured due to noise and the possibility that $\phi_j$ may not be representable exactly by the output register. In the latter case the probability for each eigenphase will be spread across bitstrings, with amplitudes that decrease with distance from the bitstring most closely approximating the eigenphase.
+
+The main input to the constructor is the number of qubits in the phase-reading register. For phase estimation, there are two methods:
+
+**first. estimate, which takes a state preparation circuit to prepare an input state, and**
+
+a unitary that will act on the input state. In this case, an instance of `qiskit.circuit.PhaseEstimation`, a QPE circuit, containing the state preparation and input unitary will be constructed.
+
+**second. estimate\_from\_pe\_circuit, which takes a quantum-phase-estimation circuit in which**
+
+the unitary and state preparation are already embedded.
+
+In both estimation methods, the QPE circuit is run on a backend and the frequencies or counts of the phases represented by bitstrings are recorded. The results are returned as an instance of `PhaseEstimationResult`.
+
+**Reference:**
+
+**\[1]: Michael A. Nielsen and Isaac L. Chuang. 2011.**
+
+Quantum Computation and Quantum Information: 10th Anniversary Edition (10th ed.). Cambridge University Press, New York, NY, USA.
+
+
+ `qiskit.algorithms.phase_estimators.phase_estimation.PhaseEstimation.__init__()`’s argument `quantum_instance` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. Instead, use the `sampler` argument. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+**Parameters**
+
+* **num\_evaluation\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of qubits used in estimating the phase. The phase will be estimated as a binary string with this many bits.
+* **quantum\_instance** ([*QuantumInstance*](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance") *|*[*Backend*](qiskit.providers.Backend "qiskit.providers.Backend") *| None*) – Deprecated: The quantum instance on which the circuit will be run.
+* **sampler** ([*BaseSampler*](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler") *| None*) – The sampler primitive on which the circuit will be sampled.
+
+**Raises**
+
+[**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – If neither sampler nor quantum instance is provided.
+
+## Methods
+
+### construct\_circuit
+
+
+
+`construct_circuit(unitary, state_preparation=None)`
+
+Return the circuit to be executed to estimate phases.
+
+This circuit includes as sub-circuits the core phase estimation circuit, with the addition of the state-preparation circuit and possibly measurement instructions.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### estimate
+
+
+
+`estimate(unitary, state_preparation=None)`
+
+Build a phase estimation circuit and run the corresponding algorithm.
+
+**Parameters**
+
+* **unitary** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – The circuit representing the unitary operator whose eigenvalues (via phase) will be measured.
+* **state\_preparation** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| None*) – The circuit that prepares the state whose eigenphase will be measured. If this parameter is omitted, no preparation circuit will be run and input state will be the all-zero state in the computational basis.
+
+**Returns**
+
+An instance of qiskit.algorithms.phase\_estimator\_result.PhaseEstimationResult.
+
+**Return type**
+
+[PhaseEstimationResult](qiskit.algorithms.PhaseEstimationResult "qiskit.algorithms.PhaseEstimationResult")
+
+### estimate\_from\_pe\_circuit
+
+
+
+`estimate_from_pe_circuit(pe_circuit, num_unitary_qubits)`
+
+Run the phase estimation algorithm on a phase estimation circuit
+
+**Parameters**
+
+* **pe\_circuit** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")) – The phase estimation circuit.
+* **num\_unitary\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Must agree with the number of qubits in the unitary in pe\_circuit.
+
+**Returns**
+
+An instance of qiskit.algorithms.phase\_estimator\_result.PhaseEstimationResult.
+
+**Raises**
+
+[**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – Primitive job failed.
+
+**Return type**
+
+[*PhaseEstimationResult*](qiskit.algorithms.PhaseEstimationResult "qiskit.algorithms.phase_estimators.phase_estimation_result.PhaseEstimationResult")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.PhaseEstimationResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.PhaseEstimationResult.md
new file mode 100644
index 00000000000..d500ae05dd7
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.PhaseEstimationResult.md
@@ -0,0 +1,103 @@
+---
+title: PhaseEstimationResult
+description: API reference for qiskit.algorithms.PhaseEstimationResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.PhaseEstimationResult
+---
+
+# PhaseEstimationResult
+
+
+
+`qiskit.algorithms.PhaseEstimationResult(num_evaluation_qubits, circuit_result, phases)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/phase_estimators/phase_estimation_result.py "view source code")
+
+Bases: `PhaseEstimatorResult`
+
+Store and manipulate results from running PhaseEstimation.
+
+This class is instantiated by the `PhaseEstimation` class, not via user code. The `PhaseEstimation` class generates a list of phases and corresponding weights. Upon completion it returns the results as an instance of this class. The main method for accessing the results is filter\_phases.
+
+The canonical phase satisfying the `PhaseEstimator` interface, returned by the attribute phase, is the most likely phase.
+
+**Parameters**
+
+* **num\_evaluation\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of qubits in phase-readout register.
+* **circuit\_result** ([*Result*](qiskit.result.Result "qiskit.result.Result")) – result object returned by method running circuit.
+* **phases** ([*numpy.ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – ndarray or dict of phases and frequencies determined by QPE.
+
+## Attributes
+
+
+
+### circuit\_result
+
+Return the result object returned by running the QPE circuit (on hardware or simulator).
+
+This is useful for inspecting and troubleshooting the QPE algorithm.
+
+
+
+### most\_likely\_phase
+
+DEPRECATED - Return the most likely phase as a number in $[0.0, 1.0)$.
+
+1.0 corresponds to a phase of $2\pi$. This selects the phase corresponding to the bit string with the highesest probability. This is the most likely phase.
+
+
+ The property `qiskit.algorithms.phase_estimators.phase_estimation_result.PhaseEstimationResult.most_likely_phase` is deprecated as of qiskit-terra 0.18.0. It will be removed no earlier than 3 months after the release date. Instead, use the property `phase`, which behaves the same.
+
+
+
+
+### phase
+
+Return the most likely phase as a number in $[0.0, 1.0)$.
+
+1.0 corresponds to a phase of $2\pi$. This selects the phase corresponding to the bit string with the highesest probability. This is the most likely phase.
+
+
+
+### phases
+
+Return all phases and their frequencies computed by QPE.
+
+This is an array or dict whose values correspond to weights on bit strings.
+
+## Methods
+
+### combine
+
+
+
+`combine(result)`
+
+Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Argument is None
+
+### filter\_phases
+
+
+
+`filter_phases(cutoff=0.0, as_float=True)`
+
+Return a filtered dict of phases (keys) and frequencies (values).
+
+Only phases with frequencies (counts) larger than cutoff are included. It is assumed that the run method has been called so that the phases have been computed. When using a noiseless, shot-based simulator to read a single phase that can be represented exactly by num\_evaluation\_qubits, all the weight will be concentrated on a single phase. In all other cases, many, or all, bit strings will have non-zero weight. This method is useful for filtering out these uninteresting bit strings.
+
+**Parameters**
+
+* **cutoff** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Minimum weight of number of counts required to keep a bit string. The default value is 0.0.
+* **as\_float** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, returned keys are floats in $[0.0, 1.0)$. If False returned keys are bit strings.
+
+**Returns**
+
+A filtered dict of phases (keys) and frequencies (values).
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.PhaseEstimationScale.md b/docs/api/qiskit/0.46/qiskit.algorithms.PhaseEstimationScale.md
new file mode 100644
index 00000000000..ecbf2957b8f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.PhaseEstimationScale.md
@@ -0,0 +1,116 @@
+---
+title: PhaseEstimationScale
+description: API reference for qiskit.algorithms.PhaseEstimationScale
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.PhaseEstimationScale
+---
+
+# PhaseEstimationScale
+
+
+
+`qiskit.algorithms.PhaseEstimationScale(bound)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/phase_estimators/phase_estimation_scale.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Set and use a bound on eigenvalues of a Hermitian operator in order to ensure phases are in the desired range and to convert measured phases into eigenvectors.
+
+The `bound` is set when constructing this class. Then the method `scale` is used to find the factor by which to scale the operator.
+
+If `bound` is equal exactly to the largest eigenvalue, and the smallest eigenvalue is minus the largest, then these two eigenvalues will not be distinguished. For example, if the Hermitian operator is the Pauli Z operator with eigenvalues $1$ and $-1$, and `bound` is $1$, then both eigenvalues will be mapped to $1$. This can be avoided by making `bound` a bit larger.
+
+Increasing `bound` decreases the part of the interval $[0, 1)$ that is used to map eigenvalues to `phi`. However, sometimes this results in a better determination of the eigenvalues, because 1) although there are fewer discrete phases in the useful range, it may shift one of the discrete phases closer to the actual phase. And, 2) If one of the discrete phases is close to, or exactly equal to the actual phase, then artifacts (probability) in neighboring phases will be reduced. This is important because the artifacts may be larger than the probability in a phase representing another eigenvalue of interest whose corresponding eigenstate has a relatively small weight in the input state.
+
+**Parameters**
+
+**bound** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – an upper bound on the absolute value of the eigenvalues of a Hermitian operator. (The operator is not needed here.)
+
+## Attributes
+
+
+
+### scale
+
+Return the Hamiltonian scaling factor.
+
+Return the scale factor by which a Hermitian operator must be multiplied so that the phase of the corresponding unitary is restricted to $[-\pi, \pi]$. This factor is computed from the bound on the absolute values of the eigenvalues of the operator. The methods `scale_phase` and `scale_phases` are used recover the eigenvalues corresponding the original (unscaled) Hermitian operator.
+
+**Returns**
+
+The scale factor.
+
+## Methods
+
+### from\_pauli\_sum
+
+
+
+`classmethod from_pauli_sum(pauli_sum)`
+
+Create a PhaseEstimationScale from a SummedOp representing a sum of Pauli Operators.
+
+It is assumed that the `pauli_sum` is the sum of `PauliOp` objects. The bound on the absolute value of the eigenvalues of the sum is obtained as the sum of the absolute values of the coefficients of the terms. This is the best bound available in the generic case. A `PhaseEstimationScale` object is instantiated using this bound.
+
+**Parameters**
+
+**pauli\_sum** ([*SummedOp*](qiskit.opflow.list_ops.SummedOp "qiskit.opflow.list_ops.SummedOp") *|*[*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp") *|*[*SparsePauliOp*](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp") *|*[*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – A `SummedOp` whose terms are `PauliOp` objects.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – if `pauli_sum` is not a sum of Pauli operators.
+
+**Returns**
+
+A `PhaseEstimationScale` object
+
+**Return type**
+
+‘PhaseEstimationScale’ | [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+### scale\_phase
+
+
+
+`scale_phase(phi, id_coefficient=0.0)`
+
+Convert a phase into an eigenvalue.
+
+The input phase `phi` corresponds to the eigenvalue of a unitary obtained by exponentiating a scaled Hermitian operator. Recall that the phase is obtained from `phi` as $2\pi\phi$. Furthermore, the Hermitian operator was scaled so that `phi` is restricted to $[-1/2, 1/2]$, corresponding to phases in $[-\pi, \pi]$. But the values of phi read from the phase-readout register are in $[0, 1)$. Any value of `phi` greater than $1/2$ corresponds to a raw phase of minus the complement with respect to 1. After this possible shift, the phase is scaled by the inverse of the factor by which the Hermitian operator was scaled to recover the eigenvalue of the Hermitian operator.
+
+**Parameters**
+
+* **phi** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Normalized phase in $[0, 1)$ to be converted to an eigenvalue.
+* **id\_coefficient** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – All eigenvalues are shifted by this value.
+
+**Returns**
+
+An eigenvalue computed from the input phase.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+### scale\_phases
+
+
+
+`scale_phases(phases, id_coefficient=0.0)`
+
+Convert a list or dict of phases to eigenvalues.
+
+The values in the list, or keys in the dict, are values of ```phi` and are converted as described in the description of ``scale_phase```. In case `phases` is a dict, the values of the dict are passed unchanged.
+
+**Parameters**
+
+* **phases** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *|*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – a list or dict of values of `phi`.
+* **id\_coefficient** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – All eigenvalues are shifted by this value.
+
+**Returns**
+
+Eigenvalues computed from phases.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") | [list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.QAOA.md b/docs/api/qiskit/0.46/qiskit.algorithms.QAOA.md
new file mode 100644
index 00000000000..6f1fb3443bc
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.QAOA.md
@@ -0,0 +1,252 @@
+---
+title: QAOA
+description: API reference for qiskit.algorithms.QAOA
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.QAOA
+---
+
+# QAOA
+
+
+
+`qiskit.algorithms.QAOA(optimizer=None, reps=1, initial_state=None, mixer=None, initial_point=None, gradient=None, expectation=None, include_custom=False, max_evals_grouped=1, callback=None, quantum_instance=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/minimum_eigen_solvers/qaoa.py "view source code")
+
+Bases: [`VQE`](qiskit.algorithms.VQE "qiskit.algorithms.minimum_eigen_solvers.vqe.VQE")
+
+Deprecated: Quantum Approximate Optimization Algorithm.
+
+The QAOA class has been superseded by the [`qiskit.algorithms.minimum_eigensolvers.QAOA`](qiskit.algorithms.minimum_eigensolvers.QAOA "qiskit.algorithms.minimum_eigensolvers.QAOA") class. This class will be deprecated in a future release and subsequently removed after that.
+
+[QAOA](https://arxiv.org/abs/1411.4028) is a well-known algorithm for finding approximate solutions to combinatorial-optimization problems.
+
+The QAOA implementation directly extends [`VQE`](qiskit.algorithms.VQE "qiskit.algorithms.VQE") and inherits VQE’s optimization structure. However, unlike VQE, which can be configured with arbitrary ansatzes, QAOA uses its own fine-tuned ansatz, which comprises $p$ parameterized global $x$ rotations and $p$ different parameterizations of the problem hamiltonian. QAOA is thus principally configured by the single integer parameter, *p*, which dictates the depth of the ansatz, and thus affects the approximation quality.
+
+An optional array of $2p$ parameter values, as the *initial\_point*, may be provided as the starting **beta** and **gamma** parameters (as identically named in the original [QAOA paper](https://arxiv.org/abs/1411.4028)) for the QAOA ansatz.
+
+An operator or a parameterized quantum circuit may optionally also be provided as a custom mixer Hamiltonian. This allows, as discussed in [this paper](https://doi.org/10.1103/PhysRevApplied.5.034007) for quantum annealing, and in [this paper](https://arxiv.org/abs/1709.03489) for QAOA, to run constrained optimization problems where the mixer constrains the evolution to a feasible subspace of the full Hilbert space.
+
+
+ The class `qiskit.algorithms.minimum_eigen_solvers.qaoa.QAOA` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. Instead, use the class `qiskit.algorithms.minimum_eigensolvers.QAOA`. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+**Parameters**
+
+* **optimizer** ([*Optimizer*](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer") *|*[*Minimizer*](qiskit.algorithms.optimizers.Minimizer "qiskit.algorithms.optimizers.Minimizer") *| None*) – A classical optimizer, see also [`VQE`](qiskit.algorithms.VQE "qiskit.algorithms.VQE") for more details on the possible types.
+* **reps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the integer parameter $p$ as specified in [https://arxiv.org/abs/1411.4028](https://arxiv.org/abs/1411.4028), Has a minimum valid value of 1.
+* **initial\_state** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| None*) – An optional initial state to prepend the QAOA circuit with
+* **mixer** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *|*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")) – the mixer Hamiltonian to evolve with or a custom quantum circuit. Allows support of optimizations in constrained subspaces as per [https://arxiv.org/abs/1709.03489](https://arxiv.org/abs/1709.03489) as well as warm-starting the optimization as introduced in [http://arxiv.org/abs/2009.10095](http://arxiv.org/abs/2009.10095).
+* **initial\_point** (*np.ndarray | None*) – An optional initial point (i.e. initial parameter values) for the optimizer. If `None` then it will simply compute a random one.
+* **gradient** ([*GradientBase*](qiskit.opflow.gradients.GradientBase "qiskit.opflow.gradients.GradientBase") *| Callable\[\[np.ndarray |*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*],* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*] | None*) – An optional gradient operator respectively a gradient function used for optimization.
+* **expectation** ([*ExpectationBase*](qiskit.opflow.expectations.ExpectationBase "qiskit.opflow.expectations.ExpectationBase") *| None*) – The Expectation converter for taking the average value of the Observable over the ansatz state function. When None (the default) an [`ExpectationFactory`](qiskit.opflow.expectations.ExpectationFactory "qiskit.opflow.expectations.ExpectationFactory") is used to select an appropriate expectation based on the operator and backend. When using Aer qasm\_simulator backend, with paulis, it is however much faster to leverage custom Aer function for the computation but, although VQE performs much faster with it, the outcome is ideal, with no shot noise, like using a state vector simulator. If you are just looking for the quickest performance when choosing Aer qasm\_simulator and the lack of shot noise is not an issue then set include\_custom parameter here to True (defaults to False).
+* **include\_custom** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – When expectation parameter here is None setting this to True will allow the factory to include the custom Aer pauli expectation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Max number of evaluations performed simultaneously. Signals the given optimizer that more than one set of parameters can be supplied so that potentially the expectation values can be computed in parallel. Typically this is possible when a finite difference gradient is used by the optimizer such that multiple points to compute the gradient can be passed and if computed in parallel improve overall execution time. Ignored if a gradient operator or function is given.
+* **callback** (*Callable\[\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*, np.ndarray,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*], None] | None*) – a callback that can access the intermediate data during the optimization. Four parameter values are passed to the callback as follows during each evaluation by the optimizer for its current set of parameters as it works towards the minimum. These are: the evaluation count, the optimizer parameters for the ansatz, the evaluated mean and the evaluated standard deviation.
+* **quantum\_instance** ([*QuantumInstance*](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance") *|*[*Backend*](qiskit.providers.Backend "qiskit.providers.Backend") *| None*) – Quantum Instance or Backend
+
+## Attributes
+
+
+
+### ansatz
+
+Returns the ansatz.
+
+
+
+### callback
+
+Returns callback
+
+
+
+### expectation
+
+The expectation value algorithm used to construct the expectation measurement from the observable.
+
+
+
+### gradient
+
+Returns the gradient.
+
+
+
+### include\_custom
+
+Returns include\_custom
+
+
+
+### initial\_point
+
+Returns initial point
+
+
+
+### initial\_state
+
+Returns: Returns the initial state.
+
+
+
+### max\_evals\_grouped
+
+Returns max\_evals\_grouped
+
+
+
+### mixer
+
+Returns: Returns the mixer.
+
+
+
+### optimizer
+
+Returns optimizer
+
+
+
+### quantum\_instance
+
+Returns quantum instance.
+
+
+
+### setting
+
+Prepare the setting of VQE as a string.
+
+## Methods
+
+### compute\_minimum\_eigenvalue
+
+
+
+`compute_minimum_eigenvalue(operator, aux_operators=None)`
+
+Computes minimum eigenvalue. Operator and aux\_operators can be supplied here and if not None will override any already set into algorithm so it can be reused with different operators. While an operator is required by algorithms, aux\_operators are optional. To ‘remove’ a previous aux\_operators array use an empty list here.
+
+**Parameters**
+
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")) – Qubit operator of the Observable
+* **aux\_operators** (*ListOrDict\[*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")*] | None*) – Optional list of auxiliary operators to be evaluated with the eigenstate of the minimum eigenvalue main result and their expectation values returned. For instance in chemistry these can be dipole operators, total particle count operators so we can get values for these at the ground state.
+
+**Returns**
+
+MinimumEigensolverResult
+
+**Return type**
+
+[MinimumEigensolverResult](qiskit.algorithms.MinimumEigensolverResult "qiskit.algorithms.MinimumEigensolverResult")
+
+### construct\_circuit
+
+
+
+`construct_circuit(parameter, operator)`
+
+Return the circuits used to compute the expectation value.
+
+**Parameters**
+
+* **parameter** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*] | np.ndarray*) – Parameters for the ansatz circuit.
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")) – Qubit operator of the Observable
+
+**Returns**
+
+A list of the circuits used to compute the expectation value.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")]
+
+### construct\_expectation
+
+
+
+`construct_expectation(parameter, operator, return_expectation=False)`
+
+Generate the ansatz circuit and expectation value measurement, and return their runnable composition.
+
+**Parameters**
+
+* **parameter** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*] | np.ndarray*) – Parameters for the ansatz circuit.
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")) – Qubit operator of the Observable
+* **return\_expectation** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, return the `ExpectationBase` expectation converter used in the construction of the expectation value. Useful e.g. to compute the standard deviation of the expectation value.
+
+**Returns**
+
+The Operator equalling the measurement of the ansatz `StateFn` by the Observable’s expectation `StateFn`, and, optionally, the expectation converter.
+
+**Raises**
+
+* [**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – If no operator has been provided.
+* [**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – If no expectation is passed and None could be inferred via the ExpectationFactory.
+
+**Return type**
+
+[OperatorBase](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase") | [tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[OperatorBase](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase"), [ExpectationBase](qiskit.opflow.expectations.ExpectationBase "qiskit.opflow.expectations.ExpectationBase")]
+
+### get\_energy\_evaluation
+
+
+
+`get_energy_evaluation(operator, return_expectation=False)`
+
+Returns a function handle to evaluates the energy at given parameters for the ansatz.
+
+This is the objective function to be passed to the optimizer that is used for evaluation.
+
+**Parameters**
+
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")) – The operator whose energy to evaluate.
+* **return\_expectation** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, return the `ExpectationBase` expectation converter used in the construction of the expectation value. Useful e.g. to evaluate other operators with the same expectation value converter.
+
+**Returns**
+
+Energy of the hamiltonian of each parameter, and, optionally, the expectation converter.
+
+**Raises**
+
+[**RuntimeError**](https://docs.python.org/3/library/exceptions.html#RuntimeError "(in Python v3.12)") – If the circuit is not parameterized (i.e. has 0 free parameters).
+
+**Return type**
+
+Callable\[\[np.ndarray], [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") | [list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")]] | [tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[Callable\[\[np.ndarray], [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") | [list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")]], [ExpectationBase](qiskit.opflow.expectations.ExpectationBase "qiskit.opflow.expectations.ExpectationBase")]
+
+### print\_settings
+
+
+
+`print_settings()`
+
+Preparing the setting of VQE into a string.
+
+**Returns**
+
+the formatted setting of VQE
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### supports\_aux\_operators
+
+
+
+`classmethod supports_aux_operators()`
+
+Whether computing the expectation value of auxiliary operators is supported.
+
+If the minimum eigensolver computes an eigenstate of the main operator then it can compute the expectation value of the aux\_operators for that state. Otherwise they will be ignored.
+
+**Returns**
+
+True if aux\_operator expectations can be evaluated, False otherwise
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.RealEvolver.md b/docs/api/qiskit/0.46/qiskit.algorithms.RealEvolver.md
new file mode 100644
index 00000000000..9f3765e6997
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.RealEvolver.md
@@ -0,0 +1,48 @@
+---
+title: RealEvolver
+description: API reference for qiskit.algorithms.RealEvolver
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.RealEvolver
+---
+
+# RealEvolver
+
+
+
+`qiskit.algorithms.RealEvolver`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/evolvers/real_evolver.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Deprecated: Interface for Quantum Real Time Evolution.
+
+The RealEvolver interface has been superseded by the `qiskit.algorithms.time_evolvers.RealTimeEvolver` interface. This interface will be deprecated in a future release and subsequently removed after that.
+
+
+ The class `qiskit.algorithms.evolvers.real_evolver.RealEvolver` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. Instead, use the interface `qiskit.algorithms.time_evolvers.RealTimeEvolver`. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+## Methods
+
+### evolve
+
+
+
+`abstract evolve(evolution_problem)`
+
+Perform real time evolution $\exp(-i t H)|\Psi\rangle$.
+
+Evolves an initial state $|\Psi\rangle$ for a time $t$ under a Hamiltonian $H$, as provided in the `evolution_problem`.
+
+**Parameters**
+
+**evolution\_problem** ([*EvolutionProblem*](qiskit.algorithms.EvolutionProblem "qiskit.algorithms.evolvers.evolution_problem.EvolutionProblem")) – The definition of the evolution problem.
+
+**Returns**
+
+Evolution result which includes an evolved quantum state.
+
+**Return type**
+
+[*EvolutionResult*](qiskit.algorithms.EvolutionResult "qiskit.algorithms.evolvers.evolution_result.EvolutionResult")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.RealTimeEvolver.md b/docs/api/qiskit/0.46/qiskit.algorithms.RealTimeEvolver.md
new file mode 100644
index 00000000000..9ff195c72a6
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.RealTimeEvolver.md
@@ -0,0 +1,42 @@
+---
+title: RealTimeEvolver
+description: API reference for qiskit.algorithms.RealTimeEvolver
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.RealTimeEvolver
+---
+
+# RealTimeEvolver
+
+
+
+`qiskit.algorithms.RealTimeEvolver`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/time_evolvers/real_time_evolver.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Interface for Quantum Real Time Evolution.
+
+## Methods
+
+### evolve
+
+
+
+`abstract evolve(evolution_problem)`
+
+Perform real time evolution $\exp(-i t H)|\Psi\rangle$.
+
+Evolves an initial state $|\Psi\rangle$ for a time $t$ under a Hamiltonian $H$, as provided in the `evolution_problem`.
+
+**Parameters**
+
+**evolution\_problem** ([*TimeEvolutionProblem*](qiskit.algorithms.TimeEvolutionProblem "qiskit.algorithms.time_evolvers.time_evolution_problem.TimeEvolutionProblem")) – The definition of the evolution problem.
+
+**Returns**
+
+Evolution result which includes an evolved quantum state.
+
+**Return type**
+
+[*TimeEvolutionResult*](qiskit.algorithms.TimeEvolutionResult "qiskit.algorithms.time_evolvers.time_evolution_result.TimeEvolutionResult")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.SciPyImaginaryEvolver.md b/docs/api/qiskit/0.46/qiskit.algorithms.SciPyImaginaryEvolver.md
new file mode 100644
index 00000000000..dc36939ecd0
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.SciPyImaginaryEvolver.md
@@ -0,0 +1,52 @@
+---
+title: SciPyImaginaryEvolver
+description: API reference for qiskit.algorithms.SciPyImaginaryEvolver
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.SciPyImaginaryEvolver
+---
+
+# SciPyImaginaryEvolver
+
+
+
+`qiskit.algorithms.SciPyImaginaryEvolver(num_timesteps)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/time_evolvers/classical_methods/scipy_imaginary_evolver.py "view source code")
+
+Bases: [`ImaginaryTimeEvolver`](qiskit.algorithms.ImaginaryTimeEvolver "qiskit.algorithms.time_evolvers.imaginary_time_evolver.ImaginaryTimeEvolver")
+
+Classical Evolver for imaginary time evolution.
+
+Evolves an initial state $|\Psi\rangle$ for an imaginary time $\tau = it$ under a Hamiltonian $H$, as provided in the `evolution_problem`. Note that the precision of the evolver does not depend on the number of timesteps taken.
+
+**Parameters**
+
+**num\_timesteps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of timesteps in the simulation.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If num\_timesteps is not a positive integer.
+
+## Methods
+
+### evolve
+
+
+
+`evolve(evolution_problem)`
+
+Perform imaginary time evolution $\exp(-\tau H)|\Psi\rangle$.
+
+Evolves an initial state $|\Psi\rangle$ for an imaginary time $\tau$ under a Hamiltonian $H$, as provided in the `evolution_problem`.
+
+**Parameters**
+
+**evolution\_problem** ([*TimeEvolutionProblem*](qiskit.algorithms.TimeEvolutionProblem "qiskit.algorithms.time_evolvers.time_evolution_problem.TimeEvolutionProblem")) – The definition of the evolution problem.
+
+**Returns**
+
+Evolution result which includes an evolved quantum state.
+
+**Return type**
+
+[*TimeEvolutionResult*](qiskit.algorithms.TimeEvolutionResult "qiskit.algorithms.time_evolvers.time_evolution_result.TimeEvolutionResult")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.SciPyRealEvolver.md b/docs/api/qiskit/0.46/qiskit.algorithms.SciPyRealEvolver.md
new file mode 100644
index 00000000000..04b53286b88
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.SciPyRealEvolver.md
@@ -0,0 +1,52 @@
+---
+title: SciPyRealEvolver
+description: API reference for qiskit.algorithms.SciPyRealEvolver
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.SciPyRealEvolver
+---
+
+# SciPyRealEvolver
+
+
+
+`qiskit.algorithms.SciPyRealEvolver(num_timesteps)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/time_evolvers/classical_methods/scipy_real_evolver.py "view source code")
+
+Bases: [`RealTimeEvolver`](qiskit.algorithms.RealTimeEvolver "qiskit.algorithms.time_evolvers.real_time_evolver.RealTimeEvolver")
+
+Classical Evolver for real time evolution.
+
+Evolves an initial state $|\Psi\rangle$ for a time $t$ under a Hamiltonian $H$, as provided in the `evolution_problem`. Note that the precision of the evolver does not depend on the number of timesteps taken.
+
+**Parameters**
+
+**num\_timesteps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of timesteps in the simulation.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If steps is not a positive integer.
+
+## Methods
+
+### evolve
+
+
+
+`evolve(evolution_problem)`
+
+Perform real time evolution $\exp(-i t H)|\Psi\rangle$.
+
+Evolves an initial state $|\Psi\rangle$ for a time $t$ under a Hamiltonian $H$, as provided in the `evolution_problem`.
+
+**Parameters**
+
+**evolution\_problem** ([*TimeEvolutionProblem*](qiskit.algorithms.TimeEvolutionProblem "qiskit.algorithms.time_evolvers.time_evolution_problem.TimeEvolutionProblem")) – The definition of the evolution problem.
+
+**Returns**
+
+Evolution result which includes an evolved quantum state.
+
+**Return type**
+
+[*TimeEvolutionResult*](qiskit.algorithms.TimeEvolutionResult "qiskit.algorithms.time_evolvers.time_evolution_result.TimeEvolutionResult")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.TimeEvolutionProblem.md b/docs/api/qiskit/0.46/qiskit.algorithms.TimeEvolutionProblem.md
new file mode 100644
index 00000000000..f19ac2c85e2
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.TimeEvolutionProblem.md
@@ -0,0 +1,116 @@
+---
+title: TimeEvolutionProblem
+description: API reference for qiskit.algorithms.TimeEvolutionProblem
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.TimeEvolutionProblem
+---
+
+# TimeEvolutionProblem
+
+
+
+`qiskit.algorithms.TimeEvolutionProblem(hamiltonian, time, initial_state=None, aux_operators=None, truncation_threshold=1e-12, t_param=None, param_value_map=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/time_evolvers/time_evolution_problem.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Time evolution problem class.
+
+This class is the input to time evolution algorithms and must contain information on the total evolution time, a quantum state to be evolved and under which Hamiltonian the state is evolved.
+
+
+
+### hamiltonian
+
+The Hamiltonian under which to evolve the system.
+
+**Type**
+
+BaseOperator | [PauliSumOp](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")
+
+
+
+### initial\_state
+
+The quantum state to be evolved for methods like Trotterization. For variational time evolutions, where the evolution happens in an ansatz, this argument is not required.
+
+**Type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") | [Statevector](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") | None
+
+
+
+### aux\_operators
+
+Optional list of auxiliary operators to be evaluated with the evolved `initial_state` and their expectation values returned.
+
+**Type**
+
+ListOrDict\[BaseOperator | [PauliSumOp](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")] | None
+
+
+
+### truncation\_threshold
+
+Defines a threshold under which values can be assumed to be 0. Used when `aux_operators` is provided.
+
+**Type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+
+
+### t\_param
+
+Time parameter in case of a time-dependent Hamiltonian. This free parameter must be within the `hamiltonian`.
+
+**Type**
+
+[Parameter](qiskit.circuit.Parameter "qiskit.circuit.Parameter") | None
+
+
+
+### param\_value\_map
+
+Maps free parameters in the problem to values. Depending on the algorithm, it might refer to e.g. a Hamiltonian or an initial state.
+
+**Type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")\[[Parameter](qiskit.circuit.Parameter "qiskit.circuit.Parameter"), [complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")] | None
+
+**Parameters**
+
+* **hamiltonian** (*BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")) – The Hamiltonian under which to evolve the system.
+* **time** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Total time of evolution.
+* **initial\_state** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *|*[*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") *| None*) – The quantum state to be evolved for methods like Trotterization. For variational time evolutions, where the evolution happens in an ansatz, this argument is not required.
+* **aux\_operators** (*ListOrDict\[BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")*] | None*) – Optional list of auxiliary operators to be evaluated with the evolved `initial_state` and their expectation values returned.
+* **truncation\_threshold** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Defines a threshold under which values can be assumed to be 0. Used when `aux_operators` is provided.
+* **t\_param** ([*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter") *| None*) – Time parameter in case of a time-dependent Hamiltonian. This free parameter must be within the `hamiltonian`.
+* **param\_value\_map** (*Mapping\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*,* [*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*] | None*) – Maps free parameters in the problem to values. Depending on the algorithm, it might refer to e.g. a Hamiltonian or an initial state.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If non-positive time of evolution is provided.
+
+## Attributes
+
+
+
+### time
+
+Returns time.
+
+## Methods
+
+### validate\_params
+
+
+
+`validate_params()`
+
+Checks if all parameters present in the Hamiltonian are also present in the dictionary that maps them to values.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If Hamiltonian parameters cannot be bound with data provided.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.TimeEvolutionResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.TimeEvolutionResult.md
new file mode 100644
index 00000000000..3000cb287b0
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.TimeEvolutionResult.md
@@ -0,0 +1,79 @@
+---
+title: TimeEvolutionResult
+description: API reference for qiskit.algorithms.TimeEvolutionResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.TimeEvolutionResult
+---
+
+# TimeEvolutionResult
+
+
+
+`qiskit.algorithms.TimeEvolutionResult(evolved_state, aux_ops_evaluated=None, observables=None, times=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/time_evolvers/time_evolution_result.py "view source code")
+
+Bases: `AlgorithmResult`
+
+Class for holding time evolution result.
+
+
+
+### evolved\_state
+
+An evolved quantum state.
+
+**Type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")|[Statevector](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector")
+
+
+
+### aux\_ops\_evaluated
+
+Optional list of observables for which expected values on an evolved state are calculated. These values are in fact tuples formatted as (mean, standard deviation).
+
+**Type**
+
+ListOrDict\[[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)"), [complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")]] | None
+
+
+
+### observables
+
+Optional list of observables for which expected on an evolved state are calculated at each timestep. These values are in fact lists of tuples formatted as (mean, standard deviation).
+
+**Type**
+
+ListOrDict\[[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[np.ndarray, np.ndarray]] | None
+
+
+
+### times
+
+Optional list of times at which each observable has been evaluated.
+
+**Type**
+
+np.array | None
+
+**Parameters**
+
+* **evolved\_state** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *|*[*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector")) – An evolved quantum state.
+* **aux\_ops\_evaluated** (*ListOrDict\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*,* [*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*]] | None*) – Optional list of observables for which expected values on an evolved state are calculated. These values are in fact tuples formatted as (mean, standard deviation).
+* **observables** (*ListOrDict\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[np.ndarray, np.ndarray]] | None*) – Optional list of observables for which expected values are calculated for each timestep. These values are in fact tuples formatted as (mean array, standard deviation array).
+* **times** (*np.ndarray | None*) – Optional list of times at which each observable has been evaluated.
+
+## Methods
+
+### combine
+
+
+
+`combine(result)`
+
+Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Argument is None
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.TrotterQRTE.md b/docs/api/qiskit/0.46/qiskit.algorithms.TrotterQRTE.md
new file mode 100644
index 00000000000..18315511224
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.TrotterQRTE.md
@@ -0,0 +1,120 @@
+---
+title: TrotterQRTE
+description: API reference for qiskit.algorithms.TrotterQRTE
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.TrotterQRTE
+---
+
+# TrotterQRTE
+
+
+
+`qiskit.algorithms.TrotterQRTE(product_formula=None, expectation=None, quantum_instance=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/evolvers/trotterization/trotter_qrte.py "view source code")
+
+Bases: [`RealEvolver`](qiskit.algorithms.RealEvolver "qiskit.algorithms.evolvers.real_evolver.RealEvolver")
+
+Deprecated: Quantum Real Time Evolution using Trotterization.
+
+The TrotterQRTE class has been superseded by the [`qiskit.algorithms.time_evolvers.trotterization.TrotterQRTE`](qiskit.algorithms.time_evolvers.trotterization.TrotterQRTE "qiskit.algorithms.time_evolvers.trotterization.TrotterQRTE") class. This class will be deprecated in a future release and subsequently removed after that.
+
+Type of Trotterization is defined by a ProductFormula provided.
+
+Examples:
+
+```python
+from qiskit.opflow import X, Z, Zero
+from qiskit.algorithms import EvolutionProblem, TrotterQRTE
+from qiskit import BasicAer
+from qiskit.utils import QuantumInstance
+
+operator = X + Z
+initial_state = Zero
+time = 1
+evolution_problem = EvolutionProblem(operator, 1, initial_state)
+# LieTrotter with 1 rep
+backend = BasicAer.get_backend("statevector_simulator")
+quantum_instance = QuantumInstance(backend=backend)
+trotter_qrte = TrotterQRTE(quantum_instance=quantum_instance)
+evolved_state = trotter_qrte.evolve(evolution_problem).evolved_state
+```
+
+
+ The class `qiskit.algorithms.evolvers.trotterization.trotter_qrte.TrotterQRTE` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. Instead, use the class `qiskit.algorithms.time_evolvers.trotterization.TrotterQRTE`. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+**Parameters**
+
+* **product\_formula** ([*ProductFormula*](qiskit.synthesis.ProductFormula "qiskit.synthesis.ProductFormula") *| None*) – A Lie-Trotter-Suzuki product formula. The default is the Lie-Trotter first order product formula with a single repetition.
+* **expectation** ([*ExpectationBase*](qiskit.opflow.expectations.ExpectationBase "qiskit.opflow.expectations.ExpectationBase") *| None*) – An instance of ExpectationBase which defines a method for calculating expectation values of EvolutionProblem.aux\_operators.
+* **quantum\_instance** ([*QuantumInstance*](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance") *|*[*Backend*](qiskit.providers.Backend "qiskit.providers.Backend") *| None*) – A quantum instance used for calculating expectation values of EvolutionProblem.aux\_operators.
+
+## Attributes
+
+
+
+### expectation
+
+Returns an expectation used in the algorithm.
+
+
+
+### product\_formula
+
+Returns a product formula used in the algorithm.
+
+
+
+### quantum\_instance
+
+Returns a quantum instance used in the algorithm.
+
+## Methods
+
+### evolve
+
+
+
+`evolve(evolution_problem)`
+
+Evolves a quantum state for a given time using the Trotterization method based on a product formula provided. The result is provided in the form of a quantum circuit. If auxiliary operators are included in the `evolution_problem`, they are evaluated on an evolved state using a backend provided.
+
+
+ Time-dependent Hamiltonians are not yet supported.
+
+
+**Parameters**
+
+**evolution\_problem** ([*EvolutionProblem*](qiskit.algorithms.EvolutionProblem "qiskit.algorithms.evolvers.evolution_problem.EvolutionProblem")) – Instance defining evolution problem. For the included Hamiltonian, `PauliOp`, `SummedOp` or `PauliSumOp` are supported by TrotterQRTE.
+
+**Returns**
+
+Evolution result that includes an evolved state as a quantum circuit and, optionally, auxiliary operators evaluated for a resulting state on a backend.
+
+**Raises**
+
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `t_param` is not set to None in the EvolutionProblem (feature not currently supported).
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If the `initial_state` is not provided in the EvolutionProblem.
+
+**Return type**
+
+[*EvolutionResult*](qiskit.algorithms.EvolutionResult "qiskit.algorithms.evolvers.evolution_result.EvolutionResult")
+
+### supports\_aux\_operators
+
+
+
+`classmethod supports_aux_operators()`
+
+Whether computing the expectation value of auxiliary operators is supported.
+
+**Returns**
+
+**True if `aux_operators` expectations in the EvolutionProblem can be evaluated, False**
+
+otherwise.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.VQD.md b/docs/api/qiskit/0.46/qiskit.algorithms.VQD.md
new file mode 100644
index 00000000000..1e31358f840
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.VQD.md
@@ -0,0 +1,243 @@
+---
+title: VQD
+description: API reference for qiskit.algorithms.VQD
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.VQD
+---
+
+# VQD
+
+
+
+`qiskit.algorithms.VQD(ansatz=None, k=2, betas=None, optimizer=None, initial_point=None, gradient=None, expectation=None, include_custom=False, max_evals_grouped=1, callback=None, quantum_instance=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/eigen_solvers/vqd.py "view source code")
+
+Bases: `VariationalAlgorithm`, [`Eigensolver`](qiskit.algorithms.Eigensolver "qiskit.algorithms.eigen_solvers.eigen_solver.Eigensolver")
+
+Deprecated: Variational Quantum Deflation algorithm.
+
+The VQD class has been superseded by the [`qiskit.algorithms.eigensolvers.VQD`](qiskit.algorithms.eigensolvers.VQD "qiskit.algorithms.eigensolvers.VQD") class. This class will be deprecated in a future release and subsequently removed after that.
+
+[VQD](https://arxiv.org/abs/1805.08138) is a quantum algorithm that uses a variational technique to find the k eigenvalues of the Hamiltonian $H$ of a given system.
+
+The algorithm computes excited state energies of generalised hamiltonians by optimising over a modified cost function where each succesive eigen value is calculated iteratively by introducing an overlap term with all the previously computed eigenstaes that must be minimised, thus ensuring higher energy eigen states are found.
+
+An instance of VQD requires defining three algorithmic sub-components: an integer k denoting the number of eigenstates to calculate, a trial state (a.k.a. ansatz)which is a `QuantumCircuit`, and one of the classical [`optimizers`](qiskit.algorithms.optimizers#module-qiskit.algorithms.optimizers "qiskit.algorithms.optimizers"). The ansatz is varied, via its set of parameters, by the optimizer, such that it works towards a state, as determined by the parameters applied to the ansatz, that will result in the minimum expectation values being measured of the input operator (Hamiltonian). The algorithm does this by iteratively refining each excited state to be orthogonal to all the previous excited states.
+
+An optional array of parameter values, via the *initial\_point*, may be provided as the starting point for the search of the minimum eigenvalue. This feature is particularly useful such as when there are reasons to believe that the solution point is close to a particular point.
+
+The length of the *initial\_point* list value must match the number of the parameters expected by the ansatz being used. If the *initial\_point* is left at the default of `None`, then VQD will look to the ansatz for a preferred value, based on its given initial state. If the ansatz returns `None`, then a random point will be generated within the parameter bounds set, as per above. If the ansatz provides `None` as the lower bound, then VQD will default it to $-2\pi$; similarly, if the ansatz returns `None` as the upper bound, the default value will be $2\pi$.
+
+
+ The class `qiskit.algorithms.eigen_solvers.vqd.VQD` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. Instead, use the class `qiskit.algorithms.eigensolvers.VQD`.See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+**Parameters**
+
+* **ansatz** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| None*) – A parameterized circuit used as ansatz for the wave function.
+* **k** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of eigenvalues to return. Returns the lowest k eigenvalues.
+* **betas** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – beta parameters in the VQD paper. Should have length k - 1, with k the number of excited states. These hyperparameters balance the contribution of each overlap term to the cost function and have a default value computed as the mean square sum of the coefficients of the observable.
+* **optimizer** ([*Optimizer*](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer") *|*[*Minimizer*](qiskit.algorithms.optimizers.Minimizer "qiskit.algorithms.optimizers.Minimizer") *| None*) – A classical optimizer. Can either be a Qiskit optimizer or a callable that takes an array as input and returns a Qiskit or SciPy optimization result.
+* **initial\_point** (*np.ndarray | None*) – An optional initial point (i.e. initial parameter values) for the optimizer. If `None` then VQD will look to the ansatz for a preferred point and if not will simply compute a random one.
+* **gradient** ([*GradientBase*](qiskit.opflow.gradients.GradientBase "qiskit.opflow.gradients.GradientBase") *| Callable | None*) – An optional gradient function or operator for optimizer. Only used to compute the ground state at the moment.
+* **expectation** ([*ExpectationBase*](qiskit.opflow.expectations.ExpectationBase "qiskit.opflow.expectations.ExpectationBase") *| None*) – The Expectation converter for taking the average value of the Observable over the ansatz state function. When `None` (the default) an [`ExpectationFactory`](qiskit.opflow.expectations.ExpectationFactory "qiskit.opflow.expectations.ExpectationFactory") is used to select an appropriate expectation based on the operator and backend. When using Aer qasm\_simulator backend, with paulis, it is however much faster to leverage custom Aer function for the computation but, although VQD performs much faster with it, the outcome is ideal, with no shot noise, like using a state vector simulator. If you are just looking for the quickest performance when choosing Aer qasm\_simulator and the lack of shot noise is not an issue then set include\_custom parameter here to `True` (defaults to `False`).
+* **include\_custom** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – When expectation parameter here is None setting this to `True` will allow the factory to include the custom Aer pauli expectation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Max number of evaluations performed simultaneously. Signals the given optimizer that more than one set of parameters can be supplied so that multiple points to compute the gradient can be passed and if computed in parallel potentially the expectation values can be computed in parallel. Typically this is possible when a finite difference gradient is used by the optimizer such that improve overall execution time. Deprecated if a gradient operator or function is given.
+* **callback** (*Callable\[\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*, np.ndarray,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*], None] | None*) – a callback that can access the intermediate data during the optimization. Four parameter values are passed to the callback as follows during each evaluation by the optimizer for its current set of parameters as it works towards the minimum. These are: the evaluation count, the optimizer parameters for the ansatz, the evaluated mean, the evaluated standard deviation, and the current step.
+* **quantum\_instance** ([*QuantumInstance*](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance") *|*[*Backend*](qiskit.providers.Backend "qiskit.providers.Backend") *| None*) – Quantum Instance or Backend
+
+## Attributes
+
+
+
+### ansatz
+
+Returns the ansatz.
+
+
+
+### callback
+
+Returns callback
+
+
+
+### expectation
+
+The expectation value algorithm used to construct the expectation measurement from the observable.
+
+
+
+### gradient
+
+Returns the gradient.
+
+
+
+### include\_custom
+
+Returns include\_custom
+
+
+
+### initial\_point
+
+Returns initial point.
+
+
+
+### max\_evals\_grouped
+
+Returns max\_evals\_grouped
+
+
+
+### optimizer
+
+Returns optimizer
+
+
+
+### quantum\_instance
+
+Returns quantum instance.
+
+
+
+### setting
+
+Prepare the setting of VQD as a string.
+
+## Methods
+
+### compute\_eigenvalues
+
+
+
+`compute_eigenvalues(operator, aux_operators=None)`
+
+Computes eigenvalues. Operator and aux\_operators can be supplied here and if not None will override any already set into algorithm so it can be reused with different operators. While an operator is required by algorithms, aux\_operators are optional. To ‘remove’ a previous aux\_operators array use an empty list here.
+
+**Parameters**
+
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")) – Qubit operator of the Observable
+* **aux\_operators** (*ListOrDict\[*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")*] | None*) – Optional list of auxiliary operators to be evaluated with the eigenstate of the minimum eigenvalue main result and their expectation values returned. For instance in chemistry these can be dipole operators, total particle count operators so we can get values for these at the ground state.
+
+**Returns**
+
+EigensolverResult
+
+**Return type**
+
+[EigensolverResult](qiskit.algorithms.EigensolverResult "qiskit.algorithms.EigensolverResult")
+
+### construct\_circuit
+
+
+
+`construct_circuit(parameter, operator)`
+
+Return the circuits used to compute the expectation value.
+
+**Parameters**
+
+* **parameter** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*] | np.ndarray*) – Parameters for the ansatz circuit.
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")) – Qubit operator of the Observable
+
+**Returns**
+
+A list of the circuits used to compute the expectation value.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")]
+
+### construct\_expectation
+
+
+
+`construct_expectation(parameter, operator, return_expectation=False)`
+
+Generate the ansatz circuit and expectation value measurement, and return their runnable composition.
+
+**Parameters**
+
+* **parameter** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*] | np.ndarray*) – Parameters for the ansatz circuit.
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")) – Qubit operator of the Observable
+* **return\_expectation** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, return the `ExpectationBase` expectation converter used in the construction of the expectation value. Useful e.g. to compute the standard deviation of the expectation value.
+
+**Returns**
+
+The Operator equalling the measurement of the ansatz `StateFn` by the Observable’s expectation `StateFn`, and, optionally, the expectation converter.
+
+**Raises**
+
+* [**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – If no operator has been provided.
+* [**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – If no expectation is passed and None could be inferred via the ExpectationFactory.
+
+**Return type**
+
+[OperatorBase](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase") | [tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[OperatorBase](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase"), [ExpectationBase](qiskit.opflow.expectations.ExpectationBase "qiskit.opflow.expectations.ExpectationBase")]
+
+### get\_energy\_evaluation
+
+
+
+`get_energy_evaluation(step, operator, return_expectation=False, prev_states=None)`
+
+Returns a function handle to evaluates the energy at given parameters for the ansatz.
+
+This return value is the objective function to be passed to the optimizer for evaluation.
+
+**Parameters**
+
+* **step** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – level of energy being calculated. 0 for ground, 1 for first excited state…
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")) – The operator whose energy to evaluate.
+* **return\_expectation** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, return the `ExpectationBase` expectation converter used in the construction of the expectation value. Useful e.g. to evaluate other operators with the same expectation value converter.
+* **prev\_states** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[np.ndarray] | None*) – List of parameters from previous rounds of optimization.
+
+**Returns**
+
+A callable that computes and returns the energy of the hamiltonian of each parameter, and, optionally, the expectation
+
+**Raises**
+
+* [**RuntimeError**](https://docs.python.org/3/library/exceptions.html#RuntimeError "(in Python v3.12)") – If the circuit is not parameterized (i.e. has 0 free parameters).
+* [**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – If operator was not provided.
+
+**Return type**
+
+Callable\[\[np.ndarray], [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") | [list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")]] | [tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[Callable\[\[np.ndarray], [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") | [list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")]], [ExpectationBase](qiskit.opflow.expectations.ExpectationBase "qiskit.opflow.expectations.ExpectationBase")]
+
+### print\_settings
+
+
+
+`print_settings()`
+
+Preparing the setting of VQD into a string.
+
+**Returns**
+
+the formatted setting of VQD.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### supports\_aux\_operators
+
+
+
+`classmethod supports_aux_operators()`
+
+Whether computing the expectation value of auxiliary operators is supported.
+
+**Returns**
+
+True if aux\_operator expectations can be evaluated, False otherwise
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.VQDResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.VQDResult.md
new file mode 100644
index 00000000000..d89e9745884
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.VQDResult.md
@@ -0,0 +1,108 @@
+---
+title: VQDResult
+description: API reference for qiskit.algorithms.VQDResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.VQDResult
+---
+
+# VQDResult
+
+
+
+`qiskit.algorithms.VQDResult`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/eigen_solvers/vqd.py "view source code")
+
+Bases: `VariationalResult`, [`EigensolverResult`](qiskit.algorithms.EigensolverResult "qiskit.algorithms.eigen_solvers.eigen_solver.EigensolverResult")
+
+Deprecated: VQD Result.
+
+The VQDResult class has been superseded by the [`qiskit.algorithms.eigensolvers.VQDResult`](qiskit.algorithms.eigensolvers.VQDResult "qiskit.algorithms.eigensolvers.VQDResult") class. This class will be deprecated in a future release and subsequently removed after that.
+
+
+ The class `qiskit.algorithms.eigen_solvers.vqd.VQDResult` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. Instead, use the class `qiskit.algorithms.eigensolvers.VQDResult`.See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+## Attributes
+
+
+
+### aux\_operator\_eigenvalues
+
+Return aux operator expectation values.
+
+These values are in fact tuples formatted as (mean, standard deviation).
+
+
+
+### cost\_function\_evals
+
+Returns number of cost optimizer evaluations
+
+
+
+### eigenstates
+
+return eigen state
+
+
+
+### eigenvalues
+
+returns eigen values
+
+
+
+### optimal\_circuit
+
+The optimal circuits. Along with the optimal parameters, these can be used to retrieve the minimum eigenstate.
+
+
+
+### optimal\_parameters
+
+Returns the optimal parameters in a dictionary
+
+
+
+### optimal\_point
+
+Returns optimal point
+
+
+
+### optimal\_value
+
+Returns optimal value
+
+
+
+### optimizer\_evals
+
+Returns number of optimizer evaluations
+
+
+
+### optimizer\_result
+
+Returns the optimizer result
+
+
+
+### optimizer\_time
+
+Returns time taken for optimization
+
+## Methods
+
+### combine
+
+
+
+`combine(result)`
+
+Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Argument is None
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.VQE.md b/docs/api/qiskit/0.46/qiskit.algorithms.VQE.md
new file mode 100644
index 00000000000..d021ddd4811
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.VQE.md
@@ -0,0 +1,270 @@
+---
+title: VQE
+description: API reference for qiskit.algorithms.VQE
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.VQE
+---
+
+# VQE
+
+
+
+`qiskit.algorithms.VQE(ansatz=None, optimizer=None, initial_point=None, gradient=None, expectation=None, include_custom=False, max_evals_grouped=1, callback=None, quantum_instance=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/minimum_eigen_solvers/vqe.py "view source code")
+
+Bases: `VariationalAlgorithm`, [`MinimumEigensolver`](qiskit.algorithms.MinimumEigensolver "qiskit.algorithms.minimum_eigen_solvers.minimum_eigen_solver.MinimumEigensolver")
+
+Deprecated: Variational Quantum Eigensolver algorithm.
+
+The VQE class has been superseded by the [`qiskit.algorithms.minimum_eigensolvers.VQE`](qiskit.algorithms.minimum_eigensolvers.VQE "qiskit.algorithms.minimum_eigensolvers.VQE") class. This class will be deprecated in a future release and subsequently removed after that.
+
+[VQE](https://arxiv.org/abs/1304.3061) is a quantum algorithm that uses a variational technique to find the minimum eigenvalue of the Hamiltonian $H$ of a given system.
+
+An instance of VQE requires defining two algorithmic sub-components: a trial state (a.k.a. ansatz) which is a `QuantumCircuit`, and one of the classical [`optimizers`](qiskit.algorithms.optimizers#module-qiskit.algorithms.optimizers "qiskit.algorithms.optimizers"). The ansatz is varied, via its set of parameters, by the optimizer, such that it works towards a state, as determined by the parameters applied to the ansatz, that will result in the minimum expectation value being measured of the input operator (Hamiltonian).
+
+An optional array of parameter values, via the *initial\_point*, may be provided as the starting point for the search of the minimum eigenvalue. This feature is particularly useful such as when there are reasons to believe that the solution point is close to a particular point. As an example, when building the dissociation profile of a molecule, it is likely that using the previous computed optimal solution as the starting initial point for the next interatomic distance is going to reduce the number of iterations necessary for the variational algorithm to converge. It provides an [initial point tutorial](https://github.com/Qiskit/qiskit-tutorials-community/blob/master/chemistry/h2_vqe_initial_point.ipynb) detailing this use case.
+
+The length of the *initial\_point* list value must match the number of the parameters expected by the ansatz being used. If the *initial\_point* is left at the default of `None`, then VQE will look to the ansatz for a preferred value, based on its given initial state. If the ansatz returns `None`, then a random point will be generated within the parameter bounds set, as per above. If the ansatz provides `None` as the lower bound, then VQE will default it to $-2\pi$; similarly, if the ansatz returns `None` as the upper bound, the default value will be $2\pi$.
+
+The optimizer can either be one of Qiskit’s optimizers, such as [`SPSA`](qiskit.algorithms.optimizers.SPSA "qiskit.algorithms.optimizers.SPSA") or a callable with the following signature:
+
+
+ The callable \_must\_ have the argument names `fun, x0, jac, bounds` as indicated in the following code block.
+
+
+```python
+from qiskit.algorithms.optimizers import OptimizerResult
+
+def my_minimizer(fun, x0, jac=None, bounds=None) -> OptimizerResult:
+ # Note that the callable *must* have these argument names!
+ # Args:
+ # fun (callable): the function to minimize
+ # x0 (np.ndarray): the initial point for the optimization
+ # jac (callable, optional): the gradient of the objective function
+ # bounds (list, optional): a list of tuples specifying the parameter bounds
+
+ result = OptimizerResult()
+ result.x = # optimal parameters
+ result.fun = # optimal function value
+ return result
+```
+
+The above signature also allows to directly pass any SciPy minimizer, for instance as
+
+```python
+from functools import partial
+from scipy.optimize import minimize
+
+optimizer = partial(minimize, method="L-BFGS-B")
+```
+
+
+ The class `qiskit.algorithms.minimum_eigen_solvers.vqe.VQE` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. Instead, use the class `qiskit.algorithms.minimum_eigensolvers.VQE`. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+**Parameters**
+
+* **ansatz** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| None*) – A parameterized circuit used as Ansatz for the wave function.
+* **optimizer** ([*Optimizer*](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer") *|*[*Minimizer*](qiskit.algorithms.optimizers.Minimizer "qiskit.algorithms.optimizers.Minimizer") *| None*) – A classical optimizer. Can either be a Qiskit optimizer or a callable that takes an array as input and returns a Qiskit or SciPy optimization result.
+* **initial\_point** (*np.ndarray | None*) – An optional initial point (i.e. initial parameter values) for the optimizer. If `None` then VQE will look to the ansatz for a preferred point and if not will simply compute a random one.
+* **gradient** ([*GradientBase*](qiskit.opflow.gradients.GradientBase "qiskit.opflow.gradients.GradientBase") *| Callable | None*) – An optional gradient function or operator for optimizer.
+* **expectation** ([*ExpectationBase*](qiskit.opflow.expectations.ExpectationBase "qiskit.opflow.expectations.ExpectationBase") *| None*) – The Expectation converter for taking the average value of the Observable over the ansatz state function. When `None` (the default) an [`ExpectationFactory`](qiskit.opflow.expectations.ExpectationFactory "qiskit.opflow.expectations.ExpectationFactory") is used to select an appropriate expectation based on the operator and backend. When using Aer qasm\_simulator backend, with paulis, it is however much faster to leverage custom Aer function for the computation but, although VQE performs much faster with it, the outcome is ideal, with no shot noise, like using a state vector simulator. If you are just looking for the quickest performance when choosing Aer qasm\_simulator and the lack of shot noise is not an issue then set include\_custom parameter here to `True` (defaults to `False`).
+* **include\_custom** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – When expectation parameter here is None setting this to `True` will allow the factory to include the custom Aer pauli expectation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Max number of evaluations performed simultaneously. Signals the given optimizer that more than one set of parameters can be supplied so that potentially the expectation values can be computed in parallel. Typically this is possible when a finite difference gradient is used by the optimizer such that multiple points to compute the gradient can be passed and if computed in parallel improve overall execution time. Deprecated if a gradient operator or function is given.
+* **callback** (*Callable\[\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*, np.ndarray,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*], None] | None*) – a callback that can access the intermediate data during the optimization. Four parameter values are passed to the callback as follows during each evaluation by the optimizer for its current set of parameters as it works towards the minimum. These are: the evaluation count, the optimizer parameters for the ansatz, the evaluated mean and the evaluated standard deviation.\`
+* **quantum\_instance** ([*QuantumInstance*](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance") *|*[*Backend*](qiskit.providers.Backend "qiskit.providers.Backend") *| None*) – Quantum Instance or Backend
+
+## Attributes
+
+
+
+### ansatz
+
+Returns the ansatz.
+
+
+
+### callback
+
+Returns callback
+
+
+
+### expectation
+
+The expectation value algorithm used to construct the expectation measurement from the observable.
+
+
+
+### gradient
+
+Returns the gradient.
+
+
+
+### include\_custom
+
+Returns include\_custom
+
+
+
+### initial\_point
+
+Returns initial point
+
+
+
+### max\_evals\_grouped
+
+Returns max\_evals\_grouped
+
+
+
+### optimizer
+
+Returns optimizer
+
+
+
+### quantum\_instance
+
+Returns quantum instance.
+
+
+
+### setting
+
+Prepare the setting of VQE as a string.
+
+## Methods
+
+### compute\_minimum\_eigenvalue
+
+
+
+`compute_minimum_eigenvalue(operator, aux_operators=None)`
+
+Computes minimum eigenvalue. Operator and aux\_operators can be supplied here and if not None will override any already set into algorithm so it can be reused with different operators. While an operator is required by algorithms, aux\_operators are optional. To ‘remove’ a previous aux\_operators array use an empty list here.
+
+**Parameters**
+
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")) – Qubit operator of the Observable
+* **aux\_operators** (*ListOrDict\[*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")*] | None*) – Optional list of auxiliary operators to be evaluated with the eigenstate of the minimum eigenvalue main result and their expectation values returned. For instance in chemistry these can be dipole operators, total particle count operators so we can get values for these at the ground state.
+
+**Returns**
+
+MinimumEigensolverResult
+
+**Return type**
+
+[MinimumEigensolverResult](qiskit.algorithms.MinimumEigensolverResult "qiskit.algorithms.MinimumEigensolverResult")
+
+### construct\_circuit
+
+
+
+`construct_circuit(parameter, operator)`
+
+Return the circuits used to compute the expectation value.
+
+**Parameters**
+
+* **parameter** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*] | np.ndarray*) – Parameters for the ansatz circuit.
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")) – Qubit operator of the Observable
+
+**Returns**
+
+A list of the circuits used to compute the expectation value.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")]
+
+### construct\_expectation
+
+
+
+`construct_expectation(parameter, operator, return_expectation=False)`
+
+Generate the ansatz circuit and expectation value measurement, and return their runnable composition.
+
+**Parameters**
+
+* **parameter** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*] | np.ndarray*) – Parameters for the ansatz circuit.
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")) – Qubit operator of the Observable
+* **return\_expectation** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, return the `ExpectationBase` expectation converter used in the construction of the expectation value. Useful e.g. to compute the standard deviation of the expectation value.
+
+**Returns**
+
+The Operator equalling the measurement of the ansatz `StateFn` by the Observable’s expectation `StateFn`, and, optionally, the expectation converter.
+
+**Raises**
+
+* [**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – If no operator has been provided.
+* [**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – If no expectation is passed and None could be inferred via the ExpectationFactory.
+
+**Return type**
+
+[OperatorBase](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase") | [tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[OperatorBase](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase"), [ExpectationBase](qiskit.opflow.expectations.ExpectationBase "qiskit.opflow.expectations.ExpectationBase")]
+
+### get\_energy\_evaluation
+
+
+
+`get_energy_evaluation(operator, return_expectation=False)`
+
+Returns a function handle to evaluates the energy at given parameters for the ansatz.
+
+This is the objective function to be passed to the optimizer that is used for evaluation.
+
+**Parameters**
+
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")) – The operator whose energy to evaluate.
+* **return\_expectation** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, return the `ExpectationBase` expectation converter used in the construction of the expectation value. Useful e.g. to evaluate other operators with the same expectation value converter.
+
+**Returns**
+
+Energy of the hamiltonian of each parameter, and, optionally, the expectation converter.
+
+**Raises**
+
+[**RuntimeError**](https://docs.python.org/3/library/exceptions.html#RuntimeError "(in Python v3.12)") – If the circuit is not parameterized (i.e. has 0 free parameters).
+
+**Return type**
+
+Callable\[\[np.ndarray], [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") | [list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")]] | [tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[Callable\[\[np.ndarray], [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") | [list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")]], [ExpectationBase](qiskit.opflow.expectations.ExpectationBase "qiskit.opflow.expectations.ExpectationBase")]
+
+### print\_settings
+
+
+
+`print_settings()`
+
+Preparing the setting of VQE into a string.
+
+**Returns**
+
+the formatted setting of VQE
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### supports\_aux\_operators
+
+
+
+`classmethod supports_aux_operators()`
+
+Whether computing the expectation value of auxiliary operators is supported.
+
+If the minimum eigensolver computes an eigenstate of the main operator then it can compute the expectation value of the aux\_operators for that state. Otherwise they will be ignored.
+
+**Returns**
+
+True if aux\_operator expectations can be evaluated, False otherwise
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.VarQITE.md b/docs/api/qiskit/0.46/qiskit.algorithms.VarQITE.md
new file mode 100644
index 00000000000..811c71c96c2
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.VarQITE.md
@@ -0,0 +1,56 @@
+---
+title: VarQITE
+description: API reference for qiskit.algorithms.VarQITE
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.VarQITE
+---
+
+# VarQITE
+
+
+
+`qiskit.algorithms.VarQITE(ansatz, initial_parameters, variational_principle=None, estimator=None, ode_solver=, lse_solver=None, num_timesteps=None, imag_part_tol=1e-07, num_instability_tol=1e-07)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/time_evolvers/variational/var_qite.py "view source code")
+
+Bases: `VarQTE`, [`ImaginaryTimeEvolver`](qiskit.algorithms.ImaginaryTimeEvolver "qiskit.algorithms.time_evolvers.imaginary_time_evolver.ImaginaryTimeEvolver")
+
+Variational Quantum Imaginary Time Evolution algorithm.
+
+**Parameters**
+
+* **ansatz** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – Ansatz to be used for variational time evolution.
+* **initial\_parameters** (*Mapping\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – Initial parameter values for the ansatz.
+* **variational\_principle** ([*ImaginaryVariationalPrinciple*](qiskit.algorithms.time_evolvers.variational.ImaginaryVariationalPrinciple "qiskit.algorithms.time_evolvers.variational.ImaginaryVariationalPrinciple") *| None*) – Variational Principle to be used. Defaults to `ImaginaryMcLachlanPrinciple`.
+* **estimator** ([*BaseEstimator*](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator") *| None*) – An estimator primitive used for calculating expectation values of TimeEvolutionProblem.aux\_operators.
+* **ode\_solver** ([*Type*](circuit_classical#qiskit.circuit.classical.types.Type "qiskit.circuit.classical.types.Type")*\[OdeSolver] |* [*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – ODE solver callable that implements a SciPy `OdeSolver` interface or a string indicating a valid method offered by SciPy.
+* **lse\_solver** (*Callable\[\[np.ndarray, np.ndarray], np.ndarray] | None*) – Linear system of equations solver callable. It accepts `A` and `b` to solve `Ax=b` and returns `x`. If `None`, the default `np.linalg.lstsq` solver is used.
+* **num\_timesteps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of timesteps to take. If `None`, it is automatically selected to achieve a timestep of approximately 0.01. Only relevant in case of the `ForwardEulerSolver`.
+* **imag\_part\_tol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Allowed value of an imaginary part that can be neglected if no imaginary part is expected.
+* **num\_instability\_tol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The amount of negative value that is allowed to be rounded up to 0 for quantities that are expected to be non-negative.
+
+## Methods
+
+### evolve
+
+
+
+`evolve(evolution_problem)`
+
+Apply Variational Quantum Time Evolution to the given operator.
+
+**Parameters**
+
+**evolution\_problem** ([*TimeEvolutionProblem*](qiskit.algorithms.TimeEvolutionProblem "qiskit.algorithms.time_evolvers.time_evolution_problem.TimeEvolutionProblem")) – Instance defining an evolution problem.
+
+**Returns**
+
+Result of the evolution which includes a quantum circuit with bound parameters as an evolved state and, if provided, observables evaluated on the evolved state.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `initial_state` is included in the `evolution_problem`.
+
+**Return type**
+
+*VarQTEResult*
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.VarQRTE.md b/docs/api/qiskit/0.46/qiskit.algorithms.VarQRTE.md
new file mode 100644
index 00000000000..7f82404a884
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.VarQRTE.md
@@ -0,0 +1,56 @@
+---
+title: VarQRTE
+description: API reference for qiskit.algorithms.VarQRTE
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.VarQRTE
+---
+
+# VarQRTE
+
+
+
+`qiskit.algorithms.VarQRTE(ansatz, initial_parameters, variational_principle=None, estimator=None, ode_solver=, lse_solver=None, num_timesteps=None, imag_part_tol=1e-07, num_instability_tol=1e-07)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/time_evolvers/variational/var_qrte.py "view source code")
+
+Bases: `VarQTE`, [`RealTimeEvolver`](qiskit.algorithms.RealTimeEvolver "qiskit.algorithms.time_evolvers.real_time_evolver.RealTimeEvolver")
+
+Variational Quantum Real Time Evolution algorithm.
+
+**Parameters**
+
+* **ansatz** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – Ansatz to be used for variational time evolution.
+* **initial\_parameters** (*Mapping\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – Initial parameter values for an ansatz.
+* **variational\_principle** ([*RealVariationalPrinciple*](qiskit.algorithms.time_evolvers.variational.RealVariationalPrinciple "qiskit.algorithms.time_evolvers.variational.RealVariationalPrinciple") *| None*) – Variational Principle to be used. Defaults to `RealMcLachlanPrinciple`.
+* **estimator** ([*BaseEstimator*](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator") *| None*) – An estimator primitive used for calculating expectation values of TimeEvolutionProblem.aux\_operators.
+* **ode\_solver** ([*Type*](circuit_classical#qiskit.circuit.classical.types.Type "qiskit.circuit.classical.types.Type")*\[OdeSolver] |* [*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – ODE solver callable that implements a SciPy `OdeSolver` interface or a string indicating a valid method offered by SciPy.
+* **lse\_solver** (*Callable\[\[np.ndarray, np.ndarray], np.ndarray] | None*) – Linear system of equations solver callable. It accepts `A` and `b` to solve `Ax=b` and returns `x`. If `None`, the default `np.linalg.lstsq` solver is used.
+* **num\_timesteps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of timesteps to take. If `None`, it is automatically selected to achieve a timestep of approximately 0.01. Only relevant in case of the `ForwardEulerSolver`.
+* **imag\_part\_tol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Allowed value of an imaginary part that can be neglected if no imaginary part is expected.
+* **num\_instability\_tol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The amount of negative value that is allowed to be rounded up to 0 for quantities that are expected to be non-negative.
+
+## Methods
+
+### evolve
+
+
+
+`evolve(evolution_problem)`
+
+Apply Variational Quantum Time Evolution to the given operator.
+
+**Parameters**
+
+**evolution\_problem** ([*TimeEvolutionProblem*](qiskit.algorithms.TimeEvolutionProblem "qiskit.algorithms.time_evolvers.time_evolution_problem.TimeEvolutionProblem")) – Instance defining an evolution problem.
+
+**Returns**
+
+Result of the evolution which includes a quantum circuit with bound parameters as an evolved state and, if provided, observables evaluated on the evolved state.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `initial_state` is included in the `evolution_problem`.
+
+**Return type**
+
+*VarQTEResult*
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.Eigensolver.md b/docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.Eigensolver.md
new file mode 100644
index 00000000000..d5b2ed3ab00
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.Eigensolver.md
@@ -0,0 +1,61 @@
+---
+title: Eigensolver
+description: API reference for qiskit.algorithms.eigensolvers.Eigensolver
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.eigensolvers.Eigensolver
+---
+
+# Eigensolver
+
+
+
+`qiskit.algorithms.eigensolvers.Eigensolver`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/eigensolvers/eigensolver.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+The eigensolver interface.
+
+Algorithms that can compute eigenvalues for an operator may implement this interface to allow different algorithms to be used interchangeably.
+
+## Methods
+
+### compute\_eigenvalues
+
+
+
+`abstract compute_eigenvalues(operator, aux_operators=None)`
+
+Computes the minimum eigenvalue. The `operator` and `aux_operators` are supplied here. While an `operator` is required by algorithms, `aux_operators` are optional.
+
+**Parameters**
+
+* **operator** (*BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")) – Qubit operator of the observable.
+* **aux\_operators** (*ListOrDict\[BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")*] | None*) – Optional list of auxiliary operators to be evaluated with the eigenstate of the minimum eigenvalue main result and their expectation values returned. For instance, in chemistry, these can be dipole operators and total particle count operators, so we can get values for these at the ground state.
+
+**Returns**
+
+An eigensolver result.
+
+**Return type**
+
+[EigensolverResult](qiskit.algorithms.eigensolvers.EigensolverResult "qiskit.algorithms.eigensolvers.EigensolverResult")
+
+### supports\_aux\_operators
+
+
+
+`classmethod supports_aux_operators()`
+
+Whether computing the expectation value of auxiliary operators is supported.
+
+If the eigensolver computes the eigenvalues of the main operator, then it can compute the expectation value of the `aux_operators` for that state. Otherwise they will be ignored.
+
+**Returns**
+
+`True` if `aux_operator` expectations can be evaluated, `False` otherwise.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.EigensolverResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.EigensolverResult.md
new file mode 100644
index 00000000000..c1264ba5c4d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.EigensolverResult.md
@@ -0,0 +1,48 @@
+---
+title: EigensolverResult
+description: API reference for qiskit.algorithms.eigensolvers.EigensolverResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.eigensolvers.EigensolverResult
+---
+
+# EigensolverResult
+
+
+
+`qiskit.algorithms.eigensolvers.EigensolverResult`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/eigensolvers/eigensolver.py "view source code")
+
+Bases: `AlgorithmResult`
+
+Eigensolver result.
+
+## Attributes
+
+
+
+### aux\_operators\_evaluated
+
+Return the aux operator expectation values.
+
+These values are in fact tuples formatted as (mean, metadata).
+
+
+
+### eigenvalues
+
+Return the eigenvalues.
+
+## Methods
+
+### combine
+
+
+
+`combine(result)`
+
+Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Argument is None
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.NumPyEigensolver.md b/docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.NumPyEigensolver.md
new file mode 100644
index 00000000000..f3b0e4a0977
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.NumPyEigensolver.md
@@ -0,0 +1,84 @@
+---
+title: NumPyEigensolver
+description: API reference for qiskit.algorithms.eigensolvers.NumPyEigensolver
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.eigensolvers.NumPyEigensolver
+---
+
+# NumPyEigensolver
+
+
+
+`qiskit.algorithms.eigensolvers.NumPyEigensolver(k=1, filter_criterion=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/eigensolvers/numpy_eigensolver.py "view source code")
+
+Bases: [`Eigensolver`](qiskit.algorithms.eigensolvers.Eigensolver "qiskit.algorithms.eigensolvers.eigensolver.Eigensolver")
+
+The NumPy eigensolver algorithm.
+
+The NumPy Eigensolver computes up to the first $k$ eigenvalues of a complex-valued square matrix of dimension $n \times n$, with $k \leq n$.
+
+
+ Operators are automatically converted to SciPy’s `spmatrix` as needed and this conversion can be costly in terms of memory and performance as the operator size, mostly in terms of number of qubits it represents, gets larger.
+
+
+**Parameters**
+
+* **k** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of eigenvalues are to be computed, with a minimum value of 1.
+* **filter\_criterion** (*FilterType | None*) – Callable that allows to filter eigenvalues/eigenstates. Only feasible eigenstates are returned in the results. The callable has the signature `filter(eigenstate, eigenvalue, aux_values)` and must return a boolean to indicate whether to keep this value in the final returned result or not. If the number of elements that satisfies the criterion is smaller than `k`, then the returned list will have fewer elements and can even be empty.
+
+## Attributes
+
+
+
+### filter\_criterion
+
+Return the filter criterion if set.
+
+
+
+### k
+
+Return k (number of eigenvalues requested).
+
+## Methods
+
+### compute\_eigenvalues
+
+
+
+`compute_eigenvalues(operator, aux_operators=None)`
+
+Computes the minimum eigenvalue. The `operator` and `aux_operators` are supplied here. While an `operator` is required by algorithms, `aux_operators` are optional.
+
+**Parameters**
+
+* **operator** (*BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")) – Qubit operator of the observable.
+* **aux\_operators** (*ListOrDict\[BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")*] | None*) – Optional list of auxiliary operators to be evaluated with the eigenstate of the minimum eigenvalue main result and their expectation values returned. For instance, in chemistry, these can be dipole operators and total particle count operators, so we can get values for these at the ground state.
+
+**Returns**
+
+An eigensolver result.
+
+**Return type**
+
+[NumPyEigensolverResult](qiskit.algorithms.eigensolvers.NumPyEigensolverResult "qiskit.algorithms.eigensolvers.NumPyEigensolverResult")
+
+### supports\_aux\_operators
+
+
+
+`classmethod supports_aux_operators()`
+
+Whether computing the expectation value of auxiliary operators is supported.
+
+If the eigensolver computes the eigenvalues of the main operator, then it can compute the expectation value of the `aux_operators` for that state. Otherwise they will be ignored.
+
+**Returns**
+
+`True` if `aux_operator` expectations can be evaluated, `False` otherwise.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.NumPyEigensolverResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.NumPyEigensolverResult.md
new file mode 100644
index 00000000000..2a492983aa9
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.NumPyEigensolverResult.md
@@ -0,0 +1,54 @@
+---
+title: NumPyEigensolverResult
+description: API reference for qiskit.algorithms.eigensolvers.NumPyEigensolverResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.eigensolvers.NumPyEigensolverResult
+---
+
+# NumPyEigensolverResult
+
+
+
+`qiskit.algorithms.eigensolvers.NumPyEigensolverResult`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/eigensolvers/numpy_eigensolver.py "view source code")
+
+Bases: [`EigensolverResult`](qiskit.algorithms.eigensolvers.EigensolverResult "qiskit.algorithms.eigensolvers.eigensolver.EigensolverResult")
+
+NumPy eigensolver result.
+
+## Attributes
+
+
+
+### aux\_operators\_evaluated
+
+Return the aux operator expectation values.
+
+These values are in fact tuples formatted as (mean, metadata).
+
+
+
+### eigenstates
+
+Return eigenstates.
+
+
+
+### eigenvalues
+
+Return the eigenvalues.
+
+## Methods
+
+### combine
+
+
+
+`combine(result)`
+
+Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Argument is None
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.VQD.md b/docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.VQD.md
new file mode 100644
index 00000000000..aa9f706b38c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.VQD.md
@@ -0,0 +1,173 @@
+---
+title: VQD
+description: API reference for qiskit.algorithms.eigensolvers.VQD
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.eigensolvers.VQD
+---
+
+# VQD
+
+
+
+`qiskit.algorithms.eigensolvers.VQD(estimator, fidelity, ansatz, optimizer, *, k=2, betas=None, initial_point=None, callback=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/eigensolvers/vqd.py "view source code")
+
+Bases: `VariationalAlgorithm`, [`Eigensolver`](qiskit.algorithms.eigensolvers.Eigensolver "qiskit.algorithms.eigensolvers.eigensolver.Eigensolver")
+
+The Variational Quantum Deflation algorithm. Implementation using primitives.
+
+[VQD](https://arxiv.org/abs/1805.08138) is a quantum algorithm that uses a variational technique to find the k eigenvalues of the Hamiltonian $H$ of a given system.
+
+The algorithm computes excited state energies of generalised hamiltonians by optimising over a modified cost function where each succesive eigenvalue is calculated iteratively by introducing an overlap term with all the previously computed eigenstates that must be minimised, thus ensuring higher energy eigenstates are found.
+
+An instance of VQD requires defining three algorithmic sub-components: an integer k denoting the number of eigenstates to calculate, a trial state (a.k.a. ansatz) which is a `QuantumCircuit`, and one instance (or list of) classical [`optimizers`](qiskit.algorithms.optimizers#module-qiskit.algorithms.optimizers "qiskit.algorithms.optimizers"). The optimizer varies the circuit parameters The trial state $|\psi(\vec\theta)\rangle$ is varied by the optimizer, which modifies the set of ansatz parameters $\vec\theta$ such that the expectation value of the operator on the corresponding state approaches a minimum. The algorithm does this by iteratively refining each excited state to be orthogonal to all the previous excited states.
+
+An optional array of parameter values, via the *initial\_point*, may be provided as the starting point for the search of the minimum eigenvalue. This feature is particularly useful when there are reasons to believe that the solution point is close to a particular point.
+
+The length of the *initial\_point* list value must match the number of the parameters expected by the ansatz. If the *initial\_point* is left at the default of `None`, then VQD will look to the ansatz for a preferred value, based on its given initial state. If the ansatz returns `None`, then a random point will be generated within the parameter bounds set, as per above. It is also possible to give a list of initial points, one for every kth eigenvalue. If the ansatz provides `None` as the lower bound, then VQD will default it to $-2\pi$; similarly, if the ansatz returns `None` as the upper bound, the default value will be $2\pi$.
+
+The following attributes can be set via the initializer but can also be read and updated once the VQD object has been constructed.
+
+
+
+### estimator
+
+The primitive instance used to perform the expectation estimation as indicated in the VQD paper.
+
+**Type**
+
+[BaseEstimator](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator")
+
+
+
+### fidelity
+
+The fidelity class instance used to compute the overlap estimation as indicated in the VQD paper.
+
+**Type**
+
+[BaseStateFidelity](qiskit.algorithms.state_fidelities.BaseStateFidelity "qiskit.algorithms.state_fidelities.BaseStateFidelity")
+
+
+
+### ansatz
+
+A parameterized circuit used as ansatz for the wave function.
+
+**Type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+
+
+### optimizer
+
+A classical optimizer or a list of optimizers,
+
+**Type**
+
+[Optimizer](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer") | Sequence\[[Optimizer](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer")]
+
+### one for every k-th eigenvalue. Can either be a Qiskit optimizer or a callable
+
+that takes an array as input and returns a Qiskit or SciPy optimization result.
+
+
+
+### k
+
+the number of eigenvalues to return. Returns the lowest k eigenvalues.
+
+**Type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### betas
+
+Beta parameters in the VQD paper. Should have length k - 1, with k the number of excited states. These hyper-parameters balance the contribution of each overlap term to the cost function and have a default value computed as the mean square sum of the coefficients of the observable.
+
+**Type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")]
+
+### initial point
+
+An optional initial point (i.e. initial parameter values) or a list of initial points (one for every k-th eigenvalue) for the optimizer. If `None` then VQD will look to the ansatz for a preferred point and if not will simply compute a random one.
+
+**Type**
+
+Sequence\[[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")] | Sequence\[Sequence\[[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")]] | None
+
+
+
+### callback
+
+A callback that can access the intermediate data during the optimization. Four parameter values are passed to the callback as follows during each evaluation by the optimizer: the evaluation count, the optimizer parameters for the ansatz, the estimated value, the estimation metadata, and the current step.
+
+**Type**
+
+Callable\[\[[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)"), np.ndarray, [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)"), [dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)"), Any]], None] | None
+
+**Parameters**
+
+* **estimator** ([*BaseEstimator*](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator")) – The estimator primitive.
+* **fidelity** ([*BaseStateFidelity*](qiskit.algorithms.state_fidelities.BaseStateFidelity "qiskit.algorithms.state_fidelities.BaseStateFidelity")) – The fidelity class using primitives.
+* **ansatz** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – A parameterized circuit used as ansatz for the wave function.
+* **optimizer** ([*Optimizer*](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer") *|*[*Minimizer*](qiskit.algorithms.optimizers.Minimizer "qiskit.algorithms.optimizers.Minimizer") *| Sequence\[*[*Optimizer*](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer") *|*[*Minimizer*](qiskit.algorithms.optimizers.Minimizer "qiskit.algorithms.optimizers.Minimizer")*]*) – A classical optimizer or a list of optimizers, one for every k-th eigenvalue.
+* **callable** (*Can either be a Qiskit optimizer or a*) – that takes an array as input and returns a Qiskit or SciPy optimization result.
+* **k** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of eigenvalues to return. Returns the lowest k eigenvalues.
+* **betas** (*Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – Beta parameters in the VQD paper. Should have length k - 1, with k the number of excited states. These hyperparameters balance the contribution of each overlap term to the cost function and have a default value computed as the mean square sum of the coefficients of the observable.
+* **initial\_point** (*Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – An optional initial point (i.e. initial parameter values) or a list of initial points (one for every k-th eigenvalue) for the optimizer. If `None` then VQD will look to the ansatz for a preferred point and if not will simply compute a random one.
+* **callback** (*Callable\[\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*, np.ndarray,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*, Any]], None] | None*) – A callback that can access the intermediate data during the optimization. Four parameter values are passed to the callback as follows during each evaluation by the optimizer: the evaluation count, the optimizer parameters for the ansatz, the estimated value, the estimation metadata, and the current step.
+
+## Attributes
+
+
+
+### initial\_point
+
+Returns initial point.
+
+## Methods
+
+### compute\_eigenvalues
+
+
+
+`compute_eigenvalues(operator, aux_operators=None)`
+
+Computes the minimum eigenvalue. The `operator` and `aux_operators` are supplied here. While an `operator` is required by algorithms, `aux_operators` are optional.
+
+**Parameters**
+
+* **operator** (*BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")) – Qubit operator of the observable.
+* **aux\_operators** (*ListOrDict\[BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")*] | None*) – Optional list of auxiliary operators to be evaluated with the eigenstate of the minimum eigenvalue main result and their expectation values returned. For instance, in chemistry, these can be dipole operators and total particle count operators, so we can get values for these at the ground state.
+
+**Returns**
+
+An eigensolver result.
+
+**Return type**
+
+[VQDResult](qiskit.algorithms.eigensolvers.VQDResult "qiskit.algorithms.eigensolvers.VQDResult")
+
+### supports\_aux\_operators
+
+
+
+`classmethod supports_aux_operators()`
+
+Whether computing the expectation value of auxiliary operators is supported.
+
+If the eigensolver computes the eigenvalues of the main operator, then it can compute the expectation value of the `aux_operators` for that state. Otherwise they will be ignored.
+
+**Returns**
+
+`True` if `aux_operator` expectations can be evaluated, `False` otherwise.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.VQDResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.VQDResult.md
new file mode 100644
index 00000000000..58c1ff70950
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.VQDResult.md
@@ -0,0 +1,90 @@
+---
+title: VQDResult
+description: API reference for qiskit.algorithms.eigensolvers.VQDResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.eigensolvers.VQDResult
+---
+
+# VQDResult
+
+
+
+`qiskit.algorithms.eigensolvers.VQDResult`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/eigensolvers/vqd.py "view source code")
+
+Bases: [`EigensolverResult`](qiskit.algorithms.eigensolvers.EigensolverResult "qiskit.algorithms.eigensolvers.eigensolver.EigensolverResult")
+
+VQD Result.
+
+## Attributes
+
+
+
+### aux\_operators\_evaluated
+
+Return the aux operator expectation values.
+
+These values are in fact tuples formatted as (mean, metadata).
+
+
+
+### cost\_function\_evals
+
+Returns number of cost optimizer evaluations
+
+
+
+### eigenvalues
+
+Return the eigenvalues.
+
+
+
+### optimal\_circuits
+
+The optimal circuits. Along with the optimal parameters, these can be used to retrieve the different eigenstates.
+
+
+
+### optimal\_parameters
+
+Returns the optimal parameters for each step
+
+
+
+### optimal\_points
+
+Returns optimal point for each step
+
+
+
+### optimal\_values
+
+Returns optimal value for each step
+
+
+
+### optimizer\_results
+
+Returns the optimizer results for each step
+
+
+
+### optimizer\_times
+
+Returns time taken for optimization for each step
+
+## Methods
+
+### combine
+
+
+
+`combine(result)`
+
+Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Argument is None
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.md b/docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.md
new file mode 100644
index 00000000000..a1fac22f05f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.eigensolvers.md
@@ -0,0 +1,38 @@
+---
+title: eigensolvers
+description: API reference for qiskit.algorithms.eigensolvers
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.algorithms.eigensolvers
+---
+
+
+
+
+
+# qiskit.algorithms.eigensolvers
+
+
+
+## Eigensolvers Package
+
+
+
+`qiskit.algorithms.eigensolvers`
+
+### Eigensolvers
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------- |
+| [`Eigensolver`](qiskit.algorithms.eigensolvers.Eigensolver "qiskit.algorithms.eigensolvers.Eigensolver")() | The eigensolver interface. |
+| [`NumPyEigensolver`](qiskit.algorithms.eigensolvers.NumPyEigensolver "qiskit.algorithms.eigensolvers.NumPyEigensolver")(\[k, filter\_criterion]) | The NumPy eigensolver algorithm. |
+| [`VQD`](qiskit.algorithms.eigensolvers.VQD "qiskit.algorithms.eigensolvers.VQD")(estimator, fidelity, ansatz, optimizer, \*) | The Variational Quantum Deflation algorithm. |
+
+### Results
+
+> | | |
+> | ------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
+> | [`EigensolverResult`](qiskit.algorithms.eigensolvers.EigensolverResult "qiskit.algorithms.eigensolvers.EigensolverResult")() | Eigensolver result. |
+> | [`NumPyEigensolverResult`](qiskit.algorithms.eigensolvers.NumPyEigensolverResult "qiskit.algorithms.eigensolvers.NumPyEigensolverResult")() | NumPy eigensolver result. |
+> | [`VQDResult`](qiskit.algorithms.eigensolvers.VQDResult "qiskit.algorithms.eigensolvers.VQDResult")() | VQD Result. |
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.gradients.BaseEstimatorGradient.md b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.BaseEstimatorGradient.md
new file mode 100644
index 00000000000..9e6baec477b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.BaseEstimatorGradient.md
@@ -0,0 +1,98 @@
+---
+title: BaseEstimatorGradient
+description: API reference for qiskit.algorithms.gradients.BaseEstimatorGradient
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.gradients.BaseEstimatorGradient
+---
+
+# BaseEstimatorGradient
+
+
+
+`qiskit.algorithms.gradients.BaseEstimatorGradient(estimator, options=None, derivative_type=DerivativeType.REAL)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/gradients/base/base_estimator_gradient.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Base class for an `EstimatorGradient` to compute the gradients of the expectation value.
+
+**Parameters**
+
+* **estimator** ([*BaseEstimator*](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator")) – The estimator used to compute the gradients.
+
+* **options** ([*Options*](qiskit.providers.Options "qiskit.providers.Options") *| None*) – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > gradient’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting
+
+* **derivative\_type** (*DerivativeType*) –
+
+ The type of derivative. Can be either `DerivativeType.REAL` `DerivativeType.IMAG`, or `DerivativeType.COMPLEX`.
+
+ > * `DerivativeType.REAL` computes $2 \mathrm{Re}[⟨ψ(ω)|O(θ)|dω ψ(ω)〉]$.
+ > * `DerivativeType.IMAG` computes $2 \mathrm{Im}[⟨ψ(ω)|O(θ)|dω ψ(ω)〉]$.
+ > * `DerivativeType.COMPLEX` computes $2 ⟨ψ(ω)|O(θ)|dω ψ(ω)〉$.
+
+ Defaults to `DerivativeType.REAL`, as this yields e.g. the commonly-used energy gradient and this type is the only supported type for function-level schemes like finite difference.
+
+## Attributes
+
+
+
+### derivative\_type
+
+Return the derivative type (real, imaginary or complex).
+
+**Returns**
+
+The derivative type.
+
+
+
+### options
+
+Return the union of estimator options setting and gradient default options, where, if the same field is set in both, the gradient’s default options override the primitive’s default setting.
+
+**Returns**
+
+The gradient default + estimator options.
+
+## Methods
+
+### run
+
+
+
+`run(circuits, observables, parameter_values, parameters=None, **options)`
+
+Run the job of the estimator gradient on the given circuits.
+
+**Parameters**
+
+* **circuits** (*Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – The list of quantum circuits to compute the gradients.
+* **observables** (*Sequence\[BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")*]*) – The list of observables.
+* **parameter\_values** (*Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]]*) – The list of parameter values to be bound to the circuit.
+* **parameters** (*Sequence\[Sequence\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*] | None] | None*) – The sequence of parameters to calculate only the gradients of the specified parameters. Each sequence of parameters corresponds to a circuit in `circuits`. Defaults to None, which means that the gradients of all parameters in each circuit are calculated. None in the sequence means that the gradients of all parameters in the corresponding circuit are calculated.
+* **options** – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > gradient’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting
+
+**Returns**
+
+The job object of the gradients of the expectation values. The i-th result corresponds to `circuits[i]` evaluated with parameters bound as `parameter_values[i]`. The j-th element of the i-th result corresponds to the gradient of the i-th circuit with respect to the j-th parameter.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – Invalid arguments are given.
+
+**Return type**
+
+[AlgorithmJob](qiskit.algorithms.AlgorithmJob "qiskit.algorithms.AlgorithmJob")
+
+### update\_default\_options
+
+
+
+`update_default_options(**options)`
+
+Update the gradient’s default options setting.
+
+**Parameters**
+
+**\*\*options** – The fields to update the default options.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.gradients.BaseQGT.md b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.BaseQGT.md
new file mode 100644
index 00000000000..8e24e88cd72
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.BaseQGT.md
@@ -0,0 +1,115 @@
+---
+title: BaseQGT
+description: API reference for qiskit.algorithms.gradients.BaseQGT
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.gradients.BaseQGT
+---
+
+# BaseQGT
+
+
+
+`qiskit.algorithms.gradients.BaseQGT(estimator, phase_fix=True, derivative_type=DerivativeType.COMPLEX, options=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/gradients/base/base_qgt.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Base class to computes the Quantum Geometric Tensor (QGT) given a pure, parameterized quantum state. QGT is defined as:
+
+$$
+\mathrm{QGT}_{ij}= \langle \partial_i \psi | \partial_j \psi \rangle
+ - \langle\partial_i \psi | \psi \rangle \langle\psi | \partial_j \psi \rangle.
+$$
+
+**Parameters**
+
+* **estimator** ([*BaseEstimator*](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator")) – The estimator used to compute the QGT.
+
+* **phase\_fix** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to calculate the second term (phase fix) of the QGT, which is $\langle\partial_i \psi | \psi \rangle \langle\psi | \partial_j \psi \rangle$. Defaults to `True`.
+
+* **derivative\_type** (*DerivativeType*) –
+
+ The type of derivative. Can be either `DerivativeType.REAL` `DerivativeType.IMAG`, or `DerivativeType.COMPLEX`. Defaults to `DerivativeType.REAL`.
+
+ * `DerivativeType.REAL` computes
+
+ $$
+ \mathrm{Re(QGT)}_{ij}= \mathrm{Re}[\langle \partial_i \psi | \partial_j \psi \rangle
+ - \langle\partial_i \psi | \psi \rangle \langle\psi | \partial_j \psi \rangle].
+ $$
+
+ * `DerivativeType.IMAG` computes
+
+ $$
+ \mathrm{Im(QGT)}_{ij}= \mathrm{Im}[\langle \partial_i \psi | \partial_j \psi \rangle
+ - \langle\partial_i \psi | \psi \rangle \langle\psi | \partial_j \psi \rangle].
+ $$
+
+ * `DerivativeType.COMPLEX` computes
+
+ $$
+ \mathrm{QGT}_{ij}= [\langle \partial_i \psi | \partial_j \psi \rangle
+ - \langle\partial_i \psi | \psi \rangle \langle\psi | \partial_j \psi \rangle].
+ $$
+
+* **options** ([*Options*](qiskit.providers.Options "qiskit.providers.Options") *| None*) – Backend runtime options used for circuit execution. The order of priority is: options in `run` method > QGT’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting.
+
+## Attributes
+
+
+
+### derivative\_type
+
+The derivative type.
+
+
+
+### options
+
+Return the union of estimator options setting and QGT default options, where, if the same field is set in both, the QGT’s default options override the primitive’s default setting.
+
+**Returns**
+
+The QGT default + estimator options.
+
+## Methods
+
+### run
+
+
+
+`run(circuits, parameter_values, parameters=None, **options)`
+
+Run the job of the QGTs on the given circuits.
+
+**Parameters**
+
+* **circuits** (*Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – The list of quantum circuits to compute the QGTs.
+* **parameter\_values** (*Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]]*) – The list of parameter values to be bound to the circuit.
+* **parameters** (*Sequence\[Sequence\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*] | None] | None*) – The sequence of parameters to calculate only the QGTs of the specified parameters. Each sequence of parameters corresponds to a circuit in `circuits`. Defaults to None, which means that the QGTs of all parameters in each circuit are calculated.
+* **options** – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > QGT’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting.
+
+**Returns**
+
+The job object of the QGTs of the expectation values. The i-th result corresponds to `circuits[i]` evaluated with parameters bound as `parameter_values[i]`.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – Invalid arguments are given.
+
+**Return type**
+
+[AlgorithmJob](qiskit.algorithms.AlgorithmJob "qiskit.algorithms.AlgorithmJob")
+
+### update\_default\_options
+
+
+
+`update_default_options(**options)`
+
+Update the gradient’s default options setting.
+
+**Parameters**
+
+**\*\*options** – The fields to update the default options.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.gradients.BaseSamplerGradient.md b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.BaseSamplerGradient.md
new file mode 100644
index 00000000000..ea964ae2633
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.BaseSamplerGradient.md
@@ -0,0 +1,76 @@
+---
+title: BaseSamplerGradient
+description: API reference for qiskit.algorithms.gradients.BaseSamplerGradient
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.gradients.BaseSamplerGradient
+---
+
+# BaseSamplerGradient
+
+
+
+`qiskit.algorithms.gradients.BaseSamplerGradient(sampler, options=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/gradients/base/base_sampler_gradient.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Base class for a `SamplerGradient` to compute the gradients of the sampling probability.
+
+**Parameters**
+
+* **sampler** ([*BaseSampler*](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler")) – The sampler used to compute the gradients.
+* **options** ([*Options*](qiskit.providers.Options "qiskit.providers.Options") *| None*) – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > gradient’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting
+
+## Attributes
+
+
+
+### options
+
+Return the union of sampler options setting and gradient default options, where, if the same field is set in both, the gradient’s default options override the primitive’s default setting.
+
+**Returns**
+
+The gradient default + sampler options.
+
+## Methods
+
+### run
+
+
+
+`run(circuits, parameter_values, parameters=None, **options)`
+
+Run the job of the sampler gradient on the given circuits.
+
+**Parameters**
+
+* **circuits** (*Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – The list of quantum circuits to compute the gradients.
+* **parameter\_values** (*Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]]*) – The list of parameter values to be bound to the circuit.
+* **parameters** (*Sequence\[Sequence\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*] | None] | None*) – The sequence of parameters to calculate only the gradients of the specified parameters. Each sequence of parameters corresponds to a circuit in `circuits`. Defaults to None, which means that the gradients of all parameters in each circuit are calculated. None in the sequence means that the gradients of all parameters in the corresponding circuit are calculated.
+* **options** – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > gradient’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting
+
+**Returns**
+
+The job object of the gradients of the sampling probability. The i-th result corresponds to `circuits[i]` evaluated with parameters bound as `parameter_values[i]`. The j-th quasi-probability distribution in the i-th result corresponds to the gradients of the sampling probability for the j-th parameter in `circuits[i]`.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – Invalid arguments are given.
+
+**Return type**
+
+[AlgorithmJob](qiskit.algorithms.AlgorithmJob "qiskit.algorithms.AlgorithmJob")
+
+### update\_default\_options
+
+
+
+`update_default_options(**options)`
+
+Update the gradient’s default options setting.
+
+**Parameters**
+
+**\*\*options** – The fields to update the default options.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.gradients.EstimatorGradientResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.EstimatorGradientResult.md
new file mode 100644
index 00000000000..c9f73e02483
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.EstimatorGradientResult.md
@@ -0,0 +1,44 @@
+---
+title: EstimatorGradientResult
+description: API reference for qiskit.algorithms.gradients.EstimatorGradientResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.gradients.EstimatorGradientResult
+---
+
+# EstimatorGradientResult
+
+
+
+`qiskit.algorithms.gradients.EstimatorGradientResult(gradients, metadata, options)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/gradients/base/estimator_gradient_result.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Result of EstimatorGradient.
+
+## Attributes
+
+
+
+### gradients
+
+`list[numpy.ndarray]`
+
+The gradients of the expectation values.
+
+
+
+### metadata
+
+`list[dict[str, Any]]`
+
+Additional information about the job.
+
+
+
+### options
+
+`Options`
+
+Primitive runtime options for the execution of the job.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.gradients.FiniteDiffEstimatorGradient.md b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.FiniteDiffEstimatorGradient.md
new file mode 100644
index 00000000000..6ce94f07798
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.FiniteDiffEstimatorGradient.md
@@ -0,0 +1,107 @@
+---
+title: FiniteDiffEstimatorGradient
+description: API reference for qiskit.algorithms.gradients.FiniteDiffEstimatorGradient
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.gradients.FiniteDiffEstimatorGradient
+---
+
+# FiniteDiffEstimatorGradient
+
+
+
+`qiskit.algorithms.gradients.FiniteDiffEstimatorGradient(estimator, epsilon, options=None, *, method='central')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/gradients/finite_diff/finite_diff_estimator_gradient.py "view source code")
+
+Bases: [`BaseEstimatorGradient`](qiskit.algorithms.gradients.BaseEstimatorGradient "qiskit.algorithms.gradients.base.base_estimator_gradient.BaseEstimatorGradient")
+
+Compute the gradients of the expectation values by finite difference method \[1].
+
+**Reference:** \[1] [Finite difference method](https://en.wikipedia.org/wiki/Finite_difference_method)
+
+**Parameters**
+
+* **estimator** ([*BaseEstimator*](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator")) – The estimator used to compute the gradients.
+
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The offset size for the finite difference gradients.
+
+* **options** ([*Options*](qiskit.providers.Options "qiskit.providers.Options") *| None*) – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > gradient’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting
+
+* **method** (*Literal\['central', 'forward', 'backward']*) –
+
+ The computation method of the gradients.
+
+ > * `central` computes $\frac{f(x+e)-f(x-e)}{2e}$,
+ > * `forward` computes $\frac{f(x+e) - f(x)}{e}$,
+ > * `backward` computes $\frac{f(x)-f(x-e)}{e}$
+
+ where $e$ is epsilon.
+
+**Raises**
+
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `epsilon` is not positive.
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – If `method` is invalid.
+
+## Attributes
+
+
+
+### derivative\_type
+
+Return the derivative type (real, imaginary or complex).
+
+**Returns**
+
+The derivative type.
+
+
+
+### options
+
+Return the union of estimator options setting and gradient default options, where, if the same field is set in both, the gradient’s default options override the primitive’s default setting.
+
+**Returns**
+
+The gradient default + estimator options.
+
+## Methods
+
+### run
+
+
+
+`run(circuits, observables, parameter_values, parameters=None, **options)`
+
+Run the job of the estimator gradient on the given circuits.
+
+**Parameters**
+
+* **circuits** (*Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – The list of quantum circuits to compute the gradients.
+* **observables** (*Sequence\[BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")*]*) – The list of observables.
+* **parameter\_values** (*Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]]*) – The list of parameter values to be bound to the circuit.
+* **parameters** (*Sequence\[Sequence\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*] | None] | None*) – The sequence of parameters to calculate only the gradients of the specified parameters. Each sequence of parameters corresponds to a circuit in `circuits`. Defaults to None, which means that the gradients of all parameters in each circuit are calculated. None in the sequence means that the gradients of all parameters in the corresponding circuit are calculated.
+* **options** – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > gradient’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting
+
+**Returns**
+
+The job object of the gradients of the expectation values. The i-th result corresponds to `circuits[i]` evaluated with parameters bound as `parameter_values[i]`. The j-th element of the i-th result corresponds to the gradient of the i-th circuit with respect to the j-th parameter.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – Invalid arguments are given.
+
+**Return type**
+
+[AlgorithmJob](qiskit.algorithms.AlgorithmJob "qiskit.algorithms.AlgorithmJob")
+
+### update\_default\_options
+
+
+
+`update_default_options(**options)`
+
+Update the gradient’s default options setting.
+
+**Parameters**
+
+**\*\*options** – The fields to update the default options.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.gradients.FiniteDiffSamplerGradient.md b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.FiniteDiffSamplerGradient.md
new file mode 100644
index 00000000000..13d46349162
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.FiniteDiffSamplerGradient.md
@@ -0,0 +1,96 @@
+---
+title: FiniteDiffSamplerGradient
+description: API reference for qiskit.algorithms.gradients.FiniteDiffSamplerGradient
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.gradients.FiniteDiffSamplerGradient
+---
+
+# FiniteDiffSamplerGradient
+
+
+
+`qiskit.algorithms.gradients.FiniteDiffSamplerGradient(sampler, epsilon, options=None, *, method='central')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/gradients/finite_diff/finite_diff_sampler_gradient.py "view source code")
+
+Bases: [`BaseSamplerGradient`](qiskit.algorithms.gradients.BaseSamplerGradient "qiskit.algorithms.gradients.base.base_sampler_gradient.BaseSamplerGradient")
+
+Compute the gradients of the sampling probability by finite difference method \[1].
+
+**Reference:** \[1] [Finite difference method](https://en.wikipedia.org/wiki/Finite_difference_method)
+
+**Parameters**
+
+* **sampler** ([*BaseSampler*](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler")) – The sampler used to compute the gradients.
+
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The offset size for the finite difference gradients.
+
+* **options** ([*Options*](qiskit.providers.Options "qiskit.providers.Options") *| None*) – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > gradient’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting
+
+* **method** (*Literal\['central', 'forward', 'backward']*) –
+
+ The computation method of the gradients.
+
+ > * `central` computes $\frac{f(x+e)-f(x-e)}{2e}$,
+ > * `forward` computes $\frac{f(x+e) - f(x)}{e}$,
+ > * `backward` computes $\frac{f(x)-f(x-e)}{e}$
+
+ where $e$ is epsilon.
+
+**Raises**
+
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `epsilon` is not positive.
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – If `method` is invalid.
+
+## Attributes
+
+
+
+### options
+
+Return the union of sampler options setting and gradient default options, where, if the same field is set in both, the gradient’s default options override the primitive’s default setting.
+
+**Returns**
+
+The gradient default + sampler options.
+
+## Methods
+
+### run
+
+
+
+`run(circuits, parameter_values, parameters=None, **options)`
+
+Run the job of the sampler gradient on the given circuits.
+
+**Parameters**
+
+* **circuits** (*Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – The list of quantum circuits to compute the gradients.
+* **parameter\_values** (*Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]]*) – The list of parameter values to be bound to the circuit.
+* **parameters** (*Sequence\[Sequence\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*] | None] | None*) – The sequence of parameters to calculate only the gradients of the specified parameters. Each sequence of parameters corresponds to a circuit in `circuits`. Defaults to None, which means that the gradients of all parameters in each circuit are calculated. None in the sequence means that the gradients of all parameters in the corresponding circuit are calculated.
+* **options** – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > gradient’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting
+
+**Returns**
+
+The job object of the gradients of the sampling probability. The i-th result corresponds to `circuits[i]` evaluated with parameters bound as `parameter_values[i]`. The j-th quasi-probability distribution in the i-th result corresponds to the gradients of the sampling probability for the j-th parameter in `circuits[i]`.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – Invalid arguments are given.
+
+**Return type**
+
+[AlgorithmJob](qiskit.algorithms.AlgorithmJob "qiskit.algorithms.AlgorithmJob")
+
+### update\_default\_options
+
+
+
+`update_default_options(**options)`
+
+Update the gradient’s default options setting.
+
+**Parameters**
+
+**\*\*options** – The fields to update the default options.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.gradients.LinCombEstimatorGradient.md b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.LinCombEstimatorGradient.md
new file mode 100644
index 00000000000..ddb39859b71
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.LinCombEstimatorGradient.md
@@ -0,0 +1,104 @@
+---
+title: LinCombEstimatorGradient
+description: API reference for qiskit.algorithms.gradients.LinCombEstimatorGradient
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.gradients.LinCombEstimatorGradient
+---
+
+# LinCombEstimatorGradient
+
+
+
+`qiskit.algorithms.gradients.LinCombEstimatorGradient(estimator, derivative_type=DerivativeType.REAL, options=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/gradients/lin_comb/lin_comb_estimator_gradient.py "view source code")
+
+Bases: [`BaseEstimatorGradient`](qiskit.algorithms.gradients.BaseEstimatorGradient "qiskit.algorithms.gradients.base.base_estimator_gradient.BaseEstimatorGradient")
+
+Compute the gradients of the expectation values. This method employs a linear combination of unitaries \[1].
+
+**Reference:** \[1] Schuld et al., Evaluating analytic gradients on quantum hardware, 2018 [arXiv:1811.11184](https://arxiv.org/pdf/1811.11184.pdf)
+
+**Parameters**
+
+* **estimator** ([*BaseEstimator*](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator")) – The estimator used to compute the gradients.
+
+* **derivative\_type** (*DerivativeType*) –
+
+ The type of derivative. Can be either `DerivativeType.REAL` `DerivativeType.IMAG`, or `DerivativeType.COMPLEX`. Defaults to `DerivativeType.REAL`.
+
+ > * `DerivativeType.REAL` computes $2 \mathrm{Re}[⟨ψ(ω)|O(θ)|dω ψ(ω)〉]$.
+ > * `DerivativeType.IMAG` computes $2 \mathrm{Im}[⟨ψ(ω)|O(θ)|dω ψ(ω)〉]$.
+ > * `DerivativeType.COMPLEX` computes $2 ⟨ψ(ω)|O(θ)|dω ψ(ω)〉$.
+
+* **options** ([*Options*](qiskit.providers.Options "qiskit.providers.Options") *| None*) – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > gradient’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting.
+
+## Attributes
+
+
+
+### SUPPORTED\_GATES
+
+`= ['rx', 'ry', 'rz', 'rzx', 'rzz', 'ryy', 'rxx', 'cx', 'cy', 'cz', 'ccx', 'swap', 'iswap', 'h', 't', 's', 'sdg', 'x', 'y', 'z']`
+
+
+
+### derivative\_type
+
+Return the derivative type (real, imaginary or complex).
+
+**Returns**
+
+The derivative type.
+
+
+
+### options
+
+Return the union of estimator options setting and gradient default options, where, if the same field is set in both, the gradient’s default options override the primitive’s default setting.
+
+**Returns**
+
+The gradient default + estimator options.
+
+## Methods
+
+### run
+
+
+
+`run(circuits, observables, parameter_values, parameters=None, **options)`
+
+Run the job of the estimator gradient on the given circuits.
+
+**Parameters**
+
+* **circuits** (*Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – The list of quantum circuits to compute the gradients.
+* **observables** (*Sequence\[BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")*]*) – The list of observables.
+* **parameter\_values** (*Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]]*) – The list of parameter values to be bound to the circuit.
+* **parameters** (*Sequence\[Sequence\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*] | None] | None*) – The sequence of parameters to calculate only the gradients of the specified parameters. Each sequence of parameters corresponds to a circuit in `circuits`. Defaults to None, which means that the gradients of all parameters in each circuit are calculated. None in the sequence means that the gradients of all parameters in the corresponding circuit are calculated.
+* **options** – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > gradient’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting
+
+**Returns**
+
+The job object of the gradients of the expectation values. The i-th result corresponds to `circuits[i]` evaluated with parameters bound as `parameter_values[i]`. The j-th element of the i-th result corresponds to the gradient of the i-th circuit with respect to the j-th parameter.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – Invalid arguments are given.
+
+**Return type**
+
+[AlgorithmJob](qiskit.algorithms.AlgorithmJob "qiskit.algorithms.AlgorithmJob")
+
+### update\_default\_options
+
+
+
+`update_default_options(**options)`
+
+Update the gradient’s default options setting.
+
+**Parameters**
+
+**\*\*options** – The fields to update the default options.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.gradients.LinCombQGT.md b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.LinCombQGT.md
new file mode 100644
index 00000000000..1e928f2d2ff
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.LinCombQGT.md
@@ -0,0 +1,124 @@
+---
+title: LinCombQGT
+description: API reference for qiskit.algorithms.gradients.LinCombQGT
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.gradients.LinCombQGT
+---
+
+# LinCombQGT
+
+
+
+`qiskit.algorithms.gradients.LinCombQGT(estimator, phase_fix=True, derivative_type=DerivativeType.COMPLEX, options=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/gradients/lin_comb/lin_comb_qgt.py "view source code")
+
+Bases: [`BaseQGT`](qiskit.algorithms.gradients.BaseQGT "qiskit.algorithms.gradients.base.base_qgt.BaseQGT")
+
+Computes the Quantum Geometric Tensor (QGT) given a pure, parameterized quantum state.
+
+This method employs a linear combination of unitaries \[1].
+
+**Reference:**
+
+> **\[1]: Schuld et al., “Evaluating analytic gradients on quantum hardware” (2018).**
+>
+> [arXiv:1811.11184](https://arxiv.org/pdf/1811.11184.pdf)
+
+**Parameters**
+
+* **estimator** ([*BaseEstimator*](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator")) – The estimator used to compute the QGT.
+
+* **phase\_fix** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to calculate the second term (phase fix) of the QGT, which is $\langle\partial_i \psi | \psi \rangle \langle\psi | \partial_j \psi \rangle$. Default to `True`.
+
+* **derivative\_type** (*DerivativeType*) –
+
+ The type of derivative. Can be either `DerivativeType.REAL` `DerivativeType.IMAG`, or `DerivativeType.COMPLEX`. Defaults to `DerivativeType.REAL`.
+
+ * `DerivativeType.REAL` computes
+
+ $$
+ \mathrm{Re(QGT)}_{ij}= \mathrm{Re}[\langle \partial_i \psi | \partial_j \psi \rangle
+ - \langle\partial_i \psi | \psi \rangle \langle\psi | \partial_j \psi \rangle].
+ $$
+
+ * `DerivativeType.IMAG` computes
+
+ $$
+ \mathrm{Re(QGT)}_{ij}= \mathrm{Im}[\langle \partial_i \psi | \partial_j \psi \rangle
+ - \langle\partial_i \psi | \psi \rangle \langle\psi | \partial_j \psi \rangle].
+ $$
+
+ * `DerivativeType.COMPLEX` computes
+
+ $$
+ \mathrm{QGT}_{ij}= [\langle \partial_i \psi | \partial_j \psi \rangle
+ - \langle\partial_i \psi | \psi \rangle \langle\psi | \partial_j \psi \rangle].
+ $$
+
+* **options** ([*Options*](qiskit.providers.Options "qiskit.providers.Options") *| None*) – Backend runtime options used for circuit execution. The order of priority is: options in `run` method > QGT’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting.
+
+## Attributes
+
+
+
+### SUPPORTED\_GATES
+
+`= ['rx', 'ry', 'rz', 'rzx', 'rzz', 'ryy', 'rxx', 'cx', 'cy', 'cz', 'ccx', 'swap', 'iswap', 'h', 't', 's', 'sdg', 'x', 'y', 'z']`
+
+
+
+### derivative\_type
+
+The derivative type.
+
+
+
+### options
+
+Return the union of estimator options setting and QGT default options, where, if the same field is set in both, the QGT’s default options override the primitive’s default setting.
+
+**Returns**
+
+The QGT default + estimator options.
+
+## Methods
+
+### run
+
+
+
+`run(circuits, parameter_values, parameters=None, **options)`
+
+Run the job of the QGTs on the given circuits.
+
+**Parameters**
+
+* **circuits** (*Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – The list of quantum circuits to compute the QGTs.
+* **parameter\_values** (*Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]]*) – The list of parameter values to be bound to the circuit.
+* **parameters** (*Sequence\[Sequence\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*] | None] | None*) – The sequence of parameters to calculate only the QGTs of the specified parameters. Each sequence of parameters corresponds to a circuit in `circuits`. Defaults to None, which means that the QGTs of all parameters in each circuit are calculated.
+* **options** – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > QGT’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting.
+
+**Returns**
+
+The job object of the QGTs of the expectation values. The i-th result corresponds to `circuits[i]` evaluated with parameters bound as `parameter_values[i]`.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – Invalid arguments are given.
+
+**Return type**
+
+[AlgorithmJob](qiskit.algorithms.AlgorithmJob "qiskit.algorithms.AlgorithmJob")
+
+### update\_default\_options
+
+
+
+`update_default_options(**options)`
+
+Update the gradient’s default options setting.
+
+**Parameters**
+
+**\*\*options** – The fields to update the default options.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.gradients.LinCombSamplerGradient.md b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.LinCombSamplerGradient.md
new file mode 100644
index 00000000000..88d20cf0b3a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.LinCombSamplerGradient.md
@@ -0,0 +1,84 @@
+---
+title: LinCombSamplerGradient
+description: API reference for qiskit.algorithms.gradients.LinCombSamplerGradient
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.gradients.LinCombSamplerGradient
+---
+
+# LinCombSamplerGradient
+
+
+
+`qiskit.algorithms.gradients.LinCombSamplerGradient(sampler, options=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/gradients/lin_comb/lin_comb_sampler_gradient.py "view source code")
+
+Bases: [`BaseSamplerGradient`](qiskit.algorithms.gradients.BaseSamplerGradient "qiskit.algorithms.gradients.base.base_sampler_gradient.BaseSamplerGradient")
+
+Compute the gradients of the sampling probability. This method employs a linear combination of unitaries \[1].
+
+**Reference:** \[1] Schuld et al., Evaluating analytic gradients on quantum hardware, 2018 [arXiv:1811.11184](https://arxiv.org/pdf/1811.11184.pdf)
+
+**Parameters**
+
+* **sampler** ([*BaseSampler*](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler")) – The sampler used to compute the gradients.
+* **options** ([*Options*](qiskit.providers.Options "qiskit.providers.Options") *| None*) – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > gradient’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting
+
+## Attributes
+
+
+
+### SUPPORTED\_GATES
+
+`= ['rx', 'ry', 'rz', 'rzx', 'rzz', 'ryy', 'rxx', 'cx', 'cy', 'cz', 'ccx', 'swap', 'iswap', 'h', 't', 's', 'sdg', 'x', 'y', 'z']`
+
+
+
+### options
+
+Return the union of sampler options setting and gradient default options, where, if the same field is set in both, the gradient’s default options override the primitive’s default setting.
+
+**Returns**
+
+The gradient default + sampler options.
+
+## Methods
+
+### run
+
+
+
+`run(circuits, parameter_values, parameters=None, **options)`
+
+Run the job of the sampler gradient on the given circuits.
+
+**Parameters**
+
+* **circuits** (*Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – The list of quantum circuits to compute the gradients.
+* **parameter\_values** (*Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]]*) – The list of parameter values to be bound to the circuit.
+* **parameters** (*Sequence\[Sequence\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*] | None] | None*) – The sequence of parameters to calculate only the gradients of the specified parameters. Each sequence of parameters corresponds to a circuit in `circuits`. Defaults to None, which means that the gradients of all parameters in each circuit are calculated. None in the sequence means that the gradients of all parameters in the corresponding circuit are calculated.
+* **options** – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > gradient’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting
+
+**Returns**
+
+The job object of the gradients of the sampling probability. The i-th result corresponds to `circuits[i]` evaluated with parameters bound as `parameter_values[i]`. The j-th quasi-probability distribution in the i-th result corresponds to the gradients of the sampling probability for the j-th parameter in `circuits[i]`.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – Invalid arguments are given.
+
+**Return type**
+
+[AlgorithmJob](qiskit.algorithms.AlgorithmJob "qiskit.algorithms.AlgorithmJob")
+
+### update\_default\_options
+
+
+
+`update_default_options(**options)`
+
+Update the gradient’s default options setting.
+
+**Parameters**
+
+**\*\*options** – The fields to update the default options.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.gradients.ParamShiftEstimatorGradient.md b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.ParamShiftEstimatorGradient.md
new file mode 100644
index 00000000000..8322b6fc9e6
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.ParamShiftEstimatorGradient.md
@@ -0,0 +1,106 @@
+---
+title: ParamShiftEstimatorGradient
+description: API reference for qiskit.algorithms.gradients.ParamShiftEstimatorGradient
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.gradients.ParamShiftEstimatorGradient
+---
+
+# ParamShiftEstimatorGradient
+
+
+
+`qiskit.algorithms.gradients.ParamShiftEstimatorGradient(estimator, options=None, derivative_type=DerivativeType.REAL)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/gradients/param_shift/param_shift_estimator_gradient.py "view source code")
+
+Bases: [`BaseEstimatorGradient`](qiskit.algorithms.gradients.BaseEstimatorGradient "qiskit.algorithms.gradients.base.base_estimator_gradient.BaseEstimatorGradient")
+
+Compute the gradients of the expectation values by the parameter shift rule \[1].
+
+**Reference:** \[1] Schuld, M., Bergholm, V., Gogolin, C., Izaac, J., and Killoran, N. Evaluating analytic gradients on quantum hardware, [DOI](https://doi.org/10.1103/PhysRevA.99.032331)
+
+**Parameters**
+
+* **estimator** ([*BaseEstimator*](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator")) – The estimator used to compute the gradients.
+
+* **options** ([*Options*](qiskit.providers.Options "qiskit.providers.Options") *| None*) – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > gradient’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting
+
+* **derivative\_type** (*DerivativeType*) –
+
+ The type of derivative. Can be either `DerivativeType.REAL` `DerivativeType.IMAG`, or `DerivativeType.COMPLEX`.
+
+ > * `DerivativeType.REAL` computes $2 \mathrm{Re}[⟨ψ(ω)|O(θ)|dω ψ(ω)〉]$.
+ > * `DerivativeType.IMAG` computes $2 \mathrm{Im}[⟨ψ(ω)|O(θ)|dω ψ(ω)〉]$.
+ > * `DerivativeType.COMPLEX` computes $2 ⟨ψ(ω)|O(θ)|dω ψ(ω)〉$.
+
+ Defaults to `DerivativeType.REAL`, as this yields e.g. the commonly-used energy gradient and this type is the only supported type for function-level schemes like finite difference.
+
+## Attributes
+
+
+
+### SUPPORTED\_GATES
+
+`= ['x', 'y', 'z', 'h', 'rx', 'ry', 'rz', 'p', 'cx', 'cy', 'cz', 'ryy', 'rxx', 'rzz', 'rzx']`
+
+
+
+### derivative\_type
+
+Return the derivative type (real, imaginary or complex).
+
+**Returns**
+
+The derivative type.
+
+
+
+### options
+
+Return the union of estimator options setting and gradient default options, where, if the same field is set in both, the gradient’s default options override the primitive’s default setting.
+
+**Returns**
+
+The gradient default + estimator options.
+
+## Methods
+
+### run
+
+
+
+`run(circuits, observables, parameter_values, parameters=None, **options)`
+
+Run the job of the estimator gradient on the given circuits.
+
+**Parameters**
+
+* **circuits** (*Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – The list of quantum circuits to compute the gradients.
+* **observables** (*Sequence\[BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")*]*) – The list of observables.
+* **parameter\_values** (*Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]]*) – The list of parameter values to be bound to the circuit.
+* **parameters** (*Sequence\[Sequence\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*] | None] | None*) – The sequence of parameters to calculate only the gradients of the specified parameters. Each sequence of parameters corresponds to a circuit in `circuits`. Defaults to None, which means that the gradients of all parameters in each circuit are calculated. None in the sequence means that the gradients of all parameters in the corresponding circuit are calculated.
+* **options** – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > gradient’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting
+
+**Returns**
+
+The job object of the gradients of the expectation values. The i-th result corresponds to `circuits[i]` evaluated with parameters bound as `parameter_values[i]`. The j-th element of the i-th result corresponds to the gradient of the i-th circuit with respect to the j-th parameter.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – Invalid arguments are given.
+
+**Return type**
+
+[AlgorithmJob](qiskit.algorithms.AlgorithmJob "qiskit.algorithms.AlgorithmJob")
+
+### update\_default\_options
+
+
+
+`update_default_options(**options)`
+
+Update the gradient’s default options setting.
+
+**Parameters**
+
+**\*\*options** – The fields to update the default options.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.gradients.ParamShiftSamplerGradient.md b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.ParamShiftSamplerGradient.md
new file mode 100644
index 00000000000..b16ba99356d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.ParamShiftSamplerGradient.md
@@ -0,0 +1,84 @@
+---
+title: ParamShiftSamplerGradient
+description: API reference for qiskit.algorithms.gradients.ParamShiftSamplerGradient
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.gradients.ParamShiftSamplerGradient
+---
+
+# ParamShiftSamplerGradient
+
+
+
+`qiskit.algorithms.gradients.ParamShiftSamplerGradient(sampler, options=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/gradients/param_shift/param_shift_sampler_gradient.py "view source code")
+
+Bases: [`BaseSamplerGradient`](qiskit.algorithms.gradients.BaseSamplerGradient "qiskit.algorithms.gradients.base.base_sampler_gradient.BaseSamplerGradient")
+
+Compute the gradients of the sampling probability by the parameter shift rule \[1].
+
+**Reference:** \[1] Schuld, M., Bergholm, V., Gogolin, C., Izaac, J., and Killoran, N. Evaluating analytic gradients on quantum hardware, [DOI](https://doi.org/10.1103/PhysRevA.99.032331)
+
+**Parameters**
+
+* **sampler** ([*BaseSampler*](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler")) – The sampler used to compute the gradients.
+* **options** ([*Options*](qiskit.providers.Options "qiskit.providers.Options") *| None*) – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > gradient’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting
+
+## Attributes
+
+
+
+### SUPPORTED\_GATES
+
+`= ['x', 'y', 'z', 'h', 'rx', 'ry', 'rz', 'p', 'cx', 'cy', 'cz', 'ryy', 'rxx', 'rzz', 'rzx']`
+
+
+
+### options
+
+Return the union of sampler options setting and gradient default options, where, if the same field is set in both, the gradient’s default options override the primitive’s default setting.
+
+**Returns**
+
+The gradient default + sampler options.
+
+## Methods
+
+### run
+
+
+
+`run(circuits, parameter_values, parameters=None, **options)`
+
+Run the job of the sampler gradient on the given circuits.
+
+**Parameters**
+
+* **circuits** (*Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – The list of quantum circuits to compute the gradients.
+* **parameter\_values** (*Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]]*) – The list of parameter values to be bound to the circuit.
+* **parameters** (*Sequence\[Sequence\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*] | None] | None*) – The sequence of parameters to calculate only the gradients of the specified parameters. Each sequence of parameters corresponds to a circuit in `circuits`. Defaults to None, which means that the gradients of all parameters in each circuit are calculated. None in the sequence means that the gradients of all parameters in the corresponding circuit are calculated.
+* **options** – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > gradient’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting
+
+**Returns**
+
+The job object of the gradients of the sampling probability. The i-th result corresponds to `circuits[i]` evaluated with parameters bound as `parameter_values[i]`. The j-th quasi-probability distribution in the i-th result corresponds to the gradients of the sampling probability for the j-th parameter in `circuits[i]`.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – Invalid arguments are given.
+
+**Return type**
+
+[AlgorithmJob](qiskit.algorithms.AlgorithmJob "qiskit.algorithms.AlgorithmJob")
+
+### update\_default\_options
+
+
+
+`update_default_options(**options)`
+
+Update the gradient’s default options setting.
+
+**Parameters**
+
+**\*\*options** – The fields to update the default options.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.gradients.QFI.md b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.QFI.md
new file mode 100644
index 00000000000..f2526b1b2ef
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.QFI.md
@@ -0,0 +1,77 @@
+---
+title: QFI
+description: API reference for qiskit.algorithms.gradients.QFI
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.gradients.QFI
+---
+
+# QFI
+
+
+
+`qiskit.algorithms.gradients.QFI(qgt, options=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/gradients/qfi.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Computes the Quantum Fisher Information (QFI) given a pure, parameterized quantum state. QFI is defined as:
+
+$$
+\mathrm{QFI}_{ij}= 4 \mathrm{Re}[\langle \partial_i \psi | \partial_j \psi \rangle
+- \langle\partial_i \psi | \psi \rangle \langle\psi | \partial_j \psi \rangle].
+$$
+
+**Parameters**
+
+* **qgt** ([*BaseQGT*](qiskit.algorithms.gradients.BaseQGT "qiskit.algorithms.gradients.BaseQGT")) – The quantum geometric tensor used to compute the QFI.
+* **options** ([*Options*](qiskit.providers.Options "qiskit.providers.Options") *| None*) – Backend runtime options used for circuit execution. The order of priority is: options in `run` method > QFI’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting.
+
+## Attributes
+
+
+
+### options
+
+Return the union of QGT’s options setting and QFI’s default options, where, if the same field is set in both, the QFI’s default options override the QGT’s default setting.
+
+**Returns**
+
+The QFI default + QGT options.
+
+## Methods
+
+### run
+
+
+
+`run(circuits, parameter_values, parameters=None, **options)`
+
+Run the job of the QFIs on the given circuits.
+
+**Parameters**
+
+* **circuits** (*Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – The list of quantum circuits to compute the QFIs.
+* **parameter\_values** (*Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]]*) – The list of parameter values to be bound to the circuit.
+* **parameters** (*Sequence\[Sequence\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*] | None] | None*) – The sequence of parameters to calculate only the QFIs of the specified parameters. Each sequence of parameters corresponds to a circuit in `circuits`. Defaults to None, which means that the QFIs of all parameters in each circuit are calculated.
+* **options** – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > QFI’s default options > QGT’s default setting. Higher priority setting overrides lower priority setting.
+
+**Returns**
+
+The job object of the QFIs of the expectation values. The i-th result corresponds to `circuits[i]` evaluated with parameters bound as `parameter_values[i]`.
+
+**Return type**
+
+[AlgorithmJob](qiskit.algorithms.AlgorithmJob "qiskit.algorithms.AlgorithmJob")
+
+### update\_default\_options
+
+
+
+`update_default_options(**options)`
+
+Update the gradient’s default options setting.
+
+**Parameters**
+
+**\*\*options** – The fields to update the default options.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.gradients.QFIResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.QFIResult.md
new file mode 100644
index 00000000000..2508cc38001
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.QFIResult.md
@@ -0,0 +1,44 @@
+---
+title: QFIResult
+description: API reference for qiskit.algorithms.gradients.QFIResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.gradients.QFIResult
+---
+
+# QFIResult
+
+
+
+`qiskit.algorithms.gradients.QFIResult(qfis, metadata, options)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/gradients/qfi_result.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Result of QFI.
+
+## Attributes
+
+
+
+### qfis
+
+`list[numpy.ndarray]`
+
+The QFI.
+
+
+
+### metadata
+
+`list[dict[str, Any]]`
+
+Additional information about the job.
+
+
+
+### options
+
+`Options`
+
+Primitive runtime options for the execution of the job.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.gradients.QGTResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.QGTResult.md
new file mode 100644
index 00000000000..edae6cb653a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.QGTResult.md
@@ -0,0 +1,52 @@
+---
+title: QGTResult
+description: API reference for qiskit.algorithms.gradients.QGTResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.gradients.QGTResult
+---
+
+# QGTResult
+
+
+
+`qiskit.algorithms.gradients.QGTResult(qgts, derivative_type, metadata, options)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/gradients/base/qgt_result.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Result of QGT.
+
+## Attributes
+
+
+
+### qgts
+
+`list[numpy.ndarray]`
+
+The QGT.
+
+
+
+### derivative\_type
+
+`DerivativeType`
+
+The type of derivative.
+
+
+
+### metadata
+
+`list[dict[str, Any]]`
+
+Additional information about the job.
+
+
+
+### options
+
+`Options`
+
+Primitive runtime options for the execution of the job.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.gradients.ReverseEstimatorGradient.md b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.ReverseEstimatorGradient.md
new file mode 100644
index 00000000000..de777e4f0c5
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.ReverseEstimatorGradient.md
@@ -0,0 +1,104 @@
+---
+title: ReverseEstimatorGradient
+description: API reference for qiskit.algorithms.gradients.ReverseEstimatorGradient
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.gradients.ReverseEstimatorGradient
+---
+
+# ReverseEstimatorGradient
+
+
+
+`qiskit.algorithms.gradients.ReverseEstimatorGradient(derivative_type=DerivativeType.REAL)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/gradients/reverse/reverse_gradient.py "view source code")
+
+Bases: [`BaseEstimatorGradient`](qiskit.algorithms.gradients.BaseEstimatorGradient "qiskit.algorithms.gradients.base.base_estimator_gradient.BaseEstimatorGradient")
+
+Estimator gradients with the classically efficient reverse mode.
+
+
+ This gradient implementation is based on statevector manipulations and scales exponentially with the number of qubits. However, for small system sizes it can be very fast compared to circuit-based gradients.
+
+
+This class implements the calculation of the expectation gradient as described in \[1]. By keeping track of two statevectors and iteratively sweeping through each parameterized gate, this method scales only linearly with the number of parameters.
+
+**References:**
+
+> **\[1]: Jones, T. and Gacon, J. “Efficient calculation of gradients in classical simulations**
+>
+> of variational quantum algorithms” (2020). [arXiv:2009.02823](https://arxiv.org/abs/2009.02823).
+
+**Parameters**
+
+**derivative\_type** (*DerivativeType*) – Defines whether the real, imaginary or real plus imaginary part of the gradient is returned.
+
+## Attributes
+
+
+
+### SUPPORTED\_GATES
+
+`= ['rx', 'ry', 'rz', 'cp', 'crx', 'cry', 'crz']`
+
+
+
+### derivative\_type
+
+Return the derivative type (real, imaginary or complex).
+
+**Returns**
+
+The derivative type.
+
+
+
+### options
+
+Return the union of estimator options setting and gradient default options, where, if the same field is set in both, the gradient’s default options override the primitive’s default setting.
+
+**Returns**
+
+The gradient default + estimator options.
+
+## Methods
+
+### run
+
+
+
+`run(circuits, observables, parameter_values, parameters=None, **options)`
+
+Run the job of the estimator gradient on the given circuits.
+
+**Parameters**
+
+* **circuits** (*Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – The list of quantum circuits to compute the gradients.
+* **observables** (*Sequence\[BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")*]*) – The list of observables.
+* **parameter\_values** (*Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]]*) – The list of parameter values to be bound to the circuit.
+* **parameters** (*Sequence\[Sequence\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*] | None] | None*) – The sequence of parameters to calculate only the gradients of the specified parameters. Each sequence of parameters corresponds to a circuit in `circuits`. Defaults to None, which means that the gradients of all parameters in each circuit are calculated. None in the sequence means that the gradients of all parameters in the corresponding circuit are calculated.
+* **options** – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > gradient’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting
+
+**Returns**
+
+The job object of the gradients of the expectation values. The i-th result corresponds to `circuits[i]` evaluated with parameters bound as `parameter_values[i]`. The j-th element of the i-th result corresponds to the gradient of the i-th circuit with respect to the j-th parameter.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – Invalid arguments are given.
+
+**Return type**
+
+[AlgorithmJob](qiskit.algorithms.AlgorithmJob "qiskit.algorithms.AlgorithmJob")
+
+### update\_default\_options
+
+
+
+`update_default_options(**options)`
+
+Update the gradient’s default options setting.
+
+**Parameters**
+
+**\*\*options** – The fields to update the default options.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.gradients.ReverseQGT.md b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.ReverseQGT.md
new file mode 100644
index 00000000000..9ed09abdbcb
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.ReverseQGT.md
@@ -0,0 +1,100 @@
+---
+title: ReverseQGT
+description: API reference for qiskit.algorithms.gradients.ReverseQGT
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.gradients.ReverseQGT
+---
+
+# ReverseQGT
+
+
+
+`qiskit.algorithms.gradients.ReverseQGT(phase_fix=True, derivative_type=DerivativeType.COMPLEX)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/gradients/reverse/reverse_qgt.py "view source code")
+
+Bases: [`BaseQGT`](qiskit.algorithms.gradients.BaseQGT "qiskit.algorithms.gradients.base.base_qgt.BaseQGT")
+
+QGT calculation with the classically efficient reverse mode.
+
+
+ This QGT implementation is based on statevector manipulations and scales exponentially with the number of qubits. However, for small system sizes it can be very fast compared to circuit-based gradients.
+
+
+This class implements the calculation of the QGT as described in \[1]. By keeping track of three statevectors and iteratively sweeping through each parameterized gate, this method scales only quadratically with the number of parameters.
+
+**References:**
+
+> **\[1]: Jones, T. “Efficient classical calculation of the Quantum Natural Gradient” (2020).**
+>
+> [arXiv:2011.02991](https://arxiv.org/abs/2011.02991).
+
+**Parameters**
+
+* **phase\_fix** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether or not to include the phase fix.
+* **derivative\_type** (*DerivativeType*) – Determines whether the complex QGT or only the real or imaginary parts are calculated.
+
+## Attributes
+
+
+
+### SUPPORTED\_GATES
+
+`= ['rx', 'ry', 'rz', 'cp', 'crx', 'cry', 'crz']`
+
+
+
+### derivative\_type
+
+The derivative type.
+
+
+
+### options
+
+There are no options for the reverse QGT, returns an empty options dict.
+
+**Returns**
+
+Empty options.
+
+## Methods
+
+### run
+
+
+
+`run(circuits, parameter_values, parameters=None, **options)`
+
+Run the job of the QGTs on the given circuits.
+
+**Parameters**
+
+* **circuits** (*Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – The list of quantum circuits to compute the QGTs.
+* **parameter\_values** (*Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]]*) – The list of parameter values to be bound to the circuit.
+* **parameters** (*Sequence\[Sequence\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*] | None] | None*) – The sequence of parameters to calculate only the QGTs of the specified parameters. Each sequence of parameters corresponds to a circuit in `circuits`. Defaults to None, which means that the QGTs of all parameters in each circuit are calculated.
+* **options** – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > QGT’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting.
+
+**Returns**
+
+The job object of the QGTs of the expectation values. The i-th result corresponds to `circuits[i]` evaluated with parameters bound as `parameter_values[i]`.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – Invalid arguments are given.
+
+**Return type**
+
+[AlgorithmJob](qiskit.algorithms.AlgorithmJob "qiskit.algorithms.AlgorithmJob")
+
+### update\_default\_options
+
+
+
+`update_default_options(**options)`
+
+Update the gradient’s default options setting.
+
+**Parameters**
+
+**\*\*options** – The fields to update the default options.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.gradients.SPSAEstimatorGradient.md b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.SPSAEstimatorGradient.md
new file mode 100644
index 00000000000..267dce75047
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.SPSAEstimatorGradient.md
@@ -0,0 +1,96 @@
+---
+title: SPSAEstimatorGradient
+description: API reference for qiskit.algorithms.gradients.SPSAEstimatorGradient
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.gradients.SPSAEstimatorGradient
+---
+
+# SPSAEstimatorGradient
+
+
+
+`qiskit.algorithms.gradients.SPSAEstimatorGradient(estimator, epsilon, batch_size=1, seed=None, options=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/gradients/spsa/spsa_estimator_gradient.py "view source code")
+
+Bases: [`BaseEstimatorGradient`](qiskit.algorithms.gradients.BaseEstimatorGradient "qiskit.algorithms.gradients.base.base_estimator_gradient.BaseEstimatorGradient")
+
+Compute the gradients of the expectation value by the Simultaneous Perturbation Stochastic Approximation (SPSA) \[1].
+
+**Reference:** \[1] J. C. Spall, Adaptive stochastic approximation by the simultaneous perturbation method in IEEE Transactions on Automatic Control, vol. 45, no. 10, pp. 1839-1853, Oct 2020, [doi: 10.1109/TAC.2000.880982](https://ieeexplore.ieee.org/document/880982)
+
+**Parameters**
+
+* **estimator** ([*BaseEstimator*](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator")) – The estimator used to compute the gradients.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The offset size for the SPSA gradients.
+* **batch\_size** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of gradients to average.
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The seed for a random perturbation vector.
+* **options** ([*Options*](qiskit.providers.Options "qiskit.providers.Options") *| None*) – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > gradient’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `epsilon` is not positive.
+
+## Attributes
+
+
+
+### derivative\_type
+
+Return the derivative type (real, imaginary or complex).
+
+**Returns**
+
+The derivative type.
+
+
+
+### options
+
+Return the union of estimator options setting and gradient default options, where, if the same field is set in both, the gradient’s default options override the primitive’s default setting.
+
+**Returns**
+
+The gradient default + estimator options.
+
+## Methods
+
+### run
+
+
+
+`run(circuits, observables, parameter_values, parameters=None, **options)`
+
+Run the job of the estimator gradient on the given circuits.
+
+**Parameters**
+
+* **circuits** (*Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – The list of quantum circuits to compute the gradients.
+* **observables** (*Sequence\[BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")*]*) – The list of observables.
+* **parameter\_values** (*Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]]*) – The list of parameter values to be bound to the circuit.
+* **parameters** (*Sequence\[Sequence\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*] | None] | None*) – The sequence of parameters to calculate only the gradients of the specified parameters. Each sequence of parameters corresponds to a circuit in `circuits`. Defaults to None, which means that the gradients of all parameters in each circuit are calculated. None in the sequence means that the gradients of all parameters in the corresponding circuit are calculated.
+* **options** – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > gradient’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting
+
+**Returns**
+
+The job object of the gradients of the expectation values. The i-th result corresponds to `circuits[i]` evaluated with parameters bound as `parameter_values[i]`. The j-th element of the i-th result corresponds to the gradient of the i-th circuit with respect to the j-th parameter.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – Invalid arguments are given.
+
+**Return type**
+
+[AlgorithmJob](qiskit.algorithms.AlgorithmJob "qiskit.algorithms.AlgorithmJob")
+
+### update\_default\_options
+
+
+
+`update_default_options(**options)`
+
+Update the gradient’s default options setting.
+
+**Parameters**
+
+**\*\*options** – The fields to update the default options.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.gradients.SPSASamplerGradient.md b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.SPSASamplerGradient.md
new file mode 100644
index 00000000000..4925431e787
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.SPSASamplerGradient.md
@@ -0,0 +1,85 @@
+---
+title: SPSASamplerGradient
+description: API reference for qiskit.algorithms.gradients.SPSASamplerGradient
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.gradients.SPSASamplerGradient
+---
+
+# SPSASamplerGradient
+
+
+
+`qiskit.algorithms.gradients.SPSASamplerGradient(sampler, epsilon, batch_size=1, seed=None, options=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/gradients/spsa/spsa_sampler_gradient.py "view source code")
+
+Bases: [`BaseSamplerGradient`](qiskit.algorithms.gradients.BaseSamplerGradient "qiskit.algorithms.gradients.base.base_sampler_gradient.BaseSamplerGradient")
+
+Compute the gradients of the sampling probability by the Simultaneous Perturbation Stochastic Approximation (SPSA) \[1].
+
+**Reference:** \[1] J. C. Spall, Adaptive stochastic approximation by the simultaneous perturbation method in IEEE Transactions on Automatic Control, vol. 45, no. 10, pp. 1839-1853, Oct 2020, [doi: 10.1109/TAC.2000.880982](https://ieeexplore.ieee.org/document/880982).
+
+**Parameters**
+
+* **sampler** ([*BaseSampler*](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler")) – The sampler used to compute the gradients.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The offset size for the SPSA gradients.
+* **batch\_size** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of gradients to average.
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The seed for a random perturbation vector.
+* **options** ([*Options*](qiskit.providers.Options "qiskit.providers.Options") *| None*) – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > gradient’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `epsilon` is not positive.
+
+## Attributes
+
+
+
+### options
+
+Return the union of sampler options setting and gradient default options, where, if the same field is set in both, the gradient’s default options override the primitive’s default setting.
+
+**Returns**
+
+The gradient default + sampler options.
+
+## Methods
+
+### run
+
+
+
+`run(circuits, parameter_values, parameters=None, **options)`
+
+Run the job of the sampler gradient on the given circuits.
+
+**Parameters**
+
+* **circuits** (*Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – The list of quantum circuits to compute the gradients.
+* **parameter\_values** (*Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]]*) – The list of parameter values to be bound to the circuit.
+* **parameters** (*Sequence\[Sequence\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*] | None] | None*) – The sequence of parameters to calculate only the gradients of the specified parameters. Each sequence of parameters corresponds to a circuit in `circuits`. Defaults to None, which means that the gradients of all parameters in each circuit are calculated. None in the sequence means that the gradients of all parameters in the corresponding circuit are calculated.
+* **options** – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > gradient’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting
+
+**Returns**
+
+The job object of the gradients of the sampling probability. The i-th result corresponds to `circuits[i]` evaluated with parameters bound as `parameter_values[i]`. The j-th quasi-probability distribution in the i-th result corresponds to the gradients of the sampling probability for the j-th parameter in `circuits[i]`.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – Invalid arguments are given.
+
+**Return type**
+
+[AlgorithmJob](qiskit.algorithms.AlgorithmJob "qiskit.algorithms.AlgorithmJob")
+
+### update\_default\_options
+
+
+
+`update_default_options(**options)`
+
+Update the gradient’s default options setting.
+
+**Parameters**
+
+**\*\*options** – The fields to update the default options.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.gradients.SamplerGradientResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.SamplerGradientResult.md
new file mode 100644
index 00000000000..a1fceb270a5
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.SamplerGradientResult.md
@@ -0,0 +1,44 @@
+---
+title: SamplerGradientResult
+description: API reference for qiskit.algorithms.gradients.SamplerGradientResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.gradients.SamplerGradientResult
+---
+
+# SamplerGradientResult
+
+
+
+`qiskit.algorithms.gradients.SamplerGradientResult(gradients, metadata, options)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/gradients/base/sampler_gradient_result.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Result of SamplerGradient.
+
+## Attributes
+
+
+
+### gradients
+
+`list[list[dict[int, float]]]`
+
+The gradients of the sample probabilities.
+
+
+
+### metadata
+
+`list[dict[str, Any]]`
+
+Additional information about the job.
+
+
+
+### options
+
+`Options`
+
+Primitive runtime options for the execution of the job.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.gradients.md b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.md
new file mode 100644
index 00000000000..d81968d4121
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.gradients.md
@@ -0,0 +1,76 @@
+---
+title: gradients
+description: API reference for qiskit.algorithms.gradients
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.algorithms.gradients
+---
+
+
+
+
+
+# qiskit.algorithms.gradients
+
+
+
+## Gradients
+
+
+
+`qiskit.algorithms.gradients`
+
+### Base Classes
+
+| | |
+| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
+| [`BaseEstimatorGradient`](qiskit.algorithms.gradients.BaseEstimatorGradient "qiskit.algorithms.gradients.BaseEstimatorGradient")(estimator\[, options, ...]) | Base class for an `EstimatorGradient` to compute the gradients of the expectation value. |
+| [`BaseQGT`](qiskit.algorithms.gradients.BaseQGT "qiskit.algorithms.gradients.BaseQGT")(estimator\[, phase\_fix, ...]) | Base class to computes the Quantum Geometric Tensor (QGT) given a pure, parameterized quantum state. |
+| [`BaseSamplerGradient`](qiskit.algorithms.gradients.BaseSamplerGradient "qiskit.algorithms.gradients.BaseSamplerGradient")(sampler\[, options]) | Base class for a `SamplerGradient` to compute the gradients of the sampling probability. |
+| [`EstimatorGradientResult`](qiskit.algorithms.gradients.EstimatorGradientResult "qiskit.algorithms.gradients.EstimatorGradientResult")(gradients, metadata, ...) | Result of EstimatorGradient. |
+| [`SamplerGradientResult`](qiskit.algorithms.gradients.SamplerGradientResult "qiskit.algorithms.gradients.SamplerGradientResult")(gradients, metadata, ...) | Result of SamplerGradient. |
+| [`QGTResult`](qiskit.algorithms.gradients.QGTResult "qiskit.algorithms.gradients.QGTResult")(qgts, derivative\_type, metadata, ...) | Result of QGT. |
+
+### Finite Differences
+
+| | |
+| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
+| [`FiniteDiffEstimatorGradient`](qiskit.algorithms.gradients.FiniteDiffEstimatorGradient "qiskit.algorithms.gradients.FiniteDiffEstimatorGradient")(estimator, epsilon) | Compute the gradients of the expectation values by finite difference method \[1]. |
+| [`FiniteDiffSamplerGradient`](qiskit.algorithms.gradients.FiniteDiffSamplerGradient "qiskit.algorithms.gradients.FiniteDiffSamplerGradient")(sampler, epsilon) | Compute the gradients of the sampling probability by finite difference method \[1]. |
+
+### Linear Combination of Unitaries
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- |
+| [`LinCombEstimatorGradient`](qiskit.algorithms.gradients.LinCombEstimatorGradient "qiskit.algorithms.gradients.LinCombEstimatorGradient")(estimator\[, ...]) | Compute the gradients of the expectation values. |
+| [`LinCombSamplerGradient`](qiskit.algorithms.gradients.LinCombSamplerGradient "qiskit.algorithms.gradients.LinCombSamplerGradient")(sampler\[, options]) | Compute the gradients of the sampling probability. |
+| [`LinCombQGT`](qiskit.algorithms.gradients.LinCombQGT "qiskit.algorithms.gradients.LinCombQGT")(estimator\[, phase\_fix, ...]) | Computes the Quantum Geometric Tensor (QGT) given a pure, parameterized quantum state. |
+
+### Parameter Shift Rules
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
+| [`ParamShiftEstimatorGradient`](qiskit.algorithms.gradients.ParamShiftEstimatorGradient "qiskit.algorithms.gradients.ParamShiftEstimatorGradient")(estimator\[, ...]) | Compute the gradients of the expectation values by the parameter shift rule \[1]. |
+| [`ParamShiftSamplerGradient`](qiskit.algorithms.gradients.ParamShiftSamplerGradient "qiskit.algorithms.gradients.ParamShiftSamplerGradient")(sampler\[, options]) | Compute the gradients of the sampling probability by the parameter shift rule \[1]. |
+
+### Quantum Fisher Information
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| [`QFIResult`](qiskit.algorithms.gradients.QFIResult "qiskit.algorithms.gradients.QFIResult")(qfis, metadata, options) | Result of QFI. |
+| [`QFI`](qiskit.algorithms.gradients.QFI "qiskit.algorithms.gradients.QFI")(qgt\[, options]) | Computes the Quantum Fisher Information (QFI) given a pure, parameterized quantum state. |
+
+### Classical Methods
+
+| | |
+| -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
+| [`ReverseEstimatorGradient`](qiskit.algorithms.gradients.ReverseEstimatorGradient "qiskit.algorithms.gradients.ReverseEstimatorGradient")(\[derivative\_type]) | Estimator gradients with the classically efficient reverse mode. |
+| [`ReverseQGT`](qiskit.algorithms.gradients.ReverseQGT "qiskit.algorithms.gradients.ReverseQGT")(\[phase\_fix, derivative\_type]) | QGT calculation with the classically efficient reverse mode. |
+
+### Simultaneous Perturbation Stochastic Approximation
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
+| [`SPSAEstimatorGradient`](qiskit.algorithms.gradients.SPSAEstimatorGradient "qiskit.algorithms.gradients.SPSAEstimatorGradient")(estimator, epsilon\[, ...]) | Compute the gradients of the expectation value by the Simultaneous Perturbation Stochastic Approximation (SPSA) \[1]. |
+| [`SPSASamplerGradient`](qiskit.algorithms.gradients.SPSASamplerGradient "qiskit.algorithms.gradients.SPSASamplerGradient")(sampler, epsilon\[, ...]) | Compute the gradients of the sampling probability by the Simultaneous Perturbation Stochastic Approximation (SPSA) \[1]. |
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.AdaptVQE.md b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.AdaptVQE.md
new file mode 100644
index 00000000000..2b818c6e3f7
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.AdaptVQE.md
@@ -0,0 +1,143 @@
+---
+title: AdaptVQE
+description: API reference for qiskit.algorithms.minimum_eigensolvers.AdaptVQE
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.minimum_eigensolvers.AdaptVQE
+---
+
+# AdaptVQE
+
+
+
+`qiskit.algorithms.minimum_eigensolvers.AdaptVQE(solver, *, gradient_threshold=1e-05, eigenvalue_threshold=1e-05, max_iterations=None, threshold=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/minimum_eigensolvers/adapt_vqe.py "view source code")
+
+Bases: `VariationalAlgorithm`, [`MinimumEigensolver`](qiskit.algorithms.minimum_eigensolvers.MinimumEigensolver "qiskit.algorithms.minimum_eigensolvers.minimum_eigensolver.MinimumEigensolver")
+
+The Adaptive Variational Quantum Eigensolver algorithm.
+
+[AdaptVQE](https://arxiv.org/abs/1812.11173) is a quantum algorithm which creates a compact ansatz from a set of evolution operators. It iteratively extends the ansatz circuit, by selecting the building block that leads to the largest gradient from a set of candidates. In chemistry, this is usually a list of orbital excitations. Thus, a common choice of ansatz to be used with this algorithm is the Unitary Coupled Cluster ansatz implemented in Qiskit Nature. This results in a wavefunction ansatz which is uniquely adapted to the operator whose minimum eigenvalue is being determined. This class relies on a supplied instance of [`VQE`](qiskit.algorithms.minimum_eigensolvers.VQE "qiskit.algorithms.minimum_eigensolvers.VQE") to find the minimum eigenvalue. The performance of AdaptVQE significantly depends on the minimization routine.
+
+```python
+from qiskit.algorithms.minimum_eigensolvers import AdaptVQE, VQE
+from qiskit.algorithms.optimizers import SLSQP
+from qiskit.primitives import Estimator
+from qiskit.circuit.library import EvolvedOperatorAnsatz
+
+# get your Hamiltonian
+hamiltonian = ...
+
+# construct your ansatz
+ansatz = EvolvedOperatorAnsatz(...)
+
+vqe = VQE(Estimator(), ansatz, SLSQP())
+
+adapt_vqe = AdaptVQE(vqe)
+
+eigenvalue, _ = adapt_vqe.compute_minimum_eigenvalue(hamiltonian)
+```
+
+The following attributes can be set via the initializer but can also be read and updated once the AdaptVQE object has been constructed.
+
+
+
+### solver
+
+a [`VQE`](qiskit.algorithms.minimum_eigensolvers.VQE "qiskit.algorithms.minimum_eigensolvers.VQE") instance used internally to compute the minimum eigenvalues. It is a requirement that the [`ansatz`](qiskit.algorithms.minimum_eigensolvers.VQE#ansatz "qiskit.algorithms.minimum_eigensolvers.VQE.ansatz") of this solver is of type [`EvolvedOperatorAnsatz`](qiskit.circuit.library.EvolvedOperatorAnsatz "qiskit.circuit.library.EvolvedOperatorAnsatz").
+
+
+
+### gradient\_threshold
+
+once all gradients have an absolute value smaller than this threshold, the algorithm has converged and terminates.
+
+
+
+### eigenvalue\_threshold
+
+once the eigenvalue has changed by less than this threshold from one iteration to the next, the algorithm has converged and terminates. When this case occurs, the excitation included in the final iteration did not result in a significant improvement of the eigenvalue and, thus, the results from this iteration are not considered.
+
+
+
+### max\_iterations
+
+the maximum number of iterations for the adaptive loop. If `None`, the algorithm is not bound in its number of iterations.
+
+
+ `qiskit.algorithms.minimum_eigensolvers.adapt_vqe.AdaptVQE.__init__()`’s argument `threshold` is pending deprecation as of qiskit-terra 0.24.0. It will be marked deprecated in a future release, and then removed no earlier than 3 months after the release date. Instead, use the argument `gradient_threshold`, which behaves identically.
+
+
+**Parameters**
+
+* **solver** ([*VQE*](qiskit.algorithms.minimum_eigensolvers.VQE "qiskit.algorithms.minimum_eigensolvers.VQE")) – a [`VQE`](qiskit.algorithms.minimum_eigensolvers.VQE "qiskit.algorithms.minimum_eigensolvers.VQE") instance used internally to compute the minimum eigenvalues. It is a requirement that the [`ansatz`](qiskit.algorithms.minimum_eigensolvers.VQE#ansatz "qiskit.algorithms.minimum_eigensolvers.VQE.ansatz") of this solver is of type [`EvolvedOperatorAnsatz`](qiskit.circuit.library.EvolvedOperatorAnsatz "qiskit.circuit.library.EvolvedOperatorAnsatz").
+* **gradient\_threshold** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – once all gradients have an absolute value smaller than this threshold, the algorithm has converged and terminates.
+* **eigenvalue\_threshold** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – once the eigenvalue has changed by less than this threshold from one iteration to the next, the algorithm has converged and terminates. When this case occurs, the excitation included in the final iteration did not result in a significant improvement of the eigenvalue and, thus, the results from this iteration are not considered.
+* **max\_iterations** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – the maximum number of iterations for the adaptive loop. If `None`, the algorithm is not bound in its number of iterations.
+* **threshold** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – once all gradients have an absolute value smaller than this threshold, the algorithm has converged and terminates. Defaults to `1e-5`.
+
+## Attributes
+
+
+
+### initial\_point
+
+Returns the initial point of the internal [`VQE`](qiskit.algorithms.minimum_eigensolvers.VQE "qiskit.algorithms.minimum_eigensolvers.VQE") solver.
+
+
+
+### threshold
+
+The threshold for the gradients.
+
+Once all gradients have an absolute value smaller than this threshold, the algorithm has converged and terminates.
+
+
+ The property `qiskit.algorithms.minimum_eigensolvers.adapt_vqe.AdaptVQE.threshold` is pending deprecation as of qiskit-terra 0.24.0. It will be marked deprecated in a future release, and then removed no earlier than 3 months after the release date. Instead, use the gradient\_threshold attribute.
+
+
+## Methods
+
+### compute\_minimum\_eigenvalue
+
+
+
+`compute_minimum_eigenvalue(operator, aux_operators=None)`
+
+Computes the minimum eigenvalue.
+
+**Parameters**
+
+* **operator** (*BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")) – Operator whose minimum eigenvalue we want to find.
+* **aux\_operators** (*ListOrDict\[BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")*] | None*) – Additional auxiliary operators to evaluate.
+
+**Raises**
+
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – If an ansatz other than [`EvolvedOperatorAnsatz`](qiskit.circuit.library.EvolvedOperatorAnsatz "qiskit.circuit.library.EvolvedOperatorAnsatz") is provided.
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If all evaluated gradients lie below the convergence threshold in the first iteration of the algorithm.
+
+**Returns**
+
+An [`AdaptVQEResult`](qiskit.algorithms.minimum_eigensolvers.AdaptVQEResult "qiskit.algorithms.minimum_eigensolvers.AdaptVQEResult") which is a [`VQEResult`](qiskit.algorithms.minimum_eigensolvers.VQEResult "qiskit.algorithms.minimum_eigensolvers.VQEResult") but also but also includes runtime information about the AdaptVQE algorithm like the number of iterations, termination criterion, and the final maximum gradient.
+
+**Return type**
+
+[AdaptVQEResult](qiskit.algorithms.minimum_eigensolvers.AdaptVQEResult "qiskit.algorithms.minimum_eigensolvers.AdaptVQEResult")
+
+### supports\_aux\_operators
+
+
+
+`classmethod supports_aux_operators()`
+
+Whether computing the expectation value of auxiliary operators is supported.
+
+If the minimum eigensolver computes an eigenvalue of the main `operator` then it can compute the expectation value of the `aux_operators` for that state. Otherwise they will be ignored.
+
+**Returns**
+
+True if aux\_operator expectations can be evaluated, False otherwise
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.AdaptVQEResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.AdaptVQEResult.md
new file mode 100644
index 00000000000..df1b52a7773
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.AdaptVQEResult.md
@@ -0,0 +1,122 @@
+---
+title: AdaptVQEResult
+description: API reference for qiskit.algorithms.minimum_eigensolvers.AdaptVQEResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.minimum_eigensolvers.AdaptVQEResult
+---
+
+# AdaptVQEResult
+
+
+
+`qiskit.algorithms.minimum_eigensolvers.AdaptVQEResult`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/minimum_eigensolvers/adapt_vqe.py "view source code")
+
+Bases: [`VQEResult`](qiskit.algorithms.minimum_eigensolvers.VQEResult "qiskit.algorithms.minimum_eigensolvers.vqe.VQEResult")
+
+AdaptVQE Result.
+
+## Attributes
+
+
+
+### aux\_operators\_evaluated
+
+The aux operator expectation values.
+
+These values are in fact tuples formatted as (mean, (variance, shots)).
+
+
+
+### cost\_function\_evals
+
+The number of cost optimizer evaluations.
+
+
+
+### eigenvalue
+
+The computed minimum eigenvalue.
+
+
+
+### eigenvalue\_history
+
+Returns the history of computed eigenvalues.
+
+The history’s length matches the number of iterations and includes the final computed value.
+
+
+
+### final\_max\_gradient
+
+Returns the final maximum gradient.
+
+
+
+### num\_iterations
+
+Returns the number of iterations.
+
+
+
+### optimal\_circuit
+
+The optimal circuits. Along with the optimal parameters, these can be used to retrieve the minimum eigenstate.
+
+
+
+### optimal\_parameters
+
+Returns the optimal parameters in a dictionary
+
+
+
+### optimal\_point
+
+Returns optimal point
+
+
+
+### optimal\_value
+
+Returns optimal value
+
+
+
+### optimizer\_evals
+
+Returns number of optimizer evaluations
+
+
+
+### optimizer\_result
+
+Returns the optimizer result
+
+
+
+### optimizer\_time
+
+Returns time taken for optimization
+
+
+
+### termination\_criterion
+
+Returns the termination criterion.
+
+## Methods
+
+### combine
+
+
+
+`combine(result)`
+
+Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Argument is None
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.MinimumEigensolver.md b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.MinimumEigensolver.md
new file mode 100644
index 00000000000..24547fd50b7
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.MinimumEigensolver.md
@@ -0,0 +1,61 @@
+---
+title: MinimumEigensolver
+description: API reference for qiskit.algorithms.minimum_eigensolvers.MinimumEigensolver
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.minimum_eigensolvers.MinimumEigensolver
+---
+
+# MinimumEigensolver
+
+
+
+`qiskit.algorithms.minimum_eigensolvers.MinimumEigensolver`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/minimum_eigensolvers/minimum_eigensolver.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+The minimum eigensolver interface.
+
+Algorithms that can compute a minimum eigenvalue for an operator may implement this interface to allow different algorithms to be used interchangeably.
+
+## Methods
+
+### compute\_minimum\_eigenvalue
+
+
+
+`abstract compute_minimum_eigenvalue(operator, aux_operators=None)`
+
+Computes the minimum eigenvalue. The `operator` and `aux_operators` are supplied here. While an `operator` is required by algorithms, `aux_operators` are optional.
+
+**Parameters**
+
+* **operator** (*BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")) – Qubit operator of the observable.
+* **aux\_operators** (*ListOrDict\[BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")*] | None*) – Optional list of auxiliary operators to be evaluated with the parameters of the minimum eigenvalue main result and their expectation values returned. For instance in chemistry these can be dipole operators and total particle count operators, so we can get values for these at the ground state.
+
+**Returns**
+
+A minimum eigensolver result.
+
+**Return type**
+
+[MinimumEigensolverResult](qiskit.algorithms.minimum_eigensolvers.MinimumEigensolverResult "qiskit.algorithms.minimum_eigensolvers.MinimumEigensolverResult")
+
+### supports\_aux\_operators
+
+
+
+`classmethod supports_aux_operators()`
+
+Whether computing the expectation value of auxiliary operators is supported.
+
+If the minimum eigensolver computes an eigenvalue of the main `operator` then it can compute the expectation value of the `aux_operators` for that state. Otherwise they will be ignored.
+
+**Returns**
+
+True if aux\_operator expectations can be evaluated, False otherwise
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.MinimumEigensolverResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.MinimumEigensolverResult.md
new file mode 100644
index 00000000000..f266555b086
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.MinimumEigensolverResult.md
@@ -0,0 +1,48 @@
+---
+title: MinimumEigensolverResult
+description: API reference for qiskit.algorithms.minimum_eigensolvers.MinimumEigensolverResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.minimum_eigensolvers.MinimumEigensolverResult
+---
+
+# MinimumEigensolverResult
+
+
+
+`qiskit.algorithms.minimum_eigensolvers.MinimumEigensolverResult`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/minimum_eigensolvers/minimum_eigensolver.py "view source code")
+
+Bases: `AlgorithmResult`
+
+Minimum eigensolver result.
+
+## Attributes
+
+
+
+### aux\_operators\_evaluated
+
+The aux operator expectation values.
+
+These values are in fact tuples formatted as (mean, (variance, shots)).
+
+
+
+### eigenvalue
+
+The computed minimum eigenvalue.
+
+## Methods
+
+### combine
+
+
+
+`combine(result)`
+
+Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Argument is None
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolver.md b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolver.md
new file mode 100644
index 00000000000..241eb954e2b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolver.md
@@ -0,0 +1,71 @@
+---
+title: NumPyMinimumEigensolver
+description: API reference for qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolver
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolver
+---
+
+# NumPyMinimumEigensolver
+
+
+
+`qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolver(filter_criterion=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/minimum_eigensolvers/numpy_minimum_eigensolver.py "view source code")
+
+Bases: [`MinimumEigensolver`](qiskit.algorithms.minimum_eigensolvers.MinimumEigensolver "qiskit.algorithms.minimum_eigensolvers.minimum_eigensolver.MinimumEigensolver")
+
+The NumPy minimum eigensolver algorithm.
+
+**Parameters**
+
+**filter\_criterion** (*FilterType | None*) – Callable that allows to filter eigenvalues/eigenstates. The minimum eigensolver is only searching over feasible states and returns an eigenstate that has the smallest eigenvalue among feasible states. The callable has the signature `filter(eigenstate, eigenvalue, aux_values)` and must return a boolean to indicate whether to consider this value or not. If there is no feasible element, the result can even be empty.
+
+## Attributes
+
+
+
+### filter\_criterion
+
+Returns the criterion for filtering eigenstates/eigenvalues.
+
+## Methods
+
+### compute\_minimum\_eigenvalue
+
+
+
+`compute_minimum_eigenvalue(operator, aux_operators=None)`
+
+Computes the minimum eigenvalue. The `operator` and `aux_operators` are supplied here. While an `operator` is required by algorithms, `aux_operators` are optional.
+
+**Parameters**
+
+* **operator** (*BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")) – Qubit operator of the observable.
+* **aux\_operators** (*ListOrDict\[BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")*] | None*) – Optional list of auxiliary operators to be evaluated with the parameters of the minimum eigenvalue main result and their expectation values returned. For instance in chemistry these can be dipole operators and total particle count operators, so we can get values for these at the ground state.
+
+**Returns**
+
+A minimum eigensolver result.
+
+**Return type**
+
+[NumPyMinimumEigensolverResult](qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolverResult "qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolverResult")
+
+### supports\_aux\_operators
+
+
+
+`classmethod supports_aux_operators()`
+
+Whether computing the expectation value of auxiliary operators is supported.
+
+If the minimum eigensolver computes an eigenvalue of the main `operator` then it can compute the expectation value of the `aux_operators` for that state. Otherwise they will be ignored.
+
+**Returns**
+
+True if aux\_operator expectations can be evaluated, False otherwise
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolverResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolverResult.md
new file mode 100644
index 00000000000..f069d8c2da4
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolverResult.md
@@ -0,0 +1,54 @@
+---
+title: NumPyMinimumEigensolverResult
+description: API reference for qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolverResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolverResult
+---
+
+# NumPyMinimumEigensolverResult
+
+
+
+`qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolverResult`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/minimum_eigensolvers/numpy_minimum_eigensolver.py "view source code")
+
+Bases: [`MinimumEigensolverResult`](qiskit.algorithms.minimum_eigensolvers.MinimumEigensolverResult "qiskit.algorithms.minimum_eigensolvers.minimum_eigensolver.MinimumEigensolverResult")
+
+NumPy minimum eigensolver result.
+
+## Attributes
+
+
+
+### aux\_operators\_evaluated
+
+The aux operator expectation values.
+
+These values are in fact tuples formatted as (mean, (variance, shots)).
+
+
+
+### eigenstate
+
+Returns the eigenstate corresponding to the computed minimum eigenvalue.
+
+
+
+### eigenvalue
+
+The computed minimum eigenvalue.
+
+## Methods
+
+### combine
+
+
+
+`combine(result)`
+
+Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Argument is None
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.QAOA.md b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.QAOA.md
new file mode 100644
index 00000000000..eaa30f6196f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.QAOA.md
@@ -0,0 +1,172 @@
+---
+title: QAOA
+description: API reference for qiskit.algorithms.minimum_eigensolvers.QAOA
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.minimum_eigensolvers.QAOA
+---
+
+# QAOA
+
+
+
+`qiskit.algorithms.minimum_eigensolvers.QAOA(sampler, optimizer, *, reps=1, initial_state=None, mixer=None, initial_point=None, aggregation=None, callback=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/minimum_eigensolvers/qaoa.py "view source code")
+
+Bases: [`SamplingVQE`](qiskit.algorithms.minimum_eigensolvers.SamplingVQE "qiskit.algorithms.minimum_eigensolvers.sampling_vqe.SamplingVQE")
+
+The Quantum Approximate Optimization Algorithm (QAOA).
+
+QAOA is a well-known algorithm for finding approximate solutions to combinatorial-optimization problems \[1].
+
+The QAOA implementation directly extends [`SamplingVQE`](qiskit.algorithms.minimum_eigensolvers.SamplingVQE "qiskit.algorithms.minimum_eigensolvers.SamplingVQE") and inherits its optimization structure. However, unlike VQE, which can be configured with arbitrary ansatzes, QAOA uses its own fine-tuned ansatz, which comprises $p$ parameterized global $x$ rotations and $p$ different parameterizations of the problem hamiltonian. QAOA is thus principally configured by the single integer parameter, `reps`, which dictates the depth of the ansatz, and thus affects the approximation quality.
+
+An optional array of $2p$ parameter values, as the [`initial_point`](#qiskit.algorithms.minimum_eigensolvers.QAOA.initial_point "qiskit.algorithms.minimum_eigensolvers.QAOA.initial_point"), may be provided as the starting $\beta$ and $\gamma$ parameters for the QAOA ansatz \[1].
+
+An operator or a parameterized quantum circuit may optionally also be provided as a custom [`mixer`](#qiskit.algorithms.minimum_eigensolvers.QAOA.mixer "qiskit.algorithms.minimum_eigensolvers.QAOA.mixer") Hamiltonian. This allows in the case of quantum annealing \[2] and QAOA \[3], to run constrained optimization problems where the mixer constrains the evolution to a feasible subspace of the full Hilbert space.
+
+The following attributes can be set via the initializer but can also be read and updated once the QAOA object has been constructed.
+
+
+
+### sampler
+
+The sampler primitive to sample the circuits.
+
+**Type**
+
+[BaseSampler](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler")
+
+
+
+### optimizer
+
+A classical optimizer to find the minimum energy. This can either be a Qiskit [`Optimizer`](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer") or a callable implementing the [`Minimizer`](qiskit.algorithms.optimizers.Minimizer "qiskit.algorithms.optimizers.Minimizer") protocol.
+
+**Type**
+
+[Optimizer](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer") | [Minimizer](qiskit.algorithms.optimizers.Minimizer "qiskit.algorithms.optimizers.Minimizer")
+
+
+
+### reps
+
+The integer parameter $p$. Has a minimum valid value of 1.
+
+**Type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### initial\_state
+
+An optional initial state to prepend the QAOA circuit with.
+
+
+
+### mixer
+
+The mixer Hamiltonian to evolve with or a custom quantum circuit. Allows support of optimizations in constrained subspaces \[2, 3] as well as warm-starting the optimization \[4].
+
+**Type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") | BaseOperator | [PauliSumOp](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")
+
+
+
+### aggregation
+
+A float or callable to specify how the objective function evaluated on the basis states should be aggregated. If a float, this specifies the $\alpha \in [0,1]$ parameter for a CVaR expectation value.
+
+**Type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") | Callable\[\[[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")]], [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")] | None
+
+
+
+### callback
+
+A callback that can access the intermediate data at each optimization step. These data are: the evaluation count, the optimizer parameters for the ansatz, the evaluated value, the the metadata dictionary, and the best measurement.
+
+**Type**
+
+Callable\[\[[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)"), np.ndarray, [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)"), [dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)"), Any]], None] | None
+
+**References**
+
+**\[1]: Farhi, E., Goldstone, J., Gutmann, S., “A Quantum Approximate Optimization Algorithm”**
+
+[arXiv:1411.4028](https://arxiv.org/abs/1411.4028)
+
+**\[2]: Hen, I., Spedalieri, F. M., “Quantum Annealing for Constrained Optimization”**
+
+[PhysRevApplied.5.034007](https://doi.org/10.1103/PhysRevApplied.5.034007)
+
+**\[3]: Hadfield, S. et al, “From the Quantum Approximate Optimization Algorithm to a Quantum**
+
+Alternating Operator Ansatz” [arXiv:1709.03489](https://arxiv.org/abs/1709.03489)
+
+**\[4]: Egger, D. J., Marecek, J., Woerner, S., “Warm-starting quantum optimization”**
+
+[arXiv: 2009.10095](https://arxiv.org/abs/2009.10095)
+
+**Parameters**
+
+* **sampler** ([*BaseSampler*](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler")) – The sampler primitive to sample the circuits.
+* **optimizer** ([*Optimizer*](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer") *|*[*Minimizer*](qiskit.algorithms.optimizers.Minimizer "qiskit.algorithms.optimizers.Minimizer")) – A classical optimizer to find the minimum energy. This can either be a Qiskit [`Optimizer`](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer") or a callable implementing the [`Minimizer`](qiskit.algorithms.optimizers.Minimizer "qiskit.algorithms.optimizers.Minimizer") protocol.
+* **reps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The integer parameter $p$. Has a minimum valid value of 1.
+* **initial\_state** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| None*) – An optional initial state to prepend the QAOA circuit with.
+* **mixer** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| BaseOperator |*[*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")) – The mixer Hamiltonian to evolve with or a custom quantum circuit. Allows support of optimizations in constrained subspaces \[2, 3] as well as warm-starting the optimization \[4].
+* **initial\_point** (*np.ndarray | None*) – An optional initial point (i.e. initial parameter values) for the optimizer. The length of the initial point must match the number of `ansatz` parameters. If `None`, a random point will be generated within certain parameter bounds. `QAOA` will look to the ansatz for these bounds. If the ansatz does not specify bounds, bounds of $-2\pi$, $2\pi$ will be used.
+* **aggregation** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| Callable\[\[*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – A float or callable to specify how the objective function evaluated on the basis states should be aggregated. If a float, this specifies the $\alpha \in [0,1]$ parameter for a CVaR expectation value.
+* **callback** (*Callable\[\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*, np.ndarray,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*, Any]], None] | None*) – A callback that can access the intermediate data at each optimization step. These data are: the evaluation count, the optimizer parameters for the ansatz, the evaluated value, the metadata dictionary.
+
+## Attributes
+
+
+
+### initial\_point
+
+Return the initial point.
+
+## Methods
+
+### compute\_minimum\_eigenvalue
+
+
+
+`compute_minimum_eigenvalue(operator, aux_operators=None)`
+
+Compute the minimum eigenvalue of a diagonal operator.
+
+**Parameters**
+
+* **operator** (*BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")) – Diagonal qubit operator.
+* **aux\_operators** (*ListOrDict\[BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")*] | None*) – Optional list of auxiliary operators to be evaluated with the final state.
+
+**Returns**
+
+A [`SamplingMinimumEigensolverResult`](qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolverResult "qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolverResult") containing the optimization result.
+
+**Return type**
+
+[SamplingMinimumEigensolverResult](qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolverResult "qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolverResult")
+
+### supports\_aux\_operators
+
+
+
+`classmethod supports_aux_operators()`
+
+Whether computing the expectation value of auxiliary operators is supported.
+
+If the minimum eigensolver computes an eigenstate of the main operator then it can compute the expectation value of the aux\_operators for that state. Otherwise they will be ignored.
+
+**Returns**
+
+True if aux\_operator expectations can be evaluated, False otherwise
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolver.md b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolver.md
new file mode 100644
index 00000000000..9e5c8a06871
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolver.md
@@ -0,0 +1,59 @@
+---
+title: SamplingMinimumEigensolver
+description: API reference for qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolver
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolver
+---
+
+# SamplingMinimumEigensolver
+
+
+
+`qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolver`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/minimum_eigensolvers/sampling_mes.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+The Sampling Minimum Eigensolver Interface.
+
+## Methods
+
+### compute\_minimum\_eigenvalue
+
+
+
+`abstract compute_minimum_eigenvalue(operator, aux_operators=None)`
+
+Compute the minimum eigenvalue of a diagonal operator.
+
+**Parameters**
+
+* **operator** (*BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")) – Diagonal qubit operator.
+* **aux\_operators** (*ListOrDict\[BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")*] | None*) – Optional list of auxiliary operators to be evaluated with the final state.
+
+**Returns**
+
+A [`SamplingMinimumEigensolverResult`](qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolverResult "qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolverResult") containing the optimization result.
+
+**Return type**
+
+[SamplingMinimumEigensolverResult](qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolverResult "qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolverResult")
+
+### supports\_aux\_operators
+
+
+
+`classmethod supports_aux_operators()`
+
+Whether computing the expectation value of auxiliary operators is supported.
+
+If the minimum eigensolver computes an eigenstate of the main operator then it can compute the expectation value of the aux\_operators for that state. Otherwise they will be ignored.
+
+**Returns**
+
+True if aux\_operator expectations can be evaluated, False otherwise
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolverResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolverResult.md
new file mode 100644
index 00000000000..7151188f85a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolverResult.md
@@ -0,0 +1,66 @@
+---
+title: SamplingMinimumEigensolverResult
+description: API reference for qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolverResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolverResult
+---
+
+# SamplingMinimumEigensolverResult
+
+
+
+`qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolverResult`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/minimum_eigensolvers/sampling_mes.py "view source code")
+
+Bases: `AlgorithmResult`
+
+Sampling Minimum Eigensolver Result.
+
+In contrast to the result of a `MinimumEigenSolver`, this result also contains the best measurement of the overall optimization and the samples of the final state.
+
+## Attributes
+
+
+
+### aux\_operators\_evaluated
+
+Return aux operator expectation values and metadata.
+
+These are formatted as (mean, metadata).
+
+
+
+### best\_measurement
+
+Return the best measurement over the entire optimization.
+
+Possesses keys: `state`, `bitstring`, `value`, `probability`.
+
+
+
+### eigenstate
+
+Return the quasi-distribution sampled from the final state.
+
+The ansatz is sampled when parameterized with the optimal parameters that where obtained computing the minimum eigenvalue. The keys represent a measured classical value and the value is a float for the quasi-probability of that result.
+
+
+
+### eigenvalue
+
+Return the approximation to the eigenvalue.
+
+## Methods
+
+### combine
+
+
+
+`combine(result)`
+
+Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Argument is None
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.SamplingVQE.md b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.SamplingVQE.md
new file mode 100644
index 00000000000..111a7b339d0
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.SamplingVQE.md
@@ -0,0 +1,168 @@
+---
+title: SamplingVQE
+description: API reference for qiskit.algorithms.minimum_eigensolvers.SamplingVQE
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.minimum_eigensolvers.SamplingVQE
+---
+
+# SamplingVQE
+
+
+
+`qiskit.algorithms.minimum_eigensolvers.SamplingVQE(sampler, ansatz, optimizer, *, initial_point=None, aggregation=None, callback=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/minimum_eigensolvers/sampling_vqe.py "view source code")
+
+Bases: `VariationalAlgorithm`, [`SamplingMinimumEigensolver`](qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolver "qiskit.algorithms.minimum_eigensolvers.sampling_mes.SamplingMinimumEigensolver")
+
+The Variational Quantum Eigensolver algorithm, optimized for diagonal Hamiltonians.
+
+VQE is a hybrid quantum-classical algorithm that uses a variational technique to find the minimum eigenvalue of a given diagonal Hamiltonian operator $H_{\text{diag}}$.
+
+In contrast to the [`VQE`](qiskit.algorithms.minimum_eigensolvers.VQE "qiskit.algorithms.minimum_eigensolvers.VQE") class, the `SamplingVQE` algorithm is executed using a [`sampler`](#qiskit.algorithms.minimum_eigensolvers.SamplingVQE.sampler "qiskit.algorithms.minimum_eigensolvers.SamplingVQE.sampler") primitive.
+
+An instance of `SamplingVQE` also requires an [`ansatz`](#qiskit.algorithms.minimum_eigensolvers.SamplingVQE.ansatz "qiskit.algorithms.minimum_eigensolvers.SamplingVQE.ansatz"), a parameterized [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), to prepare the trial state $|\psi(\vec\theta)\rangle$. It also needs a classical [`optimizer`](#qiskit.algorithms.minimum_eigensolvers.SamplingVQE.optimizer "qiskit.algorithms.minimum_eigensolvers.SamplingVQE.optimizer") which varies the circuit parameters $\vec\theta$ to minimize the objective function, which depends on the chosen [`aggregation`](#qiskit.algorithms.minimum_eigensolvers.SamplingVQE.aggregation "qiskit.algorithms.minimum_eigensolvers.SamplingVQE.aggregation").
+
+The optimizer can either be one of Qiskit’s optimizers, such as [`SPSA`](qiskit.algorithms.optimizers.SPSA "qiskit.algorithms.optimizers.SPSA") or a callable with the following signature:
+
+```python
+from qiskit.algorithms.optimizers import OptimizerResult
+
+def my_minimizer(fun, x0, jac=None, bounds=None) -> OptimizerResult:
+ # Note that the callable *must* have these argument names!
+ # Args:
+ # fun (callable): the function to minimize
+ # x0 (np.ndarray): the initial point for the optimization
+ # jac (callable, optional): the gradient of the objective function
+ # bounds (list, optional): a list of tuples specifying the parameter bounds
+
+ result = OptimizerResult()
+ result.x = # optimal parameters
+ result.fun = # optimal function value
+ return result
+```
+
+The above signature also allows one to use any SciPy minimizer, for instance as
+
+```python
+from functools import partial
+from scipy.optimize import minimize
+
+optimizer = partial(minimize, method="L-BFGS-B")
+```
+
+The following attributes can be set via the initializer but can also be read and updated once the `SamplingVQE` object has been constructed.
+
+
+
+### sampler
+
+The sampler primitive to sample the circuits.
+
+**Type**
+
+[BaseSampler](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler")
+
+
+
+### ansatz
+
+A parameterized quantum circuit to prepare the trial state.
+
+**Type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+
+
+### optimizer
+
+A classical optimizer to find the minimum energy. This can either be a Qiskit [`Optimizer`](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer") or a callable implementing the [`Minimizer`](qiskit.algorithms.optimizers.Minimizer "qiskit.algorithms.optimizers.Minimizer") protocol.
+
+**Type**
+
+[Optimizer](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer") | [Minimizer](qiskit.algorithms.optimizers.Minimizer "qiskit.algorithms.optimizers.Minimizer")
+
+
+
+### aggregation
+
+A float or callable to specify how the objective function evaluated on the basis states should be aggregated. If a float, this specifies the $\alpha \in [0,1]$ parameter for a CVaR expectation value \[1]. If a callable, it takes a list of basis state measurements specified as `[(probability, objective_value)]` and return an objective value as float. If None, all an ordinary expectation value is calculated.
+
+**Type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") | Callable\[\[[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)"), [complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")]], [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")] | None
+
+
+
+### callback
+
+A callback that can access the intermediate data at each optimization step. These data are: the evaluation count, the optimizer parameters for the ansatz, the evaluated value, and the metadata dictionary.
+
+**Type**
+
+Callable\[\[[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)"), np.ndarray, [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)"), [dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)"), Any]], None] | None
+
+**References**
+
+**\[1]: Barkoutsos, P. K., Nannicini, G., Robert, A., Tavernelli, I., and Woerner, S.,**
+
+“Improving Variational Quantum Optimization using CVaR” [arXiv:1907.04769](https://arxiv.org/abs/1907.04769)
+
+**Parameters**
+
+* **sampler** ([*BaseSampler*](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler")) – The sampler primitive to sample the circuits.
+* **ansatz** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – A parameterized quantum circuit to prepare the trial state.
+* **optimizer** ([*Optimizer*](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer") *|*[*Minimizer*](qiskit.algorithms.optimizers.Minimizer "qiskit.algorithms.optimizers.Minimizer")) – A classical optimizer to find the minimum energy. This can either be a Qiskit [`Optimizer`](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer") or a callable implementing the [`Minimizer`](qiskit.algorithms.optimizers.Minimizer "qiskit.algorithms.optimizers.Minimizer") protocol.
+* **initial\_point** (*Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – An optional initial point (i.e. initial parameter values) for the optimizer. The length of the initial point must match the number of [`ansatz`](#qiskit.algorithms.minimum_eigensolvers.SamplingVQE.ansatz "qiskit.algorithms.minimum_eigensolvers.SamplingVQE.ansatz") parameters. If `None`, a random point will be generated within certain parameter bounds. `SamplingVQE` will look to the ansatz for these bounds. If the ansatz does not specify bounds, bounds of $-2\pi$, $2\pi$ will be used.
+* **aggregation** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| Callable\[\[*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – A float or callable to specify how the objective function evaluated on the basis states should be aggregated.
+* **callback** (*Callable\[\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*, np.ndarray,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*, Any]], None] | None*) – A callback that can access the intermediate data at each optimization step. These data are: the evaluation count, the optimizer parameters for the ansatz, the estimated value, and the metadata dictionary.
+
+## Attributes
+
+
+
+### initial\_point
+
+Return the initial point.
+
+## Methods
+
+### compute\_minimum\_eigenvalue
+
+
+
+`compute_minimum_eigenvalue(operator, aux_operators=None)`
+
+Compute the minimum eigenvalue of a diagonal operator.
+
+**Parameters**
+
+* **operator** (*BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")) – Diagonal qubit operator.
+* **aux\_operators** (*ListOrDict\[BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")*] | None*) – Optional list of auxiliary operators to be evaluated with the final state.
+
+**Returns**
+
+A [`SamplingMinimumEigensolverResult`](qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolverResult "qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolverResult") containing the optimization result.
+
+**Return type**
+
+[SamplingMinimumEigensolverResult](qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolverResult "qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolverResult")
+
+### supports\_aux\_operators
+
+
+
+`classmethod supports_aux_operators()`
+
+Whether computing the expectation value of auxiliary operators is supported.
+
+If the minimum eigensolver computes an eigenstate of the main operator then it can compute the expectation value of the aux\_operators for that state. Otherwise they will be ignored.
+
+**Returns**
+
+True if aux\_operator expectations can be evaluated, False otherwise
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult.md
new file mode 100644
index 00000000000..7d26c4b94bd
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult.md
@@ -0,0 +1,112 @@
+---
+title: SamplingVQEResult
+description: API reference for qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult
+---
+
+# SamplingVQEResult
+
+
+
+`qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/minimum_eigensolvers/sampling_vqe.py "view source code")
+
+Bases: `VariationalResult`, [`SamplingMinimumEigensolverResult`](qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolverResult "qiskit.algorithms.minimum_eigensolvers.sampling_mes.SamplingMinimumEigensolverResult")
+
+VQE Result.
+
+## Attributes
+
+
+
+### aux\_operators\_evaluated
+
+Return aux operator expectation values and metadata.
+
+These are formatted as (mean, metadata).
+
+
+
+### best\_measurement
+
+Return the best measurement over the entire optimization.
+
+Possesses keys: `state`, `bitstring`, `value`, `probability`.
+
+
+
+### cost\_function\_evals
+
+Returns number of cost optimizer evaluations
+
+
+
+### eigenstate
+
+Return the quasi-distribution sampled from the final state.
+
+The ansatz is sampled when parameterized with the optimal parameters that where obtained computing the minimum eigenvalue. The keys represent a measured classical value and the value is a float for the quasi-probability of that result.
+
+
+
+### eigenvalue
+
+Return the approximation to the eigenvalue.
+
+
+
+### optimal\_circuit
+
+The optimal circuits. Along with the optimal parameters, these can be used to retrieve the minimum eigenstate.
+
+
+
+### optimal\_parameters
+
+Returns the optimal parameters in a dictionary
+
+
+
+### optimal\_point
+
+Returns optimal point
+
+
+
+### optimal\_value
+
+Returns optimal value
+
+
+
+### optimizer\_evals
+
+Returns number of optimizer evaluations
+
+
+
+### optimizer\_result
+
+Returns the optimizer result
+
+
+
+### optimizer\_time
+
+Returns time taken for optimization
+
+## Methods
+
+### combine
+
+
+
+`combine(result)`
+
+Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Argument is None
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.VQE.md b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.VQE.md
new file mode 100644
index 00000000000..cf602d09778
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.VQE.md
@@ -0,0 +1,172 @@
+---
+title: VQE
+description: API reference for qiskit.algorithms.minimum_eigensolvers.VQE
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.minimum_eigensolvers.VQE
+---
+
+# VQE
+
+
+
+`qiskit.algorithms.minimum_eigensolvers.VQE(estimator, ansatz, optimizer, *, gradient=None, initial_point=None, callback=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/minimum_eigensolvers/vqe.py "view source code")
+
+Bases: `VariationalAlgorithm`, [`MinimumEigensolver`](qiskit.algorithms.minimum_eigensolvers.MinimumEigensolver "qiskit.algorithms.minimum_eigensolvers.minimum_eigensolver.MinimumEigensolver")
+
+The variational quantum eigensolver (VQE) algorithm.
+
+VQE is a hybrid quantum-classical algorithm that uses a variational technique to find the minimum eigenvalue of a given Hamiltonian operator $H$.
+
+The `VQE` algorithm is executed using an [`estimator`](#qiskit.algorithms.minimum_eigensolvers.VQE.estimator "qiskit.algorithms.minimum_eigensolvers.VQE.estimator") primitive, which computes expectation values of operators (observables).
+
+An instance of `VQE` also requires an [`ansatz`](#qiskit.algorithms.minimum_eigensolvers.VQE.ansatz "qiskit.algorithms.minimum_eigensolvers.VQE.ansatz"), a parameterized [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), to prepare the trial state $|\psi(\vec\theta)\rangle$. It also needs a classical [`optimizer`](#qiskit.algorithms.minimum_eigensolvers.VQE.optimizer "qiskit.algorithms.minimum_eigensolvers.VQE.optimizer") which varies the circuit parameters $\vec\theta$ such that the expectation value of the operator on the corresponding state approaches a minimum,
+
+$$
+\min_{\vec\theta} \langle\psi(\vec\theta)|H|\psi(\vec\theta)\rangle.
+$$
+
+The [`estimator`](#qiskit.algorithms.minimum_eigensolvers.VQE.estimator "qiskit.algorithms.minimum_eigensolvers.VQE.estimator") is used to compute this expectation value for every optimization step.
+
+The optimizer can either be one of Qiskit’s optimizers, such as [`SPSA`](qiskit.algorithms.optimizers.SPSA "qiskit.algorithms.optimizers.SPSA") or a callable with the following signature:
+
+```python
+from qiskit.algorithms.optimizers import OptimizerResult
+
+def my_minimizer(fun, x0, jac=None, bounds=None) -> OptimizerResult:
+ # Note that the callable *must* have these argument names!
+ # Args:
+ # fun (callable): the function to minimize
+ # x0 (np.ndarray): the initial point for the optimization
+ # jac (callable, optional): the gradient of the objective function
+ # bounds (list, optional): a list of tuples specifying the parameter bounds
+
+ result = OptimizerResult()
+ result.x = # optimal parameters
+ result.fun = # optimal function value
+ return result
+```
+
+The above signature also allows one to use any SciPy minimizer, for instance as
+
+```python
+from functools import partial
+from scipy.optimize import minimize
+
+optimizer = partial(minimize, method="L-BFGS-B")
+```
+
+The following attributes can be set via the initializer but can also be read and updated once the VQE object has been constructed.
+
+
+
+### estimator
+
+The estimator primitive to compute the expectation value of the Hamiltonian operator.
+
+**Type**
+
+[BaseEstimator](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator")
+
+
+
+### ansatz
+
+A parameterized quantum circuit to prepare the trial state.
+
+**Type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+
+
+### optimizer
+
+A classical optimizer to find the minimum energy. This can either be a Qiskit [`Optimizer`](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer") or a callable implementing the [`Minimizer`](qiskit.algorithms.optimizers.Minimizer "qiskit.algorithms.optimizers.Minimizer") protocol.
+
+**Type**
+
+[Optimizer](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer") | [Minimizer](qiskit.algorithms.optimizers.Minimizer "qiskit.algorithms.optimizers.Minimizer")
+
+
+
+### gradient
+
+An optional estimator gradient to be used with the optimizer.
+
+**Type**
+
+[BaseEstimatorGradient](qiskit.algorithms.gradients.BaseEstimatorGradient "qiskit.algorithms.gradients.BaseEstimatorGradient") | None
+
+
+
+### callback
+
+A callback that can access the intermediate data at each optimization step. These data are: the evaluation count, the optimizer parameters for the ansatz, the evaluated mean, and the metadata dictionary.
+
+**Type**
+
+Callable\[\[[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)"), np.ndarray, [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)"), [dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)"), Any]], None] | None
+
+**References**
+
+**\[1]: Peruzzo, A., et al, “A variational eigenvalue solver on a quantum processor”**
+
+[arXiv:1304.3061](https://arxiv.org/abs/1304.3061)
+
+**Parameters**
+
+* **estimator** ([*BaseEstimator*](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator")) – The estimator primitive to compute the expectation value of the Hamiltonian operator.
+* **ansatz** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – A parameterized quantum circuit to prepare the trial state.
+* **optimizer** ([*Optimizer*](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer") *|*[*Minimizer*](qiskit.algorithms.optimizers.Minimizer "qiskit.algorithms.optimizers.Minimizer")) – A classical optimizer to find the minimum energy. This can either be a Qiskit [`Optimizer`](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer") or a callable implementing the [`Minimizer`](qiskit.algorithms.optimizers.Minimizer "qiskit.algorithms.optimizers.Minimizer") protocol.
+* **gradient** ([*BaseEstimatorGradient*](qiskit.algorithms.gradients.BaseEstimatorGradient "qiskit.algorithms.gradients.BaseEstimatorGradient") *| None*) – An optional estimator gradient to be used with the optimizer.
+* **initial\_point** (*Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – An optional initial point (i.e. initial parameter values) for the optimizer. The length of the initial point must match the number of [`ansatz`](#qiskit.algorithms.minimum_eigensolvers.VQE.ansatz "qiskit.algorithms.minimum_eigensolvers.VQE.ansatz") parameters. If `None`, a random point will be generated within certain parameter bounds. `VQE` will look to the ansatz for these bounds. If the ansatz does not specify bounds, bounds of $-2\pi$, $2\pi$ will be used.
+* **callback** (*Callable\[\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*, np.ndarray,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*, Any]], None] | None*) – A callback that can access the intermediate data at each optimization step. These data are: the evaluation count, the optimizer parameters for the ansatz, the estimated value, and the metadata dictionary.
+
+## Attributes
+
+
+
+### initial\_point
+
+## Methods
+
+### compute\_minimum\_eigenvalue
+
+
+
+`compute_minimum_eigenvalue(operator, aux_operators=None)`
+
+Computes the minimum eigenvalue. The `operator` and `aux_operators` are supplied here. While an `operator` is required by algorithms, `aux_operators` are optional.
+
+**Parameters**
+
+* **operator** (*BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")) – Qubit operator of the observable.
+* **aux\_operators** (*ListOrDict\[BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")*] | None*) – Optional list of auxiliary operators to be evaluated with the parameters of the minimum eigenvalue main result and their expectation values returned. For instance in chemistry these can be dipole operators and total particle count operators, so we can get values for these at the ground state.
+
+**Returns**
+
+A minimum eigensolver result.
+
+**Return type**
+
+[VQEResult](qiskit.algorithms.minimum_eigensolvers.VQEResult "qiskit.algorithms.minimum_eigensolvers.VQEResult")
+
+### supports\_aux\_operators
+
+
+
+`classmethod supports_aux_operators()`
+
+Whether computing the expectation value of auxiliary operators is supported.
+
+If the minimum eigensolver computes an eigenvalue of the main `operator` then it can compute the expectation value of the `aux_operators` for that state. Otherwise they will be ignored.
+
+**Returns**
+
+True if aux\_operator expectations can be evaluated, False otherwise
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.VQEResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.VQEResult.md
new file mode 100644
index 00000000000..8a66a5b25c7
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.VQEResult.md
@@ -0,0 +1,96 @@
+---
+title: VQEResult
+description: API reference for qiskit.algorithms.minimum_eigensolvers.VQEResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.minimum_eigensolvers.VQEResult
+---
+
+# VQEResult
+
+
+
+`qiskit.algorithms.minimum_eigensolvers.VQEResult`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/minimum_eigensolvers/vqe.py "view source code")
+
+Bases: `VariationalResult`, [`MinimumEigensolverResult`](qiskit.algorithms.minimum_eigensolvers.MinimumEigensolverResult "qiskit.algorithms.minimum_eigensolvers.minimum_eigensolver.MinimumEigensolverResult")
+
+Variational quantum eigensolver result.
+
+## Attributes
+
+
+
+### aux\_operators\_evaluated
+
+The aux operator expectation values.
+
+These values are in fact tuples formatted as (mean, (variance, shots)).
+
+
+
+### cost\_function\_evals
+
+The number of cost optimizer evaluations.
+
+
+
+### eigenvalue
+
+The computed minimum eigenvalue.
+
+
+
+### optimal\_circuit
+
+The optimal circuits. Along with the optimal parameters, these can be used to retrieve the minimum eigenstate.
+
+
+
+### optimal\_parameters
+
+Returns the optimal parameters in a dictionary
+
+
+
+### optimal\_point
+
+Returns optimal point
+
+
+
+### optimal\_value
+
+Returns optimal value
+
+
+
+### optimizer\_evals
+
+Returns number of optimizer evaluations
+
+
+
+### optimizer\_result
+
+Returns the optimizer result
+
+
+
+### optimizer\_time
+
+Returns time taken for optimization
+
+## Methods
+
+### combine
+
+
+
+`combine(result)`
+
+Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Argument is None
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.md b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.md
new file mode 100644
index 00000000000..a3bf30ea50c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.minimum_eigensolvers.md
@@ -0,0 +1,43 @@
+---
+title: minimum_eigensolvers
+description: API reference for qiskit.algorithms.minimum_eigensolvers
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.algorithms.minimum_eigensolvers
+---
+
+
+
+
+
+# qiskit.algorithms.minimum\_eigensolvers
+
+
+
+## Minimum Eigensolvers Package
+
+
+
+`qiskit.algorithms.minimum_eigensolvers`
+
+### Minimum Eigensolvers
+
+| | |
+| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
+| [`MinimumEigensolver`](qiskit.algorithms.minimum_eigensolvers.MinimumEigensolver "qiskit.algorithms.minimum_eigensolvers.MinimumEigensolver")() | The minimum eigensolver interface. |
+| [`NumPyMinimumEigensolver`](qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolver "qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolver")(\[filter\_criterion]) | The NumPy minimum eigensolver algorithm. |
+| [`VQE`](qiskit.algorithms.minimum_eigensolvers.VQE "qiskit.algorithms.minimum_eigensolvers.VQE")(estimator, ansatz, optimizer, \*\[, ...]) | The variational quantum eigensolver (VQE) algorithm. |
+| [`AdaptVQE`](qiskit.algorithms.minimum_eigensolvers.AdaptVQE "qiskit.algorithms.minimum_eigensolvers.AdaptVQE")(solver, \*\[, gradient\_threshold, ...]) | The Adaptive Variational Quantum Eigensolver algorithm. |
+| [`SamplingMinimumEigensolver`](qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolver "qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolver")() | The Sampling Minimum Eigensolver Interface. |
+| [`SamplingVQE`](qiskit.algorithms.minimum_eigensolvers.SamplingVQE "qiskit.algorithms.minimum_eigensolvers.SamplingVQE")(sampler, ansatz, optimizer, \*\[, ...]) | The Variational Quantum Eigensolver algorithm, optimized for diagonal Hamiltonians. |
+| [`QAOA`](qiskit.algorithms.minimum_eigensolvers.QAOA "qiskit.algorithms.minimum_eigensolvers.QAOA")(sampler, optimizer, \*\[, reps, ...]) | The Quantum Approximate Optimization Algorithm (QAOA). |
+
+| | |
+| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
+| [`MinimumEigensolverResult`](qiskit.algorithms.minimum_eigensolvers.MinimumEigensolverResult "qiskit.algorithms.minimum_eigensolvers.MinimumEigensolverResult")() | Minimum eigensolver result. |
+| [`NumPyMinimumEigensolverResult`](qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolverResult "qiskit.algorithms.minimum_eigensolvers.NumPyMinimumEigensolverResult")() | NumPy minimum eigensolver result. |
+| [`VQEResult`](qiskit.algorithms.minimum_eigensolvers.VQEResult "qiskit.algorithms.minimum_eigensolvers.VQEResult")() | Variational quantum eigensolver result. |
+| [`AdaptVQEResult`](qiskit.algorithms.minimum_eigensolvers.AdaptVQEResult "qiskit.algorithms.minimum_eigensolvers.AdaptVQEResult")() | AdaptVQE Result. |
+| [`SamplingMinimumEigensolverResult`](qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolverResult "qiskit.algorithms.minimum_eigensolvers.SamplingMinimumEigensolverResult")() | Sampling Minimum Eigensolver Result. |
+| [`SamplingVQEResult`](qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult "qiskit.algorithms.minimum_eigensolvers.SamplingVQEResult")() | VQE Result. |
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.ADAM.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.ADAM.md
new file mode 100644
index 00000000000..29caff17444
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.ADAM.md
@@ -0,0 +1,282 @@
+---
+title: ADAM
+description: API reference for qiskit.algorithms.optimizers.ADAM
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.ADAM
+---
+
+# ADAM
+
+
+
+`qiskit.algorithms.optimizers.ADAM(maxiter=10000, tol=1e-06, lr=0.001, beta_1=0.9, beta_2=0.99, noise_factor=1e-08, eps=1e-10, amsgrad=False, snapshot_dir=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/adam_amsgrad.py "view source code")
+
+Bases: [`Optimizer`](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.optimizer.Optimizer")
+
+Adam and AMSGRAD optimizers.
+
+Adam \[1] is a gradient-based optimization algorithm that is relies on adaptive estimates of lower-order moments. The algorithm requires little memory and is invariant to diagonal rescaling of the gradients. Furthermore, it is able to cope with non-stationary objective functions and noisy and/or sparse gradients.
+
+AMSGRAD \[2] (a variant of Adam) uses a ‘long-term memory’ of past gradients and, thereby, improves convergence properties.
+
+**References**
+
+**\[1]: Kingma, Diederik & Ba, Jimmy (2014), Adam: A Method for Stochastic Optimization.**
+
+[arXiv:1412.6980](https://arxiv.org/abs/1412.6980)
+
+**\[2]: Sashank J. Reddi and Satyen Kale and Sanjiv Kumar (2018),**
+
+On the Convergence of Adam and Beyond. [arXiv:1904.09237](https://arxiv.org/abs/1904.09237)
+
+
+ This component has some function that is normally random. If you want to reproduce behavior then you should set the random number generator seed in the algorithm\_globals (`qiskit.utils.algorithm_globals.random_seed = seed`).
+
+
+**Parameters**
+
+* **maxiter** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum number of iterations
+* **tol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Tolerance for termination
+* **lr** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Value >= 0, Learning rate.
+* **beta\_1** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Value in range 0 to 1, Generally close to 1.
+* **beta\_2** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Value in range 0 to 1, Generally close to 1.
+* **noise\_factor** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Value >= 0, Noise factor
+* **eps** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Value >=0, Epsilon to be used for finite differences if no analytic gradient method is given.
+* **amsgrad** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – True to use AMSGRAD, False if not
+* **snapshot\_dir** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – If not None save the optimizer’s parameter after every step to the given directory
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+## Methods
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+Return support level dictionary
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### load\_params
+
+
+
+`load_params(load_dir)`
+
+Load iteration parameters for a file called `adam_params.csv`.
+
+**Parameters**
+
+**load\_dir** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The directory containing `adam_params.csv`.
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None, objective_function=None, initial_point=None, gradient_function=None)`
+
+Minimize the scalar function.
+
+
+ `qiskit.algorithms.optimizers.adam_amsgrad.ADAM.minimize()`’s argument `gradient_function` is deprecated as of qiskit-terra 0.19.0. It will be removed no earlier than 3 months after the release date. Instead, use the argument `jac`, which behaves identically.
+
+
+
+ `qiskit.algorithms.optimizers.adam_amsgrad.ADAM.minimize()`’s argument `initial_point` is deprecated as of qiskit-terra 0.19.0. It will be removed no earlier than 3 months after the release date. Instead, use the argument `fun`, which behaves identically.
+
+
+
+ `qiskit.algorithms.optimizers.adam_amsgrad.ADAM.minimize()`’s argument `objective_function` is deprecated as of qiskit-terra 0.19.0. It will be removed no earlier than 3 months after the release date. Instead, use the argument `fun`, which behaves identically.
+
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+* **objective\_function** (*Callable\[\[np.ndarray],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – DEPRECATED. A function handle to the objective function.
+* **initial\_point** (*np.ndarray | None*) – DEPRECATED. The initial iteration point.
+* **gradient\_function** (*Callable\[\[np.ndarray],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – DEPRECATED. A function handle to the gradient of the objective function.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### save\_params
+
+
+
+`save_params(snapshot_dir)`
+
+Save the current iteration parameters to a file called `adam_params.csv`.
+
+
+ The current parameters are appended to the file, if it exists already. The file is not overwritten.
+
+
+**Parameters**
+
+**snapshot\_dir** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The directory to store the file in.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.AQGD.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.AQGD.md
new file mode 100644
index 00000000000..65fa59ebbed
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.AQGD.md
@@ -0,0 +1,241 @@
+---
+title: AQGD
+description: API reference for qiskit.algorithms.optimizers.AQGD
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.AQGD
+---
+
+# AQGD
+
+
+
+`qiskit.algorithms.optimizers.AQGD(maxiter=1000, eta=1.0, tol=1e-06, momentum=0.25, param_tol=1e-06, averaging=10)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/aqgd.py "view source code")
+
+Bases: [`Optimizer`](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.optimizer.Optimizer")
+
+Analytic Quantum Gradient Descent (AQGD) with Epochs optimizer. Performs gradient descent optimization with a momentum term, analytic gradients, and customized step length schedule for parameterized quantum gates, i.e. Pauli Rotations. See, for example:
+
+* K. Mitarai, M. Negoro, M. Kitagawa, and K. Fujii. (2018). Quantum circuit learning. Phys. Rev. A 98, 032309. [https://arxiv.org/abs/1803.00745](https://arxiv.org/abs/1803.00745)
+* Maria Schuld, Ville Bergholm, Christian Gogolin, Josh Izaac, Nathan Killoran. (2019). Evaluating analytic gradients on quantum hardware. Phys. Rev. A 99, 032331. [https://arxiv.org/abs/1811.11184](https://arxiv.org/abs/1811.11184)
+
+for further details on analytic gradients of parameterized quantum gates.
+
+Gradients are computed “analytically” using the quantum circuit when evaluating the objective function.
+
+Performs Analytical Quantum Gradient Descent (AQGD) with Epochs.
+
+**Parameters**
+
+* **maxiter** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Maximum number of iterations (full gradient steps)
+* **eta** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The coefficient of the gradient update. Increasing this value results in larger step sizes: param = previous\_param - eta \* deriv
+* **tol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Tolerance for change in windowed average of objective values. Convergence occurs when either objective tolerance is met OR parameter tolerance is met.
+* **momentum** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – Bias towards the previous gradient momentum in current update. Must be within the bounds: \[0,1)
+* **param\_tol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Tolerance for change in norm of parameters.
+* **averaging** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Length of window over which to average objective values for objective convergence criterion
+
+**Raises**
+
+[**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – If the length of `maxiter`, momentum\`, and `eta` is not the same.
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+## Methods
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+Support level dictionary
+
+**Returns**
+
+**gradient, bounds and initial point**
+
+support information that is ignored/required.
+
+**Return type**
+
+Dict\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)"), [int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")]
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimize the scalar function.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.AskData.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.AskData.md
new file mode 100644
index 00000000000..4de4e0e5852
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.AskData.md
@@ -0,0 +1,43 @@
+---
+title: AskData
+description: API reference for qiskit.algorithms.optimizers.AskData
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.AskData
+---
+
+# AskData
+
+
+
+`qiskit.algorithms.optimizers.AskData(x_fun=None, x_jac=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/steppable_optimizer.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Base class for return type of [`ask()`](qiskit.algorithms.optimizers.SteppableOptimizer#ask "qiskit.algorithms.optimizers.SteppableOptimizer.ask").
+
+**Parameters**
+
+* **x\_fun** (*POINT |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[POINT] | None*) – Point or list of points where the function needs to be evaluated to compute the next
+* **optimizer.** (*the next state of the*) –
+* **x\_jac** (*POINT |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[POINT] | None*) – Point or list of points where the gradient/jacobian needs to be evaluated to compute
+* **optimizer.** –
+
+## Attributes
+
+
+
+### x\_fun
+
+`POINT | list[POINT] | None`
+
+`= None`
+
+
+
+### x\_jac
+
+`POINT | list[POINT] | None`
+
+`= None`
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.BOBYQA.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.BOBYQA.md
new file mode 100644
index 00000000000..b29803aece4
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.BOBYQA.md
@@ -0,0 +1,221 @@
+---
+title: BOBYQA
+description: API reference for qiskit.algorithms.optimizers.BOBYQA
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.BOBYQA
+---
+
+# BOBYQA
+
+
+
+`qiskit.algorithms.optimizers.BOBYQA(maxiter=1000)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/bobyqa.py "view source code")
+
+Bases: [`Optimizer`](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.optimizer.Optimizer")
+
+Bound Optimization BY Quadratic Approximation algorithm.
+
+BOBYQA finds local solutions to nonlinear, non-convex minimization problems with optional bound constraints, without requirement of derivatives of the objective function.
+
+Uses skquant.opt installed with pip install scikit-quant. For further detail, please refer to [https://github.com/scikit-quant/scikit-quant](https://github.com/scikit-quant/scikit-quant) and [https://qat4chem.lbl.gov/software](https://qat4chem.lbl.gov/software).
+
+**Parameters**
+
+**maxiter** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum number of function evaluations.
+
+**Raises**
+
+[**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – scikit-quant not installed
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+## Methods
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+Returns support level dictionary.
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimize the scalar function.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.CG.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.CG.md
new file mode 100644
index 00000000000..bf3d7b248dc
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.CG.md
@@ -0,0 +1,224 @@
+---
+title: CG
+description: API reference for qiskit.algorithms.optimizers.CG
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.CG
+---
+
+# CG
+
+
+
+`qiskit.algorithms.optimizers.CG(maxiter=20, disp=False, gtol=1e-05, tol=None, eps=1.4901161193847656e-08, options=None, max_evals_grouped=1, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/cg.py "view source code")
+
+Bases: [`SciPyOptimizer`](qiskit.algorithms.optimizers.SciPyOptimizer "qiskit.algorithms.optimizers.scipy_optimizer.SciPyOptimizer")
+
+Conjugate Gradient optimizer.
+
+CG is an algorithm for the numerical solution of systems of linear equations whose matrices are symmetric and positive-definite. It is an *iterative algorithm* in that it uses an initial guess to generate a sequence of improving approximate solutions for a problem, in which each approximation is derived from the previous ones. It is often used to solve unconstrained optimization problems, such as energy minimization.
+
+Uses scipy.optimize.minimize CG. For further detail, please refer to [https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.minimize.html](https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.minimize.html)
+
+**Parameters**
+
+* **maxiter** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum number of iterations to perform.
+* **disp** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Set to True to print convergence messages.
+* **gtol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Gradient norm must be less than gtol before successful termination.
+* **tol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – Tolerance for termination.
+* **eps** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – If jac is approximated, use this value for the step size.
+* **options** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *| None*) – A dictionary of solver options.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Max number of default gradient evaluations performed simultaneously.
+* **kwargs** – additional kwargs for scipy.optimize.minimize.
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+## Methods
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+Return support level dictionary
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimize the scalar function.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.COBYLA.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.COBYLA.md
new file mode 100644
index 00000000000..5efae1d656e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.COBYLA.md
@@ -0,0 +1,222 @@
+---
+title: COBYLA
+description: API reference for qiskit.algorithms.optimizers.COBYLA
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.COBYLA
+---
+
+# COBYLA
+
+
+
+`qiskit.algorithms.optimizers.COBYLA(maxiter=1000, disp=False, rhobeg=1.0, tol=None, options=None, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/cobyla.py "view source code")
+
+Bases: [`SciPyOptimizer`](qiskit.algorithms.optimizers.SciPyOptimizer "qiskit.algorithms.optimizers.scipy_optimizer.SciPyOptimizer")
+
+Constrained Optimization By Linear Approximation optimizer.
+
+COBYLA is a numerical optimization method for constrained problems where the derivative of the objective function is not known.
+
+Uses scipy.optimize.minimize COBYLA. For further detail, please refer to [https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.minimize.html](https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.minimize.html)
+
+**Parameters**
+
+* **maxiter** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum number of function evaluations.
+* **disp** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Set to True to print convergence messages.
+* **rhobeg** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Reasonable initial changes to the variables.
+* **tol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – Final accuracy in the optimization (not precisely guaranteed). This is a lower bound on the size of the trust region.
+* **options** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *| None*) – A dictionary of solver options.
+* **kwargs** – additional kwargs for scipy.optimize.minimize.
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+## Methods
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+Return support level dictionary
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimize the scalar function.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.CRS.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.CRS.md
new file mode 100644
index 00000000000..edefeb1c72a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.CRS.md
@@ -0,0 +1,233 @@
+---
+title: CRS
+description: API reference for qiskit.algorithms.optimizers.CRS
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.CRS
+---
+
+# CRS
+
+
+
+`qiskit.algorithms.optimizers.CRS(max_evals=1000)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/nlopts/crs.py "view source code")
+
+Bases: `NLoptOptimizer`
+
+Controlled Random Search (CRS) with local mutation optimizer.
+
+Controlled Random Search (CRS) with local mutation is part of the family of the CRS optimizers. The CRS optimizers start with a random population of points, and randomly evolve these points by heuristic rules. In the case of CRS with local mutation, the evolution is a randomized version of the [`NELDER_MEAD`](qiskit.algorithms.optimizers.NELDER_MEAD "qiskit.algorithms.optimizers.NELDER_MEAD") local optimizer.
+
+NLopt global optimizer, derivative-free. For further detail, please refer to [https://nlopt.readthedocs.io/en/latest/NLopt\_Algorithms/#controlled-random-search-crs-with-local-mutation](https://nlopt.readthedocs.io/en/latest/NLopt_Algorithms/#controlled-random-search-crs-with-local-mutation)
+
+**Parameters**
+
+**max\_evals** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum allowed number of function evaluations.
+
+**Raises**
+
+[**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – NLopt library not installed.
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+## Methods
+
+### get\_nlopt\_optimizer
+
+
+
+`get_nlopt_optimizer()`
+
+Return NLopt optimizer type
+
+**Return type**
+
+*NLoptOptimizerType*
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+return support level dictionary
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimize the scalar function.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.DIRECT_L.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.DIRECT_L.md
new file mode 100644
index 00000000000..9a6af11a6dc
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.DIRECT_L.md
@@ -0,0 +1,235 @@
+---
+title: DIRECT_L
+description: API reference for qiskit.algorithms.optimizers.DIRECT_L
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.DIRECT_L
+---
+
+
+
+# DIRECT\_L
+
+
+
+`qiskit.algorithms.optimizers.DIRECT_L(max_evals=1000)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/nlopts/direct_l.py "view source code")
+
+Bases: `NLoptOptimizer`
+
+DIviding RECTangles Locally-biased optimizer.
+
+DIviding RECTangles (DIRECT) is a deterministic-search algorithms based on systematic division of the search domain into increasingly smaller hyper-rectangles. The DIRECT-L version is a “locally biased” variant of DIRECT that makes the algorithm more biased towards local search, so that it is more efficient for functions with few local minima.
+
+NLopt global optimizer, derivative-free. For further detail, please refer to [http://nlopt.readthedocs.io/en/latest/NLopt\_Algorithms/#direct-and-direct-l](http://nlopt.readthedocs.io/en/latest/NLopt_Algorithms/#direct-and-direct-l)
+
+**Parameters**
+
+**max\_evals** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum allowed number of function evaluations.
+
+**Raises**
+
+[**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – NLopt library not installed.
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+## Methods
+
+### get\_nlopt\_optimizer
+
+
+
+`get_nlopt_optimizer()`
+
+Return NLopt optimizer type
+
+**Return type**
+
+*NLoptOptimizerType*
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+return support level dictionary
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimize the scalar function.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.DIRECT_L_RAND.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.DIRECT_L_RAND.md
new file mode 100644
index 00000000000..c45a5f38af2
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.DIRECT_L_RAND.md
@@ -0,0 +1,235 @@
+---
+title: DIRECT_L_RAND
+description: API reference for qiskit.algorithms.optimizers.DIRECT_L_RAND
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.DIRECT_L_RAND
+---
+
+
+
+# DIRECT\_L\_RAND
+
+
+
+`qiskit.algorithms.optimizers.DIRECT_L_RAND(max_evals=1000)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/nlopts/direct_l_rand.py "view source code")
+
+Bases: `NLoptOptimizer`
+
+DIviding RECTangles Locally-biased Randomized optimizer.
+
+DIRECT-L RAND is the “locally biased” variant with some randomization in near-tie decisions. See also [`DIRECT_L`](qiskit.algorithms.optimizers.DIRECT_L "qiskit.algorithms.optimizers.DIRECT_L")
+
+NLopt global optimizer, derivative-free. For further detail, please refer to [http://nlopt.readthedocs.io/en/latest/NLopt\_Algorithms/#direct-and-direct-l](http://nlopt.readthedocs.io/en/latest/NLopt_Algorithms/#direct-and-direct-l)
+
+**Parameters**
+
+**max\_evals** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum allowed number of function evaluations.
+
+**Raises**
+
+[**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – NLopt library not installed.
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+## Methods
+
+### get\_nlopt\_optimizer
+
+
+
+`get_nlopt_optimizer()`
+
+Return NLopt optimizer type
+
+**Return type**
+
+*NLoptOptimizerType*
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+return support level dictionary
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimize the scalar function.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.ESCH.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.ESCH.md
new file mode 100644
index 00000000000..2de46484a51
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.ESCH.md
@@ -0,0 +1,235 @@
+---
+title: ESCH
+description: API reference for qiskit.algorithms.optimizers.ESCH
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.ESCH
+---
+
+# ESCH
+
+
+
+`qiskit.algorithms.optimizers.ESCH(max_evals=1000)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/nlopts/esch.py "view source code")
+
+Bases: `NLoptOptimizer`
+
+ESCH evolutionary optimizer.
+
+ESCH is an evolutionary algorithm for global optimization that supports bound constraints only. Specifically, it does not support nonlinear constraints.
+
+NLopt global optimizer, derivative-free. For further detail, please refer to
+
+[http://nlopt.readthedocs.io/en/latest/NLopt\_Algorithms/#esch-evolutionary-algorithm](http://nlopt.readthedocs.io/en/latest/NLopt_Algorithms/#esch-evolutionary-algorithm)
+
+**Parameters**
+
+**max\_evals** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum allowed number of function evaluations.
+
+**Raises**
+
+[**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – NLopt library not installed.
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+## Methods
+
+### get\_nlopt\_optimizer
+
+
+
+`get_nlopt_optimizer()`
+
+Return NLopt optimizer type
+
+**Return type**
+
+*NLoptOptimizerType*
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+return support level dictionary
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimize the scalar function.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.GSLS.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.GSLS.md
new file mode 100644
index 00000000000..3b9f13d11e5
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.GSLS.md
@@ -0,0 +1,342 @@
+---
+title: GSLS
+description: API reference for qiskit.algorithms.optimizers.GSLS
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.GSLS
+---
+
+# GSLS
+
+
+
+`qiskit.algorithms.optimizers.GSLS(maxiter=10000, max_eval=10000, disp=False, sampling_radius=1e-06, sample_size_factor=1, initial_step_size=0.01, min_step_size=1e-10, step_size_multiplier=0.4, armijo_parameter=0.1, min_gradient_norm=1e-08, max_failed_rejection_sampling=50)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/gsls.py "view source code")
+
+Bases: [`Optimizer`](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.optimizer.Optimizer")
+
+Gaussian-smoothed Line Search.
+
+An implementation of the line search algorithm described in [https://arxiv.org/pdf/1905.01332.pdf](https://arxiv.org/pdf/1905.01332.pdf), using gradient approximation based on Gaussian-smoothed samples on a sphere.
+
+
+ This component has some function that is normally random. If you want to reproduce behavior then you should set the random number generator seed in the algorithm\_globals (`qiskit.utils.algorithm_globals.random_seed = seed`).
+
+
+**Parameters**
+
+* **maxiter** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum number of iterations.
+* **max\_eval** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum number of evaluations.
+* **disp** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Set to True to display convergence messages.
+* **sampling\_radius** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Sampling radius to determine gradient estimate.
+* **sample\_size\_factor** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The size of the sample set at each iteration is this number multiplied by the dimension of the problem, rounded to the nearest integer.
+* **initial\_step\_size** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Initial step size for the descent algorithm.
+* **min\_step\_size** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Minimum step size for the descent algorithm.
+* **step\_size\_multiplier** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Step size reduction after unsuccessful steps, in the interval (0, 1).
+* **armijo\_parameter** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Armijo parameter for sufficient decrease criterion, in the interval (0, 1).
+* **min\_gradient\_norm** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – If the gradient norm is below this threshold, the algorithm stops.
+* **max\_failed\_rejection\_sampling** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum number of attempts to sample points within bounds.
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+## Methods
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+Return support level dictionary.
+
+**Returns**
+
+A dictionary containing the support levels for different options.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)"), [int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")]
+
+### gradient\_approximation
+
+
+
+`gradient_approximation(n, x, x_value, directions, sample_set_x, sample_set_y)`
+
+Construct gradient approximation from given sample.
+
+**Parameters**
+
+* **n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Dimension of the problem.
+* **x** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – Point around which the sample set was constructed.
+* **x\_value** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Objective function value at x.
+* **directions** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – Directions of the sample points wrt the central point x, as a 2D array.
+* **sample\_set\_x** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – x-coordinates of the sample set, one point per row, as a 2D array.
+* **sample\_set\_y** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – Objective function values of the points in sample\_set\_x, as a 1D array.
+
+**Returns**
+
+Gradient approximation at x, as a 1D array.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### ls\_optimize
+
+
+
+`ls_optimize(n, obj_fun, initial_point, var_lb, var_ub)`
+
+Run the line search optimization.
+
+**Parameters**
+
+* **n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Dimension of the problem.
+* **obj\_fun** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)")*\[\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")*],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – Objective function.
+* **initial\_point** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – Initial point.
+* **var\_lb** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – Vector of lower bounds on the decision variables. Vector elements can be -np.inf if the corresponding variable is unbounded from below.
+* **var\_ub** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – Vector of upper bounds on the decision variables. Vector elements can be np.inf if the corresponding variable is unbounded from below.
+
+**Returns**
+
+Final iterate as a vector, corresponding objective function value, number of evaluations, and norm of the gradient estimate.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If the number of dimensions mismatches the size of the initial point or the length of the lower or upper bound.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[numpy.ndarray](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)"), [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)"), [int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)"), [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")]
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimize the scalar function.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### sample\_points
+
+
+
+`sample_points(n, x, num_points)`
+
+Sample `num_points` points around `x` on the `n`-sphere of specified radius.
+
+The radius of the sphere is `self._options['sampling_radius']`.
+
+**Parameters**
+
+* **n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Dimension of the problem.
+* **x** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – Point around which the sample set is constructed.
+* **num\_points** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of points in the sample set.
+
+**Returns**
+
+A tuple containing the sampling points and the directions.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[numpy.ndarray](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)"), [numpy.ndarray](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")]
+
+### sample\_set
+
+
+
+`sample_set(n, x, var_lb, var_ub, num_points)`
+
+Construct sample set of given size.
+
+**Parameters**
+
+* **n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Dimension of the problem.
+* **x** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – Point around which the sample set is constructed.
+* **var\_lb** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – Vector of lower bounds on the decision variables. Vector elements can be -np.inf if the corresponding variable is unbounded from below.
+* **var\_ub** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – Vector of lower bounds on the decision variables. Vector elements can be np.inf if the corresponding variable is unbounded from above.
+* **num\_points** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of points in the sample set.
+
+**Returns**
+
+Matrices of (unit-norm) sample directions and sample points, one per row. Both matrices are 2D arrays of floats.
+
+**Raises**
+
+[**RuntimeError**](https://docs.python.org/3/library/exceptions.html#RuntimeError "(in Python v3.12)") – If not enough samples could be generated within the bounds.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[numpy.ndarray](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)"), [numpy.ndarray](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")]
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.GradientDescent.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.GradientDescent.md
new file mode 100644
index 00000000000..e4cb77abde0
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.GradientDescent.md
@@ -0,0 +1,466 @@
+---
+title: GradientDescent
+description: API reference for qiskit.algorithms.optimizers.GradientDescent
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.GradientDescent
+---
+
+# GradientDescent
+
+
+
+`qiskit.algorithms.optimizers.GradientDescent(maxiter=100, learning_rate=0.01, tol=1e-07, callback=None, perturbation=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/gradient_descent.py "view source code")
+
+Bases: [`SteppableOptimizer`](qiskit.algorithms.optimizers.SteppableOptimizer "qiskit.algorithms.optimizers.steppable_optimizer.SteppableOptimizer")
+
+The gradient descent minimization routine.
+
+For a function $f$ and an initial point $\vec\theta_0$, the standard (or “vanilla”) gradient descent method is an iterative scheme to find the minimum $\vec\theta^*$ of $f$ by updating the parameters in the direction of the negative gradient of $f$
+
+$$
+\vec\theta_{n+1} = \vec\theta_{n} - \eta_n \vec\nabla f(\vec\theta_{n}),
+$$
+
+for a small learning rate $\eta_n > 0$.
+
+You can either provide the analytic gradient $\vec\nabla f$ as `jac` in the [`minimize()`](#qiskit.algorithms.optimizers.GradientDescent.minimize "qiskit.algorithms.optimizers.GradientDescent.minimize") method, or, if you do not provide it, use a finite difference approximation of the gradient. To adapt the size of the perturbation in the finite difference gradients, set the `perturbation` property in the initializer.
+
+This optimizer supports a callback function. If provided in the initializer, the optimizer will call the callback in each iteration with the following information in this order: current number of function values, current parameters, current function value, norm of current gradient.
+
+**Examples**
+
+A minimum example that will use finite difference gradients with a default perturbation of 0.01 and a default learning rate of 0.01.
+
+```python
+from qiskit.algorithms.optimizers import GradientDescent
+
+def f(x):
+ return (np.linalg.norm(x) - 1) ** 2
+
+initial_point = np.array([1, 0.5, -0.2])
+
+optimizer = GradientDescent(maxiter=100)
+
+result = optimizer.minimize(fun=fun, x0=initial_point)
+
+print(f"Found minimum {result.x} at a value"
+ "of {result.fun} using {result.nfev} evaluations.")
+```
+
+An example where the learning rate is an iterator and we supply the analytic gradient. Note how much faster this convergences (i.e. less `nfev`) compared to the previous example.
+
+```python
+from qiskit.algorithms.optimizers import GradientDescent
+
+def learning_rate():
+ power = 0.6
+ constant_coeff = 0.1
+ def powerlaw():
+ n = 0
+ while True:
+ yield constant_coeff * (n ** power)
+ n += 1
+
+ return powerlaw()
+
+def f(x):
+ return (np.linalg.norm(x) - 1) ** 2
+
+def grad_f(x):
+ return 2 * (np.linalg.norm(x) - 1) * x / np.linalg.norm(x)
+
+initial_point = np.array([1, 0.5, -0.2])
+
+optimizer = GradientDescent(maxiter=100, learning_rate=learning_rate)
+result = optimizer.minimize(fun=fun, jac=grad_f, x0=initial_point)
+
+print(f"Found minimum {result.x} at a value"
+"of {result.fun} using {result.nfev} evaluations.")
+```
+
+An other example where the evaluation of the function has a chance of failing. The user, with specific knowledge about his function can catch this errors and handle them before passing the result to the optimizer.
+
+> ```python
+> import random
+> import numpy as np
+> from qiskit.algorithms.optimizers import GradientDescent
+>
+> def objective(x):
+> if random.choice([True, False]):
+> return None
+> else:
+> return (np.linalg.norm(x) - 1) ** 2
+>
+> def grad(x):
+> if random.choice([True, False]):
+> return None
+> else:
+> return 2 * (np.linalg.norm(x) - 1) * x / np.linalg.norm(x)
+>
+>
+> initial_point = np.random.normal(0, 1, size=(100,))
+>
+> optimizer = GradientDescent(maxiter=20)
+> optimizer.start(x0=initial_point, fun=objective, jac=grad)
+>
+> while optimizer.continue_condition():
+> ask_data = optimizer.ask()
+> evaluated_gradient = None
+>
+> while evaluated_gradient is None:
+> evaluated_gradient = grad(ask_data.x_center)
+> optimizer.state.njev += 1
+>
+> optmizer.state.nit += 1
+>
+> tell_data = TellData(eval_jac=evaluated_gradient)
+> optimizer.tell(ask_data=ask_data, tell_data=tell_data)
+>
+> result = optimizer.create_result()
+> ```
+
+Users that aren’t dealing with complicated functions and who are more familiar with step by step optimization algorithms can use the [`step()`](#qiskit.algorithms.optimizers.GradientDescent.step "qiskit.algorithms.optimizers.GradientDescent.step") method which wraps the [`ask()`](#qiskit.algorithms.optimizers.GradientDescent.ask "qiskit.algorithms.optimizers.GradientDescent.ask") and [`tell()`](#qiskit.algorithms.optimizers.GradientDescent.tell "qiskit.algorithms.optimizers.GradientDescent.tell") methods. In the same spirit the method [`minimize()`](#qiskit.algorithms.optimizers.GradientDescent.minimize "qiskit.algorithms.optimizers.GradientDescent.minimize") will optimize the function and return the result.
+
+To see other libraries that use this interface one can visit: [https://optuna.readthedocs.io/en/stable/tutorial/20\_recipes/009\_ask\_and\_tell.html](https://optuna.readthedocs.io/en/stable/tutorial/20_recipes/009_ask_and_tell.html)
+
+**Parameters**
+
+* **maxiter** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The maximum number of iterations.
+* **learning\_rate** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | np.ndarray | Callable\[\[], Generator\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*, None, None]]*) – A constant, list, array or factory of generators yielding learning rates for the parameter updates. See the docstring for an example.
+* **tol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – If the norm of the parameter update is smaller than this threshold, the optimizer has converged.
+* **perturbation** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – If no gradient is passed to [`minimize()`](#qiskit.algorithms.optimizers.GradientDescent.minimize "qiskit.algorithms.optimizers.GradientDescent.minimize") the gradient is approximated with a forward finite difference scheme with `perturbation` perturbation in both directions (defaults to 1e-2 if required). Ignored when we have an explicit function for the gradient.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `learning_rate` is an array and its length is less than `maxiter`.
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### perturbation
+
+Returns the perturbation.
+
+This is the perturbation used in the finite difference gradient approximation.
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+
+
+### state
+
+Return the current state of the optimizer.
+
+
+
+### tol
+
+Returns the tolerance of the optimizer.
+
+Any step with smaller stepsize than this value will stop the optimization.
+
+## Methods
+
+### ask
+
+
+
+`ask()`
+
+Returns an object with the data needed to evaluate the gradient.
+
+If this object contains a gradient function the gradient can be evaluated directly. Otherwise approximate it with a finite difference scheme.
+
+**Return type**
+
+[*AskData*](qiskit.algorithms.optimizers.AskData "qiskit.algorithms.optimizers.steppable_optimizer.AskData")
+
+### continue\_condition
+
+
+
+`continue_condition()`
+
+Condition that indicates the optimization process should come to an end.
+
+When the stepsize is smaller than the tolerance, the optimization process is considered finished.
+
+**Returns**
+
+`True` if the optimization process should continue, `False` otherwise.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### create\_result
+
+
+
+`create_result()`
+
+Creates a result of the optimization process.
+
+This result contains the best point, the best function value, the number of function/gradient evaluations and the number of iterations.
+
+**Returns**
+
+The result of the optimization process.
+
+**Return type**
+
+[*OptimizerResult*](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.optimizer.OptimizerResult")
+
+### evaluate
+
+
+
+`evaluate(ask_data)`
+
+Evaluates the gradient.
+
+It does so either by evaluating an analytic gradient or by approximating it with a finite difference scheme. It will either add `1` to the number of gradient evaluations or add `N+1` to the number of function evaluations (Where N is the dimension of the gradient).
+
+**Parameters**
+
+**ask\_data** ([*AskData*](qiskit.algorithms.optimizers.AskData "qiskit.algorithms.optimizers.steppable_optimizer.AskData")) – It contains the point where the gradient is to be evaluated and the gradient function or, in its absence, the objective function to perform a finite difference approximation.
+
+**Returns**
+
+The data containing the gradient evaluation.
+
+**Return type**
+
+[*TellData*](qiskit.algorithms.optimizers.TellData "qiskit.algorithms.optimizers.steppable_optimizer.TellData")
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+Get the support level dictionary.
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimizes the function.
+
+For well behaved functions the user can call this method to minimize a function. If the user wants more control on how to evaluate the function a custom loop can be created using [`ask()`](#qiskit.algorithms.optimizers.GradientDescent.ask "qiskit.algorithms.optimizers.GradientDescent.ask") and [`tell()`](#qiskit.algorithms.optimizers.GradientDescent.tell "qiskit.algorithms.optimizers.GradientDescent.tell") and evaluating the function manually.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – Function to minimize.
+* **x0** (*POINT*) – Initial point.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – Function to compute the gradient.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds of the search space.
+
+**Returns**
+
+Object containing the result of the optimization.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### start
+
+
+
+`start(fun, x0, jac=None, bounds=None)`
+
+Populates the state of the optimizer with the data provided and sets all the counters to 0.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – Function to minimize.
+* **x0** (*POINT*) – Initial point.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – Function to compute the gradient.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds of the search space.
+
+### step
+
+
+
+`step()`
+
+Performs one step in the optimization process.
+
+This method composes [`ask()`](#qiskit.algorithms.optimizers.GradientDescent.ask "qiskit.algorithms.optimizers.GradientDescent.ask"), [`evaluate()`](#qiskit.algorithms.optimizers.GradientDescent.evaluate "qiskit.algorithms.optimizers.GradientDescent.evaluate"), and [`tell()`](#qiskit.algorithms.optimizers.GradientDescent.tell "qiskit.algorithms.optimizers.GradientDescent.tell") to make a “step” in the optimization process.
+
+### tell
+
+
+
+`tell(ask_data, tell_data)`
+
+Updates `x` by an amount proportional to the learning rate and value of the gradient at that point.
+
+**Parameters**
+
+* **ask\_data** ([*AskData*](qiskit.algorithms.optimizers.AskData "qiskit.algorithms.optimizers.steppable_optimizer.AskData")) – The data used to evaluate the function.
+* **tell\_data** ([*TellData*](qiskit.algorithms.optimizers.TellData "qiskit.algorithms.optimizers.steppable_optimizer.TellData")) – The data from the function evaluation.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If the gradient passed doesn’t have the right dimension.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.GradientDescentState.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.GradientDescentState.md
new file mode 100644
index 00000000000..1a51659e5f3
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.GradientDescentState.md
@@ -0,0 +1,88 @@
+---
+title: GradientDescentState
+description: API reference for qiskit.algorithms.optimizers.GradientDescentState
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.GradientDescentState
+---
+
+# GradientDescentState
+
+
+
+`qiskit.algorithms.optimizers.GradientDescentState(x, fun, jac, nfev, njev, nit, stepsize, learning_rate)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/gradient_descent.py "view source code")
+
+Bases: [`OptimizerState`](qiskit.algorithms.optimizers.OptimizerState "qiskit.algorithms.optimizers.steppable_optimizer.OptimizerState")
+
+State of [`GradientDescent`](qiskit.algorithms.optimizers.GradientDescent "qiskit.algorithms.optimizers.GradientDescent").
+
+Dataclass with all the information of an optimizer plus the learning\_rate and the stepsize.
+
+## Attributes
+
+
+
+### stepsize
+
+`float | None`
+
+Norm of the gradient on the last step.
+
+
+
+### learning\_rate
+
+`LearningRate`
+
+Learning rate at the current step of the optimization process.
+
+It behaves like a generator, (use `next(learning_rate)` to get the learning rate for the next step) but it can also return the current learning rate with `learning_rate.current`.
+
+
+
+### x
+
+`POINT`
+
+Current optimization parameters.
+
+
+
+### fun
+
+`Callable[[POINT], float] | None`
+
+Function being optimized.
+
+
+
+### jac
+
+`Callable[[POINT], POINT] | None`
+
+Jacobian of the function being optimized.
+
+
+
+### nfev
+
+`int | None`
+
+Number of function evaluations so far in the optimization.
+
+
+
+### njev
+
+`int | None`
+
+Number of jacobian evaluations so far in the opimization.
+
+
+
+### nit
+
+`int | None`
+
+Number of optimization steps performed so far in the optimization.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.IMFIL.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.IMFIL.md
new file mode 100644
index 00000000000..5f76666454b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.IMFIL.md
@@ -0,0 +1,221 @@
+---
+title: IMFIL
+description: API reference for qiskit.algorithms.optimizers.IMFIL
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.IMFIL
+---
+
+# IMFIL
+
+
+
+`qiskit.algorithms.optimizers.IMFIL(maxiter=1000)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/imfil.py "view source code")
+
+Bases: [`Optimizer`](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.optimizer.Optimizer")
+
+IMplicit FILtering algorithm.
+
+Implicit filtering is a way to solve bound-constrained optimization problems for which derivatives are not available. In comparison to methods that use interpolation to reconstruct the function and its higher derivatives, implicit filtering builds upon coordinate search followed by interpolation to get an approximate gradient.
+
+Uses skquant.opt installed with pip install scikit-quant. For further detail, please refer to [https://github.com/scikit-quant/scikit-quant](https://github.com/scikit-quant/scikit-quant) and [https://qat4chem.lbl.gov/software](https://qat4chem.lbl.gov/software).
+
+**Parameters**
+
+**maxiter** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum number of function evaluations.
+
+**Raises**
+
+[**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – scikit-quant not installed
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+## Methods
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+Returns support level dictionary.
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimize the scalar function.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.ISRES.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.ISRES.md
new file mode 100644
index 00000000000..35d441762c2
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.ISRES.md
@@ -0,0 +1,233 @@
+---
+title: ISRES
+description: API reference for qiskit.algorithms.optimizers.ISRES
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.ISRES
+---
+
+# ISRES
+
+
+
+`qiskit.algorithms.optimizers.ISRES(max_evals=1000)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/nlopts/isres.py "view source code")
+
+Bases: `NLoptOptimizer`
+
+Improved Stochastic Ranking Evolution Strategy optimizer.
+
+Improved Stochastic Ranking Evolution Strategy (ISRES) is an algorithm for non-linearly constrained global optimization. It has heuristics to escape local optima, even though convergence to a global optima is not guaranteed. The evolution strategy is based on a combination of a mutation rule and differential variation. The fitness ranking is simply via the objective function for problems without nonlinear constraints. When nonlinear constraints are included, the [stochastic ranking proposed by Runarsson and Yao](https://notendur.hi.is/tpr/software/sres/Tec311r.pdf) is employed. This method supports arbitrary nonlinear inequality and equality constraints, in addition to the bound constraints.
+
+NLopt global optimizer, derivative-free. For further detail, please refer to [http://nlopt.readthedocs.io/en/latest/NLopt\_Algorithms/#isres-improved-stochastic-ranking-evolution-strategy](http://nlopt.readthedocs.io/en/latest/NLopt_Algorithms/#isres-improved-stochastic-ranking-evolution-strategy)
+
+**Parameters**
+
+**max\_evals** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum allowed number of function evaluations.
+
+**Raises**
+
+[**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – NLopt library not installed.
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+## Methods
+
+### get\_nlopt\_optimizer
+
+
+
+`get_nlopt_optimizer()`
+
+Return NLopt optimizer type
+
+**Return type**
+
+*NLoptOptimizerType*
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+return support level dictionary
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimize the scalar function.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.L_BFGS_B.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.L_BFGS_B.md
new file mode 100644
index 00000000000..cc4d6827eca
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.L_BFGS_B.md
@@ -0,0 +1,230 @@
+---
+title: L_BFGS_B
+description: API reference for qiskit.algorithms.optimizers.L_BFGS_B
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.L_BFGS_B
+---
+
+
+
+# L\_BFGS\_B
+
+
+
+`qiskit.algorithms.optimizers.L_BFGS_B(maxfun=15000, maxiter=15000, ftol=2.220446049250313e-15, iprint=-1, eps=1e-08, options=None, max_evals_grouped=1, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/l_bfgs_b.py "view source code")
+
+Bases: [`SciPyOptimizer`](qiskit.algorithms.optimizers.SciPyOptimizer "qiskit.algorithms.optimizers.scipy_optimizer.SciPyOptimizer")
+
+Limited-memory BFGS Bound optimizer.
+
+The target goal of Limited-memory Broyden-Fletcher-Goldfarb-Shanno Bound (L-BFGS-B) is to minimize the value of a differentiable scalar function $f$. This optimizer is a quasi-Newton method, meaning that, in contrast to Newtons’s method, it does not require $f$’s Hessian (the matrix of $f$’s second derivatives) when attempting to compute $f$’s minimum value.
+
+Like BFGS, L-BFGS is an iterative method for solving unconstrained, non-linear optimization problems, but approximates BFGS using a limited amount of computer memory. L-BFGS starts with an initial estimate of the optimal value, and proceeds iteratively to refine that estimate with a sequence of better estimates.
+
+The derivatives of $f$ are used to identify the direction of steepest descent, and also to form an estimate of the Hessian matrix (second derivative) of $f$. L-BFGS-B extends L-BFGS to handle simple, per-variable bound constraints.
+
+Uses `scipy.optimize.fmin_l_bfgs_b`. For further detail, please refer to [https://docs.scipy.org/doc/scipy/reference/optimize.minimize-lbfgsb.html](https://docs.scipy.org/doc/scipy/reference/optimize.minimize-lbfgsb.html)
+
+**Parameters**
+
+* **maxfun** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum number of function evaluations.
+* **maxiter** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum number of iterations.
+* **ftol** (*SupportsFloat*) – The iteration stops when $(f^k - f^{k+1}) / \max\{|f^k|, |f^{k+1}|,1\} \leq \text{ftol}$.
+* **iprint** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Controls the frequency of output. `iprint < 0` means no output; `iprint = 0` print only one line at the last iteration; `0 < iprint < 99` print also $f$ and $|\text{proj} g|$ every iprint iterations; `iprint = 99` print details of every iteration except n-vectors; `iprint = 100` print also the changes of active set and final $x$; `iprint > 100` print details of every iteration including $x$ and $g$.
+* **eps** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – If jac is approximated, use this value for the step size.
+* **options** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *| None*) – A dictionary of solver options.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Max number of default gradient evaluations performed simultaneously.
+* **kwargs** – additional kwargs for `scipy.optimize.minimize`.
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+## Methods
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+Return support level dictionary
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimize the scalar function.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.Minimizer.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.Minimizer.md
new file mode 100644
index 00000000000..c3a47c88765
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.Minimizer.md
@@ -0,0 +1,40 @@
+---
+title: Minimizer
+description: API reference for qiskit.algorithms.optimizers.Minimizer
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.Minimizer
+---
+
+# Minimizer
+
+
+
+`qiskit.algorithms.optimizers.Minimizer(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/optimizer.py "view source code")
+
+Bases: [`Protocol`](https://docs.python.org/3/library/typing.html#typing.Protocol "(in Python v3.12)")
+
+Callable Protocol for minimizer.
+
+This interface is based on [SciPy’s optimize module](https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.minimize.html).
+
+> This protocol defines a callable taking the following parameters:
+>
+> > **fun**
+> >
+> > The objective function to minimize (for example the energy in the case of the VQE).
+> >
+> > **x0**
+> >
+> > The initial point for the optimization.
+> >
+> > **jac**
+> >
+> > The gradient of the objective function.
+> >
+> > **bounds**
+> >
+> > Parameters bounds for the optimization. Note that these might not be supported by all optimizers.
+>
+> and which returns a minimization result object (either SciPy’s or Qiskit’s).
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.NELDER_MEAD.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.NELDER_MEAD.md
new file mode 100644
index 00000000000..8bf81017151
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.NELDER_MEAD.md
@@ -0,0 +1,228 @@
+---
+title: NELDER_MEAD
+description: API reference for qiskit.algorithms.optimizers.NELDER_MEAD
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.NELDER_MEAD
+---
+
+
+
+# NELDER\_MEAD
+
+
+
+`qiskit.algorithms.optimizers.NELDER_MEAD(maxiter=None, maxfev=1000, disp=False, xatol=0.0001, tol=None, adaptive=False, options=None, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/nelder_mead.py "view source code")
+
+Bases: [`SciPyOptimizer`](qiskit.algorithms.optimizers.SciPyOptimizer "qiskit.algorithms.optimizers.scipy_optimizer.SciPyOptimizer")
+
+Nelder-Mead optimizer.
+
+The Nelder-Mead algorithm performs unconstrained optimization; it ignores bounds or constraints. It is used to find the minimum or maximum of an objective function in a multidimensional space. It is based on the Simplex algorithm. Nelder-Mead is robust in many applications, especially when the first and second derivatives of the objective function are not known.
+
+However, if the numerical computation of the derivatives can be trusted to be accurate, other algorithms using the first and/or second derivatives information might be preferred to Nelder-Mead for their better performance in the general case, especially in consideration of the fact that the Nelder–Mead technique is a heuristic search method that can converge to non-stationary points.
+
+Uses scipy.optimize.minimize Nelder-Mead. For further detail, please refer to See [https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.minimize.html](https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.minimize.html)
+
+**Parameters**
+
+* **maxiter** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – Maximum allowed number of iterations. If both maxiter and maxfev are set, minimization will stop at the first reached.
+* **maxfev** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum allowed number of function evaluations. If both maxiter and maxfev are set, minimization will stop at the first reached.
+* **disp** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Set to True to print convergence messages.
+* **xatol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Absolute error in xopt between iterations that is acceptable for convergence.
+* **tol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – Tolerance for termination.
+* **adaptive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Adapt algorithm parameters to dimensionality of problem.
+* **options** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *| None*) – A dictionary of solver options.
+* **kwargs** – additional kwargs for scipy.optimize.minimize.
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+## Methods
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+Return support level dictionary
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimize the scalar function.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.NFT.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.NFT.md
new file mode 100644
index 00000000000..ef9ae30b9c6
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.NFT.md
@@ -0,0 +1,232 @@
+---
+title: NFT
+description: API reference for qiskit.algorithms.optimizers.NFT
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.NFT
+---
+
+# NFT
+
+
+
+`qiskit.algorithms.optimizers.NFT(maxiter=None, maxfev=1024, disp=False, reset_interval=32, options=None, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/nft.py "view source code")
+
+Bases: [`SciPyOptimizer`](qiskit.algorithms.optimizers.SciPyOptimizer "qiskit.algorithms.optimizers.scipy_optimizer.SciPyOptimizer")
+
+Nakanishi-Fujii-Todo algorithm.
+
+See [https://arxiv.org/abs/1903.12166](https://arxiv.org/abs/1903.12166)
+
+Built out using scipy framework, for details, please refer to [https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.minimize.html](https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.minimize.html).
+
+**Parameters**
+
+* **maxiter** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – Maximum number of iterations to perform.
+* **maxfev** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum number of function evaluations to perform.
+* **disp** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – disp
+* **reset\_interval** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The minimum estimates directly once in `reset_interval` times.
+* **options** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *| None*) – A dictionary of solver options.
+* **kwargs** – additional kwargs for scipy.optimize.minimize.
+
+**Notes**
+
+In this optimization method, the optimization function have to satisfy three conditions written in [\[1\]](#id2).
+
+**References**
+
+\[[1](#id1)]
+
+K. M. Nakanishi, K. Fujii, and S. Todo. 2019. Sequential minimal optimization for quantum-classical hybrid algorithms. arXiv preprint arXiv:1903.12166.
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+## Methods
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+Return support level dictionary
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimize the scalar function.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.Optimizer.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.Optimizer.md
new file mode 100644
index 00000000000..e07f5219c90
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.Optimizer.md
@@ -0,0 +1,221 @@
+---
+title: Optimizer
+description: API reference for qiskit.algorithms.optimizers.Optimizer
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.Optimizer
+---
+
+# Optimizer
+
+
+
+`qiskit.algorithms.optimizers.Optimizer`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/optimizer.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Base class for optimization algorithm.
+
+Initialize the optimization algorithm, setting the support level for \_gradient\_support\_level, \_bound\_support\_level, \_initial\_point\_support\_level, and empty options.
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+The optimizer settings in a dictionary format.
+
+The settings can for instance be used for JSON-serialization (if all settings are serializable, which e.g. doesn’t hold per default for callables), such that the optimizer object can be reconstructed as
+
+```python
+settings = optimizer.settings
+# JSON serialize and send to another server
+optimizer = OptimizerClass(**settings)
+```
+
+## Methods
+
+### get\_support\_level
+
+
+
+`abstract get_support_level()`
+
+Return support level dictionary
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`abstract minimize(fun, x0, jac=None, bounds=None)`
+
+Minimize the scalar function.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.OptimizerResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.OptimizerResult.md
new file mode 100644
index 00000000000..66a6e2e79a6
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.OptimizerResult.md
@@ -0,0 +1,70 @@
+---
+title: OptimizerResult
+description: API reference for qiskit.algorithms.optimizers.OptimizerResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.OptimizerResult
+---
+
+# OptimizerResult
+
+
+
+`qiskit.algorithms.optimizers.OptimizerResult`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/optimizer.py "view source code")
+
+Bases: `AlgorithmResult`
+
+The result of an optimization routine.
+
+## Attributes
+
+
+
+### fun
+
+The final value of the minimization.
+
+
+
+### jac
+
+The final gradient of the minimization.
+
+
+
+### nfev
+
+The total number of function evaluations.
+
+
+
+### nit
+
+The total number of iterations.
+
+
+
+### njev
+
+The total number of gradient evaluations.
+
+
+
+### x
+
+The final point of the minimization.
+
+## Methods
+
+### combine
+
+
+
+`combine(result)`
+
+Any property from the argument that exists in the receiver is updated. :param result: Argument result with properties to be set.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Argument is None
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.OptimizerState.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.OptimizerState.md
new file mode 100644
index 00000000000..b36bf8e5e1f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.OptimizerState.md
@@ -0,0 +1,70 @@
+---
+title: OptimizerState
+description: API reference for qiskit.algorithms.optimizers.OptimizerState
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.OptimizerState
+---
+
+# OptimizerState
+
+
+
+`qiskit.algorithms.optimizers.OptimizerState(x, fun, jac, nfev, njev, nit)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/steppable_optimizer.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Base class representing the state of the optimizer.
+
+This class stores the current state of the optimizer, given by the current point and (optionally) information like the function value, the gradient or the number of function evaluations. This dataclass can also store any other individual variables that change during the optimization.
+
+## Attributes
+
+
+
+### x
+
+`POINT`
+
+Current optimization parameters.
+
+
+
+### fun
+
+`Callable[[POINT], float] | None`
+
+Function being optimized.
+
+
+
+### jac
+
+`Callable[[POINT], POINT] | None`
+
+Jacobian of the function being optimized.
+
+
+
+### nfev
+
+`int | None`
+
+Number of function evaluations so far in the optimization.
+
+
+
+### njev
+
+`int | None`
+
+Number of jacobian evaluations so far in the opimization.
+
+
+
+### nit
+
+`int | None`
+
+Number of optimization steps performed so far in the optimization.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.OptimizerSupportLevel.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.OptimizerSupportLevel.md
new file mode 100644
index 00000000000..ad2e1630865
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.OptimizerSupportLevel.md
@@ -0,0 +1,44 @@
+---
+title: OptimizerSupportLevel
+description: API reference for qiskit.algorithms.optimizers.OptimizerSupportLevel
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.OptimizerSupportLevel
+---
+
+# OptimizerSupportLevel
+
+
+
+`qiskit.algorithms.optimizers.OptimizerSupportLevel(value)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/optimizer.py "view source code")
+
+Bases: [`IntEnum`](https://docs.python.org/3/library/enum.html#enum.IntEnum "(in Python v3.12)")
+
+Support Level enum for features such as bounds, gradient and initial point
+
+## Attributes
+
+
+
+### not\_supported
+
+`= 0`
+
+
+
+### ignored
+
+`= 1`
+
+
+
+### supported
+
+`= 2`
+
+
+
+### required
+
+`= 3`
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.POWELL.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.POWELL.md
new file mode 100644
index 00000000000..7a464de5968
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.POWELL.md
@@ -0,0 +1,223 @@
+---
+title: POWELL
+description: API reference for qiskit.algorithms.optimizers.POWELL
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.POWELL
+---
+
+# POWELL
+
+
+
+`qiskit.algorithms.optimizers.POWELL(maxiter=None, maxfev=1000, disp=False, xtol=0.0001, tol=None, options=None, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/powell.py "view source code")
+
+Bases: [`SciPyOptimizer`](qiskit.algorithms.optimizers.SciPyOptimizer "qiskit.algorithms.optimizers.scipy_optimizer.SciPyOptimizer")
+
+Powell optimizer.
+
+The Powell algorithm performs unconstrained optimization; it ignores bounds or constraints. Powell is a *conjugate direction method*: it performs sequential one-dimensional minimization along each directional vector, which is updated at each iteration of the main minimization loop. The function being minimized need not be differentiable, and no derivatives are taken.
+
+Uses scipy.optimize.minimize Powell. For further detail, please refer to See [https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.minimize.html](https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.minimize.html)
+
+**Parameters**
+
+* **maxiter** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – Maximum allowed number of iterations. If both maxiter and maxfev are set, minimization will stop at the first reached.
+* **maxfev** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum allowed number of function evaluations. If both maxiter and maxfev are set, minimization will stop at the first reached.
+* **disp** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Set to True to print convergence messages.
+* **xtol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Relative error in solution xopt acceptable for convergence.
+* **tol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – Tolerance for termination.
+* **options** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *| None*) – A dictionary of solver options.
+* **kwargs** – additional kwargs for scipy.optimize.minimize.
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+## Methods
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+Return support level dictionary
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimize the scalar function.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.P_BFGS.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.P_BFGS.md
new file mode 100644
index 00000000000..301ba90656a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.P_BFGS.md
@@ -0,0 +1,225 @@
+---
+title: P_BFGS
+description: API reference for qiskit.algorithms.optimizers.P_BFGS
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.P_BFGS
+---
+
+
+
+# P\_BFGS
+
+
+
+`qiskit.algorithms.optimizers.P_BFGS(maxfun=1000, ftol=2.220446049250313e-15, iprint=-1, max_processes=None, options=None, max_evals_grouped=1, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/p_bfgs.py "view source code")
+
+Bases: [`SciPyOptimizer`](qiskit.algorithms.optimizers.SciPyOptimizer "qiskit.algorithms.optimizers.scipy_optimizer.SciPyOptimizer")
+
+Parallelized Limited-memory BFGS optimizer.
+
+P-BFGS is a parallelized version of [`L_BFGS_B`](qiskit.algorithms.optimizers.L_BFGS_B "qiskit.algorithms.optimizers.L_BFGS_B") with which it shares the same parameters. P-BFGS can be useful when the target hardware is a quantum simulator running on a classical machine. This allows the multiple processes to use simulation to potentially reach a minimum faster. The parallelization may also help the optimizer avoid getting stuck at local optima.
+
+Uses scipy.optimize.fmin\_l\_bfgs\_b. For further detail, please refer to [https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.fmin\_l\_bfgs\_b.html](https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.fmin_l_bfgs_b.html)
+
+**Parameters**
+
+* **maxfun** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum number of function evaluations.
+* **ftol** (*SupportsFloat*) – The iteration stops when (f^k - f^\{k+1})/max\{|f^k|,|f^\{k+1}|,1} \<= ftol.
+* **iprint** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Controls the frequency of output. iprint \< 0 means no output; iprint = 0 print only one line at the last iteration; 0 \< iprint \< 99 print also f and |proj g| every iprint iterations; iprint = 99 print details of every iteration except n-vectors; iprint = 100 print also the changes of active set and final x; iprint > 100 print details of every iteration including x and g.
+* **max\_processes** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – maximum number of processes allowed, has a min. value of 1 if not None.
+* **options** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *| None*) – A dictionary of solver options.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Max number of default gradient evaluations performed simultaneously.
+* **kwargs** – additional kwargs for scipy.optimize.minimize.
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+## Methods
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+Return support level dictionary
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimize the scalar function.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.QNSPSA.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.QNSPSA.md
new file mode 100644
index 00000000000..995b4054ddf
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.QNSPSA.md
@@ -0,0 +1,416 @@
+---
+title: QNSPSA
+description: API reference for qiskit.algorithms.optimizers.QNSPSA
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.QNSPSA
+---
+
+# QNSPSA
+
+
+
+`qiskit.algorithms.optimizers.QNSPSA(fidelity, maxiter=100, blocking=True, allowed_increase=None, learning_rate=None, perturbation=None, resamplings=1, perturbation_dims=None, regularization=None, hessian_delay=0, lse_solver=None, initial_hessian=None, callback=None, termination_checker=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/qnspsa.py "view source code")
+
+Bases: [`SPSA`](qiskit.algorithms.optimizers.SPSA "qiskit.algorithms.optimizers.spsa.SPSA")
+
+The Quantum Natural SPSA (QN-SPSA) optimizer.
+
+The QN-SPSA optimizer \[1] is a stochastic optimizer that belongs to the family of gradient descent methods. This optimizer is based on SPSA but attempts to improve the convergence by sampling the **natural gradient** instead of the vanilla, first-order gradient. It achieves this by approximating Hessian of the `fidelity` of the ansatz circuit.
+
+Compared to natural gradients, which require $\mathcal{O}(d^2)$ expectation value evaluations for a circuit with $d$ parameters, QN-SPSA only requires $\mathcal{O}(1)$ and can therefore significantly speed up the natural gradient calculation by sacrificing some accuracy. Compared to SPSA, QN-SPSA requires 4 additional function evaluations of the fidelity.
+
+The stochastic approximation of the natural gradient can be systematically improved by increasing the number of `resamplings`. This leads to a Monte Carlo-style convergence to the exact, analytic value.
+
+
+ This component has some function that is normally random. If you want to reproduce behavior then you should set the random number generator seed in the algorithm\_globals (`qiskit.utils.algorithm_globals.random_seed = seed`).
+
+
+**Examples**
+
+This short example runs QN-SPSA for the ground state calculation of the `Z ^ Z` observable where the ansatz is a `PauliTwoDesign` circuit.
+
+```python
+import numpy as np
+from qiskit.algorithms.optimizers import QNSPSA
+from qiskit.circuit.library import PauliTwoDesign
+from qiskit.primitives import Estimator, Sampler
+from qiskit.quantum_info import Pauli
+
+# problem setup
+ansatz = PauliTwoDesign(2, reps=1, seed=2)
+observable = Pauli("ZZ")
+initial_point = np.random.random(ansatz.num_parameters)
+
+# loss function
+estimator = Estimator()
+
+def loss(x):
+ result = estimator.run([ansatz], [observable], [x]).result()
+ return np.real(result.values[0])
+
+# fidelity for estimation of the geometric tensor
+sampler = Sampler()
+fidelity = QNSPSA.get_fidelity(ansatz, sampler)
+
+# run QN-SPSA
+qnspsa = QNSPSA(fidelity, maxiter=300)
+result = qnspsa.optimize(ansatz.num_parameters, loss, initial_point=initial_point)
+```
+
+This is a legacy version solving the same problem but using Qiskit Opflow instead of the Qiskit Primitives. Note however, that this usage is deprecated.
+
+```python
+import numpy as np
+from qiskit.algorithms.optimizers import QNSPSA
+from qiskit.circuit.library import PauliTwoDesign
+from qiskit.opflow import Z, StateFn
+
+ansatz = PauliTwoDesign(2, reps=1, seed=2)
+observable = Z ^ Z
+initial_point = np.random.random(ansatz.num_parameters)
+
+def loss(x):
+ bound = ansatz.assign_parameters(x)
+ return np.real((StateFn(observable, is_measurement=True) @ StateFn(bound)).eval())
+
+fidelity = QNSPSA.get_fidelity(ansatz)
+qnspsa = QNSPSA(fidelity, maxiter=300)
+result = qnspsa.optimize(ansatz.num_parameters, loss, initial_point=initial_point)
+```
+
+**References**
+
+\[1] J. Gacon et al, “Simultaneous Perturbation Stochastic Approximation of the Quantum Fisher Information”, [arXiv:2103.09232](https://arxiv.org/abs/2103.09232)
+
+**Parameters**
+
+* **fidelity** (*FIDELITY*) – A function to compute the fidelity of the ansatz state with itself for two different sets of parameters.
+* **maxiter** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The maximum number of iterations. Note that this is not the maximal number of function evaluations.
+* **blocking** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, only accepts updates that improve the loss (up to some allowed increase, see next argument).
+* **allowed\_increase** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – If `blocking` is `True`, this argument determines by how much the loss can increase with the proposed parameters and still be accepted. If `None`, the allowed increases is calibrated automatically to be twice the approximated standard deviation of the loss function.
+* **learning\_rate** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| Callable\[\[], Iterator] | None*) – The update step is the learning rate is multiplied with the gradient. If the learning rate is a float, it remains constant over the course of the optimization. It can also be a callable returning an iterator which yields the learning rates for each optimization step. If `learning_rate` is set `perturbation` must also be provided.
+* **perturbation** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| Callable\[\[], Iterator] | None*) – Specifies the magnitude of the perturbation for the finite difference approximation of the gradients. Can be either a float or a generator yielding the perturbation magnitudes per step. If `perturbation` is set `learning_rate` must also be provided.
+* **resamplings** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The number of times the gradient (and Hessian) is sampled using a random direction to construct a gradient estimate. Per default the gradient is estimated using only one random direction. If an integer, all iterations use the same number of resamplings. If a dictionary, this is interpreted as `{iteration: number of resamplings per iteration}`.
+* **perturbation\_dims** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of perturbed dimensions. Per default, all dimensions are perturbed, but a smaller, fixed number can be perturbed. If set, the perturbed dimensions are chosen uniformly at random.
+* **regularization** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – To ensure the preconditioner is symmetric and positive definite, the identity times a small coefficient is added to it. This generator yields that coefficient.
+* **hessian\_delay** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Start multiplying the gradient with the inverse Hessian only after a certain number of iterations. The Hessian is still evaluated and therefore this argument can be useful to first get a stable average over the last iterations before using it as preconditioner.
+* **lse\_solver** (*Callable\[\[np.ndarray, np.ndarray], np.ndarray] | None*) – The method to solve for the inverse of the Hessian. Per default an exact LSE solver is used, but can e.g. be overwritten by a minimization routine.
+* **initial\_hessian** (*np.ndarray | None*) – The initial guess for the Hessian. By default the identity matrix is used.
+* **callback** (*CALLBACK | None*) – A callback function passed information in each iteration step. The information is, in this order: the parameters, the function value, the number of function evaluations, the stepsize, whether the step was accepted.
+* **termination\_checker** (*TERMINATIONCHECKER | None*) – A callback function executed at the end of each iteration step. The arguments are, in this order: the parameters, the function value, the number of function evaluations, the stepsize, whether the step was accepted. If the callback returns True, the optimization is terminated. To prevent additional evaluations of the objective method, if the objective has not yet been evaluated, the objective is estimated by taking the mean of the objective evaluations used in the estimate of the gradient.
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+The optimizer settings in a dictionary format.
+
+## Methods
+
+### calibrate
+
+
+
+`static calibrate(loss, initial_point, c=0.2, stability_constant=0, target_magnitude=None, alpha=0.602, gamma=0.101, modelspace=False, max_evals_grouped=1)`
+
+Calibrate SPSA parameters with a powerseries as learning rate and perturbation coeffs.
+
+The powerseries are:
+
+$$
+a_k = \frac{a}{(A + k + 1)^\alpha}, c_k = \frac{c}{(k + 1)^\gamma}
+$$
+
+**Parameters**
+
+* **loss** (*Callable\[\[np.ndarray],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The loss function.
+* **initial\_point** (*np.ndarray*) – The initial guess of the iteration.
+* **c** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The initial perturbation magnitude.
+* **stability\_constant** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The value of A.
+* **target\_magnitude** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The target magnitude for the first update step, defaults to $2\pi / 10$.
+* **alpha** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The exponent of the learning rate powerseries.
+* **gamma** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The exponent of the perturbation powerseries.
+* **modelspace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether the target magnitude is the difference of parameter values or function values (= model space).
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of grouped evaluations supported by the loss function. Defaults to 1, i.e. no grouping.
+
+**Returns**
+
+**A tuple of powerseries generators, the first one for the**
+
+learning rate and the second one for the perturbation.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")(generator, generator)
+
+### estimate\_stddev
+
+
+
+`static estimate_stddev(loss, initial_point, avg=25, max_evals_grouped=1)`
+
+Estimate the standard deviation of the loss function.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+### get\_fidelity
+
+
+
+`static get_fidelity(circuit, backend=None, expectation=None, *, sampler=None)`
+
+Get a function to compute the fidelity of `circuit` with itself.
+
+
+ Using this function with a backend and expectation converter is pending deprecation, instead pass a Qiskit Primitive sampler, such as [`Sampler`](qiskit.primitives.Sampler "qiskit.primitives.Sampler"). The sampler can be passed as keyword argument or, positionally, as second argument.
+
+
+Let `circuit` be a parameterized quantum circuit performing the operation $U(\theta)$ given a set of parameters $\theta$. Then this method returns a function to evaluate
+
+$$
+F(\theta, \phi) = \big|\langle 0 | U^\dagger(\theta) U(\phi) |0\rangle \big|^2.
+$$
+
+The output of this function can be used as input for the `fidelity` to the [`QNSPSA`](#qiskit.algorithms.optimizers.QNSPSA "qiskit.algorithms.optimizers.QNSPSA") optimizer.
+
+
+ `qiskit.algorithms.optimizers.qnspsa.QNSPSA.get_fidelity()`’s argument `expectation` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+
+ `qiskit.algorithms.optimizers.qnspsa.QNSPSA.get_fidelity()`’s argument `backend` is deprecated as of qiskit-terra 0.24.0. It will be removed no earlier than 3 months after the release date. See [https://qisk.it/algo\_migration](https://qisk.it/algo_migration) for a migration guide.
+
+
+**Parameters**
+
+* **circuit** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – The circuit preparing the parameterized ansatz.
+* **backend** ([*Backend*](qiskit.providers.Backend "qiskit.providers.Backend") *|*[*QuantumInstance*](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance") *| None*) – Deprecated. A backend of quantum instance to evaluate the circuits. If None, plain matrix multiplication will be used.
+* **expectation** ([*ExpectationBase*](qiskit.opflow.expectations.ExpectationBase "qiskit.opflow.expectations.ExpectationBase") *| None*) – Deprecated. An expectation converter to specify how the expected value is computed. If a shot-based readout is used this should be set to `PauliExpectation`.
+* **sampler** ([*BaseSampler*](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler") *| None*) – A sampler primitive to sample from a quantum state.
+
+**Returns**
+
+A handle to the function $F$.
+
+**Return type**
+
+Callable\[\[np.ndarray, np.ndarray], [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")]
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+Get the support level dictionary.
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimize the scalar function.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### optimize
+
+
+
+`optimize(num_vars, objective_function, gradient_function=None, variable_bounds=None, initial_point=None)`
+
+Perform optimization.
+
+
+ The method `qiskit.algorithms.optimizers.spsa.SPSA.optimize()` is deprecated as of qiskit-terra 0.21.0. It will be removed no earlier than 3 months after the release date. Instead, use `SPSA.minimize` as a replacement, which supports the same arguments but follows the interface of scipy.optimize and returns a complete result object containing additional information.
+
+
+**Parameters**
+
+* **num\_vars** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of parameters to be optimized.
+* **objective\_function** (*callable*) – A function that computes the objective function.
+* **gradient\_function** (*callable*) – Not supported for SPSA.
+* **variable\_bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[(*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*)]*) – Not supported for SPSA.
+* **initial\_point** ([*numpy.ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – Initial point.
+
+**Returns**
+
+**point, value, nfev**
+
+point: is a 1D numpy.ndarray\[float] containing the solution value: is a float with the objective function value nfev: number of objective function calls made if available or None
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.SLSQP.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.SLSQP.md
new file mode 100644
index 00000000000..c88001815d6
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.SLSQP.md
@@ -0,0 +1,226 @@
+---
+title: SLSQP
+description: API reference for qiskit.algorithms.optimizers.SLSQP
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.SLSQP
+---
+
+# SLSQP
+
+
+
+`qiskit.algorithms.optimizers.SLSQP(maxiter=100, disp=False, ftol=1e-06, tol=None, eps=1.4901161193847656e-08, options=None, max_evals_grouped=1, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/slsqp.py "view source code")
+
+Bases: [`SciPyOptimizer`](qiskit.algorithms.optimizers.SciPyOptimizer "qiskit.algorithms.optimizers.scipy_optimizer.SciPyOptimizer")
+
+Sequential Least SQuares Programming optimizer.
+
+SLSQP minimizes a function of several variables with any combination of bounds, equality and inequality constraints. The method wraps the SLSQP Optimization subroutine originally implemented by Dieter Kraft.
+
+SLSQP is ideal for mathematical problems for which the objective function and the constraints are twice continuously differentiable. Note that the wrapper handles infinite values in bounds by converting them into large floating values.
+
+Uses scipy.optimize.minimize SLSQP. For further detail, please refer to See [https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.minimize.html](https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.minimize.html)
+
+**Parameters**
+
+* **maxiter** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum number of iterations.
+* **disp** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Set to True to print convergence messages.
+* **ftol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Precision goal for the value of f in the stopping criterion.
+* **tol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – Tolerance for termination.
+* **eps** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Step size used for numerical approximation of the Jacobian.
+* **options** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *| None*) – A dictionary of solver options.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Max number of default gradient evaluations performed simultaneously.
+* **kwargs** – additional kwargs for scipy.optimize.minimize.
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+## Methods
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+Return support level dictionary
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimize the scalar function.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.SNOBFIT.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.SNOBFIT.md
new file mode 100644
index 00000000000..aa863c5332e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.SNOBFIT.md
@@ -0,0 +1,225 @@
+---
+title: SNOBFIT
+description: API reference for qiskit.algorithms.optimizers.SNOBFIT
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.SNOBFIT
+---
+
+# SNOBFIT
+
+
+
+`qiskit.algorithms.optimizers.SNOBFIT(maxiter=1000, maxfail=10, maxmp=None, verbose=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/snobfit.py "view source code")
+
+Bases: [`Optimizer`](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.optimizer.Optimizer")
+
+Stable Noisy Optimization by Branch and FIT algorithm.
+
+SnobFit is used for the optimization of derivative-free, noisy objective functions providing robust and fast solutions of problems with continuous variables varying within bound.
+
+Uses skquant.opt installed with pip install scikit-quant. For further detail, please refer to [https://github.com/scikit-quant/scikit-quant](https://github.com/scikit-quant/scikit-quant) and [https://qat4chem.lbl.gov/software](https://qat4chem.lbl.gov/software).
+
+**Parameters**
+
+* **maxiter** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum number of function evaluations.
+* **maxmp** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum number of model points requested for the local fit. Default = 2 \* number of parameters + 6 set to this value when None.
+* **maxfail** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum number of failures to improve the solution. Stops the algorithm after maxfail is reached.
+* **verbose** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Provide verbose (debugging) output.
+
+**Raises**
+
+* [**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – scikit-quant or SQSnobFit not installed
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If NumPy 1.24.0 or above is installed. See [https://github.com/scikit-quant/scikit-quant/issues/24](https://github.com/scikit-quant/scikit-quant/issues/24) for more details.
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+## Methods
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+Returns support level dictionary.
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimize the scalar function.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.SPSA.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.SPSA.md
new file mode 100644
index 00000000000..b54d9c6e73d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.SPSA.md
@@ -0,0 +1,399 @@
+---
+title: SPSA
+description: API reference for qiskit.algorithms.optimizers.SPSA
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.SPSA
+---
+
+# SPSA
+
+
+
+`qiskit.algorithms.optimizers.SPSA(maxiter=100, blocking=False, allowed_increase=None, trust_region=False, learning_rate=None, perturbation=None, last_avg=1, resamplings=1, perturbation_dims=None, second_order=False, regularization=None, hessian_delay=0, lse_solver=None, initial_hessian=None, callback=None, termination_checker=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/spsa.py "view source code")
+
+Bases: [`Optimizer`](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.optimizer.Optimizer")
+
+Simultaneous Perturbation Stochastic Approximation (SPSA) optimizer.
+
+SPSA \[1] is an gradient descent method for optimizing systems with multiple unknown parameters. As an optimization method, it is appropriately suited to large-scale population models, adaptive modeling, and simulation optimization.
+
+
+ Many examples are presented at the [SPSA Web site](http://www.jhuapl.edu/SPSA).
+
+
+The main feature of SPSA is the stochastic gradient approximation, which requires only two measurements of the objective function, regardless of the dimension of the optimization problem.
+
+Additionally to standard, first-order SPSA, where only gradient information is used, this implementation also allows second-order SPSA (2-SPSA) \[2]. In 2-SPSA we also estimate the Hessian of the loss with a stochastic approximation and multiply the gradient with the inverse Hessian to take local curvature into account and improve convergence. Notably this Hessian estimate requires only a constant number of function evaluations unlike an exact evaluation of the Hessian, which scales quadratically in the number of function evaluations.
+
+
+ SPSA can be used in the presence of noise, and it is therefore indicated in situations involving measurement uncertainty on a quantum computation when finding a minimum. If you are executing a variational algorithm using an OpenQASM simulator or a real device, SPSA would be the most recommended choice among the optimizers provided here.
+
+
+The optimization process can includes a calibration phase if neither the `learning_rate` nor `perturbation` is provided, which requires additional functional evaluations. (Note that either both or none must be set.) For further details on the automatic calibration, please refer to the supplementary information section IV. of \[3].
+
+
+ This component has some function that is normally random. If you want to reproduce behavior then you should set the random number generator seed in the algorithm\_globals (`qiskit.utils.algorithm_globals.random_seed = seed`).
+
+
+**Examples**
+
+This short example runs SPSA for the ground state calculation of the `Z ^ Z` observable where the ansatz is a `PauliTwoDesign` circuit.
+
+```python
+import numpy as np
+from qiskit.algorithms.optimizers import SPSA
+from qiskit.circuit.library import PauliTwoDesign
+from qiskit.opflow import Z, StateFn
+
+ansatz = PauliTwoDesign(2, reps=1, seed=2)
+observable = Z ^ Z
+initial_point = np.random.random(ansatz.num_parameters)
+
+def loss(x):
+ bound = ansatz.assign_parameters(x)
+ return np.real((StateFn(observable, is_measurement=True) @ StateFn(bound)).eval())
+
+spsa = SPSA(maxiter=300)
+result = spsa.optimize(ansatz.num_parameters, loss, initial_point=initial_point)
+```
+
+To use the Hessian information, i.e. 2-SPSA, you can add second\_order=True to the initializer of the SPSA class, the rest of the code remains the same.
+
+```python
+two_spsa = SPSA(maxiter=300, second_order=True)
+result = two_spsa.optimize(ansatz.num_parameters, loss, initial_point=initial_point)
+```
+
+The termination\_checker can be used to implement a custom termination criterion.
+
+```python
+import numpy as np
+from qiskit.algorithms.optimizers import SPSA
+
+def objective(x):
+ return np.linalg.norm(x) + .04*np.random.rand(1)
+
+class TerminationChecker:
+
+ def __init__(self, N : int):
+ self.N = N
+ self.values = []
+
+ def __call__(self, nfev, parameters, value, stepsize, accepted) -> bool:
+ self.values.append(value)
+
+ if len(self.values) > self.N:
+ last_values = self.values[-self.N:]
+ pp = np.polyfit(range(self.N), last_values, 1)
+ slope = pp[0] / self.N
+
+ if slope > 0:
+ return True
+ return False
+
+spsa = SPSA(maxiter=200, termination_checker=TerminationChecker(10))
+parameters, value, niter = spsa.optimize(2, objective, initial_point=[0.5, 0.5])
+print(f'SPSA completed after {niter} iterations')
+```
+
+**References**
+
+\[1]: J. C. Spall (1998). An Overview of the Simultaneous Perturbation Method for Efficient Optimization, Johns Hopkins APL Technical Digest, 19(4), 482–492. [Online at jhuapl.edu.](https://www.jhuapl.edu/SPSA/PDF-SPSA/Spall_An_Overview.PDF)
+
+\[2]: J. C. Spall (1997). Accelerated second-order stochastic optimization using only function measurements, Proceedings of the 36th IEEE Conference on Decision and Control, 1417-1424 vol.2. [Online at IEEE.org.](https://ieeexplore.ieee.org/document/657661)
+
+\[3]: A. Kandala et al. (2017). Hardware-efficient Variational Quantum Eigensolver for Small Molecules and Quantum Magnets. Nature 549, pages242–246(2017). [arXiv:1704.05018v2](https://arxiv.org/pdf/1704.05018v2.pdf#section*.11)
+
+**Parameters**
+
+* **maxiter** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The maximum number of iterations. Note that this is not the maximal number of function evaluations.
+* **blocking** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, only accepts updates that improve the loss (up to some allowed increase, see next argument).
+* **allowed\_increase** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – If `blocking` is `True`, this argument determines by how much the loss can increase with the proposed parameters and still be accepted. If `None`, the allowed increases is calibrated automatically to be twice the approximated standard deviation of the loss function.
+* **trust\_region** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If `True`, restricts the norm of the update step to be $\leq 1$.
+* **learning\_rate** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| np.ndarray | Callable\[\[], Iterator] | None*) – The update step is the learning rate is multiplied with the gradient. If the learning rate is a float, it remains constant over the course of the optimization. If a NumPy array, the $i$-th element is the learning rate for the $i$-th iteration. It can also be a callable returning an iterator which yields the learning rates for each optimization step. If `learning_rate` is set `perturbation` must also be provided.
+* **perturbation** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| np.ndarray | Callable\[\[], Iterator] | None*) – Specifies the magnitude of the perturbation for the finite difference approximation of the gradients. See `learning_rate` for the supported types. If `perturbation` is set `learning_rate` must also be provided.
+* **last\_avg** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Return the average of the `last_avg` parameters instead of just the last parameter values.
+* **resamplings** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The number of times the gradient (and Hessian) is sampled using a random direction to construct a gradient estimate. Per default the gradient is estimated using only one random direction. If an integer, all iterations use the same number of resamplings. If a dictionary, this is interpreted as `{iteration: number of resamplings per iteration}`.
+* **perturbation\_dims** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of perturbed dimensions. Per default, all dimensions are perturbed, but a smaller, fixed number can be perturbed. If set, the perturbed dimensions are chosen uniformly at random.
+* **second\_order** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, use 2-SPSA instead of SPSA. In 2-SPSA, the Hessian is estimated additionally to the gradient, and the gradient is preconditioned with the inverse of the Hessian to improve convergence.
+* **regularization** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – To ensure the preconditioner is symmetric and positive definite, the identity times a small coefficient is added to it. This generator yields that coefficient.
+* **hessian\_delay** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Start multiplying the gradient with the inverse Hessian only after a certain number of iterations. The Hessian is still evaluated and therefore this argument can be useful to first get a stable average over the last iterations before using it as preconditioner.
+* **lse\_solver** (*Callable\[\[np.ndarray, np.ndarray], np.ndarray] | None*) – The method to solve for the inverse of the Hessian. Per default an exact LSE solver is used, but can e.g. be overwritten by a minimization routine.
+* **initial\_hessian** (*np.ndarray | None*) – The initial guess for the Hessian. By default the identity matrix is used.
+* **callback** (*CALLBACK | None*) – A callback function passed information in each iteration step. The information is, in this order: the number of function evaluations, the parameters, the function value, the stepsize, whether the step was accepted.
+* **termination\_checker** (*TERMINATIONCHECKER | None*) – A callback function executed at the end of each iteration step. The arguments are, in this order: the parameters, the function value, the number of function evaluations, the stepsize, whether the step was accepted. If the callback returns True, the optimization is terminated. To prevent additional evaluations of the objective method, if the objective has not yet been evaluated, the objective is estimated by taking the mean of the objective evaluations used in the estimate of the gradient.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `learning_rate` or `perturbation` is an array with less elements than the number of iterations.
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+## Methods
+
+### calibrate
+
+
+
+`static calibrate(loss, initial_point, c=0.2, stability_constant=0, target_magnitude=None, alpha=0.602, gamma=0.101, modelspace=False, max_evals_grouped=1)`
+
+Calibrate SPSA parameters with a powerseries as learning rate and perturbation coeffs.
+
+The powerseries are:
+
+$$
+a_k = \frac{a}{(A + k + 1)^\alpha}, c_k = \frac{c}{(k + 1)^\gamma}
+$$
+
+**Parameters**
+
+* **loss** (*Callable\[\[np.ndarray],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The loss function.
+* **initial\_point** (*np.ndarray*) – The initial guess of the iteration.
+* **c** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The initial perturbation magnitude.
+* **stability\_constant** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The value of A.
+* **target\_magnitude** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The target magnitude for the first update step, defaults to $2\pi / 10$.
+* **alpha** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The exponent of the learning rate powerseries.
+* **gamma** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The exponent of the perturbation powerseries.
+* **modelspace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether the target magnitude is the difference of parameter values or function values (= model space).
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of grouped evaluations supported by the loss function. Defaults to 1, i.e. no grouping.
+
+**Returns**
+
+**A tuple of powerseries generators, the first one for the**
+
+learning rate and the second one for the perturbation.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")(generator, generator)
+
+### estimate\_stddev
+
+
+
+`static estimate_stddev(loss, initial_point, avg=25, max_evals_grouped=1)`
+
+Estimate the standard deviation of the loss function.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+Get the support level dictionary.
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimize the scalar function.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### optimize
+
+
+
+`optimize(num_vars, objective_function, gradient_function=None, variable_bounds=None, initial_point=None)`
+
+Perform optimization.
+
+
+ The method `qiskit.algorithms.optimizers.spsa.SPSA.optimize()` is deprecated as of qiskit-terra 0.21.0. It will be removed no earlier than 3 months after the release date. Instead, use `SPSA.minimize` as a replacement, which supports the same arguments but follows the interface of scipy.optimize and returns a complete result object containing additional information.
+
+
+**Parameters**
+
+* **num\_vars** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of parameters to be optimized.
+* **objective\_function** (*callable*) – A function that computes the objective function.
+* **gradient\_function** (*callable*) – Not supported for SPSA.
+* **variable\_bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[(*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*)]*) – Not supported for SPSA.
+* **initial\_point** ([*numpy.ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – Initial point.
+
+**Returns**
+
+**point, value, nfev**
+
+point: is a 1D numpy.ndarray\[float] containing the solution value: is a float with the objective function value nfev: number of objective function calls made if available or None
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.SciPyOptimizer.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.SciPyOptimizer.md
new file mode 100644
index 00000000000..ee2ab0af1a6
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.SciPyOptimizer.md
@@ -0,0 +1,218 @@
+---
+title: SciPyOptimizer
+description: API reference for qiskit.algorithms.optimizers.SciPyOptimizer
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.SciPyOptimizer
+---
+
+# SciPyOptimizer
+
+
+
+`qiskit.algorithms.optimizers.SciPyOptimizer(method, options=None, max_evals_grouped=1, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/scipy_optimizer.py "view source code")
+
+Bases: [`Optimizer`](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.optimizer.Optimizer")
+
+A general Qiskit Optimizer wrapping scipy.optimize.minimize.
+
+For further detail, please refer to [https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.minimize.html](https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.minimize.html)
+
+**Parameters**
+
+* **method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| Callable*) – Type of solver.
+* **options** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*, Any] | None*) – A dictionary of solver options.
+* **kwargs** – additional kwargs for scipy.optimize.minimize.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Max number of default gradient evaluations performed simultaneously.
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+## Methods
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+Return support level dictionary
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimize the scalar function.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.SteppableOptimizer.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.SteppableOptimizer.md
new file mode 100644
index 00000000000..e121b675a63
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.SteppableOptimizer.md
@@ -0,0 +1,396 @@
+---
+title: SteppableOptimizer
+description: API reference for qiskit.algorithms.optimizers.SteppableOptimizer
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.SteppableOptimizer
+---
+
+# SteppableOptimizer
+
+
+
+`qiskit.algorithms.optimizers.SteppableOptimizer(maxiter=100)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/steppable_optimizer.py "view source code")
+
+Bases: [`Optimizer`](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.optimizer.Optimizer")
+
+Base class for a steppable optimizer.
+
+This family of optimizers uses the [ask and tell interface](https://optuna.readthedocs.io/en/stable/tutorial/20_recipes/009_ask_and_tell.html). When using this interface the user has to call [`ask()`](#qiskit.algorithms.optimizers.SteppableOptimizer.ask "qiskit.algorithms.optimizers.SteppableOptimizer.ask") to get information about how to evaluate the function (we are asking the optimizer about how to do the evaluation). This information is typically the next points at which the function is evaluated, but depending on the optimizer it can also determine whether to evaluate the function or its gradient. Once the function has been evaluated, the user calls the method `tell()` to tell the optimizer what the result of the function evaluation(s) is. The optimizer then updates its state accordingly and the user can decide whether to stop the optimization process or to repeat a step.
+
+This interface is more customizable, and allows the user to have full control over the evaluation of the function.
+
+**Examples**
+
+An example where the evaluation of the function has a chance of failing. The user, with specific knowledge about his function can catch this errors and handle them before passing the result to the optimizer.
+
+```python
+import random
+import numpy as np
+from qiskit.algorithms.optimizers import GradientDescent
+
+def objective(x):
+ if random.choice([True, False]):
+ return None
+ else:
+ return (np.linalg.norm(x) - 1) ** 2
+
+def grad(x):
+ if random.choice([True, False]):
+ return None
+ else:
+ return 2 * (np.linalg.norm(x) - 1) * x / np.linalg.norm(x)
+
+
+initial_point = np.random.normal(0, 1, size=(100,))
+
+optimizer = GradientDescent(maxiter=20)
+optimizer.start(x0=initial_point, fun=objective, jac=grad)
+
+while optimizer.continue_condition():
+ ask_data = optimizer.ask()
+ evaluated_gradient = None
+
+ while evaluated_gradient is None:
+ evaluated_gradient = grad(ask_data.x_center)
+ optimizer.state.njev += 1
+
+ optmizer.state.nit += 1
+
+ cf = TellData(eval_jac=evaluated_gradient)
+ optimizer.tell(ask_data=ask_data, tell_data=tell_data)
+
+result = optimizer.create_result()
+```
+
+Users that aren’t dealing with complicated functions and who are more familiar with step by step optimization algorithms can use the [`step()`](#qiskit.algorithms.optimizers.SteppableOptimizer.step "qiskit.algorithms.optimizers.SteppableOptimizer.step") method which wraps the [`ask()`](#qiskit.algorithms.optimizers.SteppableOptimizer.ask "qiskit.algorithms.optimizers.SteppableOptimizer.ask") and [`tell()`](#qiskit.algorithms.optimizers.SteppableOptimizer.tell "qiskit.algorithms.optimizers.SteppableOptimizer.tell") methods. In the same spirit the method [`minimize()`](#qiskit.algorithms.optimizers.SteppableOptimizer.minimize "qiskit.algorithms.optimizers.SteppableOptimizer.minimize") will optimize the function and return the result.
+
+To see other libraries that use this interface one can visit: [https://optuna.readthedocs.io/en/stable/tutorial/20\_recipes/009\_ask\_and\_tell.html](https://optuna.readthedocs.io/en/stable/tutorial/20_recipes/009_ask_and_tell.html)
+
+**Parameters**
+
+**maxiter** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of steps in the optimization process before ending the loop.
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+The optimizer settings in a dictionary format.
+
+The settings can for instance be used for JSON-serialization (if all settings are serializable, which e.g. doesn’t hold per default for callables), such that the optimizer object can be reconstructed as
+
+```python
+settings = optimizer.settings
+# JSON serialize and send to another server
+optimizer = OptimizerClass(**settings)
+```
+
+
+
+### state
+
+Return the current state of the optimizer.
+
+## Methods
+
+### ask
+
+
+
+`ask()`
+
+Ask the optimizer for a set of points to evaluate.
+
+This method asks the optimizer which are the next points to evaluate. These points can, e.g., correspond to function values and/or its derivative. It may also correspond to variables that let the user infer which points to evaluate. It is the first method inside of a [`step()`](#qiskit.algorithms.optimizers.SteppableOptimizer.step "qiskit.algorithms.optimizers.SteppableOptimizer.step") in the optimization process.
+
+**Returns**
+
+An object containing the data needed to make the function evaluation to advance the optimization process.
+
+**Return type**
+
+[*AskData*](qiskit.algorithms.optimizers.AskData "qiskit.algorithms.optimizers.steppable_optimizer.AskData")
+
+### continue\_condition
+
+
+
+`continue_condition()`
+
+Condition that indicates the optimization process should continue.
+
+**Returns**
+
+`True` if the optimization process should continue, `False` otherwise.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### create\_result
+
+
+
+`abstract create_result()`
+
+Returns the result of the optimization.
+
+All the information needed to create such a result should be stored in the optimizer state and will typically contain the best point found, the function value and gradient at that point, the number of function and gradient evaluation and the number of iterations in the optimization.
+
+**Returns**
+
+The result of the optimization process.
+
+**Return type**
+
+[*OptimizerResult*](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.optimizer.OptimizerResult")
+
+### evaluate
+
+
+
+`abstract evaluate(ask_data)`
+
+Evaluates the function according to the instructions contained in `ask_data`.
+
+If the user decides to use [`step()`](#qiskit.algorithms.optimizers.SteppableOptimizer.step "qiskit.algorithms.optimizers.SteppableOptimizer.step") instead of [`ask()`](#qiskit.algorithms.optimizers.SteppableOptimizer.ask "qiskit.algorithms.optimizers.SteppableOptimizer.ask") and [`tell()`](#qiskit.algorithms.optimizers.SteppableOptimizer.tell "qiskit.algorithms.optimizers.SteppableOptimizer.tell") this function will contain the logic on how to evaluate the function.
+
+**Parameters**
+
+**ask\_data** ([*AskData*](qiskit.algorithms.optimizers.AskData "qiskit.algorithms.optimizers.steppable_optimizer.AskData")) – Contains the information on how to do the evaluation.
+
+**Returns**
+
+Data of all relevant information about the function evaluation.
+
+**Return type**
+
+[*TellData*](qiskit.algorithms.optimizers.TellData "qiskit.algorithms.optimizers.steppable_optimizer.TellData")
+
+### get\_support\_level
+
+
+
+`abstract get_support_level()`
+
+Return support level dictionary
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimizes the function.
+
+For well behaved functions the user can call this method to minimize a function. If the user wants more control on how to evaluate the function a custom loop can be created using [`ask()`](#qiskit.algorithms.optimizers.SteppableOptimizer.ask "qiskit.algorithms.optimizers.SteppableOptimizer.ask") and [`tell()`](#qiskit.algorithms.optimizers.SteppableOptimizer.tell "qiskit.algorithms.optimizers.SteppableOptimizer.tell") and evaluating the function manually.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – Function to minimize.
+* **x0** (*POINT*) – Initial point.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – Function to compute the gradient.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds of the search space.
+
+**Returns**
+
+Object containing the result of the optimization.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### start
+
+
+
+`abstract start(fun, x0, jac=None, bounds=None)`
+
+Populates the state of the optimizer with the data provided and sets all the counters to 0.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – Function to minimize.
+* **x0** (*POINT*) – Initial point.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – Function to compute the gradient.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds of the search space.
+
+### step
+
+
+
+`step()`
+
+Performs one step in the optimization process.
+
+This method composes [`ask()`](#qiskit.algorithms.optimizers.SteppableOptimizer.ask "qiskit.algorithms.optimizers.SteppableOptimizer.ask"), [`evaluate()`](#qiskit.algorithms.optimizers.SteppableOptimizer.evaluate "qiskit.algorithms.optimizers.SteppableOptimizer.evaluate"), and [`tell()`](#qiskit.algorithms.optimizers.SteppableOptimizer.tell "qiskit.algorithms.optimizers.SteppableOptimizer.tell") to make a “step” in the optimization process.
+
+### tell
+
+
+
+`tell(ask_data, tell_data)`
+
+Updates the optimization state using the results of the function evaluation.
+
+A canonical optimization example using [`ask()`](#qiskit.algorithms.optimizers.SteppableOptimizer.ask "qiskit.algorithms.optimizers.SteppableOptimizer.ask") and [`tell()`](#qiskit.algorithms.optimizers.SteppableOptimizer.tell "qiskit.algorithms.optimizers.SteppableOptimizer.tell") can be seen in [`step()`](#qiskit.algorithms.optimizers.SteppableOptimizer.step "qiskit.algorithms.optimizers.SteppableOptimizer.step").
+
+**Parameters**
+
+* **ask\_data** ([*AskData*](qiskit.algorithms.optimizers.AskData "qiskit.algorithms.optimizers.steppable_optimizer.AskData")) – Contains the information on how the evaluation was done.
+* **tell\_data** ([*TellData*](qiskit.algorithms.optimizers.TellData "qiskit.algorithms.optimizers.steppable_optimizer.TellData")) – Contains all relevant information about the evaluation of the objective function.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.TNC.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.TNC.md
new file mode 100644
index 00000000000..4d9718336d5
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.TNC.md
@@ -0,0 +1,227 @@
+---
+title: TNC
+description: API reference for qiskit.algorithms.optimizers.TNC
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.TNC
+---
+
+# TNC
+
+
+
+`qiskit.algorithms.optimizers.TNC(maxiter=100, disp=False, accuracy=0, ftol=-1, xtol=-1, gtol=-1, tol=None, eps=1e-08, options=None, max_evals_grouped=1, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/tnc.py "view source code")
+
+Bases: [`SciPyOptimizer`](qiskit.algorithms.optimizers.SciPyOptimizer "qiskit.algorithms.optimizers.scipy_optimizer.SciPyOptimizer")
+
+Truncated Newton (TNC) optimizer.
+
+TNC uses a truncated Newton algorithm to minimize a function with variables subject to bounds. This algorithm uses gradient information; it is also called Newton Conjugate-Gradient. It differs from the [`CG`](qiskit.algorithms.optimizers.CG "qiskit.algorithms.optimizers.CG") method as it wraps a C implementation and allows each variable to be given upper and lower bounds.
+
+Uses scipy.optimize.minimize TNC For further detail, please refer to See [https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.minimize.html](https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.minimize.html)
+
+**Parameters**
+
+* **maxiter** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum number of function evaluation.
+* **disp** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Set to True to print convergence messages.
+* **accuracy** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Relative precision for finite difference calculations. If \<= machine\_precision, set to sqrt(machine\_precision). Defaults to 0.
+* **ftol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Precision goal for the value of f in the stopping criterion. If ftol \< 0.0, ftol is set to 0.0 defaults to -1.
+* **xtol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Precision goal for the value of x in the stopping criterion (after applying x scaling factors). If xtol \< 0.0, xtol is set to sqrt(machine\_precision). Defaults to -1.
+* **gtol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Precision goal for the value of the projected gradient in the stopping criterion (after applying x scaling factors). If gtol \< 0.0, gtol is set to 1e-2 \* sqrt(accuracy). Setting it to 0.0 is not recommended. Defaults to -1.
+* **tol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – Tolerance for termination.
+* **eps** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Step size used for numerical approximation of the Jacobian.
+* **options** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *| None*) – A dictionary of solver options.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Max number of default gradient evaluations performed simultaneously.
+* **kwargs** – additional kwargs for scipy.optimize.minimize.
+
+## Attributes
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+## Methods
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+Return support level dictionary
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimize the scalar function.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.TellData.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.TellData.md
new file mode 100644
index 00000000000..18be7da16fd
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.TellData.md
@@ -0,0 +1,41 @@
+---
+title: TellData
+description: API reference for qiskit.algorithms.optimizers.TellData
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.TellData
+---
+
+# TellData
+
+
+
+`qiskit.algorithms.optimizers.TellData(eval_fun=None, eval_jac=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/steppable_optimizer.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Base class for argument type of [`tell()`](qiskit.algorithms.optimizers.SteppableOptimizer#tell "qiskit.algorithms.optimizers.SteppableOptimizer.tell").
+
+**Parameters**
+
+* **eval\_fun** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – Image of the function at `x_fun`.
+* **eval\_jac** (*POINT |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[POINT] | None*) – Image of the gradient-jacobian at `x_jac`.
+
+## Attributes
+
+
+
+### eval\_fun
+
+`float | list[float] | None`
+
+`= None`
+
+
+
+### eval\_jac
+
+`POINT | list[POINT] | None`
+
+`= None`
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.UMDA.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.UMDA.md
new file mode 100644
index 00000000000..73efcb24dea
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.UMDA.md
@@ -0,0 +1,307 @@
+---
+title: UMDA
+description: API reference for qiskit.algorithms.optimizers.UMDA
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.UMDA
+---
+
+# UMDA
+
+
+
+`qiskit.algorithms.optimizers.UMDA(maxiter=100, size_gen=20, alpha=0.5, callback=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/umda.py "view source code")
+
+Bases: [`Optimizer`](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.optimizer.Optimizer")
+
+Continuous Univariate Marginal Distribution Algorithm (UMDA).
+
+UMDA \[1] is a specific type of Estimation of Distribution Algorithm (EDA) where new individuals are sampled from univariate normal distributions and are updated in each iteration of the algorithm by the best individuals found in the previous iteration.
+
+
+ This original implementation of the UDMA optimizer for Qiskit was inspired by my (Vicente P. Soloviev) work on the EDAspy Python package \[2].
+
+
+EDAs are stochastic search algorithms and belong to the family of the evolutionary algorithms. The main difference is that EDAs have a probabilistic model which is updated in each iteration from the best individuals of previous generations (elite selection). Depending on the complexity of the probabilistic model, EDAs can be classified in different ways. In this case, UMDA is a univariate EDA as the embedded probabilistic model is univariate.
+
+UMDA has been compared to some of the already implemented algorithms in Qiskit library to optimize the parameters of variational algorithms such as QAOA or VQE and competitive results have been obtained \[1]. UMDA seems to provide very good solutions for those circuits in which the number of layers is not big.
+
+The optimization process can be personalized depending on the parameters chosen in the initialization. The main parameter is the population size. The bigger it is, the final result will be better. However, this increases the complexity of the algorithm and the runtime will be much heavier. In the work \[1] different experiments have been performed where population size has been set to 20 - 30.
+
+
+ The UMDA implementation has more parameters but these have default values for the initialization for better understanding of the user. For example, `lpha` parameter has been set to 0.5 and is the percentage of the population which is selected in each iteration to update the probabilistic model.
+
+
+**Example**
+
+This short example runs UMDA to optimize the parameters of a variational algorithm. Here we will use the same operator as used in the algorithms introduction, which was originally computed by Qiskit Nature for an H2 molecule. The minimum energy of the H2 Hamiltonian can be found quite easily so we are able to set maxiters to a small value.
+
+```python
+from qiskit.opflow import X, Z, I
+from qiskit_aer import Aer
+from qiskit.algorithms.optimizers import UMDA
+from qiskit.algorithms import QAOA
+from qiskit.utils import QuantumInstance
+
+
+H2_op = (-1.052373245772859 * I ^ I) + (0.39793742484318045 * I ^ Z) + (-0.39793742484318045 * Z ^ I) + (-0.01128010425623538 * Z ^ Z) + (0.18093119978423156 * X ^ X)
+
+p = 2 # Toy example: 2 layers with 2 parameters in each layer: 4 variables
+
+opt = UMDA(maxiter=100, size_gen=20)
+
+backend = Aer.get_backend('statevector_simulator')
+vqe = QAOA(opt,
+ quantum_instance=QuantumInstance(backend=backend),
+ reps=p)
+
+result = vqe.compute_minimum_eigenvalue(operator=H2_op)
+```
+
+If it is desired to modify the percentage of individuals considered to update the probabilistic model, then this code can be used. Here for example we set the 60% instead of the 50% predefined.
+
+```python
+opt = UMDA(maxiter=100, size_gen=20, alpha = 0.6)
+
+backend = Aer.get_backend('statevector_simulator')
+vqe = QAOA(opt,
+ quantum_instance=QuantumInstance(backend=backend),
+ reps=p)
+
+result = vqe.compute_minimum_eigenvalue(operator=qubit_op)
+```
+
+**References**
+
+\[1]: Vicente P. Soloviev, Pedro Larrañaga and Concha Bielza (2022, July). Quantum Parametric Circuit Optimization with Estimation of Distribution Algorithms. In 2022 The Genetic and Evolutionary Computation Conference (GECCO). DOI: [https://doi.org/10.1145/3520304.3533963](https://doi.org/10.1145/3520304.3533963)
+
+\[2]: Vicente P. Soloviev. Python package EDAspy. [https://github.com/VicentePerezSoloviev/EDAspy](https://github.com/VicentePerezSoloviev/EDAspy).
+
+**Parameters**
+
+* **maxiter** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Maximum number of iterations.
+* **size\_gen** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Population size of each generation.
+* **alpha** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Percentage (0, 1] of the population to be selected as elite selection.
+* **callback** (*Callable\[\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*, np.array,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*], None] | None*) – A callback function passed information in each iteration step. The information is, in this order: the number of function evaluations, the parameters, the best function value in this iteration.
+
+## Attributes
+
+
+
+### ELITE\_FACTOR
+
+`= 0.4`
+
+
+
+### STD\_BOUND
+
+`= 0.3`
+
+
+
+### alpha
+
+Returns the alpha parameter value (percentage of population selected to update probabilistic model)
+
+
+
+### bounds\_support\_level
+
+Returns bounds support level
+
+
+
+### gradient\_support\_level
+
+Returns gradient support level
+
+
+
+### initial\_point\_support\_level
+
+Returns initial point support level
+
+
+
+### is\_bounds\_ignored
+
+Returns is bounds ignored
+
+
+
+### is\_bounds\_required
+
+Returns is bounds required
+
+
+
+### is\_bounds\_supported
+
+Returns is bounds supported
+
+
+
+### is\_gradient\_ignored
+
+Returns is gradient ignored
+
+
+
+### is\_gradient\_required
+
+Returns is gradient required
+
+
+
+### is\_gradient\_supported
+
+Returns is gradient supported
+
+
+
+### is\_initial\_point\_ignored
+
+Returns is initial point ignored
+
+
+
+### is\_initial\_point\_required
+
+Returns is initial point required
+
+
+
+### is\_initial\_point\_supported
+
+Returns is initial point supported
+
+
+
+### maxiter
+
+Returns the maximum number of iterations
+
+
+
+### setting
+
+Return setting
+
+
+
+### settings
+
+
+
+### size\_gen
+
+Returns the size of the generations (number of individuals per generation)
+
+## Methods
+
+### get\_support\_level
+
+
+
+`get_support_level()`
+
+Get the support level dictionary.
+
+### gradient\_num\_diff
+
+
+
+`static gradient_num_diff(x_center, f, epsilon, max_evals_grouped=None)`
+
+We compute the gradient with the numeric differentiation in the parallel way, around the point x\_center.
+
+**Parameters**
+
+* **x\_center** (*ndarray*) – point around which we compute the gradient
+* **f** (*func*) – the function of which the gradient is to be computed.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the epsilon used in the numeric differentiation.
+* **max\_evals\_grouped** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max evals grouped, defaults to 1 (i.e. no batching).
+
+**Returns**
+
+the gradient computed
+
+**Return type**
+
+grad
+
+### minimize
+
+
+
+`minimize(fun, x0, jac=None, bounds=None)`
+
+Minimize the scalar function.
+
+**Parameters**
+
+* **fun** (*Callable\[\[POINT],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The scalar function to minimize.
+* **x0** (*POINT*) – The initial point for the minimization.
+* **jac** (*Callable\[\[POINT], POINT] | None*) – The gradient of the scalar function `fun`.
+* **bounds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Bounds for the variables of `fun`. This argument might be ignored if the optimizer does not support bounds.
+
+**Returns**
+
+The result of the optimization, containing e.g. the result as attribute `x`.
+
+**Return type**
+
+[OptimizerResult](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult")
+
+### print\_options
+
+
+
+`print_options()`
+
+Print algorithm-specific options.
+
+### set\_max\_evals\_grouped
+
+
+
+`set_max_evals_grouped(limit)`
+
+Set max evals grouped
+
+### set\_options
+
+
+
+`set_options(**kwargs)`
+
+Sets or updates values in the options dictionary.
+
+The options dictionary may be used internally by a given optimizer to pass additional optional values for the underlying optimizer/optimization function used. The options dictionary may be initially populated with a set of key/values when the given optimizer is constructed.
+
+**Parameters**
+
+**kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – options, given as name=value.
+
+### wrap\_function
+
+
+
+`static wrap_function(function, args)`
+
+Wrap the function to implicitly inject the args at the call of the function.
+
+**Parameters**
+
+* **function** (*func*) – the target function
+* **args** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the args to be injected
+
+**Returns**
+
+wrapper
+
+**Return type**
+
+function\_wrapper
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.md
new file mode 100644
index 00000000000..a0d332af743
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.md
@@ -0,0 +1,97 @@
+---
+title: optimizers
+description: API reference for qiskit.algorithms.optimizers
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.algorithms.optimizers
+---
+
+
+
+
+
+# qiskit.algorithms.optimizers
+
+
+
+## Optimizers
+
+
+
+`qiskit.algorithms.optimizers`
+
+It contains a variety of classical optimizers for use by quantum variational algorithms, such as [`VQE`](qiskit.algorithms.VQE "qiskit.algorithms.VQE"). Logically, these optimizers can be divided into two categories:
+
+**[Local Optimizers](#local-optimizers)**
+
+Given an optimization problem, a **local optimizer** is a function that attempts to find an optimal value within the neighboring set of a candidate solution.
+
+**[Global Optimizers](#global-optimizers)**
+
+Given an optimization problem, a **global optimizer** is a function that attempts to find an optimal value among all possible solutions.
+
+## Optimizer Base Class
+
+| | |
+| ---------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
+| [`OptimizerResult`](qiskit.algorithms.optimizers.OptimizerResult "qiskit.algorithms.optimizers.OptimizerResult") | The result of an optimization routine. |
+| [`OptimizerSupportLevel`](qiskit.algorithms.optimizers.OptimizerSupportLevel "qiskit.algorithms.optimizers.OptimizerSupportLevel") | Support Level enum for features such as bounds, gradient and initial point |
+| [`Optimizer`](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer") | Base class for optimization algorithm. |
+| [`Minimizer`](qiskit.algorithms.optimizers.Minimizer "qiskit.algorithms.optimizers.Minimizer") | Callable Protocol for minimizer. |
+
+## Steppable Optimizer Base Class
+
+| | |
+| -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- |
+| [`optimizer_utils`](qiskit.algorithms.optimizers.optimizer_utils#module-qiskit.algorithms.optimizers.optimizer_utils "qiskit.algorithms.optimizers.optimizer_utils") | Utils for optimizers |
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`SteppableOptimizer`](qiskit.algorithms.optimizers.SteppableOptimizer "qiskit.algorithms.optimizers.SteppableOptimizer") | Base class for a steppable optimizer. |
+| [`AskData`](qiskit.algorithms.optimizers.AskData "qiskit.algorithms.optimizers.AskData") | Base class for return type of [`ask()`](qiskit.algorithms.optimizers.SteppableOptimizer#ask "qiskit.algorithms.optimizers.SteppableOptimizer.ask"). |
+| [`TellData`](qiskit.algorithms.optimizers.TellData "qiskit.algorithms.optimizers.TellData") | Base class for argument type of [`tell()`](qiskit.algorithms.optimizers.SteppableOptimizer#tell "qiskit.algorithms.optimizers.SteppableOptimizer.tell"). |
+| [`OptimizerState`](qiskit.algorithms.optimizers.OptimizerState "qiskit.algorithms.optimizers.OptimizerState") | Base class representing the state of the optimizer. |
+
+## Local Optimizers
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
+| [`ADAM`](qiskit.algorithms.optimizers.ADAM "qiskit.algorithms.optimizers.ADAM") | Adam and AMSGRAD optimizers. |
+| [`AQGD`](qiskit.algorithms.optimizers.AQGD "qiskit.algorithms.optimizers.AQGD") | Analytic Quantum Gradient Descent (AQGD) with Epochs optimizer. |
+| [`CG`](qiskit.algorithms.optimizers.CG "qiskit.algorithms.optimizers.CG") | Conjugate Gradient optimizer. |
+| [`COBYLA`](qiskit.algorithms.optimizers.COBYLA "qiskit.algorithms.optimizers.COBYLA") | Constrained Optimization By Linear Approximation optimizer. |
+| [`L_BFGS_B`](qiskit.algorithms.optimizers.L_BFGS_B "qiskit.algorithms.optimizers.L_BFGS_B") | Limited-memory BFGS Bound optimizer. |
+| [`GSLS`](qiskit.algorithms.optimizers.GSLS "qiskit.algorithms.optimizers.GSLS") | Gaussian-smoothed Line Search. |
+| [`GradientDescent`](qiskit.algorithms.optimizers.GradientDescent "qiskit.algorithms.optimizers.GradientDescent") | The gradient descent minimization routine. |
+| [`GradientDescentState`](qiskit.algorithms.optimizers.GradientDescentState "qiskit.algorithms.optimizers.GradientDescentState") | State of [`GradientDescent`](qiskit.algorithms.optimizers.GradientDescent "qiskit.algorithms.optimizers.GradientDescent"). |
+| [`NELDER_MEAD`](qiskit.algorithms.optimizers.NELDER_MEAD "qiskit.algorithms.optimizers.NELDER_MEAD") | Nelder-Mead optimizer. |
+| [`NFT`](qiskit.algorithms.optimizers.NFT "qiskit.algorithms.optimizers.NFT") | Nakanishi-Fujii-Todo algorithm. |
+| [`P_BFGS`](qiskit.algorithms.optimizers.P_BFGS "qiskit.algorithms.optimizers.P_BFGS") | Parallelized Limited-memory BFGS optimizer. |
+| [`POWELL`](qiskit.algorithms.optimizers.POWELL "qiskit.algorithms.optimizers.POWELL") | Powell optimizer. |
+| [`SLSQP`](qiskit.algorithms.optimizers.SLSQP "qiskit.algorithms.optimizers.SLSQP") | Sequential Least SQuares Programming optimizer. |
+| [`SPSA`](qiskit.algorithms.optimizers.SPSA "qiskit.algorithms.optimizers.SPSA") | Simultaneous Perturbation Stochastic Approximation (SPSA) optimizer. |
+| [`QNSPSA`](qiskit.algorithms.optimizers.QNSPSA "qiskit.algorithms.optimizers.QNSPSA") | The Quantum Natural SPSA (QN-SPSA) optimizer. |
+| [`TNC`](qiskit.algorithms.optimizers.TNC "qiskit.algorithms.optimizers.TNC") | Truncated Newton (TNC) optimizer. |
+| [`SciPyOptimizer`](qiskit.algorithms.optimizers.SciPyOptimizer "qiskit.algorithms.optimizers.SciPyOptimizer") | A general Qiskit Optimizer wrapping scipy.optimize.minimize. |
+| [`UMDA`](qiskit.algorithms.optimizers.UMDA "qiskit.algorithms.optimizers.UMDA") | Continuous Univariate Marginal Distribution Algorithm (UMDA). |
+
+Qiskit also provides the following optimizers, which are built-out using the optimizers from the scikit-quant package. The scikit-quant package is not installed by default but must be explicitly installed, if desired, by the user - the optimizers therein are provided under various licenses so it has been made an optional install for the end user to choose whether to do so or not. To install the scikit-quant dependent package you can use pip install scikit-quant.
+
+| | |
+| ---------------------------------------------------------------------------------------- | -------------------------------------------------------- |
+| [`BOBYQA`](qiskit.algorithms.optimizers.BOBYQA "qiskit.algorithms.optimizers.BOBYQA") | Bound Optimization BY Quadratic Approximation algorithm. |
+| [`IMFIL`](qiskit.algorithms.optimizers.IMFIL "qiskit.algorithms.optimizers.IMFIL") | IMplicit FILtering algorithm. |
+| [`SNOBFIT`](qiskit.algorithms.optimizers.SNOBFIT "qiskit.algorithms.optimizers.SNOBFIT") | Stable Noisy Optimization by Branch and FIT algorithm. |
+
+## Global Optimizers
+
+The global optimizers here all use NLopt for their core function and can only be used if their dependent NLopt package is manually installed.
+
+| | |
+| ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
+| [`CRS`](qiskit.algorithms.optimizers.CRS "qiskit.algorithms.optimizers.CRS") | Controlled Random Search (CRS) with local mutation optimizer. |
+| [`DIRECT_L`](qiskit.algorithms.optimizers.DIRECT_L "qiskit.algorithms.optimizers.DIRECT_L") | DIviding RECTangles Locally-biased optimizer. |
+| [`DIRECT_L_RAND`](qiskit.algorithms.optimizers.DIRECT_L_RAND "qiskit.algorithms.optimizers.DIRECT_L_RAND") | DIviding RECTangles Locally-biased Randomized optimizer. |
+| [`ESCH`](qiskit.algorithms.optimizers.ESCH "qiskit.algorithms.optimizers.ESCH") | ESCH evolutionary optimizer. |
+| [`ISRES`](qiskit.algorithms.optimizers.ISRES "qiskit.algorithms.optimizers.ISRES") | Improved Stochastic Ranking Evolution Strategy optimizer. |
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.optimizer_utils.LearningRate.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.optimizer_utils.LearningRate.md
new file mode 100644
index 00000000000..911e13ad1b8
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.optimizer_utils.LearningRate.md
@@ -0,0 +1,56 @@
+---
+title: LearningRate
+description: API reference for qiskit.algorithms.optimizers.optimizer_utils.LearningRate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.optimizers.optimizer_utils.LearningRate
+---
+
+# LearningRate
+
+
+
+`qiskit.algorithms.optimizers.optimizer_utils.LearningRate(learning_rate)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/optimizers/optimizer_utils/learning_rate.py "view source code")
+
+Bases: [`Generator`](https://docs.python.org/3/library/collections.abc.html#collections.abc.Generator "(in Python v3.12)")
+
+Represents a Learning Rate. Will be an attribute of [`GradientDescentState`](qiskit.algorithms.optimizers.GradientDescentState "qiskit.algorithms.optimizers.GradientDescentState"). Note that [`GradientDescent`](qiskit.algorithms.optimizers.GradientDescent "qiskit.algorithms.optimizers.GradientDescent") also has a learning rate. That learning rate can be a float, a list, an array, a function returning a generator and will be used to create a generator to be used during the optimization process. This class wraps `Generator` so that we can also access the last yielded value.
+
+**Parameters**
+
+**learning\_rate** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | np.ndarray | Callable\[\[], Generator\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*, None, None]]*) – Used to create a generator to iterate on.
+
+## Attributes
+
+
+
+### current
+
+Returns the current value of the learning rate.
+
+## Methods
+
+### close
+
+
+
+`close()`
+
+Raise GeneratorExit inside generator.
+
+### send
+
+
+
+`send(value)`
+
+Send a value into the generator. Return next yielded value or raise StopIteration.
+
+### throw
+
+
+
+`throw(typ, val=None, tb=None)`
+
+Raise an exception in the generator. Return next yielded value or raise StopIteration.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.optimizer_utils.md b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.optimizer_utils.md
new file mode 100644
index 00000000000..3a8255470b0
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.optimizers.optimizer_utils.md
@@ -0,0 +1,28 @@
+---
+title: optimizer_utils
+description: API reference for qiskit.algorithms.optimizers.optimizer_utils
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.algorithms.optimizers.optimizer_utils
+---
+
+
+
+
+
+# qiskit.algorithms.optimizers.optimizer\_utils
+
+Utils for optimizers
+
+
+
+## Optimizer Utils
+
+
+
+`qiskit.algorithms.optimizers.optimizer_utils`
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- |
+| [`LearningRate`](qiskit.algorithms.optimizers.optimizer_utils.LearningRate "qiskit.algorithms.optimizers.optimizer_utils.LearningRate") | Represents a Learning Rate. |
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.state_fidelities.BaseStateFidelity.md b/docs/api/qiskit/0.46/qiskit.algorithms.state_fidelities.BaseStateFidelity.md
new file mode 100644
index 00000000000..a3722fff2cd
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.state_fidelities.BaseStateFidelity.md
@@ -0,0 +1,71 @@
+---
+title: BaseStateFidelity
+description: API reference for qiskit.algorithms.state_fidelities.BaseStateFidelity
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.state_fidelities.BaseStateFidelity
+---
+
+# BaseStateFidelity
+
+
+
+`qiskit.algorithms.state_fidelities.BaseStateFidelity`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/state_fidelities/base_state_fidelity.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+An interface to calculate state fidelities (state overlaps) for pairs of (parametrized) quantum circuits. The calculation depends on the particular fidelity method implementation, but can be always defined as the state overlap:
+
+$$
+|\langle\psi(x)|\phi(y)\rangle|^2
+$$
+
+where $x$ and $y$ are optional parametrizations of the states $\psi$ and $\phi$ prepared by the circuits `circuit_1` and `circuit_2`, respectively.
+
+## Methods
+
+### create\_fidelity\_circuit
+
+
+
+`abstract create_fidelity_circuit(circuit_1, circuit_2)`
+
+Implementation-dependent method to create a fidelity circuit from 2 circuit inputs.
+
+**Parameters**
+
+* **circuit\_1** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")) – (Parametrized) quantum circuit.
+* **circuit\_2** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")) – (Parametrized) quantum circuit.
+
+**Returns**
+
+The fidelity quantum circuit corresponding to `circuit_1` and `circuit_2`.
+
+**Return type**
+
+[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+### run
+
+
+
+`run(circuits_1, circuits_2, values_1=None, values_2=None, **options)`
+
+Runs asynchronously the state overlap (fidelity) calculation between two (parametrized) circuits (first and second) for a specific set of parameter values (first and second). This calculation depends on the particular fidelity method implementation.
+
+**Parameters**
+
+* **circuits\_1** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – (Parametrized) quantum circuits preparing $|\psi\rangle$.
+* **circuits\_2** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – (Parametrized) quantum circuits preparing $|\phi\rangle$.
+* **values\_1** (*Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Numerical parameters to be bound to the first set of circuits.
+* **values\_2** (*Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Numerical parameters to be bound to the second set of circuits.
+* **options** – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > fidelity’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting.
+
+**Returns**
+
+Primitive job for the fidelity calculation. The job’s result is an instance of `StateFidelityResult`.
+
+**Return type**
+
+[AlgorithmJob](qiskit.algorithms.AlgorithmJob "qiskit.algorithms.AlgorithmJob")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.state_fidelities.ComputeUncompute.md b/docs/api/qiskit/0.46/qiskit.algorithms.state_fidelities.ComputeUncompute.md
new file mode 100644
index 00000000000..7c8c07acfcf
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.state_fidelities.ComputeUncompute.md
@@ -0,0 +1,117 @@
+---
+title: ComputeUncompute
+description: API reference for qiskit.algorithms.state_fidelities.ComputeUncompute
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.state_fidelities.ComputeUncompute
+---
+
+# ComputeUncompute
+
+
+
+`qiskit.algorithms.state_fidelities.ComputeUncompute(sampler, options=None, local=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/state_fidelities/compute_uncompute.py "view source code")
+
+Bases: [`BaseStateFidelity`](qiskit.algorithms.state_fidelities.BaseStateFidelity "qiskit.algorithms.state_fidelities.base_state_fidelity.BaseStateFidelity")
+
+This class leverages the sampler primitive to calculate the state fidelity of two quantum circuits following the compute-uncompute method (see \[1] for further reference). The fidelity can be defined as the state overlap.
+
+$$
+|\langle\psi(x)|\phi(y)\rangle|^2
+$$
+
+where $x$ and $y$ are optional parametrizations of the states $\psi$ and $\phi$ prepared by the circuits `circuit_1` and `circuit_2`, respectively.
+
+**Reference:** \[1] Havlíček, V., Córcoles, A. D., Temme, K., Harrow, A. W., Kandala, A., Chow, J. M., & Gambetta, J. M. (2019). Supervised learning with quantum-enhanced feature spaces. Nature, 567(7747), 209-212. [arXiv:1804.11326v2 \[quant-ph\]](https://arxiv.org/pdf/1804.11326.pdf)
+
+**Parameters**
+
+* **sampler** ([*BaseSampler*](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler")) – Sampler primitive instance.
+
+* **options** ([*Options*](qiskit.providers.Options "qiskit.providers.Options") *| None*) – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > fidelity’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting.
+
+* **local** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) –
+
+ If set to `True`, the fidelity is averaged over single-qubit projectors
+
+ $$
+ \hat{O} = \frac{1}{N}\sum_{i=1}^N|0_i\rangle\langle 0_i|,
+ $$
+
+ instead of the global projector $|0\rangle\langle 0|^{\otimes n}$. This coincides with the standard (global) fidelity in the limit of the fidelity approaching 1. Might be used to increase the variance to improve trainability in algorithms such as `PVQD`.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If the sampler is not an instance of `BaseSampler`.
+
+## Attributes
+
+
+
+### options
+
+Return the union of estimator options setting and fidelity default options, where, if the same field is set in both, the fidelity’s default options override the primitive’s default setting.
+
+**Returns**
+
+The fidelity default + estimator options.
+
+## Methods
+
+### create\_fidelity\_circuit
+
+
+
+`create_fidelity_circuit(circuit_1, circuit_2)`
+
+Combines `circuit_1` and `circuit_2` to create the fidelity circuit following the compute-uncompute method.
+
+**Parameters**
+
+* **circuit\_1** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")) – (Parametrized) quantum circuit.
+* **circuit\_2** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")) – (Parametrized) quantum circuit.
+
+**Returns**
+
+The fidelity quantum circuit corresponding to circuit\_1 and circuit\_2.
+
+**Return type**
+
+[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+### run
+
+
+
+`run(circuits_1, circuits_2, values_1=None, values_2=None, **options)`
+
+Runs asynchronously the state overlap (fidelity) calculation between two (parametrized) circuits (first and second) for a specific set of parameter values (first and second). This calculation depends on the particular fidelity method implementation.
+
+**Parameters**
+
+* **circuits\_1** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – (Parametrized) quantum circuits preparing $|\psi\rangle$.
+* **circuits\_2** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – (Parametrized) quantum circuits preparing $|\phi\rangle$.
+* **values\_1** (*Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Numerical parameters to be bound to the first set of circuits.
+* **values\_2** (*Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Numerical parameters to be bound to the second set of circuits.
+* **options** – Primitive backend runtime options used for circuit execution. The order of priority is: options in `run` method > fidelity’s default options > primitive’s default setting. Higher priority setting overrides lower priority setting.
+
+**Returns**
+
+Primitive job for the fidelity calculation. The job’s result is an instance of `StateFidelityResult`.
+
+**Return type**
+
+[AlgorithmJob](qiskit.algorithms.AlgorithmJob "qiskit.algorithms.AlgorithmJob")
+
+### update\_default\_options
+
+
+
+`update_default_options(**options)`
+
+Update the fidelity’s default options setting.
+
+**Parameters**
+
+**\*\*options** – The fields to update the default options.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.state_fidelities.StateFidelityResult.md b/docs/api/qiskit/0.46/qiskit.algorithms.state_fidelities.StateFidelityResult.md
new file mode 100644
index 00000000000..3450e82de80
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.state_fidelities.StateFidelityResult.md
@@ -0,0 +1,52 @@
+---
+title: StateFidelityResult
+description: API reference for qiskit.algorithms.state_fidelities.StateFidelityResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.state_fidelities.StateFidelityResult
+---
+
+# StateFidelityResult
+
+
+
+`qiskit.algorithms.state_fidelities.StateFidelityResult(fidelities, raw_fidelities, metadata, options)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/state_fidelities/state_fidelity_result.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+This class stores the result of StateFidelity computations.
+
+## Attributes
+
+
+
+### fidelities
+
+`Sequence[float]`
+
+List of truncated fidelity values for each pair of input circuits, ensured to be in \[0,1].
+
+
+
+### raw\_fidelities
+
+`Sequence[float]`
+
+List of raw fidelity values for each pair of input circuits, which might not be in \[0,1] depending on the error mitigation method used.
+
+
+
+### metadata
+
+`Sequence[Mapping[str, Any]]`
+
+Additional information about the fidelity calculation.
+
+
+
+### options
+
+`Options`
+
+Primitive runtime options for the execution of the fidelity job.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.state_fidelities.md b/docs/api/qiskit/0.46/qiskit.algorithms.state_fidelities.md
new file mode 100644
index 00000000000..5479b77e6f4
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.state_fidelities.md
@@ -0,0 +1,35 @@
+---
+title: state_fidelities
+description: API reference for qiskit.algorithms.state_fidelities
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.algorithms.state_fidelities
+---
+
+
+
+
+
+# qiskit.algorithms.state\_fidelities
+
+
+
+## State Fidelity Interfaces
+
+
+
+`qiskit.algorithms.state_fidelities`
+
+### State Fidelities
+
+| | |
+| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`BaseStateFidelity`](qiskit.algorithms.state_fidelities.BaseStateFidelity "qiskit.algorithms.state_fidelities.BaseStateFidelity")() | An interface to calculate state fidelities (state overlaps) for pairs of (parametrized) quantum circuits. |
+| [`ComputeUncompute`](qiskit.algorithms.state_fidelities.ComputeUncompute "qiskit.algorithms.state_fidelities.ComputeUncompute")(sampler\[, options, local]) | This class leverages the sampler primitive to calculate the state fidelity of two quantum circuits following the compute-uncompute method (see \[1] for further reference). |
+
+### Results
+
+> | | |
+> | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
+> | [`StateFidelityResult`](qiskit.algorithms.state_fidelities.StateFidelityResult "qiskit.algorithms.state_fidelities.StateFidelityResult")(fidelities, ...) | This class stores the result of StateFidelity computations. |
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.trotterization.TrotterQRTE.md b/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.trotterization.TrotterQRTE.md
new file mode 100644
index 00000000000..a30f0e6fe83
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.trotterization.TrotterQRTE.md
@@ -0,0 +1,109 @@
+---
+title: TrotterQRTE
+description: API reference for qiskit.algorithms.time_evolvers.trotterization.TrotterQRTE
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.time_evolvers.trotterization.TrotterQRTE
+---
+
+# TrotterQRTE
+
+
+
+`qiskit.algorithms.time_evolvers.trotterization.TrotterQRTE(product_formula=None, estimator=None, num_timesteps=1)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/time_evolvers/trotterization/trotter_qrte.py "view source code")
+
+Bases: [`RealTimeEvolver`](qiskit.algorithms.RealTimeEvolver "qiskit.algorithms.time_evolvers.real_time_evolver.RealTimeEvolver")
+
+Quantum Real Time Evolution using Trotterization. Type of Trotterization is defined by a `ProductFormula` provided.
+
+**Examples**
+
+```python
+from qiskit.opflow import PauliSumOp
+from qiskit.quantum_info import Pauli, SparsePauliOp
+from qiskit import QuantumCircuit
+from qiskit.algorithms import TimeEvolutionProblem
+from qiskit.algorithms.time_evolvers import TrotterQRTE
+from qiskit.primitives import Estimator
+
+operator = PauliSumOp(SparsePauliOp([Pauli("X"), Pauli("Z")]))
+initial_state = QuantumCircuit(1)
+time = 1
+evolution_problem = TimeEvolutionProblem(operator, time, initial_state)
+# LieTrotter with 1 rep
+estimator = Estimator()
+trotter_qrte = TrotterQRTE(estimator=estimator)
+evolved_state = trotter_qrte.evolve(evolution_problem).evolved_state
+```
+
+**Parameters**
+
+* **product\_formula** ([*ProductFormula*](qiskit.synthesis.ProductFormula "qiskit.synthesis.ProductFormula") *| None*) – A Lie-Trotter-Suzuki product formula. If `None` provided, the Lie-Trotter first order product formula with a single repetition is used. `reps` should be 1 to obtain a number of time-steps equal to `num_timesteps` and an evaluation of [`TimeEvolutionProblem.aux_operators`](qiskit.algorithms.TimeEvolutionProblem#aux_operators "qiskit.algorithms.TimeEvolutionProblem.aux_operators") at every time-step. If `reps` is larger than 1, the true number of time-steps will be `num_timesteps * reps`.
+* **num\_timesteps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of time-steps the full evolution time is devided into (repetitions of `product_formula`)
+* **estimator** ([*BaseEstimator*](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator") *| None*) – An estimator primitive used for calculating expectation values of `TimeEvolutionProblem.aux_operators`.
+
+## Attributes
+
+
+
+### estimator
+
+Returns an estimator.
+
+
+
+### num\_timesteps
+
+Returns the number of timesteps.
+
+
+
+### product\_formula
+
+Returns a product formula.
+
+## Methods
+
+### evolve
+
+
+
+`evolve(evolution_problem)`
+
+Evolves a quantum state for a given time using the Trotterization method based on a product formula provided. The result is provided in the form of a quantum circuit. If auxiliary operators are included in the `evolution_problem`, they are evaluated on the `init_state` and on the evolved state at every step (`num_timesteps` times) using an estimator primitive provided.
+
+**Parameters**
+
+**evolution\_problem** ([*TimeEvolutionProblem*](qiskit.algorithms.TimeEvolutionProblem "qiskit.algorithms.time_evolvers.time_evolution_problem.TimeEvolutionProblem")) – Instance defining evolution problem. For the included Hamiltonian, `Pauli` or `PauliSumOp` are supported by TrotterQRTE.
+
+**Returns**
+
+Evolution result that includes an evolved state as a quantum circuit and, optionally, auxiliary operators evaluated for a resulting state on an estimator primitive.
+
+**Raises**
+
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `t_param` is not set to `None` in the `TimeEvolutionProblem` (feature not currently supported).
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `aux_operators` provided in the time evolution problem but no estimator provided to the algorithm.
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If the `initial_state` is not provided in the `TimeEvolutionProblem`.
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If an unsupported Hamiltonian type is provided.
+
+**Return type**
+
+[*TimeEvolutionResult*](qiskit.algorithms.TimeEvolutionResult "qiskit.algorithms.time_evolvers.time_evolution_result.TimeEvolutionResult")
+
+### supports\_aux\_operators
+
+
+
+`classmethod supports_aux_operators()`
+
+Whether computing the expectation value of auxiliary operators is supported.
+
+**Returns**
+
+`True` if `aux_operators` expectations in the `TimeEvolutionProblem` can be evaluated, `False` otherwise.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.trotterization.md b/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.trotterization.md
new file mode 100644
index 00000000000..6546eaa58bc
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.trotterization.md
@@ -0,0 +1,22 @@
+---
+title: trotterization
+description: API reference for qiskit.algorithms.time_evolvers.trotterization
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.algorithms.time_evolvers.trotterization
+---
+
+
+
+
+
+# qiskit.algorithms.time\_evolvers.trotterization
+
+This package contains Trotterization-based Quantum Real Time Evolution algorithm. It is compliant with the new Quantum Time Evolution Framework and makes use of `qiskit.synthesis.evolution.ProductFormula` and [`PauliEvolutionGate`](qiskit.circuit.library.PauliEvolutionGate "qiskit.circuit.library.PauliEvolutionGate") implementations.
+
+## Trotterization-based Quantum Real Time Evolution
+
+| | |
+| ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
+| [`TrotterQRTE`](qiskit.algorithms.time_evolvers.trotterization.TrotterQRTE "qiskit.algorithms.time_evolvers.trotterization.TrotterQRTE") | Quantum Real Time Evolution using Trotterization. |
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.ForwardEulerSolver.md b/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.ForwardEulerSolver.md
new file mode 100644
index 00000000000..9d255fb58e7
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.ForwardEulerSolver.md
@@ -0,0 +1,42 @@
+---
+title: ForwardEulerSolver
+description: API reference for qiskit.algorithms.time_evolvers.variational.ForwardEulerSolver
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.time_evolvers.variational.ForwardEulerSolver
+---
+
+# ForwardEulerSolver
+
+
+
+`qiskit.algorithms.time_evolvers.variational.ForwardEulerSolver(function, t0, y0, t_bound, vectorized=False, support_complex=False, num_t_steps=15)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/time_evolvers/variational/solvers/ode/forward_euler_solver.py "view source code")
+
+Bases: `OdeSolver`
+
+Forward Euler ODE solver.
+
+Forward Euler ODE solver that implements an interface from SciPy.
+
+**Parameters**
+
+* **function** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)")) – Right-hand side of the system. The calling signature is `fun(t, y)`. Here `t` is a scalar, and there are two options for the ndarray `y`: It can either have shape (n,); then `fun` must return array\_like with shape (n,). Alternatively it can have shape (n, k); then `fun` must return an array\_like with shape (n, k), i.e., each column corresponds to a single column in `y`. The choice between the two options is determined by vectorized argument (see below). The vectorized implementation allows a faster approximation of the Jacobian by finite differences (required for this solver).
+* **t0** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Initial time.
+* **y0** ([*Sequence*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Sequence "(in Python v3.12)")) – Initial state.
+* **t\_bound** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Boundary time - the integration won’t continue beyond it. It also determines the direction of the integration.
+* **vectorized** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether `fun` is implemented in a vectorized fashion. Default is False.
+* **support\_complex** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether integration in a complex domain should be supported. Generally determined by a derived solver class capabilities. Default is False.
+* **num\_t\_steps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of time steps for the forward Euler method.
+
+## Attributes
+
+
+
+### TOO\_SMALL\_STEP
+
+`= 'Required step size is less than spacing between numbers.'`
+
+
+
+### step\_size
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.ImaginaryMcLachlanPrinciple.md b/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.ImaginaryMcLachlanPrinciple.md
new file mode 100644
index 00000000000..f3460cb2fab
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.ImaginaryMcLachlanPrinciple.md
@@ -0,0 +1,56 @@
+---
+title: ImaginaryMcLachlanPrinciple
+description: API reference for qiskit.algorithms.time_evolvers.variational.ImaginaryMcLachlanPrinciple
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.time_evolvers.variational.ImaginaryMcLachlanPrinciple
+---
+
+# ImaginaryMcLachlanPrinciple
+
+
+
+`qiskit.algorithms.time_evolvers.variational.ImaginaryMcLachlanPrinciple(qgt=None, gradient=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/time_evolvers/variational/variational_principles/imaginary_mc_lachlan_principle.py "view source code")
+
+Bases: [`ImaginaryVariationalPrinciple`](qiskit.algorithms.time_evolvers.variational.ImaginaryVariationalPrinciple "qiskit.algorithms.time_evolvers.variational.variational_principles.imaginary_variational_principle.ImaginaryVariationalPrinciple")
+
+Class for an Imaginary McLachlan’s Variational Principle. It aims to minimize the distance between both sides of the Wick-rotated Schrödinger equation with a quantum state given as a parametrized trial state. The principle leads to a system of linear equations handled by a linear solver. The imaginary variant means that we consider imaginary time dynamics.
+
+**Parameters**
+
+* **qgt** ([*BaseQGT*](qiskit.algorithms.gradients.BaseQGT "qiskit.algorithms.gradients.BaseQGT") *| None*) – Instance of a the GQT class used to compute the QFI. If `None` provided, `LinCombQGT` is used.
+* **gradient** ([*BaseEstimatorGradient*](qiskit.algorithms.gradients.BaseEstimatorGradient "qiskit.algorithms.gradients.BaseEstimatorGradient") *| None*) – Instance of a class used to compute the state gradient. If `None` provided, `LinCombEstimatorGradient` is used.
+
+**Raises**
+
+[**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – If the gradient instance does not contain an estimator.
+
+## Methods
+
+### evolution\_gradient
+
+
+
+`evolution_gradient(hamiltonian, ansatz, param_values, gradient_params=None)`
+
+Calculates an evolution gradient according to the rules of this variational principle.
+
+**Parameters**
+
+* **hamiltonian** (*BaseOperator*) – Operator used for Variational Quantum Time Evolution.
+* **ansatz** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – Quantum state in the form of a parametrized quantum circuit.
+* **param\_values** (*Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – Values of parameters to be bound.
+* **gradient\_params** (*Sequence\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*] | None*) – List of parameters with respect to which gradients should be computed. If `None` given, gradients w\.r.t. all parameters will be computed.
+
+**Returns**
+
+An evolution gradient.
+
+**Raises**
+
+[**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – If a gradient job fails.
+
+**Return type**
+
+np.ndarray
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.ImaginaryVariationalPrinciple.md b/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.ImaginaryVariationalPrinciple.md
new file mode 100644
index 00000000000..a7c8270ca0a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.ImaginaryVariationalPrinciple.md
@@ -0,0 +1,23 @@
+---
+title: ImaginaryVariationalPrinciple
+description: API reference for qiskit.algorithms.time_evolvers.variational.ImaginaryVariationalPrinciple
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.time_evolvers.variational.ImaginaryVariationalPrinciple
+---
+
+# ImaginaryVariationalPrinciple
+
+
+
+`qiskit.algorithms.time_evolvers.variational.ImaginaryVariationalPrinciple(qgt, gradient)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/time_evolvers/variational/variational_principles/imaginary_variational_principle.py "view source code")
+
+Bases: [`VariationalPrinciple`](qiskit.algorithms.time_evolvers.variational.VariationalPrinciple "qiskit.algorithms.time_evolvers.variational.variational_principles.variational_principle.VariationalPrinciple"), [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Abstract class for an Imaginary Variational Principle. The imaginary variant means that we consider imaginary time dynamics.
+
+**Parameters**
+
+* **qgt** ([*BaseQGT*](qiskit.algorithms.gradients.BaseQGT "qiskit.algorithms.gradients.BaseQGT")) – Instance of a class used to compute the GQT.
+* **gradient** ([*BaseEstimatorGradient*](qiskit.algorithms.gradients.BaseEstimatorGradient "qiskit.algorithms.gradients.BaseEstimatorGradient")) – Instance of a class used to compute the state gradient.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.RealMcLachlanPrinciple.md b/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.RealMcLachlanPrinciple.md
new file mode 100644
index 00000000000..0de5c9639eb
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.RealMcLachlanPrinciple.md
@@ -0,0 +1,56 @@
+---
+title: RealMcLachlanPrinciple
+description: API reference for qiskit.algorithms.time_evolvers.variational.RealMcLachlanPrinciple
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.time_evolvers.variational.RealMcLachlanPrinciple
+---
+
+# RealMcLachlanPrinciple
+
+
+
+`qiskit.algorithms.time_evolvers.variational.RealMcLachlanPrinciple(qgt=None, gradient=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/time_evolvers/variational/variational_principles/real_mc_lachlan_principle.py "view source code")
+
+Bases: [`RealVariationalPrinciple`](qiskit.algorithms.time_evolvers.variational.RealVariationalPrinciple "qiskit.algorithms.time_evolvers.variational.variational_principles.real_variational_principle.RealVariationalPrinciple")
+
+Class for a Real McLachlan’s Variational Principle. It aims to minimize the distance between both sides of the Schrödinger equation with a quantum state given as a parametrized trial state. The principle leads to a system of linear equations handled by a linear solver. The real variant means that we consider real time dynamics.
+
+**Parameters**
+
+* **qgt** ([*BaseQGT*](qiskit.algorithms.gradients.BaseQGT "qiskit.algorithms.gradients.BaseQGT") *| None*) – Instance of a the GQT class used to compute the QFI. If `None` provided, `LinCombQGT` is used.
+* **gradient** ([*BaseEstimatorGradient*](qiskit.algorithms.gradients.BaseEstimatorGradient "qiskit.algorithms.gradients.BaseEstimatorGradient") *| None*) – Instance of a class used to compute the state gradient. If `None` provided, `LinCombEstimatorGradient` is used.
+
+**Raises**
+
+[**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – If the gradient instance does not contain an estimator.
+
+## Methods
+
+### evolution\_gradient
+
+
+
+`evolution_gradient(hamiltonian, ansatz, param_values, gradient_params=None)`
+
+Calculates an evolution gradient according to the rules of this variational principle.
+
+**Parameters**
+
+* **hamiltonian** (*BaseOperator*) – Operator used for Variational Quantum Time Evolution.
+* **ansatz** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – Quantum state in the form of a parametrized quantum circuit.
+* **param\_values** (*Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – Values of parameters to be bound.
+* **gradient\_params** (*Sequence\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*] | None*) – List of parameters with respect to which gradients should be computed. If `None` given, gradients w\.r.t. all parameters will be computed.
+
+**Returns**
+
+An evolution gradient.
+
+**Raises**
+
+[**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – If a gradient job fails.
+
+**Return type**
+
+np.ndarray
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.RealVariationalPrinciple.md b/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.RealVariationalPrinciple.md
new file mode 100644
index 00000000000..28e79ff4d8b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.RealVariationalPrinciple.md
@@ -0,0 +1,23 @@
+---
+title: RealVariationalPrinciple
+description: API reference for qiskit.algorithms.time_evolvers.variational.RealVariationalPrinciple
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.time_evolvers.variational.RealVariationalPrinciple
+---
+
+# RealVariationalPrinciple
+
+
+
+`qiskit.algorithms.time_evolvers.variational.RealVariationalPrinciple(qgt, gradient)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/time_evolvers/variational/variational_principles/real_variational_principle.py "view source code")
+
+Bases: [`VariationalPrinciple`](qiskit.algorithms.time_evolvers.variational.VariationalPrinciple "qiskit.algorithms.time_evolvers.variational.variational_principles.variational_principle.VariationalPrinciple"), [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Class for a Real Variational Principle. The real variant means that we consider real time dynamics.
+
+**Parameters**
+
+* **qgt** ([*BaseQGT*](qiskit.algorithms.gradients.BaseQGT "qiskit.algorithms.gradients.BaseQGT")) – Instance of a class used to compute the GQT.
+* **gradient** ([*BaseEstimatorGradient*](qiskit.algorithms.gradients.BaseEstimatorGradient "qiskit.algorithms.gradients.BaseEstimatorGradient")) – Instance of a class used to compute the state gradient.
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.VariationalPrinciple.md b/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.VariationalPrinciple.md
new file mode 100644
index 00000000000..72959fe10f1
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.VariationalPrinciple.md
@@ -0,0 +1,93 @@
+---
+title: VariationalPrinciple
+description: API reference for qiskit.algorithms.time_evolvers.variational.VariationalPrinciple
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.algorithms.time_evolvers.variational.VariationalPrinciple
+---
+
+# VariationalPrinciple
+
+
+
+`qiskit.algorithms.time_evolvers.variational.VariationalPrinciple(qgt, gradient)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/time_evolvers/variational/variational_principles/variational_principle.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+A Variational Principle class. It determines the time propagation of parameters in a quantum state provided as a parametrized quantum circuit (ansatz).
+
+
+
+### qgt
+
+Instance of a class used to compute the GQT.
+
+**Type**
+
+[BaseQGT](qiskit.algorithms.gradients.BaseQGT "qiskit.algorithms.gradients.BaseQGT")
+
+
+
+### gradient
+
+Instance of a class used to compute the state gradient.
+
+**Type**
+
+[BaseEstimatorGradient](qiskit.algorithms.gradients.BaseEstimatorGradient "qiskit.algorithms.gradients.BaseEstimatorGradient")
+
+**Parameters**
+
+* **qgt** ([*BaseQGT*](qiskit.algorithms.gradients.BaseQGT "qiskit.algorithms.gradients.BaseQGT")) – Instance of a class used to compute the GQT.
+* **gradient** ([*BaseEstimatorGradient*](qiskit.algorithms.gradients.BaseEstimatorGradient "qiskit.algorithms.gradients.BaseEstimatorGradient")) – Instance of a class used to compute the state gradient.
+
+## Methods
+
+### evolution\_gradient
+
+
+
+`abstract evolution_gradient(hamiltonian, ansatz, param_values, gradient_params=None)`
+
+Calculates an evolution gradient according to the rules of this variational principle.
+
+**Parameters**
+
+* **hamiltonian** (*BaseOperator*) – Operator used for Variational Quantum Time Evolution.
+* **ansatz** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – Quantum state in the form of a parametrized quantum circuit.
+* **param\_values** (*Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – Values of parameters to be bound.
+* **gradient\_params** (*Sequence\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*] | None*) – List of parameters with respect to which gradients should be computed. If `None` given, gradients w\.r.t. all parameters will be computed.
+
+**Returns**
+
+An evolution gradient.
+
+**Return type**
+
+np.ndarray
+
+### metric\_tensor
+
+
+
+`metric_tensor(ansatz, param_values)`
+
+Calculates a metric tensor according to the rules of this variational principle.
+
+**Parameters**
+
+* **ansatz** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")) – Quantum state in the form of a parametrized quantum circuit.
+* **param\_values** ([*Sequence*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Sequence "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – Values of parameters to be bound.
+
+**Returns**
+
+Metric tensor.
+
+**Raises**
+
+[**AlgorithmError**](algorithms#qiskit.algorithms.AlgorithmError "qiskit.algorithms.AlgorithmError") – If a QFI job fails.
+
+**Return type**
+
+[*Sequence*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Sequence "(in Python v3.12)")\[[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")]
+
diff --git a/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.md b/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.md
new file mode 100644
index 00000000000..4a573fcddb1
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.algorithms.time_evolvers.variational.md
@@ -0,0 +1,78 @@
+---
+title: variational
+description: API reference for qiskit.algorithms.time_evolvers.variational
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.algorithms.time_evolvers.variational
+---
+
+
+
+
+
+# qiskit.algorithms.time\_evolvers.variational
+
+
+
+## Variational Quantum Time Evolutions
+
+
+
+`qiskit.algorithms.time_evolvers.variational`
+
+Algorithms for performing Variational Quantum Time Evolution of quantum states, which can be tailored to near-term devices. `VarQTE` base class exposes an interface, compliant with the Quantum Time Evolution Framework in Qiskit Terra, that is implemented by [`VarQRTE`](qiskit.algorithms.VarQRTE "qiskit.algorithms.VarQRTE") and [`VarQITE`](qiskit.algorithms.VarQITE "qiskit.algorithms.VarQITE") classes for real and imaginary time evolution respectively. The variational approach is taken according to a variational principle chosen by a user.
+
+**Example**
+
+```python
+import numpy as np
+
+from qiskit.algorithms import TimeEvolutionProblem, VarQITE
+from qiskit.algorithms.time_evolvers.variational import ImaginaryMcLachlanPrinciple
+from qiskit.circuit.library import EfficientSU2
+from qiskit.quantum_info import SparsePauliOp
+
+observable = SparsePauliOp.from_list(
+ [
+ ("II", 0.2252),
+ ("ZZ", 0.5716),
+ ("IZ", 0.3435),
+ ("ZI", -0.4347),
+ ("YY", 0.091),
+ ("XX", 0.091),
+ ]
+)
+
+ansatz = EfficientSU2(observable.num_qubits, reps=1)
+init_param_values = np.zeros(len(ansatz.parameters))
+for i in range(len(ansatz.parameters)):
+ init_param_values[i] = np.pi / 2
+var_principle = ImaginaryMcLachlanPrinciple()
+time = 1
+evolution_problem = TimeEvolutionProblem(observable, time)
+var_qite = VarQITE(ansatz, var_principle, init_param_values)
+evolution_result = var_qite.evolve(evolution_problem)
+```
+
+### Variational Principles
+
+With variational principles we can project time evolution of a quantum state onto the parameters of a model, in our case a variational quantum circuit.
+
+They can be divided into two categories: Variational Quantum \_Real\_ Time Evolution, which evolves the variational ansatz under the standard Schroediger equation and Variational Quantum \_Imaginary\_ Time Evolution, which evolves under the normalized Wick-rotated Schroedinger equation.
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
+| [`VariationalPrinciple`](qiskit.algorithms.time_evolvers.variational.VariationalPrinciple "qiskit.algorithms.time_evolvers.variational.VariationalPrinciple")(qgt, gradient) | A Variational Principle class. |
+| [`RealVariationalPrinciple`](qiskit.algorithms.time_evolvers.variational.RealVariationalPrinciple "qiskit.algorithms.time_evolvers.variational.RealVariationalPrinciple")(qgt, gradient) | Class for a Real Variational Principle. |
+| [`ImaginaryVariationalPrinciple`](qiskit.algorithms.time_evolvers.variational.ImaginaryVariationalPrinciple "qiskit.algorithms.time_evolvers.variational.ImaginaryVariationalPrinciple")(qgt, gradient) | Abstract class for an Imaginary Variational Principle. |
+| [`RealMcLachlanPrinciple`](qiskit.algorithms.time_evolvers.variational.RealMcLachlanPrinciple "qiskit.algorithms.time_evolvers.variational.RealMcLachlanPrinciple")(\[qgt, gradient]) | Class for a Real McLachlan's Variational Principle. |
+| [`ImaginaryMcLachlanPrinciple`](qiskit.algorithms.time_evolvers.variational.ImaginaryMcLachlanPrinciple "qiskit.algorithms.time_evolvers.variational.ImaginaryMcLachlanPrinciple")(\[qgt, gradient]) | Class for an Imaginary McLachlan's Variational Principle. |
+
+### ODE solvers
+
+ODE solvers that implement the SciPy ODE Solver interface. The Forward Euler Solver is a preferred choice in the presence of noise. One might also use solvers provided by SciPy directly, e.g. RK45.
+
+| | |
+| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
+| [`ForwardEulerSolver`](qiskit.algorithms.time_evolvers.variational.ForwardEulerSolver "qiskit.algorithms.time_evolvers.variational.ForwardEulerSolver")(function, t0, y0, t\_bound) | Forward Euler ODE solver. |
+
diff --git a/docs/api/qiskit/0.46/qiskit.assembler.RunConfig.md b/docs/api/qiskit/0.46/qiskit.assembler.RunConfig.md
new file mode 100644
index 00000000000..798708002db
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.assembler.RunConfig.md
@@ -0,0 +1,106 @@
+---
+title: RunConfig
+description: API reference for qiskit.assembler.RunConfig
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.assembler.RunConfig
+---
+
+# RunConfig
+
+
+
+`qiskit.assembler.RunConfig(shots=None, seed_simulator=None, memory=None, parameter_binds=None, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/assembler/run_config.py "view source code")
+
+Bases: [`SimpleNamespace`](https://docs.python.org/3/library/types.html#types.SimpleNamespace "(in Python v3.12)")
+
+Class for Run Configuration.
+
+
+
+### shots
+
+the number of shots
+
+**Type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### seed\_simulator
+
+the seed to use in the simulator
+
+**Type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### memory
+
+whether to request memory from backend (per-shot readouts)
+
+**Type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+
+
+### parameter\_binds
+
+List of parameter bindings
+
+**Type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")]
+
+Initialize a RunConfig object
+
+**Parameters**
+
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of shots
+* **seed\_simulator** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the seed to use in the simulator
+* **memory** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – whether to request memory from backend (per-shot readouts)
+* **parameter\_binds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*]*) – List of parameter bindings
+* **\*\*kwargs** – optional fields
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new RunConfig object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary representing the RunConfig to create. It will be in the same format as output by [`to_dict()`](#qiskit.assembler.RunConfig.to_dict "qiskit.assembler.RunConfig.to_dict").
+
+**Returns**
+
+The RunConfig from the input dictionary.
+
+**Return type**
+
+[RunConfig](#qiskit.assembler.RunConfig "qiskit.assembler.RunConfig")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the RunConfig
+
+**Returns**
+
+The dictionary form of the RunConfig.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.AncillaQubit.md b/docs/api/qiskit/0.46/qiskit.circuit.AncillaQubit.md
new file mode 100644
index 00000000000..7ccf1c31b79
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.AncillaQubit.md
@@ -0,0 +1,55 @@
+---
+title: AncillaQubit
+description: API reference for qiskit.circuit.AncillaQubit
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.AncillaQubit
+---
+
+# AncillaQubit
+
+
+
+`qiskit.circuit.AncillaQubit(register=None, index=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/quantumregister.py "view source code")
+
+Bases: [`Qubit`](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit")
+
+A qubit used as ancillary qubit.
+
+Creates a qubit.
+
+**Parameters**
+
+* **register** ([*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister")) – Optional. A quantum register containing the bit.
+* **index** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Optional. The index of the bit in its containing register.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the provided register is not a valid [`QuantumRegister`](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister")
+
+## Attributes
+
+
+
+### index
+
+Get the index of an old-style bit in the register that owns it.
+
+In modern Qiskit Terra (version 0.17+), bits are the fundamental object and registers are aliases to collections of bits. A bit can be in many registers depending on the circuit, so a single containing register is no longer a property of a bit. It is an error to access this attribute on bits that were not constructed as “owned” by a register.
+
+
+ The property `qiskit.circuit.bit.Bit.index` is deprecated as of qiskit-terra 0.17. It will be removed in the Qiskit 1.0 release. Instead, use `find_bit()` to find all the containing registers within a circuit and the index of the bit within the circuit.
+
+
+
+
+### register
+
+Get the register of an old-style bit.
+
+In modern Qiskit Terra (version 0.17+), bits are the fundamental object and registers are aliases to collections of bits. A bit can be in many registers depending on the circuit, so a single containing register is no longer a property of a bit. It is an error to access this attribute on bits that were not constructed as “owned” by a register.
+
+
+ The property `qiskit.circuit.bit.Bit.register` is deprecated as of qiskit-terra 0.17. It will be removed in the Qiskit 1.0 release. Instead, use `find_bit()` to find all the containing registers within a circuit and the index of the bit within the circuit.
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.AncillaRegister.md b/docs/api/qiskit/0.46/qiskit.circuit.AncillaRegister.md
new file mode 100644
index 00000000000..0fa6e148b76
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.AncillaRegister.md
@@ -0,0 +1,90 @@
+---
+title: AncillaRegister
+description: API reference for qiskit.circuit.AncillaRegister
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.AncillaRegister
+---
+
+# AncillaRegister
+
+
+
+`qiskit.circuit.AncillaRegister(size=None, name=None, bits=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/quantumregister.py "view source code")
+
+Bases: [`QuantumRegister`](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister")
+
+Implement an ancilla register.
+
+Create a new generic register.
+
+Either the `size` or the `bits` argument must be provided. If `size` is not None, the register will be pre-populated with bits of the correct type.
+
+**Parameters**
+
+* **size** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Optional. The number of bits to include in the register.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Optional. The name of the register. If not provided, a unique name will be auto-generated from the register type.
+* **bits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Bit*](qiskit.circuit.Bit "qiskit.circuit.Bit")*]*) – Optional. A list of Bit() instances to be used to populate the register.
+
+**Raises**
+
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if both the `size` and `bits` arguments are provided, or if neither are.
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if `size` is not valid.
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if `name` is not a valid name according to the OpenQASM spec.
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if `bits` contained duplicated bits.
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if `bits` contained bits of an incorrect type.
+
+## Attributes
+
+
+
+### instances\_counter
+
+`= count(0)`
+
+
+
+### name
+
+Get the register name.
+
+
+
+### name\_format
+
+`= re.compile('[a-z][a-zA-Z0-9_]*')`
+
+
+
+### prefix
+
+`= 'a'`
+
+
+
+### size
+
+Get the register size.
+
+## Methods
+
+### index
+
+
+
+`index(bit)`
+
+Find the index of the provided bit within this register.
+
+### qasm
+
+
+
+`qasm()`
+
+Return OPENQASM string for this register.
+
+
+ The method `qiskit.circuit.quantumregister.QuantumRegister.qasm()` is deprecated as of qiskit-terra 0.23.0. It will be removed in the Qiskit 1.0 release. Correct exporting to OpenQASM 2 is the responsibility of a larger exporter; it cannot safely be done on an object-by-object basis without context. No replacement will be provided, because the premise is wrong.
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.AnnotatedOperation.md b/docs/api/qiskit/0.46/qiskit.circuit.AnnotatedOperation.md
new file mode 100644
index 00000000000..018298ea0b8
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.AnnotatedOperation.md
@@ -0,0 +1,84 @@
+---
+title: AnnotatedOperation
+description: API reference for qiskit.circuit.AnnotatedOperation
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.AnnotatedOperation
+---
+
+# AnnotatedOperation
+
+
+
+`qiskit.circuit.AnnotatedOperation(base_op, modifiers)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/annotated_operation.py "view source code")
+
+Bases: [`Operation`](qiskit.circuit.Operation "qiskit.circuit.operation.Operation")
+
+Annotated operation.
+
+Create a new AnnotatedOperation.
+
+An “annotated operation” allows to add a list of modifiers to the “base” operation. For now, the only supported modifiers are of types [`InverseModifier`](qiskit.circuit.InverseModifier "qiskit.circuit.InverseModifier"), [`ControlModifier`](qiskit.circuit.ControlModifier "qiskit.circuit.ControlModifier") and [`PowerModifier`](qiskit.circuit.PowerModifier "qiskit.circuit.PowerModifier").
+
+An annotated operation can be viewed as an extension of [`ControlledGate`](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate") (which also allows adding control to the base operation). However, an important difference is that the circuit definition of an annotated operation is not constructed when the operation is declared, and instead happens during transpilation, specifically during the [`HighLevelSynthesis`](qiskit.transpiler.passes.HighLevelSynthesis "qiskit.transpiler.passes.HighLevelSynthesis") transpiler pass.
+
+An annotated operation can be also viewed as a “higher-level” or “more abstract” object that can be added to a quantum circuit. This enables writing transpiler optimization passes that make use of this higher-level representation, for instance removing a gate that is immediately followed by its inverse.
+
+**Parameters**
+
+* **base\_op** ([*Operation*](qiskit.circuit.Operation "qiskit.circuit.operation.Operation")) – base operation being modified
+* **modifiers** (*Modifier |* [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[Modifier]*) – ordered list of modifiers. Supported modifiers include `InverseModifier`, `ControlModifier` and `PowerModifier`.
+
+Examples:
+
+```python
+op1 = AnnotatedOperation(SGate(), [InverseModifier(), ControlModifier(2)])
+
+op2_inner = AnnotatedGate(SGate(), InverseModifier())
+op2 = AnnotatedGate(op2_inner, ControlModifier(2))
+```
+
+Both op1 and op2 are semantically equivalent to an `SGate()` which is first inverted and then controlled by 2 qubits.
+
+## Attributes
+
+
+
+### name
+
+Unique string identifier for operation type.
+
+
+
+### num\_clbits
+
+Number of classical bits.
+
+
+
+### num\_qubits
+
+Number of qubits.
+
+## Methods
+
+### copy
+
+
+
+`copy()`
+
+Return a copy of the [`AnnotatedOperation`](#qiskit.circuit.AnnotatedOperation "qiskit.circuit.AnnotatedOperation").
+
+**Return type**
+
+[*AnnotatedOperation*](#qiskit.circuit.AnnotatedOperation "qiskit.circuit.annotated_operation.AnnotatedOperation")
+
+### to\_matrix
+
+
+
+`to_matrix()`
+
+Return a matrix representation (allowing to construct Operator).
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.Bit.md b/docs/api/qiskit/0.46/qiskit.circuit.Bit.md
new file mode 100644
index 00000000000..41f0b585135
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.Bit.md
@@ -0,0 +1,50 @@
+---
+title: Bit
+description: API reference for qiskit.circuit.Bit
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.Bit
+---
+
+# Bit
+
+
+
+`qiskit.circuit.Bit(register=None, index=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/bit.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Implement a generic bit.
+
+
+ This class should not be instantiated directly. This is just a superclass for [`Clbit`](qiskit.circuit.Clbit "qiskit.circuit.Clbit") and [`Qubit`](qiskit.circuit.Qubit "qiskit.circuit.Qubit").
+
+
+Create a new generic bit.
+
+## Attributes
+
+
+
+### index
+
+Get the index of an old-style bit in the register that owns it.
+
+In modern Qiskit Terra (version 0.17+), bits are the fundamental object and registers are aliases to collections of bits. A bit can be in many registers depending on the circuit, so a single containing register is no longer a property of a bit. It is an error to access this attribute on bits that were not constructed as “owned” by a register.
+
+
+ The property `qiskit.circuit.bit.Bit.index` is deprecated as of qiskit-terra 0.17. It will be removed in the Qiskit 1.0 release. Instead, use `find_bit()` to find all the containing registers within a circuit and the index of the bit within the circuit.
+
+
+
+
+### register
+
+Get the register of an old-style bit.
+
+In modern Qiskit Terra (version 0.17+), bits are the fundamental object and registers are aliases to collections of bits. A bit can be in many registers depending on the circuit, so a single containing register is no longer a property of a bit. It is an error to access this attribute on bits that were not constructed as “owned” by a register.
+
+
+ The property `qiskit.circuit.bit.Bit.register` is deprecated as of qiskit-terra 0.17. It will be removed in the Qiskit 1.0 release. Instead, use `find_bit()` to find all the containing registers within a circuit and the index of the bit within the circuit.
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.BreakLoopOp.md b/docs/api/qiskit/0.46/qiskit.circuit.BreakLoopOp.md
new file mode 100644
index 00000000000..33dab1d1251
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.BreakLoopOp.md
@@ -0,0 +1,345 @@
+---
+title: BreakLoopOp
+description: API reference for qiskit.circuit.BreakLoopOp
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.BreakLoopOp
+---
+
+# BreakLoopOp
+
+
+
+`qiskit.circuit.BreakLoopOp(num_qubits, num_clbits, label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/controlflow/break_loop.py "view source code")
+
+Bases: [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")
+
+A circuit operation which, when encountered, jumps to the end of the nearest enclosing loop.
+
+**Circuit symbol:**
+
+```python
+ ┌──────────────┐
+q_0: ┤0 ├
+ │ │
+q_1: ┤1 ├
+ │ break_loop │
+q_2: ┤2 ├
+ │ │
+c_0: ╡0 ╞
+ └──────────────┘
+```
+
+Create a new instruction.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – instruction name
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – instruction’s qubit width
+* **num\_clbits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – instruction’s clbit width
+* **params** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*|*[*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*|*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*|ndarray|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")*]*) – list of parameters
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – instruction’s duration. it must be integer if `unit` is ‘dt’
+* **unit** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – time unit of duration
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for identifying the instruction.
+
+**Raises**
+
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – when the register is not in the correct format.
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – when the optional label is provided, but it is not a string.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.BreakLoopOp.base_class "qiskit.circuit.BreakLoopOp.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that [`Instruction.name`](qiskit.circuit.Instruction#name "qiskit.circuit.Instruction.name") should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### add\_decomposition
+
+
+
+`add_decomposition(decomposition)`
+
+Add a decomposition of the instruction to the SessionEquivalenceLibrary.
+
+### assemble
+
+
+
+`assemble()`
+
+Assemble a QasmQobjInstruction
+
+### broadcast\_arguments
+
+
+
+`broadcast_arguments(qargs, cargs)`
+
+Validation of the arguments.
+
+**Parameters**
+
+* **qargs** (*List*) – List of quantum bit arguments.
+* **cargs** (*List*) – List of classical bit arguments.
+
+**Yields**
+
+*Tuple(List, List)* – A tuple with single arguments.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the input is not valid. For example, the number of arguments does not match the gate expectation.
+
+### c\_if
+
+
+
+`c_if(classical, val)`
+
+Set a classical equality condition on this instruction between the register or cbit `classical` and value `val`.
+
+
+ This is a setter method, not an additive one. Calling this multiple times will silently override any previously set condition; it does not stack.
+
+
+### copy
+
+
+
+`copy(name=None)`
+
+Copy of the instruction.
+
+**Parameters**
+
+**name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name to be given to the copied circuit, if `None` then the name stays the same.
+
+**Returns**
+
+a copy of the current instruction, with the name updated if it was provided
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this instruction.
+
+If the instruction is composite (i.e. has a definition), then its definition will be recursively inverted.
+
+Special instructions inheriting from Instruction can implement their own inverse (e.g. T and Tdg, Barrier, etc.)
+
+**Returns**
+
+a fresh instruction for the inverse
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the instruction is not composite and an inverse has not been implemented for it.
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True .IFF. instruction is parameterized else False
+
+### qasm
+
+
+
+`qasm()`
+
+Return a default OpenQASM string for the instruction.
+
+Derived instructions may override this to print in a different format (e.g. `measure q[0] -> c[0];`).
+
+
+ The method `qiskit.circuit.instruction.Instruction.qasm()` is deprecated as of qiskit-terra 0.25.0. It will be removed in the Qiskit 1.0 release. Correct exporting to OpenQASM 2 is the responsibility of a larger exporter; it cannot safely be done on an object-by-object basis without context. No replacement will be provided, because the premise is wrong.
+
+
+### repeat
+
+
+
+`repeat(n)`
+
+Creates an instruction with gate repeated n amount of times.
+
+**Parameters**
+
+**n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of times to repeat the instruction
+
+**Returns**
+
+Containing the definition.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If n \< 1.
+
+### reverse\_ops
+
+
+
+`reverse_ops()`
+
+For a composite instruction, reverse the order of sub-instructions.
+
+This is done by recursively reversing all sub-instructions. It does not invert any gate.
+
+**Returns**
+
+**a new instruction with**
+
+sub-instructions reversed.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### soft\_compare
+
+
+
+`soft_compare(other)`
+
+Soft comparison between gates. Their names, number of qubits, and classical bit numbers must match. The number of parameters must match. Each parameter is compared. If one is a ParameterExpression then it is not taken into account.
+
+**Parameters**
+
+**other** (*instruction*) – other instruction.
+
+**Returns**
+
+are self and other equal up to parameter expressions.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### to\_mutable
+
+
+
+`to_mutable()`
+
+Return a mutable copy of this gate.
+
+This method will return a new mutable copy of this gate instance. If a singleton instance is being used this will be a new unique instance that can be mutated. If the instance is already mutable it will be a deepcopy of that instance.
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Instruction parameters has no validation or normalization.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.CircuitInstruction.md b/docs/api/qiskit/0.46/qiskit.circuit.CircuitInstruction.md
new file mode 100644
index 00000000000..e5140ee8a61
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.CircuitInstruction.md
@@ -0,0 +1,82 @@
+---
+title: CircuitInstruction
+description: API reference for qiskit.circuit.CircuitInstruction
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.CircuitInstruction
+---
+
+# CircuitInstruction
+
+
+
+`qiskit.circuit.CircuitInstruction(operation, qubits=(), clbits=())`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/quantumcircuitdata.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+A single instruction in a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), comprised of the [`operation`](#qiskit.circuit.CircuitInstruction.operation "qiskit.circuit.CircuitInstruction.operation") and various operands.
+
+
+ There is some possible confusion in the names of this class, [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction"), and [`Operation`](qiskit.circuit.Operation "qiskit.circuit.Operation"), and this class’s attribute [`operation`](#qiskit.circuit.CircuitInstruction.operation "qiskit.circuit.CircuitInstruction.operation"). Our preferred terminology is by analogy to assembly languages, where an “instruction” is made up of an “operation” and its “operands”.
+
+ Historically, [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") came first, and originally contained the qubits it operated on and any parameters, so it was a true “instruction”. Over time, [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") became responsible for tracking qubits and clbits, and the class became better described as an “operation”. Changing the name of such a core object would be a very unpleasant API break for users, and so we have stuck with it.
+
+ This class was created to provide a formal “instruction” context object in `QuantumCircuit.data`, which had long been made of ad-hoc tuples. With this, and the advent of the [`Operation`](qiskit.circuit.Operation "qiskit.circuit.Operation") interface for adding more complex objects to circuits, we took the opportunity to correct the historical naming. For the time being, this leads to an awkward case where [`CircuitInstruction.operation`](#qiskit.circuit.CircuitInstruction.operation "qiskit.circuit.CircuitInstruction.operation") is often an [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instance ([`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") implements the [`Operation`](qiskit.circuit.Operation "qiskit.circuit.Operation") interface), but as the [`Operation`](qiskit.circuit.Operation "qiskit.circuit.Operation") interface gains more use, this confusion will hopefully abate.
+
+
+
+ This is a lightweight internal class and there is minimal error checking; you must respect the type hints when using it. It is the user’s responsibility to ensure that direct mutations of the object do not invalidate the types, nor the restrictions placed on it by its context. Typically this will mean, for example, that [`qubits`](#qiskit.circuit.CircuitInstruction.qubits "qiskit.circuit.CircuitInstruction.qubits") must be a sequence of distinct items, with no duplicates.
+
+
+## Attributes
+
+
+
+### operation
+
+`Operation`
+
+The logical operation that this instruction represents an execution of.
+
+
+
+### qubits
+
+`Tuple[Qubit, ...]`
+
+A sequence of the qubits that the operation is applied to.
+
+
+
+### clbits
+
+`Tuple[Clbit, ...]`
+
+A sequence of the classical bits that this operation reads from or writes to.
+
+## Methods
+
+### copy
+
+
+
+`copy()`
+
+Return a shallow copy of the [`CircuitInstruction`](#qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction").
+
+**Return type**
+
+[*CircuitInstruction*](#qiskit.circuit.CircuitInstruction "qiskit.circuit.quantumcircuitdata.CircuitInstruction")
+
+### replace
+
+
+
+`replace(operation=None, qubits=None, clbits=None)`
+
+Return a new [`CircuitInstruction`](#qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction") with the given fields replaced.
+
+**Return type**
+
+[*CircuitInstruction*](#qiskit.circuit.CircuitInstruction "qiskit.circuit.quantumcircuitdata.CircuitInstruction")
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.ClassicalRegister.md b/docs/api/qiskit/0.46/qiskit.circuit.ClassicalRegister.md
new file mode 100644
index 00000000000..b0c1e06d474
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.ClassicalRegister.md
@@ -0,0 +1,90 @@
+---
+title: ClassicalRegister
+description: API reference for qiskit.circuit.ClassicalRegister
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.ClassicalRegister
+---
+
+# ClassicalRegister
+
+
+
+`qiskit.circuit.ClassicalRegister(size=None, name=None, bits=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classicalregister.py "view source code")
+
+Bases: [`Register`](qiskit.circuit.Register "qiskit.circuit.register.Register")
+
+Implement a classical register.
+
+Create a new generic register.
+
+Either the `size` or the `bits` argument must be provided. If `size` is not None, the register will be pre-populated with bits of the correct type.
+
+**Parameters**
+
+* **size** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Optional. The number of bits to include in the register.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Optional. The name of the register. If not provided, a unique name will be auto-generated from the register type.
+* **bits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Bit*](qiskit.circuit.Bit "qiskit.circuit.Bit")*]*) – Optional. A list of Bit() instances to be used to populate the register.
+
+**Raises**
+
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if both the `size` and `bits` arguments are provided, or if neither are.
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if `size` is not valid.
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if `name` is not a valid name according to the OpenQASM spec.
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if `bits` contained duplicated bits.
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if `bits` contained bits of an incorrect type.
+
+## Attributes
+
+
+
+### instances\_counter
+
+`= count(0)`
+
+
+
+### name
+
+Get the register name.
+
+
+
+### name\_format
+
+`= re.compile('[a-z][a-zA-Z0-9_]*')`
+
+
+
+### prefix
+
+`= 'c'`
+
+
+
+### size
+
+Get the register size.
+
+## Methods
+
+### index
+
+
+
+`index(bit)`
+
+Find the index of the provided bit within this register.
+
+### qasm
+
+
+
+`qasm()`
+
+Return OPENQASM string for this register.
+
+
+ The method `qiskit.circuit.classicalregister.ClassicalRegister.qasm()` is deprecated as of qiskit-terra 0.23.0. It will be removed in the Qiskit 1.0 release. Correct exporting to OpenQASM 2 is the responsibility of a larger exporter; it cannot safely be done on an object-by-object basis without context. No replacement will be provided, because the premise is wrong.
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.Clbit.md b/docs/api/qiskit/0.46/qiskit.circuit.Clbit.md
new file mode 100644
index 00000000000..ad65b20f0ba
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.Clbit.md
@@ -0,0 +1,55 @@
+---
+title: Clbit
+description: API reference for qiskit.circuit.Clbit
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.Clbit
+---
+
+# Clbit
+
+
+
+`qiskit.circuit.Clbit(register=None, index=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classicalregister.py "view source code")
+
+Bases: [`Bit`](qiskit.circuit.Bit "qiskit.circuit.bit.Bit")
+
+Implement a classical bit.
+
+Creates a classical bit.
+
+**Parameters**
+
+* **register** ([*ClassicalRegister*](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister")) – Optional. A classical register containing the bit.
+* **index** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Optional. The index of the bit in its containing register.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the provided register is not a valid [`ClassicalRegister`](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister")
+
+## Attributes
+
+
+
+### index
+
+Get the index of an old-style bit in the register that owns it.
+
+In modern Qiskit Terra (version 0.17+), bits are the fundamental object and registers are aliases to collections of bits. A bit can be in many registers depending on the circuit, so a single containing register is no longer a property of a bit. It is an error to access this attribute on bits that were not constructed as “owned” by a register.
+
+
+ The property `qiskit.circuit.bit.Bit.index` is deprecated as of qiskit-terra 0.17. It will be removed in the Qiskit 1.0 release. Instead, use `find_bit()` to find all the containing registers within a circuit and the index of the bit within the circuit.
+
+
+
+
+### register
+
+Get the register of an old-style bit.
+
+In modern Qiskit Terra (version 0.17+), bits are the fundamental object and registers are aliases to collections of bits. A bit can be in many registers depending on the circuit, so a single containing register is no longer a property of a bit. It is an error to access this attribute on bits that were not constructed as “owned” by a register.
+
+
+ The property `qiskit.circuit.bit.Bit.register` is deprecated as of qiskit-terra 0.17. It will be removed in the Qiskit 1.0 release. Instead, use `find_bit()` to find all the containing registers within a circuit and the index of the bit within the circuit.
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.CommutationChecker.md b/docs/api/qiskit/0.46/qiskit.circuit.CommutationChecker.md
new file mode 100644
index 00000000000..427805ee99f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.CommutationChecker.md
@@ -0,0 +1,46 @@
+---
+title: CommutationChecker
+description: API reference for qiskit.circuit.CommutationChecker
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.CommutationChecker
+---
+
+# CommutationChecker
+
+
+
+`qiskit.circuit.CommutationChecker`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/commutation_checker.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+This code is essentially copy-pasted from commutative\_analysis.py. This code cleverly hashes commutativity and non-commutativity results between DAG nodes and seems quite efficient for large Clifford circuits. They may be other possible efficiency improvements: using rule-based commutativity analysis, evicting from the cache less useful entries, etc.
+
+## Methods
+
+### commute
+
+
+
+`commute(op1, qargs1, cargs1, op2, qargs2, cargs2, max_num_qubits=3)`
+
+Checks if two Operations commute. The return value of True means that the operations truly commute, and the return value of False means that either the operations do not commute or that the commutation check was skipped (for example, when the operations have conditions or have too many qubits).
+
+**Parameters**
+
+* **op1** ([*Operation*](qiskit.circuit.Operation "qiskit.circuit.operation.Operation")) – first operation.
+* **qargs1** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")) – first operation’s qubits.
+* **cargs1** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")) – first operation’s clbits.
+* **op2** ([*Operation*](qiskit.circuit.Operation "qiskit.circuit.operation.Operation")) – second operation.
+* **qargs2** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")) – second operation’s qubits.
+* **cargs2** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")) – second operation’s clbits.
+* **max\_num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the maximum number of qubits to consider, the check may be skipped if the number of qubits for either operation exceeds this amount.
+
+**Returns**
+
+whether two operations commute.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.ContinueLoopOp.md b/docs/api/qiskit/0.46/qiskit.circuit.ContinueLoopOp.md
new file mode 100644
index 00000000000..460051fc9da
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.ContinueLoopOp.md
@@ -0,0 +1,349 @@
+---
+title: ContinueLoopOp
+description: API reference for qiskit.circuit.ContinueLoopOp
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.ContinueLoopOp
+---
+
+# ContinueLoopOp
+
+
+
+`qiskit.circuit.ContinueLoopOp(num_qubits, num_clbits, label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/controlflow/continue_loop.py "view source code")
+
+Bases: [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")
+
+A circuit operation which, when encountered, moves to the next iteration of the nearest enclosing loop.
+
+
+ Can be inserted only within the body of a loop op, and must span the full width of that block.
+
+
+**Circuit symbol:**
+
+```python
+ ┌─────────────────┐
+q_0: ┤0 ├
+ │ │
+q_1: ┤1 ├
+ │ continue_loop │
+q_2: ┤2 ├
+ │ │
+c_0: ╡0 ╞
+ └─────────────────┘
+```
+
+Create a new instruction.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – instruction name
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – instruction’s qubit width
+* **num\_clbits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – instruction’s clbit width
+* **params** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*|*[*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*|*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*|ndarray|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")*]*) – list of parameters
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – instruction’s duration. it must be integer if `unit` is ‘dt’
+* **unit** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – time unit of duration
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for identifying the instruction.
+
+**Raises**
+
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – when the register is not in the correct format.
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – when the optional label is provided, but it is not a string.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.ContinueLoopOp.base_class "qiskit.circuit.ContinueLoopOp.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that [`Instruction.name`](qiskit.circuit.Instruction#name "qiskit.circuit.Instruction.name") should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### add\_decomposition
+
+
+
+`add_decomposition(decomposition)`
+
+Add a decomposition of the instruction to the SessionEquivalenceLibrary.
+
+### assemble
+
+
+
+`assemble()`
+
+Assemble a QasmQobjInstruction
+
+### broadcast\_arguments
+
+
+
+`broadcast_arguments(qargs, cargs)`
+
+Validation of the arguments.
+
+**Parameters**
+
+* **qargs** (*List*) – List of quantum bit arguments.
+* **cargs** (*List*) – List of classical bit arguments.
+
+**Yields**
+
+*Tuple(List, List)* – A tuple with single arguments.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the input is not valid. For example, the number of arguments does not match the gate expectation.
+
+### c\_if
+
+
+
+`c_if(classical, val)`
+
+Set a classical equality condition on this instruction between the register or cbit `classical` and value `val`.
+
+
+ This is a setter method, not an additive one. Calling this multiple times will silently override any previously set condition; it does not stack.
+
+
+### copy
+
+
+
+`copy(name=None)`
+
+Copy of the instruction.
+
+**Parameters**
+
+**name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name to be given to the copied circuit, if `None` then the name stays the same.
+
+**Returns**
+
+a copy of the current instruction, with the name updated if it was provided
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this instruction.
+
+If the instruction is composite (i.e. has a definition), then its definition will be recursively inverted.
+
+Special instructions inheriting from Instruction can implement their own inverse (e.g. T and Tdg, Barrier, etc.)
+
+**Returns**
+
+a fresh instruction for the inverse
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the instruction is not composite and an inverse has not been implemented for it.
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True .IFF. instruction is parameterized else False
+
+### qasm
+
+
+
+`qasm()`
+
+Return a default OpenQASM string for the instruction.
+
+Derived instructions may override this to print in a different format (e.g. `measure q[0] -> c[0];`).
+
+
+ The method `qiskit.circuit.instruction.Instruction.qasm()` is deprecated as of qiskit-terra 0.25.0. It will be removed in the Qiskit 1.0 release. Correct exporting to OpenQASM 2 is the responsibility of a larger exporter; it cannot safely be done on an object-by-object basis without context. No replacement will be provided, because the premise is wrong.
+
+
+### repeat
+
+
+
+`repeat(n)`
+
+Creates an instruction with gate repeated n amount of times.
+
+**Parameters**
+
+**n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of times to repeat the instruction
+
+**Returns**
+
+Containing the definition.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If n \< 1.
+
+### reverse\_ops
+
+
+
+`reverse_ops()`
+
+For a composite instruction, reverse the order of sub-instructions.
+
+This is done by recursively reversing all sub-instructions. It does not invert any gate.
+
+**Returns**
+
+**a new instruction with**
+
+sub-instructions reversed.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### soft\_compare
+
+
+
+`soft_compare(other)`
+
+Soft comparison between gates. Their names, number of qubits, and classical bit numbers must match. The number of parameters must match. Each parameter is compared. If one is a ParameterExpression then it is not taken into account.
+
+**Parameters**
+
+**other** (*instruction*) – other instruction.
+
+**Returns**
+
+are self and other equal up to parameter expressions.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### to\_mutable
+
+
+
+`to_mutable()`
+
+Return a mutable copy of this gate.
+
+This method will return a new mutable copy of this gate instance. If a singleton instance is being used this will be a new unique instance that can be mutated. If the instance is already mutable it will be a deepcopy of that instance.
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Instruction parameters has no validation or normalization.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.ControlFlowOp.md b/docs/api/qiskit/0.46/qiskit.circuit.ControlFlowOp.md
new file mode 100644
index 00000000000..91164e88d20
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.ControlFlowOp.md
@@ -0,0 +1,353 @@
+---
+title: ControlFlowOp
+description: API reference for qiskit.circuit.ControlFlowOp
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.ControlFlowOp
+---
+
+# ControlFlowOp
+
+
+
+`qiskit.circuit.ControlFlowOp(name, num_qubits, num_clbits, params, duration=None, unit='dt', label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/controlflow/control_flow.py "view source code")
+
+Bases: [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction"), [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Abstract class to encapsulate all control flow operations.
+
+Create a new instruction.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – instruction name
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – instruction’s qubit width
+* **num\_clbits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – instruction’s clbit width
+* **params** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*|*[*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*|*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*|ndarray|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")*]*) – list of parameters
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – instruction’s duration. it must be integer if `unit` is ‘dt’
+* **unit** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – time unit of duration
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for identifying the instruction.
+
+**Raises**
+
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – when the register is not in the correct format.
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – when the optional label is provided, but it is not a string.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.ControlFlowOp.base_class "qiskit.circuit.ControlFlowOp.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that [`Instruction.name`](qiskit.circuit.Instruction#name "qiskit.circuit.Instruction.name") should be a more suitable discriminator in most situations.
+
+
+
+### blocks
+
+Tuple of QuantumCircuits which may be executed as part of the execution of this ControlFlowOp. May be parameterized by a loop parameter to be resolved at run time.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### add\_decomposition
+
+
+
+`add_decomposition(decomposition)`
+
+Add a decomposition of the instruction to the SessionEquivalenceLibrary.
+
+### assemble
+
+
+
+`assemble()`
+
+Assemble a QasmQobjInstruction
+
+### broadcast\_arguments
+
+
+
+`broadcast_arguments(qargs, cargs)`
+
+Validation of the arguments.
+
+**Parameters**
+
+* **qargs** (*List*) – List of quantum bit arguments.
+* **cargs** (*List*) – List of classical bit arguments.
+
+**Yields**
+
+*Tuple(List, List)* – A tuple with single arguments.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the input is not valid. For example, the number of arguments does not match the gate expectation.
+
+### c\_if
+
+
+
+`c_if(classical, val)`
+
+Set a classical equality condition on this instruction between the register or cbit `classical` and value `val`.
+
+
+ This is a setter method, not an additive one. Calling this multiple times will silently override any previously set condition; it does not stack.
+
+
+### copy
+
+
+
+`copy(name=None)`
+
+Copy of the instruction.
+
+**Parameters**
+
+**name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name to be given to the copied circuit, if `None` then the name stays the same.
+
+**Returns**
+
+a copy of the current instruction, with the name updated if it was provided
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this instruction.
+
+If the instruction is composite (i.e. has a definition), then its definition will be recursively inverted.
+
+Special instructions inheriting from Instruction can implement their own inverse (e.g. T and Tdg, Barrier, etc.)
+
+**Returns**
+
+a fresh instruction for the inverse
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the instruction is not composite and an inverse has not been implemented for it.
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True .IFF. instruction is parameterized else False
+
+### qasm
+
+
+
+`qasm()`
+
+Return a default OpenQASM string for the instruction.
+
+Derived instructions may override this to print in a different format (e.g. `measure q[0] -> c[0];`).
+
+
+ The method `qiskit.circuit.instruction.Instruction.qasm()` is deprecated as of qiskit-terra 0.25.0. It will be removed in the Qiskit 1.0 release. Correct exporting to OpenQASM 2 is the responsibility of a larger exporter; it cannot safely be done on an object-by-object basis without context. No replacement will be provided, because the premise is wrong.
+
+
+### repeat
+
+
+
+`repeat(n)`
+
+Creates an instruction with gate repeated n amount of times.
+
+**Parameters**
+
+**n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of times to repeat the instruction
+
+**Returns**
+
+Containing the definition.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If n \< 1.
+
+### replace\_blocks
+
+
+
+`abstract replace_blocks(blocks)`
+
+Replace blocks and return new instruction. :param blocks: Tuple of QuantumCircuits to replace in instruction.
+
+**Returns**
+
+New ControlFlowOp with replaced blocks.
+
+**Return type**
+
+[*ControlFlowOp*](#qiskit.circuit.ControlFlowOp "qiskit.circuit.controlflow.control_flow.ControlFlowOp")
+
+### reverse\_ops
+
+
+
+`reverse_ops()`
+
+For a composite instruction, reverse the order of sub-instructions.
+
+This is done by recursively reversing all sub-instructions. It does not invert any gate.
+
+**Returns**
+
+**a new instruction with**
+
+sub-instructions reversed.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### soft\_compare
+
+
+
+`soft_compare(other)`
+
+Soft comparison between gates. Their names, number of qubits, and classical bit numbers must match. The number of parameters must match. Each parameter is compared. If one is a ParameterExpression then it is not taken into account.
+
+**Parameters**
+
+**other** (*instruction*) – other instruction.
+
+**Returns**
+
+are self and other equal up to parameter expressions.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### to\_mutable
+
+
+
+`to_mutable()`
+
+Return a mutable copy of this gate.
+
+This method will return a new mutable copy of this gate instance. If a singleton instance is being used this will be a new unique instance that can be mutated. If the instance is already mutable it will be a deepcopy of that instance.
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Instruction parameters has no validation or normalization.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.ControlModifier.md b/docs/api/qiskit/0.46/qiskit.circuit.ControlModifier.md
new file mode 100644
index 00000000000..f63c8349a84
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.ControlModifier.md
@@ -0,0 +1,36 @@
+---
+title: ControlModifier
+description: API reference for qiskit.circuit.ControlModifier
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.ControlModifier
+---
+
+# ControlModifier
+
+
+
+`qiskit.circuit.ControlModifier(num_ctrl_qubits=0, ctrl_state=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/annotated_operation.py "view source code")
+
+Bases: `Modifier`
+
+Control modifier: specifies that the operation is controlled by `num_ctrl_qubits` and has control state `ctrl_state`.
+
+## Attributes
+
+
+
+### ctrl\_state
+
+`int | str | None`
+
+`= None`
+
+
+
+### num\_ctrl\_qubits
+
+`int`
+
+`= 0`
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.ControlledGate.md b/docs/api/qiskit/0.46/qiskit.circuit.ControlledGate.md
new file mode 100644
index 00000000000..64cc909aad8
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.ControlledGate.md
@@ -0,0 +1,495 @@
+---
+title: ControlledGate
+description: API reference for qiskit.circuit.ControlledGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.ControlledGate
+---
+
+# ControlledGate
+
+
+
+`qiskit.circuit.ControlledGate(name, num_qubits, params, label=None, num_ctrl_qubits=1, definition=None, ctrl_state=None, base_gate=None, duration=None, unit=None, *, _base_label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/controlledgate.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+Controlled unitary gate.
+
+Create a new ControlledGate. In the new gate the first `num_ctrl_qubits` of the gate are the controls.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the gate.
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of qubits the gate acts on.
+* **params** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of parameters for the gate.
+* **label** (*Optional\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – An optional label for the gate.
+* **num\_ctrl\_qubits** (*Optional\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Number of control qubits.
+* **definition** (*Optional\['QuantumCircuit']*) – A list of gate rules for implementing this gate. The elements of the list are tuples of ([`Gate()`](qiskit.circuit.Gate "qiskit.circuit.Gate"), \[qubit\_list], \[clbit\_list]).
+* **ctrl\_state** (*Optional\[Union\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*,* [*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]]*) – The control state in decimal or as a bitstring (e.g. ‘111’). If specified as a bitstring the length must equal num\_ctrl\_qubits, MSB on left. If None, use 2\*\*num\_ctrl\_qubits-1.
+* **base\_gate** (*Optional\[*[*Gate*](qiskit.circuit.Gate "qiskit.circuit.Gate")*]*) – Gate object to be controlled.
+
+**Raises**
+
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If `num_ctrl_qubits` >= `num_qubits`.
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – ctrl\_state \< 0 or ctrl\_state > 2\*\*num\_ctrl\_qubits.
+
+Examples:
+
+Create a controlled standard gate and apply it to a circuit.
+
+```python
+from qiskit import QuantumCircuit, QuantumRegister
+from qiskit.circuit.library.standard_gates import HGate
+
+qr = QuantumRegister(3)
+qc = QuantumCircuit(qr)
+c3h_gate = HGate().control(2)
+qc.append(c3h_gate, qr)
+qc.draw('mpl')
+```
+
+
+
+Create a controlled custom gate and apply it to a circuit.
+
+```python
+from qiskit import QuantumCircuit, QuantumRegister
+from qiskit.circuit.library.standard_gates import HGate
+
+qc1 = QuantumCircuit(2)
+qc1.x(0)
+qc1.h(1)
+custom = qc1.to_gate().control(2)
+
+qc2 = QuantumCircuit(4)
+qc2.append(custom, [0, 3, 1, 2])
+qc2.draw('mpl')
+```
+
+
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.ControlledGate.base_class "qiskit.circuit.ControlledGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that [`Instruction.name`](qiskit.circuit.Instruction#name "qiskit.circuit.Instruction.name") should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### add\_decomposition
+
+
+
+`add_decomposition(decomposition)`
+
+Add a decomposition of the instruction to the SessionEquivalenceLibrary.
+
+### assemble
+
+
+
+`assemble()`
+
+Assemble a QasmQobjInstruction
+
+### broadcast\_arguments
+
+
+
+`broadcast_arguments(qargs, cargs)`
+
+Validation and handling of the arguments and its relationship.
+
+For example, `cx([q[0],q[1]], q[2])` means `cx(q[0], q[2]); cx(q[1], q[2])`. This method yields the arguments in the right grouping. In the given example:
+
+```python
+in: [[q[0],q[1]], q[2]],[]
+outs: [q[0], q[2]], []
+ [q[1], q[2]], []
+```
+
+The general broadcasting rules are:
+
+> * If len(qargs) == 1:
+>
+> ```python
+> [q[0], q[1]] -> [q[0]],[q[1]]
+> ```
+>
+> * If len(qargs) == 2:
+>
+> ```python
+> [[q[0], q[1]], [r[0], r[1]]] -> [q[0], r[0]], [q[1], r[1]]
+> [[q[0]], [r[0], r[1]]] -> [q[0], r[0]], [q[0], r[1]]
+> [[q[0], q[1]], [r[0]]] -> [q[0], r[0]], [q[1], r[0]]
+> ```
+>
+> * If len(qargs) >= 3:
+>
+> ```python
+> [q[0], q[1]], [r[0], r[1]], ...] -> [q[0], r[0], ...], [q[1], r[1], ...]
+> ```
+
+**Parameters**
+
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – List of quantum bit arguments.
+* **cargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – List of classical bit arguments.
+
+**Returns**
+
+A tuple with single arguments.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the input is not valid. For example, the number of arguments does not match the gate expectation.
+
+**Return type**
+
+[*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")\[[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)"), [list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")]]
+
+### c\_if
+
+
+
+`c_if(classical, val)`
+
+Set a classical equality condition on this instruction between the register or cbit `classical` and value `val`.
+
+
+ This is a setter method, not an additive one. Calling this multiple times will silently override any previously set condition; it does not stack.
+
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Return controlled version of gate. See [`ControlledGate`](#qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate") for usage.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of controls to add to gate (default: `1`)
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – optional gate label
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The control state in decimal or as a bitstring (e.g. `'111'`). If `None`, use `2**num_ctrl_qubits-1`.
+
+**Returns**
+
+Controlled version of gate. This default algorithm uses `num_ctrl_qubits-1` ancilla qubits so returns a gate of size `num_qubits + 2*num_ctrl_qubits - 1`.
+
+**Return type**
+
+[qiskit.circuit.ControlledGate](#qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – unrecognized mode or invalid ctrl\_state
+
+### copy
+
+
+
+`copy(name=None)`
+
+Copy of the instruction.
+
+**Parameters**
+
+**name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name to be given to the copied circuit, if `None` then the name stays the same.
+
+**Returns**
+
+a copy of the current instruction, with the name updated if it was provided
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this gate by calling inverse on the base gate.
+
+**Return type**
+
+[*ControlledGate*](#qiskit.circuit.ControlledGate "qiskit.circuit.controlledgate.ControlledGate")
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True .IFF. instruction is parameterized else False
+
+### power
+
+
+
+`power(exponent)`
+
+Creates a unitary gate as gate^exponent.
+
+**Parameters**
+
+**exponent** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Gate^exponent
+
+**Returns**
+
+To which to\_matrix is self.to\_matrix^exponent.
+
+**Return type**
+
+.library.UnitaryGate
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If Gate is not unitary
+
+### qasm
+
+
+
+`qasm()`
+
+Return a default OpenQASM string for the instruction.
+
+Derived instructions may override this to print in a different format (e.g. `measure q[0] -> c[0];`).
+
+
+ The method `qiskit.circuit.instruction.Instruction.qasm()` is deprecated as of qiskit-terra 0.25.0. It will be removed in the Qiskit 1.0 release. Correct exporting to OpenQASM 2 is the responsibility of a larger exporter; it cannot safely be done on an object-by-object basis without context. No replacement will be provided, because the premise is wrong.
+
+
+### repeat
+
+
+
+`repeat(n)`
+
+Creates an instruction with gate repeated n amount of times.
+
+**Parameters**
+
+**n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of times to repeat the instruction
+
+**Returns**
+
+Containing the definition.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If n \< 1.
+
+### reverse\_ops
+
+
+
+`reverse_ops()`
+
+For a composite instruction, reverse the order of sub-instructions.
+
+This is done by recursively reversing all sub-instructions. It does not invert any gate.
+
+**Returns**
+
+**a new instruction with**
+
+sub-instructions reversed.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### soft\_compare
+
+
+
+`soft_compare(other)`
+
+Soft comparison between gates. Their names, number of qubits, and classical bit numbers must match. The number of parameters must match. Each parameter is compared. If one is a ParameterExpression then it is not taken into account.
+
+**Parameters**
+
+**other** (*instruction*) – other instruction.
+
+**Returns**
+
+are self and other equal up to parameter expressions.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### to\_matrix
+
+
+
+`to_matrix()`
+
+Return a Numpy.array for the gate unitary matrix.
+
+**Returns**
+
+if the Gate subclass has a matrix definition.
+
+**Return type**
+
+np.ndarray
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If a Gate subclass does not implement this method an exception will be raised when this base class method is called.
+
+### to\_mutable
+
+
+
+`to_mutable()`
+
+Return a mutable copy of this gate.
+
+This method will return a new mutable copy of this gate instance. If a singleton instance is being used this will be a new unique instance that can be mutated. If the instance is already mutable it will be a deepcopy of that instance.
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Gate parameters should be int, float, or ParameterExpression
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.Delay.md b/docs/api/qiskit/0.46/qiskit.circuit.Delay.md
new file mode 100644
index 00000000000..462efb32895
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.Delay.md
@@ -0,0 +1,350 @@
+---
+title: Delay
+description: API reference for qiskit.circuit.Delay
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.Delay
+---
+
+# Delay
+
+
+
+`qiskit.circuit.Delay(duration, unit='dt')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/delay.py "view source code")
+
+Bases: [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")
+
+Do nothing and just delay/wait/idle for a specified duration.
+
+Create new delay instruction.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.Delay.base_class "qiskit.circuit.Delay.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that [`Instruction.name`](qiskit.circuit.Instruction#name "qiskit.circuit.Instruction.name") should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration of this delay.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### add\_decomposition
+
+
+
+`add_decomposition(decomposition)`
+
+Add a decomposition of the instruction to the SessionEquivalenceLibrary.
+
+### assemble
+
+
+
+`assemble()`
+
+Assemble a QasmQobjInstruction
+
+### broadcast\_arguments
+
+
+
+`broadcast_arguments(qargs, cargs)`
+
+Validation and handling of the arguments and its relationship.
+
+For example, `cx([q[0],q[1]], q[2])` means `cx(q[0], q[2]); cx(q[1], q[2])`. This method yields the arguments in the right grouping. In the given example:
+
+```python
+in: [[q[0],q[1]], q[2]],[]
+outs: [q[0], q[2]], []
+ [q[1], q[2]], []
+```
+
+The general broadcasting rules are:
+
+> * If len(qargs) == 1:
+>
+> ```python
+> [q[0], q[1]] -> [q[0]],[q[1]]
+> ```
+>
+> * If len(qargs) == 2:
+>
+> ```python
+> [[q[0], q[1]], [r[0], r[1]]] -> [q[0], r[0]], [q[1], r[1]]
+> [[q[0]], [r[0], r[1]]] -> [q[0], r[0]], [q[0], r[1]]
+> [[q[0], q[1]], [r[0]]] -> [q[0], r[0]], [q[1], r[0]]
+> ```
+>
+> * If len(qargs) >= 3:
+>
+> ```python
+> [q[0], q[1]], [r[0], r[1]], ...] -> [q[0], r[0], ...], [q[1], r[1], ...]
+> ```
+
+**Parameters**
+
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – List of quantum bit arguments.
+* **cargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – List of classical bit arguments.
+
+**Returns**
+
+A tuple with single arguments.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the input is not valid. For example, the number of arguments does not match the gate expectation.
+
+**Return type**
+
+[*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")\[[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)"), [list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")]]
+
+### c\_if
+
+
+
+`c_if(classical, val)`
+
+Set a classical equality condition on this instruction between the register or cbit `classical` and value `val`.
+
+
+ This is a setter method, not an additive one. Calling this multiple times will silently override any previously set condition; it does not stack.
+
+
+### copy
+
+
+
+`copy(name=None)`
+
+Copy of the instruction.
+
+**Parameters**
+
+**name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name to be given to the copied circuit, if `None` then the name stays the same.
+
+**Returns**
+
+a copy of the current instruction, with the name updated if it was provided
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### inverse
+
+
+
+`inverse()`
+
+Special case. Return self.
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True .IFF. instruction is parameterized else False
+
+### qasm
+
+
+
+`qasm()`
+
+Return a default OpenQASM string for the instruction.
+
+Derived instructions may override this to print in a different format (e.g. `measure q[0] -> c[0];`).
+
+
+ The method `qiskit.circuit.instruction.Instruction.qasm()` is deprecated as of qiskit-terra 0.25.0. It will be removed in the Qiskit 1.0 release. Correct exporting to OpenQASM 2 is the responsibility of a larger exporter; it cannot safely be done on an object-by-object basis without context. No replacement will be provided, because the premise is wrong.
+
+
+### repeat
+
+
+
+`repeat(n)`
+
+Creates an instruction with gate repeated n amount of times.
+
+**Parameters**
+
+**n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of times to repeat the instruction
+
+**Returns**
+
+Containing the definition.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If n \< 1.
+
+### reverse\_ops
+
+
+
+`reverse_ops()`
+
+For a composite instruction, reverse the order of sub-instructions.
+
+This is done by recursively reversing all sub-instructions. It does not invert any gate.
+
+**Returns**
+
+**a new instruction with**
+
+sub-instructions reversed.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### soft\_compare
+
+
+
+`soft_compare(other)`
+
+Soft comparison between gates. Their names, number of qubits, and classical bit numbers must match. The number of parameters must match. Each parameter is compared. If one is a ParameterExpression then it is not taken into account.
+
+**Parameters**
+
+**other** (*instruction*) – other instruction.
+
+**Returns**
+
+are self and other equal up to parameter expressions.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### to\_matrix
+
+
+
+`to_matrix()`
+
+Return a Numpy.array for the unitary matrix. This has been added to enable simulation without making delay a full Gate type.
+
+**Returns**
+
+matrix representation.
+
+**Return type**
+
+np.ndarray
+
+### to\_mutable
+
+
+
+`to_mutable()`
+
+Return a mutable copy of this gate.
+
+This method will return a new mutable copy of this gate instance. If a singleton instance is being used this will be a new unique instance that can be mutated. If the instance is already mutable it will be a deepcopy of that instance.
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Delay parameter (i.e. duration) must be int, float or ParameterExpression.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.EquivalenceLibrary.md b/docs/api/qiskit/0.46/qiskit.circuit.EquivalenceLibrary.md
new file mode 100644
index 00000000000..80500c5be3e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.EquivalenceLibrary.md
@@ -0,0 +1,184 @@
+---
+title: EquivalenceLibrary
+description: API reference for qiskit.circuit.EquivalenceLibrary
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.EquivalenceLibrary
+---
+
+# EquivalenceLibrary
+
+
+
+`qiskit.circuit.EquivalenceLibrary(*, base=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/equivalence.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+A library providing a one-way mapping of Gates to their equivalent implementations as QuantumCircuits.
+
+Create a new equivalence library.
+
+**Parameters**
+
+**base** (*Optional\[*[*EquivalenceLibrary*](#qiskit.circuit.EquivalenceLibrary "qiskit.circuit.EquivalenceLibrary")*]*) – Base equivalence library to be referenced if an entry is not found in this library.
+
+## Attributes
+
+
+
+### graph
+
+Return graph representing the equivalence library data.
+
+This property should be treated as read-only as it provides a reference to the internal state of the [`EquivalenceLibrary`](#qiskit.circuit.EquivalenceLibrary "qiskit.circuit.EquivalenceLibrary") object. If the graph returned by this property is mutated it could corrupt the the contents of the object. If you need to modify the output `PyDiGraph` be sure to make a copy prior to any modification.
+
+**Returns**
+
+A graph object with equivalence data in each node.
+
+**Return type**
+
+PyDiGraph
+
+## Methods
+
+### add\_equivalence
+
+
+
+`add_equivalence(gate, equivalent_circuit)`
+
+Add a new equivalence to the library. Future queries for the Gate will include the given circuit, in addition to all existing equivalences (including those from base).
+
+Parameterized Gates (those including qiskit.circuit.Parameters in their Gate.params) can be marked equivalent to parameterized circuits, provided the parameters match.
+
+**Parameters**
+
+* **gate** ([*Gate*](qiskit.circuit.Gate "qiskit.circuit.Gate")) – A Gate instance.
+* **equivalent\_circuit** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – A circuit equivalently implementing the given Gate.
+
+### draw
+
+
+
+`draw(filename=None)`
+
+Draws the equivalence relations available in the library.
+
+**Parameters**
+
+**filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – An optional path to write the output image to if specified this method will return None.
+
+**Returns**
+
+**Drawn equivalence library as an**
+
+IPython SVG if in a jupyter notebook, or as a PIL.Image otherwise.
+
+**Return type**
+
+PIL.Image or IPython.display.SVG
+
+**Raises**
+
+[**InvalidFileError**](exceptions#qiskit.exceptions.InvalidFileError "qiskit.exceptions.InvalidFileError") – if filename is not valid.
+
+### get\_entry
+
+
+
+`get_entry(gate)`
+
+Gets the set of QuantumCircuits circuits from the library which equivalently implement the given Gate.
+
+Parameterized circuits will have their parameters replaced with the corresponding entries from Gate.params.
+
+**Parameters**
+
+**gate** ([*Gate*](qiskit.circuit.Gate "qiskit.circuit.Gate")) – A Gate instance.
+
+**Returns**
+
+**A list of equivalent QuantumCircuits. If empty,**
+
+library contains no known decompositions of Gate.
+
+Returned circuits will be ordered according to their insertion in the library, from earliest to latest, from top to base. The ordering of the StandardEquivalenceLibrary will not generally be consistent across Qiskit versions.
+
+**Return type**
+
+List\[[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")]
+
+### has\_entry
+
+
+
+`has_entry(gate)`
+
+Check if a library contains any decompositions for gate.
+
+**Parameters**
+
+**gate** ([*Gate*](qiskit.circuit.Gate "qiskit.circuit.Gate")) – A Gate instance.
+
+**Returns**
+
+**True if gate has a known decomposition in the library.**
+
+False otherwise.
+
+**Return type**
+
+[Bool](circuit_classical#qiskit.circuit.classical.types.Bool "qiskit.circuit.classical.types.Bool")
+
+### keys
+
+
+
+`keys()`
+
+Return list of keys to key to node index map.
+
+**Returns**
+
+Keys to the key to node index map.
+
+**Return type**
+
+List
+
+### node\_index
+
+
+
+`node_index(key)`
+
+Return node index for a given key.
+
+**Parameters**
+
+**key** (*Key*) – Key to an equivalence.
+
+**Returns**
+
+Index to the node in the graph for the given key.
+
+**Return type**
+
+Int
+
+### set\_entry
+
+
+
+`set_entry(gate, entry)`
+
+Set the equivalence record for a Gate. Future queries for the Gate will return only the circuits provided.
+
+Parameterized Gates (those including qiskit.circuit.Parameters in their Gate.params) can be marked equivalent to parameterized circuits, provided the parameters match.
+
+**Parameters**
+
+* **gate** ([*Gate*](qiskit.circuit.Gate "qiskit.circuit.Gate")) – A Gate instance.
+* **entry** (*List\['QuantumCircuit']*) – A list of QuantumCircuits, each equivalently implementing the given Gate.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.ForLoopOp.md b/docs/api/qiskit/0.46/qiskit.circuit.ForLoopOp.md
new file mode 100644
index 00000000000..6c2f2b3120e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.ForLoopOp.md
@@ -0,0 +1,366 @@
+---
+title: ForLoopOp
+description: API reference for qiskit.circuit.ForLoopOp
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.ForLoopOp
+---
+
+# ForLoopOp
+
+
+
+`qiskit.circuit.ForLoopOp(indexset, loop_parameter, body, label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/controlflow/for_loop.py "view source code")
+
+Bases: [`ControlFlowOp`](qiskit.circuit.ControlFlowOp "qiskit.circuit.controlflow.control_flow.ControlFlowOp")
+
+A circuit operation which repeatedly executes a subcircuit (`body`) parameterized by a parameter `loop_parameter` through the set of integer values provided in `indexset`.
+
+**Parameters**
+
+* **indexset** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – A collection of integers to loop over.
+* **loop\_parameter** ([*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.parameter.Parameter") *| None*) – The placeholder parameterizing `body` to which the values from `indexset` will be assigned.
+* **body** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")) – The loop body to be repeatedly executed.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – An optional label for identifying the instruction.
+
+**Circuit symbol:**
+
+```python
+ ┌───────────┐
+q_0: ┤0 ├
+ │ │
+q_1: ┤1 ├
+ │ for_loop │
+q_2: ┤2 ├
+ │ │
+c_0: ╡0 ╞
+ └───────────┘
+```
+
+Create a new instruction.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – instruction name
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – instruction’s qubit width
+* **num\_clbits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – instruction’s clbit width
+* **params** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*|*[*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*|*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*|ndarray|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")*]*) – list of parameters
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – instruction’s duration. it must be integer if `unit` is ‘dt’
+* **unit** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – time unit of duration
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for identifying the instruction.
+
+**Raises**
+
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – when the register is not in the correct format.
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – when the optional label is provided, but it is not a string.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.ForLoopOp.base_class "qiskit.circuit.ForLoopOp.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that [`Instruction.name`](qiskit.circuit.Instruction#name "qiskit.circuit.Instruction.name") should be a more suitable discriminator in most situations.
+
+
+
+### blocks
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### add\_decomposition
+
+
+
+`add_decomposition(decomposition)`
+
+Add a decomposition of the instruction to the SessionEquivalenceLibrary.
+
+### assemble
+
+
+
+`assemble()`
+
+Assemble a QasmQobjInstruction
+
+### broadcast\_arguments
+
+
+
+`broadcast_arguments(qargs, cargs)`
+
+Validation of the arguments.
+
+**Parameters**
+
+* **qargs** (*List*) – List of quantum bit arguments.
+* **cargs** (*List*) – List of classical bit arguments.
+
+**Yields**
+
+*Tuple(List, List)* – A tuple with single arguments.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the input is not valid. For example, the number of arguments does not match the gate expectation.
+
+### c\_if
+
+
+
+`c_if(classical, val)`
+
+Set a classical equality condition on this instruction between the register or cbit `classical` and value `val`.
+
+
+ This is a setter method, not an additive one. Calling this multiple times will silently override any previously set condition; it does not stack.
+
+
+### copy
+
+
+
+`copy(name=None)`
+
+Copy of the instruction.
+
+**Parameters**
+
+**name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name to be given to the copied circuit, if `None` then the name stays the same.
+
+**Returns**
+
+a copy of the current instruction, with the name updated if it was provided
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this instruction.
+
+If the instruction is composite (i.e. has a definition), then its definition will be recursively inverted.
+
+Special instructions inheriting from Instruction can implement their own inverse (e.g. T and Tdg, Barrier, etc.)
+
+**Returns**
+
+a fresh instruction for the inverse
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the instruction is not composite and an inverse has not been implemented for it.
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True .IFF. instruction is parameterized else False
+
+### qasm
+
+
+
+`qasm()`
+
+Return a default OpenQASM string for the instruction.
+
+Derived instructions may override this to print in a different format (e.g. `measure q[0] -> c[0];`).
+
+
+ The method `qiskit.circuit.instruction.Instruction.qasm()` is deprecated as of qiskit-terra 0.25.0. It will be removed in the Qiskit 1.0 release. Correct exporting to OpenQASM 2 is the responsibility of a larger exporter; it cannot safely be done on an object-by-object basis without context. No replacement will be provided, because the premise is wrong.
+
+
+### repeat
+
+
+
+`repeat(n)`
+
+Creates an instruction with gate repeated n amount of times.
+
+**Parameters**
+
+**n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of times to repeat the instruction
+
+**Returns**
+
+Containing the definition.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If n \< 1.
+
+### replace\_blocks
+
+
+
+`replace_blocks(blocks)`
+
+Replace blocks and return new instruction. :param blocks: Tuple of QuantumCircuits to replace in instruction.
+
+**Returns**
+
+New ControlFlowOp with replaced blocks.
+
+### reverse\_ops
+
+
+
+`reverse_ops()`
+
+For a composite instruction, reverse the order of sub-instructions.
+
+This is done by recursively reversing all sub-instructions. It does not invert any gate.
+
+**Returns**
+
+**a new instruction with**
+
+sub-instructions reversed.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### soft\_compare
+
+
+
+`soft_compare(other)`
+
+Soft comparison between gates. Their names, number of qubits, and classical bit numbers must match. The number of parameters must match. Each parameter is compared. If one is a ParameterExpression then it is not taken into account.
+
+**Parameters**
+
+**other** (*instruction*) – other instruction.
+
+**Returns**
+
+are self and other equal up to parameter expressions.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### to\_mutable
+
+
+
+`to_mutable()`
+
+Return a mutable copy of this gate.
+
+This method will return a new mutable copy of this gate instance. If a singleton instance is being used this will be a new unique instance that can be mutated. If the instance is already mutable it will be a deepcopy of that instance.
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Instruction parameters has no validation or normalization.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.Gate.md b/docs/api/qiskit/0.46/qiskit.circuit.Gate.md
new file mode 100644
index 00000000000..910d4f5d9b0
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.Gate.md
@@ -0,0 +1,427 @@
+---
+title: Gate
+description: API reference for qiskit.circuit.Gate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.Gate
+---
+
+# Gate
+
+
+
+`qiskit.circuit.Gate(name, num_qubits, params, label=None, duration=None, unit='dt')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/gate.py "view source code")
+
+Bases: [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")
+
+Unitary gate.
+
+Create a new gate.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The Qobj name of the gate.
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of qubits the gate acts on.
+* **params** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of parameters.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – An optional label for the gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.Gate.base_class "qiskit.circuit.Gate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that [`Instruction.name`](qiskit.circuit.Instruction#name "qiskit.circuit.Instruction.name") should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### add\_decomposition
+
+
+
+`add_decomposition(decomposition)`
+
+Add a decomposition of the instruction to the SessionEquivalenceLibrary.
+
+### assemble
+
+
+
+`assemble()`
+
+Assemble a QasmQobjInstruction
+
+### broadcast\_arguments
+
+
+
+`broadcast_arguments(qargs, cargs)`
+
+Validation and handling of the arguments and its relationship.
+
+For example, `cx([q[0],q[1]], q[2])` means `cx(q[0], q[2]); cx(q[1], q[2])`. This method yields the arguments in the right grouping. In the given example:
+
+```python
+in: [[q[0],q[1]], q[2]],[]
+outs: [q[0], q[2]], []
+ [q[1], q[2]], []
+```
+
+The general broadcasting rules are:
+
+> * If len(qargs) == 1:
+>
+> ```python
+> [q[0], q[1]] -> [q[0]],[q[1]]
+> ```
+>
+> * If len(qargs) == 2:
+>
+> ```python
+> [[q[0], q[1]], [r[0], r[1]]] -> [q[0], r[0]], [q[1], r[1]]
+> [[q[0]], [r[0], r[1]]] -> [q[0], r[0]], [q[0], r[1]]
+> [[q[0], q[1]], [r[0]]] -> [q[0], r[0]], [q[1], r[0]]
+> ```
+>
+> * If len(qargs) >= 3:
+>
+> ```python
+> [q[0], q[1]], [r[0], r[1]], ...] -> [q[0], r[0], ...], [q[1], r[1], ...]
+> ```
+
+**Parameters**
+
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – List of quantum bit arguments.
+* **cargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – List of classical bit arguments.
+
+**Returns**
+
+A tuple with single arguments.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the input is not valid. For example, the number of arguments does not match the gate expectation.
+
+**Return type**
+
+[*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")\[[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)"), [list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")]]
+
+### c\_if
+
+
+
+`c_if(classical, val)`
+
+Set a classical equality condition on this instruction between the register or cbit `classical` and value `val`.
+
+
+ This is a setter method, not an additive one. Calling this multiple times will silently override any previously set condition; it does not stack.
+
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Return controlled version of gate. See [`ControlledGate`](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate") for usage.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of controls to add to gate (default: `1`)
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – optional gate label
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The control state in decimal or as a bitstring (e.g. `'111'`). If `None`, use `2**num_ctrl_qubits-1`.
+
+**Returns**
+
+Controlled version of gate. This default algorithm uses `num_ctrl_qubits-1` ancilla qubits so returns a gate of size `num_qubits + 2*num_ctrl_qubits - 1`.
+
+**Return type**
+
+[qiskit.circuit.ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – unrecognized mode or invalid ctrl\_state
+
+### copy
+
+
+
+`copy(name=None)`
+
+Copy of the instruction.
+
+**Parameters**
+
+**name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name to be given to the copied circuit, if `None` then the name stays the same.
+
+**Returns**
+
+a copy of the current instruction, with the name updated if it was provided
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this instruction.
+
+If the instruction is composite (i.e. has a definition), then its definition will be recursively inverted.
+
+Special instructions inheriting from Instruction can implement their own inverse (e.g. T and Tdg, Barrier, etc.)
+
+**Returns**
+
+a fresh instruction for the inverse
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the instruction is not composite and an inverse has not been implemented for it.
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True .IFF. instruction is parameterized else False
+
+### power
+
+
+
+`power(exponent)`
+
+Creates a unitary gate as gate^exponent.
+
+**Parameters**
+
+**exponent** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Gate^exponent
+
+**Returns**
+
+To which to\_matrix is self.to\_matrix^exponent.
+
+**Return type**
+
+.library.UnitaryGate
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If Gate is not unitary
+
+### qasm
+
+
+
+`qasm()`
+
+Return a default OpenQASM string for the instruction.
+
+Derived instructions may override this to print in a different format (e.g. `measure q[0] -> c[0];`).
+
+
+ The method `qiskit.circuit.instruction.Instruction.qasm()` is deprecated as of qiskit-terra 0.25.0. It will be removed in the Qiskit 1.0 release. Correct exporting to OpenQASM 2 is the responsibility of a larger exporter; it cannot safely be done on an object-by-object basis without context. No replacement will be provided, because the premise is wrong.
+
+
+### repeat
+
+
+
+`repeat(n)`
+
+Creates an instruction with gate repeated n amount of times.
+
+**Parameters**
+
+**n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of times to repeat the instruction
+
+**Returns**
+
+Containing the definition.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If n \< 1.
+
+### reverse\_ops
+
+
+
+`reverse_ops()`
+
+For a composite instruction, reverse the order of sub-instructions.
+
+This is done by recursively reversing all sub-instructions. It does not invert any gate.
+
+**Returns**
+
+**a new instruction with**
+
+sub-instructions reversed.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### soft\_compare
+
+
+
+`soft_compare(other)`
+
+Soft comparison between gates. Their names, number of qubits, and classical bit numbers must match. The number of parameters must match. Each parameter is compared. If one is a ParameterExpression then it is not taken into account.
+
+**Parameters**
+
+**other** (*instruction*) – other instruction.
+
+**Returns**
+
+are self and other equal up to parameter expressions.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### to\_matrix
+
+
+
+`to_matrix()`
+
+Return a Numpy.array for the gate unitary matrix.
+
+**Returns**
+
+if the Gate subclass has a matrix definition.
+
+**Return type**
+
+np.ndarray
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If a Gate subclass does not implement this method an exception will be raised when this base class method is called.
+
+### to\_mutable
+
+
+
+`to_mutable()`
+
+Return a mutable copy of this gate.
+
+This method will return a new mutable copy of this gate instance. If a singleton instance is being used this will be a new unique instance that can be mutated. If the instance is already mutable it will be a deepcopy of that instance.
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Gate parameters should be int, float, or ParameterExpression
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.IfElseOp.md b/docs/api/qiskit/0.46/qiskit.circuit.IfElseOp.md
new file mode 100644
index 00000000000..3df61193c64
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.IfElseOp.md
@@ -0,0 +1,378 @@
+---
+title: IfElseOp
+description: API reference for qiskit.circuit.IfElseOp
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.IfElseOp
+---
+
+# IfElseOp
+
+
+
+`qiskit.circuit.IfElseOp(condition, true_body, false_body=None, label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/controlflow/if_else.py "view source code")
+
+Bases: [`ControlFlowOp`](qiskit.circuit.ControlFlowOp "qiskit.circuit.controlflow.control_flow.ControlFlowOp")
+
+A circuit operation which executes a program (`true_body`) if a provided condition (`condition`) evaluates to true, and optionally evaluates another program (`false_body`) otherwise.
+
+**Parameters**
+
+* **condition** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*ClassicalRegister*](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] |* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*Clbit*](qiskit.circuit.Clbit "qiskit.circuit.Clbit")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] |* [*expr.Expr*](circuit_classical#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.Expr")) – A condition to be evaluated at circuit runtime which, if true, will trigger the evaluation of `true_body`. Can be specified as either a tuple of a `ClassicalRegister` to be tested for equality with a given `int`, or as a tuple of a `Clbit` to be compared to either a `bool` or an `int`.
+* **true\_body** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – A program to be executed if `condition` evaluates to true.
+* **false\_body** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| None*) – A optional program to be executed if `condition` evaluates to false.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – An optional label for identifying the instruction.
+
+If provided, `false_body` must be of the same `num_qubits` and `num_clbits` as `true_body`.
+
+The classical bits used in `condition` must be a subset of those attached to the circuit on which this `IfElseOp` will be appended.
+
+**Circuit symbol:**
+
+```python
+ ┌───────────┐
+q_0: ┤0 ├
+ │ │
+q_1: ┤1 ├
+ │ if_else │
+q_2: ┤2 ├
+ │ │
+c_0: ╡0 ╞
+ └───────────┘
+```
+
+Create a new instruction.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – instruction name
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – instruction’s qubit width
+* **num\_clbits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – instruction’s clbit width
+* **params** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*|*[*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*|*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*|ndarray|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")*]*) – list of parameters
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – instruction’s duration. it must be integer if `unit` is ‘dt’
+* **unit** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – time unit of duration
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for identifying the instruction.
+
+**Raises**
+
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – when the register is not in the correct format.
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – when the optional label is provided, but it is not a string.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.IfElseOp.base_class "qiskit.circuit.IfElseOp.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that [`Instruction.name`](qiskit.circuit.Instruction#name "qiskit.circuit.Instruction.name") should be a more suitable discriminator in most situations.
+
+
+
+### blocks
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### add\_decomposition
+
+
+
+`add_decomposition(decomposition)`
+
+Add a decomposition of the instruction to the SessionEquivalenceLibrary.
+
+### assemble
+
+
+
+`assemble()`
+
+Assemble a QasmQobjInstruction
+
+### broadcast\_arguments
+
+
+
+`broadcast_arguments(qargs, cargs)`
+
+Validation of the arguments.
+
+**Parameters**
+
+* **qargs** (*List*) – List of quantum bit arguments.
+* **cargs** (*List*) – List of classical bit arguments.
+
+**Yields**
+
+*Tuple(List, List)* – A tuple with single arguments.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the input is not valid. For example, the number of arguments does not match the gate expectation.
+
+### c\_if
+
+
+
+`c_if(classical, val)`
+
+Set a classical equality condition on this instruction between the register or cbit `classical` and value `val`.
+
+
+ This is a setter method, not an additive one. Calling this multiple times will silently override any previously set condition; it does not stack.
+
+
+### copy
+
+
+
+`copy(name=None)`
+
+Copy of the instruction.
+
+**Parameters**
+
+**name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name to be given to the copied circuit, if `None` then the name stays the same.
+
+**Returns**
+
+a copy of the current instruction, with the name updated if it was provided
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this instruction.
+
+If the instruction is composite (i.e. has a definition), then its definition will be recursively inverted.
+
+Special instructions inheriting from Instruction can implement their own inverse (e.g. T and Tdg, Barrier, etc.)
+
+**Returns**
+
+a fresh instruction for the inverse
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the instruction is not composite and an inverse has not been implemented for it.
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True .IFF. instruction is parameterized else False
+
+### qasm
+
+
+
+`qasm()`
+
+Return a default OpenQASM string for the instruction.
+
+Derived instructions may override this to print in a different format (e.g. `measure q[0] -> c[0];`).
+
+
+ The method `qiskit.circuit.instruction.Instruction.qasm()` is deprecated as of qiskit-terra 0.25.0. It will be removed in the Qiskit 1.0 release. Correct exporting to OpenQASM 2 is the responsibility of a larger exporter; it cannot safely be done on an object-by-object basis without context. No replacement will be provided, because the premise is wrong.
+
+
+### repeat
+
+
+
+`repeat(n)`
+
+Creates an instruction with gate repeated n amount of times.
+
+**Parameters**
+
+**n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of times to repeat the instruction
+
+**Returns**
+
+Containing the definition.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If n \< 1.
+
+### replace\_blocks
+
+
+
+`replace_blocks(blocks)`
+
+Replace blocks and return new instruction.
+
+**Parameters**
+
+**blocks** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")*]*) – Iterable of circuits for “if” and “else” condition. If there is no “else” circuit it may be set to None or omitted.
+
+**Returns**
+
+New IfElseOp with replaced blocks.
+
+**Return type**
+
+[*IfElseOp*](#qiskit.circuit.IfElseOp "qiskit.circuit.controlflow.if_else.IfElseOp")
+
+### reverse\_ops
+
+
+
+`reverse_ops()`
+
+For a composite instruction, reverse the order of sub-instructions.
+
+This is done by recursively reversing all sub-instructions. It does not invert any gate.
+
+**Returns**
+
+**a new instruction with**
+
+sub-instructions reversed.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### soft\_compare
+
+
+
+`soft_compare(other)`
+
+Soft comparison between gates. Their names, number of qubits, and classical bit numbers must match. The number of parameters must match. Each parameter is compared. If one is a ParameterExpression then it is not taken into account.
+
+**Parameters**
+
+**other** (*instruction*) – other instruction.
+
+**Returns**
+
+are self and other equal up to parameter expressions.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### to\_mutable
+
+
+
+`to_mutable()`
+
+Return a mutable copy of this gate.
+
+This method will return a new mutable copy of this gate instance. If a singleton instance is being used this will be a new unique instance that can be mutated. If the instance is already mutable it will be a deepcopy of that instance.
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Instruction parameters has no validation or normalization.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.Instruction.md b/docs/api/qiskit/0.46/qiskit.circuit.Instruction.md
new file mode 100644
index 00000000000..84594a70898
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.Instruction.md
@@ -0,0 +1,331 @@
+---
+title: Instruction
+description: API reference for qiskit.circuit.Instruction
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.Instruction
+---
+
+# Instruction
+
+
+
+`qiskit.circuit.Instruction(name, num_qubits, num_clbits, params, duration=None, unit='dt', label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/instruction.py "view source code")
+
+Bases: [`Operation`](qiskit.circuit.Operation "qiskit.circuit.operation.Operation")
+
+Generic quantum instruction.
+
+Create a new instruction.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – instruction name
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – instruction’s qubit width
+* **num\_clbits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – instruction’s clbit width
+* **params** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*|*[*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*|*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*|ndarray|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")*]*) – list of parameters
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – instruction’s duration. it must be integer if `unit` is ‘dt’
+* **unit** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – time unit of duration
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for identifying the instruction.
+
+**Raises**
+
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – when the register is not in the correct format.
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – when the optional label is provided, but it is not a string.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.Instruction.base_class "qiskit.circuit.Instruction.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that [`Instruction.name`](#qiskit.circuit.Instruction.name "qiskit.circuit.Instruction.name") should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### add\_decomposition
+
+
+
+`add_decomposition(decomposition)`
+
+Add a decomposition of the instruction to the SessionEquivalenceLibrary.
+
+### assemble
+
+
+
+`assemble()`
+
+Assemble a QasmQobjInstruction
+
+### broadcast\_arguments
+
+
+
+`broadcast_arguments(qargs, cargs)`
+
+Validation of the arguments.
+
+**Parameters**
+
+* **qargs** (*List*) – List of quantum bit arguments.
+* **cargs** (*List*) – List of classical bit arguments.
+
+**Yields**
+
+*Tuple(List, List)* – A tuple with single arguments.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the input is not valid. For example, the number of arguments does not match the gate expectation.
+
+### c\_if
+
+
+
+`c_if(classical, val)`
+
+Set a classical equality condition on this instruction between the register or cbit `classical` and value `val`.
+
+
+ This is a setter method, not an additive one. Calling this multiple times will silently override any previously set condition; it does not stack.
+
+
+### copy
+
+
+
+`copy(name=None)`
+
+Copy of the instruction.
+
+**Parameters**
+
+**name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name to be given to the copied circuit, if `None` then the name stays the same.
+
+**Returns**
+
+a copy of the current instruction, with the name updated if it was provided
+
+**Return type**
+
+[qiskit.circuit.Instruction](#qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this instruction.
+
+If the instruction is composite (i.e. has a definition), then its definition will be recursively inverted.
+
+Special instructions inheriting from Instruction can implement their own inverse (e.g. T and Tdg, Barrier, etc.)
+
+**Returns**
+
+a fresh instruction for the inverse
+
+**Return type**
+
+[qiskit.circuit.Instruction](#qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the instruction is not composite and an inverse has not been implemented for it.
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True .IFF. instruction is parameterized else False
+
+### qasm
+
+
+
+`qasm()`
+
+Return a default OpenQASM string for the instruction.
+
+Derived instructions may override this to print in a different format (e.g. `measure q[0] -> c[0];`).
+
+
+ The method `qiskit.circuit.instruction.Instruction.qasm()` is deprecated as of qiskit-terra 0.25.0. It will be removed in the Qiskit 1.0 release. Correct exporting to OpenQASM 2 is the responsibility of a larger exporter; it cannot safely be done on an object-by-object basis without context. No replacement will be provided, because the premise is wrong.
+
+
+### repeat
+
+
+
+`repeat(n)`
+
+Creates an instruction with gate repeated n amount of times.
+
+**Parameters**
+
+**n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of times to repeat the instruction
+
+**Returns**
+
+Containing the definition.
+
+**Return type**
+
+[qiskit.circuit.Instruction](#qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If n \< 1.
+
+### reverse\_ops
+
+
+
+`reverse_ops()`
+
+For a composite instruction, reverse the order of sub-instructions.
+
+This is done by recursively reversing all sub-instructions. It does not invert any gate.
+
+**Returns**
+
+**a new instruction with**
+
+sub-instructions reversed.
+
+**Return type**
+
+[qiskit.circuit.Instruction](#qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### soft\_compare
+
+
+
+`soft_compare(other)`
+
+Soft comparison between gates. Their names, number of qubits, and classical bit numbers must match. The number of parameters must match. Each parameter is compared. If one is a ParameterExpression then it is not taken into account.
+
+**Parameters**
+
+**other** (*instruction*) – other instruction.
+
+**Returns**
+
+are self and other equal up to parameter expressions.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### to\_mutable
+
+
+
+`to_mutable()`
+
+Return a mutable copy of this gate.
+
+This method will return a new mutable copy of this gate instance. If a singleton instance is being used this will be a new unique instance that can be mutated. If the instance is already mutable it will be a deepcopy of that instance.
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Instruction parameters has no validation or normalization.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.InstructionSet.md b/docs/api/qiskit/0.46/qiskit.circuit.InstructionSet.md
new file mode 100644
index 00000000000..63441668f32
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.InstructionSet.md
@@ -0,0 +1,121 @@
+---
+title: InstructionSet
+description: API reference for qiskit.circuit.InstructionSet
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.InstructionSet
+---
+
+# InstructionSet
+
+
+
+`qiskit.circuit.InstructionSet(*, resource_requester=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/instructionset.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Instruction collection, and their contexts.
+
+New collection of instructions.
+
+The context (`qargs` and `cargs` that each instruction is attached to) is also stored separately for each instruction.
+
+**Parameters**
+
+**resource\_requester** (*Callable\[...,* [*ClassicalRegister*](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister") *|*[*Clbit*](qiskit.circuit.Clbit "qiskit.circuit.Clbit")*] | None*) –
+
+A callable that takes in the classical resource used in the condition, verifies that it is present in the attached circuit, resolves any indices into concrete [`Clbit`](qiskit.circuit.Clbit "qiskit.circuit.Clbit") instances, and returns the concrete resource. If this is not given, specifying a condition with an index is forbidden, and all concrete [`Clbit`](qiskit.circuit.Clbit "qiskit.circuit.Clbit") and [`ClassicalRegister`](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister") resources will be assumed to be valid.
+
+
+ The callback `resource_requester` is called once for each call to [`c_if()`](#qiskit.circuit.InstructionSet.c_if "qiskit.circuit.InstructionSet.c_if"), and assumes that a call implies that the resource will now be used. It may throw an error if the resource is not valid for usage.
+
+
+## Attributes
+
+
+
+### cargs
+
+Legacy getter for the cargs components of an instruction set. This does not support mutation.
+
+
+
+### instructions
+
+Legacy getter for the instruction components of an instruction set. This does not support mutation.
+
+
+
+### qargs
+
+Legacy getter for the qargs components of an instruction set. This does not support mutation.
+
+## Methods
+
+### add
+
+
+
+`add(instruction, qargs=None, cargs=None)`
+
+Add an instruction and its context (where it is attached).
+
+### c\_if
+
+
+
+`c_if(classical, val)`
+
+Set a classical equality condition on all the instructions in this set between the [`ClassicalRegister`](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister") or [`Clbit`](qiskit.circuit.Clbit "qiskit.circuit.Clbit") `classical` and value `val`.
+
+
+ This is a setter method, not an additive one. Calling this multiple times will silently override any previously set condition on any of the contained instructions; it does not stack.
+
+
+**Parameters**
+
+* **classical** ([*Clbit*](qiskit.circuit.Clbit "qiskit.circuit.Clbit") *|*[*ClassicalRegister*](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the classical resource the equality condition should be on. If this is given as an integer, it will be resolved into a [`Clbit`](qiskit.circuit.Clbit "qiskit.circuit.Clbit") using the same conventions as the circuit these instructions are attached to.
+* **val** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the value the classical resource should be equal to.
+
+**Returns**
+
+This same instance of [`InstructionSet`](#qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet"), but now mutated to have the given equality condition.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the passed classical resource is invalid, or otherwise not resolvable to a concrete resource that these instructions are permitted to access.
+
+**Return type**
+
+[InstructionSet](#qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+**Example**
+
+```python
+from qiskit import ClassicalRegister, QuantumRegister, QuantumCircuit
+
+qr = QuantumRegister(2)
+cr = ClassicalRegister(2)
+qc = QuantumCircuit(qr, cr)
+qc.h(range(2))
+qc.measure(range(2), range(2))
+
+# apply x gate if the classical register has the value 2 (10 in binary)
+qc.x(0).c_if(cr, 2)
+
+# apply y gate if bit 0 is set to 1
+qc.y(1).c_if(0, 1)
+
+qc.draw('mpl')
+```
+
+
+
+### inverse
+
+
+
+`inverse()`
+
+Invert all instructions.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.InverseModifier.md b/docs/api/qiskit/0.46/qiskit.circuit.InverseModifier.md
new file mode 100644
index 00000000000..49503610b12
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.InverseModifier.md
@@ -0,0 +1,18 @@
+---
+title: InverseModifier
+description: API reference for qiskit.circuit.InverseModifier
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.InverseModifier
+---
+
+# InverseModifier
+
+
+
+`qiskit.circuit.InverseModifier`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/annotated_operation.py "view source code")
+
+Bases: `Modifier`
+
+Inverse modifier: specifies that the operation is inverted.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.Operation.md b/docs/api/qiskit/0.46/qiskit.circuit.Operation.md
new file mode 100644
index 00000000000..5b691c8f996
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.Operation.md
@@ -0,0 +1,55 @@
+---
+title: Operation
+description: API reference for qiskit.circuit.Operation
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.Operation
+---
+
+# Operation
+
+
+
+`qiskit.circuit.Operation`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/operation.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Quantum Operation Interface Class. For objects that can be added to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"). These objects include [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate"), `Reset`, `Barrier`, `Measure`, and operators such as [`Clifford`](qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford"). The main purpose is to add an [`Operation`](#qiskit.circuit.Operation "qiskit.circuit.Operation") to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") without synthesizing it before the transpilation.
+
+**Example**
+
+Add a Clifford and a Toffoli gate to a QuantumCircuit.
+
+```python
+from qiskit import QuantumCircuit
+from qiskit.quantum_info import Clifford, random_clifford
+
+qc = QuantumCircuit(3)
+cliff = random_clifford(2)
+qc.append(cliff, [0, 1])
+qc.ccx(0, 1, 2)
+qc.draw('mpl')
+```
+
+
+
+## Attributes
+
+
+
+### name
+
+Unique string identifier for operation type.
+
+
+
+### num\_clbits
+
+Number of classical bits.
+
+
+
+### num\_qubits
+
+Number of qubits.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.Parameter.md b/docs/api/qiskit/0.46/qiskit.circuit.Parameter.md
new file mode 100644
index 00000000000..16db09dd992
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.Parameter.md
@@ -0,0 +1,258 @@
+---
+title: Parameter
+description: API reference for qiskit.circuit.Parameter
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.Parameter
+---
+
+# Parameter
+
+
+
+`qiskit.circuit.Parameter(name, *, uuid=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/parameter.py "view source code")
+
+Bases: [`ParameterExpression`](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")
+
+Parameter Class for variable parameters.
+
+A parameter is a variable value that is not required to be fixed at circuit definition.
+
+**Examples**
+
+Construct a variable-rotation X gate using circuit parameters.
+
+```python
+from qiskit.circuit import QuantumCircuit, Parameter
+
+# create the parameter
+phi = Parameter('phi')
+qc = QuantumCircuit(1)
+
+# parameterize the rotation
+qc.rx(phi, 0)
+qc.draw('mpl')
+
+# bind the parameters after circuit to create a bound circuit
+bc = qc.assign_parameters({phi: 3.14})
+bc.measure_all()
+bc.draw('mpl')
+```
+
+
+
+
+
+Create a new named [`Parameter`](#qiskit.circuit.Parameter "qiskit.circuit.Parameter").
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name of the `Parameter`, used for visual representation. This can be any unicode string, e.g. “ϕ”.
+* **uuid** (*UUID | None*) – For advanced usage only. Override the UUID of this parameter, in order to make it compare equal to some other parameter object. By default, two parameters with the same name do not compare equal to help catch shadowing bugs when two circuits containing the same named parameters are spurious combined. Setting the `uuid` field when creating two parameters to the same thing (along with the same name) allows them to be equal. This is useful during serialization and deserialization.
+
+## Attributes
+
+
+
+### name
+
+Returns the name of the [`Parameter`](#qiskit.circuit.Parameter "qiskit.circuit.Parameter").
+
+
+
+### parameters
+
+Returns a set of the unbound Parameters in the expression.
+
+## Methods
+
+### abs
+
+
+
+`abs()`
+
+Absolute of a ParameterExpression
+
+### arccos
+
+
+
+`arccos()`
+
+Arccos of a ParameterExpression
+
+### arcsin
+
+
+
+`arcsin()`
+
+Arcsin of a ParameterExpression
+
+### arctan
+
+
+
+`arctan()`
+
+Arctan of a ParameterExpression
+
+### assign
+
+
+
+`assign(parameter, value)`
+
+Assign one parameter to a value, which can either be numeric or another parameter expression.
+
+**Parameters**
+
+* **parameter** ([*Parameter*](#qiskit.circuit.Parameter "qiskit.circuit.Parameter")) – A parameter in this expression whose value will be updated.
+* **value** – The new value to bind to.
+
+**Returns**
+
+A new expression parameterized by any parameters which were not bound by assignment.
+
+### bind
+
+
+
+`bind(parameter_values, allow_unknown_parameters=False)`
+
+Binds the provided set of parameters to their corresponding values.
+
+**Parameters**
+
+* **parameter\_values** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – Mapping of Parameter instances to the numeric value to which they will be bound.
+* **allow\_unknown\_parameters** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If `False`, raises an error if `parameter_values` contains Parameters in the keys outside those present in the expression. If `True`, any such parameters are simply ignored.
+
+**Raises**
+
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") –
+
+ * If parameter\_values contains Parameters outside those in self. - If a non-numeric value is passed in parameter\_values.
+
+* [**ZeroDivisionError**](https://docs.python.org/3/library/exceptions.html#ZeroDivisionError "(in Python v3.12)") –
+
+ * If binding the provided values requires division by zero.
+
+**Returns**
+
+A new expression parameterized by any parameters which were not bound by parameter\_values.
+
+**Return type**
+
+[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")
+
+### conjugate
+
+
+
+`conjugate()`
+
+Return the conjugate.
+
+**Return type**
+
+[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")
+
+### cos
+
+
+
+`cos()`
+
+Cosine of a ParameterExpression
+
+### exp
+
+
+
+`exp()`
+
+Exponential of a ParameterExpression
+
+### gradient
+
+
+
+`gradient(param)`
+
+Get the derivative of a parameter expression w\.r.t. a specified parameter expression.
+
+**Parameters**
+
+**param** ([*Parameter*](#qiskit.circuit.Parameter "qiskit.circuit.Parameter")) – Parameter w\.r.t. which we want to take the derivative
+
+**Returns**
+
+ParameterExpression representing the gradient of param\_expr w\.r.t. param or complex or float number
+
+**Return type**
+
+[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") | [complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")
+
+### is\_real
+
+
+
+`is_real()`
+
+Return whether the expression is real
+
+### log
+
+
+
+`log()`
+
+Logarithm of a ParameterExpression
+
+### sign
+
+
+
+`sign()`
+
+Sign of a ParameterExpression
+
+### sin
+
+
+
+`sin()`
+
+Sine of a ParameterExpression
+
+### subs
+
+
+
+`subs(parameter_map, allow_unknown_parameters=False)`
+
+Substitute self with the corresponding parameter in `parameter_map`.
+
+### sympify
+
+
+
+`sympify()`
+
+Return symbolic expression as a raw Sympy or Symengine object.
+
+Symengine is used preferentially; if both are available, the result will always be a `symengine` object. Symengine is a separate library but has integration with Sympy.
+
+
+ This is for interoperability only. Qiskit will not accept or work with raw Sympy or Symegine expressions in its parameters, because they do not contain the tracking information used in circuit-parameter binding and assignment.
+
+
+### tan
+
+
+
+`tan()`
+
+Tangent of a ParameterExpression
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.ParameterExpression.md b/docs/api/qiskit/0.46/qiskit.circuit.ParameterExpression.md
new file mode 100644
index 00000000000..b151f6fa9c4
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.ParameterExpression.md
@@ -0,0 +1,250 @@
+---
+title: ParameterExpression
+description: API reference for qiskit.circuit.ParameterExpression
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.ParameterExpression
+---
+
+# ParameterExpression
+
+
+
+`qiskit.circuit.ParameterExpression(symbol_map, expr)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/parameterexpression.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+ParameterExpression class to enable creating expressions of Parameters.
+
+Create a new [`ParameterExpression`](#qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression").
+
+Not intended to be called directly, but to be instantiated via operations on other [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") or [`ParameterExpression`](#qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression") objects.
+
+**Parameters**
+
+* **symbol\_map** (*Dict\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*, \[*[*ParameterExpression*](#qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*, or* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]]*) – Mapping of [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") instances to the `sympy.Symbol` serving as their placeholder in expr.
+* **expr** (*sympy.Expr*) – Expression of `sympy.Symbol` s.
+
+## Attributes
+
+
+
+### parameters
+
+Returns a set of the unbound Parameters in the expression.
+
+## Methods
+
+### abs
+
+
+
+`abs()`
+
+Absolute of a ParameterExpression
+
+### arccos
+
+
+
+`arccos()`
+
+Arccos of a ParameterExpression
+
+### arcsin
+
+
+
+`arcsin()`
+
+Arcsin of a ParameterExpression
+
+### arctan
+
+
+
+`arctan()`
+
+Arctan of a ParameterExpression
+
+### assign
+
+
+
+`assign(parameter, value)`
+
+Assign one parameter to a value, which can either be numeric or another parameter expression.
+
+**Parameters**
+
+* **parameter** ([*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")) – A parameter in this expression whose value will be updated.
+* **value** ([*ParameterExpression*](#qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The new value to bind to.
+
+**Returns**
+
+A new expression parameterized by any parameters which were not bound by assignment.
+
+**Return type**
+
+[*ParameterExpression*](#qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")
+
+### bind
+
+
+
+`bind(parameter_values, allow_unknown_parameters=False)`
+
+Binds the provided set of parameters to their corresponding values.
+
+**Parameters**
+
+* **parameter\_values** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – Mapping of Parameter instances to the numeric value to which they will be bound.
+* **allow\_unknown\_parameters** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If `False`, raises an error if `parameter_values` contains Parameters in the keys outside those present in the expression. If `True`, any such parameters are simply ignored.
+
+**Raises**
+
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") –
+
+ * If parameter\_values contains Parameters outside those in self. - If a non-numeric value is passed in parameter\_values.
+
+* [**ZeroDivisionError**](https://docs.python.org/3/library/exceptions.html#ZeroDivisionError "(in Python v3.12)") –
+
+ * If binding the provided values requires division by zero.
+
+**Returns**
+
+A new expression parameterized by any parameters which were not bound by parameter\_values.
+
+**Return type**
+
+[*ParameterExpression*](#qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")
+
+### conjugate
+
+
+
+`conjugate()`
+
+Return the conjugate.
+
+**Return type**
+
+[*ParameterExpression*](#qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")
+
+### cos
+
+
+
+`cos()`
+
+Cosine of a ParameterExpression
+
+### exp
+
+
+
+`exp()`
+
+Exponential of a ParameterExpression
+
+### gradient
+
+
+
+`gradient(param)`
+
+Get the derivative of a parameter expression w\.r.t. a specified parameter expression.
+
+**Parameters**
+
+**param** ([*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")) – Parameter w\.r.t. which we want to take the derivative
+
+**Returns**
+
+ParameterExpression representing the gradient of param\_expr w\.r.t. param or complex or float number
+
+**Return type**
+
+[*ParameterExpression*](#qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") | [complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")
+
+### is\_real
+
+
+
+`is_real()`
+
+Return whether the expression is real
+
+### log
+
+
+
+`log()`
+
+Logarithm of a ParameterExpression
+
+### sign
+
+
+
+`sign()`
+
+Sign of a ParameterExpression
+
+### sin
+
+
+
+`sin()`
+
+Sine of a ParameterExpression
+
+### subs
+
+
+
+`subs(parameter_map, allow_unknown_parameters=False)`
+
+Returns a new Expression with replacement Parameters.
+
+**Parameters**
+
+* **parameter\_map** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – Mapping from Parameters in self to the ParameterExpression instances with which they should be replaced.
+* **allow\_unknown\_parameters** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If `False`, raises an error if `parameter_map` contains Parameters in the keys outside those present in the expression. If `True`, any such parameters are simply ignored.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") –
+
+* If parameter\_map contains Parameters outside those in self. - If the replacement Parameters in parameter\_map would result in a name conflict in the generated expression.
+
+**Returns**
+
+A new expression with the specified parameters replaced.
+
+**Return type**
+
+[*ParameterExpression*](#qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")
+
+### sympify
+
+
+
+`sympify()`
+
+Return symbolic expression as a raw Sympy or Symengine object.
+
+Symengine is used preferentially; if both are available, the result will always be a `symengine` object. Symengine is a separate library but has integration with Sympy.
+
+
+ This is for interoperability only. Qiskit will not accept or work with raw Sympy or Symegine expressions in its parameters, because they do not contain the tracking information used in circuit-parameter binding and assignment.
+
+
+### tan
+
+
+
+`tan()`
+
+Tangent of a ParameterExpression
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.ParameterVector.md b/docs/api/qiskit/0.46/qiskit.circuit.ParameterVector.md
new file mode 100644
index 00000000000..3ba494c36aa
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.ParameterVector.md
@@ -0,0 +1,52 @@
+---
+title: ParameterVector
+description: API reference for qiskit.circuit.ParameterVector
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.ParameterVector
+---
+
+# ParameterVector
+
+
+
+`qiskit.circuit.ParameterVector(name, length=0)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/parametervector.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+ParameterVector class to quickly generate lists of parameters.
+
+## Attributes
+
+
+
+### name
+
+Returns the name of the ParameterVector.
+
+
+
+### params
+
+Returns the list of parameters in the ParameterVector.
+
+## Methods
+
+### index
+
+
+
+`index(value)`
+
+Returns first index of value.
+
+### resize
+
+
+
+`resize(length)`
+
+Resize the parameter vector.
+
+If necessary, new elements are generated. If length is smaller than before, the previous elements are cached and not re-generated if the vector is enlarged again. This is to ensure that the parameter instances do not change.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.PowerModifier.md b/docs/api/qiskit/0.46/qiskit.circuit.PowerModifier.md
new file mode 100644
index 00000000000..d05c37059a4
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.PowerModifier.md
@@ -0,0 +1,26 @@
+---
+title: PowerModifier
+description: API reference for qiskit.circuit.PowerModifier
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.PowerModifier
+---
+
+# PowerModifier
+
+
+
+`qiskit.circuit.PowerModifier(power)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/annotated_operation.py "view source code")
+
+Bases: `Modifier`
+
+Power modifier: specifies that the operation is raised to the power `power`.
+
+## Attributes
+
+
+
+### power
+
+`float`
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.QuantumCircuit.md b/docs/api/qiskit/0.46/qiskit.circuit.QuantumCircuit.md
new file mode 100644
index 00000000000..405af621f63
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.QuantumCircuit.md
@@ -0,0 +1,3922 @@
+---
+title: QuantumCircuit
+description: API reference for qiskit.circuit.QuantumCircuit
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.QuantumCircuit
+---
+
+# QuantumCircuit
+
+
+
+`qiskit.circuit.QuantumCircuit(*regs, name=None, global_phase=0, metadata=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/quantumcircuit.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Create a new circuit.
+
+A circuit is a list of instructions bound to some registers.
+
+**Parameters**
+
+* **regs** (list([`Register`](qiskit.circuit.Register "qiskit.circuit.Register")) or list(`int`) or list(list([`Bit`](qiskit.circuit.Bit "qiskit.circuit.Bit")))) –
+
+ The registers to be included in the circuit.
+
+ * If a list of [`Register`](qiskit.circuit.Register "qiskit.circuit.Register") objects, represents the [`QuantumRegister`](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister") and/or [`ClassicalRegister`](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister") objects to include in the circuit.
+
+ For example:
+
+ > * `QuantumCircuit(QuantumRegister(4))`
+ > * `QuantumCircuit(QuantumRegister(4), ClassicalRegister(3))`
+ > * `QuantumCircuit(QuantumRegister(4, 'qr0'), QuantumRegister(2, 'qr1'))`
+
+ * If a list of `int`, the amount of qubits and/or classical bits to include in the circuit. It can either be a single int for just the number of quantum bits, or 2 ints for the number of quantum bits and classical bits, respectively.
+
+ For example:
+
+ > * `QuantumCircuit(4) # A QuantumCircuit with 4 qubits`
+ > * `QuantumCircuit(4, 3) # A QuantumCircuit with 4 qubits and 3 classical bits`
+
+ * If a list of python lists containing [`Bit`](qiskit.circuit.Bit "qiskit.circuit.Bit") objects, a collection of [`Bit`](qiskit.circuit.Bit "qiskit.circuit.Bit") s to be added to the circuit.
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – the name of the quantum circuit. If not set, an automatically generated string will be assigned.
+
+* **global\_phase** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *or*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")) – The global phase of the circuit in radians.
+
+* **metadata** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – Arbitrary key value metadata to associate with the circuit. This gets stored as free-form data in a dict in the [`metadata`](#qiskit.circuit.QuantumCircuit.metadata "qiskit.circuit.QuantumCircuit.metadata") attribute. It will not be directly used in the circuit.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the circuit name, if given, is not valid.
+
+**Examples**
+
+Construct a simple Bell state circuit.
+
+```python
+from qiskit import QuantumCircuit
+
+qc = QuantumCircuit(2, 2)
+qc.h(0)
+qc.cx(0, 1)
+qc.measure([0, 1], [0, 1])
+qc.draw('mpl')
+```
+
+
+
+Construct a 5-qubit GHZ circuit.
+
+```python
+from qiskit import QuantumCircuit
+
+qc = QuantumCircuit(5)
+qc.h(0)
+qc.cx(0, range(1, 5))
+qc.measure_all()
+```
+
+Construct a 4-qubit Bernstein-Vazirani circuit using registers.
+
+```python
+from qiskit import QuantumRegister, ClassicalRegister, QuantumCircuit
+
+qr = QuantumRegister(3, 'q')
+anc = QuantumRegister(1, 'ancilla')
+cr = ClassicalRegister(3, 'c')
+qc = QuantumCircuit(qr, anc, cr)
+
+qc.x(anc[0])
+qc.h(anc[0])
+qc.h(qr[0:3])
+qc.cx(qr[0:3], anc[0])
+qc.h(qr[0:3])
+qc.barrier(qr)
+qc.measure(qr, cr)
+
+qc.draw('mpl')
+```
+
+
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 183`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in [`QuantumCircuit.data`](#qiskit.circuit.QuantumCircuit.data "qiskit.circuit.QuantumCircuit.data").
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+## Methods
+
+### add\_bits
+
+
+
+`add_bits(bits)`
+
+Add Bits to the circuit.
+
+### add\_calibration
+
+
+
+`add_calibration(gate, qubits, schedule, params=None)`
+
+Register a low-level, custom pulse definition for the given gate.
+
+**Parameters**
+
+* **gate** (*Union\[*[*Gate*](qiskit.circuit.Gate "qiskit.circuit.Gate")*,* [*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – Gate information.
+* **qubits** (*Union\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*, Tuple\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]]*) – List of qubits to be measured.
+* **schedule** ([*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule")) – Schedule information.
+* **params** (*Optional\[List\[Union\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*]]]*) – A list of parameters.
+
+**Raises**
+
+[**Exception**](https://docs.python.org/3/library/exceptions.html#Exception "(in Python v3.12)") – if the gate is of type string and params is None.
+
+### add\_register
+
+
+
+`add_register(*regs)`
+
+Add registers.
+
+### append
+
+
+
+`append(instruction, qargs=None, cargs=None)`
+
+Append one or more instructions to the end of the circuit, modifying the circuit in place.
+
+The `qargs` and `cargs` will be expanded and broadcast according to the rules of the given [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction"), and any non-[`Bit`](qiskit.circuit.Bit "qiskit.circuit.Bit") specifiers (such as integer indices) will be resolved into the relevant instances.
+
+If a [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction") is given, it will be unwrapped, verified in the context of this circuit, and a new object will be appended to the circuit. In this case, you may not pass `qargs` or `cargs` separately.
+
+**Parameters**
+
+* **instruction** ([*Operation*](qiskit.circuit.Operation "qiskit.circuit.Operation") *|*[*CircuitInstruction*](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")) – [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instance to append, or a [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction") with all its context.
+* **qargs** (*Sequence\[QubitSpecifier] | None*) – specifiers of the [`Qubit`](qiskit.circuit.Qubit "qiskit.circuit.Qubit")s to attach instruction to.
+* **cargs** (*Sequence\[ClbitSpecifier] | None*) – specifiers of the [`Clbit`](qiskit.circuit.Clbit "qiskit.circuit.Clbit")s to attach instruction to.
+
+**Returns**
+
+a handle to the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s that were actually added to the circuit.
+
+**Return type**
+
+[qiskit.circuit.InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the operation passed is not an instance of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") .
+
+### assign\_parameters
+
+### assign\_parameters
+
+
+
+`assign_parameters(parameters: Mapping[Parameter, ParameterExpression | float] | Sequence[ParameterExpression | float], inplace: Literal[False] = False, *, flat_input: bool = False, strict: bool = True) → QuantumCircuit`
+
+
+
+`assign_parameters(parameters: Mapping[Parameter, ParameterExpression | float] | Sequence[ParameterExpression | float], inplace: Literal[True] = False, *, flat_input: bool = False, strict: bool = True) → None`
+
+Assign parameters to new parameters or values.
+
+If `parameters` is passed as a dictionary, the keys must be [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") instances in the current circuit. The values of the dictionary can either be numeric values or new parameter objects.
+
+If `parameters` is passed as a list or array, the elements are assigned to the current parameters in the order of [`parameters`](#qiskit.circuit.QuantumCircuit.parameters "qiskit.circuit.QuantumCircuit.parameters") which is sorted alphabetically (while respecting the ordering in [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") objects).
+
+The values can be assigned to the current circuit object or to a copy of it.
+
+**Parameters**
+
+* **parameters** – Either a dictionary or iterable specifying the new parameter values.
+* **inplace** – If False, a copy of the circuit with the bound parameters is returned. If True the circuit instance itself is modified.
+* **flat\_input** – If `True` and `parameters` is a mapping type, it is assumed to be exactly a mapping of `{parameter: value}`. By default (`False`), the mapping may also contain [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") keys that point to a corresponding sequence of values, and these will be unrolled during the mapping.
+* **strict** – If `False`, any parameters given in the mapping that are not used in the circuit will be ignored. If `True` (the default), an error will be raised indicating a logic error.
+
+**Raises**
+
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If parameters is a dict and contains parameters not present in the circuit.
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If parameters is a list/array and the length mismatches the number of free parameters in the circuit.
+
+**Returns**
+
+A copy of the circuit with bound parameters if `inplace` is False, otherwise None.
+
+**Examples**
+
+Create a parameterized circuit and assign the parameters in-place.
+
+```python
+from qiskit.circuit import QuantumCircuit, Parameter
+
+circuit = QuantumCircuit(2)
+params = [Parameter('A'), Parameter('B'), Parameter('C')]
+circuit.ry(params[0], 0)
+circuit.crx(params[1], 0, 1)
+circuit.draw('mpl')
+circuit.assign_parameters({params[0]: params[2]}, inplace=True)
+circuit.draw('mpl')
+```
+
+
+
+
+
+Bind the values out-of-place by list and get a copy of the original circuit.
+
+```python
+from qiskit.circuit import QuantumCircuit, ParameterVector
+
+circuit = QuantumCircuit(2)
+params = ParameterVector('P', 2)
+circuit.ry(params[0], 0)
+circuit.crx(params[1], 0, 1)
+
+bound_circuit = circuit.assign_parameters([1, 2])
+bound_circuit.draw('mpl')
+
+circuit.draw('mpl')
+```
+
+
+
+
+
+### barrier
+
+
+
+`barrier(*qargs, label=None)`
+
+Apply [`Barrier`](qiskit.circuit.library.Barrier "qiskit.circuit.library.Barrier"). If `qargs` is empty, applies to all qubits in the circuit.
+
+**Parameters**
+
+* **qargs** (*QubitSpecifier*) – Specification for one or more qubit arguments.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The string label of the barrier.
+
+**Returns**
+
+handle to the added instructions.
+
+**Return type**
+
+[qiskit.circuit.InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+### bind\_parameters
+
+
+
+`bind_parameters(values)`
+
+Assign numeric parameters to values yielding a new circuit.
+
+If the values are given as list or array they are bound to the circuit in the order of [`parameters`](#qiskit.circuit.QuantumCircuit.parameters "qiskit.circuit.QuantumCircuit.parameters") (see the docstring for more details).
+
+To assign new Parameter objects or bind the values in-place, without yielding a new circuit, use the [`assign_parameters()`](#qiskit.circuit.QuantumCircuit.assign_parameters "qiskit.circuit.QuantumCircuit.assign_parameters") method.
+
+
+ The method `qiskit.circuit.quantumcircuit.QuantumCircuit.bind_parameters()` is deprecated as of qiskit 0.45.0. It will be removed in the Qiskit 1.0.0 release. Use assign\_parameters() instead
+
+
+**Parameters**
+
+**values** ([*Mapping*](https://docs.python.org/3/library/typing.html#typing.Mapping "(in Python v3.12)")*\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.parameter.Parameter")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] |* [*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – `{parameter: value, ...}` or `[value1, value2, ...]`
+
+**Raises**
+
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If values is a dict and contains parameters not present in the circuit.
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – If values contains a ParameterExpression.
+
+**Returns**
+
+Copy of self with assignment substitution.
+
+**Return type**
+
+[*QuantumCircuit*](#qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+### break\_loop
+
+
+
+`break_loop()`
+
+Apply [`BreakLoopOp`](qiskit.circuit.BreakLoopOp "qiskit.circuit.BreakLoopOp").
+
+
+ If you are using the context-manager “builder” forms of [`if_test()`](#qiskit.circuit.QuantumCircuit.if_test "qiskit.circuit.QuantumCircuit.if_test"), [`for_loop()`](#qiskit.circuit.QuantumCircuit.for_loop "qiskit.circuit.QuantumCircuit.for_loop") or [`while_loop()`](#qiskit.circuit.QuantumCircuit.while_loop "qiskit.circuit.QuantumCircuit.while_loop"), you can only call this method if you are within a loop context, because otherwise the “resource width” of the operation cannot be determined. This would quickly lead to invalid circuits, and so if you are trying to construct a reusable loop body (without the context managers), you must also use the non-context-manager form of [`if_test()`](#qiskit.circuit.QuantumCircuit.if_test "qiskit.circuit.QuantumCircuit.if_test") and [`if_else()`](#qiskit.circuit.QuantumCircuit.if_else "qiskit.circuit.QuantumCircuit.if_else"). Take care that the [`BreakLoopOp`](qiskit.circuit.BreakLoopOp "qiskit.circuit.BreakLoopOp") instruction must span all the resources of its containing loop, not just the immediate scope.
+
+
+**Returns**
+
+A handle to the instruction created.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if this method was called within a builder context, but not contained within a loop.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### cast
+
+
+
+`static cast(value, type_)`
+
+Best effort to cast value to type. Otherwise, returns the value.
+
+**Return type**
+
+*S* | *T*
+
+### cbit\_argument\_conversion
+
+
+
+`cbit_argument_conversion(clbit_representation)`
+
+Converts several classical bit representations (such as indexes, range, etc.) into a list of classical bits.
+
+**Parameters**
+
+**clbit\_representation** (*Object*) – representation to expand
+
+**Returns**
+
+Where each tuple is a classical bit.
+
+**Return type**
+
+List([tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)"))
+
+### ccx
+
+
+
+`ccx(control_qubit1, control_qubit2, target_qubit, ctrl_state=None)`
+
+Apply [`CCXGate`](qiskit.circuit.library.CCXGate "qiskit.circuit.library.CCXGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **control\_qubit1** (*QubitSpecifier*) – The qubit(s) used as the first control.
+* **control\_qubit2** (*QubitSpecifier*) – The qubit(s) used as the second control.
+* **target\_qubit** (*QubitSpecifier*) – The qubit(s) targeted by the gate.
+* **ctrl\_state** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The control state in decimal, or as a bitstring (e.g. ‘1’). Defaults to controlling on the ‘1’ state.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+### ccz
+
+
+
+`ccz(control_qubit1, control_qubit2, target_qubit, label=None, ctrl_state=None)`
+
+Apply [`CCZGate`](qiskit.circuit.library.CCZGate "qiskit.circuit.library.CCZGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **control\_qubit1** (*QubitSpecifier*) – The qubit(s) used as the first control.
+* **control\_qubit2** (*QubitSpecifier*) – The qubit(s) used as the second control.
+* **target\_qubit** (*QubitSpecifier*) – The qubit(s) targeted by the gate.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The string label of the gate in the circuit.
+* **ctrl\_state** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The control state in decimal, or as a bitstring (e.g. ‘10’). Defaults to controlling on the ‘11’ state.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+### ch
+
+
+
+`ch(control_qubit, target_qubit, label=None, ctrl_state=None)`
+
+Apply [`CHGate`](qiskit.circuit.library.CHGate "qiskit.circuit.library.CHGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **control\_qubit** (*QubitSpecifier*) – The qubit(s) used as the control.
+* **target\_qubit** (*QubitSpecifier*) – The qubit(s) targeted by the gate.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The string label of the gate in the circuit.
+* **ctrl\_state** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The control state in decimal, or as a bitstring (e.g. ‘1’). Defaults to controlling on the ‘1’ state.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+### clear
+
+
+
+`clear()`
+
+Clear all instructions in self.
+
+Clearing the circuits will keep the metadata and calibrations.
+
+### cls\_instances
+
+
+
+`classmethod cls_instances()`
+
+Return the current number of instances of this class, useful for auto naming.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### cls\_prefix
+
+
+
+`classmethod cls_prefix()`
+
+Return the prefix to use for auto naming.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### cnot
+
+
+
+`cnot(control_qubit, target_qubit, label=None, ctrl_state=None)`
+
+Apply [`CXGate`](qiskit.circuit.library.CXGate "qiskit.circuit.library.CXGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+
+ The method `qiskit.circuit.quantumcircuit.QuantumCircuit.cnot()` is deprecated as of qiskit 0.45.0. It will be removed in the Qiskit 1.0.0 release. Use QuantumCircuit.cx as direct replacement.
+
+
+**Parameters**
+
+* **control\_qubit** (*QubitSpecifier*) – The qubit(s) used as the control.
+* **target\_qubit** (*QubitSpecifier*) – The qubit(s) targeted by the gate.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The string label of the gate in the circuit.
+* **ctrl\_state** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The control state in decimal, or as a bitstring (e.g. ‘1’). Defaults to controlling on the ‘1’ state.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+
+ QuantumCircuit.cx: the same function with a different name.
+
+
+### compose
+
+
+
+`compose(other, qubits=None, clbits=None, front=False, inplace=False, wrap=False)`
+
+Compose circuit with `other` circuit or instruction, optionally permuting wires.
+
+`other` can be narrower or of equal width to `self`.
+
+**Parameters**
+
+* **other** ([*qiskit.circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction") *or*[*QuantumCircuit*](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – (sub)circuit or instruction to compose onto self. If not a [`QuantumCircuit`](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), this can be anything that [`append`](#qiskit.circuit.QuantumCircuit.append "qiskit.circuit.QuantumCircuit.append") will accept.
+* **qubits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – qubits of self to compose onto.
+* **clbits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Clbit*](qiskit.circuit.Clbit "qiskit.circuit.Clbit")*|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – clbits of self to compose onto.
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, front composition will be performed. This is not possible within control-flow builder context managers.
+* **inplace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, modify the object. Otherwise return composed circuit.
+* **wrap** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, wraps the other circuit into a gate (or instruction, depending on whether it contains only unitary instructions) before composing it onto self.
+
+**Returns**
+
+the composed circuit (returns None if inplace==True).
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if no correct wire mapping can be made between the two circuits, such as if `other` is wider than `self`.
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if trying to emit a new circuit while `self` has a partially built control-flow context active, such as the context-manager forms of [`if_test()`](#qiskit.circuit.QuantumCircuit.if_test "qiskit.circuit.QuantumCircuit.if_test"), [`for_loop()`](#qiskit.circuit.QuantumCircuit.for_loop "qiskit.circuit.QuantumCircuit.for_loop") and [`while_loop()`](#qiskit.circuit.QuantumCircuit.while_loop "qiskit.circuit.QuantumCircuit.while_loop").
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if trying to compose to the front of a circuit when a control-flow builder block is active; there is no clear meaning to this action.
+
+**Examples**
+
+```python
+>>> lhs.compose(rhs, qubits=[3, 2], inplace=True)
+```
+
+```python
+ ┌───┐ ┌─────┐ ┌───┐
+lqr_1_0: ───┤ H ├─── rqr_0: ──■──┤ Tdg ├ lqr_1_0: ───┤ H ├───────────────
+ ├───┤ ┌─┴─┐└─────┘ ├───┤
+lqr_1_1: ───┤ X ├─── rqr_1: ┤ X ├─────── lqr_1_1: ───┤ X ├───────────────
+ ┌──┴───┴──┐ └───┘ ┌──┴───┴──┐┌───┐
+lqr_1_2: ┤ U1(0.1) ├ + = lqr_1_2: ┤ U1(0.1) ├┤ X ├───────
+ └─────────┘ └─────────┘└─┬─┘┌─────┐
+lqr_2_0: ─────■───── lqr_2_0: ─────■───────■──┤ Tdg ├
+ ┌─┴─┐ ┌─┴─┐ └─────┘
+lqr_2_1: ───┤ X ├─── lqr_2_1: ───┤ X ├───────────────
+ └───┘ └───┘
+lcr_0: 0 ═══════════ lcr_0: 0 ═══════════════════════
+
+lcr_1: 0 ═══════════ lcr_1: 0 ═══════════════════════
+```
+
+### continue\_loop
+
+
+
+`continue_loop()`
+
+Apply [`ContinueLoopOp`](qiskit.circuit.ContinueLoopOp "qiskit.circuit.ContinueLoopOp").
+
+
+ If you are using the context-manager “builder” forms of [`if_test()`](#qiskit.circuit.QuantumCircuit.if_test "qiskit.circuit.QuantumCircuit.if_test"), [`for_loop()`](#qiskit.circuit.QuantumCircuit.for_loop "qiskit.circuit.QuantumCircuit.for_loop") or [`while_loop()`](#qiskit.circuit.QuantumCircuit.while_loop "qiskit.circuit.QuantumCircuit.while_loop"), you can only call this method if you are within a loop context, because otherwise the “resource width” of the operation cannot be determined. This would quickly lead to invalid circuits, and so if you are trying to construct a reusable loop body (without the context managers), you must also use the non-context-manager form of [`if_test()`](#qiskit.circuit.QuantumCircuit.if_test "qiskit.circuit.QuantumCircuit.if_test") and [`if_else()`](#qiskit.circuit.QuantumCircuit.if_else "qiskit.circuit.QuantumCircuit.if_else"). Take care that the [`ContinueLoopOp`](qiskit.circuit.ContinueLoopOp "qiskit.circuit.ContinueLoopOp") instruction must span all the resources of its containing loop, not just the immediate scope.
+
+
+**Returns**
+
+A handle to the instruction created.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if this method was called within a builder context, but not contained within a loop.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Control this circuit on `num_ctrl_qubits` qubits.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of control qubits.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – An optional label to give the controlled operation for visualization.
+* **ctrl\_state** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The control state in decimal or as a bitstring (e.g. ‘111’). If None, use `2**num_ctrl_qubits - 1`.
+
+**Returns**
+
+The controlled version of this circuit.
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the circuit contains a non-unitary operation and cannot be controlled.
+
+### copy
+
+
+
+`copy(name=None)`
+
+Copy the circuit.
+
+**Parameters**
+
+**name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name to be given to the copied circuit. If None, then the name stays the same.
+
+**Returns**
+
+a deepcopy of the current circuit, with the specified name
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### copy\_empty\_like
+
+
+
+`copy_empty_like(name=None)`
+
+Return a copy of self with the same structure but empty.
+
+**That structure includes:**
+
+* name, calibrations and other metadata
+* global phase
+* all the qubits and clbits, including the registers
+
+**Parameters**
+
+**name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Name for the copied circuit. If None, then the name stays the same.
+
+**Returns**
+
+An empty copy of self.
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### count\_ops
+
+
+
+`count_ops()`
+
+Count each operation kind in the circuit.
+
+**Returns**
+
+a breakdown of how many operations of each kind, sorted by amount.
+
+**Return type**
+
+OrderedDict
+
+### cp
+
+
+
+`cp(theta, control_qubit, target_qubit, label=None, ctrl_state=None)`
+
+Apply [`CPhaseGate`](qiskit.circuit.library.CPhaseGate "qiskit.circuit.library.CPhaseGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **theta** (*ParameterValueType*) – The angle of the rotation.
+* **control\_qubit** (*QubitSpecifier*) – The qubit(s) used as the control.
+* **target\_qubit** (*QubitSpecifier*) – The qubit(s) targeted by the gate.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The string label of the gate in the circuit.
+* **ctrl\_state** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The control state in decimal, or as a bitstring (e.g. ‘1’). Defaults to controlling on the ‘1’ state.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+### crx
+
+
+
+`crx(theta, control_qubit, target_qubit, label=None, ctrl_state=None)`
+
+Apply [`CRXGate`](qiskit.circuit.library.CRXGate "qiskit.circuit.library.CRXGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **theta** (*ParameterValueType*) – The angle of the rotation.
+* **control\_qubit** (*QubitSpecifier*) – The qubit(s) used as the control.
+* **target\_qubit** (*QubitSpecifier*) – The qubit(s) targeted by the gate.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The string label of the gate in the circuit.
+* **ctrl\_state** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The control state in decimal, or as a bitstring (e.g. ‘1’). Defaults to controlling on the ‘1’ state.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+### cry
+
+
+
+`cry(theta, control_qubit, target_qubit, label=None, ctrl_state=None)`
+
+Apply [`CRYGate`](qiskit.circuit.library.CRYGate "qiskit.circuit.library.CRYGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **theta** (*ParameterValueType*) – The angle of the rotation.
+* **control\_qubit** (*QubitSpecifier*) – The qubit(s) used as the control.
+* **target\_qubit** (*QubitSpecifier*) – The qubit(s) targeted by the gate.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The string label of the gate in the circuit.
+* **ctrl\_state** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The control state in decimal, or as a bitstring (e.g. ‘1’). Defaults to controlling on the ‘1’ state.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+### crz
+
+
+
+`crz(theta, control_qubit, target_qubit, label=None, ctrl_state=None)`
+
+Apply [`CRZGate`](qiskit.circuit.library.CRZGate "qiskit.circuit.library.CRZGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **theta** (*ParameterValueType*) – The angle of the rotation.
+* **control\_qubit** (*QubitSpecifier*) – The qubit(s) used as the control.
+* **target\_qubit** (*QubitSpecifier*) – The qubit(s) targeted by the gate.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The string label of the gate in the circuit.
+* **ctrl\_state** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The control state in decimal, or as a bitstring (e.g. ‘1’). Defaults to controlling on the ‘1’ state.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+### cs
+
+
+
+`cs(control_qubit, target_qubit, label=None, ctrl_state=None)`
+
+Apply [`CSGate`](qiskit.circuit.library.CSGate "qiskit.circuit.library.CSGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **control\_qubit** (*QubitSpecifier*) – The qubit(s) used as the control.
+* **target\_qubit** (*QubitSpecifier*) – The qubit(s) targeted by the gate.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The string label of the gate in the circuit.
+* **ctrl\_state** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The control state in decimal, or as a bitstring (e.g. ‘1’). Defaults to controlling on the ‘1’ state.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+### csdg
+
+
+
+`csdg(control_qubit, target_qubit, label=None, ctrl_state=None)`
+
+Apply [`CSdgGate`](qiskit.circuit.library.CSdgGate "qiskit.circuit.library.CSdgGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **control\_qubit** (*QubitSpecifier*) – The qubit(s) used as the control.
+* **target\_qubit** (*QubitSpecifier*) – The qubit(s) targeted by the gate.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The string label of the gate in the circuit.
+* **ctrl\_state** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The control state in decimal, or as a bitstring (e.g. ‘1’). Defaults to controlling on the ‘1’ state.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+### cswap
+
+
+
+`cswap(control_qubit, target_qubit1, target_qubit2, label=None, ctrl_state=None)`
+
+Apply [`CSwapGate`](qiskit.circuit.library.CSwapGate "qiskit.circuit.library.CSwapGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **control\_qubit** (*QubitSpecifier*) – The qubit(s) used as the control.
+* **target\_qubit1** (*QubitSpecifier*) – The qubit(s) targeted by the gate.
+* **target\_qubit2** (*QubitSpecifier*) – The qubit(s) targeted by the gate.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The string label of the gate in the circuit.
+* **ctrl\_state** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The control state in decimal, or as a bitstring (e.g. `'1'`). Defaults to controlling on the `'1'` state.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+### csx
+
+
+
+`csx(control_qubit, target_qubit, label=None, ctrl_state=None)`
+
+Apply [`CSXGate`](qiskit.circuit.library.CSXGate "qiskit.circuit.library.CSXGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **control\_qubit** (*QubitSpecifier*) – The qubit(s) used as the control.
+* **target\_qubit** (*QubitSpecifier*) – The qubit(s) targeted by the gate.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The string label of the gate in the circuit.
+* **ctrl\_state** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The control state in decimal, or as a bitstring (e.g. ‘1’). Defaults to controlling on the ‘1’ state.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+### cu
+
+
+
+`cu(theta, phi, lam, gamma, control_qubit, target_qubit, label=None, ctrl_state=None)`
+
+Apply [`CUGate`](qiskit.circuit.library.CUGate "qiskit.circuit.library.CUGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **theta** (*ParameterValueType*) – The $\theta$ rotation angle of the gate.
+* **phi** (*ParameterValueType*) – The $\phi$ rotation angle of the gate.
+* **lam** (*ParameterValueType*) – The $\lambda$ rotation angle of the gate.
+* **gamma** (*ParameterValueType*) – The global phase applied of the U gate, if applied.
+* **control\_qubit** (*QubitSpecifier*) – The qubit(s) used as the control.
+* **target\_qubit** (*QubitSpecifier*) – The qubit(s) targeted by the gate.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The string label of the gate in the circuit.
+* **ctrl\_state** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The control state in decimal, or as a bitstring (e.g. ‘1’). Defaults to controlling on the ‘1’ state.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+### cx
+
+
+
+`cx(control_qubit, target_qubit, label=None, ctrl_state=None)`
+
+Apply [`CXGate`](qiskit.circuit.library.CXGate "qiskit.circuit.library.CXGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **control\_qubit** (*QubitSpecifier*) – The qubit(s) used as the control.
+* **target\_qubit** (*QubitSpecifier*) – The qubit(s) targeted by the gate.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The string label of the gate in the circuit.
+* **ctrl\_state** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The control state in decimal, or as a bitstring (e.g. ‘1’). Defaults to controlling on the ‘1’ state.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+### cy
+
+
+
+`cy(control_qubit, target_qubit, label=None, ctrl_state=None)`
+
+Apply [`CYGate`](qiskit.circuit.library.CYGate "qiskit.circuit.library.CYGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **control\_qubit** (*QubitSpecifier*) – The qubit(s) used as the controls.
+* **target\_qubit** (*QubitSpecifier*) – The qubit(s) targeted by the gate.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The string label of the gate in the circuit.
+* **ctrl\_state** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The control state in decimal, or as a bitstring (e.g. ‘1’). Defaults to controlling on the ‘1’ state.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+### cz
+
+
+
+`cz(control_qubit, target_qubit, label=None, ctrl_state=None)`
+
+Apply [`CZGate`](qiskit.circuit.library.CZGate "qiskit.circuit.library.CZGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **control\_qubit** (*QubitSpecifier*) – The qubit(s) used as the controls.
+* **target\_qubit** (*QubitSpecifier*) – The qubit(s) targeted by the gate.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The string label of the gate in the circuit.
+* **ctrl\_state** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The control state in decimal, or as a bitstring (e.g. ‘1’). Defaults to controlling on the ‘1’ state.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+### dcx
+
+
+
+`dcx(qubit1, qubit2)`
+
+Apply [`DCXGate`](qiskit.circuit.library.DCXGate "qiskit.circuit.library.DCXGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **qubit1** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+* **qubit2** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### decompose
+
+
+
+`decompose(gates_to_decompose=None, reps=1)`
+
+Call a decomposition pass on this circuit, to decompose one level (shallow decompose).
+
+**Parameters**
+
+* **gates\_to\_decompose** ([*type*](https://docs.python.org/3/library/functions.html#type "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*(*[*type*](https://docs.python.org/3/library/functions.html#type "(in Python v3.12)")*,* [*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*)*) – Optional subset of gates to decompose. Can be a gate type, such as `HGate`, or a gate name, such as ‘h’, or a gate label, such as ‘My H Gate’, or a list of any combination of these. If a gate name is entered, it will decompose all gates with that name, whether the gates have labels or not. Defaults to all gates in circuit.
+* **reps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Optional number of times the circuit should be decomposed. For instance, `reps=2` equals calling `circuit.decompose().decompose()`. can decompose specific gates specific time
+
+**Returns**
+
+a circuit one level decomposed
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### delay
+
+
+
+`delay(duration, qarg=None, unit='dt')`
+
+Apply [`Delay`](qiskit.circuit.Delay "qiskit.circuit.Delay"). If qarg is `None`, applies to all qubits. When applying to multiple qubits, delays with the same duration will be created.
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *or*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")) – duration of the delay.
+* **qarg** (*Object*) – qubit argument to apply this delay.
+* **unit** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – unit of the duration. Supported units: `'s'`, `'ms'`, `'us'`, `'ns'`, `'ps'`, and `'dt'`. Default is `'dt'`, i.e. integer time unit depending on the target backend.
+
+**Returns**
+
+handle to the added instructions.
+
+**Return type**
+
+[qiskit.circuit.InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if arguments have bad format.
+
+### depth
+
+
+
+`depth(filter_function=>)`
+
+Return circuit depth (i.e., length of critical path).
+
+**Parameters**
+
+**filter\_function** (*callable*) – A function to filter instructions. Should take as input a tuple of (Instruction, list(Qubit), list(Clbit)). Instructions for which the function returns False are ignored in the computation of the circuit depth. By default filters out “directives”, such as barrier or snapshot.
+
+**Returns**
+
+Depth of circuit.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+**Notes**
+
+The circuit depth and the DAG depth need not be the same.
+
+### diagonal
+
+
+
+`diagonal(diag, qubit)`
+
+Attach a diagonal gate to a circuit.
+
+The decomposition is based on Theorem 7 given in “Synthesis of Quantum Logic Circuits” by Shende et al. ([https://arxiv.org/pdf/quant-ph/0406176.pdf](https://arxiv.org/pdf/quant-ph/0406176.pdf)).
+
+
+ The method `qiskit.circuit.quantumcircuit.QuantumCircuit.diagonal()` is deprecated as of qiskit 0.46.0. It will be removed in the 1.0.0 release. Instead, compose the circuit with a qiskit.circuit.library.Diagonal circuit.
+
+
+**Parameters**
+
+* **diag** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – list of the 2^k diagonal entries (for a diagonal gate on k qubits). Must contain at least two entries
+* **qubit** ([*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – list of k qubits the diagonal is acting on (the order of the qubits specifies the computational basis in which the diagonal gate is provided: the first element in diag acts on the state where all the qubits in q are in the state 0, the second entry acts on the state where all the qubits q\[1],…,q\[k-1] are in the state zero and q\[0] is in the state 1, and so on)
+
+**Returns**
+
+the diagonal gate which was attached to the circuit.
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the list of the diagonal entries or the qubit list is in bad format; if the number of diagonal entries is not 2^k, where k denotes the number of qubits
+
+### draw
+
+
+
+`draw(output=None, scale=None, filename=None, style=None, interactive=False, plot_barriers=True, reverse_bits=None, justify=None, vertical_compression='medium', idle_wires=True, with_layout=True, fold=None, ax=None, initial_state=False, cregbundle=None, wire_order=None, expr_len=30)`
+
+Draw the quantum circuit. Use the output parameter to choose the drawing format:
+
+**text**: ASCII art TextDrawing that can be printed in the console.
+
+**mpl**: images with color rendered purely in Python using matplotlib.
+
+**latex**: high-quality images compiled via latex.
+
+**latex\_source**: raw uncompiled latex output.
+
+
+ Support for [`Expr`](circuit_classical#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.Expr") nodes in conditions and `SwitchCaseOp.target` fields is preliminary and incomplete. The `text` and `mpl` drawers will make a best-effort attempt to show data dependencies, but the LaTeX-based drawers will skip these completely.
+
+
+**Parameters**
+
+* **output** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – select the output method to use for drawing the circuit. Valid choices are `text`, `mpl`, `latex`, `latex_source`. By default the text drawer is used unless the user config file (usually `~/.qiskit/settings.conf`) has an alternative backend set as the default. For example, `circuit_drawer = latex`. If the output kwarg is set, that backend will always be used over the default in the user config file.
+* **scale** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – scale of image to draw (shrink if \< 1.0). Only used by the mpl, latex and latex\_source outputs. Defaults to 1.0.
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – file path to save image to. Defaults to None.
+* **style** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – dictionary of style or file name of style json file. This option is only used by the mpl or latex output type. If style is a str, it is used as the path to a json file which contains a style dict. The file will be opened, parsed, and then any style elements in the dict will replace the default values in the input dict. A file to be loaded must end in `.json`, but the name entered here can omit `.json`. For example, `style='iqp.json'` or `style='iqp'`. If style is a dict and the `'name'` key is set, that name will be used to load a json file, followed by loading the other items in the style dict. For example, `style={'name': 'iqp'}`. If style is not a str and name is not a key in the style dict, then the default value from the user config file (usually `~/.qiskit/settings.conf`) will be used, for example, `circuit_mpl_style = iqp`. If none of these are set, the clifford style will be used. The search path for style json files can be specified in the user config, for example, `circuit_mpl_style_path = /home/user/styles:/home/user`. See: [`DefaultStyle`](qiskit.visualization.circuit.qcstyle.DefaultStyle "qiskit.visualization.circuit.qcstyle.DefaultStyle") for more information on the contents.
+* **interactive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – when set to true, show the circuit in a new window (for mpl this depends on the matplotlib backend being used supporting this). Note when used with either the text or the latex\_source output type this has no effect and will be silently ignored. Defaults to False.
+* **reverse\_bits** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – when set to True, reverse the bit order inside registers for the output visualization. Defaults to False unless the user config file (usually `~/.qiskit/settings.conf`) has an alternative value set. For example, `circuit_reverse_bits = True`.
+* **plot\_barriers** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – enable/disable drawing barriers in the output circuit. Defaults to True.
+* **justify** (*string*) – options are `left`, `right` or `none`. If anything else is supplied, it defaults to left justified. It refers to where gates should be placed in the output circuit if there is an option. `none` results in each gate being placed in its own column.
+* **vertical\_compression** (*string*) – `high`, `medium` or `low`. It merges the lines generated by the text output so the drawing will take less vertical room. Default is `medium`. Only used by the text output, will be silently ignored otherwise.
+* **idle\_wires** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – include idle wires (wires with no circuit elements) in output visualization. Default is True.
+* **with\_layout** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – include layout information, with labels on the physical layout. Default is True.
+* **fold** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – sets pagination. It can be disabled using -1. In text, sets the length of the lines. This is useful when the drawing does not fit in the console. If None (default), it will try to guess the console width using `shutil.get_terminal_size()`. However, if running in jupyter, the default line length is set to 80 characters. In mpl, it is the number of (visual) layers before folding. Default is 25.
+* **ax** ([*matplotlib.axes.Axes*](https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.html#matplotlib.axes.Axes "(in Matplotlib v3.8.2)")) – Only used by the mpl backend. An optional Axes object to be used for the visualization output. If none is specified, a new matplotlib Figure will be created and used. Additionally, if specified there will be no returned Figure since it is redundant.
+* **initial\_state** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Optional. Adds `|0>` in the beginning of the wire. Default is False.
+* **cregbundle** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Optional. If set True, bundle classical registers. Default is True, except for when `output` is set to `"text"`.
+* **wire\_order** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – Optional. A list of integers used to reorder the display of the bits. The list must have an entry for every bit with the bits in the range 0 to (`num_qubits` + `num_clbits`).
+* **expr\_len** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Optional. The number of characters to display if an [`Expr`](circuit_classical#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.Expr") is used for the condition in a [`ControlFlowOp`](qiskit.circuit.ControlFlowOp "qiskit.circuit.ControlFlowOp"). If this number is exceeded, the string will be truncated at that number and ‘…’ added to the end.
+
+**Returns**
+
+`TextDrawing` or `matplotlib.figure` or `PIL.Image` or [`str`](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)"):
+
+* **TextDrawing (output=’text’)**
+
+ A drawing that can be printed as ascii art.
+
+* **matplotlib.figure.Figure (output=’mpl’)**
+
+ A matplotlib figure object for the circuit diagram.
+
+* **PIL.Image (output=’latex’)**
+
+ An in-memory representation of the image of the circuit diagram.
+
+* **str (output=’latex\_source’)**
+
+ The LaTeX source code for visualizing the circuit diagram.
+
+**Raises**
+
+* [**VisualizationError**](visualization#qiskit.visualization.VisualizationError "qiskit.visualization.VisualizationError") – when an invalid output method is selected
+* [**ImportError**](https://docs.python.org/3/library/exceptions.html#ImportError "(in Python v3.12)") – when the output methods requires non-installed libraries.
+
+**Example**
+
+```python
+from qiskit import QuantumRegister, ClassicalRegister, QuantumCircuit
+q = QuantumRegister(1)
+c = ClassicalRegister(1)
+qc = QuantumCircuit(q, c)
+qc.h(q)
+qc.measure(q, c)
+qc.draw(output='mpl', style={'backgroundcolor': '#EEEEEE'})
+```
+
+
+
+### ecr
+
+
+
+`ecr(qubit1, qubit2)`
+
+Apply [`ECRGate`](qiskit.circuit.library.ECRGate "qiskit.circuit.library.ECRGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **qubit1** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubits to apply the gate to.
+* **qubit2** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubits to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### find\_bit
+
+
+
+`find_bit(bit)`
+
+Find locations in the circuit which can be used to reference a given [`Bit`](qiskit.circuit.Bit "qiskit.circuit.Bit").
+
+**Parameters**
+
+**bit** ([*Bit*](qiskit.circuit.Bit "qiskit.circuit.Bit")) – The bit to locate.
+
+**Returns**
+
+**A 2-tuple. The first element (`index`)**
+
+contains the index at which the `Bit` can be found (in either [`qubits`](#qiskit.circuit.QuantumCircuit.qubits "qiskit.circuit.QuantumCircuit.qubits"), [`clbits`](#qiskit.circuit.QuantumCircuit.clbits "qiskit.circuit.QuantumCircuit.clbits"), depending on its type). The second element (`registers`) is a list of `(register, index)` pairs with an entry for each [`Register`](qiskit.circuit.Register "qiskit.circuit.Register") in the circuit which contains the [`Bit`](qiskit.circuit.Bit "qiskit.circuit.Bit") (and the index in the [`Register`](qiskit.circuit.Register "qiskit.circuit.Register") at which it can be found).
+
+**Return type**
+
+namedtuple([int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)"), List\[Tuple([Register](qiskit.circuit.Register "qiskit.circuit.Register"), [int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)"))])
+
+**Notes**
+
+The circuit index of an [`AncillaQubit`](qiskit.circuit.AncillaQubit "qiskit.circuit.AncillaQubit") will be its index in [`qubits`](#qiskit.circuit.QuantumCircuit.qubits "qiskit.circuit.QuantumCircuit.qubits"), not [`ancillas`](#qiskit.circuit.QuantumCircuit.ancillas "qiskit.circuit.QuantumCircuit.ancillas").
+
+**Raises**
+
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the supplied [`Bit`](qiskit.circuit.Bit "qiskit.circuit.Bit") was of an unknown type.
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the supplied [`Bit`](qiskit.circuit.Bit "qiskit.circuit.Bit") could not be found on the circuit.
+
+**Return type**
+
+*BitLocations*
+
+### for\_loop
+
+### for\_loop
+
+
+
+`for_loop(indexset: Iterable[int], loop_parameter: Parameter | None, body: None, qubits: None, clbits: None, *, label: str | None) → qiskit.circuit.controlflow.for_loop.ForLoopContext`
+
+
+
+`for_loop(indexset: Iterable[int], loop_parameter: Parameter | None, body: QuantumCircuit, qubits: Sequence[Qubit | QuantumRegister | int | slice | Sequence[Qubit | int]], clbits: Sequence[Clbit | ClassicalRegister | int | slice | Sequence[Clbit | int]], *, label: str | None) → InstructionSet`
+
+Create a `for` loop on this circuit.
+
+There are two forms for calling this function. If called with all its arguments (with the possible exception of `label`), it will create a [`ForLoopOp`](qiskit.circuit.ForLoopOp "qiskit.circuit.ForLoopOp") with the given `body`. If `body` (and `qubits` and `clbits`) are *not* passed, then this acts as a context manager, which, when entered, provides a loop variable (unless one is given, in which case it will be reused) and will automatically build a [`ForLoopOp`](qiskit.circuit.ForLoopOp "qiskit.circuit.ForLoopOp") when the scope finishes. In this form, you do not need to keep track of the qubits or clbits you are using, because the scope will handle it for you.
+
+For example:
+
+```python
+from qiskit import QuantumCircuit
+qc = QuantumCircuit(2, 1)
+
+with qc.for_loop(range(5)) as i:
+ qc.h(0)
+ qc.cx(0, 1)
+ qc.measure(0, 0)
+ qc.break_loop().c_if(0, True)
+```
+
+**Parameters**
+
+* **indexset** (*Iterable\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – A collection of integers to loop over. Always necessary.
+
+* **loop\_parameter** (*Optional\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*]*) –
+
+ The parameter used within `body` to which the values from `indexset` will be assigned. In the context-manager form, if this argument is not supplied, then a loop parameter will be allocated for you and returned as the value of the `with` statement. This will only be bound into the circuit if it is used within the body.
+
+ If this argument is `None` in the manual form of this method, `body` will be repeated once for each of the items in `indexset` but their values will be ignored.
+
+* **body** (*Optional\[*[*QuantumCircuit*](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – The loop body to be repeatedly executed. Omit this to use the context-manager mode.
+
+* **qubits** (*Optional\[Sequence\[QubitSpecifier]]*) – The circuit qubits over which the loop body should be run. Omit this to use the context-manager mode.
+
+* **clbits** (*Optional\[Sequence\[ClbitSpecifier]]*) – The circuit clbits over which the loop body should be run. Omit this to use the context-manager mode.
+
+* **label** (*Optional\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – The string label of the instruction in the circuit.
+
+**Returns**
+
+depending on the call signature, either a context manager for creating the for loop (it will automatically be added to the circuit at the end of the block), or an [`InstructionSet`](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet") handle to the appended loop operation.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet") or ForLoopContext
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if an incorrect calling convention is used.
+
+### fredkin
+
+
+
+`fredkin(control_qubit, target_qubit1, target_qubit2)`
+
+Apply [`CSwapGate`](qiskit.circuit.library.CSwapGate "qiskit.circuit.library.CSwapGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+
+ The method `qiskit.circuit.quantumcircuit.QuantumCircuit.fredkin()` is deprecated as of qiskit 0.45.0. It will be removed in the Qiskit 1.0.0 release. Use QuantumCircuit.cswap as direct replacement.
+
+
+**Parameters**
+
+* **control\_qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) used as the control.
+* **target\_qubit1** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) targeted by the gate.
+* **target\_qubit2** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) targeted by the gate.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+
+ QuantumCircuit.cswap: the same function with a different name.
+
+
+### from\_instructions
+
+
+
+`static from_instructions(instructions, *, qubits=(), clbits=(), name=None, global_phase=0, metadata=None)`
+
+Construct a circuit from an iterable of CircuitInstructions.
+
+**Parameters**
+
+* **instructions** (*Iterable\[*[*CircuitInstruction*](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction") *|*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*qiskit.circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction")*] |* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*qiskit.circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction")*, Iterable\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]] |* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*qiskit.circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction")*, Iterable\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*], Iterable\[*[*Clbit*](qiskit.circuit.Clbit "qiskit.circuit.Clbit")*]]]*) – The instructions to add to the circuit.
+* **qubits** (*Iterable\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]*) – Any qubits to add to the circuit. This argument can be used, for example, to enforce a particular ordering of qubits.
+* **clbits** (*Iterable\[*[*Clbit*](qiskit.circuit.Clbit "qiskit.circuit.Clbit")*]*) – Any classical bits to add to the circuit. This argument can be used, for example, to enforce a particular ordering of classical bits.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The name of the circuit.
+* **global\_phase** (*ParameterValueType*) – The global phase of the circuit in radians.
+* **metadata** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *| None*) – Arbitrary key value metadata to associate with the circuit.
+
+**Returns**
+
+The quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### from\_qasm\_file
+
+
+
+`static from_qasm_file(path)`
+
+Read an OpenQASM 2.0 program from a file and convert to an instance of [`QuantumCircuit`](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit").
+
+**Parameters**
+
+**path** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Path to the file for an OpenQASM 2 program
+
+**Returns**
+
+The QuantumCircuit object for the input OpenQASM 2.
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+
+ [`qasm2.load()`](qasm2#qiskit.qasm2.load "qiskit.qasm2.load"): the complete interface to the OpenQASM 2 importer.
+
+
+### from\_qasm\_str
+
+
+
+`static from_qasm_str(qasm_str)`
+
+Convert a string containing an OpenQASM 2.0 program to a [`QuantumCircuit`](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit").
+
+**Parameters**
+
+**qasm\_str** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – A string containing an OpenQASM 2.0 program.
+
+**Returns**
+
+The QuantumCircuit object for the input OpenQASM 2
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+
+ [`qasm2.loads()`](qasm2#qiskit.qasm2.loads "qiskit.qasm2.loads"): the complete interface to the OpenQASM 2 importer.
+
+
+### get\_instructions
+
+
+
+`get_instructions(name)`
+
+Get instructions matching name.
+
+**Parameters**
+
+**name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of instruction to.
+
+**Returns**
+
+list of (instruction, qargs, cargs).
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")([tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)"))
+
+### h
+
+
+
+`h(qubit)`
+
+Apply [`HGate`](qiskit.circuit.library.HGate "qiskit.circuit.library.HGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+**qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### hamiltonian
+
+
+
+`hamiltonian(operator, time, qubits, label=None)`
+
+Apply hamiltonian evolution to qubits.
+
+This gate resolves to a [`UnitaryGate`](qiskit.circuit.library.UnitaryGate "qiskit.circuit.library.UnitaryGate") as $U(t) = exp(-i t H)$, which can be decomposed into basis gates if it is 2 qubits or less, or simulated directly in Aer for more qubits.
+
+
+ The method `qiskit.circuit.quantumcircuit.QuantumCircuit.hamiltonian()` is deprecated as of qiskit 0.46.0. It will be removed in the 1.0.0 release. Instead, append a qiskit.circuit.library.HamiltonianGate to the circuit.
+
+
+**Parameters**
+
+* **operator** (*matrix or* [*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – a hermitian operator.
+* **time** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *or*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")) – time evolution parameter.
+* **qubits** (*Union\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*, Tuple\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]]*) – The circuit qubits to apply the transformation to.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – unitary name for backend \[Default: None].
+
+**Returns**
+
+The quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### has\_calibration\_for
+
+
+
+`has_calibration_for(instruction)`
+
+Return True if the circuit has a calibration defined for the instruction context. In this case, the operation does not need to be translated to the device basis.
+
+### has\_register
+
+
+
+`has_register(register)`
+
+Test if this circuit has the register r.
+
+**Parameters**
+
+**register** ([*Register*](qiskit.circuit.Register "qiskit.circuit.Register")) – a quantum or classical register.
+
+**Returns**
+
+True if the register is contained in this circuit.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### i
+
+
+
+`i(qubit)`
+
+Apply [`IGate`](qiskit.circuit.library.IGate "qiskit.circuit.library.IGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+
+ The method `qiskit.circuit.quantumcircuit.QuantumCircuit.i()` is deprecated as of qiskit 0.45.0. It will be removed in the Qiskit 1.0.0 release. Use QuantumCircuit.id as direct replacement.
+
+
+**Parameters**
+
+**qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### id
+
+
+
+`id(qubit)`
+
+Apply [`IGate`](qiskit.circuit.library.IGate "qiskit.circuit.library.IGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+**qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### if\_else
+
+
+
+`if_else(condition, true_body, false_body, qubits, clbits, label=None)`
+
+Apply [`IfElseOp`](qiskit.circuit.IfElseOp "qiskit.circuit.IfElseOp").
+
+
+ This method does not have an associated context-manager form, because it is already handled by the [`if_test()`](#qiskit.circuit.QuantumCircuit.if_test "qiskit.circuit.QuantumCircuit.if_test") method. You can use the `else` part of that with something such as:
+
+ ```python
+ from qiskit.circuit import QuantumCircuit, Qubit, Clbit
+ bits = [Qubit(), Qubit(), Clbit()]
+ qc = QuantumCircuit(bits)
+ qc.h(0)
+ qc.cx(0, 1)
+ qc.measure(0, 0)
+ with qc.if_test((bits[2], 0)) as else_:
+ qc.h(0)
+ with else_:
+ qc.x(0)
+ ```
+
+
+**Parameters**
+
+* **condition** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*ClassicalRegister*](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] |* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*Clbit*](qiskit.circuit.Clbit "qiskit.circuit.Clbit")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] |* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*Clbit*](qiskit.circuit.Clbit "qiskit.circuit.Clbit")*,* [*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")*]*) – A condition to be evaluated at circuit runtime which, if true, will trigger the evaluation of `true_body`. Can be specified as either a tuple of a `ClassicalRegister` to be tested for equality with a given `int`, or as a tuple of a `Clbit` to be compared to either a `bool` or an `int`.
+* **true\_body** ([*QuantumCircuit*](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – The circuit body to be run if `condition` is true.
+* **false\_body** ([*QuantumCircuit*](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – The circuit to be run if `condition` is false.
+* **qubits** (*Sequence\[QubitSpecifier]*) – The circuit qubits over which the if/else should be run.
+* **clbits** (*Sequence\[ClbitSpecifier]*) – The circuit clbits over which the if/else should be run.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The string label of the instruction in the circuit.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the provided condition references Clbits outside the enclosing circuit.
+
+**Returns**
+
+A handle to the instruction created.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+### if\_test
+
+### if\_test
+
+
+
+`if_test(condition: tuple[ClassicalRegister | Clbit, int], true_body: None, qubits: None, clbits: None, *, label: str | None) → qiskit.circuit.controlflow.if_else.IfContext`
+
+
+
+`if_test(condition: tuple[ClassicalRegister | Clbit, int], true_body: QuantumCircuit, qubits: Sequence[Qubit | QuantumRegister | int | slice | Sequence[Qubit | int]], clbits: Sequence[Clbit | ClassicalRegister | int | slice | Sequence[Clbit | int]], *, label: str | None = None) → InstructionSet`
+
+Create an `if` statement on this circuit.
+
+There are two forms for calling this function. If called with all its arguments (with the possible exception of `label`), it will create a [`IfElseOp`](qiskit.circuit.IfElseOp "qiskit.circuit.IfElseOp") with the given `true_body`, and there will be no branch for the `false` condition (see also the [`if_else()`](#qiskit.circuit.QuantumCircuit.if_else "qiskit.circuit.QuantumCircuit.if_else") method). However, if `true_body` (and `qubits` and `clbits`) are *not* passed, then this acts as a context manager, which can be used to build `if` statements. The return value of the `with` statement is a chainable context manager, which can be used to create subsequent `else` blocks. In this form, you do not need to keep track of the qubits or clbits you are using, because the scope will handle it for you.
+
+For example:
+
+```python
+from qiskit.circuit import QuantumCircuit, Qubit, Clbit
+bits = [Qubit(), Qubit(), Qubit(), Clbit(), Clbit()]
+qc = QuantumCircuit(bits)
+
+qc.h(0)
+qc.cx(0, 1)
+qc.measure(0, 0)
+qc.h(0)
+qc.cx(0, 1)
+qc.measure(0, 1)
+
+with qc.if_test((bits[3], 0)) as else_:
+ qc.x(2)
+with else_:
+ qc.h(2)
+ qc.z(2)
+```
+
+**Parameters**
+
+* **condition** (*Tuple\[Union\[*[*ClassicalRegister*](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister")*,* [*Clbit*](qiskit.circuit.Clbit "qiskit.circuit.Clbit")*],* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – A condition to be evaluated at circuit runtime which, if true, will trigger the evaluation of `true_body`. Can be specified as either a tuple of a `ClassicalRegister` to be tested for equality with a given `int`, or as a tuple of a `Clbit` to be compared to either a `bool` or an `int`.
+* **true\_body** (*Optional\[*[*QuantumCircuit*](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – The circuit body to be run if `condition` is true.
+* **qubits** (*Optional\[Sequence\[QubitSpecifier]]*) – The circuit qubits over which the if/else should be run.
+* **clbits** (*Optional\[Sequence\[ClbitSpecifier]]*) – The circuit clbits over which the if/else should be run.
+* **label** (*Optional\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – The string label of the instruction in the circuit.
+
+**Returns**
+
+depending on the call signature, either a context manager for creating the `if` block (it will automatically be added to the circuit at the end of the block), or an [`InstructionSet`](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet") handle to the appended conditional operation.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet") or IfContext
+
+**Raises**
+
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the provided condition references Clbits outside the enclosing circuit.
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if an incorrect calling convention is used.
+
+**Returns**
+
+A handle to the instruction created.
+
+### initialize
+
+
+
+`initialize(params, qubits=None, normalize=False)`
+
+Initialize qubits in a specific state.
+
+Qubit initialization is done by first resetting the qubits to $|0\rangle$ followed by calling [`StatePreparation`](qiskit.circuit.library.StatePreparation "qiskit.circuit.library.StatePreparation") class to prepare the qubits in a specified state. Both these steps are included in the [`Initialize`](qiskit.circuit.library.Initialize "qiskit.circuit.library.Initialize") instruction.
+
+**Parameters**
+
+* **params** (*Sequence\[*[*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*] |* [*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) –
+
+ The state to initialize to, can be either of the following.
+
+ * Statevector or vector of complex amplitudes to initialize to.
+ * Labels of basis states of the Pauli eigenstates Z, X, Y. See [`Statevector.from_label()`](qiskit.quantum_info.Statevector#from_label "qiskit.quantum_info.Statevector.from_label"). Notice the order of the labels is reversed with respect to the qubit index to be applied to. Example label ‘01’ initializes the qubit zero to $|1\rangle$ and the qubit one to $|0\rangle$.
+ * An integer that is used as a bitmap indicating which qubits to initialize to $|1\rangle$. Example: setting params to 5 would initialize qubit 0 and qubit 2 to $|1\rangle$ and qubit 1 to $|0\rangle$.
+
+* **qubits** (*Sequence\[QubitSpecifier] | None*) – Qubits to initialize. If `None` the initialization is applied to all qubits in the circuit.
+
+* **normalize** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to normalize an input array to a unit vector.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Examples**
+
+Prepare a qubit in the state $(|0\rangle - |1\rangle) / \sqrt{2}$.
+
+```python
+import numpy as np
+from qiskit import QuantumCircuit
+
+circuit = QuantumCircuit(1)
+circuit.initialize([1/np.sqrt(2), -1/np.sqrt(2)], 0)
+circuit.draw()
+```
+
+output:
+
+```python
+ ┌──────────────────────────────┐
+q_0: ┤ Initialize(0.70711,-0.70711) ├
+ └──────────────────────────────┘
+```
+
+Initialize from a string two qubits in the state $|10\rangle$. The order of the labels is reversed with respect to qubit index. More information about labels for basis states are in [`Statevector.from_label()`](qiskit.quantum_info.Statevector#from_label "qiskit.quantum_info.Statevector.from_label").
+
+```python
+import numpy as np
+from qiskit import QuantumCircuit
+
+circuit = QuantumCircuit(2)
+circuit.initialize('01', circuit.qubits)
+circuit.draw()
+```
+
+output:
+
+```python
+ ┌──────────────────┐
+q_0: ┤0 ├
+ │ Initialize(0,1) │
+q_1: ┤1 ├
+ └──────────────────┘
+```
+
+Initialize two qubits from an array of complex amplitudes.
+
+```python
+import numpy as np
+from qiskit import QuantumCircuit
+
+circuit = QuantumCircuit(2)
+circuit.initialize([0, 1/np.sqrt(2), -1.j/np.sqrt(2), 0], circuit.qubits)
+circuit.draw()
+```
+
+output:
+
+```python
+ ┌────────────────────────────────────┐
+q_0: ┤0 ├
+ │ Initialize(0,0.70711,-0.70711j,0) │
+q_1: ┤1 ├
+ └────────────────────────────────────┘
+```
+
+### inverse
+
+
+
+`inverse()`
+
+Invert (take adjoint of) this circuit.
+
+This is done by recursively inverting all gates.
+
+**Returns**
+
+the inverted circuit
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the circuit cannot be inverted.
+
+**Examples**
+
+input:
+
+```python
+ ┌───┐
+q_0: ┤ H ├─────■──────
+ └───┘┌────┴─────┐
+q_1: ─────┤ RX(1.57) ├
+ └──────────┘
+```
+
+output:
+
+```python
+ ┌───┐
+q_0: ──────■──────┤ H ├
+ ┌─────┴─────┐└───┘
+q_1: ┤ RX(-1.57) ├─────
+ └───────────┘
+```
+
+### iso
+
+
+
+`iso(isometry, q_input, q_ancillas_for_output, q_ancillas_zero=None, q_ancillas_dirty=None, epsilon=1e-10)`
+
+Attach an arbitrary isometry from m to n qubits to a circuit. In particular, this allows to attach arbitrary unitaries on n qubits (m=n) or to prepare any state on n qubits (m=0). The decomposition used here was introduced by Iten et al. in [https://arxiv.org/abs/1501.06911](https://arxiv.org/abs/1501.06911).
+
+
+ The method `qiskit.circuit.quantumcircuit.QuantumCircuit.iso()` is deprecated as of qiskit 0.46.0. It will be removed in the 1.0.0 release. Instead, append a qiskit.circuit.library.Isometry to the circuit.
+
+
+**Parameters**
+
+* **isometry** (*ndarray*) – an isometry from m to n qubits, i.e., a (complex) ndarray of dimension 2^n×2^m with orthonormal columns (given in the computational basis specified by the order of the ancillas and the input qubits, where the ancillas are considered to be more significant than the input qubits.).
+* **q\_input** ([*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]*) – list of m qubits where the input to the isometry is fed in (empty list for state preparation).
+* **q\_ancillas\_for\_output** ([*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]*) – list of n-m ancilla qubits that are used for the output of the isometry and which are assumed to start in the zero state. The qubits are listed with increasing significance.
+* **q\_ancillas\_zero** ([*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]*) – list of ancilla qubits which are assumed to start in the zero state. Default is q\_ancillas\_zero = None.
+* **q\_ancillas\_dirty** ([*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]*) – list of ancilla qubits which can start in an arbitrary state. Default is q\_ancillas\_dirty = None.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – error tolerance of calculations. Default is epsilon = \_EPS.
+
+**Returns**
+
+the isometry is attached to the quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the array is not an isometry of the correct size corresponding to the provided number of qubits.
+
+### isometry
+
+
+
+`isometry(isometry, q_input, q_ancillas_for_output, q_ancillas_zero=None, q_ancillas_dirty=None, epsilon=1e-10)`
+
+Attach an arbitrary isometry from m to n qubits to a circuit. In particular, this allows to attach arbitrary unitaries on n qubits (m=n) or to prepare any state on n qubits (m=0). The decomposition used here was introduced by Iten et al. in [https://arxiv.org/abs/1501.06911](https://arxiv.org/abs/1501.06911).
+
+
+ The method `qiskit.circuit.quantumcircuit.QuantumCircuit.iso()` is deprecated as of qiskit 0.46.0. It will be removed in the 1.0.0 release. Instead, append a qiskit.circuit.library.Isometry to the circuit.
+
+
+**Parameters**
+
+* **isometry** (*ndarray*) – an isometry from m to n qubits, i.e., a (complex) ndarray of dimension 2^n×2^m with orthonormal columns (given in the computational basis specified by the order of the ancillas and the input qubits, where the ancillas are considered to be more significant than the input qubits.).
+* **q\_input** ([*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]*) – list of m qubits where the input to the isometry is fed in (empty list for state preparation).
+* **q\_ancillas\_for\_output** ([*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]*) – list of n-m ancilla qubits that are used for the output of the isometry and which are assumed to start in the zero state. The qubits are listed with increasing significance.
+* **q\_ancillas\_zero** ([*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]*) – list of ancilla qubits which are assumed to start in the zero state. Default is q\_ancillas\_zero = None.
+* **q\_ancillas\_dirty** ([*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]*) – list of ancilla qubits which can start in an arbitrary state. Default is q\_ancillas\_dirty = None.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – error tolerance of calculations. Default is epsilon = \_EPS.
+
+**Returns**
+
+the isometry is attached to the quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the array is not an isometry of the correct size corresponding to the provided number of qubits.
+
+### iswap
+
+
+
+`iswap(qubit1, qubit2)`
+
+Apply [`iSwapGate`](qiskit.circuit.library.iSwapGate "qiskit.circuit.library.iSwapGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **qubit1** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubits to apply the gate to.
+* **qubit2** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubits to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### mcp
+
+
+
+`mcp(lam, control_qubits, target_qubit)`
+
+Apply [`MCPhaseGate`](qiskit.circuit.library.MCPhaseGate "qiskit.circuit.library.MCPhaseGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **lam** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The angle of the rotation.
+* **control\_qubits** ([*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]]*) – The qubits used as the controls.
+* **target\_qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) targeted by the gate.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### mcrx
+
+
+
+`mcrx(theta, q_controls, q_target, use_basis_gates=False)`
+
+Apply Multiple-Controlled X rotation gate
+
+**Parameters**
+
+* **self** ([*QuantumCircuit*](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – The QuantumCircuit object to apply the mcrx gate on.
+* **theta** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – angle theta
+* **q\_controls** ([*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*(*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*)*) – The list of control qubits
+* **q\_target** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")) – The target qubit
+* **use\_basis\_gates** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – use p, u, cx
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – parameter errors
+
+### mcry
+
+
+
+`mcry(theta, q_controls, q_target, q_ancillae=None, mode=None, use_basis_gates=False)`
+
+Apply Multiple-Controlled Y rotation gate
+
+**Parameters**
+
+* **self** ([*QuantumCircuit*](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – The QuantumCircuit object to apply the mcry gate on.
+* **theta** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – angle theta
+* **q\_controls** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*(*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*)*) – The list of control qubits
+* **q\_target** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")) – The target qubit
+* **q\_ancillae** ([*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister") *or*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*(*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*)*) – The list of ancillary qubits.
+* **mode** (*string*) – The implementation mode to use
+* **use\_basis\_gates** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – use p, u, cx
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – parameter errors
+
+### mcrz
+
+
+
+`mcrz(lam, q_controls, q_target, use_basis_gates=False)`
+
+Apply Multiple-Controlled Z rotation gate
+
+**Parameters**
+
+* **self** ([*QuantumCircuit*](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – The QuantumCircuit object to apply the mcrz gate on.
+* **lam** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – angle lambda
+* **q\_controls** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*(*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*)*) – The list of control qubits
+* **q\_target** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")) – The target qubit
+* **use\_basis\_gates** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – use p, u, cx
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – parameter errors
+
+### mct
+
+
+
+`mct(control_qubits, target_qubit, ancilla_qubits=None, mode='noancilla')`
+
+Apply [`MCXGate`](qiskit.circuit.library.MCXGate "qiskit.circuit.library.MCXGate").
+
+The multi-cX gate can be implemented using different techniques, which use different numbers of ancilla qubits and have varying circuit depth. These modes are:
+
+* `'noancilla'`: Requires 0 ancilla qubits.
+* `'recursion'`: Requires 1 ancilla qubit if more than 4 controls are used, otherwise 0.
+* `'v-chain'`: Requires 2 less ancillas than the number of control qubits.
+* `'v-chain-dirty'`: Same as for the clean ancillas (but the circuit will be longer).
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+
+ The method `qiskit.circuit.quantumcircuit.QuantumCircuit.mct()` is deprecated as of qiskit 0.45.0. It will be removed in the Qiskit 1.0.0 release. Use QuantumCircuit.mcx as direct replacement.
+
+
+**Parameters**
+
+* **control\_qubits** (*Sequence\[QubitSpecifier]*) – The qubits used as the controls.
+* **target\_qubit** (*QubitSpecifier*) – The qubit(s) targeted by the gate.
+* **ancilla\_qubits** (*QubitSpecifier | Sequence\[QubitSpecifier] | None*) – The qubits used as the ancillae, if the mode requires them.
+* **mode** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The choice of mode, explained further above.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Raises**
+
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – if the given mode is not known, or if too few ancilla qubits are passed.
+* [**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – if no ancilla qubits are passed, but some are needed.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+
+ QuantumCircuit.mcx: the same gate with a different name.
+
+
+### mcx
+
+
+
+`mcx(control_qubits, target_qubit, ancilla_qubits=None, mode='noancilla')`
+
+Apply [`MCXGate`](qiskit.circuit.library.MCXGate "qiskit.circuit.library.MCXGate").
+
+The multi-cX gate can be implemented using different techniques, which use different numbers of ancilla qubits and have varying circuit depth. These modes are:
+
+* `'noancilla'`: Requires 0 ancilla qubits.
+* `'recursion'`: Requires 1 ancilla qubit if more than 4 controls are used, otherwise 0.
+* `'v-chain'`: Requires 2 less ancillas than the number of control qubits.
+* `'v-chain-dirty'`: Same as for the clean ancillas (but the circuit will be longer).
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **control\_qubits** (*Sequence\[QubitSpecifier]*) – The qubits used as the controls.
+* **target\_qubit** (*QubitSpecifier*) – The qubit(s) targeted by the gate.
+* **ancilla\_qubits** (*QubitSpecifier | Sequence\[QubitSpecifier] | None*) – The qubits used as the ancillae, if the mode requires them.
+* **mode** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The choice of mode, explained further above.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Raises**
+
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – if the given mode is not known, or if too few ancilla qubits are passed.
+* [**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – if no ancilla qubits are passed, but some are needed.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+### measure
+
+
+
+`measure(qubit, cbit)`
+
+Measure a quantum bit (`qubit`) in the Z basis into a classical bit (`cbit`).
+
+When a quantum state is measured, a qubit is projected in the computational (Pauli Z) basis to either $\lvert 0 \rangle$ or $\lvert 1 \rangle$. The classical bit `cbit` indicates the result of that projection as a `0` or a `1` respectively. This operation is non-reversible.
+
+**Parameters**
+
+* **qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – qubit(s) to measure.
+* **cbit** ([*Clbit*](qiskit.circuit.Clbit "qiskit.circuit.classicalregister.Clbit") *|*[*ClassicalRegister*](qiskit.circuit.ClassicalRegister "qiskit.circuit.classicalregister.ClassicalRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Clbit*](qiskit.circuit.Clbit "qiskit.circuit.classicalregister.Clbit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – classical bit(s) to place the measurement result(s) in.
+
+**Returns**
+
+handle to the added instructions.
+
+**Return type**
+
+[qiskit.circuit.InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if arguments have bad format.
+
+**Examples**
+
+In this example, a qubit is measured and the result of that measurement is stored in the classical bit (usually expressed in diagrams as a double line):
+
+```python
+from qiskit import QuantumCircuit
+circuit = QuantumCircuit(1, 1)
+circuit.h(0)
+circuit.measure(0, 0)
+circuit.draw()
+```
+
+```python
+ ┌───┐┌─┐
+ q: ┤ H ├┤M├
+ └───┘└╥┘
+c: 1/══════╩═
+ 0
+```
+
+It is possible to call `measure` with lists of `qubits` and `cbits` as a shortcut for one-to-one measurement. These two forms produce identical results:
+
+```python
+circuit = QuantumCircuit(2, 2)
+circuit.measure([0,1], [0,1])
+```
+
+```python
+circuit = QuantumCircuit(2, 2)
+circuit.measure(0, 0)
+circuit.measure(1, 1)
+```
+
+Instead of lists, you can use [`QuantumRegister`](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister") and [`ClassicalRegister`](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister") under the same logic.
+
+```python
+from qiskit import QuantumCircuit, QuantumRegister, ClassicalRegister
+qreg = QuantumRegister(2, "qreg")
+creg = ClassicalRegister(2, "creg")
+circuit = QuantumCircuit(qreg, creg)
+circuit.measure(qreg, creg)
+```
+
+This is equivalent to:
+
+```python
+circuit = QuantumCircuit(qreg, creg)
+circuit.measure(qreg[0], creg[0])
+circuit.measure(qreg[1], creg[1])
+```
+
+### measure\_active
+
+
+
+`measure_active(inplace=True)`
+
+Adds measurement to all non-idle qubits. Creates a new ClassicalRegister with a size equal to the number of non-idle qubits being measured.
+
+Returns a new circuit with measurements if inplace=False.
+
+**Parameters**
+
+**inplace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – All measurements inplace or return new circuit.
+
+**Returns**
+
+Returns circuit with measurements when inplace = False.
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### measure\_all
+
+
+
+`measure_all(inplace=True, add_bits=True)`
+
+Adds measurement to all qubits.
+
+By default, adds new classical bits in a [`ClassicalRegister`](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister") to store these measurements. If `add_bits=False`, the results of the measurements will instead be stored in the already existing classical bits, with qubit `n` being measured into classical bit `n`.
+
+Returns a new circuit with measurements if `inplace=False`.
+
+**Parameters**
+
+* **inplace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – All measurements inplace or return new circuit.
+* **add\_bits** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to add new bits to store the results.
+
+**Returns**
+
+Returns circuit with measurements when `inplace=False`.
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if `add_bits=False` but there are not enough classical bits.
+
+### ms
+
+
+
+`ms(theta, qubits)`
+
+Apply [`MSGate`](qiskit.circuit.library.MSGate "qiskit.circuit.library.MSGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **theta** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The angle of the rotation.
+* **qubits** ([*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]]*) – The qubits to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### num\_connected\_components
+
+
+
+`num_connected_components(unitary_only=False)`
+
+How many non-entangled subcircuits can the circuit be factored to.
+
+**Parameters**
+
+**unitary\_only** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Compute only unitary part of graph.
+
+**Returns**
+
+Number of connected components in circuit.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### num\_nonlocal\_gates
+
+
+
+`num_nonlocal_gates()`
+
+Return number of non-local gates (i.e. involving 2+ qubits).
+
+Conditional nonlocal gates are also included.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### num\_tensor\_factors
+
+
+
+`num_tensor_factors()`
+
+Computes the number of tensor factors in the unitary (quantum) part of the circuit only.
+
+**Notes**
+
+This is here for backwards compatibility, and will be removed in a future release of Qiskit. You should call num\_unitary\_factors instead.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### num\_unitary\_factors
+
+
+
+`num_unitary_factors()`
+
+Computes the number of tensor factors in the unitary (quantum) part of the circuit only.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### p
+
+
+
+`p(theta, qubit)`
+
+Apply [`PhaseGate`](qiskit.circuit.library.PhaseGate "qiskit.circuit.library.PhaseGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **theta** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – THe angle of the rotation.
+* **qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### pauli
+
+
+
+`pauli(pauli_string, qubits)`
+
+Apply [`PauliGate`](qiskit.circuit.library.PauliGate "qiskit.circuit.library.PauliGate").
+
+**Parameters**
+
+* **pauli\_string** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – A string representing the Pauli operator to apply, e.g. ‘XX’.
+* **qubits** ([*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]]*) – The qubits to apply this gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### power
+
+
+
+`power(power, matrix_power=False)`
+
+Raise this circuit to the power of `power`.
+
+If `power` is a positive integer and `matrix_power` is `False`, this implementation defaults to calling `repeat`. Otherwise, if the circuit is unitary, the matrix is computed to calculate the matrix power.
+
+**Parameters**
+
+* **power** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The power to raise this circuit to.
+* **matrix\_power** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, the circuit is converted to a matrix and then the matrix power is computed. If False, and `power` is a positive integer, the implementation defaults to `repeat`.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the circuit needs to be converted to a gate but it is not unitary.
+
+**Returns**
+
+A circuit implementing this circuit raised to the power of `power`.
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### prepare\_state
+
+
+
+`prepare_state(state, qubits=None, label=None, normalize=False)`
+
+Prepare qubits in a specific state.
+
+This class implements a state preparing unitary. Unlike [`Initialize`](qiskit.circuit.library.Initialize "qiskit.circuit.library.Initialize") it does not reset the qubits first.
+
+**Parameters**
+
+* **state** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector")) –
+
+ * Statevector: Statevector to initialize to.
+ * str: labels of basis states of the Pauli eigenstates Z, X, Y. See [`Statevector.from_label()`](qiskit.quantum_info.Statevector#from_label "qiskit.quantum_info.Statevector.from_label"). Notice the order of the labels is reversed with respect to the qubit index to be applied to. Example label ‘01’ initializes the qubit zero to $|1\rangle$ and the qubit one to $|0\rangle$.
+ * list: vector of complex amplitudes to initialize to.
+ * int: an integer that is used as a bitmap indicating which qubits to initialize to $|1\rangle$. Example: setting params to 5 would initialize qubit 0 and qubit 2 to $|1\rangle$ and qubit 1 to $|0\rangle$.
+
+* **qubits** ([*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister") *or*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit") *or*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) –
+
+ * QuantumRegister: A list of qubits to be initialized \[Default: None].
+ * Qubit: Single qubit to be initialized \[Default: None].
+ * int: Index of qubit to be initialized \[Default: None].
+ * list: Indexes of qubits to be initialized \[Default: None].
+
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – An optional label for the gate
+
+* **normalize** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to normalize an input array to a unit vector.
+
+**Returns**
+
+a handle to the instruction that was just initialized
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Examples**
+
+Prepare a qubit in the state $(|0\rangle - |1\rangle) / \sqrt{2}$.
+
+```python
+import numpy as np
+from qiskit import QuantumCircuit
+
+circuit = QuantumCircuit(1)
+circuit.prepare_state([1/np.sqrt(2), -1/np.sqrt(2)], 0)
+circuit.draw()
+```
+
+output:
+
+```python
+ ┌─────────────────────────────────────┐
+q_0: ┤ State Preparation(0.70711,-0.70711) ├
+ └─────────────────────────────────────┘
+```
+
+Prepare from a string two qubits in the state $|10\rangle$. The order of the labels is reversed with respect to qubit index. More information about labels for basis states are in [`Statevector.from_label()`](qiskit.quantum_info.Statevector#from_label "qiskit.quantum_info.Statevector.from_label").
+
+```python
+import numpy as np
+from qiskit import QuantumCircuit
+
+circuit = QuantumCircuit(2)
+circuit.prepare_state('01', circuit.qubits)
+circuit.draw()
+```
+
+output:
+
+```python
+ ┌─────────────────────────┐
+q_0: ┤0 ├
+ │ State Preparation(0,1) │
+q_1: ┤1 ├
+ └─────────────────────────┘
+```
+
+Initialize two qubits from an array of complex amplitudes .. code-block:
+
+```python
+import numpy as np
+from qiskit import QuantumCircuit
+
+circuit = QuantumCircuit(2)
+circuit.prepare_state([0, 1/np.sqrt(2), -1.j/np.sqrt(2), 0], circuit.qubits)
+circuit.draw()
+```
+
+output:
+
+```python
+ ┌───────────────────────────────────────────┐
+q_0: ┤0 ├
+ │ State Preparation(0,0.70711,-0.70711j,0) │
+q_1: ┤1 ├
+ └───────────────────────────────────────────┘
+```
+
+### qasm
+
+
+
+`qasm(formatted=False, filename=None, encoding=None)`
+
+Return OpenQASM 2.0 string.
+
+
+ **[`qasm2.dump()`](qasm2#qiskit.qasm2.dump "qiskit.qasm2.dump") and [`qasm2.dumps()`](qasm2#qiskit.qasm2.dumps "qiskit.qasm2.dumps")**
+
+ The preferred entry points to the OpenQASM 2 export capabilities. These match the interface for other serialisers in Qiskit.
+
+
+
+ The method `qiskit.circuit.quantumcircuit.QuantumCircuit.qasm()` is deprecated as of qiskit 0.46. It will be removed in the 1.0.0 release. Instead use the qiskit.qasm2.dump() or qiskit.qasm2.dumps() function
+
+
+**Parameters**
+
+* **formatted** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Return formatted OpenQASM 2.0 string.
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Save OpenQASM 2.0 to file with name ‘filename’.
+* **encoding** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Optionally specify the encoding to use for the output file if `filename` is specified. By default this is set to the system’s default encoding (ie whatever `locale.getpreferredencoding()` returns) and can be set to any valid codec or alias from stdlib’s [codec module](https://docs.python.org/3/library/codecs.html#standard-encodings)
+
+**Returns**
+
+If formatted=False.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+**Raises**
+
+* [**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – If pygments is not installed and `formatted` is `True`.
+* [**QASM2ExportError**](qasm2#qiskit.qasm2.QASM2ExportError "qiskit.qasm2.QASM2ExportError") – If circuit has free parameters.
+* [**QASM2ExportError**](qasm2#qiskit.qasm2.QASM2ExportError "qiskit.qasm2.QASM2ExportError") – If an operation that has no OpenQASM 2 representation is encountered.
+
+### qbit\_argument\_conversion
+
+
+
+`qbit_argument_conversion(qubit_representation)`
+
+Converts several qubit representations (such as indexes, range, etc.) into a list of qubits.
+
+**Parameters**
+
+**qubit\_representation** (*Object*) – representation to expand
+
+**Returns**
+
+the resolved instances of the qubits.
+
+**Return type**
+
+List([Qubit](qiskit.circuit.Qubit "qiskit.circuit.Qubit"))
+
+### qubit\_duration
+
+
+
+`qubit_duration(*qubits)`
+
+Return the duration between the start and stop time of the first and last instructions, excluding delays, over the supplied qubits. Its time unit is `self.unit`.
+
+**Parameters**
+
+**\*qubits** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Qubits within `self` to include.
+
+**Returns**
+
+Return the duration between the first start and last stop time of non-delay instructions
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+### qubit\_start\_time
+
+
+
+`qubit_start_time(*qubits)`
+
+Return the start time of the first instruction, excluding delays, over the supplied qubits. Its time unit is `self.unit`.
+
+Return 0 if there are no instructions over qubits
+
+**Parameters**
+
+* **\*qubits** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Qubits within `self` to include. Integers are allowed for qubits, indicating
+* **self.qubits.** (*indices of*) –
+
+**Returns**
+
+Return the start time of the first instruction, excluding delays, over the qubits
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if `self` is a not-yet scheduled circuit.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+### qubit\_stop\_time
+
+
+
+`qubit_stop_time(*qubits)`
+
+Return the stop time of the last instruction, excluding delays, over the supplied qubits. Its time unit is `self.unit`.
+
+Return 0 if there are no instructions over qubits
+
+**Parameters**
+
+* **\*qubits** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Qubits within `self` to include. Integers are allowed for qubits, indicating
+* **self.qubits.** (*indices of*) –
+
+**Returns**
+
+Return the stop time of the last instruction, excluding delays, over the qubits
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if `self` is a not-yet scheduled circuit.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+### r
+
+
+
+`r(theta, phi, qubit)`
+
+Apply [`RGate`](qiskit.circuit.library.RGate "qiskit.circuit.library.RGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **theta** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The angle of the rotation.
+* **phi** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The angle of the axis of rotation in the x-y plane.
+* **qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### rcccx
+
+
+
+`rcccx(control_qubit1, control_qubit2, control_qubit3, target_qubit)`
+
+Apply [`RC3XGate`](qiskit.circuit.library.RC3XGate "qiskit.circuit.library.RC3XGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **control\_qubit1** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) used as the first control.
+* **control\_qubit2** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) used as the second control.
+* **control\_qubit3** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) used as the third control.
+* **target\_qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) targeted by the gate.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### rccx
+
+
+
+`rccx(control_qubit1, control_qubit2, target_qubit)`
+
+Apply [`RCCXGate`](qiskit.circuit.library.RCCXGate "qiskit.circuit.library.RCCXGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **control\_qubit1** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) used as the first control.
+* **control\_qubit2** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) used as the second control.
+* **target\_qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) targeted by the gate.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### remove\_final\_measurements
+
+
+
+`remove_final_measurements(inplace=True)`
+
+Removes final measurements and barriers on all qubits if they are present. Deletes the classical registers that were used to store the values from these measurements that become idle as a result of this operation, and deletes classical bits that are referenced only by removed registers, or that aren’t referenced at all but have become idle as a result of this operation.
+
+Measurements and barriers are considered final if they are followed by no other operations (aside from other measurements or barriers.)
+
+**Parameters**
+
+**inplace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – All measurements removed inplace or return new circuit.
+
+**Returns**
+
+Returns the resulting circuit when `inplace=False`, else None.
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### repeat
+
+
+
+`repeat(reps)`
+
+Repeat this circuit `reps` times.
+
+**Parameters**
+
+**reps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – How often this circuit should be repeated.
+
+**Returns**
+
+A circuit containing `reps` repetitions of this circuit.
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### reset
+
+
+
+`reset(qubit)`
+
+Reset the quantum bit(s) to their default state.
+
+**Parameters**
+
+**qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – qubit(s) to reset.
+
+**Returns**
+
+handle to the added instruction.
+
+**Return type**
+
+[qiskit.circuit.InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+### reverse\_bits
+
+
+
+`reverse_bits()`
+
+Return a circuit with the opposite order of wires.
+
+The circuit is “vertically” flipped. If a circuit is defined over multiple registers, the resulting circuit will have the same registers but with their order flipped.
+
+This method is useful for converting a circuit written in little-endian convention to the big-endian equivalent, and vice versa.
+
+**Returns**
+
+the circuit with reversed bit order.
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Examples**
+
+input:
+
+```python
+ ┌───┐
+a_0: ┤ H ├──■─────────────────
+ └───┘┌─┴─┐
+a_1: ─────┤ X ├──■────────────
+ └───┘┌─┴─┐
+a_2: ──────────┤ X ├──■───────
+ └───┘┌─┴─┐
+b_0: ───────────────┤ X ├──■──
+ └───┘┌─┴─┐
+b_1: ────────────────────┤ X ├
+ └───┘
+```
+
+output:
+
+```python
+ ┌───┐
+b_0: ────────────────────┤ X ├
+ ┌───┐└─┬─┘
+b_1: ───────────────┤ X ├──■──
+ ┌───┐└─┬─┘
+a_0: ──────────┤ X ├──■───────
+ ┌───┐└─┬─┘
+a_1: ─────┤ X ├──■────────────
+ ┌───┐└─┬─┘
+a_2: ┤ H ├──■─────────────────
+ └───┘
+```
+
+### reverse\_ops
+
+
+
+`reverse_ops()`
+
+Reverse the circuit by reversing the order of instructions.
+
+This is done by recursively reversing all instructions. It does not invert (adjoint) any gate.
+
+**Returns**
+
+the reversed circuit.
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Examples**
+
+input:
+
+```python
+ ┌───┐
+q_0: ┤ H ├─────■──────
+ └───┘┌────┴─────┐
+q_1: ─────┤ RX(1.57) ├
+ └──────────┘
+```
+
+output:
+
+```python
+ ┌───┐
+q_0: ─────■──────┤ H ├
+ ┌────┴─────┐└───┘
+q_1: ┤ RX(1.57) ├─────
+ └──────────┘
+```
+
+### rv
+
+
+
+`rv(vx, vy, vz, qubit)`
+
+Apply [`RVGate`](qiskit.circuit.library.RVGate "qiskit.circuit.library.RVGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+Rotation around an arbitrary rotation axis $v$, where $|v|$ is the angle of rotation in radians.
+
+**Parameters**
+
+* **vx** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – x-component of the rotation axis.
+* **vy** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – y-component of the rotation axis.
+* **vz** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – z-component of the rotation axis.
+* **qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### rx
+
+
+
+`rx(theta, qubit, label=None)`
+
+Apply [`RXGate`](qiskit.circuit.library.RXGate "qiskit.circuit.library.RXGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **theta** (*ParameterValueType*) – The rotation angle of the gate.
+* **qubit** (*QubitSpecifier*) – The qubit(s) to apply the gate to.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The string label of the gate in the circuit.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+### rxx
+
+
+
+`rxx(theta, qubit1, qubit2)`
+
+Apply [`RXXGate`](qiskit.circuit.library.RXXGate "qiskit.circuit.library.RXXGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **theta** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The angle of the rotation.
+* **qubit1** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+* **qubit2** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### ry
+
+
+
+`ry(theta, qubit, label=None)`
+
+Apply [`RYGate`](qiskit.circuit.library.RYGate "qiskit.circuit.library.RYGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **theta** (*ParameterValueType*) – The rotation angle of the gate.
+* **qubit** (*QubitSpecifier*) – The qubit(s) to apply the gate to.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The string label of the gate in the circuit.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+### ryy
+
+
+
+`ryy(theta, qubit1, qubit2)`
+
+Apply [`RYYGate`](qiskit.circuit.library.RYYGate "qiskit.circuit.library.RYYGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **theta** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The rotation angle of the gate.
+* **qubit1** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+* **qubit2** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### rz
+
+
+
+`rz(phi, qubit)`
+
+Apply [`RZGate`](qiskit.circuit.library.RZGate "qiskit.circuit.library.RZGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **phi** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The rotation angle of the gate.
+* **qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### rzx
+
+
+
+`rzx(theta, qubit1, qubit2)`
+
+Apply [`RZXGate`](qiskit.circuit.library.RZXGate "qiskit.circuit.library.RZXGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **theta** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The rotation angle of the gate.
+* **qubit1** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+* **qubit2** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### rzz
+
+
+
+`rzz(theta, qubit1, qubit2)`
+
+Apply [`RZZGate`](qiskit.circuit.library.RZZGate "qiskit.circuit.library.RZZGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **theta** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The rotation angle of the gate.
+* **qubit1** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+* **qubit2** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### s
+
+
+
+`s(qubit)`
+
+Apply [`SGate`](qiskit.circuit.library.SGate "qiskit.circuit.library.SGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+**qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### sdg
+
+
+
+`sdg(qubit)`
+
+Apply [`SdgGate`](qiskit.circuit.library.SdgGate "qiskit.circuit.library.SdgGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+**qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### size
+
+
+
+`size(filter_function=>)`
+
+Returns total number of instructions in circuit.
+
+**Parameters**
+
+**filter\_function** (*callable*) – a function to filter out some instructions. Should take as input a tuple of (Instruction, list(Qubit), list(Clbit)). By default filters out “directives”, such as barrier or snapshot.
+
+**Returns**
+
+Total number of gate operations.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### snapshot
+
+
+
+`snapshot(label, snapshot_type='statevector', qubits=None, params=None)`
+
+Take a statevector snapshot of the internal simulator representation. Works on all qubits, and prevents reordering (like barrier).
+
+For other types of snapshots use the Snapshot extension directly.
+
+
+ The method `qiskit.circuit.quantumcircuit.QuantumCircuit.snapshot()` is deprecated as of qiskit 0.45.0. It will be removed in the Qiskit 1.0.0 release. The Snapshot instruction has been superseded by Qiskit Aer’s save instructions, see [https://qiskit.org/ecosystem/aer/apidocs/aer\_library.html#saving-simulator-data](https://qiskit.org/ecosystem/aer/apidocs/aer_library.html#saving-simulator-data).
+
+
+**Parameters**
+
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – a snapshot label to report the result.
+* **snapshot\_type** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – the type of the snapshot.
+* **qubits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – the qubits to apply snapshot to \[Default: None].
+* **params** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – the parameters for snapshot\_type \[Default: None].
+
+**Returns**
+
+with attached command
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**ExtensionError**](extensions#qiskit.extensions.ExtensionError "qiskit.extensions.ExtensionError") – malformed command
+
+### squ
+
+
+
+`squ(unitary_matrix, qubit, mode='ZYZ', up_to_diagonal=False)`
+
+Decompose an arbitrary 2\*2 unitary into three rotation gates.
+
+Note that the decomposition is up to a global phase shift. (This is a well known decomposition which can be found for example in Nielsen and Chuang’s book “Quantum computation and quantum information”.)
+
+
+ The method `qiskit.circuit.quantumcircuit.QuantumCircuit.squ()` is deprecated as of qiskit 0.45.0. It will be removed in the Qiskit 1.0.0 release. Instead, use the QuantumCircuit.unitary method.
+
+
+**Parameters**
+
+* **unitary\_matrix** (*ndarray*) – 2\*2 unitary (given as a (complex) ndarray).
+* **qubit** ([*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister") *or*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")) – The qubit which the gate is acting on.
+* **mode** (*string*) – determines the used decomposition by providing the rotation axes. The allowed modes are: “ZYZ” (default)
+* **up\_to\_diagonal** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if set to True, the single-qubit unitary is decomposed up to a diagonal matrix, i.e. a unitary u’ is implemented such that there exists a 2\*2 diagonal gate d with u = d.dot(u’)
+
+**Returns**
+
+The single-qubit unitary instruction attached to the circuit.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the format is wrong; if the array u is not unitary
+
+### swap
+
+
+
+`swap(qubit1, qubit2)`
+
+Apply [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **qubit1** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubits to apply the gate to.
+* **qubit2** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubits to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### switch
+
+### switch
+
+
+
+`switch(target: Clbit | ClassicalRegister | int | slice | Sequence[Clbit | int], cases: None, qubits: None, clbits: None, *, label: str | None) → qiskit.circuit.controlflow.switch_case.SwitchContext`
+
+
+
+`switch(target: Clbit | ClassicalRegister | int | slice | Sequence[Clbit | int], cases: Iterable[Tuple[Any, QuantumCircuit]], qubits: Sequence[Qubit | QuantumRegister | int | slice | Sequence[Qubit | int]], clbits: Sequence[Clbit | ClassicalRegister | int | slice | Sequence[Clbit | int]], *, label: str | None) → InstructionSet`
+
+Create a `switch`/`case` structure on this circuit.
+
+There are two forms for calling this function. If called with all its arguments (with the possible exception of `label`), it will create a [`SwitchCaseOp`](qiskit.circuit.SwitchCaseOp "qiskit.circuit.SwitchCaseOp") with the given case structure. If `cases` (and `qubits` and `clbits`) are *not* passed, then this acts as a context manager, which will automatically build a [`SwitchCaseOp`](qiskit.circuit.SwitchCaseOp "qiskit.circuit.SwitchCaseOp") when the scope finishes. In this form, you do not need to keep track of the qubits or clbits you are using, because the scope will handle it for you.
+
+Example usage:
+
+```python
+from qiskit.circuit import QuantumCircuit, ClassicalRegister, QuantumRegister
+qreg = QuantumRegister(3)
+creg = ClassicalRegister(3)
+qc = QuantumCircuit(qreg, creg)
+qc.h([0, 1, 2])
+qc.measure([0, 1, 2], [0, 1, 2])
+
+with qc.switch(creg) as case:
+ with case(0):
+ qc.x(0)
+ with case(1, 2):
+ qc.z(1)
+ with case(case.DEFAULT):
+ qc.cx(0, 1)
+```
+
+**Parameters**
+
+* **target** (*Union\[*[*ClassicalRegister*](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister")*,* [*Clbit*](qiskit.circuit.Clbit "qiskit.circuit.Clbit")*]*) – The classical value to switch one. This must be integer-like.
+* **cases** (*Iterable\[Tuple\[*[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")*,* [*QuantumCircuit*](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]]*) – A sequence of case specifiers. Each tuple defines one case body (the second item). The first item of the tuple can be either a single integer value, the special value [`CASE_DEFAULT`](circuit#qiskit.circuit.CASE_DEFAULT "qiskit.circuit.CASE_DEFAULT"), or a tuple of several integer values. Each of the integer values will be tried in turn; control will then pass to the body corresponding to the first match. [`CASE_DEFAULT`](circuit#qiskit.circuit.CASE_DEFAULT "qiskit.circuit.CASE_DEFAULT") matches all possible values. Omit in context-manager form.
+* **qubits** (*Sequence\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]*) – The circuit qubits over which all case bodies execute. Omit in context-manager form.
+* **clbits** (*Sequence\[*[*Clbit*](qiskit.circuit.Clbit "qiskit.circuit.Clbit")*]*) – The circuit clbits over which all case bodies execute. Omit in context-manager form.
+* **label** (*Optional\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – The string label of the instruction in the circuit.
+
+**Returns**
+
+If used in context-manager mode, then this should be used as a `with` resource, which will return an object that can be repeatedly entered to produce cases for the switch statement. If the full form is used, then this returns a handle to the instructions created.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet") or SwitchCaseContext
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if an incorrect calling convention is used.
+
+### sx
+
+
+
+`sx(qubit)`
+
+Apply [`SXGate`](qiskit.circuit.library.SXGate "qiskit.circuit.library.SXGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+**qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### sxdg
+
+
+
+`sxdg(qubit)`
+
+Apply [`SXdgGate`](qiskit.circuit.library.SXdgGate "qiskit.circuit.library.SXdgGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+**qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### t
+
+
+
+`t(qubit)`
+
+Apply [`TGate`](qiskit.circuit.library.TGate "qiskit.circuit.library.TGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+**qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### tdg
+
+
+
+`tdg(qubit)`
+
+Apply [`TdgGate`](qiskit.circuit.library.TdgGate "qiskit.circuit.library.TdgGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+**qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### tensor
+
+
+
+`tensor(other, inplace=False)`
+
+Tensor `self` with `other`.
+
+Remember that in the little-endian convention the leftmost operation will be at the bottom of the circuit. See also [the docs](https://docs.quantum-computing.ibm.com/build/circuit-construction) for more information.
+
+```python
+ ┌────────┐ ┌─────┐ ┌─────┐
+q_0: ┤ bottom ├ ⊗ q_0: ┤ top ├ = q_0: ─┤ top ├──
+ └────────┘ └─────┘ ┌┴─────┴─┐
+ q_1: ┤ bottom ├
+ └────────┘
+```
+
+**Parameters**
+
+* **other** ([*QuantumCircuit*](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – The other circuit to tensor this circuit with.
+* **inplace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, modify the object. Otherwise return composed circuit.
+
+**Return type**
+
+[*QuantumCircuit*](#qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit") | None
+
+**Examples**
+
+```python
+from qiskit import QuantumCircuit
+top = QuantumCircuit(1)
+top.x(0);
+bottom = QuantumCircuit(2)
+bottom.cry(0.2, 0, 1);
+tensored = bottom.tensor(top)
+tensored.draw('mpl')
+```
+
+
+
+**Returns**
+
+The tensored circuit (returns None if inplace==True).
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### to\_gate
+
+
+
+`to_gate(parameter_map=None, label=None)`
+
+Create a Gate out of this circuit.
+
+**Parameters**
+
+* **parameter\_map** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – For parameterized circuits, a mapping from parameters in the circuit to parameters to be used in the gate. If None, existing circuit parameters will also parameterize the gate.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Optional gate label.
+
+**Returns**
+
+a composite gate encapsulating this circuit (can be decomposed back)
+
+**Return type**
+
+[Gate](qiskit.circuit.Gate "qiskit.circuit.Gate")
+
+### to\_instruction
+
+
+
+`to_instruction(parameter_map=None, label=None)`
+
+Create an Instruction out of this circuit.
+
+**Parameters**
+
+* **parameter\_map** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – For parameterized circuits, a mapping from parameters in the circuit to parameters to be used in the instruction. If None, existing circuit parameters will also parameterize the instruction.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Optional gate label.
+
+**Returns**
+
+a composite instruction encapsulating this circuit (can be decomposed back)
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### toffoli
+
+
+
+`toffoli(control_qubit1, control_qubit2, target_qubit)`
+
+Apply [`CCXGate`](qiskit.circuit.library.CCXGate "qiskit.circuit.library.CCXGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+
+ The method `qiskit.circuit.quantumcircuit.QuantumCircuit.toffoli()` is deprecated as of qiskit 0.45.0. It will be removed in the Qiskit 1.0.0 release. Use QuantumCircuit.ccx as direct replacement.
+
+
+**Parameters**
+
+* **control\_qubit1** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) used as the first control.
+* **control\_qubit2** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) used as the second control.
+* **target\_qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) targeted by the gate.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+
+ QuantumCircuit.ccx: the same gate with a different name.
+
+
+### u
+
+
+
+`u(theta, phi, lam, qubit)`
+
+Apply [`UGate`](qiskit.circuit.library.UGate "qiskit.circuit.library.UGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **theta** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The $\theta$ rotation angle of the gate.
+* **phi** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The $\phi$ rotation angle of the gate.
+* **lam** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The $\lambda$ rotation angle of the gate.
+* **qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### uc
+
+
+
+`uc(gate_list, q_controls, q_target, up_to_diagonal=False)`
+
+Attach a uniformly controlled gates (also called multiplexed gates) to a circuit.
+
+The decomposition was introduced by Bergholm et al. in [https://arxiv.org/pdf/quant-ph/0410066.pdf](https://arxiv.org/pdf/quant-ph/0410066.pdf).
+
+
+ The method `qiskit.circuit.quantumcircuit.QuantumCircuit.uc()` is deprecated as of qiskit 0.46.0. It will be removed in the 1.0.0 release. Instead, append a qiskit.circuit.library.UCGate to the circuit.
+
+
+**Parameters**
+
+* **gate\_list** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[ndarray]*) – list of two qubit unitaries \[U\_0,…,U\_\{2^k-1}], where each single-qubit unitary U\_i is a given as a 2\*2 array
+* **q\_controls** ([*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[(*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister")*,*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*)]*) – list of k control qubits. The qubits are ordered according to their significance in the computational basis. For example if q\_controls=\[q\[1],q\[2]] (with q = QuantumRegister(2)), the unitary U\_0 is performed if q\[1] and q\[2] are in the state zero, U\_1 is performed if q\[2] is in the state zero and q\[1] is in the state one, and so on
+* **q\_target** ([*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister") *|*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*(*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*)*) – target qubit, where we act on with the single-qubit gates.
+* **up\_to\_diagonal** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If set to True, the uniformly controlled gate is decomposed up to a diagonal gate, i.e. a unitary u’ is implemented such that there exists a diagonal gate d with u = d.dot(u’), where the unitary u describes the uniformly controlled gate
+
+**Returns**
+
+the uniformly controlled gate is attached to the circuit.
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the list number of control qubits does not correspond to the provided number of single-qubit unitaries; if an input is of the wrong type
+
+### ucrx
+
+
+
+`ucrx(angle_list, q_controls, q_target)`
+
+Attach a uniformly controlled (also called multiplexed) Rx rotation gate to a circuit.
+
+The decomposition is base on [https://arxiv.org/pdf/quant-ph/0406176.pdf](https://arxiv.org/pdf/quant-ph/0406176.pdf) by Shende et al.
+
+
+ The method `qiskit.circuit.quantumcircuit.QuantumCircuit.ucrx()` is deprecated as of qiskit 0.46.0. It will be removed in the 1.0.0 release. Instead, append a qiskit.circuit.library.UCRXGate to the circuit.
+
+
+**Parameters**
+
+* **angle\_list** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – list of (real) rotation angles $[a_0,...,a_{2^k-1}]$
+* **q\_controls** (*Sequence\[QubitSpecifier]*) – list of k control qubits (or empty list if no controls). The control qubits are ordered according to their significance in increasing order: For example if `q_controls=[q[0],q[1]]` (with `q = QuantumRegister(2)`), the rotation `Rx(a_0)` is performed if `q[0]` and `q[1]` are in the state zero, the rotation `Rx(a_1)` is performed if `q[0]` is in the state one and `q[1]` is in the state zero, and so on
+* **q\_target** (*QubitSpecifier*) – target qubit, where we act on with the single-qubit rotation gates
+
+**Returns**
+
+the uniformly controlled rotation gate is attached to the circuit.
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the list number of control qubits does not correspond to the provided number of single-qubit unitaries; if an input is of the wrong type
+
+### ucry
+
+
+
+`ucry(angle_list, q_controls, q_target)`
+
+Attach a uniformly controlled (also called multiplexed) Ry rotation gate to a circuit.
+
+The decomposition is base on [https://arxiv.org/pdf/quant-ph/0406176.pdf](https://arxiv.org/pdf/quant-ph/0406176.pdf) by Shende et al.
+
+
+ The method `qiskit.circuit.quantumcircuit.QuantumCircuit.ucry()` is deprecated as of qiskit 0.46.0. It will be removed in the 1.0.0 release. Instead, append a qiskit.circuit.library.UCRYGate to the circuit.
+
+
+**Parameters**
+
+* **angle\_list** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – list of (real) rotation angles $[a_0,...,a_{2^k-1}]$
+* **q\_controls** (*Sequence\[QubitSpecifier]*) – list of k control qubits (or empty list if no controls). The control qubits are ordered according to their significance in increasing order: For example if `q_controls=[q[0],q[1]]` (with `q = QuantumRegister(2)`), the rotation `Ry(a_0)` is performed if `q[0]` and `q[1]` are in the state zero, the rotation `Ry(a_1)` is performed if `q[0]` is in the state one and `q[1]` is in the state zero, and so on
+* **q\_target** (*QubitSpecifier*) – target qubit, where we act on with the single-qubit rotation gates
+
+**Returns**
+
+the uniformly controlled rotation gate is attached to the circuit.
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the list number of control qubits does not correspond to the provided number of single-qubit unitaries; if an input is of the wrong type
+
+### ucrz
+
+
+
+`ucrz(angle_list, q_controls, q_target)`
+
+Attach a uniformly controlled (also called multiplexed) Rz rotation gate to a circuit.
+
+The decomposition is base on [https://arxiv.org/pdf/quant-ph/0406176.pdf](https://arxiv.org/pdf/quant-ph/0406176.pdf) by Shende et al.
+
+
+ The method `qiskit.circuit.quantumcircuit.QuantumCircuit.ucrz()` is deprecated as of qiskit 0.46.0. It will be removed in the 1.0.0 release. Instead, append a qiskit.circuit.library.UCRZGate to the circuit.
+
+
+**Parameters**
+
+* **angle\_list** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – list of (real) rotation angles $[a_0,...,a_{2^k-1}]$
+* **q\_controls** (*Sequence\[QubitSpecifier]*) – list of k control qubits (or empty list if no controls). The control qubits are ordered according to their significance in increasing order: For example if `q_controls=[q[0],q[1]]` (with `q = QuantumRegister(2)`), the rotation `Rz(a_0)` is performed if `q[0]` and `q[1]` are in the state zero, the rotation `Rz(a_1)` is performed if `q[0]` is in the state one and `q[1]` is in the state zero, and so on
+* **q\_target** (*QubitSpecifier*) – target qubit, where we act on with the single-qubit rotation gates
+
+**Returns**
+
+the uniformly controlled rotation gate is attached to the circuit.
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the list number of control qubits does not correspond to the provided number of single-qubit unitaries; if an input is of the wrong type
+
+### unitary
+
+
+
+`unitary(obj, qubits, label=None)`
+
+Apply unitary gate specified by `obj` to `qubits`.
+
+**Parameters**
+
+* **obj** (*np.ndarray |* [*Gate*](qiskit.circuit.Gate "qiskit.circuit.Gate") *| BaseOperator*) – Unitary operator.
+* **qubits** (*Sequence\[QubitSpecifier]*) – The circuit qubits to apply the transformation to.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Unitary name for backend \[Default: None].
+
+**Returns**
+
+The quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Example**
+
+Apply a gate specified by a unitary matrix to a quantum circuit
+
+```python
+from qiskit import QuantumCircuit
+matrix = [[0, 0, 0, 1],
+ [0, 0, 1, 0],
+ [1, 0, 0, 0],
+ [0, 1, 0, 0]]
+circuit = QuantumCircuit(2)
+circuit.unitary(matrix, [0, 1])
+```
+
+### while\_loop
+
+### while\_loop
+
+
+
+`while_loop(condition: tuple[ClassicalRegister | Clbit, int] | expr.Expr, body: None, qubits: None, clbits: None, *, label: str | None) → qiskit.circuit.controlflow.while_loop.WhileLoopContext`
+
+
+
+`while_loop(condition: tuple[ClassicalRegister | Clbit, int] | expr.Expr, body: QuantumCircuit, qubits: Sequence[Qubit | QuantumRegister | int | slice | Sequence[Qubit | int]], clbits: Sequence[Clbit | ClassicalRegister | int | slice | Sequence[Clbit | int]], *, label: str | None) → InstructionSet`
+
+Create a `while` loop on this circuit.
+
+There are two forms for calling this function. If called with all its arguments (with the possible exception of `label`), it will create a `WhileLoopOp` with the given `body`. If `body` (and `qubits` and `clbits`) are *not* passed, then this acts as a context manager, which will automatically build a `WhileLoopOp` when the scope finishes. In this form, you do not need to keep track of the qubits or clbits you are using, because the scope will handle it for you.
+
+Example usage:
+
+```python
+from qiskit.circuit import QuantumCircuit, Clbit, Qubit
+bits = [Qubit(), Qubit(), Clbit()]
+qc = QuantumCircuit(bits)
+
+with qc.while_loop((bits[2], 0)):
+ qc.h(0)
+ qc.cx(0, 1)
+ qc.measure(0, 0)
+```
+
+**Parameters**
+
+* **condition** (*Tuple\[Union\[*[*ClassicalRegister*](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister")*,* [*Clbit*](qiskit.circuit.Clbit "qiskit.circuit.Clbit")*],* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – An equality condition to be checked prior to executing `body`. The left-hand side of the condition must be a [`ClassicalRegister`](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister") or a [`Clbit`](qiskit.circuit.Clbit "qiskit.circuit.Clbit"), and the right-hand side must be an integer or boolean.
+* **body** (*Optional\[*[*QuantumCircuit*](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – The loop body to be repeatedly executed. Omit this to use the context-manager mode.
+* **qubits** (*Optional\[Sequence\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]]*) – The circuit qubits over which the loop body should be run. Omit this to use the context-manager mode.
+* **clbits** (*Optional\[Sequence\[*[*Clbit*](qiskit.circuit.Clbit "qiskit.circuit.Clbit")*]]*) – The circuit clbits over which the loop body should be run. Omit this to use the context-manager mode.
+* **label** (*Optional\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – The string label of the instruction in the circuit.
+
+**Returns**
+
+If used in context-manager mode, then this should be used as a `with` resource, which will infer the block content and operands on exit. If the full form is used, then this returns a handle to the instructions created.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet") or WhileLoopContext
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if an incorrect calling convention is used.
+
+### width
+
+
+
+`width()`
+
+Return number of qubits plus clbits in circuit.
+
+**Returns**
+
+Width of circuit.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### x
+
+
+
+`x(qubit, label=None)`
+
+Apply [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.library.XGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+* **qubit** (*QubitSpecifier*) – The qubit(s) to apply the gate to.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The string label of the gate in the circuit.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
+
+### y
+
+
+
+`y(qubit)`
+
+Apply [`YGate`](qiskit.circuit.library.YGate "qiskit.circuit.library.YGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+**qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
+### z
+
+
+
+`z(qubit)`
+
+Apply [`ZGate`](qiskit.circuit.library.ZGate "qiskit.circuit.library.ZGate").
+
+For the full matrix form of this gate, see the underlying gate documentation.
+
+**Parameters**
+
+**qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.quantumregister.QuantumRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*slice*](https://docs.python.org/3/library/functions.html#slice "(in Python v3.12)") *|*[*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.quantumregister.Qubit") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit(s) to apply the gate to.
+
+**Returns**
+
+A handle to the instructions created.
+
+**Return type**
+
+[*InstructionSet*](qiskit.circuit.InstructionSet "qiskit.circuit.instructionset.InstructionSet")
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.QuantumRegister.md b/docs/api/qiskit/0.46/qiskit.circuit.QuantumRegister.md
new file mode 100644
index 00000000000..009b411b508
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.QuantumRegister.md
@@ -0,0 +1,90 @@
+---
+title: QuantumRegister
+description: API reference for qiskit.circuit.QuantumRegister
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.QuantumRegister
+---
+
+# QuantumRegister
+
+
+
+`qiskit.circuit.QuantumRegister(size=None, name=None, bits=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/quantumregister.py "view source code")
+
+Bases: [`Register`](qiskit.circuit.Register "qiskit.circuit.register.Register")
+
+Implement a quantum register.
+
+Create a new generic register.
+
+Either the `size` or the `bits` argument must be provided. If `size` is not None, the register will be pre-populated with bits of the correct type.
+
+**Parameters**
+
+* **size** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Optional. The number of bits to include in the register.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Optional. The name of the register. If not provided, a unique name will be auto-generated from the register type.
+* **bits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Bit*](qiskit.circuit.Bit "qiskit.circuit.Bit")*]*) – Optional. A list of Bit() instances to be used to populate the register.
+
+**Raises**
+
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if both the `size` and `bits` arguments are provided, or if neither are.
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if `size` is not valid.
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if `name` is not a valid name according to the OpenQASM spec.
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if `bits` contained duplicated bits.
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if `bits` contained bits of an incorrect type.
+
+## Attributes
+
+
+
+### instances\_counter
+
+`= count(6)`
+
+
+
+### name
+
+Get the register name.
+
+
+
+### name\_format
+
+`= re.compile('[a-z][a-zA-Z0-9_]*')`
+
+
+
+### prefix
+
+`= 'q'`
+
+
+
+### size
+
+Get the register size.
+
+## Methods
+
+### index
+
+
+
+`index(bit)`
+
+Find the index of the provided bit within this register.
+
+### qasm
+
+
+
+`qasm()`
+
+Return OPENQASM string for this register.
+
+
+ The method `qiskit.circuit.quantumregister.QuantumRegister.qasm()` is deprecated as of qiskit-terra 0.23.0. It will be removed in the Qiskit 1.0 release. Correct exporting to OpenQASM 2 is the responsibility of a larger exporter; it cannot safely be done on an object-by-object basis without context. No replacement will be provided, because the premise is wrong.
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.Qubit.md b/docs/api/qiskit/0.46/qiskit.circuit.Qubit.md
new file mode 100644
index 00000000000..4eec17a136b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.Qubit.md
@@ -0,0 +1,55 @@
+---
+title: Qubit
+description: API reference for qiskit.circuit.Qubit
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.Qubit
+---
+
+# Qubit
+
+
+
+`qiskit.circuit.Qubit(register=None, index=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/quantumregister.py "view source code")
+
+Bases: [`Bit`](qiskit.circuit.Bit "qiskit.circuit.bit.Bit")
+
+Implement a quantum bit.
+
+Creates a qubit.
+
+**Parameters**
+
+* **register** ([*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister")) – Optional. A quantum register containing the bit.
+* **index** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Optional. The index of the bit in its containing register.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the provided register is not a valid [`QuantumRegister`](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister")
+
+## Attributes
+
+
+
+### index
+
+Get the index of an old-style bit in the register that owns it.
+
+In modern Qiskit Terra (version 0.17+), bits are the fundamental object and registers are aliases to collections of bits. A bit can be in many registers depending on the circuit, so a single containing register is no longer a property of a bit. It is an error to access this attribute on bits that were not constructed as “owned” by a register.
+
+
+ The property `qiskit.circuit.bit.Bit.index` is deprecated as of qiskit-terra 0.17. It will be removed in the Qiskit 1.0 release. Instead, use `find_bit()` to find all the containing registers within a circuit and the index of the bit within the circuit.
+
+
+
+
+### register
+
+Get the register of an old-style bit.
+
+In modern Qiskit Terra (version 0.17+), bits are the fundamental object and registers are aliases to collections of bits. A bit can be in many registers depending on the circuit, so a single containing register is no longer a property of a bit. It is an error to access this attribute on bits that were not constructed as “owned” by a register.
+
+
+ The property `qiskit.circuit.bit.Bit.register` is deprecated as of qiskit-terra 0.17. It will be removed in the Qiskit 1.0 release. Instead, use `find_bit()` to find all the containing registers within a circuit and the index of the bit within the circuit.
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.Register.md b/docs/api/qiskit/0.46/qiskit.circuit.Register.md
new file mode 100644
index 00000000000..6b95a843580
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.Register.md
@@ -0,0 +1,88 @@
+---
+title: Register
+description: API reference for qiskit.circuit.Register
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.Register
+---
+
+# Register
+
+
+
+`qiskit.circuit.Register(size=None, name=None, bits=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/register.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Implement a generic register.
+
+
+ This class should not be instantiated directly. This is just a superclass for [`ClassicalRegister`](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister") and [`QuantumRegister`](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister").
+
+
+Create a new generic register.
+
+Either the `size` or the `bits` argument must be provided. If `size` is not None, the register will be pre-populated with bits of the correct type.
+
+**Parameters**
+
+* **size** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Optional. The number of bits to include in the register.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Optional. The name of the register. If not provided, a unique name will be auto-generated from the register type.
+* **bits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Bit*](qiskit.circuit.Bit "qiskit.circuit.Bit")*]*) – Optional. A list of Bit() instances to be used to populate the register.
+
+**Raises**
+
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if both the `size` and `bits` arguments are provided, or if neither are.
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if `size` is not valid.
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if `name` is not a valid name according to the OpenQASM spec.
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if `bits` contained duplicated bits.
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if `bits` contained bits of an incorrect type.
+
+## Attributes
+
+
+
+### bit\_type
+
+`= None`
+
+
+
+### instances\_counter
+
+`= count(0)`
+
+
+
+### name
+
+Get the register name.
+
+
+
+### name\_format
+
+`= re.compile('[a-z][a-zA-Z0-9_]*')`
+
+
+
+### prefix
+
+`= 'reg'`
+
+
+
+### size
+
+Get the register size.
+
+## Methods
+
+### index
+
+
+
+`index(bit)`
+
+Find the index of the provided bit within this register.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.SwitchCaseOp.md b/docs/api/qiskit/0.46/qiskit.circuit.SwitchCaseOp.md
new file mode 100644
index 00000000000..3d24cb66b1a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.SwitchCaseOp.md
@@ -0,0 +1,392 @@
+---
+title: SwitchCaseOp
+description: API reference for qiskit.circuit.SwitchCaseOp
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.SwitchCaseOp
+---
+
+# SwitchCaseOp
+
+
+
+`qiskit.circuit.SwitchCaseOp(target, cases, *, label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/controlflow/switch_case.py "view source code")
+
+Bases: [`ControlFlowOp`](qiskit.circuit.ControlFlowOp "qiskit.circuit.controlflow.control_flow.ControlFlowOp")
+
+A circuit operation that executes one particular circuit block based on matching a given `target` against an ordered list of `values`. The special value [`CASE_DEFAULT`](circuit#qiskit.circuit.CASE_DEFAULT "qiskit.circuit.CASE_DEFAULT") can be used to represent a default condition.
+
+This is the low-level interface for creating a switch-case statement; in general, the circuit method [`QuantumCircuit.switch()`](qiskit.circuit.QuantumCircuit#switch "qiskit.circuit.QuantumCircuit.switch") should be used as a context manager to access the builder interface. At the low level, you must ensure that all the circuit blocks contain equal numbers of qubits and clbits, and that the order the virtual bits of the containing circuit should be bound is the same for all blocks. This will likely mean that each circuit block is wider than its natural width, as each block must span the union of all the spaces covered by *any* of the blocks.
+
+**Parameters**
+
+* **target** ([*Clbit*](qiskit.circuit.Clbit "qiskit.circuit.Clbit") *|*[*ClassicalRegister*](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister") *|*[*expr.Expr*](circuit_classical#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.Expr")) – the runtime value to switch on.
+* **cases** (*Iterable\[Tuple\[Any,* [*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]]*) – an ordered iterable of the corresponding value of the `target` and the circuit block that should be executed if this is matched. There is no fall-through between blocks, and the order matters.
+
+Create a new instruction.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – instruction name
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – instruction’s qubit width
+* **num\_clbits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – instruction’s clbit width
+* **params** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*|*[*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*|*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*|ndarray|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")*]*) – list of parameters
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – instruction’s duration. it must be integer if `unit` is ‘dt’
+* **unit** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – time unit of duration
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for identifying the instruction.
+
+**Raises**
+
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – when the register is not in the correct format.
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – when the optional label is provided, but it is not a string.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.SwitchCaseOp.base_class "qiskit.circuit.SwitchCaseOp.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that [`Instruction.name`](qiskit.circuit.Instruction#name "qiskit.circuit.Instruction.name") should be a more suitable discriminator in most situations.
+
+
+
+### blocks
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### add\_decomposition
+
+
+
+`add_decomposition(decomposition)`
+
+Add a decomposition of the instruction to the SessionEquivalenceLibrary.
+
+### assemble
+
+
+
+`assemble()`
+
+Assemble a QasmQobjInstruction
+
+### broadcast\_arguments
+
+
+
+`broadcast_arguments(qargs, cargs)`
+
+Validation of the arguments.
+
+**Parameters**
+
+* **qargs** (*List*) – List of quantum bit arguments.
+* **cargs** (*List*) – List of classical bit arguments.
+
+**Yields**
+
+*Tuple(List, List)* – A tuple with single arguments.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the input is not valid. For example, the number of arguments does not match the gate expectation.
+
+### c\_if
+
+
+
+`c_if(classical, val)`
+
+Set a classical equality condition on this instruction between the register or cbit `classical` and value `val`.
+
+
+ This is a setter method, not an additive one. Calling this multiple times will silently override any previously set condition; it does not stack.
+
+
+### cases
+
+
+
+`cases()`
+
+Return a lookup table from case labels to the circuit that would be executed in that case. This object is not generally suitable for creating a new [`SwitchCaseOp`](#qiskit.circuit.SwitchCaseOp "qiskit.circuit.SwitchCaseOp") because any keys that point to the same object will not be grouped.
+
+
+ **[`SwitchCaseOp.cases_specifier()`](#qiskit.circuit.SwitchCaseOp.cases_specifier "qiskit.circuit.SwitchCaseOp.cases_specifier")**
+
+ An alternate method that produces its output in a suitable format for creating new [`SwitchCaseOp`](#qiskit.circuit.SwitchCaseOp "qiskit.circuit.SwitchCaseOp") instances.
+
+
+### cases\_specifier
+
+
+
+`cases_specifier()`
+
+Return an iterable where each element is a 2-tuple whose first element is a tuple of jump values, and whose second is the single circuit block that is associated with those values.
+
+This is an abstract specification of the jump table suitable for creating new [`SwitchCaseOp`](#qiskit.circuit.SwitchCaseOp "qiskit.circuit.SwitchCaseOp") instances.
+
+
+ **[`SwitchCaseOp.cases()`](#qiskit.circuit.SwitchCaseOp.cases "qiskit.circuit.SwitchCaseOp.cases")**
+
+ Create a lookup table that you can use for your own purposes to jump from values to the circuit that would be executed.
+
+
+**Return type**
+
+[*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")\[[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")\[[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)"), [*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")]]
+
+### copy
+
+
+
+`copy(name=None)`
+
+Copy of the instruction.
+
+**Parameters**
+
+**name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name to be given to the copied circuit, if `None` then the name stays the same.
+
+**Returns**
+
+a copy of the current instruction, with the name updated if it was provided
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this instruction.
+
+If the instruction is composite (i.e. has a definition), then its definition will be recursively inverted.
+
+Special instructions inheriting from Instruction can implement their own inverse (e.g. T and Tdg, Barrier, etc.)
+
+**Returns**
+
+a fresh instruction for the inverse
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the instruction is not composite and an inverse has not been implemented for it.
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True .IFF. instruction is parameterized else False
+
+### qasm
+
+
+
+`qasm()`
+
+Return a default OpenQASM string for the instruction.
+
+Derived instructions may override this to print in a different format (e.g. `measure q[0] -> c[0];`).
+
+
+ The method `qiskit.circuit.instruction.Instruction.qasm()` is deprecated as of qiskit-terra 0.25.0. It will be removed in the Qiskit 1.0 release. Correct exporting to OpenQASM 2 is the responsibility of a larger exporter; it cannot safely be done on an object-by-object basis without context. No replacement will be provided, because the premise is wrong.
+
+
+### repeat
+
+
+
+`repeat(n)`
+
+Creates an instruction with gate repeated n amount of times.
+
+**Parameters**
+
+**n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of times to repeat the instruction
+
+**Returns**
+
+Containing the definition.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If n \< 1.
+
+### replace\_blocks
+
+
+
+`replace_blocks(blocks)`
+
+Replace blocks and return new instruction. :param blocks: Tuple of QuantumCircuits to replace in instruction.
+
+**Returns**
+
+New ControlFlowOp with replaced blocks.
+
+**Return type**
+
+[*SwitchCaseOp*](#qiskit.circuit.SwitchCaseOp "qiskit.circuit.controlflow.switch_case.SwitchCaseOp")
+
+### reverse\_ops
+
+
+
+`reverse_ops()`
+
+For a composite instruction, reverse the order of sub-instructions.
+
+This is done by recursively reversing all sub-instructions. It does not invert any gate.
+
+**Returns**
+
+**a new instruction with**
+
+sub-instructions reversed.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### soft\_compare
+
+
+
+`soft_compare(other)`
+
+Soft comparison between gates. Their names, number of qubits, and classical bit numbers must match. The number of parameters must match. Each parameter is compared. If one is a ParameterExpression then it is not taken into account.
+
+**Parameters**
+
+**other** (*instruction*) – other instruction.
+
+**Returns**
+
+are self and other equal up to parameter expressions.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### to\_mutable
+
+
+
+`to_mutable()`
+
+Return a mutable copy of this gate.
+
+This method will return a new mutable copy of this gate instance. If a singleton instance is being used this will be a new unique instance that can be mutated. If the instance is already mutable it will be a deepcopy of that instance.
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Instruction parameters has no validation or normalization.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.WhileLoopOp.md b/docs/api/qiskit/0.46/qiskit.circuit.WhileLoopOp.md
new file mode 100644
index 00000000000..f850b0a6671
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.WhileLoopOp.md
@@ -0,0 +1,367 @@
+---
+title: WhileLoopOp
+description: API reference for qiskit.circuit.WhileLoopOp
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.WhileLoopOp
+---
+
+# WhileLoopOp
+
+
+
+`qiskit.circuit.WhileLoopOp(condition, body, label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/controlflow/while_loop.py "view source code")
+
+Bases: [`ControlFlowOp`](qiskit.circuit.ControlFlowOp "qiskit.circuit.controlflow.control_flow.ControlFlowOp")
+
+A circuit operation which repeatedly executes a subcircuit (`body`) until a condition (`condition`) evaluates as False.
+
+**Parameters**
+
+* **condition** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*ClassicalRegister*](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] |* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*Clbit*](qiskit.circuit.Clbit "qiskit.circuit.Clbit")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] |* [*expr.Expr*](circuit_classical#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.Expr")) – A condition to be checked prior to executing `body`. Can be specified as either a tuple of a `ClassicalRegister` to be tested for equality with a given `int`, or as a tuple of a `Clbit` to be compared to either a `bool` or an `int`.
+* **body** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – The loop body to be repeatedly executed.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – An optional label for identifying the instruction.
+
+The classical bits used in `condition` must be a subset of those attached to `body`.
+
+**Circuit symbol:**
+
+```python
+ ┌─────────────┐
+q_0: ┤0 ├
+ │ │
+q_1: ┤1 ├
+ │ while_loop │
+q_2: ┤2 ├
+ │ │
+c_0: ╡0 ╞
+ └─────────────┘
+```
+
+Create a new instruction.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – instruction name
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – instruction’s qubit width
+* **num\_clbits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – instruction’s clbit width
+* **params** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*|*[*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*|*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*|ndarray|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")*]*) – list of parameters
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – instruction’s duration. it must be integer if `unit` is ‘dt’
+* **unit** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – time unit of duration
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for identifying the instruction.
+
+**Raises**
+
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – when the register is not in the correct format.
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – when the optional label is provided, but it is not a string.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.WhileLoopOp.base_class "qiskit.circuit.WhileLoopOp.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that [`Instruction.name`](qiskit.circuit.Instruction#name "qiskit.circuit.Instruction.name") should be a more suitable discriminator in most situations.
+
+
+
+### blocks
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### add\_decomposition
+
+
+
+`add_decomposition(decomposition)`
+
+Add a decomposition of the instruction to the SessionEquivalenceLibrary.
+
+### assemble
+
+
+
+`assemble()`
+
+Assemble a QasmQobjInstruction
+
+### broadcast\_arguments
+
+
+
+`broadcast_arguments(qargs, cargs)`
+
+Validation of the arguments.
+
+**Parameters**
+
+* **qargs** (*List*) – List of quantum bit arguments.
+* **cargs** (*List*) – List of classical bit arguments.
+
+**Yields**
+
+*Tuple(List, List)* – A tuple with single arguments.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the input is not valid. For example, the number of arguments does not match the gate expectation.
+
+### c\_if
+
+
+
+`c_if(classical, val)`
+
+Set a classical equality condition on this instruction between the register or cbit `classical` and value `val`.
+
+
+ This is a setter method, not an additive one. Calling this multiple times will silently override any previously set condition; it does not stack.
+
+
+### copy
+
+
+
+`copy(name=None)`
+
+Copy of the instruction.
+
+**Parameters**
+
+**name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name to be given to the copied circuit, if `None` then the name stays the same.
+
+**Returns**
+
+a copy of the current instruction, with the name updated if it was provided
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this instruction.
+
+If the instruction is composite (i.e. has a definition), then its definition will be recursively inverted.
+
+Special instructions inheriting from Instruction can implement their own inverse (e.g. T and Tdg, Barrier, etc.)
+
+**Returns**
+
+a fresh instruction for the inverse
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the instruction is not composite and an inverse has not been implemented for it.
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True .IFF. instruction is parameterized else False
+
+### qasm
+
+
+
+`qasm()`
+
+Return a default OpenQASM string for the instruction.
+
+Derived instructions may override this to print in a different format (e.g. `measure q[0] -> c[0];`).
+
+
+ The method `qiskit.circuit.instruction.Instruction.qasm()` is deprecated as of qiskit-terra 0.25.0. It will be removed in the Qiskit 1.0 release. Correct exporting to OpenQASM 2 is the responsibility of a larger exporter; it cannot safely be done on an object-by-object basis without context. No replacement will be provided, because the premise is wrong.
+
+
+### repeat
+
+
+
+`repeat(n)`
+
+Creates an instruction with gate repeated n amount of times.
+
+**Parameters**
+
+**n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of times to repeat the instruction
+
+**Returns**
+
+Containing the definition.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If n \< 1.
+
+### replace\_blocks
+
+
+
+`replace_blocks(blocks)`
+
+Replace blocks and return new instruction. :param blocks: Tuple of QuantumCircuits to replace in instruction.
+
+**Returns**
+
+New ControlFlowOp with replaced blocks.
+
+### reverse\_ops
+
+
+
+`reverse_ops()`
+
+For a composite instruction, reverse the order of sub-instructions.
+
+This is done by recursively reversing all sub-instructions. It does not invert any gate.
+
+**Returns**
+
+**a new instruction with**
+
+sub-instructions reversed.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### soft\_compare
+
+
+
+`soft_compare(other)`
+
+Soft comparison between gates. Their names, number of qubits, and classical bit numbers must match. The number of parameters must match. Each parameter is compared. If one is a ParameterExpression then it is not taken into account.
+
+**Parameters**
+
+**other** (*instruction*) – other instruction.
+
+**Returns**
+
+are self and other equal up to parameter expressions.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### to\_mutable
+
+
+
+`to_mutable()`
+
+Return a mutable copy of this gate.
+
+This method will return a new mutable copy of this gate instance. If a singleton instance is being used this will be a new unique instance that can be mutated. If the instance is already mutable it will be a deepcopy of that instance.
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Instruction parameters has no validation or normalization.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.classicalfunction.BooleanExpression.md b/docs/api/qiskit/0.46/qiskit.circuit.classicalfunction.BooleanExpression.md
new file mode 100644
index 00000000000..7cc37760ed2
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.classicalfunction.BooleanExpression.md
@@ -0,0 +1,487 @@
+---
+title: BooleanExpression
+description: API reference for qiskit.circuit.classicalfunction.BooleanExpression
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.classicalfunction.BooleanExpression
+---
+
+# BooleanExpression
+
+
+
+`qiskit.circuit.classicalfunction.BooleanExpression(expression, name=None, var_order=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classicalfunction/boolean_expression.py "view source code")
+
+Bases: `ClassicalElement`
+
+The Boolean Expression gate.
+
+**Parameters**
+
+* **expression** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The logical expression string.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Optional. Instruction gate name. Otherwise part of the expression is going to be used.
+* **var\_order** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list with the order in which variables will be created. (default: by appearance)
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.classicalfunction.BooleanExpression.base_class "qiskit.circuit.classicalfunction.BooleanExpression.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### add\_decomposition
+
+
+
+`add_decomposition(decomposition)`
+
+Add a decomposition of the instruction to the SessionEquivalenceLibrary.
+
+### assemble
+
+
+
+`assemble()`
+
+Assemble a QasmQobjInstruction
+
+### broadcast\_arguments
+
+
+
+`broadcast_arguments(qargs, cargs)`
+
+Validation and handling of the arguments and its relationship.
+
+For example, `cx([q[0],q[1]], q[2])` means `cx(q[0], q[2]); cx(q[1], q[2])`. This method yields the arguments in the right grouping. In the given example:
+
+```python
+in: [[q[0],q[1]], q[2]],[]
+outs: [q[0], q[2]], []
+ [q[1], q[2]], []
+```
+
+The general broadcasting rules are:
+
+> * If len(qargs) == 1:
+>
+> ```python
+> [q[0], q[1]] -> [q[0]],[q[1]]
+> ```
+>
+> * If len(qargs) == 2:
+>
+> ```python
+> [[q[0], q[1]], [r[0], r[1]]] -> [q[0], r[0]], [q[1], r[1]]
+> [[q[0]], [r[0], r[1]]] -> [q[0], r[0]], [q[0], r[1]]
+> [[q[0], q[1]], [r[0]]] -> [q[0], r[0]], [q[1], r[0]]
+> ```
+>
+> * If len(qargs) >= 3:
+>
+> ```python
+> [q[0], q[1]], [r[0], r[1]], ...] -> [q[0], r[0], ...], [q[1], r[1], ...]
+> ```
+
+**Parameters**
+
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – List of quantum bit arguments.
+* **cargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – List of classical bit arguments.
+
+**Returns**
+
+A tuple with single arguments.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the input is not valid. For example, the number of arguments does not match the gate expectation.
+
+**Return type**
+
+[*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")\[[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)"), [list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")]]
+
+### c\_if
+
+
+
+`c_if(classical, val)`
+
+Set a classical equality condition on this instruction between the register or cbit `classical` and value `val`.
+
+
+ This is a setter method, not an additive one. Calling this multiple times will silently override any previously set condition; it does not stack.
+
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Return controlled version of gate. See [`ControlledGate`](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate") for usage.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of controls to add to gate (default: `1`)
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – optional gate label
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The control state in decimal or as a bitstring (e.g. `'111'`). If `None`, use `2**num_ctrl_qubits-1`.
+
+**Returns**
+
+Controlled version of gate. This default algorithm uses `num_ctrl_qubits-1` ancilla qubits so returns a gate of size `num_qubits + 2*num_ctrl_qubits - 1`.
+
+**Return type**
+
+[qiskit.circuit.ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – unrecognized mode or invalid ctrl\_state
+
+### copy
+
+
+
+`copy(name=None)`
+
+Copy of the instruction.
+
+**Parameters**
+
+**name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name to be given to the copied circuit, if `None` then the name stays the same.
+
+**Returns**
+
+a copy of the current instruction, with the name updated if it was provided
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### from\_dimacs\_file
+
+
+
+`classmethod from_dimacs_file(filename)`
+
+Create a BooleanExpression from the string in the DIMACS format. :param filename: A file in DIMACS format.
+
+**Returns**
+
+A gate for the input string
+
+**Return type**
+
+[BooleanExpression](#qiskit.circuit.classicalfunction.BooleanExpression "qiskit.circuit.classicalfunction.BooleanExpression")
+
+**Raises**
+
+[**FileNotFoundError**](https://docs.python.org/3/library/exceptions.html#FileNotFoundError "(in Python v3.12)") – If filename is not found.
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this instruction.
+
+If the instruction is composite (i.e. has a definition), then its definition will be recursively inverted.
+
+Special instructions inheriting from Instruction can implement their own inverse (e.g. T and Tdg, Barrier, etc.)
+
+**Returns**
+
+a fresh instruction for the inverse
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the instruction is not composite and an inverse has not been implemented for it.
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True .IFF. instruction is parameterized else False
+
+### power
+
+
+
+`power(exponent)`
+
+Creates a unitary gate as gate^exponent.
+
+**Parameters**
+
+**exponent** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Gate^exponent
+
+**Returns**
+
+To which to\_matrix is self.to\_matrix^exponent.
+
+**Return type**
+
+.library.UnitaryGate
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If Gate is not unitary
+
+### qasm
+
+
+
+`qasm()`
+
+Return a default OpenQASM string for the instruction.
+
+Derived instructions may override this to print in a different format (e.g. `measure q[0] -> c[0];`).
+
+
+ The method `qiskit.circuit.instruction.Instruction.qasm()` is deprecated as of qiskit-terra 0.25.0. It will be removed in the Qiskit 1.0 release. Correct exporting to OpenQASM 2 is the responsibility of a larger exporter; it cannot safely be done on an object-by-object basis without context. No replacement will be provided, because the premise is wrong.
+
+
+### repeat
+
+
+
+`repeat(n)`
+
+Creates an instruction with gate repeated n amount of times.
+
+**Parameters**
+
+**n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of times to repeat the instruction
+
+**Returns**
+
+Containing the definition.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If n \< 1.
+
+### reverse\_ops
+
+
+
+`reverse_ops()`
+
+For a composite instruction, reverse the order of sub-instructions.
+
+This is done by recursively reversing all sub-instructions. It does not invert any gate.
+
+**Returns**
+
+**a new instruction with**
+
+sub-instructions reversed.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### simulate
+
+
+
+`simulate(bitstring)`
+
+Evaluate the expression on a bitstring.
+
+This evaluation is done classically.
+
+**Parameters**
+
+**bitstring** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The bitstring for which to evaluate.
+
+**Returns**
+
+result of the evaluation.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### soft\_compare
+
+
+
+`soft_compare(other)`
+
+Soft comparison between gates. Their names, number of qubits, and classical bit numbers must match. The number of parameters must match. Each parameter is compared. If one is a ParameterExpression then it is not taken into account.
+
+**Parameters**
+
+**other** (*instruction*) – other instruction.
+
+**Returns**
+
+are self and other equal up to parameter expressions.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### synth
+
+
+
+`synth(registerless=True, synthesizer=None)`
+
+Synthesis the logic network into a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit").
+
+**Parameters**
+
+* **registerless** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Default `True`. If `False` uses the parameter names to create registers with those names. Otherwise, creates a circuit with a flat quantum register.
+* **synthesizer** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")*\[\[*[*BooleanExpression*](#qiskit.circuit.classicalfunction.BooleanExpression "qiskit.circuit.classicalfunction.boolean_expression.BooleanExpression")*],* [*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")*] | None*) – A callable that takes self and returns a Tweedledum circuit.
+
+**Returns**
+
+A circuit implementing the logic network.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### to\_matrix
+
+
+
+`to_matrix()`
+
+Return a Numpy.array for the gate unitary matrix.
+
+**Returns**
+
+if the Gate subclass has a matrix definition.
+
+**Return type**
+
+np.ndarray
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If a Gate subclass does not implement this method an exception will be raised when this base class method is called.
+
+### to\_mutable
+
+
+
+`to_mutable()`
+
+Return a mutable copy of this gate.
+
+This method will return a new mutable copy of this gate instance. If a singleton instance is being used this will be a new unique instance that can be mutated. If the instance is already mutable it will be a deepcopy of that instance.
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Gate parameters should be int, float, or ParameterExpression
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.classicalfunction.ClassicalFunction.md b/docs/api/qiskit/0.46/qiskit.circuit.classicalfunction.ClassicalFunction.md
new file mode 100644
index 00000000000..44a8ab5b1a7
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.classicalfunction.ClassicalFunction.md
@@ -0,0 +1,544 @@
+---
+title: ClassicalFunction
+description: API reference for qiskit.circuit.classicalfunction.ClassicalFunction
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.classicalfunction.ClassicalFunction
+---
+
+# ClassicalFunction
+
+
+
+`qiskit.circuit.classicalfunction.ClassicalFunction(source, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classicalfunction/classicalfunction.py "view source code")
+
+Bases: `ClassicalElement`
+
+Represent a classical function and its logic network.
+
+Creates a `ClassicalFunction` from Python source code in `source`.
+
+The code should be a single function with types.
+
+**Parameters**
+
+* **source** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Python code with type hints.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Optional. Default: “*classicalfunction*”. ClassicalFunction name.
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If source is not a string.
+
+## Attributes
+
+
+
+### args
+
+Returns the classicalfunction arguments
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.classicalfunction.ClassicalFunction.base_class "qiskit.circuit.classicalfunction.ClassicalFunction.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### network
+
+Returns the logical network
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### qregs
+
+The list of qregs used by the classicalfunction
+
+
+
+### scopes
+
+Returns the scope dict
+
+
+
+### truth\_table
+
+Returns (and computes) the truth table
+
+
+
+### types
+
+Dumps a list of scopes with their variables and types.
+
+**Returns**
+
+A list of scopes as dicts, where key is the variable name and value is its type.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")([dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)"))
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### add\_decomposition
+
+
+
+`add_decomposition(decomposition)`
+
+Add a decomposition of the instruction to the SessionEquivalenceLibrary.
+
+### assemble
+
+
+
+`assemble()`
+
+Assemble a QasmQobjInstruction
+
+### broadcast\_arguments
+
+
+
+`broadcast_arguments(qargs, cargs)`
+
+Validation and handling of the arguments and its relationship.
+
+For example, `cx([q[0],q[1]], q[2])` means `cx(q[0], q[2]); cx(q[1], q[2])`. This method yields the arguments in the right grouping. In the given example:
+
+```python
+in: [[q[0],q[1]], q[2]],[]
+outs: [q[0], q[2]], []
+ [q[1], q[2]], []
+```
+
+The general broadcasting rules are:
+
+> * If len(qargs) == 1:
+>
+> ```python
+> [q[0], q[1]] -> [q[0]],[q[1]]
+> ```
+>
+> * If len(qargs) == 2:
+>
+> ```python
+> [[q[0], q[1]], [r[0], r[1]]] -> [q[0], r[0]], [q[1], r[1]]
+> [[q[0]], [r[0], r[1]]] -> [q[0], r[0]], [q[0], r[1]]
+> [[q[0], q[1]], [r[0]]] -> [q[0], r[0]], [q[1], r[0]]
+> ```
+>
+> * If len(qargs) >= 3:
+>
+> ```python
+> [q[0], q[1]], [r[0], r[1]], ...] -> [q[0], r[0], ...], [q[1], r[1], ...]
+> ```
+
+**Parameters**
+
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – List of quantum bit arguments.
+* **cargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – List of classical bit arguments.
+
+**Returns**
+
+A tuple with single arguments.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the input is not valid. For example, the number of arguments does not match the gate expectation.
+
+**Return type**
+
+[*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")\[[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)"), [list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")]]
+
+### c\_if
+
+
+
+`c_if(classical, val)`
+
+Set a classical equality condition on this instruction between the register or cbit `classical` and value `val`.
+
+
+ This is a setter method, not an additive one. Calling this multiple times will silently override any previously set condition; it does not stack.
+
+
+### compile
+
+
+
+`compile()`
+
+Parses and creates the logical circuit
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Return controlled version of gate. See [`ControlledGate`](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate") for usage.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of controls to add to gate (default: `1`)
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – optional gate label
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The control state in decimal or as a bitstring (e.g. `'111'`). If `None`, use `2**num_ctrl_qubits-1`.
+
+**Returns**
+
+Controlled version of gate. This default algorithm uses `num_ctrl_qubits-1` ancilla qubits so returns a gate of size `num_qubits + 2*num_ctrl_qubits - 1`.
+
+**Return type**
+
+[qiskit.circuit.ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – unrecognized mode or invalid ctrl\_state
+
+### copy
+
+
+
+`copy(name=None)`
+
+Copy of the instruction.
+
+**Parameters**
+
+**name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name to be given to the copied circuit, if `None` then the name stays the same.
+
+**Returns**
+
+a copy of the current instruction, with the name updated if it was provided
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this instruction.
+
+If the instruction is composite (i.e. has a definition), then its definition will be recursively inverted.
+
+Special instructions inheriting from Instruction can implement their own inverse (e.g. T and Tdg, Barrier, etc.)
+
+**Returns**
+
+a fresh instruction for the inverse
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the instruction is not composite and an inverse has not been implemented for it.
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True .IFF. instruction is parameterized else False
+
+### power
+
+
+
+`power(exponent)`
+
+Creates a unitary gate as gate^exponent.
+
+**Parameters**
+
+**exponent** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Gate^exponent
+
+**Returns**
+
+To which to\_matrix is self.to\_matrix^exponent.
+
+**Return type**
+
+.library.UnitaryGate
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If Gate is not unitary
+
+### qasm
+
+
+
+`qasm()`
+
+Return a default OpenQASM string for the instruction.
+
+Derived instructions may override this to print in a different format (e.g. `measure q[0] -> c[0];`).
+
+
+ The method `qiskit.circuit.instruction.Instruction.qasm()` is deprecated as of qiskit-terra 0.25.0. It will be removed in the Qiskit 1.0 release. Correct exporting to OpenQASM 2 is the responsibility of a larger exporter; it cannot safely be done on an object-by-object basis without context. No replacement will be provided, because the premise is wrong.
+
+
+### repeat
+
+
+
+`repeat(n)`
+
+Creates an instruction with gate repeated n amount of times.
+
+**Parameters**
+
+**n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of times to repeat the instruction
+
+**Returns**
+
+Containing the definition.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If n \< 1.
+
+### reverse\_ops
+
+
+
+`reverse_ops()`
+
+For a composite instruction, reverse the order of sub-instructions.
+
+This is done by recursively reversing all sub-instructions. It does not invert any gate.
+
+**Returns**
+
+**a new instruction with**
+
+sub-instructions reversed.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### simulate
+
+
+
+`simulate(bitstring)`
+
+Evaluate the expression on a bitstring.
+
+This evaluation is done classically.
+
+**Parameters**
+
+**bitstring** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The bitstring for which to evaluate.
+
+**Returns**
+
+result of the evaluation.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### simulate\_all
+
+
+
+`simulate_all()`
+
+Returns a truth table.
+
+**Returns**
+
+a bitstring with a truth table
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### soft\_compare
+
+
+
+`soft_compare(other)`
+
+Soft comparison between gates. Their names, number of qubits, and classical bit numbers must match. The number of parameters must match. Each parameter is compared. If one is a ParameterExpression then it is not taken into account.
+
+**Parameters**
+
+**other** (*instruction*) – other instruction.
+
+**Returns**
+
+are self and other equal up to parameter expressions.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### synth
+
+
+
+`synth(registerless=True, synthesizer=None)`
+
+Synthesis the logic network into a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit").
+
+**Parameters**
+
+* **registerless** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Default `True`. If `False` uses the parameter names to create
+* **Otherwise** (*registers with those names.*) –
+* **register.** (*creates a circuit with a flat quantum*) –
+* **synthesizer** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")*\[\[ClassicalElement],* [*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")*] | None*) – Optional. If None tweedledum’s pkrm\_synth is used.
+
+**Returns**
+
+A circuit implementing the logic network.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### to\_matrix
+
+
+
+`to_matrix()`
+
+Return a Numpy.array for the gate unitary matrix.
+
+**Returns**
+
+if the Gate subclass has a matrix definition.
+
+**Return type**
+
+np.ndarray
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If a Gate subclass does not implement this method an exception will be raised when this base class method is called.
+
+### to\_mutable
+
+
+
+`to_mutable()`
+
+Return a mutable copy of this gate.
+
+This method will return a new mutable copy of this gate instance. If a singleton instance is being used this will be a new unique instance that can be mutated. If the instance is already mutable it will be a deepcopy of that instance.
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Gate parameters should be int, float, or ParameterExpression
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.classicalfunction.ClassicalFunctionCompilerTypeError.md b/docs/api/qiskit/0.46/qiskit.circuit.classicalfunction.ClassicalFunctionCompilerTypeError.md
new file mode 100644
index 00000000000..94b9c516a35
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.classicalfunction.ClassicalFunctionCompilerTypeError.md
@@ -0,0 +1,20 @@
+---
+title: ClassicalFunctionCompilerTypeError
+description: API reference for qiskit.circuit.classicalfunction.ClassicalFunctionCompilerTypeError
+in_page_toc_min_heading_level: 1
+python_api_type: exception
+python_api_name: qiskit.circuit.classicalfunction.ClassicalFunctionCompilerTypeError
+---
+
+
+
+# qiskit.circuit.classicalfunction.ClassicalFunctionCompilerTypeError
+
+
+
+`qiskit.circuit.classicalfunction.ClassicalFunctionCompilerTypeError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classicalfunction/exceptions.py "view source code")
+
+ClassicalFunction compiler type error. The classicalfunction function fails at type checking time.
+
+Set the error message.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.classicalfunction.ClassicalFunctionParseError.md b/docs/api/qiskit/0.46/qiskit.circuit.classicalfunction.ClassicalFunctionParseError.md
new file mode 100644
index 00000000000..e9d783380b1
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.classicalfunction.ClassicalFunctionParseError.md
@@ -0,0 +1,20 @@
+---
+title: ClassicalFunctionParseError
+description: API reference for qiskit.circuit.classicalfunction.ClassicalFunctionParseError
+in_page_toc_min_heading_level: 1
+python_api_type: exception
+python_api_name: qiskit.circuit.classicalfunction.ClassicalFunctionParseError
+---
+
+
+
+# qiskit.circuit.classicalfunction.ClassicalFunctionParseError
+
+
+
+`qiskit.circuit.classicalfunction.ClassicalFunctionParseError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/classicalfunction/exceptions.py "view source code")
+
+ClassicalFunction compiler parse error. The classicalfunction function fails at parsing time.
+
+Set the error message.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.AND.md b/docs/api/qiskit/0.46/qiskit.circuit.library.AND.md
new file mode 100644
index 00000000000..612e6a9994f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.AND.md
@@ -0,0 +1,227 @@
+---
+title: AND
+description: API reference for qiskit.circuit.library.AND
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.AND
+---
+
+# AND
+
+
+
+`qiskit.circuit.library.AND(num_variable_qubits, flags=None, mcx_mode='noancilla')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/boolean_logic/quantum_and.py "view source code")
+
+Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+A circuit implementing the logical AND operation on a number of qubits.
+
+For the AND operation the state $|1\rangle$ is interpreted as `True`. The result qubit is flipped, if the state of all variable qubits is `True`. In this format, the AND operation equals a multi-controlled X gate, which is controlled on all variable qubits. Using a list of flags however, qubits can be skipped or negated. Practically, the flags allow to skip controls or to apply pre- and post-X gates to the negated qubits.
+
+The AND gate without special flags equals the multi-controlled-X gate:
+
+
+
+Using flags we can negate qubits or skip them. For instance, if we have 5 qubits and want to return `True` if the first qubit is `False` and the last two are `True` we use the flags `[-1, 0, 0, 1, 1]`.
+
+
+
+Create a new logical AND circuit.
+
+**Parameters**
+
+* **num\_variable\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The qubits of which the OR is computed. The result will be written into an additional result qubit.
+* **flags** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – A list of +1/0/-1 marking negations or omissions of qubits.
+* **mcx\_mode** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The mode to be used to implement the multi-controlled X gate.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 193`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.Barrier.md b/docs/api/qiskit/0.46/qiskit.circuit.library.Barrier.md
new file mode 100644
index 00000000000..dcc73097c35
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.Barrier.md
@@ -0,0 +1,311 @@
+---
+title: Barrier
+description: API reference for qiskit.circuit.library.Barrier
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.Barrier
+---
+
+# Barrier
+
+
+
+`qiskit.circuit.library.Barrier(num_qubits, label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/barrier.py "view source code")
+
+Bases: [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")
+
+Barrier instruction.
+
+A barrier is a visual indicator of the grouping of a circuit section. It also acts as a directive for circuit compilation to separate pieces of a circuit so that any optimizations or re-writes are constrained to only act between barriers.
+
+Create new barrier instruction.
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of qubits for the barrier type \[Default: 0].
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – the barrier label
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – if barrier label is invalid.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.Barrier.base_class "qiskit.circuit.library.Barrier.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### add\_decomposition
+
+
+
+`add_decomposition(decomposition)`
+
+Add a decomposition of the instruction to the SessionEquivalenceLibrary.
+
+### assemble
+
+
+
+`assemble()`
+
+Assemble a QasmQobjInstruction
+
+### broadcast\_arguments
+
+
+
+`broadcast_arguments(qargs, cargs)`
+
+Validation of the arguments.
+
+**Parameters**
+
+* **qargs** (*List*) – List of quantum bit arguments.
+* **cargs** (*List*) – List of classical bit arguments.
+
+**Yields**
+
+*Tuple(List, List)* – A tuple with single arguments.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the input is not valid. For example, the number of arguments does not match the gate expectation.
+
+### c\_if
+
+
+
+`c_if(classical, val)`
+
+Set a classical equality condition on this instruction between the register or cbit `classical` and value `val`.
+
+
+ This is a setter method, not an additive one. Calling this multiple times will silently override any previously set condition; it does not stack.
+
+
+### copy
+
+
+
+`copy(name=None)`
+
+Copy of the instruction.
+
+**Parameters**
+
+**name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name to be given to the copied circuit, if `None` then the name stays the same.
+
+**Returns**
+
+a copy of the current instruction, with the name updated if it was provided
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### inverse
+
+
+
+`inverse()`
+
+Special case. Return self.
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True .IFF. instruction is parameterized else False
+
+### qasm
+
+
+
+`qasm()`
+
+Return a default OpenQASM string for the instruction.
+
+Derived instructions may override this to print in a different format (e.g. `measure q[0] -> c[0];`).
+
+
+ The method `qiskit.circuit.instruction.Instruction.qasm()` is deprecated as of qiskit-terra 0.25.0. It will be removed in the Qiskit 1.0 release. Correct exporting to OpenQASM 2 is the responsibility of a larger exporter; it cannot safely be done on an object-by-object basis without context. No replacement will be provided, because the premise is wrong.
+
+
+### repeat
+
+
+
+`repeat(n)`
+
+Creates an instruction with gate repeated n amount of times.
+
+**Parameters**
+
+**n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of times to repeat the instruction
+
+**Returns**
+
+Containing the definition.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If n \< 1.
+
+### reverse\_ops
+
+
+
+`reverse_ops()`
+
+For a composite instruction, reverse the order of sub-instructions.
+
+This is done by recursively reversing all sub-instructions. It does not invert any gate.
+
+**Returns**
+
+**a new instruction with**
+
+sub-instructions reversed.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### soft\_compare
+
+
+
+`soft_compare(other)`
+
+Soft comparison between gates. Their names, number of qubits, and classical bit numbers must match. The number of parameters must match. Each parameter is compared. If one is a ParameterExpression then it is not taken into account.
+
+**Parameters**
+
+**other** (*instruction*) – other instruction.
+
+**Returns**
+
+are self and other equal up to parameter expressions.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### to\_mutable
+
+
+
+`to_mutable()`
+
+Return a mutable copy of this gate.
+
+This method will return a new mutable copy of this gate instance. If a singleton instance is being used this will be a new unique instance that can be mutated. If the instance is already mutable it will be a deepcopy of that instance.
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Instruction parameters has no validation or normalization.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.C3SXGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.C3SXGate.md
new file mode 100644
index 00000000000..4afb068188b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.C3SXGate.md
@@ -0,0 +1,176 @@
+---
+title: C3SXGate
+description: API reference for qiskit.circuit.library.C3SXGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.C3SXGate
+---
+
+# C3SXGate
+
+
+
+`qiskit.circuit.library.C3SXGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/x.py "view source code")
+
+Bases: [`SingletonControlledGate`](circuit_singleton#qiskit.circuit.singleton.SingletonControlledGate "qiskit.circuit.singleton.SingletonControlledGate")
+
+The 3-qubit controlled sqrt-X gate.
+
+This implementation is based on Page 17 of \[1].
+
+**References**
+
+\[1] Barenco et al., 1995. [https://arxiv.org/pdf/quant-ph/9503016.pdf](https://arxiv.org/pdf/quant-ph/9503016.pdf)
+
+Create a new 3-qubit controlled sqrt-X gate.
+
+**Parameters**
+
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for the gate \[Default: None]
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – control state expressed as integer, string (e.g. ‘110’), or None. If None, use all 1s.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.C3SXGate.base_class "qiskit.circuit.library.C3SXGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### qasm
+
+
+
+`qasm()`
+
+
+ The method `qiskit.circuit.library.standard_gates.x.C3SXGate.qasm()` is deprecated as of qiskit-terra 0.25.0. It will be removed in the Qiskit 1.0 release.
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.C3XGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.C3XGate.md
new file mode 100644
index 00000000000..b36568887b0
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.C3XGate.md
@@ -0,0 +1,187 @@
+---
+title: C3XGate
+description: API reference for qiskit.circuit.library.C3XGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.C3XGate
+---
+
+# C3XGate
+
+
+
+`qiskit.circuit.library.C3XGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/x.py "view source code")
+
+Bases: [`SingletonControlledGate`](circuit_singleton#qiskit.circuit.singleton.SingletonControlledGate "qiskit.circuit.singleton.SingletonControlledGate")
+
+The X gate controlled on 3 qubits.
+
+This implementation uses $\sqrt{T}$ and 14 CNOT gates.
+
+Create a new 3-qubit controlled X gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.C3XGate.base_class "qiskit.circuit.library.C3XGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Controlled version of this gate.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of control qubits.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for the gate \[Default: None]
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – control state expressed as integer, string (e.g. ‘110’), or None. If None, use all 1s.
+
+**Returns**
+
+controlled version of this gate.
+
+**Return type**
+
+[ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this gate. The C4X is its own inverse.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.C4XGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.C4XGate.md
new file mode 100644
index 00000000000..6df286171a5
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.C4XGate.md
@@ -0,0 +1,191 @@
+---
+title: C4XGate
+description: API reference for qiskit.circuit.library.C4XGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.C4XGate
+---
+
+# C4XGate
+
+
+
+`qiskit.circuit.library.C4XGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/x.py "view source code")
+
+Bases: [`SingletonControlledGate`](circuit_singleton#qiskit.circuit.singleton.SingletonControlledGate "qiskit.circuit.singleton.SingletonControlledGate")
+
+The 4-qubit controlled X gate.
+
+This implementation is based on Page 21, Lemma 7.5, of \[1], with the use of the relative phase version of c3x, the rc3x \[2].
+
+**References**
+
+\[1] Barenco et al., 1995. [https://arxiv.org/pdf/quant-ph/9503016.pdf](https://arxiv.org/pdf/quant-ph/9503016.pdf) \[2] Maslov, 2015. [https://arxiv.org/abs/1508.03273](https://arxiv.org/abs/1508.03273)
+
+Create a new 4-qubit controlled X gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.C4XGate.base_class "qiskit.circuit.library.C4XGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Controlled version of this gate.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of control qubits.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for the gate \[Default: None]
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – control state expressed as integer, string (e.g. ‘110’), or None. If None, use all 1s.
+
+**Returns**
+
+controlled version of this gate.
+
+**Return type**
+
+[ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this gate. The C4X is its own inverse.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.CCXGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.CCXGate.md
new file mode 100644
index 00000000000..0c6169baeae
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.CCXGate.md
@@ -0,0 +1,243 @@
+---
+title: CCXGate
+description: API reference for qiskit.circuit.library.CCXGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.CCXGate
+---
+
+# CCXGate
+
+
+
+`qiskit.circuit.library.CCXGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/x.py "view source code")
+
+Bases: [`SingletonControlledGate`](circuit_singleton#qiskit.circuit.singleton.SingletonControlledGate "qiskit.circuit.singleton.SingletonControlledGate")
+
+CCX gate, also known as Toffoli gate.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`ccx()`](qiskit.circuit.QuantumCircuit#ccx "qiskit.circuit.QuantumCircuit.ccx") and [`toffoli()`](qiskit.circuit.QuantumCircuit#toffoli "qiskit.circuit.QuantumCircuit.toffoli") methods.
+
+**Circuit symbol:**
+
+```python
+q_0: ──■──
+ │
+q_1: ──■──
+ ┌─┴─┐
+q_2: ┤ X ├
+ └───┘
+```
+
+**Matrix representation:**
+
+$$
+CCX q_0, q_1, q_2 =
+ I \otimes I \otimes |0 \rangle \langle 0| + CX \otimes |1 \rangle \langle 1| =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 & 0 & 0 & 0 & 0\\
+ 0 & 1 & 0 & 0 & 0 & 0 & 0 & 0\\
+ 0 & 0 & 1 & 0 & 0 & 0 & 0 & 0\\
+ 0 & 0 & 0 & 0 & 0 & 0 & 0 & 1\\
+ 0 & 0 & 0 & 0 & 1 & 0 & 0 & 0\\
+ 0 & 0 & 0 & 0 & 0 & 1 & 0 & 0\\
+ 0 & 0 & 0 & 0 & 0 & 0 & 1 & 0\\
+ 0 & 0 & 0 & 1 & 0 & 0 & 0 & 0
+ \end{pmatrix}
+$$
+
+
+ In Qiskit’s convention, higher qubit indices are more significant (little endian convention). In many textbooks, controlled gates are presented with the assumption of more significant qubits as control, which in our case would be q\_2 and q\_1. Thus a textbook matrix for this gate will be:
+
+ ```python
+ ┌───┐
+ q_0: ┤ X ├
+ └─┬─┘
+ q_1: ──■──
+ │
+ q_2: ──■──
+ ```
+
+ $$
+ CCX\ q_2, q_1, q_0 =
+ |0 \rangle \langle 0| \otimes I \otimes I + |1 \rangle \langle 1| \otimes CX =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 & 0 & 0 & 0 & 0\\
+ 0 & 1 & 0 & 0 & 0 & 0 & 0 & 0\\
+ 0 & 0 & 1 & 0 & 0 & 0 & 0 & 0\\
+ 0 & 0 & 0 & 1 & 0 & 0 & 0 & 0\\
+ 0 & 0 & 0 & 0 & 1 & 0 & 0 & 0\\
+ 0 & 0 & 0 & 0 & 0 & 1 & 0 & 0\\
+ 0 & 0 & 0 & 0 & 0 & 0 & 0 & 1\\
+ 0 & 0 & 0 & 0 & 0 & 0 & 1 & 0
+ \end{pmatrix}
+ $$
+
+
+Create new CCX gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.CCXGate.base_class "qiskit.circuit.library.CCXGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Controlled version of this gate.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of control qubits.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for the gate \[Default: None]
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – control state expressed as integer, string (e.g. ‘110’), or None. If None, use all 1s.
+
+**Returns**
+
+controlled version of this gate.
+
+**Return type**
+
+[ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+### inverse
+
+
+
+`inverse()`
+
+Return an inverted CCX gate (also a CCX).
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.CCZGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.CCZGate.md
new file mode 100644
index 00000000000..53fd3661a21
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.CCZGate.md
@@ -0,0 +1,196 @@
+---
+title: CCZGate
+description: API reference for qiskit.circuit.library.CCZGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.CCZGate
+---
+
+# CCZGate
+
+
+
+`qiskit.circuit.library.CCZGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/z.py "view source code")
+
+Bases: [`SingletonControlledGate`](circuit_singleton#qiskit.circuit.singleton.SingletonControlledGate "qiskit.circuit.singleton.SingletonControlledGate")
+
+CCZ gate.
+
+This is a symmetric gate.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`ccz()`](qiskit.circuit.QuantumCircuit#ccz "qiskit.circuit.QuantumCircuit.ccz") method.
+
+**Circuit symbol:**
+
+```python
+q_0: ─■─
+ │
+q_1: ─■─
+ │
+q_2: ─■─
+```
+
+**Matrix representation:**
+
+$$
+CCZ\ q_0, q_1, q_2 =
+ I \otimes I \otimes |0\rangle\langle 0| + CZ \otimes |1\rangle\langle 1| =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 & 0 & 0 & 0 & 0 \\
+ 0 & 1 & 0 & 0 & 0 & 0 & 0 & 0 \\
+ 0 & 0 & 1 & 0 & 0 & 0 & 0 & 0 \\
+ 0 & 0 & 0 & 1 & 0 & 0 & 0 & 0 \\
+ 0 & 0 & 0 & 0 & 1 & 0 & 0 & 0 \\
+ 0 & 0 & 0 & 0 & 0 & 1 & 0 & 0 \\
+ 0 & 0 & 0 & 0 & 0 & 0 & 1 & 0 \\
+ 0 & 0 & 0 & 0 & 0 & 0 & 0 & -1
+ \end{pmatrix}
+$$
+
+In the computational basis, this gate flips the phase of the target qubit if the control qubits are in the $|11\rangle$ state.
+
+Create new CCZ gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.CCZGate.base_class "qiskit.circuit.library.CCZGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted CCZ gate (itself).
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.CDKMRippleCarryAdder.md b/docs/api/qiskit/0.46/qiskit.circuit.library.CDKMRippleCarryAdder.md
new file mode 100644
index 00000000000..d21cd10c0f7
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.CDKMRippleCarryAdder.md
@@ -0,0 +1,283 @@
+---
+title: CDKMRippleCarryAdder
+description: API reference for qiskit.circuit.library.CDKMRippleCarryAdder
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.CDKMRippleCarryAdder
+---
+
+# CDKMRippleCarryAdder
+
+
+
+`qiskit.circuit.library.CDKMRippleCarryAdder(num_state_qubits, kind='full', name='CDKMRippleCarryAdder')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/arithmetic/adders/cdkm_ripple_carry_adder.py "view source code")
+
+Bases: `Adder`
+
+A ripple-carry circuit to perform in-place addition on two qubit registers.
+
+As an example, a ripple-carry adder circuit that performs addition on two 3-qubit sized registers with a carry-in bit (`kind="full"`) is as follows:
+
+```python
+ ┌──────┐ ┌──────┐
+ cin_0: ┤2 ├─────────────────────────────────────┤2 ├
+ │ │┌──────┐ ┌──────┐│ │
+ a_0: ┤0 ├┤2 ├─────────────────────┤2 ├┤0 ├
+ │ ││ │┌──────┐ ┌──────┐│ ││ │
+ a_1: ┤ MAJ ├┤0 ├┤2 ├─────┤2 ├┤0 ├┤ UMA ├
+ │ ││ ││ │ │ ││ ││ │
+ a_2: ┤ ├┤ MAJ ├┤0 ├──■──┤0 ├┤ UMA ├┤ ├
+ │ ││ ││ │ │ │ ││ ││ │
+ b_0: ┤1 ├┤ ├┤ MAJ ├──┼──┤ UMA ├┤ ├┤1 ├
+ └──────┘│ ││ │ │ │ ││ │└──────┘
+ b_1: ────────┤1 ├┤ ├──┼──┤ ├┤1 ├────────
+ └──────┘│ │ │ │ │└──────┘
+ b_2: ────────────────┤1 ├──┼──┤1 ├────────────────
+ └──────┘┌─┴─┐└──────┘
+cout_0: ────────────────────────┤ X ├────────────────────────
+ └───┘
+```
+
+Here *MAJ* and *UMA* gates correspond to the gates introduced in \[1]. Note that in this implementation the input register qubits are ordered as all qubits from the first input register, followed by all qubits from the second input register.
+
+Two different kinds of adders are supported. By setting the `kind` argument, you can also choose a half-adder, which doesn’t have a carry-in, and a fixed-sized-adder, which has neither carry-in nor carry-out, and thus acts on fixed register sizes. Unlike the full-adder, these circuits need one additional helper qubit.
+
+The circuit diagram for the fixed-point adder (`kind="fixed"`) on 3-qubit sized inputs is
+
+```python
+ ┌──────┐┌──────┐ ┌──────┐┌──────┐
+ a_0: ┤0 ├┤2 ├────────────────┤2 ├┤0 ├
+ │ ││ │┌──────┐┌──────┐│ ││ │
+ a_1: ┤ ├┤0 ├┤2 ├┤2 ├┤0 ├┤ ├
+ │ ││ ││ ││ ││ ││ │
+ a_2: ┤ ├┤ MAJ ├┤0 ├┤0 ├┤ UMA ├┤ ├
+ │ ││ ││ ││ ││ ││ │
+ b_0: ┤1 MAJ ├┤ ├┤ MAJ ├┤ UMA ├┤ ├┤1 UMA ├
+ │ ││ ││ ││ ││ ││ │
+ b_1: ┤ ├┤1 ├┤ ├┤ ├┤1 ├┤ ├
+ │ │└──────┘│ ││ │└──────┘│ │
+ b_2: ┤ ├────────┤1 ├┤1 ├────────┤ ├
+ │ │ └──────┘└──────┘ │ │
+help_0: ┤2 ├────────────────────────────────┤2 ├
+ └──────┘ └──────┘
+```
+
+It has one less qubit than the full-adder since it doesn’t have the carry-out, but uses a helper qubit instead of the carry-in, so it only has one less qubit, not two.
+
+**References:**
+
+\[1] Cuccaro et al., A new quantum ripple-carry addition circuit, 2004. [arXiv:quant-ph/0410184](https://arxiv.org/pdf/quant-ph/0410184.pdf)
+
+\[2] Vedral et al., Quantum Networks for Elementary Arithmetic Operations, 1995. [arXiv:quant-ph/9511018](https://arxiv.org/pdf/quant-ph/9511018.pdf)
+
+**Parameters**
+
+* **num\_state\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of qubits in either input register for state $|a\rangle$ or $|b\rangle$. The two input registers must have the same number of qubits.
+* **kind** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The kind of adder, can be `'full'` for a full adder, `'half'` for a half adder, or `'fixed'` for a fixed-sized adder. A full adder includes both carry-in and carry-out, a half only carry-out, and a fixed-sized adder neither carry-in nor carry-out.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the circuit object.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `num_state_qubits` is lower than 1.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 159`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### num\_state\_qubits
+
+The number of state qubits, i.e. the number of bits in each input register.
+
+**Returns**
+
+The number of state qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.CHGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.CHGate.md
new file mode 100644
index 00000000000..8093f61659f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.CHGate.md
@@ -0,0 +1,211 @@
+---
+title: CHGate
+description: API reference for qiskit.circuit.library.CHGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.CHGate
+---
+
+# CHGate
+
+
+
+`qiskit.circuit.library.CHGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/h.py "view source code")
+
+Bases: [`SingletonControlledGate`](circuit_singleton#qiskit.circuit.singleton.SingletonControlledGate "qiskit.circuit.singleton.SingletonControlledGate")
+
+Controlled-Hadamard gate.
+
+Applies a Hadamard on the target qubit if the control is in the $|1\rangle$ state.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`ch()`](qiskit.circuit.QuantumCircuit#ch "qiskit.circuit.QuantumCircuit.ch") method.
+
+**Circuit symbol:**
+
+```python
+q_0: ──■──
+ ┌─┴─┐
+q_1: ┤ H ├
+ └───┘
+```
+
+**Matrix Representation:**
+
+$$
+CH\ q_0, q_1 =
+ I \otimes |0\rangle\langle 0| + H \otimes |1\rangle\langle 1| =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & \frac{1}{\sqrt{2}} & 0 & \frac{1}{\sqrt{2}} \\
+ 0 & 0 & 1 & 0 \\
+ 0 & \frac{1}{\sqrt{2}} & 0 & -\frac{1}{\sqrt{2}}
+ \end{pmatrix}
+$$
+
+
+ In Qiskit’s convention, higher qubit indices are more significant (little endian convention). In many textbooks, controlled gates are presented with the assumption of more significant qubits as control, which in our case would be q\_1. Thus a textbook matrix for this gate will be:
+
+ ```python
+ ┌───┐
+ q_0: ┤ H ├
+ └─┬─┘
+ q_1: ──■──
+ ```
+
+ $$
+ CH\ q_1, q_0 =
+ |0\rangle\langle 0| \otimes I + |1\rangle\langle 1| \otimes H =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & 1 & 0 & 0 \\
+ 0 & 0 & \frac{1}{\sqrt{2}} & \frac{1}{\sqrt{2}} \\
+ 0 & 0 & \frac{1}{\sqrt{2}} & -\frac{1}{\sqrt{2}}
+ \end{pmatrix}
+ $$
+
+
+Create new CH gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.CHGate.base_class "qiskit.circuit.library.CHGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted CH gate (itself).
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.CPhaseGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.CPhaseGate.md
new file mode 100644
index 00000000000..caa15cce20f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.CPhaseGate.md
@@ -0,0 +1,222 @@
+---
+title: CPhaseGate
+description: API reference for qiskit.circuit.library.CPhaseGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.CPhaseGate
+---
+
+# CPhaseGate
+
+
+
+`qiskit.circuit.library.CPhaseGate(theta, label=None, ctrl_state=None, *, duration=None, unit='dt', _base_label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/p.py "view source code")
+
+Bases: [`ControlledGate`](qiskit.circuit.ControlledGate "qiskit.circuit.controlledgate.ControlledGate")
+
+Controlled-Phase gate.
+
+This is a diagonal and symmetric gate that induces a phase on the state of the target qubit, depending on the control state.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`cp()`](qiskit.circuit.QuantumCircuit#cp "qiskit.circuit.QuantumCircuit.cp") method.
+
+**Circuit symbol:**
+
+```python
+q_0: ─■──
+ │λ
+q_1: ─■──
+```
+
+**Matrix representation:**
+
+$$
+CPhase =
+ I \otimes |0\rangle\langle 0| + P \otimes |1\rangle\langle 1| =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & 1 & 0 & 0 \\
+ 0 & 0 & 1 & 0 \\
+ 0 & 0 & 0 & e^{i\lambda}
+ \end{pmatrix}
+$$
+
+
+ `CRZGate`: Due to the global phase difference in the matrix definitions of Phase and RZ, CPhase and CRZ are different gates with a relative phase difference.
+
+
+Create new CPhase gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.CPhaseGate.base_class "qiskit.circuit.library.CPhaseGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Controlled version of this gate.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of control qubits.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for the gate \[Default: None]
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – control state expressed as integer, string (e.g. ‘110’), or None. If None, use all 1s.
+
+**Returns**
+
+controlled version of this gate.
+
+**Return type**
+
+[ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted CPhase gate ($CPhase(\lambda)^{\dagger} = CPhase(-\lambda)$)
+
+### power
+
+
+
+`power(exponent)`
+
+Raise gate to a power.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.CRXGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.CRXGate.md
new file mode 100644
index 00000000000..b9ebc221b24
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.CRXGate.md
@@ -0,0 +1,213 @@
+---
+title: CRXGate
+description: API reference for qiskit.circuit.library.CRXGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.CRXGate
+---
+
+# CRXGate
+
+
+
+`qiskit.circuit.library.CRXGate(theta, label=None, ctrl_state=None, *, duration=None, unit='dt', _base_label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/rx.py "view source code")
+
+Bases: [`ControlledGate`](qiskit.circuit.ControlledGate "qiskit.circuit.controlledgate.ControlledGate")
+
+Controlled-RX gate.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`crx()`](qiskit.circuit.QuantumCircuit#crx "qiskit.circuit.QuantumCircuit.crx") method.
+
+**Circuit symbol:**
+
+```python
+q_0: ────■────
+ ┌───┴───┐
+q_1: ┤ Rx(ϴ) ├
+ └───────┘
+```
+
+**Matrix representation:**
+
+$$
+\newcommand{\rotationangle}{\frac{\theta}{2}}
+
+CRX(\theta)\ q_0, q_1 =
+ I \otimes |0\rangle\langle 0| + RX(\theta) \otimes |1\rangle\langle 1| =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & \cos\left(\rotationangle\right) & 0 & -i\sin\left(\rotationangle\right) \\
+ 0 & 0 & 1 & 0 \\
+ 0 & -i\sin\left(\rotationangle\right) & 0 & \cos\left(\rotationangle\right)
+ \end{pmatrix}
+$$
+
+
+ In Qiskit’s convention, higher qubit indices are more significant (little endian convention). In many textbooks, controlled gates are presented with the assumption of more significant qubits as control, which in our case would be q\_1. Thus a textbook matrix for this gate will be:
+
+ ```python
+ ┌───────┐
+ q_0: ┤ Rx(ϴ) ├
+ └───┬───┘
+ q_1: ────■────
+ ```
+
+ $$
+ \newcommand{\rotationangle}{\frac{\theta}{2}}
+
+ CRX(\theta)\ q_1, q_0 =
+ |0\rangle\langle0| \otimes I + |1\rangle\langle1| \otimes RX(\theta) =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & 1 & 0 & 0 \\
+ 0 & 0 & \cos\left(\rotationangle\right) & -i\sin\left(\rotationangle\right) \\
+ 0 & 0 & -i\sin\left(\rotationangle\right) & \cos\left(\rotationangle\right)
+ \end{pmatrix}
+ $$
+
+
+Create new CRX gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.CRXGate.base_class "qiskit.circuit.library.CRXGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverse CRX gate (i.e. with the negative rotation angle).
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.CRYGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.CRYGate.md
new file mode 100644
index 00000000000..5e5413f5c56
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.CRYGate.md
@@ -0,0 +1,213 @@
+---
+title: CRYGate
+description: API reference for qiskit.circuit.library.CRYGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.CRYGate
+---
+
+# CRYGate
+
+
+
+`qiskit.circuit.library.CRYGate(theta, label=None, ctrl_state=None, *, duration=None, unit='dt', _base_label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/ry.py "view source code")
+
+Bases: [`ControlledGate`](qiskit.circuit.ControlledGate "qiskit.circuit.controlledgate.ControlledGate")
+
+Controlled-RY gate.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`cry()`](qiskit.circuit.QuantumCircuit#cry "qiskit.circuit.QuantumCircuit.cry") method.
+
+**Circuit symbol:**
+
+```python
+q_0: ────■────
+ ┌───┴───┐
+q_1: ┤ Ry(ϴ) ├
+ └───────┘
+```
+
+**Matrix representation:**
+
+$$
+\newcommand{\rotationangle}{\frac{\theta}{2}}
+
+CRY(\theta)\ q_0, q_1 =
+ I \otimes |0\rangle\langle 0| + RY(\theta) \otimes |1\rangle\langle 1| =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & \cos\left(\rotationangle\right) & 0 & -\sin\left(\rotationangle\right) \\
+ 0 & 0 & 1 & 0 \\
+ 0 & \sin\left(\rotationangle\right) & 0 & \cos\left(\rotationangle\right)
+ \end{pmatrix}
+$$
+
+
+ In Qiskit’s convention, higher qubit indices are more significant (little endian convention). In many textbooks, controlled gates are presented with the assumption of more significant qubits as control, which in our case would be q\_1. Thus a textbook matrix for this gate will be:
+
+ ```python
+ ┌───────┐
+ q_0: ┤ Ry(ϴ) ├
+ └───┬───┘
+ q_1: ────■────
+ ```
+
+ $$
+ \newcommand{\rotationangle}{\frac{\theta}{2}}
+
+ CRY(\theta)\ q_1, q_0 =
+ |0\rangle\langle 0| \otimes I + |1\rangle\langle 1| \otimes RY(\theta) =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & 1 & 0 & 0 \\
+ 0 & 0 & \cos\left(\rotationangle\right) & -\sin\left(\rotationangle\right) \\
+ 0 & 0 & \sin\left(\rotationangle\right) & \cos\left(\rotationangle\right)
+ \end{pmatrix}
+ $$
+
+
+Create new CRY gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.CRYGate.base_class "qiskit.circuit.library.CRYGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverse CRY gate (i.e. with the negative rotation angle).
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.CRZGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.CRZGate.md
new file mode 100644
index 00000000000..3ecf0b95ed1
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.CRZGate.md
@@ -0,0 +1,215 @@
+---
+title: CRZGate
+description: API reference for qiskit.circuit.library.CRZGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.CRZGate
+---
+
+# CRZGate
+
+
+
+`qiskit.circuit.library.CRZGate(theta, label=None, ctrl_state=None, *, duration=None, unit='dt', _base_label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/rz.py "view source code")
+
+Bases: [`ControlledGate`](qiskit.circuit.ControlledGate "qiskit.circuit.controlledgate.ControlledGate")
+
+Controlled-RZ gate.
+
+This is a diagonal but non-symmetric gate that induces a phase on the state of the target qubit, depending on the control state.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`crz()`](qiskit.circuit.QuantumCircuit#crz "qiskit.circuit.QuantumCircuit.crz") method.
+
+**Circuit symbol:**
+
+```python
+q_0: ────■────
+ ┌───┴───┐
+q_1: ┤ Rz(λ) ├
+ └───────┘
+```
+
+**Matrix representation:**
+
+$$
+CRZ(\lambda)\ q_0, q_1 =
+ I \otimes |0\rangle\langle 0| + RZ(\lambda) \otimes |1\rangle\langle 1| =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & e^{-i\frac{\lambda}{2}} & 0 & 0 \\
+ 0 & 0 & 1 & 0 \\
+ 0 & 0 & 0 & e^{i\frac{\lambda}{2}}
+ \end{pmatrix}
+$$
+
+
+ In Qiskit’s convention, higher qubit indices are more significant (little endian convention). In many textbooks, controlled gates are presented with the assumption of more significant qubits as control, which in our case would be q\_1. Thus a textbook matrix for this gate will be:
+
+ ```python
+ ┌───────┐
+ q_0: ┤ Rz(λ) ├
+ └───┬───┘
+ q_1: ────■────
+ ```
+
+ $$
+ CRZ(\lambda)\ q_1, q_0 =
+ |0\rangle\langle 0| \otimes I + |1\rangle\langle 1| \otimes RZ(\lambda) =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & 1 & 0 & 0 \\
+ 0 & 0 & e^{-i\frac{\lambda}{2}} & 0 \\
+ 0 & 0 & 0 & e^{i\frac{\lambda}{2}}
+ \end{pmatrix}
+ $$
+
+
+
+ `CU1Gate`: Due to the global phase difference in the matrix definitions of U1 and RZ, CU1 and CRZ are different gates with a relative phase difference.
+
+
+Create new CRZ gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.CRZGate.base_class "qiskit.circuit.library.CRZGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverse CRZ gate (i.e. with the negative rotation angle).
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.CSGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.CSGate.md
new file mode 100644
index 00000000000..0d73e333043
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.CSGate.md
@@ -0,0 +1,195 @@
+---
+title: CSGate
+description: API reference for qiskit.circuit.library.CSGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.CSGate
+---
+
+# CSGate
+
+
+
+`qiskit.circuit.library.CSGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/s.py "view source code")
+
+Bases: [`SingletonControlledGate`](circuit_singleton#qiskit.circuit.singleton.SingletonControlledGate "qiskit.circuit.singleton.SingletonControlledGate")
+
+Controlled-S gate.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`cs()`](qiskit.circuit.QuantumCircuit#cs "qiskit.circuit.QuantumCircuit.cs") method.
+
+**Circuit symbol:**
+
+```python
+q_0: ──■──
+ ┌─┴─┐
+q_1: ┤ S ├
+ └───┘
+```
+
+**Matrix representation:**
+
+$$
+CS \ q_0, q_1 =
+I \otimes |0 \rangle\langle 0| + S \otimes |1 \rangle\langle 1| =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & 1 & 0 & 0 \\
+ 0 & 0 & 1 & 0 \\
+ 0 & 0 & 0 & i
+ \end{pmatrix}
+$$
+
+Create new CS gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.CSGate.base_class "qiskit.circuit.library.CSGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverse of CSGate (CSdgGate).
+
+### power
+
+
+
+`power(exponent)`
+
+Raise gate to a power.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.CSXGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.CSXGate.md
new file mode 100644
index 00000000000..19647b1c8f3
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.CSXGate.md
@@ -0,0 +1,199 @@
+---
+title: CSXGate
+description: API reference for qiskit.circuit.library.CSXGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.CSXGate
+---
+
+# CSXGate
+
+
+
+`qiskit.circuit.library.CSXGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/sx.py "view source code")
+
+Bases: [`SingletonControlledGate`](circuit_singleton#qiskit.circuit.singleton.SingletonControlledGate "qiskit.circuit.singleton.SingletonControlledGate")
+
+Controlled-√X gate.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`csx()`](qiskit.circuit.QuantumCircuit#csx "qiskit.circuit.QuantumCircuit.csx") method.
+
+**Circuit symbol:**
+
+```python
+q_0: ──■──
+ ┌─┴──┐
+q_1: ┤ √X ├
+ └────┘
+```
+
+**Matrix representation:**
+
+$$
+C\sqrt{X} \ q_0, q_1 =
+I \otimes |0 \rangle\langle 0| + \sqrt{X} \otimes |1 \rangle\langle 1| =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & (1 + i) / 2 & 0 & (1 - i) / 2 \\
+ 0 & 0 & 1 & 0 \\
+ 0 & (1 - i) / 2 & 0 & (1 + i) / 2
+ \end{pmatrix}
+$$
+
+
+ In Qiskit’s convention, higher qubit indices are more significant (little endian convention). In many textbooks, controlled gates are presented with the assumption of more significant qubits as control, which in our case would be q\_1. Thus a textbook matrix for this gate will be:
+
+ ```python
+ ┌────┐
+ q_0: ┤ √X ├
+ └─┬──┘
+ q_1: ──■──
+ ```
+
+ $$
+ C\sqrt{X}\ q_1, q_0 =
+ |0 \rangle\langle 0| \otimes I + |1 \rangle\langle 1| \otimes \sqrt{X} =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & 1 & 0 & 0 \\
+ 0 & 0 & (1 + i) / 2 & (1 - i) / 2 \\
+ 0 & 0 & (1 - i) / 2 & (1 + i) / 2
+ \end{pmatrix}
+ $$
+
+
+Create new CSX gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.CSXGate.base_class "qiskit.circuit.library.CSXGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.CSdgGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.CSdgGate.md
new file mode 100644
index 00000000000..839c7f3565e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.CSdgGate.md
@@ -0,0 +1,195 @@
+---
+title: CSdgGate
+description: API reference for qiskit.circuit.library.CSdgGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.CSdgGate
+---
+
+# CSdgGate
+
+
+
+`qiskit.circuit.library.CSdgGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/s.py "view source code")
+
+Bases: [`SingletonControlledGate`](circuit_singleton#qiskit.circuit.singleton.SingletonControlledGate "qiskit.circuit.singleton.SingletonControlledGate")
+
+Controlled-S^dagger gate.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`csdg()`](qiskit.circuit.QuantumCircuit#csdg "qiskit.circuit.QuantumCircuit.csdg") method.
+
+**Circuit symbol:**
+
+```python
+q_0: ───■───
+ ┌──┴──┐
+q_1: ┤ Sdg ├
+ └─────┘
+```
+
+**Matrix representation:**
+
+$$
+CS^\dagger \ q_0, q_1 =
+I \otimes |0 \rangle\langle 0| + S^\dagger \otimes |1 \rangle\langle 1| =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & 1 & 0 & 0 \\
+ 0 & 0 & 1 & 0 \\
+ 0 & 0 & 0 & -i
+ \end{pmatrix}
+$$
+
+Create new CSdg gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.CSdgGate.base_class "qiskit.circuit.library.CSdgGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverse of CSdgGate (CSGate).
+
+### power
+
+
+
+`power(exponent)`
+
+Raise gate to a power.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.CSwapGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.CSwapGate.md
new file mode 100644
index 00000000000..344ad69c3f1
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.CSwapGate.md
@@ -0,0 +1,230 @@
+---
+title: CSwapGate
+description: API reference for qiskit.circuit.library.CSwapGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.CSwapGate
+---
+
+# CSwapGate
+
+
+
+`qiskit.circuit.library.CSwapGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/swap.py "view source code")
+
+Bases: [`SingletonControlledGate`](circuit_singleton#qiskit.circuit.singleton.SingletonControlledGate "qiskit.circuit.singleton.SingletonControlledGate")
+
+Controlled-SWAP gate, also known as the Fredkin gate.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`cswap()`](qiskit.circuit.QuantumCircuit#cswap "qiskit.circuit.QuantumCircuit.cswap") and [`fredkin()`](qiskit.circuit.QuantumCircuit#fredkin "qiskit.circuit.QuantumCircuit.fredkin") methods.
+
+**Circuit symbol:**
+
+```python
+q_0: ─■─
+ │
+q_1: ─X─
+ │
+q_2: ─X─
+```
+
+**Matrix representation:**
+
+$$
+CSWAP\ q_0, q_1, q_2 =
+ I \otimes I \otimes |0 \rangle \langle 0| +
+ SWAP \otimes |1 \rangle \langle 1| =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 & 0 & 0 & 0 & 0 \\
+ 0 & 1 & 0 & 0 & 0 & 0 & 0 & 0 \\
+ 0 & 0 & 1 & 0 & 0 & 0 & 0 & 0 \\
+ 0 & 0 & 0 & 0 & 0 & 1 & 0 & 0 \\
+ 0 & 0 & 0 & 0 & 1 & 0 & 0 & 0 \\
+ 0 & 0 & 0 & 1 & 0 & 0 & 0 & 0 \\
+ 0 & 0 & 0 & 0 & 0 & 0 & 1 & 0 \\
+ 0 & 0 & 0 & 0 & 0 & 0 & 0 & 1 \\
+ \end{pmatrix}
+$$
+
+
+ In Qiskit’s convention, higher qubit indices are more significant (little endian convention). In many textbooks, controlled gates are presented with the assumption of more significant qubits as control, which in our case would be q\_2. Thus a textbook matrix for this gate will be:
+
+ ```python
+ q_0: ─X─
+ │
+ q_1: ─X─
+ │
+ q_2: ─■─
+ ```
+
+ $$
+ CSWAP\ q_2, q_1, q_0 =
+ |0 \rangle \langle 0| \otimes I \otimes I +
+ |1 \rangle \langle 1| \otimes SWAP =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 & 0 & 0 & 0 & 0 \\
+ 0 & 1 & 0 & 0 & 0 & 0 & 0 & 0 \\
+ 0 & 0 & 1 & 0 & 0 & 0 & 0 & 0 \\
+ 0 & 0 & 0 & 1 & 0 & 0 & 0 & 0 \\
+ 0 & 0 & 0 & 0 & 1 & 0 & 0 & 0 \\
+ 0 & 0 & 0 & 0 & 0 & 0 & 1 & 0 \\
+ 0 & 0 & 0 & 0 & 0 & 1 & 0 & 0 \\
+ 0 & 0 & 0 & 0 & 0 & 0 & 0 & 1 \\
+ \end{pmatrix}
+ $$
+
+
+In the computational basis, this gate swaps the states of the two target qubits if the control qubit is in the $|1\rangle$ state.
+
+$$
+|0, b, c\rangle \rightarrow |0, b, c\rangle
+|1, b, c\rangle \rightarrow |1, c, b\rangle
+
+
+$$
+
+Create new CSWAP gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.CSwapGate.base_class "qiskit.circuit.library.CSwapGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverse CSwap gate (itself).
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.CU1Gate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.CU1Gate.md
new file mode 100644
index 00000000000..589b7e5fe13
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.CU1Gate.md
@@ -0,0 +1,212 @@
+---
+title: CU1Gate
+description: API reference for qiskit.circuit.library.CU1Gate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.CU1Gate
+---
+
+# CU1Gate
+
+
+
+`qiskit.circuit.library.CU1Gate(theta, label=None, ctrl_state=None, *, duration=None, unit='dt', _base_label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/u1.py "view source code")
+
+Bases: [`ControlledGate`](qiskit.circuit.ControlledGate "qiskit.circuit.controlledgate.ControlledGate")
+
+Controlled-U1 gate.
+
+This is a diagonal and symmetric gate that induces a phase on the state of the target qubit, depending on the control state.
+
+**Circuit symbol:**
+
+```python
+q_0: ─■──
+ │λ
+q_1: ─■──
+```
+
+**Matrix representation:**
+
+$$
+CU1(\lambda) =
+ I \otimes |0\rangle\langle 0| + U1 \otimes |1\rangle\langle 1| =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & 1 & 0 & 0 \\
+ 0 & 0 & 1 & 0 \\
+ 0 & 0 & 0 & e^{i\lambda}
+ \end{pmatrix}
+$$
+
+
+ `CRZGate`: Due to the global phase difference in the matrix definitions of U1 and RZ, CU1 and CRZ are different gates with a relative phase difference.
+
+
+Create new CU1 gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.CU1Gate.base_class "qiskit.circuit.library.CU1Gate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Controlled version of this gate.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of control qubits.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for the gate \[Default: None]
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – control state expressed as integer, string (e.g. ‘110’), or None. If None, use all 1s.
+
+**Returns**
+
+controlled version of this gate.
+
+**Return type**
+
+[ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted CU1 gate ($CU1(\lambda)^{\dagger} = CU1(-\lambda)$)
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.CU3Gate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.CU3Gate.md
new file mode 100644
index 00000000000..1e97d6be50e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.CU3Gate.md
@@ -0,0 +1,217 @@
+---
+title: CU3Gate
+description: API reference for qiskit.circuit.library.CU3Gate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.CU3Gate
+---
+
+# CU3Gate
+
+
+
+`qiskit.circuit.library.CU3Gate(theta, phi, lam, label=None, ctrl_state=None, *, duration=None, unit='dt', _base_label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/u3.py "view source code")
+
+Bases: [`ControlledGate`](qiskit.circuit.ControlledGate "qiskit.circuit.controlledgate.ControlledGate")
+
+Controlled-U3 gate (3-parameter two-qubit gate).
+
+This is a controlled version of the U3 gate (generic single qubit rotation). It is restricted to 3 parameters, and so cannot cover generic two-qubit controlled gates).
+
+**Circuit symbol:**
+
+```python
+q_0: ──────■──────
+ ┌─────┴─────┐
+q_1: ┤ U3(ϴ,φ,λ) ├
+ └───────────┘
+```
+
+**Matrix representation:**
+
+$$
+\newcommand{\rotationangle}{\frac{\theta}{2}}
+
+CU3(\theta, \phi, \lambda)\ q_0, q_1 =
+ I \otimes |0\rangle\langle 0| +
+ U3(\theta,\phi,\lambda) \otimes |1\rangle\langle 1| =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & \cos(\rotationangle) & 0 & -e^{i\lambda}\sin(\rotationangle) \\
+ 0 & 0 & 1 & 0 \\
+ 0 & e^{i\phi}\sin(\rotationangle) & 0 & e^{i(\phi+\lambda)}\cos(\rotationangle)
+ \end{pmatrix}
+$$
+
+
+ In Qiskit’s convention, higher qubit indices are more significant (little endian convention). In many textbooks, controlled gates are presented with the assumption of more significant qubits as control, which in our case would be q\_1. Thus a textbook matrix for this gate will be:
+
+ ```python
+ ┌───────────┐
+ q_0: ┤ U3(ϴ,φ,λ) ├
+ └─────┬─────┘
+ q_1: ──────■──────
+ ```
+
+ $$
+ \newcommand{\rotationangle}{\frac{\theta}{2}}
+
+ CU3(\theta, \phi, \lambda)\ q_1, q_0 =
+ |0\rangle\langle 0| \otimes I +
+ |1\rangle\langle 1| \otimes U3(\theta,\phi,\lambda) =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & 1 & 0 & 0 \\
+ 0 & 0 & \cos(\rotationangle) & -e^{i\lambda}\sin(\rotationangle) \\
+ 0 & 0 & e^{i\phi}\sin(\rotationangle) & e^{i(\phi+\lambda)}\cos(\rotationangle)
+ \end{pmatrix}
+ $$
+
+
+Create new CU3 gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.CU3Gate.base_class "qiskit.circuit.library.CU3Gate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted CU3 gate.
+
+$CU3(\theta,\phi,\lambda)^{\dagger} =CU3(-\theta,-\phi,-\lambda)$)
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.CUGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.CUGate.md
new file mode 100644
index 00000000000..dc2e6b48a14
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.CUGate.md
@@ -0,0 +1,207 @@
+---
+title: CUGate
+description: API reference for qiskit.circuit.library.CUGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.CUGate
+---
+
+# CUGate
+
+
+
+`qiskit.circuit.library.CUGate(theta, phi, lam, gamma, label=None, ctrl_state=None, *, duration=None, unit='dt', _base_label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/u.py "view source code")
+
+Bases: [`ControlledGate`](qiskit.circuit.ControlledGate "qiskit.circuit.controlledgate.ControlledGate")
+
+Controlled-U gate (4-parameter two-qubit gate).
+
+This is a controlled version of the U gate (generic single qubit rotation), including a possible global phase $e^{i\gamma}$ of the U gate.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`cu()`](qiskit.circuit.QuantumCircuit#cu "qiskit.circuit.QuantumCircuit.cu") method.
+
+**Circuit symbol:**
+
+```python
+q_0: ──────■──────
+ ┌─────┴──────┐
+q_1: ┤ U(ϴ,φ,λ,γ) ├
+ └────────────┘
+```
+
+**Matrix representation:**
+
+$$
+\newcommand{\rotationangle}{\frac{\theta}{2}}
+
+CU(\theta, \phi, \lambda, \gamma)\ q_0, q_1 =
+ I \otimes |0\rangle\langle 0| +
+ e^{i\gamma} U(\theta,\phi,\lambda) \otimes |1\rangle\langle 1| =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & e^{i\gamma}\cos(\rotationangle) &
+ 0 & -e^{i(\gamma + \lambda)}\sin(\rotationangle) \\
+ 0 & 0 & 1 & 0 \\
+ 0 & e^{i(\gamma+\phi)}\sin(\rotationangle) &
+ 0 & e^{i(\gamma+\phi+\lambda)}\cos(\rotationangle)
+ \end{pmatrix}
+$$
+
+
+ In Qiskit’s convention, higher qubit indices are more significant (little endian convention). In many textbooks, controlled gates are presented with the assumption of more significant qubits as control, which in our case would be q\_1. Thus a textbook matrix for this gate will be:
+
+ ```python
+ ┌────────────┐
+ q_0: ┤ U(ϴ,φ,λ,γ) ├
+ └─────┬──────┘
+ q_1: ──────■───────
+ ```
+
+ $$
+ \newcommand{\rotationangle}{\frac{\theta}{2}}
+ CU(\theta, \phi, \lambda, \gamma)\ q_1, q_0 =
+ |0\rangle\langle 0| \otimes I +
+ e^{i\gamma}|1\rangle\langle 1| \otimes U(\theta,\phi,\lambda) =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & 1 & 0 & 0 \\
+ 0 & 0 & e^{i\gamma} \cos(\rotationangle) & -e^{i(\gamma + \lambda)}\sin(\rotationangle) \\
+ 0 & 0 &
+ e^{i(\gamma + \phi)}\sin(\rotationangle) & e^{i(\gamma + \phi+\lambda)}\cos(\rotationangle)
+ \end{pmatrix}
+ $$
+
+
+Create new CU gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.CUGate.base_class "qiskit.circuit.library.CUGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted CU gate.
+
+$CU(\theta,\phi,\lambda,\gamma)^{\dagger} = CU(-\theta,-\phi,-\lambda,-\gamma)$)
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.CXGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.CXGate.md
new file mode 100644
index 00000000000..9aac3159491
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.CXGate.md
@@ -0,0 +1,239 @@
+---
+title: CXGate
+description: API reference for qiskit.circuit.library.CXGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.CXGate
+---
+
+# CXGate
+
+
+
+`qiskit.circuit.library.CXGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/x.py "view source code")
+
+Bases: [`SingletonControlledGate`](circuit_singleton#qiskit.circuit.singleton.SingletonControlledGate "qiskit.circuit.singleton.SingletonControlledGate")
+
+Controlled-X gate.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`cx()`](qiskit.circuit.QuantumCircuit#cx "qiskit.circuit.QuantumCircuit.cx") and [`cnot()`](qiskit.circuit.QuantumCircuit#cnot "qiskit.circuit.QuantumCircuit.cnot") methods.
+
+**Circuit symbol:**
+
+```python
+q_0: ──■──
+ ┌─┴─┐
+q_1: ┤ X ├
+ └───┘
+```
+
+**Matrix representation:**
+
+$$
+CX\ q_0, q_1 =
+ I \otimes |0\rangle\langle0| + X \otimes |1\rangle\langle1| =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & 0 & 0 & 1 \\
+ 0 & 0 & 1 & 0 \\
+ 0 & 1 & 0 & 0
+ \end{pmatrix}
+$$
+
+
+ In Qiskit’s convention, higher qubit indices are more significant (little endian convention). In many textbooks, controlled gates are presented with the assumption of more significant qubits as control, which in our case would be q\_1. Thus a textbook matrix for this gate will be:
+
+ ```python
+ ┌───┐
+ q_0: ┤ X ├
+ └─┬─┘
+ q_1: ──■──
+ ```
+
+ $$
+ CX\ q_1, q_0 =
+ |0 \rangle\langle 0| \otimes I + |1 \rangle\langle 1| \otimes X =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & 1 & 0 & 0 \\
+ 0 & 0 & 0 & 1 \\
+ 0 & 0 & 1 & 0
+ \end{pmatrix}
+ $$
+
+
+In the computational basis, this gate flips the target qubit if the control qubit is in the $|1\rangle$ state. In this sense it is similar to a classical XOR gate.
+
+$$
+`|a, b\rangle \rightarrow |a, a \oplus b\rangle`
+
+
+$$
+
+Create new CX gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.CXGate.base_class "qiskit.circuit.library.CXGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Return a controlled-X gate with more control lines.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of control qubits.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for the gate \[Default: None]
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – control state expressed as integer, string (e.g. ‘110’), or None. If None, use all 1s.
+
+**Returns**
+
+controlled version of this gate.
+
+**Return type**
+
+[ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted CX gate (itself).
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.CYGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.CYGate.md
new file mode 100644
index 00000000000..99228a9d25c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.CYGate.md
@@ -0,0 +1,209 @@
+---
+title: CYGate
+description: API reference for qiskit.circuit.library.CYGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.CYGate
+---
+
+# CYGate
+
+
+
+`qiskit.circuit.library.CYGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/y.py "view source code")
+
+Bases: [`SingletonControlledGate`](circuit_singleton#qiskit.circuit.singleton.SingletonControlledGate "qiskit.circuit.singleton.SingletonControlledGate")
+
+Controlled-Y gate.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`cy()`](qiskit.circuit.QuantumCircuit#cy "qiskit.circuit.QuantumCircuit.cy") method.
+
+**Circuit symbol:**
+
+```python
+q_0: ──■──
+ ┌─┴─┐
+q_1: ┤ Y ├
+ └───┘
+```
+
+**Matrix representation:**
+
+$$
+CY\ q_0, q_1 =
+I \otimes |0 \rangle\langle 0| + Y \otimes |1 \rangle\langle 1| =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & 0 & 0 & -i \\
+ 0 & 0 & 1 & 0 \\
+ 0 & i & 0 & 0
+ \end{pmatrix}
+$$
+
+
+ In Qiskit’s convention, higher qubit indices are more significant (little endian convention). In many textbooks, controlled gates are presented with the assumption of more significant qubits as control, which in our case would be q\_1. Thus a textbook matrix for this gate will be:
+
+ ```python
+ ┌───┐
+ q_0: ┤ Y ├
+ └─┬─┘
+ q_1: ──■──
+ ```
+
+ $$
+ CY\ q_1, q_0 =
+ |0 \rangle\langle 0| \otimes I + |1 \rangle\langle 1| \otimes Y =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & 1 & 0 & 0 \\
+ 0 & 0 & 0 & -i \\
+ 0 & 0 & i & 0
+ \end{pmatrix}
+ $$
+
+
+Create new CY gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.CYGate.base_class "qiskit.circuit.library.CYGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted CY gate (itself).
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.CZGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.CZGate.md
new file mode 100644
index 00000000000..01d2b7e0f3e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.CZGate.md
@@ -0,0 +1,190 @@
+---
+title: CZGate
+description: API reference for qiskit.circuit.library.CZGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.CZGate
+---
+
+# CZGate
+
+
+
+`qiskit.circuit.library.CZGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/z.py "view source code")
+
+Bases: [`SingletonControlledGate`](circuit_singleton#qiskit.circuit.singleton.SingletonControlledGate "qiskit.circuit.singleton.SingletonControlledGate")
+
+Controlled-Z gate.
+
+This is a Clifford and symmetric gate.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`cz()`](qiskit.circuit.QuantumCircuit#cz "qiskit.circuit.QuantumCircuit.cz") method.
+
+**Circuit symbol:**
+
+```python
+q_0: ─■─
+ │
+q_1: ─■─
+```
+
+**Matrix representation:**
+
+$$
+CZ\ q_0, q_1 =
+ I \otimes |0\rangle\langle 0| + Z \otimes |1\rangle\langle 1| =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & 1 & 0 & 0 \\
+ 0 & 0 & 1 & 0 \\
+ 0 & 0 & 0 & -1
+ \end{pmatrix}
+$$
+
+In the computational basis, this gate flips the phase of the target qubit if the control qubit is in the $|1\rangle$ state.
+
+Create new CZ gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.CZGate.base_class "qiskit.circuit.library.CZGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted CZ gate (itself).
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.DCXGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.DCXGate.md
new file mode 100644
index 00000000000..c2e34acbfd6
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.DCXGate.md
@@ -0,0 +1,141 @@
+---
+title: DCXGate
+description: API reference for qiskit.circuit.library.DCXGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.DCXGate
+---
+
+# DCXGate
+
+
+
+`qiskit.circuit.library.DCXGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/dcx.py "view source code")
+
+Bases: [`SingletonGate`](circuit_singleton#qiskit.circuit.singleton.SingletonGate "qiskit.circuit.singleton.SingletonGate")
+
+Double-CNOT gate.
+
+A 2-qubit Clifford gate consisting of two back-to-back CNOTs with alternate controls.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`dcx()`](qiskit.circuit.QuantumCircuit#dcx "qiskit.circuit.QuantumCircuit.dcx") method.
+
+```python
+ ┌───┐
+q_0: ──■──┤ X ├
+ ┌─┴─┐└─┬─┘
+q_1: ┤ X ├──■──
+ └───┘
+```
+
+This is a classical logic gate, equivalent to a CNOT-SWAP (CNS) sequence, and locally equivalent to an iSWAP.
+
+$$
+DCX\ q_0, q_1 =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & 0 & 0 & 1 \\
+ 0 & 1 & 0 & 0 \\
+ 0 & 0 & 1 & 0
+ \end{pmatrix}
+$$
+
+Create new DCX gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.DCXGate.base_class "qiskit.circuit.library.DCXGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.Diagonal.md b/docs/api/qiskit/0.46/qiskit.circuit.library.Diagonal.md
new file mode 100644
index 00000000000..2d0660b1c8b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.Diagonal.md
@@ -0,0 +1,255 @@
+---
+title: Diagonal
+description: API reference for qiskit.circuit.library.Diagonal
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.Diagonal
+---
+
+# Diagonal
+
+
+
+`qiskit.circuit.library.Diagonal(diag)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/generalized_gates/diagonal.py "view source code")
+
+Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+Diagonal circuit.
+
+Circuit symbol:
+
+```python
+ ┌───────────┐
+q_0: ┤0 ├
+ │ │
+q_1: ┤1 Diagonal ├
+ │ │
+q_2: ┤2 ├
+ └───────────┘
+```
+
+Matrix form:
+
+$$
+\text{DiagonalGate}\ q_0, q_1, .., q_{n-1} =
+ \begin{pmatrix}
+ D[0] & 0 & \dots & 0 \\
+ 0 & D[1] & \dots & 0 \\
+ \vdots & \vdots & \ddots & 0 \\
+ 0 & 0 & \dots & D[n-1]
+ \end{pmatrix}
+
+
+$$
+
+Diagonal gates are useful as representations of Boolean functions, as they can map from $\{0,1\}^{2^n}$ to $\{0,1\}^{2^n}$ space. For example a phase oracle can be seen as a diagonal gate with $\{1, -1\}$ on the diagonals. Such an oracle will induce a $+1$ or :math\`-1\` phase on the amplitude of any corresponding basis state.
+
+Diagonal gates appear in many classically hard oracular problems such as Forrelation or Hidden Shift circuits.
+
+Diagonal gates are represented and simulated more efficiently than a dense $2^n \times 2^n$ unitary matrix.
+
+The reference implementation is via the method described in Theorem 7 of \[1]. The code is based on Emanuel Malvetti’s semester thesis at ETH in 2018, supervised by Raban Iten and Prof. Renato Renner.
+
+**Reference:**
+
+\[1] Shende et al., Synthesis of Quantum Logic Circuits, 2009 [arXiv:0406176](https://arxiv.org/pdf/quant-ph/0406176.pdf)
+
+**Parameters**
+
+**diag** (*Sequence\[*[*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*]*) – List of the $2^k$ diagonal entries (for a diagonal gate on $k$ qubits).
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the list of the diagonal entries or the qubit list is in bad format; if the number of diagonal entries is not $2^k$, where $k$ denotes the number of qubits.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 159`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.DiagonalGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.DiagonalGate.md
new file mode 100644
index 00000000000..33fd6d7b987
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.DiagonalGate.md
@@ -0,0 +1,137 @@
+---
+title: DiagonalGate
+description: API reference for qiskit.circuit.library.DiagonalGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.DiagonalGate
+---
+
+# DiagonalGate
+
+
+
+`qiskit.circuit.library.DiagonalGate(diag)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/generalized_gates/diagonal.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+Gate implementing a diagonal transformation.
+
+**Parameters**
+
+**diag** (*Sequence\[*[*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*]*) – list of the $2^k$ diagonal entries (for a diagonal gate on $k$ qubits).
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.DiagonalGate.base_class "qiskit.circuit.library.DiagonalGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return the inverse of the diagonal gate.
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Diagonal Gate parameter should accept complex (in addition to the Gate parameter types) and always return build-in complex.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.DraperQFTAdder.md b/docs/api/qiskit/0.46/qiskit.circuit.library.DraperQFTAdder.md
new file mode 100644
index 00000000000..1075c4a53a2
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.DraperQFTAdder.md
@@ -0,0 +1,254 @@
+---
+title: DraperQFTAdder
+description: API reference for qiskit.circuit.library.DraperQFTAdder
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.DraperQFTAdder
+---
+
+# DraperQFTAdder
+
+
+
+`qiskit.circuit.library.DraperQFTAdder(num_state_qubits, kind='fixed', name='DraperQFTAdder')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/arithmetic/adders/draper_qft_adder.py "view source code")
+
+Bases: `Adder`
+
+A circuit that uses QFT to perform in-place addition on two qubit registers.
+
+For registers with $n$ qubits, the QFT adder can perform addition modulo $2^n$ (with `kind="fixed"`) or ordinary addition by adding a carry qubits (with `kind="half"`).
+
+As an example, a non-fixed\_point QFT adder circuit that performs addition on two 2-qubit sized registers is as follows:
+
+```python
+ a_0: ─────────■──────■────────────────────────■────────────────
+ │ │ │
+ a_1: ─────────┼──────┼────────■──────■────────┼────────────────
+ ┌──────┐ │P(π) │ │ │ │ ┌───────┐
+ b_0: ┤0 ├─■──────┼────────┼──────┼────────┼───────┤0 ├
+ │ │ │P(π/2) │P(π) │ │ │ │
+ b_1: ┤1 qft ├────────■────────■──────┼────────┼───────┤1 iqft ├
+ │ │ │P(π/2) │P(π/4) │ │
+cout_0: ┤2 ├────────────────────────■────────■───────┤2 ├
+ └──────┘ └───────┘
+```
+
+**References:**
+
+\[1] T. G. Draper, Addition on a Quantum Computer, 2000. [arXiv:quant-ph/0008033](https://arxiv.org/pdf/quant-ph/0008033.pdf)
+
+\[2] Ruiz-Perez et al., Quantum arithmetic with the Quantum Fourier Transform, 2017. [arXiv:1411.5949](https://arxiv.org/pdf/1411.5949.pdf)
+
+\[3] Vedral et al., Quantum Networks for Elementary Arithmetic Operations, 1995. [arXiv:quant-ph/9511018](https://arxiv.org/pdf/quant-ph/9511018.pdf)
+
+**Parameters**
+
+* **num\_state\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of qubits in either input register for state $|a\rangle$ or $|b\rangle$. The two input registers must have the same number of qubits.
+* **kind** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The kind of adder, can be `'half'` for a half adder or `'fixed'` for a fixed-sized adder. A half adder contains a carry-out to represent the most-significant bit, but the fixed-sized adder doesn’t and hence performs addition modulo `2 ** num_state_qubits`.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the circuit object.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `num_state_qubits` is lower than 1.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 159`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### num\_state\_qubits
+
+The number of state qubits, i.e. the number of bits in each input register.
+
+**Returns**
+
+The number of state qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.ECRGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.ECRGate.md
new file mode 100644
index 00000000000..6338fdb1fe9
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.ECRGate.md
@@ -0,0 +1,175 @@
+---
+title: ECRGate
+description: API reference for qiskit.circuit.library.ECRGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.ECRGate
+---
+
+# ECRGate
+
+
+
+`qiskit.circuit.library.ECRGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/ecr.py "view source code")
+
+Bases: [`SingletonGate`](circuit_singleton#qiskit.circuit.singleton.SingletonGate "qiskit.circuit.singleton.SingletonGate")
+
+An echoed cross-resonance gate.
+
+This gate is maximally entangling and is equivalent to a CNOT up to single-qubit pre-rotations. The echoing procedure mitigates some unwanted terms (terms other than ZX) to cancel in an experiment. More specifically, this gate implements $\frac{1}{\sqrt{2}}(IX-XY)$.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`ecr()`](qiskit.circuit.QuantumCircuit#ecr "qiskit.circuit.QuantumCircuit.ecr") method.
+
+**Circuit Symbol:**
+
+```python
+ ┌─────────┐ ┌────────────┐┌────────┐┌─────────────┐
+q_0: ┤0 ├ q_0: ┤0 ├┤ RX(pi) ├┤0 ├
+ │ ECR │ = │ RZX(pi/4) │└────────┘│ RZX(-pi/4) │
+q_1: ┤1 ├ q_1: ┤1 ├──────────┤1 ├
+ └─────────┘ └────────────┘ └─────────────┘
+```
+
+**Matrix Representation:**
+
+$$
+ECR\ q_0, q_1 = \frac{1}{\sqrt{2}}
+ \begin{pmatrix}
+ 0 & 1 & 0 & i \\
+ 1 & 0 & -i & 0 \\
+ 0 & i & 0 & 1 \\
+ -i & 0 & 1 & 0
+ \end{pmatrix}
+$$
+
+
+ In Qiskit’s convention, higher qubit indices are more significant (little endian convention). In the above example we apply the gate on (q\_0, q\_1) which results in the $X \otimes Z$ tensor order. Instead, if we apply it on (q\_1, q\_0), the matrix will be $Z \otimes X$:
+
+ ```python
+ ┌─────────┐
+ q_0: ┤1 ├
+ │ ECR │
+ q_1: ┤0 ├
+ └─────────┘
+ ```
+
+ $$
+ ECR\ q_0, q_1 = \frac{1}{\sqrt{2}}
+ \begin{pmatrix}
+ 0 & 0 & 1 & i \\
+ 0 & 0 & i & 1 \\
+ 1 & -i & 0 & 0 \\
+ -i & 1 & 0 & 0
+ \end{pmatrix}
+ $$
+
+
+Create new ECR gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.ECRGate.base_class "qiskit.circuit.library.ECRGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverse ECR gate (itself).
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.EfficientSU2.md b/docs/api/qiskit/0.46/qiskit.circuit.library.EfficientSU2.md
new file mode 100644
index 00000000000..a510dad5833
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.EfficientSU2.md
@@ -0,0 +1,351 @@
+---
+title: EfficientSU2
+description: API reference for qiskit.circuit.library.EfficientSU2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.EfficientSU2
+---
+
+# EfficientSU2
+
+
+
+`qiskit.circuit.library.EfficientSU2(num_qubits=None, su2_gates=None, entanglement='reverse_linear', reps=3, skip_unentangled_qubits=False, skip_final_rotation_layer=False, parameter_prefix='θ', insert_barriers=False, initial_state=None, name='EfficientSU2', flatten=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/n_local/efficient_su2.py "view source code")
+
+Bases: [`TwoLocal`](qiskit.circuit.library.TwoLocal "qiskit.circuit.library.n_local.two_local.TwoLocal")
+
+The hardware efficient SU(2) 2-local circuit.
+
+The `EfficientSU2` circuit consists of layers of single qubit operations spanned by SU(2) and $CX$ entanglements. This is a heuristic pattern that can be used to prepare trial wave functions for variational quantum algorithms or classification circuit for machine learning.
+
+SU(2) stands for special unitary group of degree 2, its elements are $2 \times 2$ unitary matrices with determinant 1, such as the Pauli rotation gates.
+
+On 3 qubits and using the Pauli $Y$ and $Z$ su2\_gates as single qubit gates, the hardware efficient SU(2) circuit is represented by:
+
+```python
+┌──────────┐┌──────────┐ ░ ░ ░ ┌───────────┐┌───────────┐
+┤ RY(θ[0]) ├┤ RZ(θ[3]) ├─░────────■───░─ ... ─░─┤ RY(θ[12]) ├┤ RZ(θ[15]) ├
+├──────────┤├──────────┤ ░ ┌─┴─┐ ░ ░ ├───────────┤├───────────┤
+┤ RY(θ[1]) ├┤ RZ(θ[4]) ├─░───■──┤ X ├─░─ ... ─░─┤ RY(θ[13]) ├┤ RZ(θ[16]) ├
+├──────────┤├──────────┤ ░ ┌─┴─┐└───┘ ░ ░ ├───────────┤├───────────┤
+┤ RY(θ[2]) ├┤ RZ(θ[5]) ├─░─┤ X ├──────░─ ... ─░─┤ RY(θ[14]) ├┤ RZ(θ[17]) ├
+└──────────┘└──────────┘ ░ └───┘ ░ ░ └───────────┘└───────────┘
+```
+
+See [`RealAmplitudes`](qiskit.circuit.library.RealAmplitudes "qiskit.circuit.library.RealAmplitudes") for more detail on the possible arguments and options such as skipping unentanglement qubits, which apply here too.
+
+**Examples**
+
+```python
+>>> circuit = EfficientSU2(3, reps=1)
+>>> print(circuit)
+ ┌──────────┐┌──────────┐ ┌──────────┐┌──────────┐
+q_0: ┤ RY(θ[0]) ├┤ RZ(θ[3]) ├──■────■──┤ RY(θ[6]) ├┤ RZ(θ[9]) ├─────────────
+ ├──────────┤├──────────┤┌─┴─┐ │ └──────────┘├──────────┤┌───────────┐
+q_1: ┤ RY(θ[1]) ├┤ RZ(θ[4]) ├┤ X ├──┼───────■──────┤ RY(θ[7]) ├┤ RZ(θ[10]) ├
+ ├──────────┤├──────────┤└───┘┌─┴─┐ ┌─┴─┐ ├──────────┤├───────────┤
+q_2: ┤ RY(θ[2]) ├┤ RZ(θ[5]) ├─────┤ X ├───┤ X ├────┤ RY(θ[8]) ├┤ RZ(θ[11]) ├
+ └──────────┘└──────────┘ └───┘ └───┘ └──────────┘└───────────┘
+```
+
+```python
+>>> ansatz = EfficientSU2(4, su2_gates=['rx', 'y'], entanglement='circular', reps=1)
+>>> qc = QuantumCircuit(4) # create a circuit and append the RY variational form
+>>> qc.compose(ansatz, inplace=True)
+>>> qc.draw()
+ ┌──────────┐┌───┐┌───┐ ┌──────────┐ ┌───┐
+q_0: ┤ RX(θ[0]) ├┤ Y ├┤ X ├──■──┤ RX(θ[4]) ├───┤ Y ├─────────────────────
+ ├──────────┤├───┤└─┬─┘┌─┴─┐└──────────┘┌──┴───┴───┐ ┌───┐
+q_1: ┤ RX(θ[1]) ├┤ Y ├──┼──┤ X ├─────■──────┤ RX(θ[5]) ├───┤ Y ├─────────
+ ├──────────┤├───┤ │ └───┘ ┌─┴─┐ └──────────┘┌──┴───┴───┐┌───┐
+q_2: ┤ RX(θ[2]) ├┤ Y ├──┼──────────┤ X ├─────────■──────┤ RX(θ[6]) ├┤ Y ├
+ ├──────────┤├───┤ │ └───┘ ┌─┴─┐ ├──────────┤├───┤
+q_3: ┤ RX(θ[3]) ├┤ Y ├──■──────────────────────┤ X ├────┤ RX(θ[7]) ├┤ Y ├
+ └──────────┘└───┘ └───┘ └──────────┘└───┘
+```
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of qubits of the EfficientSU2 circuit.
+* **reps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Specifies how often the structure of a rotation layer followed by an entanglement layer is repeated.
+* **su2\_gates** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*type*](https://docs.python.org/3/library/functions.html#type "(in Python v3.12)") *|*[*qiskit.circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction") *|*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*type*](https://docs.python.org/3/library/functions.html#type "(in Python v3.12)") *|*[*qiskit.circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction") *|*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*] | None*) – The SU(2) single qubit gates to apply in single qubit gate layers. If only one gate is provided, the same gate is applied to each qubit. If a list of gates is provided, all gates are applied to each qubit in the provided order.
+* **entanglement** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]] | Callable\[\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*],* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]]*) – Specifies the entanglement structure. Can be a string (‘full’, ‘linear’ , ‘reverse\_linear’, ‘circular’ or ‘sca’), a list of integer-pairs specifying the indices of qubits entangled with one another, or a callable returning such a list provided with the index of the entanglement layer. Default to ‘reverse\_linear’ entanglement. Note that ‘reverse\_linear’ entanglement provides the same unitary as ‘full’ with fewer entangling gates. See the Examples section of [`TwoLocal`](qiskit.circuit.library.TwoLocal "qiskit.circuit.library.TwoLocal") for more detail.
+* **initial\_state** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| None*) – A QuantumCircuit object to prepend to the circuit.
+* **skip\_unentangled\_qubits** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, the single qubit gates are only applied to qubits that are entangled with another qubit. If False, the single qubit gates are applied to each qubit in the Ansatz. Defaults to False.
+* **skip\_final\_rotation\_layer** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If False, a rotation layer is added at the end of the ansatz. If True, no rotation layer is added.
+* **parameter\_prefix** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The parameterized gates require a parameter to be defined, for which we use [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector").
+* **insert\_barriers** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, barriers are inserted in between each layer. If False, no barriers are inserted.
+* **flatten** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – Set this to `True` to output a flat circuit instead of nesting it inside multiple layers of gate objects. By default currently the contents of the output circuit will be wrapped in nested objects for cleaner visualization. However, if you’re using this circuit for anything besides visualization its **strongly** recommended to set this flag to `True` to avoid a large performance overhead for parameter binding.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+
+
+### entanglement
+
+Get the entanglement strategy.
+
+**Returns**
+
+The entanglement strategy, see `get_entangler_map()` for more detail on how the format is interpreted.
+
+
+
+### entanglement\_blocks
+
+The blocks in the entanglement layers.
+
+**Returns**
+
+The blocks in the entanglement layers.
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### flatten
+
+Returns whether the circuit is wrapped in nested gates/instructions or flattened.
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### initial\_state
+
+Return the initial state that is added in front of the n-local circuit.
+
+**Returns**
+
+The initial state.
+
+
+
+### insert\_barriers
+
+If barriers are inserted in between the layers or not.
+
+**Returns**
+
+`True`, if barriers are inserted in between the layers, `False` if not.
+
+
+
+### instances
+
+`= 159`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_layers
+
+Return the number of layers in the n-local circuit.
+
+**Returns**
+
+The number of layers in the circuit.
+
+
+
+### num\_parameters
+
+
+
+### num\_parameters\_settable
+
+The number of total parameters that can be set to distinct values.
+
+This does not change when the parameters are bound or exchanged for same parameters, and therefore is different from `num_parameters` which counts the number of unique [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects currently in the circuit.
+
+**Returns**
+
+The number of parameters originally available in the circuit.
+
+
+ This quantity does not require the circuit to be built yet.
+
+
+
+
+### num\_qubits
+
+Returns the number of qubits in this circuit.
+
+**Returns**
+
+The number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### ordered\_parameters
+
+The parameters used in the underlying circuit.
+
+This includes float values and duplicates.
+
+**Examples**
+
+```python
+>>> # prepare circuit ...
+>>> print(nlocal)
+ ┌───────┐┌──────────┐┌──────────┐┌──────────┐
+q_0: ┤ Ry(1) ├┤ Ry(θ[1]) ├┤ Ry(θ[1]) ├┤ Ry(θ[3]) ├
+ └───────┘└──────────┘└──────────┘└──────────┘
+>>> nlocal.parameters
+{Parameter(θ[1]), Parameter(θ[3])}
+>>> nlocal.ordered_parameters
+[1, Parameter(θ[1]), Parameter(θ[1]), Parameter(θ[3])]
+```
+
+**Returns**
+
+The parameters objects used in the circuit.
+
+
+
+### parameter\_bounds
+
+Return the parameter bounds.
+
+**Returns**
+
+The parameter bounds.
+
+
+
+### parameters
+
+
+
+### preferred\_init\_points
+
+The initial points for the parameters. Can be stored as initial guess in optimization.
+
+**Returns**
+
+The initial values for the parameters, or None, if none have been set.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qregs
+
+`list[QuantumRegister]`
+
+A list of the quantum registers associated with the circuit.
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+
+
+### reps
+
+The number of times rotation and entanglement block are repeated.
+
+**Returns**
+
+The number of repetitions.
+
+
+
+### rotation\_blocks
+
+The blocks in the rotation layers.
+
+**Returns**
+
+The blocks in the rotation layers.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.EvolvedOperatorAnsatz.md b/docs/api/qiskit/0.46/qiskit.circuit.library.EvolvedOperatorAnsatz.md
new file mode 100644
index 00000000000..a689c6d8fe3
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.EvolvedOperatorAnsatz.md
@@ -0,0 +1,319 @@
+---
+title: EvolvedOperatorAnsatz
+description: API reference for qiskit.circuit.library.EvolvedOperatorAnsatz
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.EvolvedOperatorAnsatz
+---
+
+# EvolvedOperatorAnsatz
+
+
+
+`qiskit.circuit.library.EvolvedOperatorAnsatz(operators=None, reps=1, evolution=None, insert_barriers=False, name='EvolvedOps', parameter_prefix='t', initial_state=None, flatten=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/evolved_operator_ansatz.py "view source code")
+
+Bases: [`NLocal`](qiskit.circuit.library.NLocal "qiskit.circuit.library.n_local.n_local.NLocal")
+
+The evolved operator ansatz.
+
+**Parameters**
+
+* **operators** (*BaseOperator |* [*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase") *|*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *| None*) – The operators to evolve. If a circuit is passed, we assume it implements an already evolved operator and thus the circuit is not evolved again. Can be a single operator (circuit) or a list of operators (and circuits).
+* **reps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of times to repeat the evolved operators.
+* **evolution** ([*EvolutionBase*](qiskit.opflow.evolutions.EvolutionBase "qiskit.opflow.evolutions.EvolutionBase") *|*[*EvolutionSynthesis*](qiskit.synthesis.EvolutionSynthesis "qiskit.synthesis.EvolutionSynthesis") *| None*) – A specification of which evolution synthesis to use for the [`PauliEvolutionGate`](qiskit.circuit.library.PauliEvolutionGate "qiskit.circuit.library.PauliEvolutionGate"), if the operator is from [`qiskit.quantum_info`](quantum_info#module-qiskit.quantum_info "qiskit.quantum_info") or an opflow converter object if the operator is from [`qiskit.opflow`](opflow#module-qiskit.opflow "qiskit.opflow"). Defaults to first order Trotterization.
+* **insert\_barriers** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to insert barriers in between each evolution.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the circuit.
+* **parameter\_prefix** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| Sequence\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – Set the names of the circuit parameters. If a string, the same prefix will be used for each parameters. Can also be a list to specify a prefix per operator.
+* **initial\_state** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| None*) – A [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") object to prepend to the circuit.
+* **flatten** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – Set this to `True` to output a flat circuit instead of nesting it inside multiple layers of gate objects. By default currently the contents of the output circuit will be wrapped in nested objects for cleaner visualization. However, if you’re using this circuit for anything besides visualization its **strongly** recommended to set this flag to `True` to avoid a large performance overhead for parameter binding.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+
+
+### entanglement
+
+Get the entanglement strategy.
+
+**Returns**
+
+The entanglement strategy, see `get_entangler_map()` for more detail on how the format is interpreted.
+
+
+
+### entanglement\_blocks
+
+The blocks in the entanglement layers.
+
+**Returns**
+
+The blocks in the entanglement layers.
+
+
+
+### evolution
+
+The evolution converter used to compute the evolution.
+
+**Returns**
+
+The evolution converter used to compute the evolution.
+
+**Return type**
+
+[EvolutionBase](qiskit.opflow.evolutions.EvolutionBase "qiskit.opflow.evolutions.EvolutionBase") or [EvolutionSynthesis](qiskit.synthesis.EvolutionSynthesis "qiskit.synthesis.EvolutionSynthesis")
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### flatten
+
+Returns whether the circuit is wrapped in nested gates/instructions or flattened.
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### initial\_state
+
+Return the initial state that is added in front of the n-local circuit.
+
+**Returns**
+
+The initial state.
+
+
+
+### insert\_barriers
+
+If barriers are inserted in between the layers or not.
+
+**Returns**
+
+`True`, if barriers are inserted in between the layers, `False` if not.
+
+
+
+### instances
+
+`= 159`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_layers
+
+Return the number of layers in the n-local circuit.
+
+**Returns**
+
+The number of layers in the circuit.
+
+
+
+### num\_parameters
+
+
+
+### num\_parameters\_settable
+
+The number of total parameters that can be set to distinct values.
+
+This does not change when the parameters are bound or exchanged for same parameters, and therefore is different from `num_parameters` which counts the number of unique [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects currently in the circuit.
+
+**Returns**
+
+The number of parameters originally available in the circuit.
+
+
+ This quantity does not require the circuit to be built yet.
+
+
+
+
+### num\_qubits
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### operators
+
+The operators that are evolved in this circuit.
+
+**Returns**
+
+The operators to be evolved (and circuits) contained in this ansatz.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+
+
+### ordered\_parameters
+
+The parameters used in the underlying circuit.
+
+This includes float values and duplicates.
+
+**Examples**
+
+```python
+>>> # prepare circuit ...
+>>> print(nlocal)
+ ┌───────┐┌──────────┐┌──────────┐┌──────────┐
+q_0: ┤ Ry(1) ├┤ Ry(θ[1]) ├┤ Ry(θ[1]) ├┤ Ry(θ[3]) ├
+ └───────┘└──────────┘└──────────┘└──────────┘
+>>> nlocal.parameters
+{Parameter(θ[1]), Parameter(θ[3])}
+>>> nlocal.ordered_parameters
+[1, Parameter(θ[1]), Parameter(θ[1]), Parameter(θ[3])]
+```
+
+**Returns**
+
+The parameters objects used in the circuit.
+
+
+
+### parameter\_bounds
+
+The parameter bounds for the unbound parameters in the circuit.
+
+**Returns**
+
+A list of pairs indicating the bounds, as (lower, upper). None indicates an unbounded parameter in the corresponding direction. If `None` is returned, problem is fully unbounded.
+
+
+
+### parameters
+
+
+
+### preferred\_init\_points
+
+Getter of preferred initial points based on the given initial state.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qregs
+
+`list[QuantumRegister]`
+
+A list of the quantum registers associated with the circuit.
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+
+
+### reps
+
+The number of times rotation and entanglement block are repeated.
+
+**Returns**
+
+The number of repetitions.
+
+
+
+### rotation\_blocks
+
+The blocks in the rotation layers.
+
+**Returns**
+
+The blocks in the rotation layers.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.ExactReciprocal.md b/docs/api/qiskit/0.46/qiskit.circuit.library.ExactReciprocal.md
new file mode 100644
index 00000000000..f21867e703e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.ExactReciprocal.md
@@ -0,0 +1,224 @@
+---
+title: ExactReciprocal
+description: API reference for qiskit.circuit.library.ExactReciprocal
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.ExactReciprocal
+---
+
+# ExactReciprocal
+
+
+
+`qiskit.circuit.library.ExactReciprocal(num_state_qubits, scaling, neg_vals=False, name='1/x')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/arithmetic/exact_reciprocal.py "view source code")
+
+Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+Exact reciprocal
+
+$$
+|x\rangle |0\rangle \mapsto \cos(1/x)|x\rangle|0\rangle + \sin(1/x)|x\rangle |1\rangle
+$$
+
+**Parameters**
+
+* **num\_state\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of qubits representing the value to invert.
+* **scaling** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Scaling factor $s$ of the reciprocal function, i.e. to compute $s / x$.
+* **neg\_vals** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether $x$ might represent negative values. In this case the first qubit is the sign, with $|1\rangle$ for negative and $|0\rangle$ for positive. For the negative case it is assumed that the remaining string represents $1 - x$. This is because $e^{-2 \pi i x} = e^{2 \pi i (1 - x)}$ for $x \in [0,1)$.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the object.
+
+
+ It is assumed that the binary string $x$ represents a number \< 1.
+
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 159`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.ExcitationPreserving.md b/docs/api/qiskit/0.46/qiskit.circuit.library.ExcitationPreserving.md
new file mode 100644
index 00000000000..c753ee5bd58
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.ExcitationPreserving.md
@@ -0,0 +1,370 @@
+---
+title: ExcitationPreserving
+description: API reference for qiskit.circuit.library.ExcitationPreserving
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.ExcitationPreserving
+---
+
+# ExcitationPreserving
+
+
+
+`qiskit.circuit.library.ExcitationPreserving(num_qubits=None, mode='iswap', entanglement='full', reps=3, skip_unentangled_qubits=False, skip_final_rotation_layer=False, parameter_prefix='θ', insert_barriers=False, initial_state=None, name='ExcitationPreserving', flatten=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/n_local/excitation_preserving.py "view source code")
+
+Bases: [`TwoLocal`](qiskit.circuit.library.TwoLocal "qiskit.circuit.library.n_local.two_local.TwoLocal")
+
+The heuristic excitation-preserving wave function ansatz.
+
+The `ExcitationPreserving` circuit preserves the ratio of $|00\rangle$, $|01\rangle + |10\rangle$ and $|11\rangle$ states. To this end, this circuit uses two-qubit interactions of the form
+
+$$
+\newcommand{\rotationangle}{\theta/2}
+
+\begin{pmatrix}
+1 & 0 & 0 & 0 \\
+0 & \cos\left(\rotationangle\right) & -i\sin\left(\rotationangle\right) & 0 \\
+0 & -i\sin\left(\rotationangle\right) & \cos\left(\rotationangle\right) & 0 \\
+0 & 0 & 0 & e^{-i\phi}
+\end{pmatrix}
+$$
+
+for the mode `'fsim'` or with $e^{-i\phi} = 1$ for the mode `'iswap'`.
+
+Note that other wave functions, such as UCC-ansatzes, are also excitation preserving. However these can become complex quickly, while this heuristically motivated circuit follows a simpler pattern.
+
+This trial wave function consists of layers of $Z$ rotations with 2-qubit entanglements. The entangling is creating using $XX+YY$ rotations and optionally a controlled-phase gate for the mode `'fsim'`.
+
+See [`RealAmplitudes`](qiskit.circuit.library.RealAmplitudes "qiskit.circuit.library.RealAmplitudes") for more detail on the possible arguments and options such as skipping unentanglement qubits, which apply here too.
+
+The rotations of the ExcitationPreserving ansatz can be written as
+
+**Examples**
+
+```python
+>>> ansatz = ExcitationPreserving(3, reps=1, insert_barriers=True, entanglement='linear')
+>>> print(ansatz) # show the circuit
+ ┌──────────┐ ░ ┌────────────┐┌────────────┐ ░ ┌──────────┐
+q_0: ┤ RZ(θ[0]) ├─░─┤0 ├┤0 ├─────────────────────────────░─┤ RZ(θ[5]) ├
+ ├──────────┤ ░ │ RXX(θ[3]) ││ RYY(θ[3]) │┌────────────┐┌────────────┐ ░ ├──────────┤
+q_1: ┤ RZ(θ[1]) ├─░─┤1 ├┤1 ├┤0 ├┤0 ├─░─┤ RZ(θ[6]) ├
+ ├──────────┤ ░ └────────────┘└────────────┘│ RXX(θ[4]) ││ RYY(θ[4]) │ ░ ├──────────┤
+q_2: ┤ RZ(θ[2]) ├─░─────────────────────────────┤1 ├┤1 ├─░─┤ RZ(θ[7]) ├
+ └──────────┘ ░ └────────────┘└────────────┘ ░ └──────────┘
+```
+
+```python
+>>> ansatz = ExcitationPreserving(2, reps=1)
+>>> qc = QuantumCircuit(2) # create a circuit and append the RY variational form
+>>> qc.cry(0.2, 0, 1) # do some previous operation
+>>> qc.compose(ansatz, inplace=True) # add the swaprz
+>>> qc.draw()
+ ┌──────────┐┌────────────┐┌────────────┐┌──────────┐
+q_0: ─────■─────┤ RZ(θ[0]) ├┤0 ├┤0 ├┤ RZ(θ[3]) ├
+ ┌────┴────┐├──────────┤│ RXX(θ[2]) ││ RYY(θ[2]) │├──────────┤
+q_1: ┤ RY(0.2) ├┤ RZ(θ[1]) ├┤1 ├┤1 ├┤ RZ(θ[4]) ├
+ └─────────┘└──────────┘└────────────┘└────────────┘└──────────┘
+```
+
+```python
+>>> ansatz = ExcitationPreserving(3, reps=1, mode='fsim', entanglement=[[0,2]],
+... insert_barriers=True)
+>>> print(ansatz)
+ ┌──────────┐ ░ ┌────────────┐┌────────────┐ ░ ┌──────────┐
+q_0: ┤ RZ(θ[0]) ├─░─┤0 ├┤0 ├─■──────░─┤ RZ(θ[5]) ├
+ ├──────────┤ ░ │ ││ │ │ ░ ├──────────┤
+q_1: ┤ RZ(θ[1]) ├─░─┤ RXX(θ[3]) ├┤ RYY(θ[3]) ├─┼──────░─┤ RZ(θ[6]) ├
+ ├──────────┤ ░ │ ││ │ │θ[4] ░ ├──────────┤
+q_2: ┤ RZ(θ[2]) ├─░─┤1 ├┤1 ├─■──────░─┤ RZ(θ[7]) ├
+ └──────────┘ ░ └────────────┘└────────────┘ ░ └──────────┘
+```
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of qubits of the ExcitationPreserving circuit.
+* **mode** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Choose the entangler mode, can be ‘iswap’ or ‘fsim’.
+* **reps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Specifies how often the structure of a rotation layer followed by an entanglement layer is repeated.
+* **entanglement** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]] | Callable\[\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*],* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]]*) – Specifies the entanglement structure. Can be a string (‘full’, ‘linear’ or ‘sca’), a list of integer-pairs specifying the indices of qubits entangled with one another, or a callable returning such a list provided with the index of the entanglement layer. See the Examples section of [`TwoLocal`](qiskit.circuit.library.TwoLocal "qiskit.circuit.library.TwoLocal") for more detail.
+* **initial\_state** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| None*) – A QuantumCircuit object to prepend to the circuit.
+* **skip\_unentangled\_qubits** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, the single qubit gates are only applied to qubits that are entangled with another qubit. If False, the single qubit gates are applied to each qubit in the Ansatz. Defaults to False.
+* **skip\_final\_rotation\_layer** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, a rotation layer is added at the end of the ansatz. If False, no rotation layer is added. Defaults to True.
+* **parameter\_prefix** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The parameterized gates require a parameter to be defined, for which we use [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector").
+* **insert\_barriers** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, barriers are inserted in between each layer. If False, no barriers are inserted.
+* **flatten** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – Set this to `True` to output a flat circuit instead of nesting it inside multiple layers of gate objects. By default currently the contents of the output circuit will be wrapped in nested objects for cleaner visualization. However, if you’re using this circuit for anything besides visualization its **strongly** recommended to set this flag to `True` to avoid a large performance overhead for parameter binding.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If the selected mode is not supported.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+
+
+### entanglement
+
+Get the entanglement strategy.
+
+**Returns**
+
+The entanglement strategy, see `get_entangler_map()` for more detail on how the format is interpreted.
+
+
+
+### entanglement\_blocks
+
+The blocks in the entanglement layers.
+
+**Returns**
+
+The blocks in the entanglement layers.
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### flatten
+
+Returns whether the circuit is wrapped in nested gates/instructions or flattened.
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### initial\_state
+
+Return the initial state that is added in front of the n-local circuit.
+
+**Returns**
+
+The initial state.
+
+
+
+### insert\_barriers
+
+If barriers are inserted in between the layers or not.
+
+**Returns**
+
+`True`, if barriers are inserted in between the layers, `False` if not.
+
+
+
+### instances
+
+`= 159`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_layers
+
+Return the number of layers in the n-local circuit.
+
+**Returns**
+
+The number of layers in the circuit.
+
+
+
+### num\_parameters
+
+
+
+### num\_parameters\_settable
+
+The number of total parameters that can be set to distinct values.
+
+This does not change when the parameters are bound or exchanged for same parameters, and therefore is different from `num_parameters` which counts the number of unique [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects currently in the circuit.
+
+**Returns**
+
+The number of parameters originally available in the circuit.
+
+
+ This quantity does not require the circuit to be built yet.
+
+
+
+
+### num\_qubits
+
+Returns the number of qubits in this circuit.
+
+**Returns**
+
+The number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### ordered\_parameters
+
+The parameters used in the underlying circuit.
+
+This includes float values and duplicates.
+
+**Examples**
+
+```python
+>>> # prepare circuit ...
+>>> print(nlocal)
+ ┌───────┐┌──────────┐┌──────────┐┌──────────┐
+q_0: ┤ Ry(1) ├┤ Ry(θ[1]) ├┤ Ry(θ[1]) ├┤ Ry(θ[3]) ├
+ └───────┘└──────────┘└──────────┘└──────────┘
+>>> nlocal.parameters
+{Parameter(θ[1]), Parameter(θ[3])}
+>>> nlocal.ordered_parameters
+[1, Parameter(θ[1]), Parameter(θ[1]), Parameter(θ[3])]
+```
+
+**Returns**
+
+The parameters objects used in the circuit.
+
+
+
+### parameter\_bounds
+
+Return the parameter bounds.
+
+**Returns**
+
+The parameter bounds.
+
+
+
+### parameters
+
+
+
+### preferred\_init\_points
+
+The initial points for the parameters. Can be stored as initial guess in optimization.
+
+**Returns**
+
+The initial values for the parameters, or None, if none have been set.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qregs
+
+`list[QuantumRegister]`
+
+A list of the quantum registers associated with the circuit.
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+
+
+### reps
+
+The number of times rotation and entanglement block are repeated.
+
+**Returns**
+
+The number of repetitions.
+
+
+
+### rotation\_blocks
+
+The blocks in the rotation layers.
+
+**Returns**
+
+The blocks in the rotation layers.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.FourierChecking.md b/docs/api/qiskit/0.46/qiskit.circuit.library.FourierChecking.md
new file mode 100644
index 00000000000..934e100e187
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.FourierChecking.md
@@ -0,0 +1,238 @@
+---
+title: FourierChecking
+description: API reference for qiskit.circuit.library.FourierChecking
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.FourierChecking
+---
+
+# FourierChecking
+
+
+
+`qiskit.circuit.library.FourierChecking(f, g)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/fourier_checking.py "view source code")
+
+Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+Fourier checking circuit.
+
+The circuit for the Fourier checking algorithm, introduced in \[1], involves a layer of Hadamards, the function $f$, another layer of Hadamards, the function $g$, followed by a final layer of Hadamards. The functions $f$ and $g$ are classical functions realized as phase oracles (diagonal operators with \{-1, 1} on the diagonal).
+
+The probability of observing the all-zeros string is $p(f,g)$. The algorithm solves the promise Fourier checking problem, which decides if f is correlated with the Fourier transform of g, by testing if $p(f,g) <= 0.01$ or $p(f,g) >= 0.05$, promised that one or the other of these is true.
+
+The functions $f$ and $g$ are currently implemented from their truth tables but could be represented concisely and implemented efficiently for special classes of functions.
+
+Fourier checking is a special case of $k$-fold forrelation \[2].
+
+**Reference:**
+
+\[1] S. Aaronson, BQP and the Polynomial Hierarchy, 2009 (Section 3.2). [arXiv:0910.4698](https://arxiv.org/abs/0910.4698)
+
+\[2] S. Aaronson, A. Ambainis, Forrelation: a problem that optimally separates quantum from classical computing, 2014. [arXiv:1411.5729](https://arxiv.org/abs/1411.5729)
+
+Create Fourier checking circuit.
+
+**Parameters**
+
+* **f** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – truth table for f, length 2\*\*n list of \{1,-1}.
+* **g** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – truth table for g, length 2\*\*n list of \{1,-1}.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the inputs f and g are not valid.
+
+**Reference Circuit:**
+
+
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 167`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.FunctionalPauliRotations.md b/docs/api/qiskit/0.46/qiskit.circuit.library.FunctionalPauliRotations.md
new file mode 100644
index 00000000000..1684121a616
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.FunctionalPauliRotations.md
@@ -0,0 +1,188 @@
+---
+title: FunctionalPauliRotations
+description: API reference for qiskit.circuit.library.FunctionalPauliRotations
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.FunctionalPauliRotations
+---
+
+# FunctionalPauliRotations
+
+
+
+`qiskit.circuit.library.FunctionalPauliRotations(num_state_qubits=None, basis='Y', name='F')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/arithmetic/functional_pauli_rotations.py "view source code")
+
+Bases: `BlueprintCircuit`, [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Base class for functional Pauli rotations.
+
+Create a new functional Pauli rotation circuit.
+
+**Parameters**
+
+* **num\_state\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of qubits representing the state $|x\rangle$.
+* **basis** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The kind of Pauli rotation to use. Must be ‘X’, ‘Y’ or ‘Z’.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the circuit object.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### basis
+
+The kind of Pauli rotation to be used.
+
+Set the basis to ‘X’, ‘Y’ or ‘Z’ for controlled-X, -Y, or -Z rotations respectively.
+
+**Returns**
+
+The kind of Pauli rotation used in controlled rotation.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 169`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancilla\_qubits
+
+The minimum number of ancilla qubits in the circuit.
+
+**Returns**
+
+The minimal number of ancillas required.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### num\_state\_qubits
+
+The number of state qubits representing the state $|x\rangle$.
+
+**Returns**
+
+The number of state qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qregs
+
+`list[QuantumRegister]`
+
+A list of the quantum registers associated with the circuit.
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.GMS.md b/docs/api/qiskit/0.46/qiskit.circuit.library.GMS.md
new file mode 100644
index 00000000000..5f3778d8236
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.GMS.md
@@ -0,0 +1,247 @@
+---
+title: GMS
+description: API reference for qiskit.circuit.library.GMS
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.GMS
+---
+
+# GMS
+
+
+
+`qiskit.circuit.library.GMS(num_qubits, theta)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/generalized_gates/gms.py "view source code")
+
+Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+Global Mølmer–Sørensen gate.
+
+**Circuit symbol:**
+
+```python
+ ┌───────────┐
+q_0: ┤0 ├
+ │ │
+q_1: ┤1 GMS ├
+ │ │
+q_2: ┤2 ├
+ └───────────┘
+```
+
+**Expanded Circuit:**
+
+
+
+The Mølmer–Sørensen gate is native to ion-trap systems. The global MS can be applied to multiple ions to entangle multiple qubits simultaneously \[1].
+
+In the two-qubit case, this is equivalent to an XX(theta) interaction, and is thus reduced to the RXXGate. The global MS gate is a sum of XX interactions on all pairs \[2].
+
+$$
+GMS(\chi_{12}, \chi_{13}, ..., \chi_{n-1 n}) =
+exp(-i \sum_{i=1}^{n} \sum_{j=i+1}^{n} X{\otimes}X \frac{\chi_{ij}}{2})
+$$
+
+**References:**
+
+\[1] Sørensen, A. and Mølmer, K., Multi-particle entanglement of hot trapped ions. Physical Review Letters. 82 (9): 1835–1838. [arXiv:9810040](https://arxiv.org/abs/quant-ph/9810040)
+
+\[2] Maslov, D. and Nam, Y., Use of global interactions in efficient quantum circuit constructions. New Journal of Physics, 20(3), p.033018. [arXiv:1707.06356](https://arxiv.org/abs/1707.06356)
+
+Create a new Global Mølmer–Sørensen (GMS) gate.
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – width of gate.
+* **theta** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] |* [*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – a num\_qubits x num\_qubits symmetric matrix of interaction angles for each qubit pair. The upper triangle is considered.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 170`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.GR.md b/docs/api/qiskit/0.46/qiskit.circuit.library.GR.md
new file mode 100644
index 00000000000..05a546b6989
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.GR.md
@@ -0,0 +1,241 @@
+---
+title: GR
+description: API reference for qiskit.circuit.library.GR
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.GR
+---
+
+# GR
+
+
+
+`qiskit.circuit.library.GR(num_qubits, theta, phi)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/generalized_gates/gr.py "view source code")
+
+Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+Global R gate.
+
+**Circuit symbol:**
+
+```python
+ ┌──────────┐
+q_0: ┤0 ├
+ │ │
+q_1: ┤1 GR(ϴ,φ) ├
+ │ │
+q_2: ┤2 ├
+ └──────────┘
+```
+
+The global R gate is native to atomic systems (ion traps, cold neutrals). The global R can be applied to multiple qubits simultaneously.
+
+In the one-qubit case, this is equivalent to an R(theta, phi) operation, and is thus reduced to the RGate. The global R gate is a direct sum of R operations on all individual qubits.
+
+$$
+GR(\theta, \phi) = \exp(-i \sum_{i=1}^{n} (\cos(\phi)X_i + \sin(\phi)Y_i) \theta/2)
+$$
+
+**Expanded Circuit:**
+
+
+
+Create a new Global R (GR) gate.
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of qubits.
+* **theta** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – rotation angle about axis determined by phi
+* **phi** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – angle of rotation axis in xy-plane
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 179`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.GRX.md b/docs/api/qiskit/0.46/qiskit.circuit.library.GRX.md
new file mode 100644
index 00000000000..97ceb86234e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.GRX.md
@@ -0,0 +1,240 @@
+---
+title: GRX
+description: API reference for qiskit.circuit.library.GRX
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.GRX
+---
+
+# GRX
+
+
+
+`qiskit.circuit.library.GRX(num_qubits, theta)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/generalized_gates/gr.py "view source code")
+
+Bases: [`GR`](qiskit.circuit.library.GR "qiskit.circuit.library.generalized_gates.gr.GR")
+
+Global RX gate.
+
+**Circuit symbol:**
+
+```python
+ ┌──────────┐
+q_0: ┤0 ├
+ │ │
+q_1: ┤1 GRX(ϴ) ├
+ │ │
+q_2: ┤2 ├
+ └──────────┘
+```
+
+The global RX gate is native to atomic systems (ion traps, cold neutrals). The global RX can be applied to multiple qubits simultaneously.
+
+In the one-qubit case, this is equivalent to an RX(theta) operations, and is thus reduced to the RXGate. The global RX gate is a direct sum of RX operations on all individual qubits.
+
+$$
+GRX(\theta) = \exp(-i \sum_{i=1}^{n} X_i \theta/2)
+$$
+
+**Expanded Circuit:**
+
+
+
+Create a new Global RX (GRX) gate.
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of qubits.
+* **theta** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – rotation angle about x-axis
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 180`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.GRY.md b/docs/api/qiskit/0.46/qiskit.circuit.library.GRY.md
new file mode 100644
index 00000000000..ebbf81c46f2
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.GRY.md
@@ -0,0 +1,240 @@
+---
+title: GRY
+description: API reference for qiskit.circuit.library.GRY
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.GRY
+---
+
+# GRY
+
+
+
+`qiskit.circuit.library.GRY(num_qubits, theta)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/generalized_gates/gr.py "view source code")
+
+Bases: [`GR`](qiskit.circuit.library.GR "qiskit.circuit.library.generalized_gates.gr.GR")
+
+Global RY gate.
+
+**Circuit symbol:**
+
+```python
+ ┌──────────┐
+q_0: ┤0 ├
+ │ │
+q_1: ┤1 GRY(ϴ) ├
+ │ │
+q_2: ┤2 ├
+ └──────────┘
+```
+
+The global RY gate is native to atomic systems (ion traps, cold neutrals). The global RY can be applied to multiple qubits simultaneously.
+
+In the one-qubit case, this is equivalent to an RY(theta) operation, and is thus reduced to the RYGate. The global RY gate is a direct sum of RY operations on all individual qubits.
+
+$$
+GRY(\theta) = \exp(-i \sum_{i=1}^{n} Y_i \theta/2)
+$$
+
+**Expanded Circuit:**
+
+
+
+Create a new Global RY (GRY) gate.
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of qubits.
+* **theta** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – rotation angle about y-axis
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 180`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.GRZ.md b/docs/api/qiskit/0.46/qiskit.circuit.library.GRZ.md
new file mode 100644
index 00000000000..b0e9595effa
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.GRZ.md
@@ -0,0 +1,240 @@
+---
+title: GRZ
+description: API reference for qiskit.circuit.library.GRZ
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.GRZ
+---
+
+# GRZ
+
+
+
+`qiskit.circuit.library.GRZ(num_qubits, phi)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/generalized_gates/gr.py "view source code")
+
+Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+Global RZ gate.
+
+**Circuit symbol:**
+
+```python
+ ┌──────────┐
+q_0: ┤0 ├
+ │ │
+q_1: ┤1 GRZ(φ) ├
+ │ │
+q_2: ┤2 ├
+ └──────────┘
+```
+
+The global RZ gate is native to atomic systems (ion traps, cold neutrals). The global RZ can be applied to multiple qubits simultaneously.
+
+In the one-qubit case, this is equivalent to an RZ(phi) operation, and is thus reduced to the RZGate. The global RZ gate is a direct sum of RZ operations on all individual qubits.
+
+$$
+GRZ(\phi) = \exp(-i \sum_{i=1}^{n} Z_i \phi)
+$$
+
+**Expanded Circuit:**
+
+
+
+Create a new Global RZ (GRZ) gate.
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of qubits.
+* **phi** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – rotation angle about z-axis
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 190`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.GlobalPhaseGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.GlobalPhaseGate.md
new file mode 100644
index 00000000000..b3e0d99bcf4
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.GlobalPhaseGate.md
@@ -0,0 +1,145 @@
+---
+title: GlobalPhaseGate
+description: API reference for qiskit.circuit.library.GlobalPhaseGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.GlobalPhaseGate
+---
+
+# GlobalPhaseGate
+
+
+
+`qiskit.circuit.library.GlobalPhaseGate(phase, label=None, *, duration=None, unit='dt')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/global_phase.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+The global phase gate ($e^{i\theta}$).
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Mathematical Representation:**
+
+$$
+\text{GlobalPhaseGate}\ =
+ \begin{pmatrix}
+ e^{i\theta}
+ \end{pmatrix}
+
+
+$$
+
+**Parameters**
+
+* **phase** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The value of phase it takes.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – An optional label for the gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.GlobalPhaseGate.base_class "qiskit.circuit.library.GlobalPhaseGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted GLobalPhaseGate gate.
+
+$\text{GlobalPhaseGate}(\lambda)^{\dagger} = \text{GlobalPhaseGate}(-\lambda)$
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.GraphState.md b/docs/api/qiskit/0.46/qiskit.circuit.library.GraphState.md
new file mode 100644
index 00000000000..38157921792
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.GraphState.md
@@ -0,0 +1,245 @@
+---
+title: GraphState
+description: API reference for qiskit.circuit.library.GraphState
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.GraphState
+---
+
+# GraphState
+
+
+
+`qiskit.circuit.library.GraphState(adjacency_matrix)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/graph_state.py "view source code")
+
+Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+Circuit to prepare a graph state.
+
+Given a graph G = (V, E), with the set of vertices V and the set of edges E, the corresponding graph state is defined as
+
+$$
+|G\rangle = \prod_{(a,b) \in E} CZ_{(a,b)} {|+\rangle}^{\otimes V}
+$$
+
+Such a state can be prepared by first preparing all qubits in the $+$ state, then applying a $CZ$ gate for each corresponding graph edge.
+
+Graph state preparation circuits are Clifford circuits, and thus easy to simulate classically. However, by adding a layer of measurements in a product basis at the end, there is evidence that the circuit becomes hard to simulate \[2].
+
+**Reference Circuit:**
+
+
+
+**References:**
+
+**\[1] M. Hein, J. Eisert, H.J. Briegel, Multi-party Entanglement in Graph States,**
+
+[arXiv:0307130](https://arxiv.org/pdf/quant-ph/0307130.pdf)
+
+**\[2] D. Koh, Further Extensions of Clifford Circuits & their Classical Simulation Complexities.**
+
+[arXiv:1512.07892](https://arxiv.org/pdf/1512.07892.pdf)
+
+Create graph state preparation circuit.
+
+**Parameters**
+
+**adjacency\_matrix** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *| np.ndarray*) – input graph as n-by-n list of 0-1 lists
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If adjacency\_matrix is not symmetric.
+
+The circuit prepares a graph state with the given adjacency matrix.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 195`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.GroverOperator.md b/docs/api/qiskit/0.46/qiskit.circuit.library.GroverOperator.md
new file mode 100644
index 00000000000..90d206d52b4
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.GroverOperator.md
@@ -0,0 +1,380 @@
+---
+title: GroverOperator
+description: API reference for qiskit.circuit.library.GroverOperator
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.GroverOperator
+---
+
+# GroverOperator
+
+
+
+`qiskit.circuit.library.GroverOperator(oracle, state_preparation=None, zero_reflection=None, reflection_qubits=None, insert_barriers=False, mcx_mode='noancilla', name='Q')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/grover_operator.py "view source code")
+
+Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+The Grover operator.
+
+Grover’s search algorithm \[1, 2] consists of repeated applications of the so-called Grover operator used to amplify the amplitudes of the desired output states. This operator, $\mathcal{Q}$, consists of the phase oracle, $\mathcal{S}_f$, zero phase-shift or zero reflection, $\mathcal{S}_0$, and an input state preparation $\mathcal{A}$:
+
+$$
+\mathcal{Q} = \mathcal{A} \mathcal{S}_0 \mathcal{A}^\dagger \mathcal{S}_f
+
+
+$$
+
+In the standard Grover search we have $\mathcal{A} = H^{\otimes n}$:
+
+$$
+\mathcal{Q} = H^{\otimes n} \mathcal{S}_0 H^{\otimes n} \mathcal{S}_f
+ = D \mathcal{S_f}
+
+
+$$
+
+The operation $D = H^{\otimes n} \mathcal{S}_0 H^{\otimes n}$ is also referred to as diffusion operator. In this formulation we can see that Grover’s operator consists of two steps: first, the phase oracle multiplies the good states by -1 (with $\mathcal{S}_f$) and then the whole state is reflected around the mean (with $D$).
+
+This class allows setting a different state preparation, as in quantum amplitude amplification (a generalization of Grover’s algorithm), $\mathcal{A}$ might not be a layer of Hardamard gates \[3].
+
+The action of the phase oracle $\mathcal{S}_f$ is defined as
+
+$$
+\mathcal{S}_f: |x\rangle \mapsto (-1)^{f(x)}|x\rangle
+
+
+$$
+
+where $f(x) = 1$ if $x$ is a good state and 0 otherwise. To highlight the fact that this oracle flips the phase of the good states and does not flip the state of a result qubit, we call $\mathcal{S}_f$ a phase oracle.
+
+Note that you can easily construct a phase oracle from a bitflip oracle by sandwiching the controlled X gate on the result qubit by a X and H gate. For instance
+
+```python
+Bitflip oracle Phaseflip oracle
+q_0: ──■── q_0: ────────────■────────────
+ ┌─┴─┐ ┌───┐┌───┐┌─┴─┐┌───┐┌───┐
+out: ┤ X ├ out: ┤ X ├┤ H ├┤ X ├┤ H ├┤ X ├
+ └───┘ └───┘└───┘└───┘└───┘└───┘
+```
+
+There is some flexibility in defining the oracle and $\mathcal{A}$ operator. Before the Grover operator is applied in Grover’s algorithm, the qubits are first prepared with one application of the $\mathcal{A}$ operator (or Hadamard gates in the standard formulation). Thus, we always have operation of the form $\mathcal{A} \mathcal{S}_f \mathcal{A}^\dagger$. Therefore it is possible to move bitflip logic into $\mathcal{A}$ and leaving the oracle only to do phaseflips via Z gates based on the bitflips. One possible use-case for this are oracles that do not uncompute the state qubits.
+
+The zero reflection $\mathcal{S}_0$ is usually defined as
+
+$$
+\mathcal{S}_0 = 2 |0\rangle^{\otimes n} \langle 0|^{\otimes n} - \mathbb{I}_n
+
+
+$$
+
+where $\mathbb{I}_n$ is the identity on $n$ qubits. By default, this class implements the negative version $2 |0\rangle^{\otimes n} \langle 0|^{\otimes n} - \mathbb{I}_n$, since this can simply be implemented with a multi-controlled Z sandwiched by X gates on the target qubit and the introduced global phase does not matter for Grover’s algorithm.
+
+**Examples**
+
+```python
+>>> from qiskit.circuit import QuantumCircuit
+>>> from qiskit.circuit.library import GroverOperator
+>>> oracle = QuantumCircuit(2)
+>>> oracle.z(0) # good state = first qubit is |1>
+>>> grover_op = GroverOperator(oracle, insert_barriers=True)
+>>> grover_op.decompose().draw()
+ ┌───┐ ░ ┌───┐ ░ ┌───┐ ┌───┐ ░ ┌───┐
+state_0: ┤ Z ├─░─┤ H ├─░─┤ X ├───────■──┤ X ├──────░─┤ H ├
+ └───┘ ░ ├───┤ ░ ├───┤┌───┐┌─┴─┐├───┤┌───┐ ░ ├───┤
+state_1: ──────░─┤ H ├─░─┤ X ├┤ H ├┤ X ├┤ H ├┤ X ├─░─┤ H ├
+ ░ └───┘ ░ └───┘└───┘└───┘└───┘└───┘ ░ └───┘
+```
+
+```python
+>>> oracle = QuantumCircuit(1)
+>>> oracle.z(0) # the qubit state |1> is the good state
+>>> state_preparation = QuantumCircuit(1)
+>>> state_preparation.ry(0.2, 0) # non-uniform state preparation
+>>> grover_op = GroverOperator(oracle, state_preparation)
+>>> grover_op.decompose().draw()
+ ┌───┐┌──────────┐┌───┐┌───┐┌───┐┌─────────┐
+state_0: ┤ Z ├┤ RY(-0.2) ├┤ X ├┤ Z ├┤ X ├┤ RY(0.2) ├
+ └───┘└──────────┘└───┘└───┘└───┘└─────────┘
+```
+
+```python
+>>> oracle = QuantumCircuit(4)
+>>> oracle.z(3)
+>>> reflection_qubits = [0, 3]
+>>> state_preparation = QuantumCircuit(4)
+>>> state_preparation.cry(0.1, 0, 3)
+>>> state_preparation.ry(0.5, 3)
+>>> grover_op = GroverOperator(oracle, state_preparation,
+... reflection_qubits=reflection_qubits)
+>>> grover_op.decompose().draw()
+ ┌───┐ ┌───┐
+state_0: ──────────────────────■──────┤ X ├───────■──┤ X ├──────────■────────────────
+ │ └───┘ │ └───┘ │
+state_1: ──────────────────────┼──────────────────┼─────────────────┼────────────────
+ │ │ │
+state_2: ──────────────────────┼──────────────────┼─────────────────┼────────────────
+ ┌───┐┌──────────┐┌────┴─────┐┌───┐┌───┐┌─┴─┐┌───┐┌───┐┌────┴────┐┌─────────┐
+state_3: ┤ Z ├┤ RY(-0.5) ├┤ RY(-0.1) ├┤ X ├┤ H ├┤ X ├┤ H ├┤ X ├┤ RY(0.1) ├┤ RY(0.5) ├
+ └───┘└──────────┘└──────────┘└───┘└───┘└───┘└───┘└───┘└─────────┘└─────────┘
+```
+
+```python
+>>> mark_state = Statevector.from_label('011')
+>>> diffuse_operator = 2 * DensityMatrix.from_label('000') - Operator.from_label('III')
+>>> grover_op = GroverOperator(oracle=mark_state, zero_reflection=diffuse_operator)
+>>> grover_op.decompose().draw(fold=70)
+ ┌─────────────────┐ ┌───┐ »
+state_0: ┤0 ├──────┤ H ├──────────────────────────»
+ │ │┌─────┴───┴─────┐ ┌───┐ »
+state_1: ┤1 UCRZ(0,pi,0,0) ├┤0 ├─────┤ H ├──────────»
+ │ ││ UCRZ(pi/2,0) │┌────┴───┴────┐┌───┐»
+state_2: ┤2 ├┤1 ├┤ UCRZ(-pi/4) ├┤ H ├»
+ └─────────────────┘└───────────────┘└─────────────┘└───┘»
+« ┌─────────────────┐ ┌───┐
+«state_0: ┤0 ├──────┤ H ├─────────────────────────
+« │ │┌─────┴───┴─────┐ ┌───┐
+«state_1: ┤1 UCRZ(pi,0,0,0) ├┤0 ├────┤ H ├──────────
+« │ ││ UCRZ(pi/2,0) │┌───┴───┴────┐┌───┐
+«state_2: ┤2 ├┤1 ├┤ UCRZ(pi/4) ├┤ H ├
+« └─────────────────┘└───────────────┘└────────────┘└───┘
+```
+
+**References**
+
+**\[1]: L. K. Grover (1996), A fast quantum mechanical algorithm for database search,**
+
+[arXiv:quant-ph/9605043](https://arxiv.org/abs/quant-ph/9605043).
+
+**\[2]: I. Chuang & M. Nielsen, Quantum Computation and Quantum Information,**
+
+Cambridge: Cambridge University Press, 2000. Chapter 6.1.2.
+
+**\[3]: Brassard, G., Hoyer, P., Mosca, M., & Tapp, A. (2000).**
+
+Quantum Amplitude Amplification and Estimation. [arXiv:quant-ph/0005055](http://arxiv.org/abs/quant-ph/0005055).
+
+**Parameters**
+
+* **oracle** (*Union\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*,* [*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector")*]*) – The phase oracle implementing a reflection about the bad state. Note that this is not a bitflip oracle, see the docstring for more information.
+* **state\_preparation** (*Optional\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – The operator preparing the good and bad state. For Grover’s algorithm, this is a n-qubit Hadamard gate and for amplitude amplification or estimation the operator $\mathcal{A}$.
+* **zero\_reflection** (*Optional\[Union\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*,* [*DensityMatrix*](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")*,* [*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")*]]*) – The reflection about the zero state, $\mathcal{S}_0$.
+* **reflection\_qubits** (*Optional\[List\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]]*) – Qubits on which the zero reflection acts on.
+* **insert\_barriers** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether barriers should be inserted between the reflections and A.
+* **mcx\_mode** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The mode to use for building the default zero reflection.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the circuit.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 197`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### oracle
+
+The oracle implementing a reflection about the bad state.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+
+
+### reflection\_qubits
+
+Reflection qubits, on which S0 is applied (if S0 is not user-specified).
+
+
+
+### state\_preparation
+
+The subcircuit implementing the A operator or Hadamards.
+
+
+
+### zero\_reflection
+
+The subcircuit implementing the reflection about 0.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.HGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.HGate.md
new file mode 100644
index 00000000000..5c77f0b5226
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.HGate.md
@@ -0,0 +1,173 @@
+---
+title: HGate
+description: API reference for qiskit.circuit.library.HGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.HGate
+---
+
+# HGate
+
+
+
+`qiskit.circuit.library.HGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/h.py "view source code")
+
+Bases: [`SingletonGate`](circuit_singleton#qiskit.circuit.singleton.SingletonGate "qiskit.circuit.singleton.SingletonGate")
+
+Single-qubit Hadamard gate.
+
+This gate is a pi rotation about the X+Z axis, and has the effect of changing computation basis from $|0\rangle,|1\rangle$ to $|+\rangle,|-\rangle$ and vice-versa.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`h()`](qiskit.circuit.QuantumCircuit#h "qiskit.circuit.QuantumCircuit.h") method.
+
+**Circuit symbol:**
+
+```python
+ ┌───┐
+q_0: ┤ H ├
+ └───┘
+```
+
+**Matrix Representation:**
+
+$$
+H = \frac{1}{\sqrt{2}}
+ \begin{pmatrix}
+ 1 & 1 \\
+ 1 & -1
+ \end{pmatrix}
+$$
+
+Create new H gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.HGate.base_class "qiskit.circuit.library.HGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Return a (multi-)controlled-H gate.
+
+One control qubit returns a CH gate.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of control qubits.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for the gate \[Default: None]
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – control state expressed as integer, string (e.g. ‘110’), or None. If None, use all 1s.
+
+**Returns**
+
+controlled version of this gate.
+
+**Return type**
+
+[ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted H gate (itself).
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.HRSCumulativeMultiplier.md b/docs/api/qiskit/0.46/qiskit.circuit.library.HRSCumulativeMultiplier.md
new file mode 100644
index 00000000000..c81fb1044d6
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.HRSCumulativeMultiplier.md
@@ -0,0 +1,277 @@
+---
+title: HRSCumulativeMultiplier
+description: API reference for qiskit.circuit.library.HRSCumulativeMultiplier
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.HRSCumulativeMultiplier
+---
+
+# HRSCumulativeMultiplier
+
+
+
+`qiskit.circuit.library.HRSCumulativeMultiplier(num_state_qubits, num_result_qubits=None, adder=None, name='HRSCumulativeMultiplier')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/arithmetic/multipliers/hrs_cumulative_multiplier.py "view source code")
+
+Bases: `Multiplier`
+
+A multiplication circuit to store product of two input registers out-of-place.
+
+Circuit uses the approach from \[1]. As an example, a multiplier circuit that performs a non-modular multiplication on two 3-qubit sized registers with the default adder is as follows (where `Adder` denotes the `CDKMRippleCarryAdder`):
+
+```python
+ a_0: ────■─────────────────────────
+ │
+ a_1: ────┼─────────■───────────────
+ │ │
+ a_2: ────┼─────────┼─────────■─────
+ ┌───┴────┐┌───┴────┐┌───┴────┐
+ b_0: ┤0 ├┤0 ├┤0 ├
+ │ ││ ││ │
+ b_1: ┤1 ├┤1 ├┤1 ├
+ │ ││ ││ │
+ b_2: ┤2 ├┤2 ├┤2 ├
+ │ ││ ││ │
+out_0: ┤3 ├┤ ├┤ ├
+ │ ││ ││ │
+out_1: ┤4 ├┤3 ├┤ ├
+ │ Adder ││ Adder ││ Adder │
+out_2: ┤5 ├┤4 ├┤3 ├
+ │ ││ ││ │
+out_3: ┤6 ├┤5 ├┤4 ├
+ │ ││ ││ │
+out_4: ┤ ├┤6 ├┤5 ├
+ │ ││ ││ │
+out_5: ┤ ├┤ ├┤6 ├
+ │ ││ ││ │
+aux_0: ┤7 ├┤7 ├┤7 ├
+ └────────┘└────────┘└────────┘
+```
+
+Multiplication in this circuit is implemented in a classical approach by performing a series of shifted additions using one of the input registers while the qubits from the other input register act as control qubits for the adders.
+
+**References:**
+
+\[1] Häner et al., Optimizing Quantum Circuits for Arithmetic, 2018. [arXiv:1805.12445](https://arxiv.org/pdf/1805.12445.pdf)
+
+**Parameters**
+
+* **num\_state\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of qubits in either input register for state $|a\rangle$ or $|b\rangle$. The two input registers must have the same number of qubits.
+* **num\_result\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of result qubits to limit the output to. If number of result qubits is $n$, multiplication modulo $2^n$ is performed to limit the output to the specified number of qubits. Default value is `2 * num_state_qubits` to represent any possible result from the multiplication of the two inputs.
+* **adder** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit") *| None*) – Half adder circuit to be used for performing multiplication. The CDKMRippleCarryAdder is used as default if no adder is provided.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the circuit object.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – If `num_result_qubits` is not default and a custom adder is provided.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 197`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### num\_result\_qubits
+
+The number of result qubits to limit the output to.
+
+**Returns**
+
+The number of result qubits.
+
+
+
+### num\_state\_qubits
+
+The number of state qubits, i.e. the number of bits in each input register.
+
+**Returns**
+
+The number of state qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.HamiltonianGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.HamiltonianGate.md
new file mode 100644
index 00000000000..238f01bb122
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.HamiltonianGate.md
@@ -0,0 +1,181 @@
+---
+title: HamiltonianGate
+description: API reference for qiskit.circuit.library.HamiltonianGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.HamiltonianGate
+---
+
+# HamiltonianGate
+
+
+
+`qiskit.circuit.library.HamiltonianGate(data, time, label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/hamiltonian_gate.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+Class for representing evolution by a Hamiltonian operator as a gate.
+
+This gate resolves to a [`UnitaryGate`](qiskit.circuit.library.UnitaryGate "qiskit.circuit.library.UnitaryGate") as $U(t) = \exp(-i t H)$, which can be decomposed into basis gates if it is 2 qubits or less, or simulated directly in Aer for more qubits.
+
+**Parameters**
+
+* **data** (*np.ndarray |* [*Gate*](qiskit.circuit.Gate "qiskit.circuit.Gate") *| BaseOperator*) – A hermitian operator.
+* **time** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")) – Time evolution parameter.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Unitary name for backend \[Default: None].
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – if input data is not an N-qubit unitary operator.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.HamiltonianGate.base_class "qiskit.circuit.library.HamiltonianGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return the adjoint of the unitary.
+
+### conjugate
+
+
+
+`conjugate()`
+
+Return the conjugate of the Hamiltonian.
+
+### inverse
+
+
+
+`inverse()`
+
+Return the adjoint of the unitary.
+
+### qasm
+
+
+
+`qasm()`
+
+Raise an error, as QASM is not defined for the HamiltonianGate.
+
+
+ The method `qiskit.circuit.library.hamiltonian_gate.HamiltonianGate.qasm()` is deprecated as of qiskit-terra 0.25.0. It will be removed in the Qiskit 1.0 release.
+
+
+### transpose
+
+
+
+`transpose()`
+
+Return the transpose of the Hamiltonian.
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Hamiltonian parameter has to be an ndarray, operator or float.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.HiddenLinearFunction.md b/docs/api/qiskit/0.46/qiskit.circuit.library.HiddenLinearFunction.md
new file mode 100644
index 00000000000..fd6852f11f6
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.HiddenLinearFunction.md
@@ -0,0 +1,247 @@
+---
+title: HiddenLinearFunction
+description: API reference for qiskit.circuit.library.HiddenLinearFunction
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.HiddenLinearFunction
+---
+
+# HiddenLinearFunction
+
+
+
+`qiskit.circuit.library.HiddenLinearFunction(adjacency_matrix)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/hidden_linear_function.py "view source code")
+
+Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+Circuit to solve the hidden linear function problem.
+
+The 2D Hidden Linear Function problem is determined by a 2D adjacency matrix A, where only elements that are nearest-neighbor on a grid have non-zero entries. Each row/column corresponds to one binary variable $x_i$.
+
+The hidden linear function problem is as follows:
+
+Consider the quadratic form
+
+$$
+q(x) = \sum_{i,j=1}^{n}{x_i x_j} ~(\mathrm{mod}~ 4)
+$$
+
+and restrict $q(x)$ onto the nullspace of A. This results in a linear function.
+
+$$
+2 \sum_{i=1}^{n}{z_i x_i} ~(\mathrm{mod}~ 4) \forall x \in \mathrm{Ker}(A)
+$$
+
+and the goal is to recover this linear function (equivalently a vector $[z_0, ..., z_{n-1}]$). There can be multiple solutions.
+
+In \[1] it is shown that the present circuit solves this problem on a quantum computer in constant depth, whereas any corresponding solution on a classical computer would require circuits that grow logarithmically with $n$. Thus this circuit is an example of quantum advantage with shallow circuits.
+
+**Reference Circuit:**
+
+> 
+
+**Reference:**
+
+\[1] S. Bravyi, D. Gosset, R. Koenig, Quantum Advantage with Shallow Circuits, 2017. [arXiv:1704.00690](https://arxiv.org/abs/1704.00690)
+
+Create new HLF circuit.
+
+**Parameters**
+
+**adjacency\_matrix** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]] |* [*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – a symmetric n-by-n list of 0-1 lists. n will be the number of qubits.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If A is not symmetric.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 199`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.IGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.IGate.md
new file mode 100644
index 00000000000..8616cf72a7d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.IGate.md
@@ -0,0 +1,156 @@
+---
+title: IGate
+description: API reference for qiskit.circuit.library.IGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.IGate
+---
+
+# IGate
+
+
+
+`qiskit.circuit.library.IGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/i.py "view source code")
+
+Bases: [`SingletonGate`](circuit_singleton#qiskit.circuit.singleton.SingletonGate "qiskit.circuit.singleton.SingletonGate")
+
+Identity gate.
+
+Identity gate corresponds to a single-qubit gate wait cycle, and should not be optimized or unrolled (it is an opaque gate).
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`i()`](qiskit.circuit.QuantumCircuit#i "qiskit.circuit.QuantumCircuit.i") and [`id()`](qiskit.circuit.QuantumCircuit#id "qiskit.circuit.QuantumCircuit.id") methods.
+
+**Matrix Representation:**
+
+$$
+I = \begin{pmatrix}
+ 1 & 0 \\
+ 0 & 1
+ \end{pmatrix}
+$$
+
+**Circuit symbol:**
+
+```python
+ ┌───┐
+q_0: ┤ I ├
+ └───┘
+```
+
+Create new Identity gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.IGate.base_class "qiskit.circuit.library.IGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this gate.
+
+### power
+
+
+
+`power(exponent)`
+
+Raise gate to a power.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.IQP.md b/docs/api/qiskit/0.46/qiskit.circuit.library.IQP.md
new file mode 100644
index 00000000000..7dc7738ae27
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.IQP.md
@@ -0,0 +1,235 @@
+---
+title: IQP
+description: API reference for qiskit.circuit.library.IQP
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.IQP
+---
+
+# IQP
+
+
+
+`qiskit.circuit.library.IQP(interactions)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/iqp.py "view source code")
+
+Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+Instantaneous quantum polynomial (IQP) circuit.
+
+The circuit consists of a column of Hadamard gates, a column of powers of T gates, a sequence of powers of CS gates (up to $\frac{n^2-n}{2}$ of them), and a final column of Hadamard gates, as introduced in \[1].
+
+The circuit is parameterized by an n x n interactions matrix. The powers of each T gate are given by the diagonal elements of the interactions matrix. The powers of the CS gates are given by the upper triangle of the interactions matrix.
+
+**Reference Circuit:**
+
+
+
+**Expanded Circuit:**
+
+> 
+
+**References:**
+
+\[1] M. J. Bremner et al. Average-case complexity versus approximate simulation of commuting quantum computations, Phys. Rev. Lett. 117, 080501 (2016). [arXiv:1504.07999](https://arxiv.org/abs/1504.07999)
+
+Create IQP circuit.
+
+**Parameters**
+
+**interactions** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *| np.ndarray*) – input n-by-n symmetric matrix.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the inputs is not as symmetric matrix.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 204`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.Initialize.md b/docs/api/qiskit/0.46/qiskit.circuit.library.Initialize.md
new file mode 100644
index 00000000000..61548344e8d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.Initialize.md
@@ -0,0 +1,170 @@
+---
+title: Initialize
+description: API reference for qiskit.circuit.library.Initialize
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.Initialize
+---
+
+# Initialize
+
+
+
+`qiskit.circuit.library.Initialize(params, num_qubits=None, normalize=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/data_preparation/initializer.py "view source code")
+
+Bases: [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")
+
+Complex amplitude initialization.
+
+Class that initializes some flexible collection of qubit registers, implemented by calling the [`StatePreparation`](qiskit.circuit.library.StatePreparation "qiskit.circuit.library.StatePreparation") class. Note that `Initialize` is an [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") and not a [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate") since it contains a reset instruction, which is not unitary.
+
+**Parameters**
+
+* **params** ([*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") *| Sequence\[*[*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*] |* [*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) –
+
+ The state to initialize to, can be either of the following.
+
+ * Statevector or vector of complex amplitudes to initialize to.
+ * Labels of basis states of the Pauli eigenstates Z, X, Y. See [`Statevector.from_label()`](qiskit.quantum_info.Statevector#from_label "qiskit.quantum_info.Statevector.from_label"). Notice the order of the labels is reversed with respect to the qubit index to be applied to. Example label ‘01’ initializes the qubit zero to $|1\rangle$ and the qubit one to $|0\rangle$.
+ * An integer that is used as a bitmap indicating which qubits to initialize to $|1\rangle$. Example: setting params to 5 would initialize qubit 0 and qubit 2 to $|1\rangle$ and qubit 1 to $|0\rangle$.
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – This parameter is only used if params is an int. Indicates the total number of qubits in the initialize call. Example: initialize covers 5 qubits and params is 3. This allows qubits 0 and 1 to be initialized to $|1\rangle$ and the remaining 3 qubits to be initialized to $|0\rangle$.
+
+* **normalize** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to normalize an input array to a unit vector.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.Initialize.base_class "qiskit.circuit.library.Initialize.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Return initialize params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### broadcast\_arguments
+
+
+
+`broadcast_arguments(qargs, cargs)`
+
+Validation of the arguments.
+
+**Parameters**
+
+* **qargs** (*List*) – List of quantum bit arguments.
+* **cargs** (*List*) – List of classical bit arguments.
+
+**Yields**
+
+*Tuple(List, List)* – A tuple with single arguments.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the input is not valid. For example, the number of arguments does not match the gate expectation.
+
+### gates\_to\_uncompute
+
+
+
+`gates_to_uncompute()`
+
+Call to create a circuit with gates that take the desired vector to zero.
+
+**Returns**
+
+Circuit to take `self.params` vector to $|{00\ldots0}\rangle$
+
+**Return type**
+
+[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.InnerProduct.md b/docs/api/qiskit/0.46/qiskit.circuit.library.InnerProduct.md
new file mode 100644
index 00000000000..19811da0aa3
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.InnerProduct.md
@@ -0,0 +1,246 @@
+---
+title: InnerProduct
+description: API reference for qiskit.circuit.library.InnerProduct
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.InnerProduct
+---
+
+# InnerProduct
+
+
+
+`qiskit.circuit.library.InnerProduct(num_qubits)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/boolean_logic/inner_product.py "view source code")
+
+Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+A 2n-qubit Boolean function that computes the inner product of two n-qubit vectors over $F_2$.
+
+This implementation is a phase oracle which computes the following transform.
+
+$$
+\mathcal{IP}_{2n} : F_2^{2n} \rightarrow {-1, 1}
+\mathcal{IP}_{2n}(x_1, \cdots, x_n, y_1, \cdots, y_n) = (-1)^{x.y}
+$$
+
+The corresponding unitary is a diagonal, which induces a -1 phase on any inputs where the inner product of the top and bottom registers is 1. Otherwise it keeps the input intact.
+
+```python
+q0_0: ─■──────────
+ │
+q0_1: ─┼──■───────
+ │ │
+q0_2: ─┼──┼──■────
+ │ │ │
+q0_3: ─┼──┼──┼──■─
+ │ │ │ │
+q1_0: ─■──┼──┼──┼─
+ │ │ │
+q1_1: ────■──┼──┼─
+ │ │
+q1_2: ───────■──┼─
+ │
+q1_3: ──────────■─
+```
+
+**Reference Circuit:**
+
+
+
+Return a circuit to compute the inner product of 2 n-qubit registers.
+
+**Parameters**
+
+**num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – width of top and bottom registers (half total circuit width)
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 161`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.IntegerComparator.md b/docs/api/qiskit/0.46/qiskit.circuit.library.IntegerComparator.md
new file mode 100644
index 00000000000..adf614c8b63
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.IntegerComparator.md
@@ -0,0 +1,201 @@
+---
+title: IntegerComparator
+description: API reference for qiskit.circuit.library.IntegerComparator
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.IntegerComparator
+---
+
+# IntegerComparator
+
+
+
+`qiskit.circuit.library.IntegerComparator(num_state_qubits=None, value=None, geq=True, name='cmp')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/arithmetic/integer_comparator.py "view source code")
+
+Bases: `BlueprintCircuit`
+
+Integer Comparator.
+
+Operator compares basis states $|i\rangle_n$ against a classically given integer $L$ of fixed value and flips a target qubit if $i \geq L$ (or $<$ depending on the parameter `geq`):
+
+$$
+|i\rangle_n |0\rangle \mapsto |i\rangle_n |i \geq L\rangle
+$$
+
+This operation is based on two’s complement implementation of binary subtraction but only uses carry bits and no actual result bits. If the most significant carry bit (the results bit) is 1, the $\geq$ condition is `True` otherwise it is `False`.
+
+Create a new fixed value comparator circuit.
+
+**Parameters**
+
+* **num\_state\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – Number of state qubits. If this is set it will determine the number of qubits required for the circuit.
+* **value** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The fixed value to compare with.
+* **geq** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, evaluate a `>=` condition, else `<`.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Name of the circuit.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### geq
+
+Return whether the comparator compares greater or less equal.
+
+**Returns**
+
+True, if the comparator compares `>=`, False if `<`.
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 163`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancilla\_qubits
+
+Deprecated. Use num\_ancillas instead.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### num\_state\_qubits
+
+The number of qubits encoding the state for the comparison.
+
+**Returns**
+
+The number of state qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qregs
+
+`list[QuantumRegister]`
+
+A list of the quantum registers associated with the circuit.
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+
+
+### value
+
+The value to compare the qubit register to.
+
+**Returns**
+
+The value against which the value of the qubit register is compared.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.Isometry.md b/docs/api/qiskit/0.46/qiskit.circuit.library.Isometry.md
new file mode 100644
index 00000000000..01f4b2657e9
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.Isometry.md
@@ -0,0 +1,174 @@
+---
+title: Isometry
+description: API reference for qiskit.circuit.library.Isometry
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.Isometry
+---
+
+# Isometry
+
+
+
+`qiskit.circuit.library.Isometry(isometry, num_ancillas_zero, num_ancillas_dirty, epsilon=1e-10)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/generalized_gates/isometry.py "view source code")
+
+Bases: [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")
+
+Decomposition of arbitrary isometries from $m$ to $n$ qubits.
+
+In particular, this allows to decompose unitaries (m=n) and to do state preparation ($m=0$).
+
+The decomposition is based on \[1].
+
+**References:**
+
+**\[1] Iten et al., Quantum circuits for isometries (2016).**
+
+[Phys. Rev. A 93, 032318](https://journals.aps.org/pra/abstract/10.1103/PhysRevA.93.032318).
+
+**Parameters**
+
+* **isometry** (*np.ndarray*) – An isometry from $m$ to :math\`n\` qubits, i.e., a complex `np.ndarray` of dimension $2^n \times 2^m$ with orthonormal columns (given in the computational basis specified by the order of the ancillas and the input qubits, where the ancillas are considered to be more significant than the input qubits).
+* **num\_ancillas\_zero** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of additional ancillas that start in the state $|0\rangle$ (the $n-m$ ancillas required for providing the output of the isometry are not accounted for here).
+* **num\_ancillas\_dirty** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of additional ancillas that start in an arbitrary state.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Error tolerance of calculations.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.Isometry.base_class "qiskit.circuit.library.Isometry.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inv\_gate
+
+
+
+`inv_gate()`
+
+Return the adjoint of the unitary.
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this instruction.
+
+If the instruction is composite (i.e. has a definition), then its definition will be recursively inverted.
+
+Special instructions inheriting from Instruction can implement their own inverse (e.g. T and Tdg, Barrier, etc.)
+
+**Returns**
+
+a fresh instruction for the inverse
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the instruction is not composite and an inverse has not been implemented for it.
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Isometry parameter has to be an ndarray.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.LinearAmplitudeFunction.md b/docs/api/qiskit/0.46/qiskit.circuit.library.LinearAmplitudeFunction.md
new file mode 100644
index 00000000000..62fa6a465d5
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.LinearAmplitudeFunction.md
@@ -0,0 +1,283 @@
+---
+title: LinearAmplitudeFunction
+description: API reference for qiskit.circuit.library.LinearAmplitudeFunction
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.LinearAmplitudeFunction
+---
+
+# LinearAmplitudeFunction
+
+
+
+`qiskit.circuit.library.LinearAmplitudeFunction(num_state_qubits, slope, offset, domain, image, rescaling_factor=1, breakpoints=None, name='F')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/arithmetic/linear_amplitude_function.py "view source code")
+
+Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+A circuit implementing a (piecewise) linear function on qubit amplitudes.
+
+An amplitude function $F$ of a function $f$ is a mapping
+
+$$
+F|x\rangle|0\rangle = \sqrt{1 - \hat{f}(x)} |x\rangle|0\rangle + \sqrt{\hat{f}(x)}
+ |x\rangle|1\rangle.
+$$
+
+for a function $\hat{f}: \{ 0, ..., 2^n - 1 \} \rightarrow [0, 1]$, where $|x\rangle$ is a $n$ qubit state.
+
+This circuit implements $F$ for piecewise linear functions $\hat{f}$. In this case, the mapping $F$ can be approximately implemented using a Taylor expansion and linearly controlled Pauli-Y rotations, see \[1, 2] for more detail. This approximation uses a `rescaling_factor` to determine the accuracy of the Taylor expansion.
+
+In general, the function of interest $f$ is defined from some interval $[a,b]$, the `domain` to $[c,d]$, the `image`, instead of $\{ 1, ..., N \}$ to $[0, 1]$. Using an affine transformation we can rescale $f$ to $\hat{f}$:
+
+$$
+\hat{f}(x) = \frac{f(\phi(x)) - c}{d - c}
+$$
+
+with
+
+$$
+\phi(x) = a + \frac{b - a}{2^n - 1} x.
+$$
+
+If $f$ is a piecewise linear function on $m$ intervals $[p_{i-1}, p_i], i \in \{1, ..., m\}$ with slopes $\alpha_i$ and offsets $\beta_i$ it can be written as
+
+$$
+f(x) = \sum_{i=1}^m 1_{[p_{i-1}, p_i]}(x) (\alpha_i x + \beta_i)
+$$
+
+where $1_{[a, b]}$ is an indication function that is 1 if the argument is in the interval $[a, b]$ and otherwise 0. The breakpoints $p_i$ can be specified by the `breakpoints` argument.
+
+**References**
+
+**\[1]: Woerner, S., & Egger, D. J. (2018).**
+
+Quantum Risk Analysis. [arXiv:1806.06893](http://arxiv.org/abs/1806.06893)
+
+**\[2]: Gacon, J., Zoufal, C., & Woerner, S. (2020).**
+
+Quantum-Enhanced Simulation-Based Optimization. [arXiv:2005.10780](http://arxiv.org/abs/2005.10780)
+
+**Parameters**
+
+* **num\_state\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of qubits used to encode the variable $x$.
+* **slope** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The slope of the linear function. Can be a list of slopes if it is a piecewise linear function.
+* **offset** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The offset of the linear function. Can be a list of offsets if it is a piecewise linear function.
+* **domain** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The domain of the function as tuple $(x_\min{}, x_\max{})$.
+* **image** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The image of the function as tuple $(f_\min{}, f_\max{})$.
+* **rescaling\_factor** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The rescaling factor to adjust the accuracy in the Taylor approximation.
+* **breakpoints** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – The breakpoints if the function is piecewise linear. If None, the function is not piecewise.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Name of the circuit.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 163`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+## Methods
+
+### post\_processing
+
+
+
+`post_processing(scaled_value)`
+
+Map the function value of the approximated $\hat{f}$ to $f$.
+
+**Parameters**
+
+**scaled\_value** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – A function value from the Taylor expansion of $\hat{f}(x)$.
+
+**Returns**
+
+The `scaled_value` mapped back to the domain of $f$, by first inverting the transformation used for the Taylor approximation and then mapping back from $[0, 1]$ to the original domain.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.LinearFunction.md b/docs/api/qiskit/0.46/qiskit.circuit.library.LinearFunction.md
new file mode 100644
index 00000000000..626008c96ca
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.LinearFunction.md
@@ -0,0 +1,251 @@
+---
+title: LinearFunction
+description: API reference for qiskit.circuit.library.LinearFunction
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.LinearFunction
+---
+
+# LinearFunction
+
+
+
+`qiskit.circuit.library.LinearFunction(linear, validate_input=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/generalized_gates/linear_function.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+A linear reversible circuit on n qubits.
+
+Internally, a linear function acting on n qubits is represented as a n x n matrix of 0s and 1s in numpy array format.
+
+A linear function can be synthesized into CX and SWAP gates using the Patel–Markov–Hayes algorithm, as implemented in [`synth_cnot_count_full_pmh()`](synthesis#qiskit.synthesis.synth_cnot_count_full_pmh "qiskit.synthesis.synth_cnot_count_full_pmh") based on reference \[1].
+
+For efficiency, the internal n x n matrix is stored in the format expected by cnot\_synth, which is the big-endian (and not the little-endian) bit-ordering convention.
+
+**Example:** the circuit
+
+```python
+q_0: ──■──
+ ┌─┴─┐
+q_1: ┤ X ├
+ └───┘
+q_2: ─────
+```
+
+is represented by a 3x3 linear matrix
+
+$$
+\begin{pmatrix}
+ 1 & 0 & 0 \\
+ 1 & 1 & 0 \\
+ 0 & 0 & 1
+\end{pmatrix}
+$$
+
+**References:**
+
+\[1] Ketan N. Patel, Igor L. Markov, and John P. Hayes, Optimal synthesis of linear reversible circuits, Quantum Inf. Comput. 8(3) (2008). [Online at umich.edu.](https://web.eecs.umich.edu/~imarkov/pubs/jour/qic08-cnot.pdf)
+
+Create a new linear function.
+
+**Parameters**
+
+* **linear** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*] | np.ndarray\[*[*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")*] |* [*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *|*[*LinearFunction*](#qiskit.circuit.library.LinearFunction "qiskit.circuit.library.LinearFunction") *|*[*PermutationGate*](qiskit.circuit.library.PermutationGate "qiskit.circuit.library.PermutationGate") *|*[*Clifford*](qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")) – data from which a linear function can be constructed. It can be either a nxn matrix (describing the linear transformation), a permutation (which is a special case of a linear function), another linear function, a clifford (when it corresponds to a linear function), or a quantum circuit composed of linear gates (CX and SWAP) and other objects described above, including nested subcircuits.
+* **validate\_input** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if True, performs more expensive input validation checks, such as checking that a given n x n matrix is invertible.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the input is invalid: either the input matrix is not square or not invertible, or the input quantum circuit contains non-linear objects (for example, a Hadamard gate, or a Clifford that does not correspond to a linear function).
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.LinearFunction.base_class "qiskit.circuit.library.LinearFunction.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### linear
+
+Returns the n x n matrix representing this linear function.
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### original\_circuit
+
+Returns the original circuit used to construct this linear function (including None, when the linear function is not constructed from a circuit).
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### extend\_with\_identity
+
+
+
+`extend_with_identity(num_qubits, positions)`
+
+Extend linear function to a linear function over nq qubits, with identities on other subsystems.
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of qubits of the extended function.
+* **positions** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – describes the positions of original qubits in the extended function’s qubits.
+
+**Returns**
+
+extended linear function.
+
+**Return type**
+
+[LinearFunction](#qiskit.circuit.library.LinearFunction "qiskit.circuit.library.LinearFunction")
+
+### function\_str
+
+
+
+`function_str()`
+
+Return string representation of the linear function viewed as a linear transformation.
+
+### is\_permutation
+
+
+
+`is_permutation()`
+
+Returns whether this linear function is a permutation, that is whether every row and every column of the n x n matrix has exactly one 1.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### mat\_str
+
+
+
+`mat_str()`
+
+Return string representation of the linear function viewed as a matrix with 0/1 entries.
+
+### permutation\_pattern
+
+
+
+`permutation_pattern()`
+
+This method first checks if a linear function is a permutation and raises a qiskit.circuit.exceptions.CircuitError if not. In the case that this linear function is a permutation, returns the permutation pattern.
+
+### synthesize
+
+
+
+`synthesize()`
+
+Synthesizes the linear function into a quantum circuit.
+
+**Returns**
+
+A circuit implementing the evolution.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Parameter validation
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.LinearPauliRotations.md b/docs/api/qiskit/0.46/qiskit.circuit.library.LinearPauliRotations.md
new file mode 100644
index 00000000000..791c681ac04
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.LinearPauliRotations.md
@@ -0,0 +1,235 @@
+---
+title: LinearPauliRotations
+description: API reference for qiskit.circuit.library.LinearPauliRotations
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.LinearPauliRotations
+---
+
+# LinearPauliRotations
+
+
+
+`qiskit.circuit.library.LinearPauliRotations(num_state_qubits=None, slope=1, offset=0, basis='Y', name='LinRot')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/arithmetic/linear_pauli_rotations.py "view source code")
+
+Bases: [`FunctionalPauliRotations`](qiskit.circuit.library.FunctionalPauliRotations "qiskit.circuit.library.arithmetic.functional_pauli_rotations.FunctionalPauliRotations")
+
+Linearly-controlled X, Y or Z rotation.
+
+For a register of state qubits $|x\rangle$, a target qubit $|0\rangle$ and the basis `'Y'` this circuit acts as:
+
+```python
+ q_0: ─────────────────────────■───────── ... ──────────────────────
+ │
+ .
+ │
+q_(n-1): ─────────────────────────┼───────── ... ───────────■──────────
+ ┌────────────┐ ┌───────┴───────┐ ┌─────────┴─────────┐
+ q_n: ─┤ RY(offset) ├──┤ RY(2^0 slope) ├ ... ┤ RY(2^(n-1) slope) ├
+ └────────────┘ └───────────────┘ └───────────────────┘
+```
+
+This can for example be used to approximate linear functions, with $a =$ `slope`$/2$ and $b =$ `offset`$/2$ and the basis `'Y'`:
+
+$$
+|x\rangle |0\rangle \mapsto \cos(ax + b)|x\rangle|0\rangle + \sin(ax + b)|x\rangle |1\rangle
+$$
+
+Since for small arguments $\sin(x) \approx x$ this operator can be used to approximate linear functions.
+
+Create a new linear rotation circuit.
+
+**Parameters**
+
+* **num\_state\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of qubits representing the state $|x\rangle$.
+* **slope** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The slope of the controlled rotation.
+* **offset** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The offset of the controlled rotation.
+* **basis** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The type of Pauli rotation (‘X’, ‘Y’, ‘Z’).
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the circuit object.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### basis
+
+The kind of Pauli rotation to be used.
+
+Set the basis to ‘X’, ‘Y’ or ‘Z’ for controlled-X, -Y, or -Z rotations respectively.
+
+**Returns**
+
+The kind of Pauli rotation used in controlled rotation.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 163`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancilla\_qubits
+
+The minimum number of ancilla qubits in the circuit.
+
+**Returns**
+
+The minimal number of ancillas required.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### num\_state\_qubits
+
+The number of state qubits representing the state $|x\rangle$.
+
+**Returns**
+
+The number of state qubits.
+
+
+
+### offset
+
+The angle of the single qubit offset rotation on the target qubit.
+
+Before applying the controlled rotations, a single rotation of angle `offset` is applied to the target qubit.
+
+**Returns**
+
+The offset angle.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qregs
+
+`list[QuantumRegister]`
+
+A list of the quantum registers associated with the circuit.
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+
+
+### slope
+
+The multiplicative factor in the rotation angle of the controlled rotations.
+
+The rotation angles are `slope * 2^0`, `slope * 2^1`, … , `slope * 2^(n-1)` where `n` is the number of state qubits.
+
+**Returns**
+
+The rotation angle common in all controlled rotations.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.MCMT.md b/docs/api/qiskit/0.46/qiskit.circuit.library.MCMT.md
new file mode 100644
index 00000000000..4b1d0dfad2b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.MCMT.md
@@ -0,0 +1,263 @@
+---
+title: MCMT
+description: API reference for qiskit.circuit.library.MCMT
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.MCMT
+---
+
+# MCMT
+
+
+
+`qiskit.circuit.library.MCMT(gate, num_ctrl_qubits, num_target_qubits)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/generalized_gates/mcmt.py "view source code")
+
+Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+The multi-controlled multi-target gate, for an arbitrary singly controlled target gate.
+
+For example, the H gate controlled on 3 qubits and acting on 2 target qubit is represented as:
+
+```python
+───■────
+ │
+───■────
+ │
+───■────
+┌──┴───┐
+┤0 ├
+│ 2-H │
+┤1 ├
+└──────┘
+```
+
+This default implementations requires no ancilla qubits, by broadcasting the target gate to the number of target qubits and using Qiskit’s generic control routine to control the broadcasted target on the control qubits. If ancilla qubits are available, a more efficient variant using the so-called V-chain decomposition can be used. This is implemented in [`MCMTVChain`](qiskit.circuit.library.MCMTVChain "qiskit.circuit.library.MCMTVChain").
+
+Create a new multi-control multi-target gate.
+
+**Parameters**
+
+* **gate** ([*Gate*](qiskit.circuit.Gate "qiskit.circuit.Gate") *| Callable\[\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*,* [*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*,* [*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*],* [*circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction")*]*) – The gate to be applied controlled on the control qubits and applied to the target qubits. Can be either a Gate or a circuit method. If it is a callable, it will be casted to a Gate.
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of control qubits.
+* **num\_target\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of target qubits.
+
+**Raises**
+
+* [**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the gate cannot be casted to a controlled gate.
+* [**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the number of controls or targets is 0.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 163`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancilla\_qubits
+
+Return the number of ancillas.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+## Methods
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Return the controlled version of the MCMT circuit.
+
+### inverse
+
+
+
+`inverse()`
+
+Return the inverse MCMT circuit, which is itself.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.MCMTVChain.md b/docs/api/qiskit/0.46/qiskit.circuit.library.MCMTVChain.md
new file mode 100644
index 00000000000..56c154d4f78
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.MCMTVChain.md
@@ -0,0 +1,279 @@
+---
+title: MCMTVChain
+description: API reference for qiskit.circuit.library.MCMTVChain
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.MCMTVChain
+---
+
+# MCMTVChain
+
+
+
+`qiskit.circuit.library.MCMTVChain(gate, num_ctrl_qubits, num_target_qubits)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/generalized_gates/mcmt.py "view source code")
+
+Bases: [`MCMT`](qiskit.circuit.library.MCMT "qiskit.circuit.library.generalized_gates.mcmt.MCMT")
+
+The MCMT implementation using the CCX V-chain.
+
+This implementation requires ancillas but is decomposed into a much shallower circuit than the default implementation in [`MCMT`](qiskit.circuit.library.MCMT "qiskit.circuit.library.MCMT").
+
+**Expanded Circuit:**
+
+
+
+**Examples:**
+
+> ```python
+> >>> from qiskit.circuit.library import HGate
+> >>> MCMTVChain(HGate(), 3, 2).draw()
+> ```
+>
+> **q\_0: ──■────────────────────────■──**
+>
+> │ │
+>
+> **q\_1: ──■────────────────────────■──**
+>
+> │ │
+>
+> **q\_2: ──┼────■──────────────■────┼──**
+>
+> │ │ ┌───┐ │ │
+>
+> **q\_3: ──┼────┼──┤ H ├───────┼────┼──**
+>
+> │ │ └─┬─┘┌───┐ │ │
+>
+> **q\_4: ──┼────┼────┼──┤ H ├──┼────┼──**
+>
+> ┌─┴─┐ │ │ └─┬─┘ │ ┌─┴─┐
+>
+> **q\_5: ┤ X ├──■────┼────┼────■──┤ X ├**
+>
+> └───┘┌─┴─┐ │ │ ┌─┴─┐└───┘
+>
+> **q\_6: ─────┤ X ├──■────■──┤ X ├─────**
+>
+> └───┘ └───┘
+
+Create a new multi-control multi-target gate.
+
+**Parameters**
+
+* **gate** ([*Gate*](qiskit.circuit.Gate "qiskit.circuit.Gate") *| Callable\[\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*,* [*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*,* [*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*],* [*circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction")*]*) – The gate to be applied controlled on the control qubits and applied to the target qubits. Can be either a Gate or a circuit method. If it is a callable, it will be casted to a Gate.
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of control qubits.
+* **num\_target\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of target qubits.
+
+**Raises**
+
+* [**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the gate cannot be casted to a controlled gate.
+* [**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the number of controls or targets is 0.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 164`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancilla\_qubits
+
+Return the number of ancilla qubits required.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return the inverse MCMT circuit, which is itself.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.MCPhaseGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.MCPhaseGate.md
new file mode 100644
index 00000000000..9b66055be80
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.MCPhaseGate.md
@@ -0,0 +1,206 @@
+---
+title: MCPhaseGate
+description: API reference for qiskit.circuit.library.MCPhaseGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.MCPhaseGate
+---
+
+# MCPhaseGate
+
+
+
+`qiskit.circuit.library.MCPhaseGate(lam, num_ctrl_qubits, label=None, *, duration=None, unit='dt', _base_label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/p.py "view source code")
+
+Bases: [`ControlledGate`](qiskit.circuit.ControlledGate "qiskit.circuit.controlledgate.ControlledGate")
+
+Multi-controlled-Phase gate.
+
+This is a diagonal and symmetric gate that induces a phase on the state of the target qubit, depending on the state of the control qubits.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`mcp()`](qiskit.circuit.QuantumCircuit#mcp "qiskit.circuit.QuantumCircuit.mcp") method.
+
+**Circuit symbol:**
+
+```python
+ q_0: ───■────
+ │
+ .
+ │
+q_(n-1): ───■────
+ ┌──┴───┐
+ q_n: ┤ P(λ) ├
+ └──────┘
+```
+
+
+ `CPhaseGate`: The singly-controlled-version of this gate.
+
+
+Create new MCPhase gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.MCPhaseGate.base_class "qiskit.circuit.library.MCPhaseGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Controlled version of this gate.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of control qubits.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for the gate \[Default: None]
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – control state expressed as integer, string (e.g. ‘110’), or None. If None, use all 1s.
+
+**Returns**
+
+controlled version of this gate.
+
+**Return type**
+
+[ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted MCU1 gate ($MCU1(\lambda)^{\dagger} = MCU1(-\lambda)$)
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.MCXGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.MCXGate.md
new file mode 100644
index 00000000000..e4b71c94a71
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.MCXGate.md
@@ -0,0 +1,207 @@
+---
+title: MCXGate
+description: API reference for qiskit.circuit.library.MCXGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.MCXGate
+---
+
+# MCXGate
+
+
+
+`qiskit.circuit.library.MCXGate(num_ctrl_qubits=None, label=None, ctrl_state=None, *, duration=None, unit='dt', _base_label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/x.py "view source code")
+
+Bases: [`ControlledGate`](qiskit.circuit.ControlledGate "qiskit.circuit.controlledgate.ControlledGate")
+
+The general, multi-controlled X gate.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`mcx()`](qiskit.circuit.QuantumCircuit#mcx "qiskit.circuit.QuantumCircuit.mcx") method.
+
+Create new MCX gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.MCXGate.base_class "qiskit.circuit.library.MCXGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_ancilla\_qubits
+
+The number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Return a multi-controlled-X gate with more control lines.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of control qubits.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for the gate \[Default: None]
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – control state expressed as integer, string (e.g. ‘110’), or None. If None, use all 1s.
+
+**Returns**
+
+controlled version of this gate.
+
+**Return type**
+
+[ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+### get\_num\_ancilla\_qubits
+
+
+
+`static get_num_ancilla_qubits(num_ctrl_qubits, mode='noancilla')`
+
+Get the number of required ancilla qubits without instantiating the class.
+
+This staticmethod might be necessary to check the number of ancillas before creating the gate, or to use the number of ancillas in the initialization.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this gate. The MCX is its own inverse.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.MCXGrayCode.md b/docs/api/qiskit/0.46/qiskit.circuit.library.MCXGrayCode.md
new file mode 100644
index 00000000000..4e02d35a033
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.MCXGrayCode.md
@@ -0,0 +1,171 @@
+---
+title: MCXGrayCode
+description: API reference for qiskit.circuit.library.MCXGrayCode
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.MCXGrayCode
+---
+
+# MCXGrayCode
+
+
+
+`qiskit.circuit.library.MCXGrayCode(num_ctrl_qubits=None, label=None, ctrl_state=None, *, duration=None, unit='dt', _base_label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/x.py "view source code")
+
+Bases: [`MCXGate`](qiskit.circuit.library.MCXGate "qiskit.circuit.library.standard_gates.x.MCXGate")
+
+Implement the multi-controlled X gate using the Gray code.
+
+This delegates the implementation to the MCU1 gate, since $X = H \cdot U1(\pi) \cdot H$.
+
+Create new MCX gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.MCXGrayCode.base_class "qiskit.circuit.library.MCXGrayCode.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_ancilla\_qubits
+
+The number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this gate. The MCX is its own inverse.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.MCXRecursive.md b/docs/api/qiskit/0.46/qiskit.circuit.library.MCXRecursive.md
new file mode 100644
index 00000000000..f4aaa5c9e3f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.MCXRecursive.md
@@ -0,0 +1,179 @@
+---
+title: MCXRecursive
+description: API reference for qiskit.circuit.library.MCXRecursive
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.MCXRecursive
+---
+
+# MCXRecursive
+
+
+
+`qiskit.circuit.library.MCXRecursive(num_ctrl_qubits=None, label=None, ctrl_state=None, *, duration=None, unit='dt', _base_label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/x.py "view source code")
+
+Bases: [`MCXGate`](qiskit.circuit.library.MCXGate "qiskit.circuit.library.standard_gates.x.MCXGate")
+
+Implement the multi-controlled X gate using recursion.
+
+Using a single ancilla qubit, the multi-controlled X gate is recursively split onto four sub-registers. This is done until we reach the 3- or 4-controlled X gate since for these we have a concrete implementation that do not require ancillas.
+
+Create new MCX gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.MCXRecursive.base_class "qiskit.circuit.library.MCXRecursive.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_ancilla\_qubits
+
+The number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### get\_num\_ancilla\_qubits
+
+
+
+`static get_num_ancilla_qubits(num_ctrl_qubits, mode='recursion')`
+
+Get the number of required ancilla qubits.
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this gate. The MCX is its own inverse.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.MCXVChain.md b/docs/api/qiskit/0.46/qiskit.circuit.library.MCXVChain.md
new file mode 100644
index 00000000000..ad8646ee796
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.MCXVChain.md
@@ -0,0 +1,177 @@
+---
+title: MCXVChain
+description: API reference for qiskit.circuit.library.MCXVChain
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.MCXVChain
+---
+
+# MCXVChain
+
+
+
+`qiskit.circuit.library.MCXVChain(num_ctrl_qubits=None, dirty_ancillas=False, label=None, ctrl_state=None, *, duration=None, unit='dt', _base_label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/x.py "view source code")
+
+Bases: [`MCXGate`](qiskit.circuit.library.MCXGate "qiskit.circuit.library.standard_gates.x.MCXGate")
+
+Implement the multi-controlled X gate using a V-chain of CX gates.
+
+Create new MCX gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.MCXVChain.base_class "qiskit.circuit.library.MCXVChain.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### ctrl\_state
+
+Return the control state of the gate as a decimal integer.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates. If the gate has open controls, as determined from self.ctrl\_state, the returned definition is conjugated with X without changing the internal \_definition.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Get name of gate. If the gate has open controls the gate name will become:
+
+> \
+
+where \ is the gate name for the default case of closed control qubits and \ is the integer value of the control state for the gate.
+
+
+
+### num\_ancilla\_qubits
+
+The number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_ctrl\_qubits
+
+Get number of control qubits.
+
+**Returns**
+
+The number of control qubits for the gate.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+Get parameters from base\_gate.
+
+**Returns**
+
+List of gate parameters.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Controlled gate does not define a base gate
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### get\_num\_ancilla\_qubits
+
+
+
+`static get_num_ancilla_qubits(num_ctrl_qubits, mode='v-chain')`
+
+Get the number of required ancilla qubits.
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this gate. The MCX is its own inverse.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.MSGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.MSGate.md
new file mode 100644
index 00000000000..7da50cb3367
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.MSGate.md
@@ -0,0 +1,123 @@
+---
+title: MSGate
+description: API reference for qiskit.circuit.library.MSGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.MSGate
+---
+
+# MSGate
+
+
+
+`qiskit.circuit.library.MSGate(num_qubits, theta, label=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/generalized_gates/gms.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+MSGate has been deprecated. Please use `GMS` in `qiskit.circuit.generalized_gates` instead.
+
+Global Mølmer–Sørensen gate.
+
+The Mølmer–Sørensen gate is native to ion-trap systems. The global MS can be applied to multiple ions to entangle multiple qubits simultaneously.
+
+In the two-qubit case, this is equivalent to an XX(theta) interaction, and is thus reduced to the RXXGate.
+
+Create new MS gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.MSGate.base_class "qiskit.circuit.library.MSGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.Measure.md b/docs/api/qiskit/0.46/qiskit.circuit.library.Measure.md
new file mode 100644
index 00000000000..bc7e942ea5c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.Measure.md
@@ -0,0 +1,316 @@
+---
+title: Measure
+description: API reference for qiskit.circuit.library.Measure
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.Measure
+---
+
+# Measure
+
+
+
+`qiskit.circuit.library.Measure(label=None, *, duration=None, unit='dt')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/measure.py "view source code")
+
+Bases: [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")
+
+Quantum measurement in the computational basis.
+
+Create new measurement instruction.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.Measure.base_class "qiskit.circuit.library.Measure.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### add\_decomposition
+
+
+
+`add_decomposition(decomposition)`
+
+Add a decomposition of the instruction to the SessionEquivalenceLibrary.
+
+### assemble
+
+
+
+`assemble()`
+
+Assemble a QasmQobjInstruction
+
+### broadcast\_arguments
+
+
+
+`broadcast_arguments(qargs, cargs)`
+
+Validation of the arguments.
+
+**Parameters**
+
+* **qargs** (*List*) – List of quantum bit arguments.
+* **cargs** (*List*) – List of classical bit arguments.
+
+**Yields**
+
+*Tuple(List, List)* – A tuple with single arguments.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the input is not valid. For example, the number of arguments does not match the gate expectation.
+
+### c\_if
+
+
+
+`c_if(classical, val)`
+
+Set a classical equality condition on this instruction between the register or cbit `classical` and value `val`.
+
+
+ This is a setter method, not an additive one. Calling this multiple times will silently override any previously set condition; it does not stack.
+
+
+### copy
+
+
+
+`copy(name=None)`
+
+Copy of the instruction.
+
+**Parameters**
+
+**name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name to be given to the copied circuit, if `None` then the name stays the same.
+
+**Returns**
+
+a copy of the current instruction, with the name updated if it was provided
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this instruction.
+
+If the instruction is composite (i.e. has a definition), then its definition will be recursively inverted.
+
+Special instructions inheriting from Instruction can implement their own inverse (e.g. T and Tdg, Barrier, etc.)
+
+**Returns**
+
+a fresh instruction for the inverse
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the instruction is not composite and an inverse has not been implemented for it.
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True .IFF. instruction is parameterized else False
+
+### qasm
+
+
+
+`qasm()`
+
+Return a default OpenQASM string for the instruction.
+
+Derived instructions may override this to print in a different format (e.g. `measure q[0] -> c[0];`).
+
+
+ The method `qiskit.circuit.instruction.Instruction.qasm()` is deprecated as of qiskit-terra 0.25.0. It will be removed in the Qiskit 1.0 release. Correct exporting to OpenQASM 2 is the responsibility of a larger exporter; it cannot safely be done on an object-by-object basis without context. No replacement will be provided, because the premise is wrong.
+
+
+### repeat
+
+
+
+`repeat(n)`
+
+Creates an instruction with gate repeated n amount of times.
+
+**Parameters**
+
+**n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of times to repeat the instruction
+
+**Returns**
+
+Containing the definition.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If n \< 1.
+
+### reverse\_ops
+
+
+
+`reverse_ops()`
+
+For a composite instruction, reverse the order of sub-instructions.
+
+This is done by recursively reversing all sub-instructions. It does not invert any gate.
+
+**Returns**
+
+**a new instruction with**
+
+sub-instructions reversed.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### soft\_compare
+
+
+
+`soft_compare(other)`
+
+Soft comparison between gates. Their names, number of qubits, and classical bit numbers must match. The number of parameters must match. Each parameter is compared. If one is a ParameterExpression then it is not taken into account.
+
+**Parameters**
+
+**other** (*instruction*) – other instruction.
+
+**Returns**
+
+are self and other equal up to parameter expressions.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### to\_mutable
+
+
+
+`to_mutable()`
+
+Return a mutable copy of this gate.
+
+This method will return a new mutable copy of this gate instance. If a singleton instance is being used this will be a new unique instance that can be mutated. If the instance is already mutable it will be a deepcopy of that instance.
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Instruction parameters has no validation or normalization.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.NLocal.md b/docs/api/qiskit/0.46/qiskit.circuit.library.NLocal.md
new file mode 100644
index 00000000000..fc3277f1b2f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.NLocal.md
@@ -0,0 +1,462 @@
+---
+title: NLocal
+description: API reference for qiskit.circuit.library.NLocal
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.NLocal
+---
+
+# NLocal
+
+
+
+`qiskit.circuit.library.NLocal(num_qubits=None, rotation_blocks=None, entanglement_blocks=None, entanglement=None, reps=1, insert_barriers=False, parameter_prefix='θ', overwrite_block_parameters=True, skip_final_rotation_layer=False, skip_unentangled_qubits=False, initial_state=None, name='nlocal', flatten=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/n_local/n_local.py "view source code")
+
+Bases: `BlueprintCircuit`
+
+The n-local circuit class.
+
+The structure of the n-local circuit are alternating rotation and entanglement layers. In both layers, parameterized circuit-blocks act on the circuit in a defined way. In the rotation layer, the blocks are applied stacked on top of each other, while in the entanglement layer according to the `entanglement` strategy. The circuit blocks can have arbitrary sizes (smaller equal to the number of qubits in the circuit). Each layer is repeated `reps` times, and by default a final rotation layer is appended.
+
+For instance, a rotation block on 2 qubits and an entanglement block on 4 qubits using `'linear'` entanglement yields the following circuit.
+
+```python
+┌──────┐ ░ ┌──────┐ ░ ┌──────┐
+┤0 ├─░─┤0 ├──────────────── ... ─░─┤0 ├
+│ Rot │ ░ │ │┌──────┐ ░ │ Rot │
+┤1 ├─░─┤1 ├┤0 ├──────── ... ─░─┤1 ├
+├──────┤ ░ │ Ent ││ │┌──────┐ ░ ├──────┤
+┤0 ├─░─┤2 ├┤1 ├┤0 ├ ... ─░─┤0 ├
+│ Rot │ ░ │ ││ Ent ││ │ ░ │ Rot │
+┤1 ├─░─┤3 ├┤2 ├┤1 ├ ... ─░─┤1 ├
+├──────┤ ░ └──────┘│ ││ Ent │ ░ ├──────┤
+┤0 ├─░─────────┤3 ├┤2 ├ ... ─░─┤0 ├
+│ Rot │ ░ └──────┘│ │ ░ │ Rot │
+┤1 ├─░─────────────────┤3 ├ ... ─░─┤1 ├
+└──────┘ ░ └──────┘ ░ └──────┘
+
+| |
++---------------------------------+
+ repeated reps times
+```
+
+If specified, barriers can be inserted in between every block. If an initial state object is provided, it is added in front of the NLocal.
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of qubits of the circuit.
+* **rotation\_blocks** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*] |* [*qiskit.circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*qiskit.circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction")*] | None*) – The blocks used in the rotation layers. If multiple are passed, these will be applied one after another (like new sub-layers).
+* **entanglement\_blocks** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*] |* [*qiskit.circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*qiskit.circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction")*] | None*) – The blocks used in the entanglement layers. If multiple are passed, these will be applied one after another. To use different entanglements for the sub-layers, see [`get_entangler_map()`](#qiskit.circuit.library.NLocal.get_entangler_map "qiskit.circuit.library.NLocal.get_entangler_map").
+* **entanglement** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]] | None*) – The indices specifying on which qubits the input blocks act. If `None`, the entanglement blocks are applied at the top of the circuit.
+* **reps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Specifies how often the rotation blocks and entanglement blocks are repeated.
+* **insert\_barriers** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If `True`, barriers are inserted in between each layer. If `False`, no barriers are inserted.
+* **parameter\_prefix** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The prefix used if default parameters are generated.
+* **overwrite\_block\_parameters** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*]]*) – If the parameters in the added blocks should be overwritten. If `False`, the parameters in the blocks are not changed.
+* **skip\_final\_rotation\_layer** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether a final rotation layer is added to the circuit.
+* **skip\_unentangled\_qubits** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If `True`, the rotation gates act only on qubits that are entangled. If `False`, the rotation gates act on all qubits.
+* **initial\_state** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| None*) – A [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") object which can be used to describe an initial state prepended to the NLocal circuit.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The name of the circuit.
+* **flatten** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – Set this to `True` to output a flat circuit instead of nesting it inside multiple layers of gate objects. By default currently the contents of the output circuit will be wrapped in nested objects for cleaner visualization. However, if you’re using this circuit for anything besides visualization its **strongly** recommended to set this flag to `True` to avoid a large performance overhead for parameter binding.
+
+**Raises**
+
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `reps` parameter is less than or equal to 0.
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – If `reps` parameter is not an int value.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+
+
+### entanglement
+
+Get the entanglement strategy.
+
+**Returns**
+
+The entanglement strategy, see [`get_entangler_map()`](#qiskit.circuit.library.NLocal.get_entangler_map "qiskit.circuit.library.NLocal.get_entangler_map") for more detail on how the format is interpreted.
+
+
+
+### entanglement\_blocks
+
+The blocks in the entanglement layers.
+
+**Returns**
+
+The blocks in the entanglement layers.
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### flatten
+
+Returns whether the circuit is wrapped in nested gates/instructions or flattened.
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### initial\_state
+
+Return the initial state that is added in front of the n-local circuit.
+
+**Returns**
+
+The initial state.
+
+
+
+### insert\_barriers
+
+If barriers are inserted in between the layers or not.
+
+**Returns**
+
+`True`, if barriers are inserted in between the layers, `False` if not.
+
+
+
+### instances
+
+`= 165`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_layers
+
+Return the number of layers in the n-local circuit.
+
+**Returns**
+
+The number of layers in the circuit.
+
+
+
+### num\_parameters
+
+
+
+### num\_parameters\_settable
+
+The number of total parameters that can be set to distinct values.
+
+This does not change when the parameters are bound or exchanged for same parameters, and therefore is different from `num_parameters` which counts the number of unique [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects currently in the circuit.
+
+**Returns**
+
+The number of parameters originally available in the circuit.
+
+
+ This quantity does not require the circuit to be built yet.
+
+
+
+
+### num\_qubits
+
+Returns the number of qubits in this circuit.
+
+**Returns**
+
+The number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### ordered\_parameters
+
+The parameters used in the underlying circuit.
+
+This includes float values and duplicates.
+
+**Examples**
+
+```python
+>>> # prepare circuit ...
+>>> print(nlocal)
+ ┌───────┐┌──────────┐┌──────────┐┌──────────┐
+q_0: ┤ Ry(1) ├┤ Ry(θ[1]) ├┤ Ry(θ[1]) ├┤ Ry(θ[3]) ├
+ └───────┘└──────────┘└──────────┘└──────────┘
+>>> nlocal.parameters
+{Parameter(θ[1]), Parameter(θ[3])}
+>>> nlocal.ordered_parameters
+[1, Parameter(θ[1]), Parameter(θ[1]), Parameter(θ[3])]
+```
+
+**Returns**
+
+The parameters objects used in the circuit.
+
+
+
+### parameter\_bounds
+
+The parameter bounds for the unbound parameters in the circuit.
+
+**Returns**
+
+A list of pairs indicating the bounds, as (lower, upper). None indicates an unbounded parameter in the corresponding direction. If `None` is returned, problem is fully unbounded.
+
+
+
+### parameters
+
+
+
+### preferred\_init\_points
+
+The initial points for the parameters. Can be stored as initial guess in optimization.
+
+**Returns**
+
+The initial values for the parameters, or None, if none have been set.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qregs
+
+`list[QuantumRegister]`
+
+A list of the quantum registers associated with the circuit.
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+
+
+### reps
+
+The number of times rotation and entanglement block are repeated.
+
+**Returns**
+
+The number of repetitions.
+
+
+
+### rotation\_blocks
+
+The blocks in the rotation layers.
+
+**Returns**
+
+The blocks in the rotation layers.
+
+## Methods
+
+### add\_layer
+
+
+
+`add_layer(other, entanglement=None, front=False)`
+
+Append another layer to the NLocal.
+
+**Parameters**
+
+* **other** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *|*[*qiskit.circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction")) – The layer to compose, can be another NLocal, an Instruction or Gate, or a QuantumCircuit.
+* **entanglement** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] |* [*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]] | None*) – The entanglement or qubit indices.
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, `other` is appended to the front, else to the back.
+
+**Returns**
+
+self, such that chained composes are possible.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – If other is not compatible, i.e. is no Instruction and does not have a to\_instruction method.
+
+**Return type**
+
+[NLocal](#qiskit.circuit.library.NLocal "qiskit.circuit.library.NLocal")
+
+### assign\_parameters
+
+
+
+`assign_parameters(parameters, inplace=False, **kwargs)`
+
+Assign parameters to the n-local circuit.
+
+This method also supports passing a list instead of a dictionary. If a list is passed, the list must have the same length as the number of unbound parameters in the circuit. The parameters are assigned in the order of the parameters in [`ordered_parameters()`](#qiskit.circuit.library.NLocal.ordered_parameters "qiskit.circuit.library.NLocal.ordered_parameters").
+
+**Returns**
+
+A copy of the NLocal circuit with the specified parameters.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the parameters are given as list and do not match the number of parameters.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") | None
+
+### get\_entangler\_map
+
+
+
+`get_entangler_map(rep_num, block_num, num_block_qubits)`
+
+Get the entangler map for in the repetition `rep_num` and the block `block_num`.
+
+The entangler map for the current block is derived from the value of `self.entanglement`. Below the different cases are listed, where `i` and `j` denote the repetition number and the block number, respectively, and `n` the number of qubits in the block.
+
+| entanglement type | entangler map |
+| -------------------------------- | -------------------------------------------------- |
+| `None` | `[[0, ..., n - 1]]` |
+| `str` (e.g `'full'`) | the specified connectivity on `n` qubits |
+| `List[int]` | \[`entanglement`] |
+| `List[List[int]]` | `entanglement` |
+| `List[List[List[int]]]` | `entanglement[i]` |
+| `List[List[List[List[int]]]]` | `entanglement[i][j]` |
+| `List[str]` | the connectivity specified in `entanglement[i]` |
+| `List[List[str]]` | the connectivity specified in `entanglement[i][j]` |
+| `Callable[int, str]` | same as `List[str]` |
+| `Callable[int, List[List[int]]]` | same as `List[List[List[int]]]` |
+
+Note that all indices are to be taken modulo the length of the array they act on, i.e. no out-of-bounds index error will be raised but we re-iterate from the beginning of the list.
+
+**Parameters**
+
+* **rep\_num** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The current repetition we are in.
+* **block\_num** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The block number within the entanglement layers.
+* **num\_block\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of qubits in the block.
+
+**Returns**
+
+The entangler map for the current block in the current repetition.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If the value of `entanglement` could not be cast to a corresponding entangler map.
+
+**Return type**
+
+[*Sequence*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Sequence "(in Python v3.12)")\[[*Sequence*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Sequence "(in Python v3.12)")\[[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")]]
+
+### get\_unentangled\_qubits
+
+
+
+`get_unentangled_qubits()`
+
+Get the indices of unentangled qubits in a set.
+
+**Returns**
+
+The unentangled qubits.
+
+**Return type**
+
+[set](https://docs.python.org/3/library/stdtypes.html#set "(in Python v3.12)")\[[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")]
+
+### print\_settings
+
+
+
+`print_settings()`
+
+Returns information about the setting.
+
+**Returns**
+
+The class name and the attributes/parameters of the instance as `str`.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.OR.md b/docs/api/qiskit/0.46/qiskit.circuit.library.OR.md
new file mode 100644
index 00000000000..1dd502a2a2f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.OR.md
@@ -0,0 +1,227 @@
+---
+title: OR
+description: API reference for qiskit.circuit.library.OR
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.OR
+---
+
+# OR
+
+
+
+`qiskit.circuit.library.OR(num_variable_qubits, flags=None, mcx_mode='noancilla')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/boolean_logic/quantum_or.py "view source code")
+
+Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+A circuit implementing the logical OR operation on a number of qubits.
+
+For the OR operation the state $|1\rangle$ is interpreted as `True`. The result qubit is flipped, if the state of any variable qubit is `True`. The OR is implemented using a multi-open-controlled X gate (i.e. flips if the state is $|0\rangle$) and applying an X gate on the result qubit. Using a list of flags, qubits can be skipped or negated.
+
+The OR gate without special flags:
+
+
+
+Using flags we can negate qubits or skip them. For instance, if we have 5 qubits and want to return `True` if the first qubit is `False` or one of the last two are `True` we use the flags `[-1, 0, 0, 1, 1]`.
+
+
+
+Create a new logical OR circuit.
+
+**Parameters**
+
+* **num\_variable\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The qubits of which the OR is computed. The result will be written into an additional result qubit.
+* **flags** (*Optional\[List\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]]*) – A list of +1/0/-1 marking negations or omissions of qubits.
+* **mcx\_mode** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The mode to be used to implement the multi-controlled X gate.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 168`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.PauliEvolutionGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.PauliEvolutionGate.md
new file mode 100644
index 00000000000..985bd6ab6ee
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.PauliEvolutionGate.md
@@ -0,0 +1,191 @@
+---
+title: PauliEvolutionGate
+description: API reference for qiskit.circuit.library.PauliEvolutionGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.PauliEvolutionGate
+---
+
+# PauliEvolutionGate
+
+
+
+`qiskit.circuit.library.PauliEvolutionGate(operator, time=1.0, label=None, synthesis=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/pauli_evolution.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+Time-evolution of an operator consisting of Paulis.
+
+For an operator $H$ consisting of Pauli terms and (real) evolution time $t$ this gate implements
+
+$$
+U(t) = e^{-itH}.
+$$
+
+This gate serves as a high-level definition of the evolution and can be synthesized into a circuit using different algorithms.
+
+The evolution gates are related to the Pauli rotation gates by a factor of 2. For example the time evolution of the Pauli $X$ operator is connected to the Pauli $X$ rotation $R_X$ by
+
+$$
+U(t) = e^{-itX} = R_X(2t).
+$$
+
+**Examples:**
+
+```python
+from qiskit.circuit import QuantumCircuit
+from qiskit.circuit.library import PauliEvolutionGate
+from qiskit.opflow import I, Z, X
+
+# build the evolution gate
+operator = (Z ^ Z) - 0.1 * (X ^ I)
+evo = PauliEvolutionGate(operator, time=0.2)
+
+# plug it into a circuit
+circuit = QuantumCircuit(2)
+circuit.append(evo, range(2))
+print(circuit.draw())
+```
+
+The above will print (note that the `-0.1` coefficient is not printed!):
+
+```python
+ ┌──────────────────────────┐
+q_0: ┤0 ├
+ │ exp(-it (ZZ + XI))(0.2) │
+q_1: ┤1 ├
+ └──────────────────────────┘
+```
+
+**References:**
+
+\[1] G. Li et al. Paulihedral: A Generalized Block-Wise Compiler Optimization Framework For Quantum Simulation Kernels (2021). \[[arXiv:2109.03371](https://arxiv.org/abs/2109.03371)]
+
+**Parameters**
+
+* **operator** ([*Pauli*](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli") *|*[*PauliOp*](qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.PauliOp") *|*[*SparsePauliOp*](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp") *|*[*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – The operator to evolve. Can also be provided as list of non-commuting operators where the elements are sums of commuting operators. For example: `[XY + YX, ZZ + ZI + IZ, YY]`.
+* **time** (*Union\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")*]*) – The evolution time.
+* **label** (*Optional\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – A label for the gate to display in visualizations. Per default, the label is set to `exp(-it )` where `` is the sum of the Paulis. Note that the label does not include any coefficients of the Paulis. See the class docstring for an example.
+* **synthesis** (*Optional\[*[*EvolutionSynthesis*](qiskit.synthesis.EvolutionSynthesis "qiskit.synthesis.EvolutionSynthesis")*]*) – A synthesis strategy. If None, the default synthesis is the Lie-Trotter product formula with a single repetition.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.PauliEvolutionGate.base_class "qiskit.circuit.library.PauliEvolutionGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### time
+
+Return the evolution time as stored in the gate parameters.
+
+**Returns**
+
+The evolution time.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Gate parameters should be int, float, or ParameterExpression
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") | [*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.PauliFeatureMap.md b/docs/api/qiskit/0.46/qiskit.circuit.library.PauliFeatureMap.md
new file mode 100644
index 00000000000..8ee9fc54600
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.PauliFeatureMap.md
@@ -0,0 +1,418 @@
+---
+title: PauliFeatureMap
+description: API reference for qiskit.circuit.library.PauliFeatureMap
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.PauliFeatureMap
+---
+
+# PauliFeatureMap
+
+
+
+`qiskit.circuit.library.PauliFeatureMap(feature_dimension=None, reps=2, entanglement='full', alpha=2.0, paulis=None, data_map_func=None, parameter_prefix='x', insert_barriers=False, name='PauliFeatureMap')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/data_preparation/pauli_feature_map.py "view source code")
+
+Bases: [`NLocal`](qiskit.circuit.library.NLocal "qiskit.circuit.library.n_local.n_local.NLocal")
+
+The Pauli Expansion circuit.
+
+The Pauli Expansion circuit is a data encoding circuit that transforms input data $\vec{x} \in \mathbb{R}^n$, where n is the `feature_dimension`, as
+
+$$
+U_{\Phi(\vec{x})}=\exp\left(i\sum_{S \in \mathcal{I}}
+\phi_S(\vec{x})\prod_{i\in S} P_i\right).
+$$
+
+Here, $S$ is a set of qubit indices that describes the connections in the feature map, $\mathcal{I}$ is a set containing all these index sets, and $P_i \in \{I, X, Y, Z\}$. Per default the data-mapping $\phi_S$ is
+
+$$
+\phi_S(\vec{x}) = \begin{cases}
+ x_i \text{ if } S = \{i\} \\
+ \prod_{j \in S} (\pi - x_j) \text{ if } |S| > 1
+ \end{cases}.
+$$
+
+The possible connections can be set using the `entanglement` and `paulis` arguments. For example, for single-qubit $Z$ rotations and two-qubit $YY$ interactions between all qubit pairs, we can set:
+
+```python
+feature_map = PauliFeatureMap(..., paulis=["Z", "YY"], entanglement="full")
+```
+
+which will produce blocks of the form
+
+```python
+┌───┐┌──────────────┐┌──────────┐ ┌───────────┐
+┤ H ├┤ U1(2.0*x[0]) ├┤ RX(pi/2) ├──■───────────────────────────────────────■──┤ RX(-pi/2) ├
+├───┤├──────────────┤├──────────┤┌─┴─┐┌─────────────────────────────────┐┌─┴─┐├───────────┤
+┤ H ├┤ U1(2.0*x[1]) ├┤ RX(pi/2) ├┤ X ├┤ U1(2.0*(pi - x[0])*(pi - x[1])) ├┤ X ├┤ RX(-pi/2) ├
+└───┘└──────────────┘└──────────┘└───┘└─────────────────────────────────┘└───┘└───────────┘
+```
+
+The circuit contains `reps` repetitions of this transformation.
+
+Please refer to [`ZFeatureMap`](qiskit.circuit.library.ZFeatureMap "qiskit.circuit.library.ZFeatureMap") for the case of single-qubit Pauli-$Z$ rotations and to [`ZZFeatureMap`](qiskit.circuit.library.ZZFeatureMap "qiskit.circuit.library.ZZFeatureMap") for the single- and two-qubit Pauli-$Z$ rotations.
+
+**Examples**
+
+```python
+>>> prep = PauliFeatureMap(2, reps=1, paulis=['ZZ'])
+>>> print(prep)
+ ┌───┐
+q_0: ┤ H ├──■───────────────────────────────────────■──
+ ├───┤┌─┴─┐┌─────────────────────────────────┐┌─┴─┐
+q_1: ┤ H ├┤ X ├┤ U1(2.0*(pi - x[0])*(pi - x[1])) ├┤ X ├
+ └───┘└───┘└─────────────────────────────────┘└───┘
+```
+
+```python
+>>> prep = PauliFeatureMap(2, reps=1, paulis=['Z', 'XX'])
+>>> print(prep)
+ ┌───┐┌──────────────┐┌───┐ ┌───┐
+q_0: ┤ H ├┤ U1(2.0*x[0]) ├┤ H ├──■───────────────────────────────────────■──┤ H ├
+ ├───┤├──────────────┤├───┤┌─┴─┐┌─────────────────────────────────┐┌─┴─┐├───┤
+q_1: ┤ H ├┤ U1(2.0*x[1]) ├┤ H ├┤ X ├┤ U1(2.0*(pi - x[0])*(pi - x[1])) ├┤ X ├┤ H ├
+ └───┘└──────────────┘└───┘└───┘└─────────────────────────────────┘└───┘└───┘
+```
+
+```python
+>>> prep = PauliFeatureMap(2, reps=1, paulis=['ZY'])
+>>> print(prep)
+ ┌───┐┌──────────┐ ┌───────────┐
+q_0: ┤ H ├┤ RX(pi/2) ├──■───────────────────────────────────────■──┤ RX(-pi/2) ├
+ ├───┤└──────────┘┌─┴─┐┌─────────────────────────────────┐┌─┴─┐└───────────┘
+q_1: ┤ H ├────────────┤ X ├┤ U1(2.0*(pi - x[0])*(pi - x[1])) ├┤ X ├─────────────
+ └───┘ └───┘└─────────────────────────────────┘└───┘
+```
+
+```python
+>>> from qiskit.circuit.library import EfficientSU2
+>>> prep = PauliFeatureMap(3, reps=3, paulis=['Z', 'YY', 'ZXZ'])
+>>> wavefunction = EfficientSU2(3)
+>>> classifier = prep.compose(wavefunction
+>>> classifier.num_parameters
+27
+>>> classifier.count_ops()
+OrderedDict([('cx', 39), ('rx', 36), ('u1', 21), ('h', 15), ('ry', 12), ('rz', 12)])
+```
+
+References:
+
+\[1] Havlicek et al. Supervised learning with quantum enhanced feature spaces, [Nature 567, 209-212 (2019)](https://www.nature.com/articles/s41586-019-0980-2).
+
+Create a new Pauli expansion circuit.
+
+**Parameters**
+
+* **feature\_dimension** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – Number of qubits in the circuit.
+* **reps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of repeated circuits.
+* **entanglement** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]] |* [*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")*\[\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*],* [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]]*) – Specifies the entanglement structure. Refer to [`NLocal`](qiskit.circuit.library.NLocal "qiskit.circuit.library.NLocal") for detail.
+* **alpha** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The Pauli rotation factor, multiplicative to the pauli rotations
+* **paulis** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*] | None*) – A list of strings for to-be-used paulis. If None are provided, `['Z', 'ZZ']` will be used.
+* **data\_map\_func** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")*\[\[*[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")*],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – A mapping function for data x which can be supplied to override the default mapping from `self_product()`.
+* **parameter\_prefix** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The prefix used if default parameters are generated.
+* **insert\_barriers** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, barriers are inserted in between the evolution instructions and hadamard layers.
+
+## Attributes
+
+
+
+### alpha
+
+The Pauli rotation factor (alpha).
+
+**Returns**
+
+The Pauli rotation factor.
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+
+
+### entanglement
+
+Get the entanglement strategy.
+
+**Returns**
+
+The entanglement strategy, see `get_entangler_map()` for more detail on how the format is interpreted.
+
+
+
+### entanglement\_blocks
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### feature\_dimension
+
+Returns the feature dimension (which is equal to the number of qubits).
+
+**Returns**
+
+The feature dimension of this feature map.
+
+
+
+### flatten
+
+Returns whether the circuit is wrapped in nested gates/instructions or flattened.
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### initial\_state
+
+Return the initial state that is added in front of the n-local circuit.
+
+**Returns**
+
+The initial state.
+
+
+
+### insert\_barriers
+
+If barriers are inserted in between the layers or not.
+
+**Returns**
+
+`True`, if barriers are inserted in between the layers, `False` if not.
+
+
+
+### instances
+
+`= 173`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_layers
+
+Return the number of layers in the n-local circuit.
+
+**Returns**
+
+The number of layers in the circuit.
+
+
+
+### num\_parameters
+
+
+
+### num\_parameters\_settable
+
+The number of distinct parameters.
+
+
+
+### num\_qubits
+
+Returns the number of qubits in this circuit.
+
+**Returns**
+
+The number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### ordered\_parameters
+
+The parameters used in the underlying circuit.
+
+This includes float values and duplicates.
+
+**Examples**
+
+```python
+>>> # prepare circuit ...
+>>> print(nlocal)
+ ┌───────┐┌──────────┐┌──────────┐┌──────────┐
+q_0: ┤ Ry(1) ├┤ Ry(θ[1]) ├┤ Ry(θ[1]) ├┤ Ry(θ[3]) ├
+ └───────┘└──────────┘└──────────┘└──────────┘
+>>> nlocal.parameters
+{Parameter(θ[1]), Parameter(θ[3])}
+>>> nlocal.ordered_parameters
+[1, Parameter(θ[1]), Parameter(θ[1]), Parameter(θ[3])]
+```
+
+**Returns**
+
+The parameters objects used in the circuit.
+
+
+
+### parameter\_bounds
+
+The parameter bounds for the unbound parameters in the circuit.
+
+**Returns**
+
+A list of pairs indicating the bounds, as (lower, upper). None indicates an unbounded parameter in the corresponding direction. If `None` is returned, problem is fully unbounded.
+
+
+
+### parameters
+
+
+
+### paulis
+
+The Pauli strings used in the entanglement of the qubits.
+
+**Returns**
+
+The Pauli strings as list.
+
+
+
+### preferred\_init\_points
+
+The initial points for the parameters. Can be stored as initial guess in optimization.
+
+**Returns**
+
+The initial values for the parameters, or None, if none have been set.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qregs
+
+`list[QuantumRegister]`
+
+A list of the quantum registers associated with the circuit.
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+
+
+### reps
+
+The number of times rotation and entanglement block are repeated.
+
+**Returns**
+
+The number of repetitions.
+
+
+
+### rotation\_blocks
+
+The blocks in the rotation layers.
+
+**Returns**
+
+The blocks in the rotation layers.
+
+## Methods
+
+### pauli\_block
+
+
+
+`pauli_block(pauli_string)`
+
+Get the Pauli block for the feature map circuit.
+
+### pauli\_evolution
+
+
+
+`pauli_evolution(pauli_string, time)`
+
+Get the evolution block for the given pauli string.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.PauliGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.PauliGate.md
new file mode 100644
index 00000000000..81b9602d8bc
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.PauliGate.md
@@ -0,0 +1,148 @@
+---
+title: PauliGate
+description: API reference for qiskit.circuit.library.PauliGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.PauliGate
+---
+
+# PauliGate
+
+
+
+`qiskit.circuit.library.PauliGate(label)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/generalized_gates/pauli.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+A multi-qubit Pauli gate.
+
+This gate exists for optimization purposes for the quantum statevector simulation, since applying multiple pauli gates to different qubits at once can be done via a single pass on the statevector.
+
+The functionality is equivalent to applying the pauli gates sequentially using standard Qiskit gates.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`pauli()`](qiskit.circuit.QuantumCircuit#pauli "qiskit.circuit.QuantumCircuit.pauli") method.
+
+Create a new gate.
+
+**Parameters**
+
+* **name** – The Qobj name of the gate.
+* **num\_qubits** – The number of qubits the gate acts on.
+* **params** – A list of parameters.
+* **label** – An optional label for the gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.PauliGate.base_class "qiskit.circuit.library.PauliGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted pauli gate (itself).
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Gate parameters should be int, float, or ParameterExpression
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.PauliTwoDesign.md b/docs/api/qiskit/0.46/qiskit.circuit.library.PauliTwoDesign.md
new file mode 100644
index 00000000000..282be122251
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.PauliTwoDesign.md
@@ -0,0 +1,329 @@
+---
+title: PauliTwoDesign
+description: API reference for qiskit.circuit.library.PauliTwoDesign
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.PauliTwoDesign
+---
+
+# PauliTwoDesign
+
+
+
+`qiskit.circuit.library.PauliTwoDesign(num_qubits=None, reps=3, seed=None, insert_barriers=False, name='PauliTwoDesign')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/n_local/pauli_two_design.py "view source code")
+
+Bases: [`TwoLocal`](qiskit.circuit.library.TwoLocal "qiskit.circuit.library.n_local.two_local.TwoLocal")
+
+The Pauli Two-Design ansatz.
+
+This class implements a particular form of a 2-design circuit \[1], which is frequently studied in quantum machine learning literature, such as e.g. the investigating of Barren plateaus in variational algorithms \[2].
+
+The circuit consists of alternating rotation and entanglement layers with an initial layer of $\sqrt{H} = RY(\pi/4)$ gates. The rotation layers contain single qubit Pauli rotations, where the axis is chosen uniformly at random to be X, Y or Z. The entanglement layers is compromised of pairwise CZ gates with a total depth of 2.
+
+For instance, the circuit could look like this (but note that choosing a different seed yields different Pauli rotations).
+
+```python
+ ┌─────────┐┌──────────┐ ░ ┌──────────┐ ░ ┌──────────┐
+q_0: ┤ RY(π/4) ├┤ RZ(θ[0]) ├─■─────░─┤ RY(θ[4]) ├─■─────░──┤ RZ(θ[8]) ├
+ ├─────────┤├──────────┤ │ ░ ├──────────┤ │ ░ ├──────────┤
+q_1: ┤ RY(π/4) ├┤ RZ(θ[1]) ├─■──■──░─┤ RY(θ[5]) ├─■──■──░──┤ RX(θ[9]) ├
+ ├─────────┤├──────────┤ │ ░ ├──────────┤ │ ░ ┌┴──────────┤
+q_2: ┤ RY(π/4) ├┤ RX(θ[2]) ├─■──■──░─┤ RY(θ[6]) ├─■──■──░─┤ RX(θ[10]) ├
+ ├─────────┤├──────────┤ │ ░ ├──────────┤ │ ░ ├───────────┤
+q_3: ┤ RY(π/4) ├┤ RZ(θ[3]) ├─■─────░─┤ RX(θ[7]) ├─■─────░─┤ RY(θ[11]) ├
+ └─────────┘└──────────┘ ░ └──────────┘ ░ └───────────┘
+```
+
+**Examples**
+
+```python
+from qiskit.circuit.library import PauliTwoDesign
+circuit = PauliTwoDesign(4, reps=2, seed=5, insert_barriers=True)
+circuit.draw('mpl')
+```
+
+
+
+**References**
+
+**\[1]: Nakata et al., Unitary 2-designs from random X- and Z-diagonal unitaries.**
+
+[arXiv:1502.07514](https://arxiv.org/pdf/1502.07514.pdf)
+
+**\[2]: McClean et al., Barren plateaus in quantum neural network training landscapes.**
+
+[arXiv:1803.11173](https://arxiv.org/pdf/1803.11173.pdf)
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of qubits of the Pauli Two-Design circuit.
+* **reps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Specifies how often a block consisting of a rotation layer and entanglement layer is repeated.
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The seed for randomly choosing the axes of the Pauli rotations.
+* **insert\_barriers** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If `True`, barriers are inserted in between each layer. If `False`, no barriers are inserted. Defaults to `False`.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+
+
+### entanglement
+
+Get the entanglement strategy.
+
+**Returns**
+
+The entanglement strategy, see `get_entangler_map()` for more detail on how the format is interpreted.
+
+
+
+### entanglement\_blocks
+
+The blocks in the entanglement layers.
+
+**Returns**
+
+The blocks in the entanglement layers.
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### flatten
+
+Returns whether the circuit is wrapped in nested gates/instructions or flattened.
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### initial\_state
+
+Return the initial state that is added in front of the n-local circuit.
+
+**Returns**
+
+The initial state.
+
+
+
+### insert\_barriers
+
+If barriers are inserted in between the layers or not.
+
+**Returns**
+
+`True`, if barriers are inserted in between the layers, `False` if not.
+
+
+
+### instances
+
+`= 174`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_layers
+
+Return the number of layers in the n-local circuit.
+
+**Returns**
+
+The number of layers in the circuit.
+
+
+
+### num\_parameters
+
+
+
+### num\_parameters\_settable
+
+Return the number of settable parameters.
+
+**Returns**
+
+The number of possibly distinct parameters.
+
+
+
+### num\_qubits
+
+Returns the number of qubits in this circuit.
+
+**Returns**
+
+The number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### ordered\_parameters
+
+The parameters used in the underlying circuit.
+
+This includes float values and duplicates.
+
+**Examples**
+
+```python
+>>> # prepare circuit ...
+>>> print(nlocal)
+ ┌───────┐┌──────────┐┌──────────┐┌──────────┐
+q_0: ┤ Ry(1) ├┤ Ry(θ[1]) ├┤ Ry(θ[1]) ├┤ Ry(θ[3]) ├
+ └───────┘└──────────┘└──────────┘└──────────┘
+>>> nlocal.parameters
+{Parameter(θ[1]), Parameter(θ[3])}
+>>> nlocal.ordered_parameters
+[1, Parameter(θ[1]), Parameter(θ[1]), Parameter(θ[3])]
+```
+
+**Returns**
+
+The parameters objects used in the circuit.
+
+
+
+### parameter\_bounds
+
+The parameter bounds for the unbound parameters in the circuit.
+
+**Returns**
+
+A list of pairs indicating the bounds, as (lower, upper). None indicates an unbounded parameter in the corresponding direction. If `None` is returned, problem is fully unbounded.
+
+
+
+### parameters
+
+
+
+### preferred\_init\_points
+
+The initial points for the parameters. Can be stored as initial guess in optimization.
+
+**Returns**
+
+The initial values for the parameters, or None, if none have been set.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qregs
+
+`list[QuantumRegister]`
+
+A list of the quantum registers associated with the circuit.
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+
+
+### reps
+
+The number of times rotation and entanglement block are repeated.
+
+**Returns**
+
+The number of repetitions.
+
+
+
+### rotation\_blocks
+
+The blocks in the rotation layers.
+
+**Returns**
+
+The blocks in the rotation layers.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.Permutation.md b/docs/api/qiskit/0.46/qiskit.circuit.library.Permutation.md
new file mode 100644
index 00000000000..67683df9d9f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.Permutation.md
@@ -0,0 +1,229 @@
+---
+title: Permutation
+description: API reference for qiskit.circuit.library.Permutation
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.Permutation
+---
+
+# Permutation
+
+
+
+`qiskit.circuit.library.Permutation(num_qubits, pattern=None, seed=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/generalized_gates/permutation.py "view source code")
+
+Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+An n\_qubit circuit that permutes qubits.
+
+Return an n\_qubit permutation circuit implemented using SWAPs.
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – circuit width.
+* **pattern** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | np.ndarray | None*) – permutation pattern, describing which qubits occupy the positions 0, 1, 2, etc. after applying the permutation, that is `pattern[k] = m` when the permutation maps qubit `m` to position `k`. As an example, the pattern `[2, 4, 3, 0, 1]` means that qubit `2` goes to position `0`, qubit `4` goes to the position `1`, etc. The pattern can also be `None`, in which case a random permutation over `num_qubits` is created.
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – random seed in case a random permutation is requested.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if permutation pattern is malformed.
+
+**Reference Circuit:**
+
+
+
+**Expanded Circuit:**
+
+
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 192`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.PermutationGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.PermutationGate.md
new file mode 100644
index 00000000000..469398a0091
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.PermutationGate.md
@@ -0,0 +1,157 @@
+---
+title: PermutationGate
+description: API reference for qiskit.circuit.library.PermutationGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.PermutationGate
+---
+
+# PermutationGate
+
+
+
+`qiskit.circuit.library.PermutationGate(pattern)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/generalized_gates/permutation.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+A gate that permutes qubits.
+
+Return a permutation gate.
+
+**Parameters**
+
+**pattern** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – permutation pattern, describing which qubits occupy the positions 0, 1, 2, etc. after applying the permutation, that is `pattern[k] = m` when the permutation maps qubit `m` to position `k`. As an example, the pattern `[2, 4, 3, 0, 1]` means that qubit `2` goes to position `0`, qubit `4` goes to the position `1`, etc.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if permutation pattern is malformed.
+
+**Reference Circuit:**
+
+
+
+**Expanded Circuit:**
+
+
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.PermutationGate.base_class "qiskit.circuit.library.PermutationGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### pattern
+
+Returns the permutation pattern defining this permutation.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Returns the inverse of the permutation.
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Parameter validation.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.PhaseEstimation.md b/docs/api/qiskit/0.46/qiskit.circuit.library.PhaseEstimation.md
new file mode 100644
index 00000000000..ee66766b1eb
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.PhaseEstimation.md
@@ -0,0 +1,246 @@
+---
+title: PhaseEstimation
+description: API reference for qiskit.circuit.library.PhaseEstimation
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.PhaseEstimation
+---
+
+# PhaseEstimation
+
+
+
+`qiskit.circuit.library.PhaseEstimation(num_evaluation_qubits, unitary, iqft=None, name='QPE')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/phase_estimation.py "view source code")
+
+Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+Phase Estimation circuit.
+
+In the Quantum Phase Estimation (QPE) algorithm \[1, 2, 3], the Phase Estimation circuit is used to estimate the phase $\phi$ of an eigenvalue $e^{2\pi i\phi}$ of a unitary operator $U$, provided with the corresponding eigenstate $|\psi\rangle$. That is
+
+$$
+U|\psi\rangle = e^{2\pi i\phi} |\psi\rangle
+$$
+
+This estimation (and thereby this circuit) is a central routine to several well-known algorithms, such as Shor’s algorithm or Quantum Amplitude Estimation.
+
+**References:**
+
+**\[1]: Kitaev, A. Y. (1995). Quantum measurements and the Abelian Stabilizer Problem. 1–22.**
+
+[quant-ph/9511026](http://arxiv.org/abs/quant-ph/9511026)
+
+**\[2]: Michael A. Nielsen and Isaac L. Chuang. 2011.**
+
+Quantum Computation and Quantum Information: 10th Anniversary Edition (10th ed.). Cambridge University Press, New York, NY, USA.
+
+**\[3]: Qiskit**
+
+[textbook](https://github.com/Qiskit/textbook/blob/main/notebooks/ch-algorithms/quantum-phase-estimation.ipynb)
+
+**Parameters**
+
+* **num\_evaluation\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of evaluation qubits.
+* **unitary** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")) – The unitary operation $U$ which will be repeated and controlled.
+* **iqft** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit") *| None*) – A inverse Quantum Fourier Transform, per default the inverse of [`QFT`](qiskit.circuit.library.QFT "qiskit.circuit.library.QFT") is used. Note that the QFT should not include the usual swaps!
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the circuit.
+
+
+ The inverse QFT should not include a swap of the qubit order.
+
+
+**Reference Circuit:**
+
+
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 246`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.PhaseGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.PhaseGate.md
new file mode 100644
index 00000000000..0d5ed6963c0
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.PhaseGate.md
@@ -0,0 +1,203 @@
+---
+title: PhaseGate
+description: API reference for qiskit.circuit.library.PhaseGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.PhaseGate
+---
+
+# PhaseGate
+
+
+
+`qiskit.circuit.library.PhaseGate(theta, label=None, *, duration=None, unit='dt')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/p.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+Single-qubit rotation about the Z axis.
+
+This is a diagonal gate. It can be implemented virtually in hardware via framechanges (i.e. at zero error and duration).
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`p()`](qiskit.circuit.QuantumCircuit#p "qiskit.circuit.QuantumCircuit.p") method.
+
+**Circuit symbol:**
+
+```python
+ ┌──────┐
+q_0: ┤ P(λ) ├
+ └──────┘
+```
+
+**Matrix Representation:**
+
+$$
+P(\lambda) =
+ \begin{pmatrix}
+ 1 & 0 \\
+ 0 & e^{i\lambda}
+ \end{pmatrix}
+$$
+
+**Examples:**
+
+> $$
+> P(\lambda = \pi) = Z
+> $$
+>
+> $$
+> P(\lambda = \pi/2) = S
+> $$
+>
+> $$
+> P(\lambda = \pi/4) = T
+> $$
+
+
+ `RZGate`: This gate is equivalent to RZ up to a phase factor.
+
+ > $$
+ > P(\lambda) = e^{i{\lambda}/2} RZ(\lambda)
+ > $$
+
+ Reference for virtual Z gate implementation: [1612.00858](https://arxiv.org/abs/1612.00858)
+
+
+Create new Phase gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.PhaseGate.base_class "qiskit.circuit.library.PhaseGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Return a (multi-)controlled-Phase gate.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of control qubits.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for the gate \[Default: None]
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – control state expressed as integer, string (e.g. ‘110’), or None. If None, use all 1s.
+
+**Returns**
+
+controlled version of this gate.
+
+**Return type**
+
+[ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted Phase gate ($Phase(\lambda)^{\dagger} = Phase(-\lambda)$)
+
+### power
+
+
+
+`power(exponent)`
+
+Raise gate to a power.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.PhaseOracle.md b/docs/api/qiskit/0.46/qiskit.circuit.library.PhaseOracle.md
new file mode 100644
index 00000000000..417bd3cacce
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.PhaseOracle.md
@@ -0,0 +1,283 @@
+---
+title: PhaseOracle
+description: API reference for qiskit.circuit.library.PhaseOracle
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.PhaseOracle
+---
+
+# PhaseOracle
+
+
+
+`qiskit.circuit.library.PhaseOracle(expression, synthesizer=None, var_order=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/phase_oracle.py "view source code")
+
+Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+Phase Oracle.
+
+The Phase Oracle object constructs circuits for any arbitrary input logical expressions. A logical expression is composed of logical operators & (AND), | (OR), \~ (NOT), and ^ (XOR). as well as symbols for literals (variables). For example, ‘a & b’, and (v0 | \~v1) & (\~v2 & v3) are both valid string representation of boolean logical expressions.
+
+For convenience, this oracle, in addition to parsing arbitrary logical expressions, also supports input strings in the [DIMACS CNF format](http://www.satcompetition.org/2009/format-benchmarks2009.html), which is the standard format for specifying SATisfiability (SAT) problem instances in [Conjunctive Normal Form (CNF)](https://en.wikipedia.org/wiki/Conjunctive_normal_form), which is a conjunction of one or more clauses, where a clause is a disjunction of one or more literals. See `qiskit.circuit.library.phase_oracle.PhaseOracle.from_dimacs_file()`.
+
+From 16 variables on, possible performance issues should be expected when using the default synthesizer.
+
+Creates a PhaseOracle object
+
+**Parameters**
+
+* **expression** (*Union\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*, ClassicalElement]*) – A Python-like boolean expression.
+* **synthesizer** (*Optional\[Callable\[\[*[*BooleanExpression*](qiskit.circuit.classicalfunction.BooleanExpression "qiskit.circuit.classicalfunction.BooleanExpression")*],* [*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]]*) – Optional. A function to convert a BooleanExpression into a QuantumCircuit If None is provided, Tweedledum’s pkrm\_synth with phase\_esop will be used.
+* **var\_order** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list with the order in which variables will be created. (default: by appearance)
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 248`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+## Methods
+
+### evaluate\_bitstring
+
+
+
+`evaluate_bitstring(bitstring)`
+
+Evaluate the oracle on a bitstring. This evaluation is done classically without any quantum circuit.
+
+**Parameters**
+
+**bitstring** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The bitstring for which to evaluate. The input bitstring is expected to be in little-endian order.
+
+**Returns**
+
+True if the bitstring is a good state, False otherwise.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### from\_dimacs\_file
+
+
+
+`classmethod from_dimacs_file(filename)`
+
+Create a PhaseOracle from the string in the DIMACS format.
+
+It is possible to build a PhaseOracle from a file in [DIMACS CNF format](http://www.satcompetition.org/2009/format-benchmarks2009.html), which is the standard format for specifying SATisfiability (SAT) problem instances in [Conjunctive Normal Form (CNF)](https://en.wikipedia.org/wiki/Conjunctive_normal_form), which is a conjunction of one or more clauses, where a clause is a disjunction of one or more literals.
+
+The following is an example of a CNF expressed in the DIMACS format:
+
+```python
+c DIMACS CNF file with 3 satisfying assignments: 1 -2 3, -1 -2 -3, 1 2 -3.
+p cnf 3 5
+-1 -2 -3 0
+1 -2 3 0
+1 2 -3 0
+1 -2 -3 0
+-1 2 3 0
+```
+
+The first line, following the c character, is a comment. The second line specifies that the CNF is over three boolean variables — let us call them $x_1, x_2, x_3$, and contains five clauses. The five clauses, listed afterwards, are implicitly joined by the logical AND operator, $\land$, while the variables in each clause, represented by their indices, are implicitly disjoined by the logical OR operator, $lor$. The $-$ symbol preceding a boolean variable index corresponds to the logical NOT operator, $lnot$. Character 0 (zero) marks the end of each clause. Essentially, the code above corresponds to the following CNF:
+
+$(\lnot x_1 \lor \lnot x_2 \lor \lnot x_3) \land (x_1 \lor \lnot x_2 \lor x_3) \land (x_1 \lor x_2 \lor \lnot x_3) \land (x_1 \lor \lnot x_2 \lor \lnot x_3) \land (\lnot x_1 \lor x_2 \lor x_3)$.
+
+**Parameters**
+
+**filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – A file in DIMACS format.
+
+**Returns**
+
+A quantum circuit with a phase oracle.
+
+**Return type**
+
+[PhaseOracle](#qiskit.circuit.library.PhaseOracle "qiskit.circuit.library.PhaseOracle")
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.PiecewiseChebyshev.md b/docs/api/qiskit/0.46/qiskit.circuit.library.PiecewiseChebyshev.md
new file mode 100644
index 00000000000..67e2a5ceb11
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.PiecewiseChebyshev.md
@@ -0,0 +1,241 @@
+---
+title: PiecewiseChebyshev
+description: API reference for qiskit.circuit.library.PiecewiseChebyshev
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.PiecewiseChebyshev
+---
+
+# PiecewiseChebyshev
+
+
+
+`qiskit.circuit.library.PiecewiseChebyshev(f_x, degree=None, breakpoints=None, num_state_qubits=None, name='pw_cheb')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/arithmetic/piecewise_chebyshev.py "view source code")
+
+Bases: `BlueprintCircuit`
+
+Piecewise Chebyshev approximation to an input function.
+
+For a given function $f(x)$ and degree $d$, this class implements a piecewise polynomial Chebyshev approximation on $n$ qubits to $f(x)$ on the given intervals. All the polynomials in the approximation are of degree $d$.
+
+The values of the parameters are calculated according to \[1] and see \[2] for a more detailed explanation of the circuit construction and how it acts on the qubits.
+
+**Examples**
+
+```python
+import numpy as np
+from qiskit import QuantumCircuit
+from qiskit.circuit.library.arithmetic.piecewise_chebyshev import PiecewiseChebyshev
+f_x, degree, breakpoints, num_state_qubits = lambda x: np.arcsin(1 / x), 2, [2, 4], 2
+pw_approximation = PiecewiseChebyshev(f_x, degree, breakpoints, num_state_qubits)
+pw_approximation._build()
+qc = QuantumCircuit(pw_approximation.num_qubits)
+qc.h(list(range(num_state_qubits)))
+qc.append(pw_approximation.to_instruction(), qc.qubits)
+qc.draw(output='mpl')
+```
+
+
+
+**References**
+
+**\[1]: Haener, T., Roetteler, M., & Svore, K. M. (2018).**
+
+Optimizing Quantum Circuits for Arithmetic. [arXiv:1805.12445](http://arxiv.org/abs/1805.12445)
+
+**\[2]: Carrera Vazquez, A., Hiptmair, H., & Woerner, S. (2022).**
+
+Enhancing the Quantum Linear Systems Algorithm Using Richardson Extrapolation. [ACM Transactions on Quantum Computing 3, 1, Article 2](https://doi.org/10.1145/3490631)
+
+**Parameters**
+
+* **f\_x** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| Callable\[\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – the function to be approximated. Constant functions should be specified as f\_x = constant.
+* **degree** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – the degree of the polynomials. Defaults to `1`.
+* **breakpoints** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – the breakpoints to define the piecewise-linear function. Defaults to the full interval.
+* **num\_state\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – number of qubits representing the state.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the circuit object.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### breakpoints
+
+The breakpoints for the piecewise approximation.
+
+**Returns**
+
+The breakpoints for the piecewise approximation.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+
+
+### degree
+
+The degree of the polynomials.
+
+**Returns**
+
+The degree of the polynomials.
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### f\_x
+
+The function to be approximated.
+
+**Returns**
+
+The function to be approximated.
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 250`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### num\_state\_qubits
+
+The number of state qubits representing the state $|x\rangle$.
+
+**Returns**
+
+The number of state qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+
+
+### polynomials
+
+The polynomials for the piecewise approximation.
+
+**Returns**
+
+The polynomials for the piecewise approximation.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – If the input function is not in the correct format.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qregs
+
+`list[QuantumRegister]`
+
+A list of the quantum registers associated with the circuit.
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.PiecewiseLinearPauliRotations.md b/docs/api/qiskit/0.46/qiskit.circuit.library.PiecewiseLinearPauliRotations.md
new file mode 100644
index 00000000000..27872c7ab47
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.PiecewiseLinearPauliRotations.md
@@ -0,0 +1,278 @@
+---
+title: PiecewiseLinearPauliRotations
+description: API reference for qiskit.circuit.library.PiecewiseLinearPauliRotations
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.PiecewiseLinearPauliRotations
+---
+
+# PiecewiseLinearPauliRotations
+
+
+
+`qiskit.circuit.library.PiecewiseLinearPauliRotations(num_state_qubits=None, breakpoints=None, slopes=None, offsets=None, basis='Y', name='pw_lin')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/arithmetic/piecewise_linear_pauli_rotations.py "view source code")
+
+Bases: [`FunctionalPauliRotations`](qiskit.circuit.library.FunctionalPauliRotations "qiskit.circuit.library.arithmetic.functional_pauli_rotations.FunctionalPauliRotations")
+
+Piecewise-linearly-controlled Pauli rotations.
+
+For a piecewise linear (not necessarily continuous) function $f(x)$, which is defined through breakpoints, slopes and offsets as follows. Suppose the breakpoints $(x_0, ..., x_J)$ are a subset of $[0, 2^n-1]$, where $n$ is the number of state qubits. Further on, denote the corresponding slopes and offsets by $a_j$ and $b_j$ respectively. Then f(x) is defined as:
+
+$$
+f(x) = \begin{cases}
+ 0, x < x_0 \\
+ a_j (x - x_j) + b_j, x_j \leq x < x_{j+1}
+ \end{cases}
+$$
+
+where we implicitly assume $x_{J+1} = 2^n$.
+
+Construct piecewise-linearly-controlled Pauli rotations.
+
+**Parameters**
+
+* **num\_state\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of qubits representing the state.
+* **breakpoints** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – The breakpoints to define the piecewise-linear function. Defaults to `[0]`.
+* **slopes** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | np.ndarray | None*) – The slopes for different segments of the piecewise-linear function. Defaults to `[1]`.
+* **offsets** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | np.ndarray | None*) – The offsets for different segments of the piecewise-linear function. Defaults to `[0]`.
+* **basis** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The type of Pauli rotation (`'X'`, `'Y'`, `'Z'`).
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the circuit.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### basis
+
+The kind of Pauli rotation to be used.
+
+Set the basis to ‘X’, ‘Y’ or ‘Z’ for controlled-X, -Y, or -Z rotations respectively.
+
+**Returns**
+
+The kind of Pauli rotation used in controlled rotation.
+
+
+
+### breakpoints
+
+The breakpoints of the piecewise linear function.
+
+The function is linear in the intervals `[point_i, point_{i+1}]` where the last point implicitly is `2**(num_state_qubits + 1)`.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### contains\_zero\_breakpoint
+
+Whether 0 is the first breakpoint.
+
+**Returns**
+
+True, if 0 is the first breakpoint, otherwise False.
+
+
+
+### data
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 310`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### mapped\_offsets
+
+The offsets mapped to the internal representation.
+
+**Returns**
+
+The mapped offsets.
+
+
+
+### mapped\_slopes
+
+The slopes mapped to the internal representation.
+
+**Returns**
+
+The mapped slopes.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancilla\_qubits
+
+The minimum number of ancilla qubits in the circuit.
+
+**Returns**
+
+The minimal number of ancillas required.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### num\_state\_qubits
+
+The number of state qubits representing the state $|x\rangle$.
+
+**Returns**
+
+The number of state qubits.
+
+
+
+### offsets
+
+The breakpoints of the piecewise linear function.
+
+The function is linear in the intervals `[point_i, point_{i+1}]` where the last point implicitly is `2**(num_state_qubits + 1)`.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qregs
+
+`list[QuantumRegister]`
+
+A list of the quantum registers associated with the circuit.
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+
+
+### slopes
+
+The breakpoints of the piecewise linear function.
+
+The function is linear in the intervals `[point_i, point_{i+1}]` where the last point implicitly is `2**(num_state_qubits + 1)`.
+
+## Methods
+
+### evaluate
+
+
+
+`evaluate(x)`
+
+Classically evaluate the piecewise linear rotation.
+
+**Parameters**
+
+**x** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Value to be evaluated at.
+
+**Returns**
+
+Value of piecewise linear function at x.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.PiecewisePolynomialPauliRotations.md b/docs/api/qiskit/0.46/qiskit.circuit.library.PiecewisePolynomialPauliRotations.md
new file mode 100644
index 00000000000..8899b5cde63
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.PiecewisePolynomialPauliRotations.md
@@ -0,0 +1,310 @@
+---
+title: PiecewisePolynomialPauliRotations
+description: API reference for qiskit.circuit.library.PiecewisePolynomialPauliRotations
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.PiecewisePolynomialPauliRotations
+---
+
+# PiecewisePolynomialPauliRotations
+
+
+
+`qiskit.circuit.library.PiecewisePolynomialPauliRotations(num_state_qubits=None, breakpoints=None, coeffs=None, basis='Y', name='pw_poly')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/arithmetic/piecewise_polynomial_pauli_rotations.py "view source code")
+
+Bases: [`FunctionalPauliRotations`](qiskit.circuit.library.FunctionalPauliRotations "qiskit.circuit.library.arithmetic.functional_pauli_rotations.FunctionalPauliRotations")
+
+Piecewise-polynomially-controlled Pauli rotations.
+
+This class implements a piecewise polynomial (not necessarily continuous) function, $f(x)$, on qubit amplitudes, which is defined through breakpoints and coefficients as follows. Suppose the breakpoints $(x_0, ..., x_J)$ are a subset of $[0, 2^n-1]$, where $n$ is the number of state qubits. Further on, denote the corresponding coefficients by $[a_{j,1},...,a_{j,d}]$, where $d$ is the highest degree among all polynomials.
+
+Then $f(x)$ is defined as:
+
+$$
+f(x) = \begin{cases}
+ 0, x < x_0 \\
+ \sum_{i=0}^{i=d}a_{j,i}/2 x^i, x_j \leq x < x_{j+1}
+ \end{cases}
+$$
+
+where if given the same number of breakpoints as polynomials, we implicitly assume $x_{J+1} = 2^n$.
+
+
+ Note the $1/2$ factor in the coefficients of $f(x)$, this is consistent with Qiskit’s Pauli rotations.
+
+
+**Examples**
+
+```python
+>>> from qiskit import QuantumCircuit
+>>> from qiskit.circuit.library.arithmetic.piecewise_polynomial_pauli_rotations import\
+... PiecewisePolynomialPauliRotations
+>>> qubits, breakpoints, coeffs = (2, [0, 2], [[0, -1.2],[-1, 1, 3]])
+>>> poly_r = PiecewisePolynomialPauliRotations(num_state_qubits=qubits,
+...breakpoints=breakpoints, coeffs=coeffs)
+>>>
+>>> qc = QuantumCircuit(poly_r.num_qubits)
+>>> qc.h(list(range(qubits)));
+>>> qc.append(poly_r.to_instruction(), list(range(qc.num_qubits)));
+>>> qc.draw()
+ ┌───┐┌──────────┐
+q_0: ┤ H ├┤0 ├
+ ├───┤│ │
+q_1: ┤ H ├┤1 ├
+ └───┘│ │
+q_2: ─────┤2 ├
+ │ pw_poly │
+q_3: ─────┤3 ├
+ │ │
+q_4: ─────┤4 ├
+ │ │
+q_5: ─────┤5 ├
+ └──────────┘
+```
+
+**References**
+
+**\[1]: Haener, T., Roetteler, M., & Svore, K. M. (2018).**
+
+Optimizing Quantum Circuits for Arithmetic. [arXiv:1805.12445](http://arxiv.org/abs/1805.12445)
+
+**\[2]: Carrera Vazquez, A., Hiptmair, R., & Woerner, S. (2022).**
+
+Enhancing the Quantum Linear Systems Algorithm using Richardson Extrapolation. [ACM Transactions on Quantum Computing 3, 1, Article 2](https://doi.org/10.1145/3490631)
+
+**Parameters**
+
+* **num\_state\_qubits** (*Optional\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The number of qubits representing the state.
+* **breakpoints** (*Optional\[List\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]]*) – The breakpoints to define the piecewise-linear function. Defaults to `[0]`.
+* **coeffs** (*Optional\[List\[List\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]]]*) – The coefficients of the polynomials for different segments of the
+* **x** (*piecewise-linear function. coeffs\[j]\[i] is the coefficient of the i-th power of*) –
+* **polynomial.** (*for the j-th*) – Defaults to linear: `[[1]]`.
+* **basis** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The type of Pauli rotation (`'X'`, `'Y'`, `'Z'`).
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the circuit.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### basis
+
+The kind of Pauli rotation to be used.
+
+Set the basis to ‘X’, ‘Y’ or ‘Z’ for controlled-X, -Y, or -Z rotations respectively.
+
+**Returns**
+
+The kind of Pauli rotation used in controlled rotation.
+
+
+
+### breakpoints
+
+The breakpoints of the piecewise polynomial function.
+
+The function is polynomial in the intervals `[point_i, point_{i+1}]` where the last point implicitly is `2**(num_state_qubits + 1)`.
+
+**Returns**
+
+The list of breakpoints.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### coeffs
+
+The coefficients of the polynomials.
+
+**Returns**
+
+The polynomial coefficients per interval as nested lists.
+
+
+
+### contains\_zero\_breakpoint
+
+Whether 0 is the first breakpoint.
+
+**Returns**
+
+True, if 0 is the first breakpoint, otherwise False.
+
+
+
+### data
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 250`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### mapped\_coeffs
+
+The coefficients mapped to the internal representation, since we only compare x>=breakpoint.
+
+**Returns**
+
+The mapped coefficients.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancilla\_qubits
+
+The minimum number of ancilla qubits in the circuit.
+
+**Returns**
+
+The minimal number of ancillas required.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### num\_state\_qubits
+
+The number of state qubits representing the state $|x\rangle$.
+
+**Returns**
+
+The number of state qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qregs
+
+`list[QuantumRegister]`
+
+A list of the quantum registers associated with the circuit.
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+## Methods
+
+### evaluate
+
+
+
+`evaluate(x)`
+
+Classically evaluate the piecewise polynomial rotation.
+
+**Parameters**
+
+**x** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Value to be evaluated at.
+
+**Returns**
+
+Value of piecewise polynomial function at x.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.PolynomialPauliRotations.md b/docs/api/qiskit/0.46/qiskit.circuit.library.PolynomialPauliRotations.md
new file mode 100644
index 00000000000..758cda3a6d2
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.PolynomialPauliRotations.md
@@ -0,0 +1,238 @@
+---
+title: PolynomialPauliRotations
+description: API reference for qiskit.circuit.library.PolynomialPauliRotations
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.PolynomialPauliRotations
+---
+
+# PolynomialPauliRotations
+
+
+
+`qiskit.circuit.library.PolynomialPauliRotations(num_state_qubits=None, coeffs=None, basis='Y', name='poly')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/arithmetic/polynomial_pauli_rotations.py "view source code")
+
+Bases: [`FunctionalPauliRotations`](qiskit.circuit.library.FunctionalPauliRotations "qiskit.circuit.library.arithmetic.functional_pauli_rotations.FunctionalPauliRotations")
+
+A circuit implementing polynomial Pauli rotations.
+
+For a polynomial $p(x)$, a basis state $|i\rangle$ and a target qubit $|0\rangle$ this operator acts as:
+
+$$
+|i\rangle |0\rangle \mapsto \cos\left(\frac{p(i)}{2}\right) |i\rangle |0\rangle
++ \sin\left(\frac{p(i)}{2}\right) |i\rangle |1\rangle
+$$
+
+Let n be the number of qubits representing the state, d the degree of p(x) and q\_i the qubits, where q\_0 is the least significant qubit. Then for
+
+$$
+x = \sum_{i=0}^{n-1} 2^i q_i,
+$$
+
+we can write
+
+$$
+p(x) = \sum_{j=0}^{j=d} c_j x^j
+$$
+
+where $c$ are the input coefficients, `coeffs`.
+
+Prepare an approximation to a state with amplitudes specified by a polynomial.
+
+**Parameters**
+
+* **num\_state\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of qubits representing the state.
+* **coeffs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – The coefficients of the polynomial. `coeffs[i]` is the coefficient of the i-th power of x. Defaults to linear: \[0, 1].
+* **basis** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The type of Pauli rotation (‘X’, ‘Y’, ‘Z’).
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the circuit.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### basis
+
+The kind of Pauli rotation to be used.
+
+Set the basis to ‘X’, ‘Y’ or ‘Z’ for controlled-X, -Y, or -Z rotations respectively.
+
+**Returns**
+
+The kind of Pauli rotation used in controlled rotation.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### coeffs
+
+The coefficients of the polynomial.
+
+`coeffs[i]` is the coefficient of the i-th power of the function input $x$, that means that the rotation angles are based on the coefficients value, following the formula
+
+$$
+c_j x^j , j=0, ..., d
+$$
+
+where $d$ is the degree of the polynomial $p(x)$ and $c$ are the coefficients `coeffs`.
+
+**Returns**
+
+The coefficients of the polynomial.
+
+
+
+### data
+
+
+
+### degree
+
+Return the degree of the polynomial, equals to the number of coefficients minus 1.
+
+**Returns**
+
+The degree of the polynomial. If the coefficients have not been set, return 0.
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 253`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancilla\_qubits
+
+The minimum number of ancilla qubits in the circuit.
+
+**Returns**
+
+The minimal number of ancillas required.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### num\_state\_qubits
+
+The number of state qubits representing the state $|x\rangle$.
+
+**Returns**
+
+The number of state qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qregs
+
+`list[QuantumRegister]`
+
+A list of the quantum registers associated with the circuit.
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.QAOAAnsatz.md b/docs/api/qiskit/0.46/qiskit.circuit.library.QAOAAnsatz.md
new file mode 100644
index 00000000000..d25abeacc79
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.QAOAAnsatz.md
@@ -0,0 +1,345 @@
+---
+title: QAOAAnsatz
+description: API reference for qiskit.circuit.library.QAOAAnsatz
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.QAOAAnsatz
+---
+
+# QAOAAnsatz
+
+
+
+`qiskit.circuit.library.QAOAAnsatz(cost_operator=None, reps=1, initial_state=None, mixer_operator=None, name='QAOA', flatten=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/n_local/qaoa_ansatz.py "view source code")
+
+Bases: [`EvolvedOperatorAnsatz`](qiskit.circuit.library.EvolvedOperatorAnsatz "qiskit.circuit.library.evolved_operator_ansatz.EvolvedOperatorAnsatz")
+
+A generalized QAOA quantum circuit with a support of custom initial states and mixers.
+
+**References**
+
+**\[1]: Farhi et al., A Quantum Approximate Optimization Algorithm.**
+
+[arXiv:1411.4028](https://arxiv.org/pdf/1411.4028)
+
+**Parameters**
+
+* **cost\_operator** (*BaseOperator or* [*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")*, optional*) – The operator representing the cost of the optimization problem, denoted as $U(C, \gamma)$ in the original paper. Must be set either in the constructor or via property setter.
+* **reps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The integer parameter p, which determines the depth of the circuit, as specified in the original paper, default is 1.
+* **initial\_state** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*, optional*) – An optional initial state to use. If None is passed then a set of Hadamard gates is applied as an initial state to all qubits.
+* **mixer\_operator** (*BaseOperator or* [*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase") *or*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*, optional*) – An optional custom mixer to use instead of the global X-rotations, denoted as $U(B, \beta)$ in the original paper. Can be an operator or an optionally parameterized quantum circuit.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – A name of the circuit, default ‘qaoa’
+* **flatten** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – Set this to `True` to output a flat circuit instead of nesting it inside multiple layers of gate objects. By default currently the contents of the output circuit will be wrapped in nested objects for cleaner visualization. However, if you’re using this circuit for anything besides visualization its **strongly** recommended to set this flag to `True` to avoid a large performance overhead for parameter binding.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### cost\_operator
+
+Returns an operator representing the cost of the optimization problem.
+
+**Returns**
+
+cost operator.
+
+**Return type**
+
+BaseOperator or [OperatorBase](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")
+
+
+
+### data
+
+
+
+### entanglement
+
+Get the entanglement strategy.
+
+**Returns**
+
+The entanglement strategy, see `get_entangler_map()` for more detail on how the format is interpreted.
+
+
+
+### entanglement\_blocks
+
+The blocks in the entanglement layers.
+
+**Returns**
+
+The blocks in the entanglement layers.
+
+
+
+### evolution
+
+The evolution converter used to compute the evolution.
+
+**Returns**
+
+The evolution converter used to compute the evolution.
+
+**Return type**
+
+[EvolutionBase](qiskit.opflow.evolutions.EvolutionBase "qiskit.opflow.evolutions.EvolutionBase") or [EvolutionSynthesis](qiskit.synthesis.EvolutionSynthesis "qiskit.synthesis.EvolutionSynthesis")
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### flatten
+
+Returns whether the circuit is wrapped in nested gates/instructions or flattened.
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### initial\_state
+
+Returns an optional initial state as a circuit
+
+
+
+### insert\_barriers
+
+If barriers are inserted in between the layers or not.
+
+**Returns**
+
+`True`, if barriers are inserted in between the layers, `False` if not.
+
+
+
+### instances
+
+`= 310`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### mixer\_operator
+
+Returns an optional mixer operator expressed as an operator or a quantum circuit.
+
+**Returns**
+
+mixer operator or circuit.
+
+**Return type**
+
+BaseOperator or [OperatorBase](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase") or [QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), optional
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_layers
+
+Return the number of layers in the n-local circuit.
+
+**Returns**
+
+The number of layers in the circuit.
+
+
+
+### num\_parameters
+
+
+
+### num\_parameters\_settable
+
+The number of total parameters that can be set to distinct values.
+
+This does not change when the parameters are bound or exchanged for same parameters, and therefore is different from `num_parameters` which counts the number of unique [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects currently in the circuit.
+
+**Returns**
+
+The number of parameters originally available in the circuit.
+
+
+ This quantity does not require the circuit to be built yet.
+
+
+
+
+### num\_qubits
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### operators
+
+The operators that are evolved in this circuit.
+
+**Returns**
+
+**The operators to be evolved**
+
+(and circuits) in this ansatz.
+
+**Return type**
+
+List\[Union\[BaseOperator, [OperatorBase](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase"), [QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")]]
+
+
+
+### ordered\_parameters
+
+The parameters used in the underlying circuit.
+
+This includes float values and duplicates.
+
+**Examples**
+
+```python
+>>> # prepare circuit ...
+>>> print(nlocal)
+ ┌───────┐┌──────────┐┌──────────┐┌──────────┐
+q_0: ┤ Ry(1) ├┤ Ry(θ[1]) ├┤ Ry(θ[1]) ├┤ Ry(θ[3]) ├
+ └───────┘└──────────┘└──────────┘└──────────┘
+>>> nlocal.parameters
+{Parameter(θ[1]), Parameter(θ[3])}
+>>> nlocal.ordered_parameters
+[1, Parameter(θ[1]), Parameter(θ[1]), Parameter(θ[3])]
+```
+
+**Returns**
+
+The parameters objects used in the circuit.
+
+
+
+### parameter\_bounds
+
+The parameter bounds for the unbound parameters in the circuit.
+
+**Returns**
+
+A list of pairs indicating the bounds, as (lower, upper). None indicates an unbounded parameter in the corresponding direction. If None is returned, problem is fully unbounded.
+
+
+
+### parameters
+
+
+
+### preferred\_init\_points
+
+Getter of preferred initial points based on the given initial state.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qregs
+
+`list[QuantumRegister]`
+
+A list of the quantum registers associated with the circuit.
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+
+
+### reps
+
+Returns the reps parameter, which determines the depth of the circuit.
+
+
+
+### rotation\_blocks
+
+The blocks in the rotation layers.
+
+**Returns**
+
+The blocks in the rotation layers.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.QFT.md b/docs/api/qiskit/0.46/qiskit.circuit.library.QFT.md
new file mode 100644
index 00000000000..d8e18d99d3c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.QFT.md
@@ -0,0 +1,249 @@
+---
+title: QFT
+description: API reference for qiskit.circuit.library.QFT
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.QFT
+---
+
+# QFT
+
+
+
+`qiskit.circuit.library.QFT(num_qubits=None, approximation_degree=0, do_swaps=True, inverse=False, insert_barriers=False, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/basis_change/qft.py "view source code")
+
+Bases: `BlueprintCircuit`
+
+Quantum Fourier Transform Circuit.
+
+The Quantum Fourier Transform (QFT) on $n$ qubits is the operation
+
+$$
+|j\rangle \mapsto \frac{1}{2^{n/2}} \sum_{k=0}^{2^n - 1} e^{2\pi ijk / 2^n} |k\rangle
+$$
+
+The circuit that implements this transformation can be implemented using Hadamard gates on each qubit, a series of controlled-U1 (or Z, depending on the phase) gates and a layer of Swap gates. The layer of Swap gates can in principle be dropped if the QFT appears at the end of the circuit, since then the re-ordering can be done classically. They can be turned off using the `do_swaps` attribute.
+
+For 4 qubits, the circuit that implements this transformation is:
+
+
+
+The inverse QFT can be obtained by calling the `inverse` method on this class. The respective circuit diagram is:
+
+
+
+One method to reduce circuit depth is to implement the QFT approximately by ignoring controlled-phase rotations where the angle is beneath a threshold. This is discussed in more detail in [https://arxiv.org/abs/quant-ph/9601018](https://arxiv.org/abs/quant-ph/9601018) or [https://arxiv.org/abs/quant-ph/0403071](https://arxiv.org/abs/quant-ph/0403071).
+
+Here, this can be adjusted using the `approximation_degree` attribute: the smallest `approximation_degree` rotation angles are dropped from the QFT. For instance, a QFT on 5 qubits with approximation degree 2 yields (the barriers are dropped in this example):
+
+
+
+Construct a new QFT circuit.
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of qubits on which the QFT acts.
+* **approximation\_degree** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The degree of approximation (0 for no approximation).
+* **do\_swaps** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to include the final swaps in the QFT.
+* **inverse** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, the inverse Fourier transform is constructed.
+* **insert\_barriers** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, barriers are inserted as visualization improvement.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The name of the circuit.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### approximation\_degree
+
+The approximation degree of the QFT.
+
+**Returns**
+
+The currently set approximation degree.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+
+
+### do\_swaps
+
+Whether the final swaps of the QFT are applied or not.
+
+**Returns**
+
+True, if the final swaps are applied, False if not.
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### insert\_barriers
+
+Whether barriers are inserted for better visualization or not.
+
+**Returns**
+
+True, if barriers are inserted, False if not.
+
+
+
+### instances
+
+`= 208`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+
+
+### num\_qubits
+
+The number of qubits in the QFT circuit.
+
+**Returns**
+
+The number of qubits in the circuit.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qregs
+
+`list[QuantumRegister]`
+
+A list of the quantum registers associated with the circuit.
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this circuit.
+
+**Returns**
+
+The inverted circuit.
+
+**Return type**
+
+[*QFT*](#qiskit.circuit.library.QFT "qiskit.circuit.library.basis_change.qft.QFT")
+
+### is\_inverse
+
+
+
+`is_inverse()`
+
+Whether the inverse Fourier transform is implemented.
+
+**Returns**
+
+True, if the inverse Fourier transform is implemented, False otherwise.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.QuadraticForm.md b/docs/api/qiskit/0.46/qiskit.circuit.library.QuadraticForm.md
new file mode 100644
index 00000000000..385b536442b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.QuadraticForm.md
@@ -0,0 +1,272 @@
+---
+title: QuadraticForm
+description: API reference for qiskit.circuit.library.QuadraticForm
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.QuadraticForm
+---
+
+# QuadraticForm
+
+
+
+`qiskit.circuit.library.QuadraticForm(num_result_qubits=None, quadratic=None, linear=None, offset=None, little_endian=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/arithmetic/quadratic_form.py "view source code")
+
+Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+Implements a quadratic form on binary variables encoded in qubit registers.
+
+A quadratic form on binary variables is a quadratic function $Q$ acting on a binary variable of $n$ bits, $x = x_0 ... x_{n-1}$. For an integer matrix $A$, an integer vector $b$ and an integer $c$ the function can be written as
+
+$$
+Q(x) = x^T A x + x^T b + c
+$$
+
+If $A$, $b$ or $c$ contain scalar values, this circuit computes only an approximation of the quadratic form.
+
+Provided with $m$ qubits to encode the value, this circuit computes $Q(x) \mod 2^m$ in \[two’s complement]\([https://stackoverflow.com/questions/1049722/what-is-2s-complement](https://stackoverflow.com/questions/1049722/what-is-2s-complement)) representation.
+
+$$
+|x\rangle_n |0\rangle_m \mapsto |x\rangle_n |(Q(x) + 2^m) \mod 2^m \rangle_m
+$$
+
+Since we use two’s complement e.g. the value of $Q(x) = 3$ requires 2 bits to represent the value and 1 bit for the sign: 3 = ‘011’ where the first 0 indicates a positive value. On the other hand, $Q(x) = -3$ would be -3 = ‘101’, where the first 1 indicates a negative value and 01 is the two’s complement of 3.
+
+If the value of $Q(x)$ is too large to be represented with m qubits, the resulting bitstring is $(Q(x) + 2^m) \mod 2^m)$.
+
+The implementation of this circuit is discussed in \[1], Fig. 6.
+
+**References**
+
+**\[1]: Gilliam et al., Grover Adaptive Search for Constrained Polynomial Binary Optimization.**
+
+[arXiv:1912.04088](https://arxiv.org/pdf/1912.04088.pdf)
+
+**Parameters**
+
+* **num\_result\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of qubits to encode the result. Called $m$ in the class documentation.
+* **quadratic** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*]] | None*) – A matrix containing the quadratic coefficients, $A$.
+* **linear** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*] | None*) – An array containing the linear coefficients, $b$.
+* **offset** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – A constant offset, $c$.
+* **little\_endian** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Encode the result in little endianness.
+
+**Raises**
+
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `linear` and `quadratic` have mismatching sizes.
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `num_result_qubits` is unspecified but cannot be determined because some values of the quadratic form are parameterized.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 322`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+## Methods
+
+### required\_result\_qubits
+
+
+
+`static required_result_qubits(quadratic, linear, offset)`
+
+Get the number of required result qubits.
+
+**Parameters**
+
+* **quadratic** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]]*) – A matrix containing the quadratic coefficients.
+* **linear** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – An array containing the linear coefficients.
+* **offset** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – A constant offset.
+
+**Returns**
+
+The number of qubits needed to represent the value of the quadratic form in twos complement.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.QuantumVolume.md b/docs/api/qiskit/0.46/qiskit.circuit.library.QuantumVolume.md
new file mode 100644
index 00000000000..620a6ab7643
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.QuantumVolume.md
@@ -0,0 +1,234 @@
+---
+title: QuantumVolume
+description: API reference for qiskit.circuit.library.QuantumVolume
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.QuantumVolume
+---
+
+# QuantumVolume
+
+
+
+`qiskit.circuit.library.QuantumVolume(num_qubits, depth=None, seed=None, classical_permutation=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/quantum_volume.py "view source code")
+
+Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+A quantum volume model circuit.
+
+The model circuits are random instances of circuits used to measure the Quantum Volume metric, as introduced in \[1].
+
+The model circuits consist of layers of Haar random elements of SU(4) applied between corresponding pairs of qubits in a random bipartition.
+
+**Reference Circuit:**
+
+
+
+**Expanded Circuit:**
+
+
+
+**References:**
+
+\[1] A. Cross et al. Validating quantum computers using randomized model circuits, Phys. Rev. A 100, 032328 (2019). \[[arXiv:1811.12926](https://arxiv.org/abs/1811.12926)]
+
+Create quantum volume model circuit of size num\_qubits x depth.
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of active qubits in model circuit.
+* **depth** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – layers of SU(4) operations in model circuit.
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*Generator*](https://numpy.org/doc/stable/reference/random/generator.html#numpy.random.Generator "(in NumPy v1.26)") *| None*) – Random number generator or generator seed.
+* **classical\_permutation** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – use classical permutations at every layer, rather than quantum.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 325`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.RC3XGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.RC3XGate.md
new file mode 100644
index 00000000000..d4617ce80b3
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.RC3XGate.md
@@ -0,0 +1,123 @@
+---
+title: RC3XGate
+description: API reference for qiskit.circuit.library.RC3XGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.RC3XGate
+---
+
+# RC3XGate
+
+
+
+`qiskit.circuit.library.RC3XGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/x.py "view source code")
+
+Bases: [`SingletonGate`](circuit_singleton#qiskit.circuit.singleton.SingletonGate "qiskit.circuit.singleton.SingletonGate")
+
+The simplified 3-controlled Toffoli gate.
+
+The simplified Toffoli gate implements the Toffoli gate up to relative phases. Note, that the simplified Toffoli is not equivalent to the Toffoli. But can be used in places where the Toffoli gate is uncomputed again.
+
+This concrete implementation is from [https://arxiv.org/abs/1508.03273](https://arxiv.org/abs/1508.03273), the complete circuit of Fig. 4.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`rcccx()`](qiskit.circuit.QuantumCircuit#rcccx "qiskit.circuit.QuantumCircuit.rcccx") method.
+
+Create a new RC3X gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.RC3XGate.base_class "qiskit.circuit.library.RC3XGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.RCCXGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.RCCXGate.md
new file mode 100644
index 00000000000..3c9d4e88933
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.RCCXGate.md
@@ -0,0 +1,123 @@
+---
+title: RCCXGate
+description: API reference for qiskit.circuit.library.RCCXGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.RCCXGate
+---
+
+# RCCXGate
+
+
+
+`qiskit.circuit.library.RCCXGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/x.py "view source code")
+
+Bases: [`SingletonGate`](circuit_singleton#qiskit.circuit.singleton.SingletonGate "qiskit.circuit.singleton.SingletonGate")
+
+The simplified Toffoli gate, also referred to as Margolus gate.
+
+The simplified Toffoli gate implements the Toffoli gate up to relative phases. This implementation requires three CX gates which is the minimal amount possible, as shown in [https://arxiv.org/abs/quant-ph/0312225](https://arxiv.org/abs/quant-ph/0312225). Note, that the simplified Toffoli is not equivalent to the Toffoli. But can be used in places where the Toffoli gate is uncomputed again.
+
+This concrete implementation is from [https://arxiv.org/abs/1508.03273](https://arxiv.org/abs/1508.03273), the dashed box of Fig. 3.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`rccx()`](qiskit.circuit.QuantumCircuit#rccx "qiskit.circuit.QuantumCircuit.rccx") method.
+
+Create a new simplified CCX gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.RCCXGate.base_class "qiskit.circuit.library.RCCXGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.RGQFTMultiplier.md b/docs/api/qiskit/0.46/qiskit.circuit.library.RGQFTMultiplier.md
new file mode 100644
index 00000000000..831bf1e42b8
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.RGQFTMultiplier.md
@@ -0,0 +1,256 @@
+---
+title: RGQFTMultiplier
+description: API reference for qiskit.circuit.library.RGQFTMultiplier
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.RGQFTMultiplier
+---
+
+# RGQFTMultiplier
+
+
+
+`qiskit.circuit.library.RGQFTMultiplier(num_state_qubits, num_result_qubits=None, name='RGQFTMultiplier')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/arithmetic/multipliers/rg_qft_multiplier.py "view source code")
+
+Bases: `Multiplier`
+
+A QFT multiplication circuit to store product of two input registers out-of-place.
+
+Multiplication in this circuit is implemented using the procedure of Fig. 3 in \[1], where weighted sum rotations are implemented as given in Fig. 5 in \[1]. QFT is used on the output register and is followed by rotations controlled by input registers. The rotations transform the state into the product of two input registers in QFT base, which is reverted from QFT base using inverse QFT. As an example, a circuit that performs a modular QFT multiplication on two 2-qubit sized input registers with an output register of 2 qubits, is as follows:
+
+```python
+ a_0: ────────────────────────────────────────■───────■──────■──────■────────────────
+ │ │ │ │
+ a_1: ─────────■───────■───────■───────■──────┼───────┼──────┼──────┼────────────────
+ │ │ │ │ │ │ │ │
+ b_0: ─────────┼───────┼───────■───────■──────┼───────┼──────■──────■────────────────
+ │ │ │ │ │ │ │ │
+ b_1: ─────────■───────■───────┼───────┼──────■───────■──────┼──────┼────────────────
+ ┌──────┐ │P(4π) │ │P(2π) │ │P(2π) │ │P(π) │ ┌───────┐
+out_0: ┤0 ├─■───────┼───────■───────┼──────■───────┼──────■──────┼───────┤0 ├
+ │ qft │ │P(2π) │P(π) │P(π) │P(π/2) │ iqft │
+out_1: ┤1 ├─────────■───────────────■──────────────■─────────────■───────┤1 ├
+ └──────┘ └───────┘
+```
+
+**References:**
+
+\[1] Ruiz-Perez et al., Quantum arithmetic with the Quantum Fourier Transform, 2017. [arXiv:1411.5949](https://arxiv.org/pdf/1411.5949.pdf)
+
+**Parameters**
+
+* **num\_state\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of qubits in either input register for state $|a\rangle$ or $|b\rangle$. The two input registers must have the same number of qubits.
+* **num\_result\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of result qubits to limit the output to. If number of result qubits is $n$, multiplication modulo $2^n$ is performed to limit the output to the specified number of qubits. Default value is `2 * num_state_qubits` to represent any possible result from the multiplication of the two inputs.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the circuit object.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 456`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### num\_result\_qubits
+
+The number of result qubits to limit the output to.
+
+**Returns**
+
+The number of result qubits.
+
+
+
+### num\_state\_qubits
+
+The number of state qubits, i.e. the number of bits in each input register.
+
+**Returns**
+
+The number of state qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.RGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.RGate.md
new file mode 100644
index 00000000000..d96f8b9f6fe
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.RGate.md
@@ -0,0 +1,159 @@
+---
+title: RGate
+description: API reference for qiskit.circuit.library.RGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.RGate
+---
+
+# RGate
+
+
+
+`qiskit.circuit.library.RGate(theta, phi, label=None, *, duration=None, unit='dt')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/r.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+Rotation θ around the cos(φ)x + sin(φ)y axis.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`r()`](qiskit.circuit.QuantumCircuit#r "qiskit.circuit.QuantumCircuit.r") method.
+
+**Circuit symbol:**
+
+```python
+ ┌──────┐
+q_0: ┤ R(ϴ) ├
+ └──────┘
+```
+
+**Matrix Representation:**
+
+$$
+\newcommand{\rotationangle}{\frac{\theta}{2}}
+
+R(\theta, \phi) = e^{-i \rotationangle \left(\cos{\phi} x + \sin{\phi} y\right)} =
+ \begin{pmatrix}
+ \cos\left(\rotationangle\right) & -i e^{-i \phi} \sin\left(\rotationangle\right) \\
+ -i e^{i \phi} \sin\left(\rotationangle\right) & \cos\left(\rotationangle\right)
+ \end{pmatrix}
+$$
+
+Create new r single-qubit gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.RGate.base_class "qiskit.circuit.library.RGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this gate.
+
+r(θ, φ)^dagger = r(-θ, φ)
+
+### power
+
+
+
+`power(exponent)`
+
+Raise gate to a power.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.RVGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.RVGate.md
new file mode 100644
index 00000000000..15a56da24df
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.RVGate.md
@@ -0,0 +1,166 @@
+---
+title: RVGate
+description: API reference for qiskit.circuit.library.RVGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.RVGate
+---
+
+# RVGate
+
+
+
+`qiskit.circuit.library.RVGate(v_x, v_y, v_z, basis='U')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/generalized_gates/rv.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+Rotation around arbitrary rotation axis $v$ where $|v|$ is angle of rotation in radians.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`rv()`](qiskit.circuit.QuantumCircuit#rv "qiskit.circuit.QuantumCircuit.rv") method.
+
+**Circuit symbol:**
+
+```python
+ ┌─────────────────┐
+q_0: ┤ RV(v_x,v_y,v_z) ├
+ └─────────────────┘
+```
+
+**Matrix Representation:**
+
+$$
+\newcommand{\rotationangle}{|\vec{v}|}
+\newcommand{\sinc}{\text{sinc}}
+ R(\vec{v}) = e^{-i \vec{v}\cdot\vec{\sigma}} =
+ \begin{pmatrix}
+ \cos\left(\rotationangle\right) -i v_z \sinc\left(\rotationangle\right)
+ & -(i v_x + v_y) \sinc\left(\rotationangle\right) \\
+ -(i v_x - v_y) \sinc\left(\rotationangle\right)
+ & \cos\left(\rotationangle\right) + i v_z \sinc\left(\rotationangle\right)
+ \end{pmatrix}
+$$
+
+Create new rv single-qubit gate.
+
+**Parameters**
+
+* **v\_x** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – x-component
+* **v\_y** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – y-component
+* **v\_z** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – z-component
+* **basis** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*, optional*) – basis (see [`OneQubitEulerDecomposer`](qiskit.synthesis.OneQubitEulerDecomposer "qiskit.synthesis.one_qubit.one_qubit_decompose.OneQubitEulerDecomposer"))
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.RVGate.base_class "qiskit.circuit.library.RVGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this gate.
+
+### to\_matrix
+
+
+
+`to_matrix()`
+
+Return a numpy.array for the R(v) gate.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.RXGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.RXGate.md
new file mode 100644
index 00000000000..65b3ef7a476
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.RXGate.md
@@ -0,0 +1,181 @@
+---
+title: RXGate
+description: API reference for qiskit.circuit.library.RXGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.RXGate
+---
+
+# RXGate
+
+
+
+`qiskit.circuit.library.RXGate(theta, label=None, *, duration=None, unit='dt')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/rx.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+Single-qubit rotation about the X axis.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`rx()`](qiskit.circuit.QuantumCircuit#rx "qiskit.circuit.QuantumCircuit.rx") method.
+
+**Circuit symbol:**
+
+```python
+ ┌───────┐
+q_0: ┤ Rx(ϴ) ├
+ └───────┘
+```
+
+**Matrix Representation:**
+
+$$
+\newcommand{\rotationangle}{\frac{\theta}{2}}
+
+RX(\theta) = \exp\left(-i \rotationangle X\right) =
+ \begin{pmatrix}
+ \cos\left(\rotationangle\right) & -i\sin\left(\rotationangle\right) \\
+ -i\sin\left(\rotationangle\right) & \cos\left(\rotationangle\right)
+ \end{pmatrix}
+$$
+
+Create new RX gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.RXGate.base_class "qiskit.circuit.library.RXGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Return a (multi-)controlled-RX gate.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of control qubits.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for the gate \[Default: None]
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – control state expressed as integer, string (e.g. ‘110’), or None. If None, use all 1s.
+
+**Returns**
+
+controlled version of this gate.
+
+**Return type**
+
+[ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted RX gate.
+
+$RX(\lambda)^{\dagger} = RX(-\lambda)$
+
+### power
+
+
+
+`power(exponent)`
+
+Raise gate to a power.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.RXXGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.RXXGate.md
new file mode 100644
index 00000000000..bcf4ffee144
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.RXXGate.md
@@ -0,0 +1,183 @@
+---
+title: RXXGate
+description: API reference for qiskit.circuit.library.RXXGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.RXXGate
+---
+
+# RXXGate
+
+
+
+`qiskit.circuit.library.RXXGate(theta, label=None, *, duration=None, unit='dt')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/rxx.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+A parametric 2-qubit $X \otimes X$ interaction (rotation about XX).
+
+This gate is symmetric, and is maximally entangling at $\theta = \pi/2$.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`rxx()`](qiskit.circuit.QuantumCircuit#rxx "qiskit.circuit.QuantumCircuit.rxx") method.
+
+**Circuit Symbol:**
+
+```python
+ ┌─────────┐
+q_0: ┤1 ├
+ │ Rxx(ϴ) │
+q_1: ┤0 ├
+ └─────────┘
+```
+
+**Matrix Representation:**
+
+$$
+\newcommand{\rotationangle}{\frac{\theta}{2}}
+
+R_{XX}(\theta) = \exp\left(-i \rotationangle X{\otimes}X\right) =
+ \begin{pmatrix}
+ \cos\left(\rotationangle\right) & 0 & 0 & -i\sin\left(\rotationangle\right) \\
+ 0 & \cos\left(\rotationangle\right) & -i\sin\left(\rotationangle\right) & 0 \\
+ 0 & -i\sin\left(\rotationangle\right) & \cos\left(\rotationangle\right) & 0 \\
+ -i\sin\left(\rotationangle\right) & 0 & 0 & \cos\left(\rotationangle\right)
+ \end{pmatrix}
+$$
+
+**Examples:**
+
+> $$
+> R_{XX}(\theta = 0) = I
+> $$
+>
+> $$
+> R_{XX}(\theta = \pi) = i X \otimes X
+> $$
+>
+> $$
+> R_{XX}\left(\theta = \frac{\pi}{2}\right) = \frac{1}{\sqrt{2}}
+> \begin{pmatrix}
+> 1 & 0 & 0 & -i \\
+> 0 & 1 & -i & 0 \\
+> 0 & -i & 1 & 0 \\
+> -i & 0 & 0 & 1
+> \end{pmatrix}
+> $$
+
+Create new RXX gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.RXXGate.base_class "qiskit.circuit.library.RXXGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverse RXX gate (i.e. with the negative rotation angle).
+
+### power
+
+
+
+`power(exponent)`
+
+Raise gate to a power.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.RYGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.RYGate.md
new file mode 100644
index 00000000000..3ae272d4b0a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.RYGate.md
@@ -0,0 +1,181 @@
+---
+title: RYGate
+description: API reference for qiskit.circuit.library.RYGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.RYGate
+---
+
+# RYGate
+
+
+
+`qiskit.circuit.library.RYGate(theta, label=None, *, duration=None, unit='dt')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/ry.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+Single-qubit rotation about the Y axis.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`ry()`](qiskit.circuit.QuantumCircuit#ry "qiskit.circuit.QuantumCircuit.ry") method.
+
+**Circuit symbol:**
+
+```python
+ ┌───────┐
+q_0: ┤ Ry(ϴ) ├
+ └───────┘
+```
+
+**Matrix Representation:**
+
+$$
+\newcommand{\rotationangle}{\frac{\theta}{2}}
+
+RY(\theta) = \exp\left(-i \rotationangle Y\right) =
+ \begin{pmatrix}
+ \cos\left(\rotationangle\right) & -\sin\left(\rotationangle\right) \\
+ \sin\left(\rotationangle\right) & \cos\left(\rotationangle\right)
+ \end{pmatrix}
+$$
+
+Create new RY gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.RYGate.base_class "qiskit.circuit.library.RYGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Return a (multi-)controlled-RY gate.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of control qubits.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for the gate \[Default: None]
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – control state expressed as integer, string (e.g. ‘110’), or None. If None, use all 1s.
+
+**Returns**
+
+controlled version of this gate.
+
+**Return type**
+
+[ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted RY gate.
+
+$RY(\lambda)^{\dagger} = RY(-\lambda)$
+
+### power
+
+
+
+`power(exponent)`
+
+Raise gate to a power.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.RYYGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.RYYGate.md
new file mode 100644
index 00000000000..6fc935d7584
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.RYYGate.md
@@ -0,0 +1,183 @@
+---
+title: RYYGate
+description: API reference for qiskit.circuit.library.RYYGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.RYYGate
+---
+
+# RYYGate
+
+
+
+`qiskit.circuit.library.RYYGate(theta, label=None, *, duration=None, unit='dt')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/ryy.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+A parametric 2-qubit $Y \otimes Y$ interaction (rotation about YY).
+
+This gate is symmetric, and is maximally entangling at $\theta = \pi/2$.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`ryy()`](qiskit.circuit.QuantumCircuit#ryy "qiskit.circuit.QuantumCircuit.ryy") method.
+
+**Circuit Symbol:**
+
+```python
+ ┌─────────┐
+q_0: ┤1 ├
+ │ Ryy(ϴ) │
+q_1: ┤0 ├
+ └─────────┘
+```
+
+**Matrix Representation:**
+
+$$
+\newcommand{\rotationangle}{\frac{\theta}{2}}
+
+R_{YY}(\theta) = \exp\left(-i \rotationangle Y{\otimes}Y\right) =
+ \begin{pmatrix}
+ \cos\left(\rotationangle\right) & 0 & 0 & i\sin\left(\rotationangle\right) \\
+ 0 & \cos\left(\rotationangle\right) & -i\sin\left(\rotationangle\right) & 0 \\
+ 0 & -i\sin\left(\rotationangle\right) & \cos\left(\rotationangle\right) & 0 \\
+ i\sin\left(\rotationangle\right) & 0 & 0 & \cos\left(\rotationangle\right)
+ \end{pmatrix}
+$$
+
+**Examples:**
+
+> $$
+> R_{YY}(\theta = 0) = I
+> $$
+>
+> $$
+> R_{YY}(\theta = \pi) = i Y \otimes Y
+> $$
+>
+> $$
+> R_{YY}\left(\theta = \frac{\pi}{2}\right) = \frac{1}{\sqrt{2}}
+> \begin{pmatrix}
+> 1 & 0 & 0 & i \\
+> 0 & 1 & -i & 0 \\
+> 0 & -i & 1 & 0 \\
+> i & 0 & 0 & 1
+> \end{pmatrix}
+> $$
+
+Create new RYY gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.RYYGate.base_class "qiskit.circuit.library.RYYGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverse RYY gate (i.e. with the negative rotation angle).
+
+### power
+
+
+
+`power(exponent)`
+
+Raise gate to a power.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.RZGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.RZGate.md
new file mode 100644
index 00000000000..715fbfb6b2f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.RZGate.md
@@ -0,0 +1,191 @@
+---
+title: RZGate
+description: API reference for qiskit.circuit.library.RZGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.RZGate
+---
+
+# RZGate
+
+
+
+`qiskit.circuit.library.RZGate(phi, label=None, *, duration=None, unit='dt')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/rz.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+Single-qubit rotation about the Z axis.
+
+This is a diagonal gate. It can be implemented virtually in hardware via framechanges (i.e. at zero error and duration).
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`rz()`](qiskit.circuit.QuantumCircuit#rz "qiskit.circuit.QuantumCircuit.rz") method.
+
+**Circuit symbol:**
+
+```python
+ ┌───────┐
+q_0: ┤ Rz(λ) ├
+ └───────┘
+```
+
+**Matrix Representation:**
+
+$$
+RZ(\lambda) = \exp\left(-i\frac{\lambda}{2}Z\right) =
+ \begin{pmatrix}
+ e^{-i\frac{\lambda}{2}} & 0 \\
+ 0 & e^{i\frac{\lambda}{2}}
+ \end{pmatrix}
+$$
+
+
+ `U1Gate` This gate is equivalent to U1 up to a phase factor.
+
+ > $$
+ > U1(\lambda) = e^{i{\lambda}/2}RZ(\lambda)
+ > $$
+
+ Reference for virtual Z gate implementation: [1612.00858](https://arxiv.org/abs/1612.00858)
+
+
+Create new RZ gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.RZGate.base_class "qiskit.circuit.library.RZGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Return a (multi-)controlled-RZ gate.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of control qubits.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for the gate \[Default: None]
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – control state expressed as integer, string (e.g. ‘110’), or None. If None, use all 1s.
+
+**Returns**
+
+controlled version of this gate.
+
+**Return type**
+
+[ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted RZ gate
+
+$RZ(\lambda)^{\dagger} = RZ(-\lambda)$
+
+### power
+
+
+
+`power(exponent)`
+
+Raise gate to a power.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.RZXGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.RZXGate.md
new file mode 100644
index 00000000000..06caff0f53f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.RZXGate.md
@@ -0,0 +1,223 @@
+---
+title: RZXGate
+description: API reference for qiskit.circuit.library.RZXGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.RZXGate
+---
+
+# RZXGate
+
+
+
+`qiskit.circuit.library.RZXGate(theta, label=None, *, duration=None, unit='dt')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/rzx.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+A parametric 2-qubit $Z \otimes X$ interaction (rotation about ZX).
+
+This gate is maximally entangling at $\theta = \pi/2$.
+
+The cross-resonance gate (CR) for superconducting qubits implements a ZX interaction (however other terms are also present in an experiment).
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`rzx()`](qiskit.circuit.QuantumCircuit#rzx "qiskit.circuit.QuantumCircuit.rzx") method.
+
+**Circuit Symbol:**
+
+```python
+ ┌─────────┐
+q_0: ┤0 ├
+ │ Rzx(θ) │
+q_1: ┤1 ├
+ └─────────┘
+```
+
+**Matrix Representation:**
+
+$$
+\newcommand{\rotationangle}{\frac{\theta}{2}}
+
+R_{ZX}(\theta)\ q_0, q_1 = \exp\left(-i \frac{\theta}{2} X{\otimes}Z\right) =
+ \begin{pmatrix}
+ \cos\left(\rotationangle\right) & 0 & -i\sin\left(\rotationangle\right) & 0 \\
+ 0 & \cos\left(\rotationangle\right) & 0 & i\sin\left(\rotationangle\right) \\
+ -i\sin\left(\rotationangle\right) & 0 & \cos\left(\rotationangle\right) & 0 \\
+ 0 & i\sin\left(\rotationangle\right) & 0 & \cos\left(\rotationangle\right)
+ \end{pmatrix}
+$$
+
+
+ In Qiskit’s convention, higher qubit indices are more significant (little endian convention). In the above example we apply the gate on (q\_0, q\_1) which results in the $X \otimes Z$ tensor order. Instead, if we apply it on (q\_1, q\_0), the matrix will be $Z \otimes X$:
+
+ ```python
+ ┌─────────┐
+ q_0: ┤1 ├
+ │ Rzx(θ) │
+ q_1: ┤0 ├
+ └─────────┘
+ ```
+
+ $$
+ \newcommand{\rotationangle}{\frac{\theta}{2}}
+
+ R_{ZX}(\theta)\ q_1, q_0 = exp(-i \frac{\theta}{2} Z{\otimes}X) =
+ \begin{pmatrix}
+ \cos(\rotationangle) & -i\sin(\rotationangle) & 0 & 0 \\
+ -i\sin(\rotationangle) & \cos(\rotationangle) & 0 & 0 \\
+ 0 & 0 & \cos(\rotationangle) & i\sin(\rotationangle) \\
+ 0 & 0 & i\sin(\rotationangle) & \cos(\rotationangle)
+ \end{pmatrix}
+ $$
+
+ This is a direct sum of RX rotations, so this gate is equivalent to a uniformly controlled (multiplexed) RX gate:
+
+ $$
+ R_{ZX}(\theta)\ q_1, q_0 =
+ \begin{pmatrix}
+ RX(\theta) & 0 \\
+ 0 & RX(-\theta)
+ \end{pmatrix}
+ $$
+
+
+**Examples:**
+
+> $$
+> R_{ZX}(\theta = 0) = I
+> $$
+>
+> $$
+> R_{ZX}(\theta = 2\pi) = -I
+> $$
+>
+> $$
+> R_{ZX}(\theta = \pi) = -i Z \otimes X
+> $$
+>
+> $$
+> RZX(\theta = \frac{\pi}{2}) = \frac{1}{\sqrt{2}}
+> \begin{pmatrix}
+> 1 & 0 & -i & 0 \\
+> 0 & 1 & 0 & i \\
+> -i & 0 & 1 & 0 \\
+> 0 & i & 0 & 1
+> \end{pmatrix}
+> $$
+
+Create new RZX gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.RZXGate.base_class "qiskit.circuit.library.RZXGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverse RZX gate (i.e. with the negative rotation angle).
+
+### power
+
+
+
+`power(exponent)`
+
+Raise gate to a power.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.RZZGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.RZZGate.md
new file mode 100644
index 00000000000..793ed5c02b1
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.RZZGate.md
@@ -0,0 +1,195 @@
+---
+title: RZZGate
+description: API reference for qiskit.circuit.library.RZZGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.RZZGate
+---
+
+# RZZGate
+
+
+
+`qiskit.circuit.library.RZZGate(theta, label=None, *, duration=None, unit='dt')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/rzz.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+A parametric 2-qubit $Z \otimes Z$ interaction (rotation about ZZ).
+
+This gate is symmetric, and is maximally entangling at $\theta = \pi/2$.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`rzz()`](qiskit.circuit.QuantumCircuit#rzz "qiskit.circuit.QuantumCircuit.rzz") method.
+
+**Circuit Symbol:**
+
+```python
+q_0: ───■────
+ │zz(θ)
+q_1: ───■────
+```
+
+**Matrix Representation:**
+
+$$
+\newcommand{\rotationangle}{\frac{\theta}{2}}
+
+R_{ZZ}(\theta) = \exp\left(-i \rotationangle Z{\otimes}Z\right) =
+ \begin{pmatrix}
+ e^{-i \rotationangle} & 0 & 0 & 0 \\
+ 0 & e^{i \rotationangle} & 0 & 0 \\
+ 0 & 0 & e^{i \rotationangle} & 0 \\
+ 0 & 0 & 0 & e^{-i \rotationangle}
+ \end{pmatrix}
+$$
+
+This is a direct sum of RZ rotations, so this gate is equivalent to a uniformly controlled (multiplexed) RZ gate:
+
+$$
+R_{ZZ}(\theta) =
+ \begin{pmatrix}
+ RZ(\theta) & 0 \\
+ 0 & RZ(-\theta)
+ \end{pmatrix}
+$$
+
+**Examples:**
+
+> $$
+> R_{ZZ}(\theta = 0) = I
+> $$
+>
+> $$
+> R_{ZZ}(\theta = 2\pi) = -I
+> $$
+>
+> $$
+> R_{ZZ}(\theta = \pi) = - Z \otimes Z
+> $$
+>
+> $$
+> R_{ZZ}\left(\theta = \frac{\pi}{2}\right) = \frac{1}{\sqrt{2}}
+> \begin{pmatrix}
+> 1-i & 0 & 0 & 0 \\
+> 0 & 1+i & 0 & 0 \\
+> 0 & 0 & 1+i & 0 \\
+> 0 & 0 & 0 & 1-i
+> \end{pmatrix}
+> $$
+
+Create new RZZ gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.RZZGate.base_class "qiskit.circuit.library.RZZGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverse RZZ gate (i.e. with the negative rotation angle).
+
+### power
+
+
+
+`power(exponent)`
+
+Raise gate to a power.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.RealAmplitudes.md b/docs/api/qiskit/0.46/qiskit.circuit.library.RealAmplitudes.md
new file mode 100644
index 00000000000..d30a05b728c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.RealAmplitudes.md
@@ -0,0 +1,389 @@
+---
+title: RealAmplitudes
+description: API reference for qiskit.circuit.library.RealAmplitudes
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.RealAmplitudes
+---
+
+# RealAmplitudes
+
+
+
+`qiskit.circuit.library.RealAmplitudes(num_qubits=None, entanglement='reverse_linear', reps=3, skip_unentangled_qubits=False, skip_final_rotation_layer=False, parameter_prefix='θ', insert_barriers=False, initial_state=None, name='RealAmplitudes', flatten=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/n_local/real_amplitudes.py "view source code")
+
+Bases: [`TwoLocal`](qiskit.circuit.library.TwoLocal "qiskit.circuit.library.n_local.two_local.TwoLocal")
+
+The real-amplitudes 2-local circuit.
+
+The `RealAmplitudes` circuit is a heuristic trial wave function used as Ansatz in chemistry applications or classification circuits in machine learning. The circuit consists of alternating layers of $Y$ rotations and $CX$ entanglements. The entanglement pattern can be user-defined or selected from a predefined set. It is called `RealAmplitudes` since the prepared quantum states will only have real amplitudes, the complex part is always 0.
+
+For example a `RealAmplitudes` circuit with 2 repetitions on 3 qubits with `'reverse_linear'` entanglement is
+
+```python
+┌──────────┐ ░ ░ ┌──────────┐ ░ ░ ┌──────────┐
+┤ Ry(θ[0]) ├─░────────■───░─┤ Ry(θ[3]) ├─░────────■───░─┤ Ry(θ[6]) ├
+├──────────┤ ░ ┌─┴─┐ ░ ├──────────┤ ░ ┌─┴─┐ ░ ├──────────┤
+┤ Ry(θ[1]) ├─░───■──┤ X ├─░─┤ Ry(θ[4]) ├─░───■──┤ X ├─░─┤ Ry(θ[7]) ├
+├──────────┤ ░ ┌─┴─┐└───┘ ░ ├──────────┤ ░ ┌─┴─┐└───┘ ░ ├──────────┤
+┤ Ry(θ[2]) ├─░─┤ X ├──────░─┤ Ry(θ[5]) ├─░─┤ X ├──────░─┤ Ry(θ[8]) ├
+└──────────┘ ░ └───┘ ░ └──────────┘ ░ └───┘ ░ └──────────┘
+```
+
+The entanglement can be set using the `entanglement` keyword as string or a list of index-pairs. See the documentation of [`TwoLocal`](qiskit.circuit.library.TwoLocal "qiskit.circuit.library.TwoLocal") and `NLocal` for more detail. Additional options that can be set include the number of repetitions, skipping rotation gates on qubits that are not entangled, leaving out the final rotation layer and inserting barriers in between the rotation and entanglement layers.
+
+If some qubits are not entangled with other qubits it makes sense to not apply rotation gates on these qubits, since a sequence of $Y$ rotations can be reduced to a single $Y$ rotation with summed rotation angles.
+
+**Examples**
+
+```python
+>>> ansatz = RealAmplitudes(3, reps=2) # create the circuit on 3 qubits
+>>> print(ansatz)
+ ┌──────────┐ ┌──────────┐ ┌──────────┐
+q_0: ┤ Ry(θ[0]) ├──────────■──────┤ Ry(θ[3]) ├──────────■──────┤ Ry(θ[6]) ├
+ ├──────────┤ ┌─┴─┐ ├──────────┤ ┌─┴─┐ ├──────────┤
+q_1: ┤ Ry(θ[1]) ├──■─────┤ X ├────┤ Ry(θ[4]) ├──■─────┤ X ├────┤ Ry(θ[7]) ├
+ ├──────────┤┌─┴─┐┌──┴───┴───┐└──────────┘┌─┴─┐┌──┴───┴───┐└──────────┘
+q_2: ┤ Ry(θ[2]) ├┤ X ├┤ Ry(θ[5]) ├────────────┤ X ├┤ Ry(θ[8]) ├────────────
+ └──────────┘└───┘└──────────┘ └───┘└──────────┘
+```
+
+```python
+>>> ansatz = RealAmplitudes(3, entanglement='full', reps=2) # it is the same unitary as above
+>>> print(ansatz)
+ ┌──────────┐ ┌──────────┐ ┌──────────┐
+q_0: ┤ RY(θ[0]) ├──■────■──┤ RY(θ[3]) ├──────────────■────■──┤ RY(θ[6]) ├────────────
+ ├──────────┤┌─┴─┐ │ └──────────┘┌──────────┐┌─┴─┐ │ └──────────┘┌──────────┐
+q_1: ┤ RY(θ[1]) ├┤ X ├──┼───────■──────┤ RY(θ[4]) ├┤ X ├──┼───────■──────┤ RY(θ[7]) ├
+ ├──────────┤└───┘┌─┴─┐ ┌─┴─┐ ├──────────┤└───┘┌─┴─┐ ┌─┴─┐ ├──────────┤
+q_2: ┤ RY(θ[2]) ├─────┤ X ├───┤ X ├────┤ RY(θ[5]) ├─────┤ X ├───┤ X ├────┤ RY(θ[8]) ├
+ └──────────┘ └───┘ └───┘ └──────────┘ └───┘ └───┘ └──────────┘
+```
+
+```python
+>>> ansatz = RealAmplitudes(3, entanglement='linear', reps=2, insert_barriers=True)
+>>> qc = QuantumCircuit(3) # create a circuit and append the RY variational form
+>>> qc.compose(ansatz, inplace=True)
+>>> qc.draw()
+ ┌──────────┐ ░ ░ ┌──────────┐ ░ ░ ┌──────────┐
+q_0: ┤ RY(θ[0]) ├─░───■────────░─┤ RY(θ[3]) ├─░───■────────░─┤ RY(θ[6]) ├
+ ├──────────┤ ░ ┌─┴─┐ ░ ├──────────┤ ░ ┌─┴─┐ ░ ├──────────┤
+q_1: ┤ RY(θ[1]) ├─░─┤ X ├──■───░─┤ RY(θ[4]) ├─░─┤ X ├──■───░─┤ RY(θ[7]) ├
+ ├──────────┤ ░ └───┘┌─┴─┐ ░ ├──────────┤ ░ └───┘┌─┴─┐ ░ ├──────────┤
+q_2: ┤ RY(θ[2]) ├─░──────┤ X ├─░─┤ RY(θ[5]) ├─░──────┤ X ├─░─┤ RY(θ[8]) ├
+ └──────────┘ ░ └───┘ ░ └──────────┘ ░ └───┘ ░ └──────────┘
+```
+
+```python
+>>> ansatz = RealAmplitudes(4, reps=1, entanglement='circular', insert_barriers=True)
+>>> print(ansatz)
+ ┌──────────┐ ░ ┌───┐ ░ ┌──────────┐
+q_0: ┤ RY(θ[0]) ├─░─┤ X ├──■─────────────░─┤ RY(θ[4]) ├
+ ├──────────┤ ░ └─┬─┘┌─┴─┐ ░ ├──────────┤
+q_1: ┤ RY(θ[1]) ├─░───┼──┤ X ├──■────────░─┤ RY(θ[5]) ├
+ ├──────────┤ ░ │ └───┘┌─┴─┐ ░ ├──────────┤
+q_2: ┤ RY(θ[2]) ├─░───┼───────┤ X ├──■───░─┤ RY(θ[6]) ├
+ ├──────────┤ ░ │ └───┘┌─┴─┐ ░ ├──────────┤
+q_3: ┤ RY(θ[3]) ├─░───■────────────┤ X ├─░─┤ RY(θ[7]) ├
+ └──────────┘ ░ └───┘ ░ └──────────┘
+```
+
+```python
+>>> ansatz = RealAmplitudes(4, reps=2, entanglement=[[0,3], [0,2]],
+... skip_unentangled_qubits=True)
+>>> print(ansatz)
+ ┌──────────┐ ┌──────────┐ ┌──────────┐
+q_0: ┤ RY(θ[0]) ├──■───────■──────┤ RY(θ[3]) ├──■───────■──────┤ RY(θ[6]) ├
+ └──────────┘ │ │ └──────────┘ │ │ └──────────┘
+q_1: ──────────────┼───────┼────────────────────┼───────┼──────────────────
+ ┌──────────┐ │ ┌─┴─┐ ┌──────────┐ │ ┌─┴─┐ ┌──────────┐
+q_2: ┤ RY(θ[1]) ├──┼─────┤ X ├────┤ RY(θ[4]) ├──┼─────┤ X ├────┤ RY(θ[7]) ├
+ ├──────────┤┌─┴─┐┌──┴───┴───┐└──────────┘┌─┴─┐┌──┴───┴───┐└──────────┘
+q_3: ┤ RY(θ[2]) ├┤ X ├┤ RY(θ[5]) ├────────────┤ X ├┤ RY(θ[8]) ├────────────
+ └──────────┘└───┘└──────────┘ └───┘└──────────┘
+```
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of qubits of the RealAmplitudes circuit.
+* **reps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Specifies how often the structure of a rotation layer followed by an entanglement layer is repeated.
+* **entanglement** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]] | Callable\[\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*],* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]]*) – Specifies the entanglement structure. Can be a string (‘full’, ‘linear’ ‘reverse\_linear, ‘circular’ or ‘sca’), a list of integer-pairs specifying the indices of qubits entangled with one another, or a callable returning such a list provided with the index of the entanglement layer. Default to ‘reverse\_linear’ entanglement. Note that ‘reverse\_linear’ entanglement provides the same unitary as ‘full’ with fewer entangling gates. See the Examples section of [`TwoLocal`](qiskit.circuit.library.TwoLocal "qiskit.circuit.library.TwoLocal") for more detail.
+* **initial\_state** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| None*) – A QuantumCircuit object to prepend to the circuit.
+* **skip\_unentangled\_qubits** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, the single qubit gates are only applied to qubits that are entangled with another qubit. If False, the single qubit gates are applied to each qubit in the Ansatz. Defaults to False.
+* **skip\_final\_rotation\_layer** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If False, a rotation layer is added at the end of the ansatz. If True, no rotation layer is added.
+* **parameter\_prefix** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The parameterized gates require a parameter to be defined, for which we use [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector").
+* **insert\_barriers** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, barriers are inserted in between each layer. If False, no barriers are inserted.
+* **flatten** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – Set this to `True` to output a flat circuit instead of nesting it inside multiple layers of gate objects. By default currently the contents of the output circuit will be wrapped in nested objects for cleaner visualization. However, if you’re using this circuit for anything besides visualization its **strongly** recommended to set this flag to `True` to avoid a large performance overhead for parameter binding.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+
+
+### entanglement
+
+Get the entanglement strategy.
+
+**Returns**
+
+The entanglement strategy, see `get_entangler_map()` for more detail on how the format is interpreted.
+
+
+
+### entanglement\_blocks
+
+The blocks in the entanglement layers.
+
+**Returns**
+
+The blocks in the entanglement layers.
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### flatten
+
+Returns whether the circuit is wrapped in nested gates/instructions or flattened.
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### initial\_state
+
+Return the initial state that is added in front of the n-local circuit.
+
+**Returns**
+
+The initial state.
+
+
+
+### insert\_barriers
+
+If barriers are inserted in between the layers or not.
+
+**Returns**
+
+`True`, if barriers are inserted in between the layers, `False` if not.
+
+
+
+### instances
+
+`= 159`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_layers
+
+Return the number of layers in the n-local circuit.
+
+**Returns**
+
+The number of layers in the circuit.
+
+
+
+### num\_parameters
+
+
+
+### num\_parameters\_settable
+
+The number of total parameters that can be set to distinct values.
+
+This does not change when the parameters are bound or exchanged for same parameters, and therefore is different from `num_parameters` which counts the number of unique [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects currently in the circuit.
+
+**Returns**
+
+The number of parameters originally available in the circuit.
+
+
+ This quantity does not require the circuit to be built yet.
+
+
+
+
+### num\_qubits
+
+Returns the number of qubits in this circuit.
+
+**Returns**
+
+The number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### ordered\_parameters
+
+The parameters used in the underlying circuit.
+
+This includes float values and duplicates.
+
+**Examples**
+
+```python
+>>> # prepare circuit ...
+>>> print(nlocal)
+ ┌───────┐┌──────────┐┌──────────┐┌──────────┐
+q_0: ┤ Ry(1) ├┤ Ry(θ[1]) ├┤ Ry(θ[1]) ├┤ Ry(θ[3]) ├
+ └───────┘└──────────┘└──────────┘└──────────┘
+>>> nlocal.parameters
+{Parameter(θ[1]), Parameter(θ[3])}
+>>> nlocal.ordered_parameters
+[1, Parameter(θ[1]), Parameter(θ[1]), Parameter(θ[3])]
+```
+
+**Returns**
+
+The parameters objects used in the circuit.
+
+
+
+### parameter\_bounds
+
+Return the parameter bounds.
+
+**Returns**
+
+The parameter bounds.
+
+
+
+### parameters
+
+
+
+### preferred\_init\_points
+
+The initial points for the parameters. Can be stored as initial guess in optimization.
+
+**Returns**
+
+The initial values for the parameters, or None, if none have been set.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qregs
+
+`list[QuantumRegister]`
+
+A list of the quantum registers associated with the circuit.
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+
+
+### reps
+
+The number of times rotation and entanglement block are repeated.
+
+**Returns**
+
+The number of repetitions.
+
+
+
+### rotation\_blocks
+
+The blocks in the rotation layers.
+
+**Returns**
+
+The blocks in the rotation layers.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.Reset.md b/docs/api/qiskit/0.46/qiskit.circuit.library.Reset.md
new file mode 100644
index 00000000000..e4a701a60dd
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.Reset.md
@@ -0,0 +1,316 @@
+---
+title: Reset
+description: API reference for qiskit.circuit.library.Reset
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.Reset
+---
+
+# Reset
+
+
+
+`qiskit.circuit.library.Reset(label=None, *, duration=None, unit='dt')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/reset.py "view source code")
+
+Bases: [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")
+
+Qubit reset.
+
+Create new reset instruction.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.Reset.base_class "qiskit.circuit.library.Reset.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### add\_decomposition
+
+
+
+`add_decomposition(decomposition)`
+
+Add a decomposition of the instruction to the SessionEquivalenceLibrary.
+
+### assemble
+
+
+
+`assemble()`
+
+Assemble a QasmQobjInstruction
+
+### broadcast\_arguments
+
+
+
+`broadcast_arguments(qargs, cargs)`
+
+Validation of the arguments.
+
+**Parameters**
+
+* **qargs** (*List*) – List of quantum bit arguments.
+* **cargs** (*List*) – List of classical bit arguments.
+
+**Yields**
+
+*Tuple(List, List)* – A tuple with single arguments.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the input is not valid. For example, the number of arguments does not match the gate expectation.
+
+### c\_if
+
+
+
+`c_if(classical, val)`
+
+Set a classical equality condition on this instruction between the register or cbit `classical` and value `val`.
+
+
+ This is a setter method, not an additive one. Calling this multiple times will silently override any previously set condition; it does not stack.
+
+
+### copy
+
+
+
+`copy(name=None)`
+
+Copy of the instruction.
+
+**Parameters**
+
+**name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name to be given to the copied circuit, if `None` then the name stays the same.
+
+**Returns**
+
+a copy of the current instruction, with the name updated if it was provided
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### inverse
+
+
+
+`inverse()`
+
+Invert this instruction.
+
+If the instruction is composite (i.e. has a definition), then its definition will be recursively inverted.
+
+Special instructions inheriting from Instruction can implement their own inverse (e.g. T and Tdg, Barrier, etc.)
+
+**Returns**
+
+a fresh instruction for the inverse
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the instruction is not composite and an inverse has not been implemented for it.
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True .IFF. instruction is parameterized else False
+
+### qasm
+
+
+
+`qasm()`
+
+Return a default OpenQASM string for the instruction.
+
+Derived instructions may override this to print in a different format (e.g. `measure q[0] -> c[0];`).
+
+
+ The method `qiskit.circuit.instruction.Instruction.qasm()` is deprecated as of qiskit-terra 0.25.0. It will be removed in the Qiskit 1.0 release. Correct exporting to OpenQASM 2 is the responsibility of a larger exporter; it cannot safely be done on an object-by-object basis without context. No replacement will be provided, because the premise is wrong.
+
+
+### repeat
+
+
+
+`repeat(n)`
+
+Creates an instruction with gate repeated n amount of times.
+
+**Parameters**
+
+**n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of times to repeat the instruction
+
+**Returns**
+
+Containing the definition.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If n \< 1.
+
+### reverse\_ops
+
+
+
+`reverse_ops()`
+
+For a composite instruction, reverse the order of sub-instructions.
+
+This is done by recursively reversing all sub-instructions. It does not invert any gate.
+
+**Returns**
+
+**a new instruction with**
+
+sub-instructions reversed.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### soft\_compare
+
+
+
+`soft_compare(other)`
+
+Soft comparison between gates. Their names, number of qubits, and classical bit numbers must match. The number of parameters must match. Each parameter is compared. If one is a ParameterExpression then it is not taken into account.
+
+**Parameters**
+
+**other** (*instruction*) – other instruction.
+
+**Returns**
+
+are self and other equal up to parameter expressions.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### to\_mutable
+
+
+
+`to_mutable()`
+
+Return a mutable copy of this gate.
+
+This method will return a new mutable copy of this gate instance. If a singleton instance is being used this will be a new unique instance that can be mutated. If the instance is already mutable it will be a deepcopy of that instance.
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Instruction parameters has no validation or normalization.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.SGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.SGate.md
new file mode 100644
index 00000000000..e728a415e31
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.SGate.md
@@ -0,0 +1,160 @@
+---
+title: SGate
+description: API reference for qiskit.circuit.library.SGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.SGate
+---
+
+# SGate
+
+
+
+`qiskit.circuit.library.SGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/s.py "view source code")
+
+Bases: [`SingletonGate`](circuit_singleton#qiskit.circuit.singleton.SingletonGate "qiskit.circuit.singleton.SingletonGate")
+
+Single qubit S gate (Z\*\*0.5).
+
+It induces a $\pi/2$ phase, and is sometimes called the P gate (phase).
+
+This is a Clifford gate and a square-root of Pauli-Z.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`s()`](qiskit.circuit.QuantumCircuit#s "qiskit.circuit.QuantumCircuit.s") method.
+
+**Matrix Representation:**
+
+$$
+S = \begin{pmatrix}
+ 1 & 0 \\
+ 0 & i
+ \end{pmatrix}
+$$
+
+**Circuit symbol:**
+
+```python
+ ┌───┐
+q_0: ┤ S ├
+ └───┘
+```
+
+Equivalent to a $\pi/2$ radian rotation about the Z axis.
+
+Create new S gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.SGate.base_class "qiskit.circuit.library.SGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverse of S (SdgGate).
+
+### power
+
+
+
+`power(exponent)`
+
+Raise gate to a power.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.SXGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.SXGate.md
new file mode 100644
index 00000000000..9dbd8e82f2e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.SXGate.md
@@ -0,0 +1,182 @@
+---
+title: SXGate
+description: API reference for qiskit.circuit.library.SXGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.SXGate
+---
+
+# SXGate
+
+
+
+`qiskit.circuit.library.SXGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/sx.py "view source code")
+
+Bases: [`SingletonGate`](circuit_singleton#qiskit.circuit.singleton.SingletonGate "qiskit.circuit.singleton.SingletonGate")
+
+The single-qubit Sqrt(X) gate ($\sqrt{X}$).
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`sx()`](qiskit.circuit.QuantumCircuit#sx "qiskit.circuit.QuantumCircuit.sx") method.
+
+**Matrix Representation:**
+
+$$
+\sqrt{X} = \frac{1}{2} \begin{pmatrix}
+ 1 + i & 1 - i \\
+ 1 - i & 1 + i
+ \end{pmatrix}
+$$
+
+**Circuit symbol:**
+
+```python
+ ┌────┐
+q_0: ┤ √X ├
+ └────┘
+```
+
+
+ A global phase difference exists between the definitions of $RX(\pi/2)$ and $\sqrt{X}$.
+
+ $$
+ RX(\pi/2) = \frac{1}{\sqrt{2}} \begin{pmatrix}
+ 1 & -i \\
+ -i & 1
+ \end{pmatrix}
+ = e^{-i \pi/4} \sqrt{X}
+ $$
+
+
+Create new SX gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.SXGate.base_class "qiskit.circuit.library.SXGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Return a (multi-)controlled-SX gate.
+
+One control returns a CSX gate.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of control qubits.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for the gate \[Default: None]
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – control state expressed as integer, string (e.g. ‘110’), or None. If None, use all 1s.
+
+**Returns**
+
+controlled version of this gate.
+
+**Return type**
+
+[SingletonControlledGate](circuit_singleton#qiskit.circuit.singleton.SingletonControlledGate "qiskit.circuit.singleton.SingletonControlledGate")
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverse SX gate (i.e. SXdg).
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.SXdgGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.SXdgGate.md
new file mode 100644
index 00000000000..849043ed5d1
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.SXdgGate.md
@@ -0,0 +1,148 @@
+---
+title: SXdgGate
+description: API reference for qiskit.circuit.library.SXdgGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.SXdgGate
+---
+
+# SXdgGate
+
+
+
+`qiskit.circuit.library.SXdgGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/sx.py "view source code")
+
+Bases: [`SingletonGate`](circuit_singleton#qiskit.circuit.singleton.SingletonGate "qiskit.circuit.singleton.SingletonGate")
+
+The inverse single-qubit Sqrt(X) gate.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`sxdg()`](qiskit.circuit.QuantumCircuit#sxdg "qiskit.circuit.QuantumCircuit.sxdg") method.
+
+$$
+\sqrt{X}^{\dagger} = \frac{1}{2} \begin{pmatrix}
+ 1 - i & 1 + i \\
+ 1 + i & 1 - i
+ \end{pmatrix}
+$$
+
+
+ A global phase difference exists between the definitions of $RX(-\pi/2)$ and $\sqrt{X}^{\dagger}$.
+
+ $$
+ RX(-\pi/2) = \frac{1}{\sqrt{2}} \begin{pmatrix}
+ 1 & i \\
+ i & 1
+ \end{pmatrix}
+ = e^{-i \pi/4} \sqrt{X}^{\dagger}
+ $$
+
+
+Create new SXdg gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.SXdgGate.base_class "qiskit.circuit.library.SXdgGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverse SXdg gate (i.e. SX).
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.SdgGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.SdgGate.md
new file mode 100644
index 00000000000..1607bf2903c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.SdgGate.md
@@ -0,0 +1,160 @@
+---
+title: SdgGate
+description: API reference for qiskit.circuit.library.SdgGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.SdgGate
+---
+
+# SdgGate
+
+
+
+`qiskit.circuit.library.SdgGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/s.py "view source code")
+
+Bases: [`SingletonGate`](circuit_singleton#qiskit.circuit.singleton.SingletonGate "qiskit.circuit.singleton.SingletonGate")
+
+Single qubit S-adjoint gate (\~Z\*\*0.5).
+
+It induces a $-\pi/2$ phase.
+
+This is a Clifford gate and a square-root of Pauli-Z.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`sdg()`](qiskit.circuit.QuantumCircuit#sdg "qiskit.circuit.QuantumCircuit.sdg") method.
+
+**Matrix Representation:**
+
+$$
+Sdg = \begin{pmatrix}
+ 1 & 0 \\
+ 0 & -i
+ \end{pmatrix}
+$$
+
+**Circuit symbol:**
+
+```python
+ ┌─────┐
+q_0: ┤ Sdg ├
+ └─────┘
+```
+
+Equivalent to a $-\pi/2$ radian rotation about the Z axis.
+
+Create new Sdg gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.SdgGate.base_class "qiskit.circuit.library.SdgGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverse of Sdg (SGate).
+
+### power
+
+
+
+`power(exponent)`
+
+Raise gate to a power.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.StatePreparation.md b/docs/api/qiskit/0.46/qiskit.circuit.library.StatePreparation.md
new file mode 100644
index 00000000000..f5454e0cd7e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.StatePreparation.md
@@ -0,0 +1,211 @@
+---
+title: StatePreparation
+description: API reference for qiskit.circuit.library.StatePreparation
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.StatePreparation
+---
+
+# StatePreparation
+
+
+
+`qiskit.circuit.library.StatePreparation(params, num_qubits=None, inverse=False, label=None, normalize=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/data_preparation/state_preparation.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+Complex amplitude state preparation.
+
+Class that implements the (complex amplitude) state preparation of some flexible collection of qubit registers.
+
+**Parameters**
+
+* **params** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.states.statevector.Statevector")) –
+
+ * Statevector: Statevector to initialize to.
+ * list: vector of complex amplitudes to initialize to.
+ * string: labels of basis states of the Pauli eigenstates Z, X, Y. See [`Statevector.from_label()`](qiskit.quantum_info.Statevector#from_label "qiskit.quantum_info.Statevector.from_label"). Notice the order of the labels is reversed with respect to the qubit index to be applied to. Example label ‘01’ initializes the qubit zero to $|1\rangle$ and the qubit one to $|0\rangle$.
+ * int: an integer that is used as a bitmap indicating which qubits to initialize to $|1\rangle$. Example: setting params to 5 would initialize qubit 0 and qubit 2 to $|1\rangle$ and qubit 1 to $|0\rangle$.
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – This parameter is only used if params is an int. Indicates the total number of qubits in the initialize call. Example: initialize covers 5 qubits and params is 3. This allows qubits 0 and 1 to be initialized to $|1\rangle$ and the remaining 3 qubits to be initialized to $|0\rangle$.
+
+* **inverse** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if True, the inverse state is constructed.
+
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – An optional label for the gate
+
+* **normalize** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to normalize an input array to a unit vector.
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – `num_qubits` parameter used when `params` is not an integer
+
+When a Statevector argument is passed the state is prepared using a recursive initialization algorithm, including optimizations, from \[1], as well as some additional optimizations including removing zero rotations and double cnots.
+
+**References:** \[1] Shende, Bullock, Markov. Synthesis of Quantum Logic Circuits (2004) \[[https://arxiv.org/abs/quant-ph/0406176v5](https://arxiv.org/abs/quant-ph/0406176v5)]
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.StatePreparation.base_class "qiskit.circuit.library.StatePreparation.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### broadcast\_arguments
+
+
+
+`broadcast_arguments(qargs, cargs)`
+
+Validation and handling of the arguments and its relationship.
+
+For example, `cx([q[0],q[1]], q[2])` means `cx(q[0], q[2]); cx(q[1], q[2])`. This method yields the arguments in the right grouping. In the given example:
+
+```python
+in: [[q[0],q[1]], q[2]],[]
+outs: [q[0], q[2]], []
+ [q[1], q[2]], []
+```
+
+The general broadcasting rules are:
+
+> * If len(qargs) == 1:
+>
+> ```python
+> [q[0], q[1]] -> [q[0]],[q[1]]
+> ```
+>
+> * If len(qargs) == 2:
+>
+> ```python
+> [[q[0], q[1]], [r[0], r[1]]] -> [q[0], r[0]], [q[1], r[1]]
+> [[q[0]], [r[0], r[1]]] -> [q[0], r[0]], [q[0], r[1]]
+> [[q[0], q[1]], [r[0]]] -> [q[0], r[0]], [q[1], r[0]]
+> ```
+>
+> * If len(qargs) >= 3:
+>
+> ```python
+> [q[0], q[1]], [r[0], r[1]], ...] -> [q[0], r[0], ...], [q[1], r[1], ...]
+> ```
+
+**Parameters**
+
+* **qargs** – List of quantum bit arguments.
+* **cargs** – List of classical bit arguments.
+
+**Returns**
+
+A tuple with single arguments.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the input is not valid. For example, the number of arguments does not match the gate expectation.
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted StatePreparation
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+StatePreparation instruction parameter can be str, int, float, and complex.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.SwapGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.SwapGate.md
new file mode 100644
index 00000000000..79b2c2e8936
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.SwapGate.md
@@ -0,0 +1,181 @@
+---
+title: SwapGate
+description: API reference for qiskit.circuit.library.SwapGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.SwapGate
+---
+
+# SwapGate
+
+
+
+`qiskit.circuit.library.SwapGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/swap.py "view source code")
+
+Bases: [`SingletonGate`](circuit_singleton#qiskit.circuit.singleton.SingletonGate "qiskit.circuit.singleton.SingletonGate")
+
+The SWAP gate.
+
+This is a symmetric and Clifford gate.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`swap()`](qiskit.circuit.QuantumCircuit#swap "qiskit.circuit.QuantumCircuit.swap") method.
+
+**Circuit symbol:**
+
+```python
+q_0: ─X─
+ │
+q_1: ─X─
+```
+
+**Matrix Representation:**
+
+$$
+SWAP =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & 0 & 1 & 0 \\
+ 0 & 1 & 0 & 0 \\
+ 0 & 0 & 0 & 1
+ \end{pmatrix}
+$$
+
+The gate is equivalent to a state swap and is a classical logic gate.
+
+$$
+|a, b\rangle \rightarrow |b, a\rangle
+$$
+
+Create new SWAP gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.SwapGate.base_class "qiskit.circuit.library.SwapGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Return a (multi-)controlled-SWAP gate.
+
+One control returns a CSWAP (Fredkin) gate.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of control qubits.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for the gate \[Default: None]
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – control state expressed as integer, string (e.g. ‘110’), or None. If None, use all 1s.
+
+**Returns**
+
+controlled version of this gate.
+
+**Return type**
+
+[ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverse Swap gate (itself).
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.TGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.TGate.md
new file mode 100644
index 00000000000..09bf8711113
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.TGate.md
@@ -0,0 +1,160 @@
+---
+title: TGate
+description: API reference for qiskit.circuit.library.TGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.TGate
+---
+
+# TGate
+
+
+
+`qiskit.circuit.library.TGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/t.py "view source code")
+
+Bases: [`SingletonGate`](circuit_singleton#qiskit.circuit.singleton.SingletonGate "qiskit.circuit.singleton.SingletonGate")
+
+Single qubit T gate (Z\*\*0.25).
+
+It induces a $\pi/4$ phase, and is sometimes called the pi/8 gate (because of how the RZ(pi/4) matrix looks like).
+
+This is a non-Clifford gate and a fourth-root of Pauli-Z.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`t()`](qiskit.circuit.QuantumCircuit#t "qiskit.circuit.QuantumCircuit.t") method.
+
+**Matrix Representation:**
+
+$$
+T = \begin{pmatrix}
+ 1 & 0 \\
+ 0 & e^{i\pi/4}
+ \end{pmatrix}
+$$
+
+**Circuit symbol:**
+
+```python
+ ┌───┐
+q_0: ┤ T ├
+ └───┘
+```
+
+Equivalent to a $\pi/4$ radian rotation about the Z axis.
+
+Create new T gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.TGate.base_class "qiskit.circuit.library.TGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverse T gate (i.e. Tdg).
+
+### power
+
+
+
+`power(exponent)`
+
+Raise gate to a power.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.TdgGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.TdgGate.md
new file mode 100644
index 00000000000..952b408560e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.TdgGate.md
@@ -0,0 +1,160 @@
+---
+title: TdgGate
+description: API reference for qiskit.circuit.library.TdgGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.TdgGate
+---
+
+# TdgGate
+
+
+
+`qiskit.circuit.library.TdgGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/t.py "view source code")
+
+Bases: [`SingletonGate`](circuit_singleton#qiskit.circuit.singleton.SingletonGate "qiskit.circuit.singleton.SingletonGate")
+
+Single qubit T-adjoint gate (\~Z\*\*0.25).
+
+It induces a $-\pi/4$ phase.
+
+This is a non-Clifford gate and a fourth-root of Pauli-Z.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`tdg()`](qiskit.circuit.QuantumCircuit#tdg "qiskit.circuit.QuantumCircuit.tdg") method.
+
+**Matrix Representation:**
+
+$$
+Tdg = \begin{pmatrix}
+ 1 & 0 \\
+ 0 & e^{-i\pi/4}
+ \end{pmatrix}
+$$
+
+**Circuit symbol:**
+
+```python
+ ┌─────┐
+q_0: ┤ Tdg ├
+ └─────┘
+```
+
+Equivalent to a $-\pi/4$ radian rotation about the Z axis.
+
+Create new Tdg gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.TdgGate.base_class "qiskit.circuit.library.TdgGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverse Tdg gate (i.e. T).
+
+### power
+
+
+
+`power(exponent)`
+
+Raise gate to a power.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.TwoLocal.md b/docs/api/qiskit/0.46/qiskit.circuit.library.TwoLocal.md
new file mode 100644
index 00000000000..9b04820924e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.TwoLocal.md
@@ -0,0 +1,415 @@
+---
+title: TwoLocal
+description: API reference for qiskit.circuit.library.TwoLocal
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.TwoLocal
+---
+
+# TwoLocal
+
+
+
+`qiskit.circuit.library.TwoLocal(num_qubits=None, rotation_blocks=None, entanglement_blocks=None, entanglement='full', reps=3, skip_unentangled_qubits=False, skip_final_rotation_layer=False, parameter_prefix='θ', insert_barriers=False, initial_state=None, name='TwoLocal', flatten=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/n_local/two_local.py "view source code")
+
+Bases: [`NLocal`](qiskit.circuit.library.NLocal "qiskit.circuit.library.n_local.n_local.NLocal")
+
+The two-local circuit.
+
+The two-local circuit is a parameterized circuit consisting of alternating rotation layers and entanglement layers. The rotation layers are single qubit gates applied on all qubits. The entanglement layer uses two-qubit gates to entangle the qubits according to a strategy set using `entanglement`. Both the rotation and entanglement gates can be specified as string (e.g. `'ry'` or `'cx'`), as gate-type (e.g. `RYGate` or `CXGate`) or as QuantumCircuit (e.g. a 1-qubit circuit or 2-qubit circuit).
+
+A set of default entanglement strategies is provided:
+
+* `'full'` entanglement is each qubit is entangled with all the others.
+* `'linear'` entanglement is qubit $i$ entangled with qubit $i + 1$, for all $i \in \{0, 1, ... , n - 2\}$, where $n$ is the total number of qubits.
+* `'reverse_linear'` entanglement is qubit $i$ entangled with qubit $i + 1$, for all $i \in \{n-2, n-3, ... , 1, 0\}$, where $n$ is the total number of qubits. Note that if `entanglement_blocks = 'cx'` then this option provides the same unitary as `'full'` with fewer entangling gates.
+* `'pairwise'` entanglement is one layer where qubit $i$ is entangled with qubit $i + 1$, for all even values of $i$, and then a second layer where qubit $i$ is entangled with qubit $i + 1$, for all odd values of $i$.
+* `'circular'` entanglement is linear entanglement but with an additional entanglement of the first and last qubit before the linear part.
+* `'sca'` (shifted-circular-alternating) entanglement is a generalized and modified version of the proposed circuit 14 in [Sim et al.](https://arxiv.org/abs/1905.10876). It consists of circular entanglement where the ‘long’ entanglement connecting the first with the last qubit is shifted by one each block. Furthermore the role of control and target qubits are swapped every block (therefore alternating).
+
+The entanglement can further be specified using an entangler map, which is a list of index pairs, such as
+
+```python
+>>> entangler_map = [(0, 1), (1, 2), (2, 0)]
+```
+
+If different entanglements per block should be used, provide a list of entangler maps. See the examples below on how this can be used.
+
+```python
+>>> entanglement = [entangler_map_layer_1, entangler_map_layer_2, ... ]
+```
+
+Barriers can be inserted in between the different layers for better visualization using the `insert_barriers` attribute.
+
+For each parameterized gate a new parameter is generated using a `ParameterVector`. The name of these parameters can be chosen using the `parameter_prefix`.
+
+**Examples**
+
+```python
+>>> two = TwoLocal(3, 'ry', 'cx', 'linear', reps=2, insert_barriers=True)
+>>> print(two) # decompose the layers into standard gates
+ ┌──────────┐ ░ ░ ┌──────────┐ ░ ░ ┌──────────┐
+q_0: ┤ Ry(θ[0]) ├─░───■────────░─┤ Ry(θ[3]) ├─░───■────────░─┤ Ry(θ[6]) ├
+ ├──────────┤ ░ ┌─┴─┐ ░ ├──────────┤ ░ ┌─┴─┐ ░ ├──────────┤
+q_1: ┤ Ry(θ[1]) ├─░─┤ X ├──■───░─┤ Ry(θ[4]) ├─░─┤ X ├──■───░─┤ Ry(θ[7]) ├
+ ├──────────┤ ░ └───┘┌─┴─┐ ░ ├──────────┤ ░ └───┘┌─┴─┐ ░ ├──────────┤
+q_2: ┤ Ry(θ[2]) ├─░──────┤ X ├─░─┤ Ry(θ[5]) ├─░──────┤ X ├─░─┤ Ry(θ[8]) ├
+ └──────────┘ ░ └───┘ ░ └──────────┘ ░ └───┘ ░ └──────────┘
+```
+
+```python
+>>> two = TwoLocal(3, ['ry','rz'], 'cz', 'full', reps=1, insert_barriers=True)
+>>> qc = QuantumCircuit(3)
+>>> qc += two
+>>> print(qc.decompose().draw())
+ ┌──────────┐┌──────────┐ ░ ░ ┌──────────┐ ┌──────────┐
+q_0: ┤ Ry(θ[0]) ├┤ Rz(θ[3]) ├─░──■──■─────░─┤ Ry(θ[6]) ├─┤ Rz(θ[9]) ├
+ ├──────────┤├──────────┤ ░ │ │ ░ ├──────────┤┌┴──────────┤
+q_1: ┤ Ry(θ[1]) ├┤ Rz(θ[4]) ├─░──■──┼──■──░─┤ Ry(θ[7]) ├┤ Rz(θ[10]) ├
+ ├──────────┤├──────────┤ ░ │ │ ░ ├──────────┤├───────────┤
+q_2: ┤ Ry(θ[2]) ├┤ Rz(θ[5]) ├─░─────■──■──░─┤ Ry(θ[8]) ├┤ Rz(θ[11]) ├
+ └──────────┘└──────────┘ ░ ░ └──────────┘└───────────┘
+```
+
+```python
+>>> entangler_map = [[0, 1], [1, 2], [2, 0]] # circular entanglement for 3 qubits
+>>> two = TwoLocal(3, 'x', 'crx', entangler_map, reps=1)
+>>> print(two) # note: no barriers inserted this time!
+ ┌───┐ ┌──────────┐┌───┐
+q_0: |0>┤ X ├─────■───────────────────────┤ Rx(θ[2]) ├┤ X ├
+ ├───┤┌────┴─────┐ ┌───┐└─────┬────┘└───┘
+q_1: |0>┤ X ├┤ Rx(θ[0]) ├─────■──────┤ X ├──────┼──────────
+ ├───┤└──────────┘┌────┴─────┐└───┘ │ ┌───┐
+q_2: |0>┤ X ├────────────┤ Rx(θ[1]) ├───────────■─────┤ X ├
+ └───┘ └──────────┘ └───┘
+```
+
+```python
+>>> entangler_map = [[0, 3], [0, 2]] # entangle the first and last two-way
+>>> two = TwoLocal(4, [], 'cry', entangler_map, reps=1)
+>>> circuit = two + two
+>>> print(circuit.decompose().draw()) # note, that the parameters are the same!
+q_0: ─────■───────────■───────────■───────────■──────
+ │ │ │ │
+q_1: ─────┼───────────┼───────────┼───────────┼──────
+ │ ┌────┴─────┐ │ ┌────┴─────┐
+q_2: ─────┼──────┤ Ry(θ[1]) ├─────┼──────┤ Ry(θ[1]) ├
+ ┌────┴─────┐└──────────┘┌────┴─────┐└──────────┘
+q_3: ┤ Ry(θ[0]) ├────────────┤ Ry(θ[0]) ├────────────
+ └──────────┘ └──────────┘
+```
+
+```python
+>>> layer_1 = [(0, 1), (0, 2)]
+>>> layer_2 = [(1, 2)]
+>>> two = TwoLocal(3, 'x', 'cx', [layer_1, layer_2], reps=2, insert_barriers=True)
+>>> print(two)
+ ┌───┐ ░ ░ ┌───┐ ░ ░ ┌───┐
+q_0: ┤ X ├─░───■────■───░─┤ X ├─░───────░─┤ X ├
+ ├───┤ ░ ┌─┴─┐ │ ░ ├───┤ ░ ░ ├───┤
+q_1: ┤ X ├─░─┤ X ├──┼───░─┤ X ├─░───■───░─┤ X ├
+ ├───┤ ░ └───┘┌─┴─┐ ░ ├───┤ ░ ┌─┴─┐ ░ ├───┤
+q_2: ┤ X ├─░──────┤ X ├─░─┤ X ├─░─┤ X ├─░─┤ X ├
+ └───┘ ░ └───┘ ░ └───┘ ░ └───┘ ░ └───┘
+```
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of qubits of the two-local circuit.
+* **rotation\_blocks** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*type*](https://docs.python.org/3/library/functions.html#type "(in Python v3.12)") *|*[*qiskit.circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction") *|*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*type*](https://docs.python.org/3/library/functions.html#type "(in Python v3.12)") *|*[*qiskit.circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction") *|*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*] | None*) – The gates used in the rotation layer. Can be specified via the name of a gate (e.g. `'ry'`) or the gate type itself (e.g. [`RYGate`](qiskit.circuit.library.RYGate "qiskit.circuit.library.RYGate")). If only one gate is provided, the gate same gate is applied to each qubit. If a list of gates is provided, all gates are applied to each qubit in the provided order. See the Examples section for more detail.
+* **entanglement\_blocks** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*type*](https://docs.python.org/3/library/functions.html#type "(in Python v3.12)") *|*[*qiskit.circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction") *|*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*type*](https://docs.python.org/3/library/functions.html#type "(in Python v3.12)") *|*[*qiskit.circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction") *|*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*] | None*) – The gates used in the entanglement layer. Can be specified in the same format as `rotation_blocks`.
+* **entanglement** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]] | Callable\[\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*],* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]]*) – Specifies the entanglement structure. Can be a string (`'full'`, `'linear'`, `'reverse_linear'`, `'circular'` or `'sca'`), a list of integer-pairs specifying the indices of qubits entangled with one another, or a callable returning such a list provided with the index of the entanglement layer. Default to `'full'` entanglement. Note that if `entanglement_blocks = 'cx'`, then `'full'` entanglement provides the same unitary as `'reverse_linear'` but the latter option has fewer entangling gates. See the Examples section for more detail.
+* **reps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Specifies how often a block consisting of a rotation layer and entanglement layer is repeated.
+* **skip\_unentangled\_qubits** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If `True`, the single qubit gates are only applied to qubits that are entangled with another qubit. If `False`, the single qubit gates are applied to each qubit in the ansatz. Defaults to `False`.
+* **skip\_final\_rotation\_layer** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If `False`, a rotation layer is added at the end of the ansatz. If `True`, no rotation layer is added.
+* **parameter\_prefix** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The parameterized gates require a parameter to be defined, for which we use instances of [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter"). The name of each parameter will be this specified prefix plus its index.
+* **insert\_barriers** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If `True`, barriers are inserted in between each layer. If `False`, no barriers are inserted. Defaults to `False`.
+* **initial\_state** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| None*) – A [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") object to prepend to the circuit.
+* **flatten** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – Set this to `True` to output a flat circuit instead of nesting it inside multiple layers of gate objects. By default currently the contents of the output circuit will be wrapped in nested objects for cleaner visualization. However, if you’re using this circuit for anything besides visualization its **strongly** recommended to set this flag to `True` to avoid a large performance overhead for parameter binding.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+
+
+### entanglement
+
+Get the entanglement strategy.
+
+**Returns**
+
+The entanglement strategy, see [`get_entangler_map()`](#qiskit.circuit.library.TwoLocal.get_entangler_map "qiskit.circuit.library.TwoLocal.get_entangler_map") for more detail on how the format is interpreted.
+
+
+
+### entanglement\_blocks
+
+The blocks in the entanglement layers.
+
+**Returns**
+
+The blocks in the entanglement layers.
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### flatten
+
+Returns whether the circuit is wrapped in nested gates/instructions or flattened.
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### initial\_state
+
+Return the initial state that is added in front of the n-local circuit.
+
+**Returns**
+
+The initial state.
+
+
+
+### insert\_barriers
+
+If barriers are inserted in between the layers or not.
+
+**Returns**
+
+`True`, if barriers are inserted in between the layers, `False` if not.
+
+
+
+### instances
+
+`= 159`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_layers
+
+Return the number of layers in the n-local circuit.
+
+**Returns**
+
+The number of layers in the circuit.
+
+
+
+### num\_parameters
+
+
+
+### num\_parameters\_settable
+
+The number of total parameters that can be set to distinct values.
+
+This does not change when the parameters are bound or exchanged for same parameters, and therefore is different from `num_parameters` which counts the number of unique [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects currently in the circuit.
+
+**Returns**
+
+The number of parameters originally available in the circuit.
+
+
+ This quantity does not require the circuit to be built yet.
+
+
+
+
+### num\_qubits
+
+Returns the number of qubits in this circuit.
+
+**Returns**
+
+The number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### ordered\_parameters
+
+The parameters used in the underlying circuit.
+
+This includes float values and duplicates.
+
+**Examples**
+
+```python
+>>> # prepare circuit ...
+>>> print(nlocal)
+ ┌───────┐┌──────────┐┌──────────┐┌──────────┐
+q_0: ┤ Ry(1) ├┤ Ry(θ[1]) ├┤ Ry(θ[1]) ├┤ Ry(θ[3]) ├
+ └───────┘└──────────┘└──────────┘└──────────┘
+>>> nlocal.parameters
+{Parameter(θ[1]), Parameter(θ[3])}
+>>> nlocal.ordered_parameters
+[1, Parameter(θ[1]), Parameter(θ[1]), Parameter(θ[3])]
+```
+
+**Returns**
+
+The parameters objects used in the circuit.
+
+
+
+### parameter\_bounds
+
+The parameter bounds for the unbound parameters in the circuit.
+
+**Returns**
+
+A list of pairs indicating the bounds, as (lower, upper). None indicates an unbounded parameter in the corresponding direction. If `None` is returned, problem is fully unbounded.
+
+
+
+### parameters
+
+
+
+### preferred\_init\_points
+
+The initial points for the parameters. Can be stored as initial guess in optimization.
+
+**Returns**
+
+The initial values for the parameters, or None, if none have been set.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qregs
+
+`list[QuantumRegister]`
+
+A list of the quantum registers associated with the circuit.
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+
+
+### reps
+
+The number of times rotation and entanglement block are repeated.
+
+**Returns**
+
+The number of repetitions.
+
+
+
+### rotation\_blocks
+
+The blocks in the rotation layers.
+
+**Returns**
+
+The blocks in the rotation layers.
+
+## Methods
+
+### get\_entangler\_map
+
+
+
+`get_entangler_map(rep_num, block_num, num_block_qubits)`
+
+Overloading to handle the special case of 1 qubit where the entanglement are ignored.
+
+**Return type**
+
+[*Sequence*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Sequence "(in Python v3.12)")\[[*Sequence*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Sequence "(in Python v3.12)")\[[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")]]
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.U1Gate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.U1Gate.md
new file mode 100644
index 00000000000..5d7b438b452
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.U1Gate.md
@@ -0,0 +1,208 @@
+---
+title: U1Gate
+description: API reference for qiskit.circuit.library.U1Gate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.U1Gate
+---
+
+# U1Gate
+
+
+
+`qiskit.circuit.library.U1Gate(theta, label=None, *, duration=None, unit='dt')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/u1.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+Single-qubit rotation about the Z axis.
+
+This is a diagonal gate. It can be implemented virtually in hardware via framechanges (i.e. at zero error and duration).
+
+
+ This gate is deprecated. Instead, the following replacements should be used
+
+ $$
+ U1(\lambda) = P(\lambda)= U(0,0,\lambda)
+ $$
+
+ ```python
+ circuit = QuantumCircuit(1)
+ circuit.p(lambda, 0) # or circuit.u(0, 0, lambda)
+ ```
+
+
+**Circuit symbol:**
+
+```python
+ ┌───────┐
+q_0: ┤ U1(λ) ├
+ └───────┘
+```
+
+**Matrix Representation:**
+
+$$
+U1(\lambda) =
+ \begin{pmatrix}
+ 1 & 0 \\
+ 0 & e^{i\lambda}
+ \end{pmatrix}
+$$
+
+**Examples:**
+
+> $$
+> U1(\lambda = \pi) = Z
+> $$
+>
+> $$
+> U1(\lambda = \pi/2) = S
+> $$
+>
+> $$
+> U1(\lambda = \pi/4) = T
+> $$
+
+
+ `RZGate`: This gate is equivalent to RZ up to a phase factor.
+
+ > $$
+ > U1(\lambda) = e^{i{\lambda}/2} RZ(\lambda)
+ > $$
+
+ `U3Gate`: U3 is a generalization of U2 that covers all single-qubit rotations, using two X90 pulses.
+
+ Reference for virtual Z gate implementation: [1612.00858](https://arxiv.org/abs/1612.00858)
+
+
+Create new U1 gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.U1Gate.base_class "qiskit.circuit.library.U1Gate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Return a (multi-)controlled-U1 gate.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of control qubits.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for the gate \[Default: None]
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – control state expressed as integer, string (e.g. ‘110’), or None. If None, use all 1s.
+
+**Returns**
+
+controlled version of this gate.
+
+**Return type**
+
+[ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted U1 gate ($U1(\lambda)^{\dagger} = U1(-\lambda)$)
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.U2Gate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.U2Gate.md
new file mode 100644
index 00000000000..c0cd19dcdfc
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.U2Gate.md
@@ -0,0 +1,187 @@
+---
+title: U2Gate
+description: API reference for qiskit.circuit.library.U2Gate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.U2Gate
+---
+
+# U2Gate
+
+
+
+`qiskit.circuit.library.U2Gate(phi, lam, label=None, *, duration=None, unit='dt')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/u2.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+Single-qubit rotation about the X+Z axis.
+
+Implemented using one X90 pulse on IBM Quantum systems:
+
+
+ This gate is deprecated. Instead, the following replacements should be used
+
+ $$
+ U2(\phi, \lambda) = U\left(\frac{\pi}{2}, \phi, \lambda\right)
+ $$
+
+ ```python
+ circuit = QuantumCircuit(1)
+ circuit.u(pi/2, phi, lambda)
+ ```
+
+
+**Circuit symbol:**
+
+```python
+ ┌─────────┐
+q_0: ┤ U2(φ,λ) ├
+ └─────────┘
+```
+
+**Matrix Representation:**
+
+$$
+U2(\phi, \lambda) = \frac{1}{\sqrt{2}}
+ \begin{pmatrix}
+ 1 & -e^{i\lambda} \\
+ e^{i\phi} & e^{i(\phi+\lambda)}
+ \end{pmatrix}
+$$
+
+**Examples:**
+
+$$
+U2(\phi,\lambda) = e^{i \frac{\phi + \lambda}{2}}RZ(\phi)
+RY\left(\frac{\pi}{2}\right) RZ(\lambda)
+= e^{- i\frac{\pi}{4}} P\left(\frac{\pi}{2} + \phi\right)
+\sqrt{X} P\left(\lambda- \frac{\pi}{2}\right)
+$$
+
+$$
+U2(0, \pi) = H
+$$
+
+$$
+U2(0, 0) = RY(\pi/2)
+$$
+
+$$
+U2(-\pi/2, \pi/2) = RX(\pi/2)
+$$
+
+
+ `U3Gate`: U3 is a generalization of U2 that covers all single-qubit rotations, using two X90 pulses.
+
+
+Create new U2 gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.U2Gate.base_class "qiskit.circuit.library.U2Gate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted U2 gate.
+
+$U2(\phi, \lambda)^{\dagger} =U2(-\lambda-\pi, -\phi+\pi)$)
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.U3Gate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.U3Gate.md
new file mode 100644
index 00000000000..e9f4b5fa741
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.U3Gate.md
@@ -0,0 +1,204 @@
+---
+title: U3Gate
+description: API reference for qiskit.circuit.library.U3Gate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.U3Gate
+---
+
+# U3Gate
+
+
+
+`qiskit.circuit.library.U3Gate(theta, phi, lam, label=None, *, duration=None, unit='dt')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/u3.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+Generic single-qubit rotation gate with 3 Euler angles.
+
+
+ This gate is deprecated. Instead, the following replacements should be used
+
+ $$
+ U3(\theta, \phi, \lambda) = U(\theta, \phi, \lambda)
+ $$
+
+ ```python
+ circuit = QuantumCircuit(1)
+ circuit.u(theta, phi, lambda)
+ ```
+
+
+**Circuit symbol:**
+
+```python
+ ┌───────────┐
+q_0: ┤ U3(ϴ,φ,λ) ├
+ └───────────┘
+```
+
+**Matrix Representation:**
+
+$$
+\newcommand{\rotationangle}{\frac{\theta}{2}}
+
+U3(\theta, \phi, \lambda) =
+ \begin{pmatrix}
+ \cos\left(\rotationangle\right) & -e^{i\lambda}\sin\left(\rotationangle\right) \\
+ e^{i\phi}\sin\left(\rotationangle\right) &
+ e^{i(\phi+\lambda)}\cos\left(\rotationangle\right)
+ \end{pmatrix}
+$$
+
+
+ The matrix representation shown here differs from the [OpenQASM 2.0 specification](https://doi.org/10.48550/arXiv.1707.03429) by a global phase of $e^{i(\phi+\lambda)/2}$.
+
+
+**Examples:**
+
+$$
+U3(\theta, \phi, \lambda) = e^{-i \frac{\pi + \theta}{2}} P(\phi + \pi) \sqrt{X}
+P(\theta + \pi) \sqrt{X} P(\lambda)
+$$
+
+$$
+U3\left(\theta, -\frac{\pi}{2}, \frac{\pi}{2}\right) = RX(\theta)
+$$
+
+$$
+U3(\theta, 0, 0) = RY(\theta)
+$$
+
+Create new U3 gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.U3Gate.base_class "qiskit.circuit.library.U3Gate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Return a (multi-)controlled-U3 gate.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of control qubits.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for the gate \[Default: None]
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – control state expressed as integer, string (e.g. ‘110’), or None. If None, use all 1s.
+
+**Returns**
+
+controlled version of this gate.
+
+**Return type**
+
+[ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted U3 gate.
+
+$U3(\theta,\phi,\lambda)^{\dagger} =U3(-\theta,-\lambda,-\phi)$)
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.UCGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.UCGate.md
new file mode 100644
index 00000000000..7170576bad6
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.UCGate.md
@@ -0,0 +1,169 @@
+---
+title: UCGate
+description: API reference for qiskit.circuit.library.UCGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.UCGate
+---
+
+# UCGate
+
+
+
+`qiskit.circuit.library.UCGate(gate_list, up_to_diagonal=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/generalized_gates/uc.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+Uniformly controlled gate (also called multiplexed gate).
+
+These gates can have several control qubits and a single target qubit. If the k control qubits are in the state $|i\rangle$ (in the computational basis), a single-qubit unitary $U_i$ is applied to the target qubit.
+
+This gate is represented by a block-diagonal matrix, where each block is a $2\times 2$ unitary, that is
+
+$$
+\begin{pmatrix}
+ U_0 & 0 & \cdots & 0 \\
+ 0 & U_1 & \cdots & 0 \\
+ \vdots & & \ddots & \vdots \\
+ 0 & 0 & \cdots & U_{2^{k-1}}
+\end{pmatrix}.
+$$
+
+The decomposition is based on Ref. \[1].
+
+**References:**
+
+**\[1] Bergholm et al., Quantum circuits with uniformly controlled one-qubit gates (2005).**
+
+[Phys. Rev. A 71, 052330](https://journals.aps.org/pra/abstract/10.1103/PhysRevA.71.052330).
+
+**Parameters**
+
+* **gate\_list** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[np.ndarray]*) – List of two qubit unitaries $[U_0, ..., U_{2^{k-1}}]$, where each single-qubit unitary $U_i$ is given as a $2 \times 2$ numpy array.
+* **up\_to\_diagonal** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Determines if the gate is implemented up to a diagonal. or if it is decomposed completely (default: False). If the `UCGate` $U$ is decomposed up to a diagonal $D$, this means that the circuit implements a unitary $U'$ such that $D U' = U$.
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – in case of bad input to the constructor
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.UCGate.base_class "qiskit.circuit.library.UCGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return the inverse.
+
+This does not re-compute the decomposition for the multiplexer with the inverse of the gates but simply inverts the existing decomposition.
+
+**Return type**
+
+[*Gate*](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Uniformly controlled gate parameter has to be an ndarray.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.UCPauliRotGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.UCPauliRotGate.md
new file mode 100644
index 00000000000..f9961b5a124
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.UCPauliRotGate.md
@@ -0,0 +1,122 @@
+---
+title: UCPauliRotGate
+description: API reference for qiskit.circuit.library.UCPauliRotGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.UCPauliRotGate
+---
+
+# UCPauliRotGate
+
+
+
+`qiskit.circuit.library.UCPauliRotGate(angle_list, rot_axis)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/generalized_gates/uc_pauli_rot.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+Uniformly controlled Pauli rotations.
+
+Implements the [`UCGate`](qiskit.circuit.library.UCGate "qiskit.circuit.library.UCGate") for the special case that all unitaries are Pauli rotations, $U_i = R_P(a_i)$ where $P \in \{X, Y, Z\}$ and $a_i \in \mathbb{R}$ is the rotation angle.
+
+**Parameters**
+
+* **angle\_list** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – List of rotation angles $[a_0, ..., a_{2^{k-1}}]$.
+* **rot\_axis** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Rotation axis. Must be either of `"X"`, `"Y"` or `"Z"`.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.UCPauliRotGate.base_class "qiskit.circuit.library.UCPauliRotGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.UCRXGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.UCRXGate.md
new file mode 100644
index 00000000000..4ea350c9129
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.UCRXGate.md
@@ -0,0 +1,121 @@
+---
+title: UCRXGate
+description: API reference for qiskit.circuit.library.UCRXGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.UCRXGate
+---
+
+# UCRXGate
+
+
+
+`qiskit.circuit.library.UCRXGate(angle_list)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/generalized_gates/ucrx.py "view source code")
+
+Bases: [`UCPauliRotGate`](qiskit.circuit.library.UCPauliRotGate "qiskit.circuit.library.generalized_gates.uc_pauli_rot.UCPauliRotGate")
+
+Uniformly controlled Pauli-X rotations.
+
+Implements the [`UCGate`](qiskit.circuit.library.UCGate "qiskit.circuit.library.UCGate") for the special case that all unitaries are Pauli-X rotations, $U_i = R_X(a_i)$ where $a_i \in \mathbb{R}$ is the rotation angle.
+
+**Parameters**
+
+**angle\_list** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – List of rotation angles $[a_0, ..., a_{2^{k-1}}]$.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.UCRXGate.base_class "qiskit.circuit.library.UCRXGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.UCRYGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.UCRYGate.md
new file mode 100644
index 00000000000..8a1b9e170dd
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.UCRYGate.md
@@ -0,0 +1,121 @@
+---
+title: UCRYGate
+description: API reference for qiskit.circuit.library.UCRYGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.UCRYGate
+---
+
+# UCRYGate
+
+
+
+`qiskit.circuit.library.UCRYGate(angle_list)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/generalized_gates/ucry.py "view source code")
+
+Bases: [`UCPauliRotGate`](qiskit.circuit.library.UCPauliRotGate "qiskit.circuit.library.generalized_gates.uc_pauli_rot.UCPauliRotGate")
+
+Uniformly controlled Pauli-Y rotations.
+
+Implements the [`UCGate`](qiskit.circuit.library.UCGate "qiskit.circuit.library.UCGate") for the special case that all unitaries are Pauli-Y rotations, $U_i = R_Y(a_i)$ where $a_i \in \mathbb{R}$ is the rotation angle.
+
+**Parameters**
+
+**angle\_list** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – List of rotation angles $[a_0, ..., a_{2^{k-1}}]$.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.UCRYGate.base_class "qiskit.circuit.library.UCRYGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.UCRZGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.UCRZGate.md
new file mode 100644
index 00000000000..68a6143098a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.UCRZGate.md
@@ -0,0 +1,121 @@
+---
+title: UCRZGate
+description: API reference for qiskit.circuit.library.UCRZGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.UCRZGate
+---
+
+# UCRZGate
+
+
+
+`qiskit.circuit.library.UCRZGate(angle_list)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/generalized_gates/ucrz.py "view source code")
+
+Bases: [`UCPauliRotGate`](qiskit.circuit.library.UCPauliRotGate "qiskit.circuit.library.generalized_gates.uc_pauli_rot.UCPauliRotGate")
+
+Uniformly controlled Pauli-Z rotations.
+
+Implements the [`UCGate`](qiskit.circuit.library.UCGate "qiskit.circuit.library.UCGate") for the special case that all unitaries are Pauli-Z rotations, $U_i = R_Z(a_i)$ where $a_i \in \mathbb{R}$ is the rotation angle.
+
+**Parameters**
+
+**angle\_list** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – List of rotation angles $[a_0, ..., a_{2^{k-1}}]$.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.UCRZGate.base_class "qiskit.circuit.library.UCRZGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.UGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.UGate.md
new file mode 100644
index 00000000000..422fe3c621d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.UGate.md
@@ -0,0 +1,187 @@
+---
+title: UGate
+description: API reference for qiskit.circuit.library.UGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.UGate
+---
+
+# UGate
+
+
+
+`qiskit.circuit.library.UGate(theta, phi, lam, label=None, *, duration=None, unit='dt')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/u.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+Generic single-qubit rotation gate with 3 Euler angles.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`u()`](qiskit.circuit.QuantumCircuit#u "qiskit.circuit.QuantumCircuit.u") method.
+
+**Circuit symbol:**
+
+```python
+ ┌──────────┐
+q_0: ┤ U(ϴ,φ,λ) ├
+ └──────────┘
+```
+
+**Matrix Representation:**
+
+$$
+\newcommand{\rotationangle}{\frac{\theta}{2}}
+
+U(\theta, \phi, \lambda) =
+\begin{pmatrix}
+ \cos\left(\rotationangle\right) & -e^{i\lambda}\sin\left(\rotationangle\right) \\
+ e^{i\phi}\sin\left(\rotationangle\right) & e^{i(\phi+\lambda)}\cos\left(\rotationangle\right)
+\end{pmatrix}
+$$
+
+
+ The matrix representation shown here is the same as in the [OpenQASM 3.0 specification](https://openqasm.com/language/gates.html#built-in-gates), which differs from the [OpenQASM 2.0 specification](https://doi.org/10.48550/arXiv.1707.03429) by a global phase of $e^{i(\phi+\lambda)/2}$.
+
+
+**Examples:**
+
+$$
+U\left(\theta, -\frac{\pi}{2}, \frac{\pi}{2}\right) = RX(\theta)
+$$
+
+$$
+U(\theta, 0, 0) = RY(\theta)
+$$
+
+Create new U gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.UGate.base_class "qiskit.circuit.library.UGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Return a (multi-)controlled-U gate.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of control qubits.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for the gate \[Default: None]
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – control state expressed as integer, string (e.g. ‘110’), or None. If None, use all 1s.
+
+**Returns**
+
+controlled version of this gate.
+
+**Return type**
+
+[ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted U gate.
+
+$U(\theta,\phi,\lambda)^{\dagger} =U(-\theta,-\lambda,-\phi)$)
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.UnitaryGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.UnitaryGate.md
new file mode 100644
index 00000000000..8b59d6c0cac
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.UnitaryGate.md
@@ -0,0 +1,209 @@
+---
+title: UnitaryGate
+description: API reference for qiskit.circuit.library.UnitaryGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.UnitaryGate
+---
+
+# UnitaryGate
+
+
+
+`qiskit.circuit.library.UnitaryGate(data, label=None, check_input=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/generalized_gates/unitary.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+Class quantum gates specified by a unitary matrix.
+
+**Example**
+
+We can create a unitary gate from a unitary matrix then add it to a quantum circuit. The matrix can also be directly applied to the quantum circuit, see [`QuantumCircuit.unitary()`](qiskit.circuit.QuantumCircuit#unitary "qiskit.circuit.QuantumCircuit.unitary").
+
+```python
+from qiskit import QuantumCircuit
+from qiskit.circuit.library import UnitaryGate
+
+matrix = [[0, 0, 0, 1],
+ [0, 0, 1, 0],
+ [1, 0, 0, 0],
+ [0, 1, 0, 0]]
+gate = UnitaryGate(matrix)
+
+circuit = QuantumCircuit(2)
+circuit.append(gate, [0, 1])
+```
+
+Create a gate from a numeric unitary matrix.
+
+**Parameters**
+
+* **data** ([*numpy.ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*Gate*](qiskit.circuit.Gate "qiskit.circuit.Gate") *| BaseOperator*) – Unitary operator.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Unitary name for backend \[Default: None].
+* **check\_input** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If set to `False` this asserts the input is known to be unitary and the checking to validate this will be skipped. This should only ever be used if you know the input is unitary, setting this to `False` and passing in a non-unitary matrix will result unexpected behavior and errors.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If input data is not an N-qubit unitary operator.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.UnitaryGate.base_class "qiskit.circuit.library.UnitaryGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return the adjoint of the unitary.
+
+### conjugate
+
+
+
+`conjugate()`
+
+Return the conjugate of the unitary.
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Return controlled version of gate.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of controls to add to gate (default is 1).
+* **label** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – Optional gate label.
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The control state in decimal or as a bit string (e.g. `"1011"`). If `None`, use `2**num_ctrl_qubits - 1`.
+
+**Returns**
+
+Controlled version of gate.
+
+**Return type**
+
+[ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+### inverse
+
+
+
+`inverse()`
+
+Return the adjoint of the unitary.
+
+### transpose
+
+
+
+`transpose()`
+
+Return the transpose of the unitary.
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Unitary gate parameter has to be an ndarray.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.UnitaryOverlap.md b/docs/api/qiskit/0.46/qiskit.circuit.library.UnitaryOverlap.md
new file mode 100644
index 00000000000..4fcb29c8820
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.UnitaryOverlap.md
@@ -0,0 +1,256 @@
+---
+title: UnitaryOverlap
+description: API reference for qiskit.circuit.library.UnitaryOverlap
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.UnitaryOverlap
+---
+
+# UnitaryOverlap
+
+
+
+`qiskit.circuit.library.UnitaryOverlap(unitary1, unitary2, prefix1='p1', prefix2='p2')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/overlap.py "view source code")
+
+Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+Circuit that returns the overlap between two unitaries $U_2^{\dag} U_1$.
+
+The input quantum circuits must represent unitary operations, since they must be invertible. If the inputs will have parameters, they are replaced by [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector")s with names “p1” (for circuit `unitary1`) and “p2” (for circuit `unitary_2`) in the output circuit.
+
+This circuit is usually employed in computing the fidelity:
+
+```python
+.. math::
+
+ \left|\langle 0| U_2^{\dag} U_1|0\rangle\right|^{2}
+```
+
+by computing the probability of being in the all-zeros bit-string, or equivalently, the expectation value of projector $|0\rangle\langle 0|$.
+
+Example:
+
+```python
+import numpy as np
+from qiskit.circuit.library import EfficientSU2, UnitaryOverlap
+from qiskit.primitives import Sampler
+
+# get two circuit to prepare states of which we comput the overlap
+circuit = EfficientSU2(2, reps=1)
+unitary1 = circuit.assign_parameters(np.random.random(circuit.num_parameters))
+unitary2 = circuit.assign_parameters(np.random.random(circuit.num_parameters))
+
+# create the overlap circuit
+overlap = UnitaryOverap(unitary1, unitary2)
+
+# sample from the overlap
+sampler = Sampler(options={"shots": 100})
+result = sampler.run(overlap).result()
+
+# the fidelity is the probability to measure 0
+fidelity = result.quasi_dists[0].get(0, 0)
+```
+
+**Parameters**
+
+* **unitary1** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")) – Unitary acting on the ket vector.
+* **unitary2** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")) – Unitary whose inverse operates on the bra vector.
+* **prefix1** – The name of the parameter vector associated to `unitary1`, if it is parameterized. Defaults to `"p1"`.
+* **prefix2** – The name of the parameter vector associated to `unitary2`, if it is parameterized. Defaults to `"p2"`.
+
+**Raises**
+
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Number of qubits in `unitary1` and `unitary2` does not match.
+* [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – Inputs contain measurements and/or resets.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 159`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.VBERippleCarryAdder.md b/docs/api/qiskit/0.46/qiskit.circuit.library.VBERippleCarryAdder.md
new file mode 100644
index 00000000000..95cb4888005
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.VBERippleCarryAdder.md
@@ -0,0 +1,255 @@
+---
+title: VBERippleCarryAdder
+description: API reference for qiskit.circuit.library.VBERippleCarryAdder
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.VBERippleCarryAdder
+---
+
+# VBERippleCarryAdder
+
+
+
+`qiskit.circuit.library.VBERippleCarryAdder(num_state_qubits, kind='full', name='VBERippleCarryAdder')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/arithmetic/adders/vbe_ripple_carry_adder.py "view source code")
+
+Bases: `Adder`
+
+The VBE ripple carry adder \[1].
+
+This circuit performs inplace addition of two equally-sized quantum registers. As an example, a classical adder circuit that performs full addition (i.e. including a carry-in bit) on two 2-qubit sized registers is as follows:
+
+```python
+ ┌────────┐ ┌───────────┐┌──────┐
+ cin_0: ┤0 ├───────────────────────┤0 ├┤0 ├
+ │ │ │ ││ │
+ a_0: ┤1 ├───────────────────────┤1 ├┤1 ├
+ │ │┌────────┐ ┌──────┐│ ││ Sum │
+ a_1: ┤ ├┤1 ├──■──┤1 ├┤ ├┤ ├
+ │ ││ │ │ │ ││ ││ │
+ b_0: ┤2 Carry ├┤ ├──┼──┤ ├┤2 Carry_dg ├┤2 ├
+ │ ││ │┌─┴─┐│ ││ │└──────┘
+ b_1: ┤ ├┤2 Carry ├┤ X ├┤2 Sum ├┤ ├────────
+ │ ││ │└───┘│ ││ │
+ cout_0: ┤ ├┤3 ├─────┤ ├┤ ├────────
+ │ ││ │ │ ││ │
+helper_0: ┤3 ├┤0 ├─────┤0 ├┤3 ├────────
+ └────────┘└────────┘ └──────┘└───────────┘
+```
+
+Here *Carry* and *Sum* gates correspond to the gates introduced in \[1]. *Carry\_dg* correspond to the inverse of the *Carry* gate. Note that in this implementation the input register qubits are ordered as all qubits from the first input register, followed by all qubits from the second input register. This is different ordering as compared to Figure 2 in \[1], which leads to a different drawing of the circuit.
+
+**References:**
+
+\[1] Vedral et al., Quantum Networks for Elementary Arithmetic Operations, 1995. [arXiv:quant-ph/9511018](https://arxiv.org/pdf/quant-ph/9511018.pdf)
+
+**Parameters**
+
+* **num\_state\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The size of the register.
+* **kind** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The kind of adder, can be `'full'` for a full adder, `'half'` for a half adder, or `'fixed'` for a fixed-sized adder. A full adder includes both carry-in and carry-out, a half only carry-out, and a fixed-sized adder neither carry-in nor carry-out.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the circuit.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `num_state_qubits` is lower than 1.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 159`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### num\_state\_qubits
+
+The number of state qubits, i.e. the number of bits in each input register.
+
+**Returns**
+
+The number of state qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.WeightedAdder.md b/docs/api/qiskit/0.46/qiskit.circuit.library.WeightedAdder.md
new file mode 100644
index 00000000000..e9f59f146c8
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.WeightedAdder.md
@@ -0,0 +1,251 @@
+---
+title: WeightedAdder
+description: API reference for qiskit.circuit.library.WeightedAdder
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.WeightedAdder
+---
+
+# WeightedAdder
+
+
+
+`qiskit.circuit.library.WeightedAdder(num_state_qubits=None, weights=None, name='adder')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/arithmetic/weighted_adder.py "view source code")
+
+Bases: `BlueprintCircuit`
+
+A circuit to compute the weighted sum of qubit registers.
+
+Given $n$ qubit basis states $q_0, \ldots, q_{n-1} \in \{0, 1\}$ and non-negative integer weights $\lambda_0, \ldots, \lambda_{n-1}$, this circuit performs the operation
+
+$$
+|q_0 \ldots q_{n-1}\rangle |0\rangle_s
+\mapsto |q_0 \ldots q_{n-1}\rangle |\sum_{j=0}^{n-1} \lambda_j q_j\rangle_s
+$$
+
+where $s$ is the number of sum qubits required. This can be computed as
+
+$$
+s = 1 + \left\lfloor \log_2\left( \sum_{j=0}^{n-1} \lambda_j \right) \right\rfloor
+$$
+
+or $s = 1$ if the sum of the weights is 0 (then the expression in the logarithm is invalid).
+
+For qubits in a circuit diagram, the first weight applies to the upper-most qubit. For an example where the state of 4 qubits is added into a sum register, the circuit can be schematically drawn as
+
+```python
+ ┌────────┐
+ state_0: ┤0 ├ | state_0 * weights[0]
+ │ │ |
+ state_1: ┤1 ├ | + state_1 * weights[1]
+ │ │ |
+ state_2: ┤2 ├ | + state_2 * weights[2]
+ │ │ |
+ state_3: ┤3 ├ | + state_3 * weights[3]
+ │ │
+ sum_0: ┤4 ├ |
+ │ Adder │ |
+ sum_1: ┤5 ├ | = sum_0 * 2^0 + sum_1 * 2^1 + sum_2 * 2^2
+ │ │ |
+ sum_2: ┤6 ├ |
+ │ │
+ carry_0: ┤7 ├
+ │ │
+ carry_1: ┤8 ├
+ │ │
+control_0: ┤9 ├
+ └────────┘
+```
+
+Computes the weighted sum controlled by state qubits.
+
+**Parameters**
+
+* **num\_state\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of state qubits.
+* **weights** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – List of weights, one for each state qubit. If none are provided they default to 1 for every qubit.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the circuit.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 159`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_carry\_qubits
+
+The number of carry qubits required to compute the sum.
+
+Note that this is not necessarily equal to the number of ancilla qubits, these can be queried using `num_ancilla_qubits`.
+
+**Returns**
+
+The number of carry qubits required to compute the sum.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_control\_qubits
+
+The number of additional control qubits required.
+
+Note that the total number of ancilla qubits can be obtained by calling the method `num_ancilla_qubits`.
+
+**Returns**
+
+The number of additional control qubits required (0 or 1).
+
+
+
+### num\_parameters
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### num\_state\_qubits
+
+The number of qubits to be summed.
+
+**Returns**
+
+The number of state qubits.
+
+
+
+### num\_sum\_qubits
+
+The number of sum qubits in the circuit.
+
+**Returns**
+
+The number of qubits needed to represent the weighted sum of the qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qregs
+
+`list[QuantumRegister]`
+
+A list of the quantum registers associated with the circuit.
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+
+
+### weights
+
+The weights for the qubit states.
+
+**Returns**
+
+The weight for the qubit states.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.XGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.XGate.md
new file mode 100644
index 00000000000..525f90e33cb
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.XGate.md
@@ -0,0 +1,191 @@
+---
+title: XGate
+description: API reference for qiskit.circuit.library.XGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.XGate
+---
+
+# XGate
+
+
+
+`qiskit.circuit.library.XGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/x.py "view source code")
+
+Bases: [`SingletonGate`](circuit_singleton#qiskit.circuit.singleton.SingletonGate "qiskit.circuit.singleton.SingletonGate")
+
+The single-qubit Pauli-X gate ($\sigma_x$).
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`x()`](qiskit.circuit.QuantumCircuit#x "qiskit.circuit.QuantumCircuit.x") method.
+
+**Matrix Representation:**
+
+$$
+X = \begin{pmatrix}
+ 0 & 1 \\
+ 1 & 0
+ \end{pmatrix}
+$$
+
+**Circuit symbol:**
+
+```python
+ ┌───┐
+q_0: ┤ X ├
+ └───┘
+```
+
+Equivalent to a $\pi$ radian rotation about the X axis.
+
+
+ A global phase difference exists between the definitions of $RX(\pi)$ and $X$.
+
+ $$
+ RX(\pi) = \begin{pmatrix}
+ 0 & -i \\
+ -i & 0
+ \end{pmatrix}
+ = -i X
+ $$
+
+
+The gate is equivalent to a classical bit flip.
+
+$$
+|0\rangle \rightarrow |1\rangle \\
+|1\rangle \rightarrow |0\rangle
+$$
+
+Create new X gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.XGate.base_class "qiskit.circuit.library.XGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Return a (multi-)controlled-X gate.
+
+One control returns a CX gate. Two controls returns a CCX gate.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of control qubits.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for the gate \[Default: None]
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – control state expressed as integer, string (e.g. ‘110’), or None. If None, use all 1s.
+
+**Returns**
+
+controlled version of this gate.
+
+**Return type**
+
+[ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted X gate (itself).
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.XOR.md b/docs/api/qiskit/0.46/qiskit.circuit.library.XOR.md
new file mode 100644
index 00000000000..b562f42ad8f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.XOR.md
@@ -0,0 +1,229 @@
+---
+title: XOR
+description: API reference for qiskit.circuit.library.XOR
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.XOR
+---
+
+# XOR
+
+
+
+`qiskit.circuit.library.XOR(num_qubits, amount=None, seed=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/boolean_logic/quantum_xor.py "view source code")
+
+Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+An n\_qubit circuit for bitwise xor-ing the input with some integer `amount`.
+
+The `amount` is xor-ed in bitstring form with the input.
+
+This circuit can also represent addition by `amount` over the finite field GF(2).
+
+Return a circuit implementing bitwise xor.
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the width of circuit.
+* **amount** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – the xor amount in decimal form.
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – random seed in case a random xor is requested.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the xor bitstring exceeds available qubits.
+
+**Reference Circuit:**
+
+
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 161`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.XXMinusYYGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.XXMinusYYGate.md
new file mode 100644
index 00000000000..2d02a88ff8a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.XXMinusYYGate.md
@@ -0,0 +1,193 @@
+---
+title: XXMinusYYGate
+description: API reference for qiskit.circuit.library.XXMinusYYGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.XXMinusYYGate
+---
+
+# XXMinusYYGate
+
+
+
+`qiskit.circuit.library.XXMinusYYGate(theta, beta=0, label='(XX-YY)', *, duration=None, unit='dt')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/xx_minus_yy.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+XX-YY interaction gate.
+
+A 2-qubit parameterized XX-YY interaction. Its action is to induce a coherent rotation by some angle between $|00\rangle$ and $|11\rangle$.
+
+**Circuit Symbol:**
+
+```python
+ ┌───────────────┐
+q_0: ┤0 ├
+ │ (XX-YY)(θ,β) │
+q_1: ┤1 ├
+ └───────────────┘
+```
+
+**Matrix Representation:**
+
+$$
+\newcommand{\rotationangle}{\frac{\theta}{2}}
+
+R_{XX-YY}(\theta, \beta) q_0, q_1 =
+ RZ_1(\beta) \cdot \exp\left(-i \frac{\theta}{2} \frac{XX-YY}{2}\right) \cdot RZ_1(-\beta) =
+ \begin{pmatrix}
+ \cos\left(\rotationangle\right) & 0 & 0 & -i\sin\left(\rotationangle\right)e^{-i\beta} \\
+ 0 & 1 & 0 & 0 \\
+ 0 & 0 & 1 & 0 \\
+ -i\sin\left(\rotationangle\right)e^{i\beta} & 0 & 0 & \cos\left(\rotationangle\right)
+ \end{pmatrix}
+$$
+
+
+ In Qiskit’s convention, higher qubit indices are more significant (little endian convention). In the above example we apply the gate on (q\_0, q\_1) which results in adding the (optional) phase defined by $\beta$ on q\_1. Instead, if we apply it on (q\_1, q\_0), the phase is added on q\_0. If $\beta$ is set to its default value of $0$, the gate is equivalent in big and little endian.
+
+ ```python
+ ┌───────────────┐
+ q_0: ┤1 ├
+ │ (XX-YY)(θ,β) │
+ q_1: ┤0 ├
+ └───────────────┘
+ ```
+
+ $$
+ \newcommand{\rotationangle}{\frac{\theta}{2}}
+
+ R_{XX-YY}(\theta, \beta) q_1, q_0 =
+ RZ_0(\beta) \cdot \exp\left(-i \frac{\theta}{2} \frac{XX-YY}{2}\right) \cdot RZ_0(-\beta) =
+ \begin{pmatrix}
+ \cos\left(\rotationangle\right) & 0 & 0 & -i\sin\left(\rotationangle\right)e^{i\beta} \\
+ 0 & 1 & 0 & 0 \\
+ 0 & 0 & 1 & 0 \\
+ -i\sin\left(\rotationangle\right)e^{-i\beta} & 0 & 0 & \cos\left(\rotationangle\right)
+ \end{pmatrix}
+ $$
+
+
+Create new XX-YY gate.
+
+**Parameters**
+
+* **theta** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The rotation angle.
+* **beta** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The phase angle.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The label of the gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.XXMinusYYGate.base_class "qiskit.circuit.library.XXMinusYYGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Inverse gate.
+
+### power
+
+
+
+`power(exponent)`
+
+Raise gate to a power.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.XXPlusYYGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.XXPlusYYGate.md
new file mode 100644
index 00000000000..43752c4f975
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.XXPlusYYGate.md
@@ -0,0 +1,193 @@
+---
+title: XXPlusYYGate
+description: API reference for qiskit.circuit.library.XXPlusYYGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.XXPlusYYGate
+---
+
+# XXPlusYYGate
+
+
+
+`qiskit.circuit.library.XXPlusYYGate(theta, beta=0, label='(XX+YY)', *, duration=None, unit='dt')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/xx_plus_yy.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+XX+YY interaction gate.
+
+A 2-qubit parameterized XX+YY interaction, also known as an XY gate. Its action is to induce a coherent rotation by some angle between $|01\rangle$ and $|10\rangle$.
+
+**Circuit Symbol:**
+
+```python
+ ┌───────────────┐
+q_0: ┤0 ├
+ │ (XX+YY)(θ,β) │
+q_1: ┤1 ├
+ └───────────────┘
+```
+
+**Matrix Representation:**
+
+$$
+\newcommand{\rotationangle}{\frac{\theta}{2}}
+
+R_{XX+YY}(\theta, \beta)\ q_0, q_1 =
+ RZ_0(-\beta) \cdot \exp\left(-i \frac{\theta}{2} \frac{XX+YY}{2}\right) \cdot RZ_0(\beta) =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & \cos\left(\rotationangle\right) & -i\sin\left(\rotationangle\right)e^{-i\beta} & 0 \\
+ 0 & -i\sin\left(\rotationangle\right)e^{i\beta} & \cos\left(\rotationangle\right) & 0 \\
+ 0 & 0 & 0 & 1
+ \end{pmatrix}
+$$
+
+
+ In Qiskit’s convention, higher qubit indices are more significant (little endian convention). In the above example we apply the gate on (q\_0, q\_1) which results in adding the (optional) phase defined by $\beta$ on q\_0. Instead, if we apply it on (q\_1, q\_0), the phase is added on q\_1. If $\beta$ is set to its default value of $0$, the gate is equivalent in big and little endian.
+
+ ```python
+ ┌───────────────┐
+ q_0: ┤1 ├
+ │ (XX+YY)(θ,β) │
+ q_1: ┤0 ├
+ └───────────────┘
+ ```
+
+
+$$
+\newcommand{\rotationangle}{\frac{\theta}{2}}
+
+R_{XX+YY}(\theta, \beta)\ q_0, q_1 =
+ RZ_1(-\beta) \cdot \exp\left(-i \frac{\theta}{2} \frac{XX+YY}{2}\right) \cdot RZ_1(\beta) =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & \cos\left(\rotationangle\right) & -i\sin\left(\rotationangle\right)e^{i\beta} & 0 \\
+ 0 & -i\sin\left(\rotationangle\right)e^{-i\beta} & \cos\left(\rotationangle\right) & 0 \\
+ 0 & 0 & 0 & 1
+ \end{pmatrix}
+$$
+
+Create new XX+YY gate.
+
+**Parameters**
+
+* **theta** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The rotation angle.
+* **beta** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The phase angle.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The label of the gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.XXPlusYYGate.base_class "qiskit.circuit.library.XXPlusYYGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverse XX+YY gate (i.e. with the negative rotation angle and same phase angle).
+
+### power
+
+
+
+`power(exponent)`
+
+Raise gate to a power.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.YGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.YGate.md
new file mode 100644
index 00000000000..cc275fc50c0
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.YGate.md
@@ -0,0 +1,191 @@
+---
+title: YGate
+description: API reference for qiskit.circuit.library.YGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.YGate
+---
+
+# YGate
+
+
+
+`qiskit.circuit.library.YGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/y.py "view source code")
+
+Bases: [`SingletonGate`](circuit_singleton#qiskit.circuit.singleton.SingletonGate "qiskit.circuit.singleton.SingletonGate")
+
+The single-qubit Pauli-Y gate ($\sigma_y$).
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`y()`](qiskit.circuit.QuantumCircuit#y "qiskit.circuit.QuantumCircuit.y") method.
+
+**Matrix Representation:**
+
+$$
+Y = \begin{pmatrix}
+ 0 & -i \\
+ i & 0
+ \end{pmatrix}
+$$
+
+**Circuit symbol:**
+
+```python
+ ┌───┐
+q_0: ┤ Y ├
+ └───┘
+```
+
+Equivalent to a $\pi$ radian rotation about the Y axis.
+
+
+ A global phase difference exists between the definitions of $RY(\pi)$ and $Y$.
+
+ $$
+ RY(\pi) = \begin{pmatrix}
+ 0 & -1 \\
+ 1 & 0
+ \end{pmatrix}
+ = -i Y
+ $$
+
+
+The gate is equivalent to a bit and phase flip.
+
+$$
+|0\rangle \rightarrow i|1\rangle \\
+|1\rangle \rightarrow -i|0\rangle
+$$
+
+Create new Y gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.YGate.base_class "qiskit.circuit.library.YGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Return a (multi-)controlled-Y gate.
+
+One control returns a CY gate.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of control qubits.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for the gate \[Default: None]
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – control state expressed as integer, string (e.g. ‘110’), or None. If None, use all 1s.
+
+**Returns**
+
+controlled version of this gate.
+
+**Return type**
+
+[ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted Y gate ($Y^{\dagger} = Y$)
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.ZFeatureMap.md b/docs/api/qiskit/0.46/qiskit.circuit.library.ZFeatureMap.md
new file mode 100644
index 00000000000..c7ba5263343
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.ZFeatureMap.md
@@ -0,0 +1,367 @@
+---
+title: ZFeatureMap
+description: API reference for qiskit.circuit.library.ZFeatureMap
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.ZFeatureMap
+---
+
+# ZFeatureMap
+
+
+
+`qiskit.circuit.library.ZFeatureMap(feature_dimension, reps=2, data_map_func=None, parameter_prefix='x', insert_barriers=False, name='ZFeatureMap')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/data_preparation/z_feature_map.py "view source code")
+
+Bases: [`PauliFeatureMap`](qiskit.circuit.library.PauliFeatureMap "qiskit.circuit.library.data_preparation.pauli_feature_map.PauliFeatureMap")
+
+The first order Pauli Z-evolution circuit.
+
+On 3 qubits and with 2 repetitions the circuit is represented by:
+
+```python
+┌───┐┌──────────────┐┌───┐┌──────────────┐
+┤ H ├┤ U1(2.0*x[0]) ├┤ H ├┤ U1(2.0*x[0]) ├
+├───┤├──────────────┤├───┤├──────────────┤
+┤ H ├┤ U1(2.0*x[1]) ├┤ H ├┤ U1(2.0*x[1]) ├
+├───┤├──────────────┤├───┤├──────────────┤
+┤ H ├┤ U1(2.0*x[2]) ├┤ H ├┤ U1(2.0*x[2]) ├
+└───┘└──────────────┘└───┘└──────────────┘
+```
+
+This is a sub-class of [`PauliFeatureMap`](qiskit.circuit.library.PauliFeatureMap "qiskit.circuit.library.PauliFeatureMap") where the Pauli strings are fixed as \[‘Z’]. As a result the first order expansion will be a circuit without entangling gates.
+
+**Examples**
+
+```python
+>>> prep = ZFeatureMap(3, reps=3, insert_barriers=True)
+>>> print(prep)
+ ┌───┐ ░ ┌──────────────┐ ░ ┌───┐ ░ ┌──────────────┐ ░ ┌───┐ ░ ┌──────────────┐
+q_0: ┤ H ├─░─┤ U1(2.0*x[0]) ├─░─┤ H ├─░─┤ U1(2.0*x[0]) ├─░─┤ H ├─░─┤ U1(2.0*x[0]) ├
+ ├───┤ ░ ├──────────────┤ ░ ├───┤ ░ ├──────────────┤ ░ ├───┤ ░ ├──────────────┤
+q_1: ┤ H ├─░─┤ U1(2.0*x[1]) ├─░─┤ H ├─░─┤ U1(2.0*x[1]) ├─░─┤ H ├─░─┤ U1(2.0*x[1]) ├
+ ├───┤ ░ ├──────────────┤ ░ ├───┤ ░ ├──────────────┤ ░ ├───┤ ░ ├──────────────┤
+q_2: ┤ H ├─░─┤ U1(2.0*x[2]) ├─░─┤ H ├─░─┤ U1(2.0*x[2]) ├─░─┤ H ├─░─┤ U1(2.0*x[2]) ├
+ └───┘ ░ └──────────────┘ ░ └───┘ ░ └──────────────┘ ░ └───┘ ░ └──────────────┘
+```
+
+```python
+>>> data_map = lambda x: x[0]*x[0] + 1 # note: input is an array
+>>> prep = ZFeatureMap(3, reps=1, data_map_func=data_map)
+>>> print(prep)
+ ┌───┐┌───────────────────────┐
+q_0: ┤ H ├┤ U1(2.0*x[0]**2 + 2.0) ├
+ ├───┤├───────────────────────┤
+q_1: ┤ H ├┤ U1(2.0*x[1]**2 + 2.0) ├
+ ├───┤├───────────────────────┤
+q_2: ┤ H ├┤ U1(2.0*x[2]**2 + 2.0) ├
+ └───┘└───────────────────────┘
+```
+
+```python
+>>> classifier = ZFeatureMap(3, reps=1) + RY(3, reps=1)
+>>> print(classifier)
+ ┌───┐┌──────────────┐┌──────────┐ ┌──────────┐
+q_0: ┤ H ├┤ U1(2.0*x[0]) ├┤ RY(θ[0]) ├─■──■─┤ RY(θ[3]) ├────────────
+ ├───┤├──────────────┤├──────────┤ │ │ └──────────┘┌──────────┐
+q_1: ┤ H ├┤ U1(2.0*x[1]) ├┤ RY(θ[1]) ├─■──┼──────■──────┤ RY(θ[4]) ├
+ ├───┤├──────────────┤├──────────┤ │ │ ├──────────┤
+q_2: ┤ H ├┤ U1(2.0*x[2]) ├┤ RY(θ[2]) ├────■──────■──────┤ RY(θ[5]) ├
+ └───┘└──────────────┘└──────────┘ └──────────┘
+```
+
+Create a new first-order Pauli-Z expansion circuit.
+
+**Parameters**
+
+* **feature\_dimension** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of features
+* **reps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of repeated circuits. Defaults to 2, has a minimum value of 1.
+* **data\_map\_func** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")*\[\[*[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")*],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – A mapping function for data x which can be supplied to override the default mapping from `self_product()`.
+* **parameter\_prefix** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The prefix used if default parameters are generated.
+* **insert\_barriers** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, barriers are inserted in between the evolution instructions and hadamard layers.
+
+## Attributes
+
+
+
+### alpha
+
+The Pauli rotation factor (alpha).
+
+**Returns**
+
+The Pauli rotation factor.
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+
+
+### entanglement
+
+Get the entanglement strategy.
+
+**Returns**
+
+The entanglement strategy, see `get_entangler_map()` for more detail on how the format is interpreted.
+
+
+
+### entanglement\_blocks
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### feature\_dimension
+
+Returns the feature dimension (which is equal to the number of qubits).
+
+**Returns**
+
+The feature dimension of this feature map.
+
+
+
+### flatten
+
+Returns whether the circuit is wrapped in nested gates/instructions or flattened.
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### initial\_state
+
+Return the initial state that is added in front of the n-local circuit.
+
+**Returns**
+
+The initial state.
+
+
+
+### insert\_barriers
+
+If barriers are inserted in between the layers or not.
+
+**Returns**
+
+`True`, if barriers are inserted in between the layers, `False` if not.
+
+
+
+### instances
+
+`= 163`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_layers
+
+Return the number of layers in the n-local circuit.
+
+**Returns**
+
+The number of layers in the circuit.
+
+
+
+### num\_parameters
+
+
+
+### num\_parameters\_settable
+
+The number of distinct parameters.
+
+
+
+### num\_qubits
+
+Returns the number of qubits in this circuit.
+
+**Returns**
+
+The number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### ordered\_parameters
+
+The parameters used in the underlying circuit.
+
+This includes float values and duplicates.
+
+**Examples**
+
+```python
+>>> # prepare circuit ...
+>>> print(nlocal)
+ ┌───────┐┌──────────┐┌──────────┐┌──────────┐
+q_0: ┤ Ry(1) ├┤ Ry(θ[1]) ├┤ Ry(θ[1]) ├┤ Ry(θ[3]) ├
+ └───────┘└──────────┘└──────────┘└──────────┘
+>>> nlocal.parameters
+{Parameter(θ[1]), Parameter(θ[3])}
+>>> nlocal.ordered_parameters
+[1, Parameter(θ[1]), Parameter(θ[1]), Parameter(θ[3])]
+```
+
+**Returns**
+
+The parameters objects used in the circuit.
+
+
+
+### parameter\_bounds
+
+The parameter bounds for the unbound parameters in the circuit.
+
+**Returns**
+
+A list of pairs indicating the bounds, as (lower, upper). None indicates an unbounded parameter in the corresponding direction. If `None` is returned, problem is fully unbounded.
+
+
+
+### parameters
+
+
+
+### paulis
+
+The Pauli strings used in the entanglement of the qubits.
+
+**Returns**
+
+The Pauli strings as list.
+
+
+
+### preferred\_init\_points
+
+The initial points for the parameters. Can be stored as initial guess in optimization.
+
+**Returns**
+
+The initial values for the parameters, or None, if none have been set.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qregs
+
+`list[QuantumRegister]`
+
+A list of the quantum registers associated with the circuit.
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+
+
+### reps
+
+The number of times rotation and entanglement block are repeated.
+
+**Returns**
+
+The number of repetitions.
+
+
+
+### rotation\_blocks
+
+The blocks in the rotation layers.
+
+**Returns**
+
+The blocks in the rotation layers.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.ZGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.ZGate.md
new file mode 100644
index 00000000000..fa9f5ea4899
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.ZGate.md
@@ -0,0 +1,199 @@
+---
+title: ZGate
+description: API reference for qiskit.circuit.library.ZGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.ZGate
+---
+
+# ZGate
+
+
+
+`qiskit.circuit.library.ZGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/z.py "view source code")
+
+Bases: [`SingletonGate`](circuit_singleton#qiskit.circuit.singleton.SingletonGate "qiskit.circuit.singleton.SingletonGate")
+
+The single-qubit Pauli-Z gate ($\sigma_z$).
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`z()`](qiskit.circuit.QuantumCircuit#z "qiskit.circuit.QuantumCircuit.z") method.
+
+**Matrix Representation:**
+
+$$
+Z = \begin{pmatrix}
+ 1 & 0 \\
+ 0 & -1
+ \end{pmatrix}
+$$
+
+**Circuit symbol:**
+
+```python
+ ┌───┐
+q_0: ┤ Z ├
+ └───┘
+```
+
+Equivalent to a $\pi$ radian rotation about the Z axis.
+
+
+ A global phase difference exists between the definitions of $RZ(\pi)$ and $Z$.
+
+ $$
+ RZ(\pi) = \begin{pmatrix}
+ -i & 0 \\
+ 0 & i
+ \end{pmatrix}
+ = -i Z
+ $$
+
+
+The gate is equivalent to a phase flip.
+
+$$
+|0\rangle \rightarrow |0\rangle \\
+|1\rangle \rightarrow -|1\rangle
+$$
+
+Create new Z gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.ZGate.base_class "qiskit.circuit.library.ZGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Return a (multi-)controlled-Z gate.
+
+One control returns a CZ gate.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of control qubits.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – An optional label for the gate \[Default: None]
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or None*) – control state expressed as integer, string (e.g. ‘110’), or None. If None, use all 1s.
+
+**Returns**
+
+controlled version of this gate.
+
+**Return type**
+
+[ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+### inverse
+
+
+
+`inverse()`
+
+Return inverted Z gate (itself).
+
+### power
+
+
+
+`power(exponent)`
+
+Raise gate to a power.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.ZZFeatureMap.md b/docs/api/qiskit/0.46/qiskit.circuit.library.ZZFeatureMap.md
new file mode 100644
index 00000000000..ab8b04d733d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.ZZFeatureMap.md
@@ -0,0 +1,372 @@
+---
+title: ZZFeatureMap
+description: API reference for qiskit.circuit.library.ZZFeatureMap
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.ZZFeatureMap
+---
+
+# ZZFeatureMap
+
+
+
+`qiskit.circuit.library.ZZFeatureMap(feature_dimension, reps=2, entanglement='full', data_map_func=None, parameter_prefix='x', insert_barriers=False, name='ZZFeatureMap')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/data_preparation/zz_feature_map.py "view source code")
+
+Bases: [`PauliFeatureMap`](qiskit.circuit.library.PauliFeatureMap "qiskit.circuit.library.data_preparation.pauli_feature_map.PauliFeatureMap")
+
+Second-order Pauli-Z evolution circuit.
+
+For 3 qubits and 1 repetition and linear entanglement the circuit is represented by:
+
+```python
+┌───┐┌─────────────────┐
+┤ H ├┤ U1(2.0*φ(x[0])) ├──■────────────────────────────■────────────────────────────────────
+├───┤├─────────────────┤┌─┴─┐┌──────────────────────┐┌─┴─┐
+┤ H ├┤ U1(2.0*φ(x[1])) ├┤ X ├┤ U1(2.0*φ(x[0],x[1])) ├┤ X ├──■────────────────────────────■──
+├───┤├─────────────────┤└───┘└──────────────────────┘└───┘┌─┴─┐┌──────────────────────┐┌─┴─┐
+┤ H ├┤ U1(2.0*φ(x[2])) ├──────────────────────────────────┤ X ├┤ U1(2.0*φ(x[1],x[2])) ├┤ X ├
+└───┘└─────────────────┘ └───┘└──────────────────────┘└───┘
+```
+
+where $\varphi$ is a classical non-linear function, which defaults to $\varphi(x) = x$ if and $\varphi(x,y) = (\pi - x)(\pi - y)$.
+
+**Examples**
+
+```python
+>>> from qiskit.circuit.library import ZZFeatureMap
+>>> prep = ZZFeatureMap(2, reps=1)
+>>> print(prep)
+ ┌───┐┌──────────────┐
+q_0: ┤ H ├┤ U1(2.0*x[0]) ├──■───────────────────────────────────────■──
+ ├───┤├──────────────┤┌─┴─┐┌─────────────────────────────────┐┌─┴─┐
+q_1: ┤ H ├┤ U1(2.0*x[1]) ├┤ X ├┤ U1(2.0*(pi - x[0])*(pi - x[1])) ├┤ X ├
+ └───┘└──────────────┘└───┘└─────────────────────────────────┘└───┘
+```
+
+```python
+>>> from qiskit.circuit.library import EfficientSU2
+>>> classifier = ZZFeatureMap(3) + EfficientSU2(3)
+>>> classifier.num_parameters
+15
+>>> classifier.parameters # 'x' for the data preparation, 'θ' for the SU2 parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(θ[0]),
+ ParameterVectorElement(θ[1]), ParameterVectorElement(θ[2]),
+ ParameterVectorElement(θ[3]), ParameterVectorElement(θ[4]),
+ ParameterVectorElement(θ[5]), ParameterVectorElement(θ[6]),
+ ParameterVectorElement(θ[7]), ParameterVectorElement(θ[8]),
+ ParameterVectorElement(θ[9]), ParameterVectorElement(θ[10]),
+ ParameterVectorElement(θ[11]), ParameterVectorElement(θ[12]),
+ ParameterVectorElement(θ[13]), ParameterVectorElement(θ[14]),
+ ParameterVectorElement(θ[15]), ParameterVectorElement(θ[16]),
+ ParameterVectorElement(θ[17]), ParameterVectorElement(θ[18]),
+ ParameterVectorElement(θ[19]), ParameterVectorElement(θ[20]),
+ ParameterVectorElement(θ[21]), ParameterVectorElement(θ[22]),
+ ParameterVectorElement(θ[23])
+])
+>>> classifier.count_ops()
+OrderedDict([('ZZFeatureMap', 1), ('EfficientSU2', 1)])
+```
+
+Create a new second-order Pauli-Z expansion.
+
+**Parameters**
+
+* **feature\_dimension** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of features.
+* **reps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of repeated circuits, has a min. value of 1.
+* **entanglement** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]] |* [*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")*\[\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*],* [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]]*) – Specifies the entanglement structure. Refer to [`NLocal`](qiskit.circuit.library.NLocal "qiskit.circuit.library.NLocal") for detail.
+* **data\_map\_func** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")*\[\[*[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")*],* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – A mapping function for data x.
+* **parameter\_prefix** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The prefix used if default parameters are generated.
+* **insert\_barriers** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, barriers are inserted in between the evolution instructions and hadamard layers.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If the feature dimension is smaller than 2.
+
+## Attributes
+
+
+
+### alpha
+
+The Pauli rotation factor (alpha).
+
+**Returns**
+
+The Pauli rotation factor.
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+
+
+### entanglement
+
+Get the entanglement strategy.
+
+**Returns**
+
+The entanglement strategy, see `get_entangler_map()` for more detail on how the format is interpreted.
+
+
+
+### entanglement\_blocks
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### feature\_dimension
+
+Returns the feature dimension (which is equal to the number of qubits).
+
+**Returns**
+
+The feature dimension of this feature map.
+
+
+
+### flatten
+
+Returns whether the circuit is wrapped in nested gates/instructions or flattened.
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### initial\_state
+
+Return the initial state that is added in front of the n-local circuit.
+
+**Returns**
+
+The initial state.
+
+
+
+### insert\_barriers
+
+If barriers are inserted in between the layers or not.
+
+**Returns**
+
+`True`, if barriers are inserted in between the layers, `False` if not.
+
+
+
+### instances
+
+`= 163`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_layers
+
+Return the number of layers in the n-local circuit.
+
+**Returns**
+
+The number of layers in the circuit.
+
+
+
+### num\_parameters
+
+
+
+### num\_parameters\_settable
+
+The number of distinct parameters.
+
+
+
+### num\_qubits
+
+Returns the number of qubits in this circuit.
+
+**Returns**
+
+The number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### ordered\_parameters
+
+The parameters used in the underlying circuit.
+
+This includes float values and duplicates.
+
+**Examples**
+
+```python
+>>> # prepare circuit ...
+>>> print(nlocal)
+ ┌───────┐┌──────────┐┌──────────┐┌──────────┐
+q_0: ┤ Ry(1) ├┤ Ry(θ[1]) ├┤ Ry(θ[1]) ├┤ Ry(θ[3]) ├
+ └───────┘└──────────┘└──────────┘└──────────┘
+>>> nlocal.parameters
+{Parameter(θ[1]), Parameter(θ[3])}
+>>> nlocal.ordered_parameters
+[1, Parameter(θ[1]), Parameter(θ[1]), Parameter(θ[3])]
+```
+
+**Returns**
+
+The parameters objects used in the circuit.
+
+
+
+### parameter\_bounds
+
+The parameter bounds for the unbound parameters in the circuit.
+
+**Returns**
+
+A list of pairs indicating the bounds, as (lower, upper). None indicates an unbounded parameter in the corresponding direction. If `None` is returned, problem is fully unbounded.
+
+
+
+### parameters
+
+
+
+### paulis
+
+The Pauli strings used in the entanglement of the qubits.
+
+**Returns**
+
+The Pauli strings as list.
+
+
+
+### preferred\_init\_points
+
+The initial points for the parameters. Can be stored as initial guess in optimization.
+
+**Returns**
+
+The initial values for the parameters, or None, if none have been set.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qregs
+
+`list[QuantumRegister]`
+
+A list of the quantum registers associated with the circuit.
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+
+
+### reps
+
+The number of times rotation and entanglement block are repeated.
+
+**Returns**
+
+The number of repetitions.
+
+
+
+### rotation\_blocks
+
+The blocks in the rotation layers.
+
+**Returns**
+
+The blocks in the rotation layers.
+
diff --git a/docs/api/qiskit/0.46/qiskit.circuit.library.iSwapGate.md b/docs/api/qiskit/0.46/qiskit.circuit.library.iSwapGate.md
new file mode 100644
index 00000000000..877beaf25b4
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.circuit.library.iSwapGate.md
@@ -0,0 +1,180 @@
+---
+title: iSwapGate
+description: API reference for qiskit.circuit.library.iSwapGate
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.circuit.library.iSwapGate
+---
+
+# iSwapGate
+
+
+
+`qiskit.circuit.library.iSwapGate(*args, _force_mutable=False, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/circuit/library/standard_gates/iswap.py "view source code")
+
+Bases: [`SingletonGate`](circuit_singleton#qiskit.circuit.singleton.SingletonGate "qiskit.circuit.singleton.SingletonGate")
+
+iSWAP gate.
+
+A 2-qubit XX+YY interaction. This is a Clifford and symmetric gate. Its action is to swap two qubit states and phase the $|01\rangle$ and $|10\rangle$ amplitudes by i.
+
+Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`iswap()`](qiskit.circuit.QuantumCircuit#iswap "qiskit.circuit.QuantumCircuit.iswap") method.
+
+**Circuit Symbol:**
+
+```python
+q_0: ─⨂─
+ │
+q_1: ─⨂─
+```
+
+**Reference Implementation:**
+
+```python
+ ┌───┐┌───┐ ┌───┐
+q_0: ┤ S ├┤ H ├──■──┤ X ├─────
+ ├───┤└───┘┌─┴─┐└─┬─┘┌───┐
+q_1: ┤ S ├─────┤ X ├──■──┤ H ├
+ └───┘ └───┘ └───┘
+```
+
+**Matrix Representation:**
+
+$$
+iSWAP = R_{XX+YY}\left(-\frac{\pi}{2}\right)
+ = \exp\left(i \frac{\pi}{4} \left(X{\otimes}X+Y{\otimes}Y\right)\right) =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & 0 & i & 0 \\
+ 0 & i & 0 & 0 \\
+ 0 & 0 & 0 & 1
+ \end{pmatrix}
+$$
+
+This gate is equivalent to a SWAP up to a diagonal.
+
+$$
+iSWAP =
+ \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & 0 & 1 & 0 \\
+ 0 & 1 & 0 & 0 \\
+ 0 & 0 & 0 & 1
+ \end{pmatrix}
+. \begin{pmatrix}
+ 1 & 0 & 0 & 0 \\
+ 0 & i & 0 & 0 \\
+ 0 & 0 & i & 0 \\
+ 0 & 0 & 0 & 1
+ \end{pmatrix}
+$$
+
+Create new iSwap gate.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.iSwapGate.base_class "qiskit.circuit.library.iSwapGate.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### power
+
+
+
+`power(exponent)`
+
+Raise gate to a power.
+
diff --git a/docs/api/qiskit/0.46/qiskit.dagcircuit.DAGCircuit.md b/docs/api/qiskit/0.46/qiskit.dagcircuit.DAGCircuit.md
new file mode 100644
index 00000000000..19f6d1074ea
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.dagcircuit.DAGCircuit.md
@@ -0,0 +1,1026 @@
+---
+title: DAGCircuit
+description: API reference for qiskit.dagcircuit.DAGCircuit
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.dagcircuit.DAGCircuit
+---
+
+# DAGCircuit
+
+
+
+`qiskit.dagcircuit.DAGCircuit`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/dagcircuit/dagcircuit.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Quantum circuit as a directed acyclic graph.
+
+There are 3 types of nodes in the graph: inputs, outputs, and operations. The nodes are connected by directed edges that correspond to qubits and bits.
+
+Create an empty circuit.
+
+## Attributes
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+**The custom pulse definition of a given gate is of the form**
+
+\{‘gate\_name’: \{(qubits, params): schedule}}
+
+
+
+### global\_phase
+
+Return the global phase of the circuit.
+
+
+
+### node\_counter
+
+Returns the number of nodes in the dag.
+
+
+
+### wires
+
+Return a list of the wires in order.
+
+## Methods
+
+### add\_calibration
+
+
+
+`add_calibration(gate, qubits, schedule, params=None)`
+
+Register a low-level, custom pulse definition for the given gate.
+
+**Parameters**
+
+* **gate** (*Union\[*[*Gate*](qiskit.circuit.Gate "qiskit.circuit.Gate")*,* [*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – Gate information.
+* **qubits** (*Union\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*, Tuple\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]]*) – List of qubits to be measured.
+* **schedule** ([*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule")) – Schedule information.
+* **params** (*Optional\[List\[Union\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*]]]*) – A list of parameters.
+
+**Raises**
+
+[**Exception**](https://docs.python.org/3/library/exceptions.html#Exception "(in Python v3.12)") – if the gate is of type string and params is None.
+
+### add\_clbits
+
+
+
+`add_clbits(clbits)`
+
+Add individual clbit wires.
+
+### add\_creg
+
+
+
+`add_creg(creg)`
+
+Add all wires in a classical register.
+
+### add\_qreg
+
+
+
+`add_qreg(qreg)`
+
+Add all wires in a quantum register.
+
+### add\_qubits
+
+
+
+`add_qubits(qubits)`
+
+Add individual qubit wires.
+
+### ancestors
+
+
+
+`ancestors(node)`
+
+Returns set of the ancestors of a node as DAGOpNodes and DAGInNodes.
+
+### apply\_operation\_back
+
+
+
+`apply_operation_back(op, qargs=(), cargs=(), *, check=True)`
+
+Apply an operation to the output of the circuit.
+
+**Parameters**
+
+* **op** ([*qiskit.circuit.Operation*](qiskit.circuit.Operation "qiskit.circuit.Operation")) – the operation associated with the DAG node
+* **qargs** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]*) – qubits that op will be applied to
+* **cargs** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*Clbit*](qiskit.circuit.Clbit "qiskit.circuit.Clbit")*]*) – cbits that op will be applied to
+* **check** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If `True` (default), this function will enforce that the [`DAGCircuit`](#qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") data-structure invariants are maintained (all `qargs` are [`Qubit`](qiskit.circuit.Qubit "qiskit.circuit.Qubit")s, all are in the DAG, etc). If `False`, the caller *must* uphold these invariants itself, but the cost of several checks will be skipped. This is most useful when building a new DAG from a source of known-good nodes.
+
+**Returns**
+
+the node for the op that was added to the dag
+
+**Return type**
+
+[DAGOpNode](qiskit.dagcircuit.DAGOpNode "qiskit.dagcircuit.DAGOpNode")
+
+**Raises**
+
+[**DAGCircuitError**](dagcircuit#qiskit.dagcircuit.DAGCircuitError "qiskit.dagcircuit.DAGCircuitError") – if a leaf node is connected to multiple outputs
+
+### apply\_operation\_front
+
+
+
+`apply_operation_front(op, qargs=(), cargs=(), *, check=True)`
+
+Apply an operation to the input of the circuit.
+
+**Parameters**
+
+* **op** ([*qiskit.circuit.Operation*](qiskit.circuit.Operation "qiskit.circuit.Operation")) – the operation associated with the DAG node
+* **qargs** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]*) – qubits that op will be applied to
+* **cargs** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*Clbit*](qiskit.circuit.Clbit "qiskit.circuit.Clbit")*]*) – cbits that op will be applied to
+* **check** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If `True` (default), this function will enforce that the [`DAGCircuit`](#qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") data-structure invariants are maintained (all `qargs` are [`Qubit`](qiskit.circuit.Qubit "qiskit.circuit.Qubit")s, all are in the DAG, etc). If `False`, the caller *must* uphold these invariants itself, but the cost of several checks will be skipped. This is most useful when building a new DAG from a source of known-good nodes.
+
+**Returns**
+
+the node for the op that was added to the dag
+
+**Return type**
+
+[DAGOpNode](qiskit.dagcircuit.DAGOpNode "qiskit.dagcircuit.DAGOpNode")
+
+**Raises**
+
+[**DAGCircuitError**](dagcircuit#qiskit.dagcircuit.DAGCircuitError "qiskit.dagcircuit.DAGCircuitError") – if initial nodes connected to multiple out edges
+
+### bfs\_successors
+
+
+
+`bfs_successors(node)`
+
+Returns an iterator of tuples of (DAGNode, \[DAGNodes]) where the DAGNode is the current node and \[DAGNode] is its successors in BFS order.
+
+### classical\_predecessors
+
+
+
+`classical_predecessors(node)`
+
+Returns iterator of the predecessors of a node that are connected by a classical edge as DAGOpNodes and DAGInNodes.
+
+### classical\_successors
+
+
+
+`classical_successors(node)`
+
+Returns iterator of the successors of a node that are connected by a classical edge as DAGOpNodes and DAGInNodes.
+
+### collect\_1q\_runs
+
+
+
+`collect_1q_runs()`
+
+Return a set of non-conditional runs of 1q “op” nodes.
+
+### collect\_2q\_runs
+
+
+
+`collect_2q_runs()`
+
+Return a set of non-conditional runs of 2q “op” nodes.
+
+### collect\_runs
+
+
+
+`collect_runs(namelist)`
+
+Return a set of non-conditional runs of “op” nodes with the given names.
+
+For example, “… h q\[0]; cx q\[0],q\[1]; cx q\[0],q\[1]; h q\[1]; ..” would produce the tuple of cx nodes as an element of the set returned from a call to collect\_runs(\[“cx”]). If instead the cx nodes were “cx q\[0],q\[1]; cx q\[1],q\[0];”, the method would still return the pair in a tuple. The namelist can contain names that are not in the circuit’s basis.
+
+Nodes must have only one successor to continue the run.
+
+### compose
+
+
+
+`compose(other, qubits=None, clbits=None, front=False, inplace=True)`
+
+Compose the `other` circuit onto the output of this circuit.
+
+A subset of input wires of `other` are mapped to a subset of output wires of this circuit.
+
+`other` can be narrower or of equal width to `self`.
+
+**Parameters**
+
+* **other** ([*DAGCircuit*](#qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – circuit to compose with self
+* **qubits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – qubits of self to compose onto.
+* **clbits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Clbit*](qiskit.circuit.Clbit "qiskit.circuit.Clbit")*|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – clbits of self to compose onto.
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, front composition will be performed (not implemented yet)
+* **inplace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, modify the object. Otherwise return composed circuit.
+
+**Returns**
+
+the composed dag (returns None if inplace==True).
+
+**Return type**
+
+[DAGCircuit](#qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+[**DAGCircuitError**](dagcircuit#qiskit.dagcircuit.DAGCircuitError "qiskit.dagcircuit.DAGCircuitError") – if `other` is wider or there are duplicate edge mappings.
+
+### copy\_empty\_like
+
+
+
+`copy_empty_like()`
+
+Return a copy of self with the same structure but empty.
+
+**That structure includes:**
+
+* name and other metadata
+* global phase
+* duration
+* all the qubits and clbits, including the registers.
+
+**Returns**
+
+An empty copy of self.
+
+**Return type**
+
+[DAGCircuit](#qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+### count\_ops
+
+
+
+`count_ops(*, recurse=True)`
+
+Count the occurrences of operation names.
+
+**Parameters**
+
+**recurse** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if `True` (default), then recurse into control-flow operations. In all cases, this counts only the number of times the operation appears in any possible block; both branches of if-elses are counted, and for- and while-loop blocks are only counted once.
+
+**Returns**
+
+a mapping of operation names to the number of times it appears.
+
+**Return type**
+
+Mapping\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)"), [int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")]
+
+### count\_ops\_longest\_path
+
+
+
+`count_ops_longest_path()`
+
+Count the occurrences of operation names on the longest path.
+
+Returns a dictionary of counts keyed on the operation name.
+
+### depth
+
+
+
+`depth(*, recurse=False)`
+
+Return the circuit depth. If there is control flow present, this count may only be an estimate, as the complete control-flow path cannot be statically known.
+
+**Parameters**
+
+**recurse** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if `True`, then recurse into control-flow operations. For loops with known-length iterators are counted as if the loop had been manually unrolled (*i.e.* with each iteration of the loop body written out explicitly). If-else blocks take the longer case of the two branches. While loops are counted as if the loop body runs once only. Defaults to `False` and raises [`DAGCircuitError`](dagcircuit#qiskit.dagcircuit.DAGCircuitError "qiskit.dagcircuit.DAGCircuitError") if any control flow is present, to avoid silently returning a nonsensical number.
+
+**Returns**
+
+the circuit depth
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+**Raises**
+
+* [**DAGCircuitError**](dagcircuit#qiskit.dagcircuit.DAGCircuitError "qiskit.dagcircuit.DAGCircuitError") – if not a directed acyclic graph
+* [**DAGCircuitError**](dagcircuit#qiskit.dagcircuit.DAGCircuitError "qiskit.dagcircuit.DAGCircuitError") – if unknown control flow is present in a recursive call, or any control flow is present in a non-recursive call.
+
+### descendants
+
+
+
+`descendants(node)`
+
+Returns set of the descendants of a node as DAGOpNodes and DAGOutNodes.
+
+### draw
+
+
+
+`draw(scale=0.7, filename=None, style='color')`
+
+Draws the dag circuit.
+
+This function needs [Graphviz](https://www.graphviz.org/) to be installed. Graphviz is not a python package and can’t be pip installed (the `graphviz` package on PyPI is a Python interface library for Graphviz and does not actually install Graphviz). You can refer to [the Graphviz documentation](https://www.graphviz.org/download/) on how to install it.
+
+**Parameters**
+
+* **scale** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – scaling factor
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – file path to save image to (format inferred from name)
+* **style** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – ‘plain’: B\&W graph; ‘color’ (default): color input/output/op nodes
+
+**Returns**
+
+if in Jupyter notebook and not saving to file, otherwise None.
+
+**Return type**
+
+Ipython.display.Image
+
+### edges
+
+
+
+`edges(nodes=None)`
+
+Iterator for edge values and source and dest node
+
+This works by returning the output edges from the specified nodes. If no nodes are specified all edges from the graph are returned.
+
+**Parameters**
+
+**nodes** ([*DAGOpNode*](qiskit.dagcircuit.DAGOpNode "qiskit.dagcircuit.DAGOpNode")*,* [*DAGInNode*](qiskit.dagcircuit.DAGInNode "qiskit.dagcircuit.DAGInNode")*, or* [*DAGOutNode*](qiskit.dagcircuit.DAGOutNode "qiskit.dagcircuit.DAGOutNode")*|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*(*[*DAGOpNode*](qiskit.dagcircuit.DAGOpNode "qiskit.dagcircuit.DAGOpNode")*,* [*DAGInNode*](qiskit.dagcircuit.DAGInNode "qiskit.dagcircuit.DAGInNode")*, or* [*DAGOutNode*](qiskit.dagcircuit.DAGOutNode "qiskit.dagcircuit.DAGOutNode")) – Either a list of nodes or a single input node. If none is specified, all edges are returned from the graph.
+
+**Yields**
+
+*edge* –
+
+**the edge in the same format as out\_edges the tuple**
+
+(source node, destination node, edge data)
+
+### find\_bit
+
+
+
+`find_bit(bit)`
+
+Finds locations in the circuit, by mapping the Qubit and Clbit to positional index BitLocations is defined as: BitLocations = namedtuple(“BitLocations”, (“index”, “registers”))
+
+**Parameters**
+
+**bit** ([*Bit*](qiskit.circuit.Bit "qiskit.circuit.Bit")) – The bit to locate.
+
+**Returns**
+
+**A 2-tuple. The first element (`index`)**
+
+contains the index at which the `Bit` can be found (in either `qubits`, `clbits`, depending on its type). The second element (`registers`) is a list of `(register, index)` pairs with an entry for each `Register` in the circuit which contains the `Bit` (and the index in the `Register` at which it can be found).
+
+**Return type**
+
+namedtuple(int, List\[Tuple(Register, int)])
+
+**Raises:**
+
+DAGCircuitError: If the supplied `Bit` was of an unknown type. DAGCircuitError: If the supplied `Bit` could not be found on the circuit.
+
+### front\_layer
+
+
+
+`front_layer()`
+
+Return a list of op nodes in the first layer of this dag.
+
+### gate\_nodes
+
+
+
+`gate_nodes()`
+
+Get the list of gate nodes in the dag.
+
+**Returns**
+
+the list of DAGOpNodes that represent gates.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[DAGOpNode](qiskit.dagcircuit.DAGOpNode "qiskit.dagcircuit.DAGOpNode")]
+
+### has\_calibration\_for
+
+
+
+`has_calibration_for(node)`
+
+Return True if the dag has a calibration defined for the node operation. In this case, the operation does not need to be translated to the device basis.
+
+### idle\_wires
+
+
+
+`idle_wires(ignore=None)`
+
+Return idle wires.
+
+**Parameters**
+
+**ignore** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*(*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*)*) – List of node names to ignore. Default: \[]
+
+**Yields**
+
+*Bit* – Bit in idle wire.
+
+**Raises**
+
+[**DAGCircuitError**](dagcircuit#qiskit.dagcircuit.DAGCircuitError "qiskit.dagcircuit.DAGCircuitError") – If the DAG is invalid
+
+### is\_predecessor
+
+
+
+`is_predecessor(node, node_pred)`
+
+Checks if a second node is in the predecessors of node.
+
+### is\_successor
+
+
+
+`is_successor(node, node_succ)`
+
+Checks if a second node is in the successors of node.
+
+### layers
+
+
+
+`layers()`
+
+Yield a shallow view on a layer of this DAGCircuit for all d layers of this circuit.
+
+A layer is a circuit whose gates act on disjoint qubits, i.e., a layer has depth 1. The total number of layers equals the circuit depth d. The layers are indexed from 0 to d-1 with the earliest layer at index 0. The layers are constructed using a greedy algorithm. Each returned layer is a dict containing \{“graph”: circuit graph, “partition”: list of qubit lists}.
+
+The returned layer contains new (but semantically equivalent) DAGOpNodes, DAGInNodes, and DAGOutNodes. These are not the same as nodes of the original dag, but are equivalent via DAGNode.semantic\_eq(node1, node2).
+
+TODO: Gates that use the same cbits will end up in different layers as this is currently implemented. This may not be the desired behavior.
+
+### longest\_path
+
+
+
+`longest_path()`
+
+Returns the longest path in the dag as a list of DAGOpNodes, DAGInNodes, and DAGOutNodes.
+
+### multi\_qubit\_ops
+
+
+
+`multi_qubit_ops()`
+
+Get list of 3+ qubit operations. Ignore directives like snapshot and barrier.
+
+### multigraph\_layers
+
+
+
+`multigraph_layers()`
+
+Yield layers of the multigraph.
+
+### named\_nodes
+
+
+
+`named_nodes(*names)`
+
+Get the set of “op” nodes with the given name.
+
+### node
+
+
+
+`node(node_id)`
+
+Get the node in the dag.
+
+**Parameters**
+
+**node\_id** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Node identifier.
+
+**Returns**
+
+the node.
+
+**Return type**
+
+node
+
+### nodes
+
+
+
+`nodes()`
+
+Iterator for node values.
+
+**Yields**
+
+*node* – the node.
+
+### nodes\_on\_wire
+
+
+
+`nodes_on_wire(wire, only_ops=False)`
+
+Iterator for nodes that affect a given wire.
+
+**Parameters**
+
+* **wire** ([*Bit*](qiskit.circuit.Bit "qiskit.circuit.Bit")) – the wire to be looked at.
+* **only\_ops** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – True if only the ops nodes are wanted; otherwise, all nodes are returned.
+
+**Yields**
+
+*Iterator* – the successive nodes on the given wire
+
+**Raises**
+
+[**DAGCircuitError**](dagcircuit#qiskit.dagcircuit.DAGCircuitError "qiskit.dagcircuit.DAGCircuitError") – if the given wire doesn’t exist in the DAG
+
+### num\_clbits
+
+
+
+`num_clbits()`
+
+Return the total number of classical bits used by the circuit.
+
+### num\_qubits
+
+
+
+`num_qubits()`
+
+Return the total number of qubits used by the circuit. num\_qubits() replaces former use of width(). DAGCircuit.width() now returns qubits + clbits for consistency with Circuit.width() \[qiskit-terra #2564].
+
+### num\_tensor\_factors
+
+
+
+`num_tensor_factors()`
+
+Compute how many components the circuit can decompose into.
+
+### op\_nodes
+
+
+
+`op_nodes(op=None, include_directives=True)`
+
+Get the list of “op” nodes in the dag.
+
+**Parameters**
+
+* **op** ([*Type*](circuit_classical#qiskit.circuit.classical.types.Type "qiskit.circuit.classical.types.Type")) – [`qiskit.circuit.Operation`](qiskit.circuit.Operation "qiskit.circuit.Operation") subclass op nodes to return. If None, return all op nodes.
+* **include\_directives** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – include barrier, snapshot etc.
+
+**Returns**
+
+the list of node ids containing the given op.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[DAGOpNode](qiskit.dagcircuit.DAGOpNode "qiskit.dagcircuit.DAGOpNode")]
+
+### predecessors
+
+
+
+`predecessors(node)`
+
+Returns iterator of the predecessors of a node as DAGOpNodes and DAGInNodes.
+
+### properties
+
+
+
+`properties()`
+
+Return a dictionary of circuit properties.
+
+### quantum\_causal\_cone
+
+
+
+`quantum_causal_cone(qubit)`
+
+Returns causal cone of a qubit.
+
+A qubit’s causal cone is the set of qubits that can influence the output of that qubit through interactions, whether through multi-qubit gates or operations. Knowing the causal cone of a qubit can be useful when debugging faulty circuits, as it can help identify which wire(s) may be causing the problem.
+
+This method does not consider any classical data dependency in the `DAGCircuit`, classical bit wires are ignored for the purposes of building the causal cone.
+
+**Parameters**
+
+**qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")) – The output qubit for which we want to find the causal cone.
+
+**Returns**
+
+The set of qubits whose interactions affect `qubit`.
+
+**Return type**
+
+Set\[[Qubit](qiskit.circuit.Qubit "qiskit.circuit.Qubit")]
+
+### quantum\_predecessors
+
+
+
+`quantum_predecessors(node)`
+
+Returns iterator of the predecessors of a node that are connected by a quantum edge as DAGOpNodes and DAGInNodes.
+
+### quantum\_successors
+
+
+
+`quantum_successors(node)`
+
+Returns iterator of the successors of a node that are connected by a quantum edge as Opnodes and DAGOutNodes.
+
+### remove\_all\_ops\_named
+
+
+
+`remove_all_ops_named(opname)`
+
+Remove all operation nodes with the given name.
+
+### remove\_ancestors\_of
+
+
+
+`remove_ancestors_of(node)`
+
+Remove all of the ancestor operation nodes of node.
+
+### remove\_clbits
+
+
+
+`remove_clbits(*clbits)`
+
+Remove classical bits from the circuit. All bits MUST be idle. Any registers with references to at least one of the specified bits will also be removed.
+
+**Parameters**
+
+**clbits** (*List\[*[*Clbit*](qiskit.circuit.Clbit "qiskit.circuit.Clbit")*]*) – The bits to remove.
+
+**Raises**
+
+[**DAGCircuitError**](dagcircuit#qiskit.dagcircuit.DAGCircuitError "qiskit.dagcircuit.DAGCircuitError") – a clbit is not a [`Clbit`](qiskit.circuit.Clbit "qiskit.circuit.Clbit"), is not in the circuit, or is not idle.
+
+### remove\_cregs
+
+
+
+`remove_cregs(*cregs)`
+
+Remove classical registers from the circuit, leaving underlying bits in place.
+
+**Raises**
+
+* [**DAGCircuitError**](dagcircuit#qiskit.dagcircuit.DAGCircuitError "qiskit.dagcircuit.DAGCircuitError") – a creg is not a ClassicalRegister, or is not in
+* **the circuit.** –
+
+### remove\_descendants\_of
+
+
+
+`remove_descendants_of(node)`
+
+Remove all of the descendant operation nodes of node.
+
+### remove\_nonancestors\_of
+
+
+
+`remove_nonancestors_of(node)`
+
+Remove all of the non-ancestors operation nodes of node.
+
+### remove\_nondescendants\_of
+
+
+
+`remove_nondescendants_of(node)`
+
+Remove all of the non-descendants operation nodes of node.
+
+### remove\_op\_node
+
+
+
+`remove_op_node(node)`
+
+Remove an operation node n.
+
+Add edges from predecessors to successors.
+
+### remove\_qregs
+
+
+
+`remove_qregs(*qregs)`
+
+Remove classical registers from the circuit, leaving underlying bits in place.
+
+**Raises**
+
+* [**DAGCircuitError**](dagcircuit#qiskit.dagcircuit.DAGCircuitError "qiskit.dagcircuit.DAGCircuitError") – a qreg is not a QuantumRegister, or is not in
+* **the circuit.** –
+
+### remove\_qubits
+
+
+
+`remove_qubits(*qubits)`
+
+Remove quantum bits from the circuit. All bits MUST be idle. Any registers with references to at least one of the specified bits will also be removed.
+
+**Parameters**
+
+**qubits** (*List\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]*) – The bits to remove.
+
+**Raises**
+
+[**DAGCircuitError**](dagcircuit#qiskit.dagcircuit.DAGCircuitError "qiskit.dagcircuit.DAGCircuitError") – a qubit is not a [`Qubit`](qiskit.circuit.Qubit "qiskit.circuit.Qubit"), is not in the circuit, or is not idle.
+
+### replace\_block\_with\_op
+
+
+
+`replace_block_with_op(node_block, op, wire_pos_map, cycle_check=True)`
+
+Replace a block of nodes with a single node.
+
+This is used to consolidate a block of DAGOpNodes into a single operation. A typical example is a block of gates being consolidated into a single `UnitaryGate` representing the unitary matrix of the block.
+
+**Parameters**
+
+* **node\_block** (*List\[*[*DAGNode*](qiskit.dagcircuit.DAGNode "qiskit.dagcircuit.DAGNode")*]*) – A list of dag nodes that represents the node block to be replaced
+* **op** ([*qiskit.circuit.Operation*](qiskit.circuit.Operation "qiskit.circuit.Operation")) – The operation to replace the block with
+* **wire\_pos\_map** (*Dict\[*[*Bit*](qiskit.circuit.Bit "qiskit.circuit.Bit")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The dictionary mapping the bits to their positions in the output `qargs` or `cargs`. This is necessary to reconstruct the arg order over multiple gates in the combined single op node. If a [`Bit`](qiskit.circuit.Bit "qiskit.circuit.Bit") is not in the dictionary, it will not be added to the args; this can be useful when dealing with control-flow operations that have inherent bits in their `condition` or `target` fields.
+* **cycle\_check** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – When set to True this method will check that replacing the provided `node_block` with a single node would introduce a cycle (which would invalidate the `DAGCircuit`) and will raise a `DAGCircuitError` if a cycle would be introduced. This checking comes with a run time penalty. If you can guarantee that your input `node_block` is a contiguous block and won’t introduce a cycle when it’s contracted to a single node, this can be set to `False` to improve the runtime performance of this method.
+
+**Raises**
+
+[**DAGCircuitError**](dagcircuit#qiskit.dagcircuit.DAGCircuitError "qiskit.dagcircuit.DAGCircuitError") – if `cycle_check` is set to `True` and replacing the specified block introduces a cycle or if `node_block` is empty.
+
+**Returns**
+
+The op node that replaces the block.
+
+**Return type**
+
+[DAGOpNode](qiskit.dagcircuit.DAGOpNode "qiskit.dagcircuit.DAGOpNode")
+
+### reverse\_ops
+
+
+
+`reverse_ops()`
+
+Reverse the operations in the `self` circuit.
+
+**Returns**
+
+the reversed dag.
+
+**Return type**
+
+[DAGCircuit](#qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+### separable\_circuits
+
+
+
+`separable_circuits(remove_idle_qubits=False)`
+
+Decompose the circuit into sets of qubits with no gates connecting them.
+
+**Parameters**
+
+**remove\_idle\_qubits** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Flag denoting whether to remove idle qubits from the separated circuits. If `False`, each output circuit will contain the same number of qubits as `self`.
+
+**Returns**
+
+**The circuits resulting from separating `self` into sets**
+
+of disconnected qubits
+
+**Return type**
+
+List\[[DAGCircuit](#qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")]
+
+Each [`DAGCircuit`](#qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") instance returned by this method will contain the same number of clbits as `self`. The global phase information in `self` will not be maintained in the subcircuits returned by this method.
+
+### serial\_layers
+
+
+
+`serial_layers()`
+
+Yield a layer for all gates of this circuit.
+
+A serial layer is a circuit with one gate. The layers have the same structure as in layers().
+
+### size
+
+
+
+`size(*, recurse=False)`
+
+Return the number of operations. If there is control flow present, this count may only be an estimate, as the complete control-flow path cannot be statically known.
+
+**Parameters**
+
+**recurse** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if `True`, then recurse into control-flow operations. For loops with known-length iterators are counted unrolled. If-else blocks sum both of the two branches. While loops are counted as if the loop body runs once only. Defaults to `False` and raises [`DAGCircuitError`](dagcircuit#qiskit.dagcircuit.DAGCircuitError "qiskit.dagcircuit.DAGCircuitError") if any control flow is present, to avoid silently returning a mostly meaningless number.
+
+**Returns**
+
+the circuit size
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+**Raises**
+
+[**DAGCircuitError**](dagcircuit#qiskit.dagcircuit.DAGCircuitError "qiskit.dagcircuit.DAGCircuitError") – if an unknown [`ControlFlowOp`](qiskit.circuit.ControlFlowOp "qiskit.circuit.ControlFlowOp") is present in a call with `recurse=True`, or any control flow is present in a non-recursive call.
+
+### substitute\_node
+
+
+
+`substitute_node(node, op, inplace=False, propagate_condition=True)`
+
+Replace an DAGOpNode with a single operation. qargs, cargs and conditions for the new operation will be inferred from the node to be replaced. The new operation will be checked to match the shape of the replaced operation.
+
+**Parameters**
+
+* **node** ([*DAGOpNode*](qiskit.dagcircuit.DAGOpNode "qiskit.dagcircuit.DAGOpNode")) – Node to be replaced
+* **op** ([*qiskit.circuit.Operation*](qiskit.circuit.Operation "qiskit.circuit.Operation")) – The [`qiskit.circuit.Operation`](qiskit.circuit.Operation "qiskit.circuit.Operation") instance to be added to the DAG
+* **inplace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Optional, default False. If True, existing DAG node will be modified to include op. Otherwise, a new DAG node will be used.
+* **propagate\_condition** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Optional, default True. If True, a condition on the `node` to be replaced will be applied to the new `op`. This is the legacy behaviour. If either node is a control-flow operation, this will be ignored. If the `op` already has a condition, [`DAGCircuitError`](dagcircuit#qiskit.dagcircuit.DAGCircuitError "qiskit.dagcircuit.DAGCircuitError") is raised.
+
+**Returns**
+
+the new node containing the added operation.
+
+**Return type**
+
+[DAGOpNode](qiskit.dagcircuit.DAGOpNode "qiskit.dagcircuit.DAGOpNode")
+
+**Raises**
+
+* [**DAGCircuitError**](dagcircuit#qiskit.dagcircuit.DAGCircuitError "qiskit.dagcircuit.DAGCircuitError") – If replacement operation was incompatible with
+* **location**\*\* of \*\***target node.** –
+
+### substitute\_node\_with\_dag
+
+
+
+`substitute_node_with_dag(node, input_dag, wires=None, propagate_condition=True)`
+
+Replace one node with dag.
+
+**Parameters**
+
+* **node** ([*DAGOpNode*](qiskit.dagcircuit.DAGOpNode "qiskit.dagcircuit.DAGOpNode")) – node to substitute
+* **input\_dag** ([*DAGCircuit*](#qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – circuit that will substitute the node
+* **wires** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Bit*](qiskit.circuit.Bit "qiskit.circuit.Bit")*] | Dict\[*[*Bit*](qiskit.circuit.Bit "qiskit.circuit.Bit")*,* [*Bit*](qiskit.circuit.Bit "qiskit.circuit.Bit")*]*) – gives an order for (qu)bits in the input circuit. If a list, then the bits refer to those in the `input_dag`, and the order gets matched to the node wires by qargs first, then cargs, then conditions. If a dictionary, then a mapping of bits in the `input_dag` to those that the `node` acts on.
+* **propagate\_condition** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If `True` (default), then any `condition` attribute on the operation within `node` is propagated to each node in the `input_dag`. If `False`, then the `input_dag` is assumed to faithfully implement suitable conditional logic already. This is ignored for [`ControlFlowOp`](qiskit.circuit.ControlFlowOp "qiskit.circuit.ControlFlowOp")s (i.e. treated as if it is `False`); replacements of those must already fulfil the same conditional logic or this function would be close to useless for them.
+
+**Returns**
+
+maps node IDs from input\_dag to their new node incarnations in self.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+**Raises**
+
+[**DAGCircuitError**](dagcircuit#qiskit.dagcircuit.DAGCircuitError "qiskit.dagcircuit.DAGCircuitError") – if met with unexpected predecessor/successors
+
+### successors
+
+
+
+`successors(node)`
+
+Returns iterator of the successors of a node as DAGOpNodes and DAGOutNodes.
+
+### swap\_nodes
+
+
+
+`swap_nodes(node1, node2)`
+
+Swap connected nodes e.g. due to commutation.
+
+**Parameters**
+
+* **node1** (*OpNode*) – predecessor node
+* **node2** (*OpNode*) – successor node
+
+**Raises**
+
+[**DAGCircuitError**](dagcircuit#qiskit.dagcircuit.DAGCircuitError "qiskit.dagcircuit.DAGCircuitError") – if either node is not an OpNode or nodes are not connected
+
+### topological\_nodes
+
+
+
+`topological_nodes(key=None)`
+
+Yield nodes in topological order.
+
+**Parameters**
+
+**key** (*Callable*) – A callable which will take a DAGNode object and return a string sort key. If not specified the `sort_key` attribute will be used as the sort key for each node.
+
+**Returns**
+
+node in topological order
+
+**Return type**
+
+generator([DAGOpNode](qiskit.dagcircuit.DAGOpNode "qiskit.dagcircuit.DAGOpNode"), [DAGInNode](qiskit.dagcircuit.DAGInNode "qiskit.dagcircuit.DAGInNode"), or [DAGOutNode](qiskit.dagcircuit.DAGOutNode "qiskit.dagcircuit.DAGOutNode"))
+
+### topological\_op\_nodes
+
+
+
+`topological_op_nodes(key=None)`
+
+Yield op nodes in topological order.
+
+Allowed to pass in specific key to break ties in top order
+
+**Parameters**
+
+**key** (*Callable*) – A callable which will take a DAGNode object and return a string sort key. If not specified the `sort_key` attribute will be used as the sort key for each node.
+
+**Returns**
+
+op node in topological order
+
+**Return type**
+
+generator([DAGOpNode](qiskit.dagcircuit.DAGOpNode "qiskit.dagcircuit.DAGOpNode"))
+
+### two\_qubit\_ops
+
+
+
+`two_qubit_ops()`
+
+Get list of 2 qubit operations. Ignore directives like snapshot and barrier.
+
+### width
+
+
+
+`width()`
+
+Return the total number of qubits + clbits used by the circuit. This function formerly returned the number of qubits by the calculation return len(self.\_wires) - self.num\_clbits() but was changed by issue #2564 to return number of qubits + clbits with the new function DAGCircuit.num\_qubits replacing the former semantic of DAGCircuit.width().
+
diff --git a/docs/api/qiskit/0.46/qiskit.dagcircuit.DAGDepNode.md b/docs/api/qiskit/0.46/qiskit.dagcircuit.DAGDepNode.md
new file mode 100644
index 00000000000..de783da0179
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.dagcircuit.DAGDepNode.md
@@ -0,0 +1,117 @@
+---
+title: DAGDepNode
+description: API reference for qiskit.dagcircuit.DAGDepNode
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.dagcircuit.DAGDepNode
+---
+
+# DAGDepNode
+
+
+
+`qiskit.dagcircuit.DAGDepNode(type=None, op=None, name=None, qargs=(), cargs=(), successors=None, predecessors=None, reachable=None, matchedwith=None, successorstovisit=None, isblocked=None, qindices=None, cindices=None, nid=-1)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/dagcircuit/dagdepnode.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Object to represent the information at a node in the DAGDependency().
+
+It is used as the return value from \*\_nodes() functions and can be supplied to functions that take a node.
+
+## Attributes
+
+
+
+### type
+
+
+
+### name
+
+
+
+### cargs
+
+
+
+### sort\_key
+
+
+
+### node\_id
+
+
+
+### successors
+
+
+
+### predecessors
+
+
+
+### reachable
+
+
+
+### matchedwith
+
+
+
+### isblocked
+
+
+
+### successorstovisit
+
+
+
+### qindices
+
+
+
+### cindices
+
+
+
+### op
+
+Returns the Instruction object corresponding to the op for the node, else None
+
+
+
+### qargs
+
+Returns list of Qubit, else an empty list.
+
+## Methods
+
+### copy
+
+
+
+`copy()`
+
+Function to copy a DAGDepNode object. :returns: a copy of a DAGDepNode object. :rtype: DAGDepNode
+
+### semantic\_eq
+
+
+
+`static semantic_eq(node1, node2)`
+
+Check if DAG nodes are considered equivalent, e.g., as a node\_match for nx.is\_isomorphic.
+
+**Parameters**
+
+* **node1** ([*DAGDepNode*](#qiskit.dagcircuit.DAGDepNode "qiskit.dagcircuit.DAGDepNode")) – A node to compare.
+* **node2** ([*DAGDepNode*](#qiskit.dagcircuit.DAGDepNode "qiskit.dagcircuit.DAGDepNode")) – The other node to compare.
+
+**Returns**
+
+If node1 == node2
+
+**Return type**
+
+[Bool](circuit_classical#qiskit.circuit.classical.types.Bool "qiskit.circuit.classical.types.Bool")
+
diff --git a/docs/api/qiskit/0.46/qiskit.dagcircuit.DAGDependency.md b/docs/api/qiskit/0.46/qiskit.dagcircuit.DAGDependency.md
new file mode 100644
index 00000000000..dfa87146fa4
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.dagcircuit.DAGDependency.md
@@ -0,0 +1,390 @@
+---
+title: DAGDependency
+description: API reference for qiskit.dagcircuit.DAGDependency
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.dagcircuit.DAGDependency
+---
+
+# DAGDependency
+
+
+
+`qiskit.dagcircuit.DAGDependency`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/dagcircuit/dagdependency.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Object to represent a quantum circuit as a Directed Acyclic Graph (DAG) via operation dependencies (i.e. lack of commutation).
+
+The nodes in the graph are operations represented by quantum gates. The edges correspond to non-commutation between two operations (i.e. a dependency). A directed edge from node A to node B means that operation A does not commute with operation B. The object’s methods allow circuits to be constructed.
+
+The nodes in the graph have the following attributes: ‘operation’, ‘successors’, ‘predecessors’.
+
+**Example:**
+
+Bell circuit with no measurement.
+
+```python
+ ┌───┐
+qr_0: ┤ H ├──■──
+ └───┘┌─┴─┐
+qr_1: ─────┤ X ├
+ └───┘
+```
+
+The dependency DAG for the above circuit is represented by two nodes. The first one corresponds to Hadamard gate, the second one to the CNOT gate as the gates do not commute there is an edge between the two nodes.
+
+**Reference:**
+
+\[1] Iten, R., Moyard, R., Metger, T., Sutter, D. and Woerner, S., 2020. Exact and practical pattern matching for quantum circuit optimization. [arXiv:1909.05270](https://arxiv.org/abs/1909.05270)
+
+Create an empty DAGDependency.
+
+## Attributes
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`.
+
+
+
+### global\_phase
+
+Return the global phase of the circuit.
+
+## Methods
+
+### add\_clbits
+
+
+
+`add_clbits(clbits)`
+
+Add individual clbit wires.
+
+### add\_creg
+
+
+
+`add_creg(creg)`
+
+Add clbits in a classical register.
+
+### add\_op\_node
+
+
+
+`add_op_node(operation, qargs, cargs)`
+
+Add a DAGDepNode to the graph and update the edges.
+
+**Parameters**
+
+* **operation** ([*qiskit.circuit.Operation*](qiskit.circuit.Operation "qiskit.circuit.Operation")) – operation as a quantum gate
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]*) – list of qubits on which the operation acts
+* **cargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Clbit*](qiskit.circuit.Clbit "qiskit.circuit.Clbit")*]*) – list of classical wires to attach to
+
+### add\_qreg
+
+
+
+`add_qreg(qreg)`
+
+Add qubits in a quantum register.
+
+### add\_qubits
+
+
+
+`add_qubits(qubits)`
+
+Add individual qubit wires.
+
+### copy
+
+
+
+`copy()`
+
+Function to copy a DAGDependency object. :returns: a copy of a DAGDependency object. :rtype: DAGDependency
+
+### depth
+
+
+
+`depth()`
+
+Return the circuit depth. :returns: the circuit depth :rtype: int
+
+### direct\_predecessors
+
+
+
+`direct_predecessors(node_id)`
+
+Direct predecessors id of a given node as sorted list.
+
+**Parameters**
+
+**node\_id** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – label of considered node.
+
+**Returns**
+
+direct predecessors id as a sorted list
+
+**Return type**
+
+List
+
+### direct\_successors
+
+
+
+`direct_successors(node_id)`
+
+Direct successors id of a given node as sorted list.
+
+**Parameters**
+
+**node\_id** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – label of considered node.
+
+**Returns**
+
+direct successors id as a sorted list
+
+**Return type**
+
+List
+
+### draw
+
+
+
+`draw(scale=0.7, filename=None, style='color')`
+
+Draws the DAGDependency graph.
+
+This function needs pydot \<[https://github.com/erocarrera/pydot](https://github.com/erocarrera/pydot)>, which in turn needs Graphviz \<[https://www.graphviz.org/](https://www.graphviz.org/)>\` to be installed.
+
+**Parameters**
+
+* **scale** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – scaling factor
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – file path to save image to (format inferred from name)
+* **style** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – ‘plain’: B\&W graph ‘color’ (default): color input/output/op nodes
+
+**Returns**
+
+if in Jupyter notebook and not saving to file, otherwise None.
+
+**Return type**
+
+Ipython.display.Image
+
+### get\_all\_edges
+
+
+
+`get_all_edges()`
+
+Enumeration of all edges.
+
+**Returns**
+
+corresponding to the label.
+
+**Return type**
+
+List
+
+### get\_edges
+
+
+
+`get_edges(src_id, dest_id)`
+
+Edge enumeration between two nodes through method get\_all\_edge\_data.
+
+**Parameters**
+
+* **src\_id** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – label of the first node.
+* **dest\_id** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – label of the second node.
+
+**Returns**
+
+corresponding to all edges between the two nodes.
+
+**Return type**
+
+List
+
+### get\_in\_edges
+
+
+
+`get_in_edges(node_id)`
+
+Enumeration of all incoming edges for a given node.
+
+**Parameters**
+
+**node\_id** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – label of considered node.
+
+**Returns**
+
+corresponding incoming edges data.
+
+**Return type**
+
+List
+
+### get\_node
+
+
+
+`get_node(node_id)`
+
+**Parameters**
+
+**node\_id** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – label of considered node.
+
+**Returns**
+
+corresponding to the label.
+
+**Return type**
+
+node
+
+### get\_nodes
+
+
+
+`get_nodes()`
+
+**Returns**
+
+iterator over all the nodes.
+
+**Return type**
+
+generator([dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)"))
+
+### get\_out\_edges
+
+
+
+`get_out_edges(node_id)`
+
+Enumeration of all outgoing edges for a given node.
+
+**Parameters**
+
+**node\_id** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – label of considered node.
+
+**Returns**
+
+corresponding outgoing edges data.
+
+**Return type**
+
+List
+
+### predecessors
+
+
+
+`predecessors(node_id)`
+
+Predecessors id of a given node as sorted list.
+
+**Parameters**
+
+**node\_id** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – label of considered node.
+
+**Returns**
+
+all predecessors id as a sorted list
+
+**Return type**
+
+List
+
+### replace\_block\_with\_op
+
+
+
+`replace_block_with_op(node_block, op, wire_pos_map, cycle_check=True)`
+
+Replace a block of nodes with a single node.
+
+This is used to consolidate a block of DAGDepNodes into a single operation. A typical example is a block of CX and SWAP gates consolidated into a LinearFunction. This function is an adaptation of a similar function from DAGCircuit.
+
+It is important that such consolidation preserves commutativity assumptions present in DAGDependency. As an example, suppose that every node in a block \[A, B, C, D] commutes with another node E. Let F be the consolidated node, F = A o B o C o D. Then F also commutes with E, and thus the result of replacing \[A, B, C, D] by F results in a valid DAGDependency. That is, any deduction about commutativity in consolidated DAGDependency is correct. On the other hand, suppose that at least one of the nodes, say B, does not commute with E. Then the consolidated DAGDependency would imply that F does not commute with E. Even though F and E may actually commute, it is still safe to assume that they do not. That is, the current implementation of consolidation may lead to suboptimal but not to incorrect results.
+
+**Parameters**
+
+* **node\_block** (*List\[*[*DAGDepNode*](qiskit.dagcircuit.DAGDepNode "qiskit.dagcircuit.DAGDepNode")*]*) – A list of dag nodes that represents the node block to be replaced
+* **op** ([*qiskit.circuit.Operation*](qiskit.circuit.Operation "qiskit.circuit.Operation")) – The operation to replace the block with
+* **wire\_pos\_map** (*Dict\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The dictionary mapping the qarg to the position. This is necessary to reconstruct the qarg order over multiple gates in the combined single op node.
+* **cycle\_check** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – When set to True this method will check that replacing the provided `node_block` with a single node would introduce a cycle (which would invalidate the `DAGDependency`) and will raise a `DAGDependencyError` if a cycle would be introduced. This checking comes with a run time penalty. If you can guarantee that your input `node_block` is a contiguous block and won’t introduce a cycle when it’s contracted to a single node, this can be set to `False` to improve the runtime performance of this method.
+
+**Raises**
+
+[**DAGDependencyError**](dagcircuit#qiskit.dagcircuit.DAGDependencyError "qiskit.dagcircuit.DAGDependencyError") – if `cycle_check` is set to `True` and replacing the specified block introduces a cycle or if `node_block` is empty.
+
+### size
+
+
+
+`size()`
+
+Returns the number of gates in the circuit
+
+### successors
+
+
+
+`successors(node_id)`
+
+Successors id of a given node as sorted list.
+
+**Parameters**
+
+**node\_id** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – label of considered node.
+
+**Returns**
+
+all successors id as a sorted list
+
+**Return type**
+
+List
+
+### to\_retworkx
+
+
+
+`to_retworkx()`
+
+Returns the DAGDependency in retworkx format.
+
+### topological\_nodes
+
+
+
+`topological_nodes()`
+
+Yield nodes in topological order.
+
+**Returns**
+
+node in topological order.
+
+**Return type**
+
+generator([DAGNode](qiskit.dagcircuit.DAGNode "qiskit.dagcircuit.DAGNode"))
+
diff --git a/docs/api/qiskit/0.46/qiskit.dagcircuit.DAGInNode.md b/docs/api/qiskit/0.46/qiskit.dagcircuit.DAGInNode.md
new file mode 100644
index 00000000000..b8d32d60992
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.dagcircuit.DAGInNode.md
@@ -0,0 +1,55 @@
+---
+title: DAGInNode
+description: API reference for qiskit.dagcircuit.DAGInNode
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.dagcircuit.DAGInNode
+---
+
+# DAGInNode
+
+
+
+`qiskit.dagcircuit.DAGInNode(wire)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/dagcircuit/dagnode.py "view source code")
+
+Bases: [`DAGNode`](qiskit.dagcircuit.DAGNode "qiskit.dagcircuit.dagnode.DAGNode")
+
+Object to represent an incoming wire node in the DAGCircuit.
+
+Create an incoming node
+
+## Attributes
+
+
+
+### wire
+
+
+
+### sort\_key
+
+## Methods
+
+### semantic\_eq
+
+
+
+`static semantic_eq(node1, node2, bit_indices1, bit_indices2)`
+
+Check if DAG nodes are considered equivalent, e.g., as a node\_match for [`rustworkx.is_isomorphic_node_match()`](https://www.rustworkx.org/apiref/rustworkx.is_isomorphic_node_match.html#rustworkx.is_isomorphic_node_match "(in rustworkx v0.14.0)").
+
+**Parameters**
+
+* **node1** ([*DAGOpNode*](qiskit.dagcircuit.DAGOpNode "qiskit.dagcircuit.DAGOpNode")*,* [*DAGInNode*](#qiskit.dagcircuit.DAGInNode "qiskit.dagcircuit.DAGInNode")*,* [*DAGOutNode*](qiskit.dagcircuit.DAGOutNode "qiskit.dagcircuit.DAGOutNode")) – A node to compare.
+* **node2** ([*DAGOpNode*](qiskit.dagcircuit.DAGOpNode "qiskit.dagcircuit.DAGOpNode")*,* [*DAGInNode*](#qiskit.dagcircuit.DAGInNode "qiskit.dagcircuit.DAGInNode")*,* [*DAGOutNode*](qiskit.dagcircuit.DAGOutNode "qiskit.dagcircuit.DAGOutNode")) – The other node to compare.
+* **bit\_indices1** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – Dictionary mapping Bit instances to their index within the circuit containing node1
+* **bit\_indices2** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – Dictionary mapping Bit instances to their index within the circuit containing node2
+
+**Returns**
+
+If node1 == node2
+
+**Return type**
+
+[Bool](circuit_classical#qiskit.circuit.classical.types.Bool "qiskit.circuit.classical.types.Bool")
+
diff --git a/docs/api/qiskit/0.46/qiskit.dagcircuit.DAGNode.md b/docs/api/qiskit/0.46/qiskit.dagcircuit.DAGNode.md
new file mode 100644
index 00000000000..5f8679d3a11
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.dagcircuit.DAGNode.md
@@ -0,0 +1,45 @@
+---
+title: DAGNode
+description: API reference for qiskit.dagcircuit.DAGNode
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.dagcircuit.DAGNode
+---
+
+# DAGNode
+
+
+
+`qiskit.dagcircuit.DAGNode(nid=-1)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/dagcircuit/dagnode.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Parent class for DAGOpNode, DAGInNode, and DAGOutNode.
+
+Create a node
+
+## Methods
+
+### semantic\_eq
+
+
+
+`static semantic_eq(node1, node2, bit_indices1, bit_indices2)`
+
+Check if DAG nodes are considered equivalent, e.g., as a node\_match for [`rustworkx.is_isomorphic_node_match()`](https://www.rustworkx.org/apiref/rustworkx.is_isomorphic_node_match.html#rustworkx.is_isomorphic_node_match "(in rustworkx v0.14.0)").
+
+**Parameters**
+
+* **node1** ([*DAGOpNode*](qiskit.dagcircuit.DAGOpNode "qiskit.dagcircuit.DAGOpNode")*,* [*DAGInNode*](qiskit.dagcircuit.DAGInNode "qiskit.dagcircuit.DAGInNode")*,* [*DAGOutNode*](qiskit.dagcircuit.DAGOutNode "qiskit.dagcircuit.DAGOutNode")) – A node to compare.
+* **node2** ([*DAGOpNode*](qiskit.dagcircuit.DAGOpNode "qiskit.dagcircuit.DAGOpNode")*,* [*DAGInNode*](qiskit.dagcircuit.DAGInNode "qiskit.dagcircuit.DAGInNode")*,* [*DAGOutNode*](qiskit.dagcircuit.DAGOutNode "qiskit.dagcircuit.DAGOutNode")) – The other node to compare.
+* **bit\_indices1** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – Dictionary mapping Bit instances to their index within the circuit containing node1
+* **bit\_indices2** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – Dictionary mapping Bit instances to their index within the circuit containing node2
+
+**Returns**
+
+If node1 == node2
+
+**Return type**
+
+[Bool](circuit_classical#qiskit.circuit.classical.types.Bool "qiskit.circuit.classical.types.Bool")
+
diff --git a/docs/api/qiskit/0.46/qiskit.dagcircuit.DAGOpNode.md b/docs/api/qiskit/0.46/qiskit.dagcircuit.DAGOpNode.md
new file mode 100644
index 00000000000..bcef359289d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.dagcircuit.DAGOpNode.md
@@ -0,0 +1,69 @@
+---
+title: DAGOpNode
+description: API reference for qiskit.dagcircuit.DAGOpNode
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.dagcircuit.DAGOpNode
+---
+
+# DAGOpNode
+
+
+
+`qiskit.dagcircuit.DAGOpNode(op, qargs=(), cargs=(), dag=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/dagcircuit/dagnode.py "view source code")
+
+Bases: [`DAGNode`](qiskit.dagcircuit.DAGNode "qiskit.dagcircuit.dagnode.DAGNode")
+
+Object to represent an Instruction at a node in the DAGCircuit.
+
+Create an Instruction node
+
+## Attributes
+
+
+
+### op
+
+
+
+### qargs
+
+
+
+### cargs
+
+
+
+### sort\_key
+
+
+
+### name
+
+Returns the Instruction name corresponding to the op for this node
+
+## Methods
+
+### semantic\_eq
+
+
+
+`static semantic_eq(node1, node2, bit_indices1, bit_indices2)`
+
+Check if DAG nodes are considered equivalent, e.g., as a node\_match for [`rustworkx.is_isomorphic_node_match()`](https://www.rustworkx.org/apiref/rustworkx.is_isomorphic_node_match.html#rustworkx.is_isomorphic_node_match "(in rustworkx v0.14.0)").
+
+**Parameters**
+
+* **node1** ([*DAGOpNode*](#qiskit.dagcircuit.DAGOpNode "qiskit.dagcircuit.DAGOpNode")*,* [*DAGInNode*](qiskit.dagcircuit.DAGInNode "qiskit.dagcircuit.DAGInNode")*,* [*DAGOutNode*](qiskit.dagcircuit.DAGOutNode "qiskit.dagcircuit.DAGOutNode")) – A node to compare.
+* **node2** ([*DAGOpNode*](#qiskit.dagcircuit.DAGOpNode "qiskit.dagcircuit.DAGOpNode")*,* [*DAGInNode*](qiskit.dagcircuit.DAGInNode "qiskit.dagcircuit.DAGInNode")*,* [*DAGOutNode*](qiskit.dagcircuit.DAGOutNode "qiskit.dagcircuit.DAGOutNode")) – The other node to compare.
+* **bit\_indices1** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – Dictionary mapping Bit instances to their index within the circuit containing node1
+* **bit\_indices2** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – Dictionary mapping Bit instances to their index within the circuit containing node2
+
+**Returns**
+
+If node1 == node2
+
+**Return type**
+
+[Bool](circuit_classical#qiskit.circuit.classical.types.Bool "qiskit.circuit.classical.types.Bool")
+
diff --git a/docs/api/qiskit/0.46/qiskit.dagcircuit.DAGOutNode.md b/docs/api/qiskit/0.46/qiskit.dagcircuit.DAGOutNode.md
new file mode 100644
index 00000000000..e74b7d0f66a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.dagcircuit.DAGOutNode.md
@@ -0,0 +1,55 @@
+---
+title: DAGOutNode
+description: API reference for qiskit.dagcircuit.DAGOutNode
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.dagcircuit.DAGOutNode
+---
+
+# DAGOutNode
+
+
+
+`qiskit.dagcircuit.DAGOutNode(wire)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/dagcircuit/dagnode.py "view source code")
+
+Bases: [`DAGNode`](qiskit.dagcircuit.DAGNode "qiskit.dagcircuit.dagnode.DAGNode")
+
+Object to represent an outgoing wire node in the DAGCircuit.
+
+Create an outgoing node
+
+## Attributes
+
+
+
+### wire
+
+
+
+### sort\_key
+
+## Methods
+
+### semantic\_eq
+
+
+
+`static semantic_eq(node1, node2, bit_indices1, bit_indices2)`
+
+Check if DAG nodes are considered equivalent, e.g., as a node\_match for [`rustworkx.is_isomorphic_node_match()`](https://www.rustworkx.org/apiref/rustworkx.is_isomorphic_node_match.html#rustworkx.is_isomorphic_node_match "(in rustworkx v0.14.0)").
+
+**Parameters**
+
+* **node1** ([*DAGOpNode*](qiskit.dagcircuit.DAGOpNode "qiskit.dagcircuit.DAGOpNode")*,* [*DAGInNode*](qiskit.dagcircuit.DAGInNode "qiskit.dagcircuit.DAGInNode")*,* [*DAGOutNode*](#qiskit.dagcircuit.DAGOutNode "qiskit.dagcircuit.DAGOutNode")) – A node to compare.
+* **node2** ([*DAGOpNode*](qiskit.dagcircuit.DAGOpNode "qiskit.dagcircuit.DAGOpNode")*,* [*DAGInNode*](qiskit.dagcircuit.DAGInNode "qiskit.dagcircuit.DAGInNode")*,* [*DAGOutNode*](#qiskit.dagcircuit.DAGOutNode "qiskit.dagcircuit.DAGOutNode")) – The other node to compare.
+* **bit\_indices1** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – Dictionary mapping Bit instances to their index within the circuit containing node1
+* **bit\_indices2** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – Dictionary mapping Bit instances to their index within the circuit containing node2
+
+**Returns**
+
+If node1 == node2
+
+**Return type**
+
+[Bool](circuit_classical#qiskit.circuit.classical.types.Bool "qiskit.circuit.classical.types.Bool")
+
diff --git a/docs/api/qiskit/0.46/qiskit.extensions.SingleQubitUnitary.md b/docs/api/qiskit/0.46/qiskit.extensions.SingleQubitUnitary.md
new file mode 100644
index 00000000000..618f334a443
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.extensions.SingleQubitUnitary.md
@@ -0,0 +1,424 @@
+---
+title: SingleQubitUnitary
+description: API reference for qiskit.extensions.SingleQubitUnitary
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.extensions.SingleQubitUnitary
+---
+
+# SingleQubitUnitary
+
+
+
+`qiskit.extensions.SingleQubitUnitary(unitary_matrix, mode='ZYZ', up_to_diagonal=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/extensions/quantum_initializer/squ.py "view source code")
+
+Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+Single-qubit unitary.
+
+**Parameters**
+
+* **unitary\_matrix** – $2 imes 2$ unitary (given as a (complex) `numpy.ndarray`).
+* **mode** – determines the used decomposition by providing the rotation axes.
+* **up\_to\_diagonal** – the single-qubit unitary is decomposed up to a diagonal matrix, i.e. a unitary $U'$ is implemented such that there exists a diagonal matrix $D$ with $U = D U'$.
+
+Create a new single qubit gate based on the unitary `u`.
+
+
+ The class `qiskit.extensions.quantum_initializer.squ.SingleQubitUnitary` is deprecated as of qiskit 0.45.0. It will be removed in the Qiskit 1.0 release. Instead, you can use qiskit.circuit.library.UnitaryGate.
+
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.extensions.SingleQubitUnitary.base_class "qiskit.extensions.SingleQubitUnitary.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### diag
+
+Returns the diagonal gate D up to which the single-qubit unitary u is implemented.
+
+I.e. u=D.u’, where u’ is the unitary implemented by the found circuit.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### add\_decomposition
+
+
+
+`add_decomposition(decomposition)`
+
+Add a decomposition of the instruction to the SessionEquivalenceLibrary.
+
+### assemble
+
+
+
+`assemble()`
+
+Assemble a QasmQobjInstruction
+
+### broadcast\_arguments
+
+
+
+`broadcast_arguments(qargs, cargs)`
+
+Validation and handling of the arguments and its relationship.
+
+For example, `cx([q[0],q[1]], q[2])` means `cx(q[0], q[2]); cx(q[1], q[2])`. This method yields the arguments in the right grouping. In the given example:
+
+```python
+in: [[q[0],q[1]], q[2]],[]
+outs: [q[0], q[2]], []
+ [q[1], q[2]], []
+```
+
+The general broadcasting rules are:
+
+> * If len(qargs) == 1:
+>
+> ```python
+> [q[0], q[1]] -> [q[0]],[q[1]]
+> ```
+>
+> * If len(qargs) == 2:
+>
+> ```python
+> [[q[0], q[1]], [r[0], r[1]]] -> [q[0], r[0]], [q[1], r[1]]
+> [[q[0]], [r[0], r[1]]] -> [q[0], r[0]], [q[0], r[1]]
+> [[q[0], q[1]], [r[0]]] -> [q[0], r[0]], [q[1], r[0]]
+> ```
+>
+> * If len(qargs) >= 3:
+>
+> ```python
+> [q[0], q[1]], [r[0], r[1]], ...] -> [q[0], r[0], ...], [q[1], r[1], ...]
+> ```
+
+**Parameters**
+
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – List of quantum bit arguments.
+* **cargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – List of classical bit arguments.
+
+**Returns**
+
+A tuple with single arguments.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the input is not valid. For example, the number of arguments does not match the gate expectation.
+
+**Return type**
+
+[*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")\[[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)"), [list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")]]
+
+### c\_if
+
+
+
+`c_if(classical, val)`
+
+Set a classical equality condition on this instruction between the register or cbit `classical` and value `val`.
+
+
+ This is a setter method, not an additive one. Calling this multiple times will silently override any previously set condition; it does not stack.
+
+
+### control
+
+
+
+`control(num_ctrl_qubits=1, label=None, ctrl_state=None)`
+
+Return controlled version of gate. See [`ControlledGate`](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate") for usage.
+
+**Parameters**
+
+* **num\_ctrl\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of controls to add to gate (default: `1`)
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – optional gate label
+* **ctrl\_state** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The control state in decimal or as a bitstring (e.g. `'111'`). If `None`, use `2**num_ctrl_qubits-1`.
+
+**Returns**
+
+Controlled version of gate. This default algorithm uses `num_ctrl_qubits-1` ancilla qubits so returns a gate of size `num_qubits + 2*num_ctrl_qubits - 1`.
+
+**Return type**
+
+[qiskit.circuit.ControlledGate](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – unrecognized mode or invalid ctrl\_state
+
+### copy
+
+
+
+`copy(name=None)`
+
+Copy of the instruction.
+
+**Parameters**
+
+**name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name to be given to the copied circuit, if `None` then the name stays the same.
+
+**Returns**
+
+a copy of the current instruction, with the name updated if it was provided
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### inverse
+
+
+
+`inverse()`
+
+Return the inverse.
+
+Note that the resulting gate has an empty `params` property.
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True .IFF. instruction is parameterized else False
+
+### power
+
+
+
+`power(exponent)`
+
+Creates a unitary gate as gate^exponent.
+
+**Parameters**
+
+**exponent** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Gate^exponent
+
+**Returns**
+
+To which to\_matrix is self.to\_matrix^exponent.
+
+**Return type**
+
+.library.UnitaryGate
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If Gate is not unitary
+
+### qasm
+
+
+
+`qasm()`
+
+Return a default OpenQASM string for the instruction.
+
+Derived instructions may override this to print in a different format (e.g. `measure q[0] -> c[0];`).
+
+
+ The method `qiskit.circuit.instruction.Instruction.qasm()` is deprecated as of qiskit-terra 0.25.0. It will be removed in the Qiskit 1.0 release. Correct exporting to OpenQASM 2 is the responsibility of a larger exporter; it cannot safely be done on an object-by-object basis without context. No replacement will be provided, because the premise is wrong.
+
+
+### repeat
+
+
+
+`repeat(n)`
+
+Creates an instruction with gate repeated n amount of times.
+
+**Parameters**
+
+**n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of times to repeat the instruction
+
+**Returns**
+
+Containing the definition.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If n \< 1.
+
+### reverse\_ops
+
+
+
+`reverse_ops()`
+
+For a composite instruction, reverse the order of sub-instructions.
+
+This is done by recursively reversing all sub-instructions. It does not invert any gate.
+
+**Returns**
+
+**a new instruction with**
+
+sub-instructions reversed.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### soft\_compare
+
+
+
+`soft_compare(other)`
+
+Soft comparison between gates. Their names, number of qubits, and classical bit numbers must match. The number of parameters must match. Each parameter is compared. If one is a ParameterExpression then it is not taken into account.
+
+**Parameters**
+
+**other** (*instruction*) – other instruction.
+
+**Returns**
+
+are self and other equal up to parameter expressions.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### to\_matrix
+
+
+
+`to_matrix()`
+
+Return a Numpy.array for the gate unitary matrix.
+
+**Returns**
+
+if the Gate subclass has a matrix definition.
+
+**Return type**
+
+np.ndarray
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If a Gate subclass does not implement this method an exception will be raised when this base class method is called.
+
+### to\_mutable
+
+
+
+`to_mutable()`
+
+Return a mutable copy of this gate.
+
+This method will return a new mutable copy of this gate instance. If a singleton instance is being used this will be a new unique instance that can be mutated. If the instance is already mutable it will be a deepcopy of that instance.
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Single-qubit unitary gate parameter has to be an ndarray.
+
diff --git a/docs/api/qiskit/0.46/qiskit.extensions.Snapshot.md b/docs/api/qiskit/0.46/qiskit.extensions.Snapshot.md
new file mode 100644
index 00000000000..6aa4e04a085
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.extensions.Snapshot.md
@@ -0,0 +1,322 @@
+---
+title: Snapshot
+description: API reference for qiskit.extensions.Snapshot
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.extensions.Snapshot
+---
+
+# Snapshot
+
+
+
+`qiskit.extensions.Snapshot(label, snapshot_type='statevector', num_qubits=0, num_clbits=0, params=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/extensions/simulator/snapshot.py "view source code")
+
+Bases: [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")
+
+Simulator snapshot instruction.
+
+Create new snapshot instruction.
+
+
+ The class `qiskit.extensions.simulator.snapshot.Snapshot` is deprecated as of qiskit 0.45.0. It will be removed in the Qiskit 1.0 release. The Snapshot instruction has been superseded by Qiskit Aer’s save instructions, see [https://qiskit.org/ecosystem/aer/apidocs/aer\_library.html#saving-simulator-data](https://qiskit.org/ecosystem/aer/apidocs/aer_library.html#saving-simulator-data).
+
+
+**Parameters**
+
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – the snapshot label for result data.
+* **snapshot\_type** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – the type of the snapshot.
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of qubits for the snapshot type \[Default: 0].
+* **num\_clbits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of classical bits for the snapshot type \[Default: 0].
+* **params** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – the parameters for snapshot\_type \[Default: None].
+
+**Raises**
+
+[**ExtensionError**](extensions#qiskit.extensions.ExtensionError "qiskit.extensions.ExtensionError") – if snapshot label is invalid.
+
+## Attributes
+
+
+
+### base\_class
+
+Get the base class of this instruction. This is guaranteed to be in the inheritance tree of `self`.
+
+The “base class” of an instruction is the lowest class in its inheritance tree that the object should be considered entirely compatible with for \_all\_ circuit applications. This typically means that the subclass is defined purely to offer some sort of programmer convenience over the base class, and the base class is the “true” class for a behavioural perspective. In particular, you should *not* override [`base_class`](#qiskit.extensions.Snapshot.base_class "qiskit.extensions.Snapshot.base_class") if you are defining a custom version of an instruction that will be implemented differently by hardware, such as an alternative measurement strategy, or a version of a parametrised gate with a particular set of parameters for the purposes of distinguishing it in a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") from the full parametrised gate.
+
+This is often exactly equivalent to `type(obj)`, except in the case of singleton instances of standard-library instructions. These singleton instances are special subclasses of their base class, and this property will return that base. For example:
+
+```python
+>>> isinstance(XGate(), XGate)
+True
+>>> type(XGate()) is XGate
+False
+>>> XGate().base_class is XGate
+True
+```
+
+In general, you should not rely on the precise class of an instruction; within a given circuit, it is expected that `Instruction.name` should be a more suitable discriminator in most situations.
+
+
+
+### condition
+
+The classical condition on the instruction.
+
+
+
+### condition\_bits
+
+Get Clbits in condition.
+
+
+
+### decompositions
+
+Get the decompositions of the instruction from the SessionEquivalenceLibrary.
+
+
+
+### definition
+
+Return definition in terms of other basic gates.
+
+
+
+### duration
+
+Get the duration.
+
+
+
+### label
+
+Return instruction label
+
+
+
+### mutable
+
+Is this instance is a mutable unique instance or not.
+
+If this attribute is `False` the gate instance is a shared singleton and is not mutable.
+
+
+
+### name
+
+Return the name.
+
+
+
+### num\_clbits
+
+Return the number of clbits.
+
+
+
+### num\_qubits
+
+Return the number of qubits.
+
+
+
+### params
+
+return instruction params.
+
+
+
+### snapshot\_type
+
+Return snapshot type
+
+
+
+### unit
+
+Get the time unit of duration.
+
+## Methods
+
+### add\_decomposition
+
+
+
+`add_decomposition(decomposition)`
+
+Add a decomposition of the instruction to the SessionEquivalenceLibrary.
+
+### assemble
+
+
+
+`assemble()`
+
+Assemble a QasmQobjInstruction
+
+### broadcast\_arguments
+
+
+
+`broadcast_arguments(qargs, cargs)`
+
+Validation of the arguments.
+
+**Parameters**
+
+* **qargs** (*List*) – List of quantum bit arguments.
+* **cargs** (*List*) – List of classical bit arguments.
+
+**Yields**
+
+*Tuple(List, List)* – A tuple with single arguments.
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If the input is not valid. For example, the number of arguments does not match the gate expectation.
+
+### c\_if
+
+
+
+`c_if(classical, val)`
+
+Set a classical equality condition on this instruction between the register or cbit `classical` and value `val`.
+
+
+ This is a setter method, not an additive one. Calling this multiple times will silently override any previously set condition; it does not stack.
+
+
+### copy
+
+
+
+`copy(name=None)`
+
+Copy of the instruction.
+
+**Parameters**
+
+**name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name to be given to the copied circuit, if `None` then the name stays the same.
+
+**Returns**
+
+a copy of the current instruction, with the name updated if it was provided
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### inverse
+
+
+
+`inverse()`
+
+Special case. Return self.
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True .IFF. instruction is parameterized else False
+
+### qasm
+
+
+
+`qasm()`
+
+Return a default OpenQASM string for the instruction.
+
+Derived instructions may override this to print in a different format (e.g. `measure q[0] -> c[0];`).
+
+
+ The method `qiskit.circuit.instruction.Instruction.qasm()` is deprecated as of qiskit-terra 0.25.0. It will be removed in the Qiskit 1.0 release. Correct exporting to OpenQASM 2 is the responsibility of a larger exporter; it cannot safely be done on an object-by-object basis without context. No replacement will be provided, because the premise is wrong.
+
+
+### repeat
+
+
+
+`repeat(n)`
+
+Creates an instruction with gate repeated n amount of times.
+
+**Parameters**
+
+**n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of times to repeat the instruction
+
+**Returns**
+
+Containing the definition.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – If n \< 1.
+
+### reverse\_ops
+
+
+
+`reverse_ops()`
+
+For a composite instruction, reverse the order of sub-instructions.
+
+This is done by recursively reversing all sub-instructions. It does not invert any gate.
+
+**Returns**
+
+**a new instruction with**
+
+sub-instructions reversed.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### soft\_compare
+
+
+
+`soft_compare(other)`
+
+Soft comparison between gates. Their names, number of qubits, and classical bit numbers must match. The number of parameters must match. Each parameter is compared. If one is a ParameterExpression then it is not taken into account.
+
+**Parameters**
+
+**other** (*instruction*) – other instruction.
+
+**Returns**
+
+are self and other equal up to parameter expressions.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### to\_mutable
+
+
+
+`to_mutable()`
+
+Return a mutable copy of this gate.
+
+This method will return a new mutable copy of this gate instance. If a singleton instance is being used this will be a new unique instance that can be mutated. If the instance is already mutable it will be a deepcopy of that instance.
+
+### validate\_parameter
+
+
+
+`validate_parameter(parameter)`
+
+Instruction parameters has no validation or normalization.
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.OperatorBase.md b/docs/api/qiskit/0.46/qiskit.opflow.OperatorBase.md
new file mode 100644
index 00000000000..9cb5f188870
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.OperatorBase.md
@@ -0,0 +1,420 @@
+---
+title: OperatorBase
+description: API reference for qiskit.opflow.OperatorBase
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.OperatorBase
+---
+
+# OperatorBase
+
+
+
+`qiskit.opflow.OperatorBase`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/operator_base.py "view source code")
+
+Bases: `StarAlgebraMixin`, `TensorMixin`, [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Deprecated: A base class for all Operators: PrimitiveOps, StateFns, ListOps, etc. Operators are defined as functions which take one complex binary function to another. These complex binary functions are represented by StateFns, which are themselves a special class of Operators taking only the `Zero` StateFn to the complex binary function they represent.
+
+Operators can be used to construct complicated functions and computation, and serve as the building blocks for algorithms.
+
+
+ The class `qiskit.opflow.operator_base.OperatorBase` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+## Attributes
+
+
+
+### INDENTATION
+
+`= ' '`
+
+
+
+### instance\_id
+
+Return the unique instance id.
+
+
+
+### num\_qubits
+
+The number of qubits over which the Operator is defined. If `op.num_qubits == 5`, then `op.eval('1' * 5)` will be valid, but `op.eval('11')` will not.
+
+**Returns**
+
+The number of qubits accepted by the Operator’s underlying function.
+
+
+
+### parameters
+
+Return a set of Parameter objects contained in the Operator.
+
+
+
+### settings
+
+Return settings of this object in a dictionary.
+
+You can, for example, use this `settings` dictionary to serialize the object in JSON format, if the JSON encoder you use supports all types in the dictionary.
+
+**Returns**
+
+Object settings in a dictionary.
+
+## Methods
+
+### add
+
+
+
+`abstract add(other)`
+
+Return Operator addition of self and other, overloaded by `+`.
+
+**Parameters**
+
+**other** ([*OperatorBase*](#qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – An `OperatorBase` with the same number of qubits as self, and in the same ‘Operator’, ‘State function’, or ‘Measurement’ category as self (i.e. the same type of underlying function).
+
+**Returns**
+
+An `OperatorBase` equivalent to the sum of self and other.
+
+**Return type**
+
+[*OperatorBase*](#qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### adjoint
+
+
+
+`abstract adjoint()`
+
+Return a new Operator equal to the Operator’s adjoint (conjugate transpose), overloaded by `~`. For StateFns, this also turns the StateFn into a measurement.
+
+**Returns**
+
+An `OperatorBase` equivalent to the adjoint of self.
+
+**Return type**
+
+[*OperatorBase*](#qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### assign\_parameters
+
+
+
+`abstract assign_parameters(param_dict)`
+
+Binds scalar values to any Terra `Parameters` in the coefficients or primitives of the Operator, or substitutes one `Parameter` for another. This method differs from Terra’s `assign_parameters` in that it also supports lists of values to assign for a give `Parameter`, in which case self will be copied for each parameterization in the binding list(s), and all the copies will be returned in an `OpList`. If lists of parameterizations are used, every `Parameter` in the param\_dict must have the same length list of parameterizations.
+
+**Parameters**
+
+**param\_dict** ([*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*,* [*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*]]*) – The dictionary of `Parameters` to replace, and values or lists of values by which to replace them.
+
+**Returns**
+
+The `OperatorBase` with the `Parameters` in self replaced by the values or `Parameters` in param\_dict. If param\_dict contains parameterization lists, this `OperatorBase` is an `OpList`.
+
+**Return type**
+
+[*OperatorBase*](#qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### bind\_parameters
+
+
+
+`bind_parameters(param_dict)`
+
+Same as assign\_parameters, but maintained for consistency with QuantumCircuit in Terra (which has both assign\_parameters and bind\_parameters).
+
+**Return type**
+
+[*OperatorBase*](#qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### compose
+
+
+
+`abstract compose(other, permutation=None, front=False)`
+
+Return Operator Composition between self and other (linear algebra-style: A\@B(x) = A(B(x))), overloaded by `@`.
+
+Note: You must be conscious of Quantum Circuit vs. Linear Algebra ordering conventions. Meaning, X.compose(Y) produces an X∘Y on qubit 0, but would produce a QuantumCircuit which looks like
+
+> -\[Y]-\[X]-
+
+Because Terra prints circuits with the initial state at the left side of the circuit.
+
+**Parameters**
+
+* **other** ([*OperatorBase*](#qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` with which to compose self.
+* **permutation** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – `List[int]` which defines permutation on other operator.
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If front==True, return `other.compose(self)`.
+
+**Returns**
+
+An `OperatorBase` equivalent to the function composition of self and other.
+
+**Return type**
+
+[*OperatorBase*](#qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### copy
+
+
+
+`copy()`
+
+Return a deep copy of the Operator.
+
+**Return type**
+
+[*OperatorBase*](#qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### equals
+
+
+
+`abstract equals(other)`
+
+Evaluate Equality between Operators, overloaded by `==`. Only returns True if self and other are of the same representation (e.g. a DictStateFn and CircuitStateFn will never be equal, even if their vector representations are equal), their underlying primitives are equal (this means for ListOps, OperatorStateFns, or EvolvedOps the equality is evaluated recursively downwards), and their coefficients are equal.
+
+**Parameters**
+
+**other** ([*OperatorBase*](#qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to compare to self.
+
+**Returns**
+
+A bool equal to the equality of self and other.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### eval
+
+
+
+`abstract eval(front=None)`
+
+Evaluate the Operator’s underlying function, either on a binary string or another Operator. A square binary Operator can be defined as a function taking a binary function to another binary function. This method returns the value of that function for a given StateFn or binary string. For example, `op.eval('0110').eval('1110')` can be seen as querying the Operator’s matrix representation by row 6 and column 14, and will return the complex value at those “indices.” Similarly for a StateFn, `op.eval('1011')` will return the complex value at row 11 of the vector representation of the StateFn, as all StateFns are defined to be evaluated from Zero implicitly (i.e. it is as if `.eval('0000')` is already called implicitly to always “indexing” from column 0).
+
+If `front` is None, the matrix-representation of the operator is returned.
+
+**Parameters**
+
+**front** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*] |* [*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*OperatorBase*](#qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") *|*[*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.states.statevector.Statevector") *| None*) – The bitstring, dict of bitstrings (with values being coefficients), or StateFn to evaluated by the Operator’s underlying function, or None.
+
+**Returns**
+
+The output of the Operator’s evaluation function. If self is a `StateFn`, the result is a float or complex. If self is an Operator (`PrimitiveOp, ComposedOp, SummedOp, EvolvedOp,` etc.), the result is a StateFn. If `front` is None, the matrix-representation of the operator is returned, which is a `MatrixOp` for the operators and a `VectorStateFn` for state-functions. If either self or front contain proper `ListOps` (not ListOp subclasses), the result is an n-dimensional list of complex or StateFn results, resulting from the recursive evaluation by each OperatorBase in the ListOps.
+
+**Return type**
+
+[*OperatorBase*](#qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") | [complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")
+
+### is\_hermitian
+
+
+
+`is_hermitian()`
+
+Return True if the operator is hermitian.
+
+Returns: Boolean value
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### mul
+
+
+
+`abstract mul(scalar)`
+
+Returns the scalar multiplication of the Operator, overloaded by `*`, including support for Terra’s `Parameters`, which can be bound to values later (via `bind_parameters`).
+
+**Parameters**
+
+**scalar** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The real or complex scalar by which to multiply the Operator, or the `ParameterExpression` to serve as a placeholder for a scalar factor.
+
+**Returns**
+
+An `OperatorBase` equivalent to product of self and scalar.
+
+**Return type**
+
+[*OperatorBase*](#qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### neg
+
+
+
+`neg()`
+
+Return the Operator’s negation, effectively just multiplying by -1.0, overloaded by `-`.
+
+**Returns**
+
+An `OperatorBase` equivalent to the negation of self.
+
+**Return type**
+
+[*OperatorBase*](#qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### permute
+
+
+
+`abstract permute(permutation)`
+
+Permutes the qubits of the operator.
+
+**Parameters**
+
+**permutation** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – A list defining where each qubit should be permuted. The qubit at index j should be permuted to position permutation\[j].
+
+**Returns**
+
+A new OperatorBase containing the permuted operator.
+
+**Raises**
+
+[**OpflowError**](opflow#qiskit.opflow.OpflowError "qiskit.opflow.OpflowError") – if indices do not define a new index for each qubit.
+
+**Return type**
+
+[*OperatorBase*](#qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### primitive\_strings
+
+
+
+`abstract primitive_strings()`
+
+Return a set of strings describing the primitives contained in the Operator. For example, `{'QuantumCircuit', 'Pauli'}`. For hierarchical Operators, such as `ListOps`, this can help illuminate the primitives represented in the various recursive levels, and therefore which conversions can be applied.
+
+**Returns**
+
+A set of strings describing the primitives contained within the Operator.
+
+**Return type**
+
+[*Set*](https://docs.python.org/3/library/typing.html#typing.Set "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")]
+
+### reduce
+
+
+
+`abstract reduce()`
+
+Try collapsing the Operator structure, usually after some type of conversion, e.g. trying to add Operators in a SummedOp or delete needless IGates in a CircuitOp. If no reduction is available, just returns self.
+
+**Returns**
+
+The reduced `OperatorBase`.
+
+### tensor
+
+
+
+`abstract tensor(other)`
+
+Return tensor product between self and other, overloaded by `^`. Note: You must be conscious of Qiskit’s big-endian bit printing convention. Meaning, X.tensor(Y) produces an X on qubit 0 and an Y on qubit 1, or X⨂Y, but would produce a QuantumCircuit which looks like
+
+> -\[Y]- -\[X]-
+
+Because Terra prints circuits and results with qubit 0 at the end of the string or circuit.
+
+**Parameters**
+
+**other** ([*OperatorBase*](#qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to tensor product with self.
+
+**Returns**
+
+An `OperatorBase` equivalent to the tensor product of self and other.
+
+**Return type**
+
+[*OperatorBase*](#qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### tensorpower
+
+
+
+`abstract tensorpower(other)`
+
+Return tensor product with self multiple times, overloaded by `^`.
+
+**Parameters**
+
+**other** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The int number of times to tensor product self with itself via `tensorpower`.
+
+**Returns**
+
+An `OperatorBase` equivalent to the tensorpower of self by other.
+
+**Return type**
+
+[*OperatorBase*](#qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") | [int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### to\_circuit\_op
+
+
+
+`abstract to_circuit_op()`
+
+Returns a `CircuitOp` equivalent to this Operator.
+
+**Return type**
+
+[*OperatorBase*](#qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### to\_matrix
+
+
+
+`abstract to_matrix(massive=False)`
+
+Return NumPy representation of the Operator. Represents the evaluation of the Operator’s underlying function on every combination of basis binary strings. Warn if more than 16 qubits to force having to set `massive=True` if such a large vector is desired.
+
+**Returns**
+
+The NumPy `ndarray` equivalent to this Operator.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+### to\_matrix\_op
+
+
+
+`abstract to_matrix_op(massive=False)`
+
+Returns a `MatrixOp` equivalent to this Operator.
+
+**Return type**
+
+[*OperatorBase*](#qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### to\_spmatrix
+
+
+
+`to_spmatrix()`
+
+Return SciPy sparse matrix representation of the Operator. Represents the evaluation of the Operator’s underlying function on every combination of basis binary strings.
+
+**Returns**
+
+The SciPy `spmatrix` equivalent to this Operator.
+
+**Return type**
+
+*spmatrix*
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.converters.AbelianGrouper.md b/docs/api/qiskit/0.46/qiskit.opflow.converters.AbelianGrouper.md
new file mode 100644
index 00000000000..2061204b164
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.converters.AbelianGrouper.md
@@ -0,0 +1,74 @@
+---
+title: AbelianGrouper
+description: API reference for qiskit.opflow.converters.AbelianGrouper
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.converters.AbelianGrouper
+---
+
+# AbelianGrouper
+
+
+
+`qiskit.opflow.converters.AbelianGrouper(traverse=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/converters/abelian_grouper.py "view source code")
+
+Bases: [`ConverterBase`](qiskit.opflow.converters.ConverterBase "qiskit.opflow.converters.converter_base.ConverterBase")
+
+Deprecated: The AbelianGrouper converts SummedOps into a sum of Abelian sums.
+
+Meaning, it will traverse the Operator, and when it finds a SummedOp, it will evaluate which of the summed sub-Operators commute with one another. It will then convert each of the groups of commuting Operators into their own SummedOps, and return the sum-of-commuting-SummedOps. This is particularly useful for cases where mutually commuting groups can be handled similarly, as in the case of Pauli Expectations, where commuting Paulis have the same diagonalizing circuit rotation, or Pauli Evolutions, where commuting Paulis can be diagonalized together.
+
+
+ The class `qiskit.opflow.converters.abelian_grouper.AbelianGrouper` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+**traverse** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to convert only the Operator passed to `convert`, or traverse down that Operator.
+
+## Methods
+
+### convert
+
+
+
+`convert(operator)`
+
+Check if operator is a SummedOp, in which case covert it into a sum of mutually commuting sums, or if the Operator contains sub-Operators and `traverse` is True, attempt to convert any sub-Operators.
+
+**Parameters**
+
+**operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The Operator to attempt to convert.
+
+**Returns**
+
+The converted Operator.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### group\_subops
+
+
+
+`classmethod group_subops(list_op)`
+
+Given a ListOp, attempt to group into Abelian ListOps of the same type.
+
+**Parameters**
+
+**list\_op** ([*ListOp*](qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.list_op.ListOp") *|*[*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.pauli_sum_op.PauliSumOp")) – The Operator to group into Abelian groups
+
+**Returns**
+
+The grouped Operator.
+
+**Raises**
+
+[**OpflowError**](opflow#qiskit.opflow.OpflowError "qiskit.opflow.OpflowError") – If any of list\_op’s sub-ops is not `PauliOp`.
+
+**Return type**
+
+[*ListOp*](qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.list_op.ListOp")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.converters.CircuitSampler.md b/docs/api/qiskit/0.46/qiskit.opflow.converters.CircuitSampler.md
new file mode 100644
index 00000000000..0c2cdb7cccd
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.converters.CircuitSampler.md
@@ -0,0 +1,108 @@
+---
+title: CircuitSampler
+description: API reference for qiskit.opflow.converters.CircuitSampler
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.converters.CircuitSampler
+---
+
+# CircuitSampler
+
+
+
+`qiskit.opflow.converters.CircuitSampler(backend, statevector=None, param_qobj=False, attach_results=False, caching='last')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/converters/circuit_sampler.py "view source code")
+
+Bases: [`ConverterBase`](qiskit.opflow.converters.ConverterBase "qiskit.opflow.converters.converter_base.ConverterBase")
+
+Deprecated: The CircuitSampler traverses an Operator and converts any CircuitStateFns into approximations of the state function by a DictStateFn or VectorStateFn using a quantum backend. Note that in order to approximate the value of the CircuitStateFn, it must 1) send state function through a depolarizing channel, which will destroy all phase information and 2) replace the sampled frequencies with **square roots** of the frequency, rather than the raw probability of sampling (which would be the equivalent of sampling the **square** of the state function, per the Born rule.
+
+The CircuitSampler aggressively caches transpiled circuits to handle re-parameterization of the same circuit efficiently. If you are converting multiple different Operators, you are better off using a different CircuitSampler for each Operator to avoid cache thrashing.
+
+
+ The class `qiskit.opflow.converters.circuit_sampler.CircuitSampler` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **backend** ([*Backend*](qiskit.providers.Backend "qiskit.providers.backend.Backend") *|*[*QuantumInstance*](qiskit.utils.QuantumInstance "qiskit.utils.quantum_instance.QuantumInstance")) – The quantum backend or QuantumInstance to use to sample the circuits.
+* **statevector** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – If backend is a statevector backend, whether to replace the CircuitStateFns with DictStateFns (from the counts) or VectorStateFns (from the statevector). `None` will set this argument automatically based on the backend.
+* **attach\_results** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to attach the data from the backend `Results` object for a given `` CircuitStateFn` `` to an `execution_results` field added the converted `DictStateFn` or `VectorStateFn`.
+* **param\_qobj** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to use Aer’s parameterized Qobj capability to avoid re-assembling the circuits.
+* **caching** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The caching strategy. Can be ‘last’ (default) to store the last operator that was converted, set to ‘all’ to cache all processed operators.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – Set statevector or param\_qobj True when not supported by backend.
+
+## Attributes
+
+
+
+### quantum\_instance
+
+Returns the quantum instance.
+
+**Returns**
+
+The QuantumInstance used by the CircuitSampler
+
+## Methods
+
+### clear\_cache
+
+
+
+`clear_cache()`
+
+Clear the cache of sampled operator expressions.
+
+### convert
+
+
+
+`convert(operator, params=None)`
+
+Converts the Operator to one in which the CircuitStateFns are replaced by DictStateFns or VectorStateFns. Extracts the CircuitStateFns out of the Operator, caches them, calls `sample_circuits` below to get their converted replacements, and replaces the CircuitStateFns in operator with the replacement StateFns.
+
+**Parameters**
+
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The Operator to convert
+* **params** ([*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.parameter.Parameter")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] |* [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]]] | None*) – A dictionary mapping parameters to either single binding values or lists of binding values.
+
+**Returns**
+
+The converted Operator with CircuitStateFns replaced by DictStateFns or VectorStateFns.
+
+**Raises**
+
+[**OpflowError**](opflow#qiskit.opflow.OpflowError "qiskit.opflow.OpflowError") – if extracted circuits are empty.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### sample\_circuits
+
+
+
+`sample_circuits(circuit_sfns=None, param_bindings=None)`
+
+Samples the CircuitStateFns and returns a dict associating their `id()` values to their replacement DictStateFn or VectorStateFn. If param\_bindings is provided, the CircuitStateFns are broken into their parameterizations, and a list of StateFns is returned in the dict for each circuit `id()`. Note that param\_bindings is provided here in a different format than in `convert`, and lists of parameters within the dict is not supported, and only binding dicts which are valid to be passed into Terra can be included in this list.
+
+**Parameters**
+
+* **circuit\_sfns** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*CircuitStateFn*](qiskit.opflow.state_fns.CircuitStateFn "qiskit.opflow.state_fns.circuit_state_fn.CircuitStateFn")*] | None*) – The list of CircuitStateFns to sample.
+* **param\_bindings** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.parameter.Parameter")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – The parameterizations to bind to each CircuitStateFn.
+
+**Returns**
+
+The dictionary mapping ids of the CircuitStateFns to their replacement StateFns.
+
+**Raises**
+
+[**OpflowError**](opflow#qiskit.opflow.OpflowError "qiskit.opflow.OpflowError") – if extracted circuits are empty.
+
+**Return type**
+
+[*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")\[[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)"), [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*StateFn*](qiskit.opflow.state_fns.StateFn "qiskit.opflow.state_fns.state_fn.StateFn")]]
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.converters.ConverterBase.md b/docs/api/qiskit/0.46/qiskit.opflow.converters.ConverterBase.md
new file mode 100644
index 00000000000..018e0dd800f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.converters.ConverterBase.md
@@ -0,0 +1,44 @@
+---
+title: ConverterBase
+description: API reference for qiskit.opflow.converters.ConverterBase
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.converters.ConverterBase
+---
+
+# ConverterBase
+
+
+
+`qiskit.opflow.converters.ConverterBase`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/converters/converter_base.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Deprecated: Converters take an Operator and return a new Operator, generally isomorphic in some way with the first, but with certain desired properties. For example, a converter may accept `CircuitOp` and return a `SummedOp` of `PauliOps` representing the circuit unitary. Converters may not have polynomial space or time scaling in their operations. On the contrary, many converters, such as a `MatrixExpectation` or `MatrixEvolution`, which convert `PauliOps` to `MatrixOps` internally, will require time or space exponential in the number of qubits unless a clever trick is known (such as the use of sparse matrices).
+
+
+ The class `qiskit.opflow.converters.converter_base.ConverterBase` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+## Methods
+
+### convert
+
+
+
+`abstract convert(operator)`
+
+Accept the Operator and return the converted Operator
+
+**Parameters**
+
+**operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The Operator to convert.
+
+**Returns**
+
+The converted Operator.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.converters.DictToCircuitSum.md b/docs/api/qiskit/0.46/qiskit.opflow.converters.DictToCircuitSum.md
new file mode 100644
index 00000000000..2ee3d728f50
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.converters.DictToCircuitSum.md
@@ -0,0 +1,50 @@
+---
+title: DictToCircuitSum
+description: API reference for qiskit.opflow.converters.DictToCircuitSum
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.converters.DictToCircuitSum
+---
+
+# DictToCircuitSum
+
+
+
+`qiskit.opflow.converters.DictToCircuitSum(traverse=True, convert_dicts=True, convert_vectors=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/converters/dict_to_circuit_sum.py "view source code")
+
+Bases: [`ConverterBase`](qiskit.opflow.converters.ConverterBase "qiskit.opflow.converters.converter_base.ConverterBase")
+
+Deprecated: Converts `DictStateFns` or `VectorStateFns` to equivalent `CircuitStateFns` or sums thereof. The behavior of this class can be mostly replicated by calling `to_circuit_op` on an Operator, but with the added control of choosing whether to convert only `DictStateFns` or `VectorStateFns`, rather than both.
+
+
+ The class `qiskit.opflow.converters.dict_to_circuit_sum.DictToCircuitSum` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **traverse** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to recurse down into Operators with internal sub-operators for conversion.
+* **convert\_dicts** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to convert VectorStateFn.
+* **convert\_vectors** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to convert DictStateFns.
+
+## Methods
+
+### convert
+
+
+
+`convert(operator)`
+
+Convert the Operator to `CircuitStateFns`, recursively if `traverse` is True.
+
+**Parameters**
+
+**operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The Operator to convert
+
+**Returns**
+
+The converted Operator.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.converters.PauliBasisChange.md b/docs/api/qiskit/0.46/qiskit.opflow.converters.PauliBasisChange.md
new file mode 100644
index 00000000000..be2c8656853
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.converters.PauliBasisChange.md
@@ -0,0 +1,268 @@
+---
+title: PauliBasisChange
+description: API reference for qiskit.opflow.converters.PauliBasisChange
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.converters.PauliBasisChange
+---
+
+# PauliBasisChange
+
+
+
+`qiskit.opflow.converters.PauliBasisChange(destination_basis=None, traverse=True, replacement_fn=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/converters/pauli_basis_change.py "view source code")
+
+Bases: [`ConverterBase`](qiskit.opflow.converters.ConverterBase "qiskit.opflow.converters.converter_base.ConverterBase")
+
+Deprecated: Converter for changing Paulis into other bases. By default, the diagonal basis composed only of Pauli \{Z, I}^n is used as the destination basis to which to convert. Meaning, if a Pauli containing X or Y terms is passed in, which cannot be sampled or evolved natively on some Quantum hardware, the Pauli can be replaced by a composition of a change of basis circuit and a Pauli composed of only Z and I terms (diagonal), which can be evolved or sampled natively on the Quantum hardware.
+
+The replacement function determines how the `PauliOps` should be replaced by their computed change-of-basis `CircuitOps` and destination `PauliOps`. Several convenient out-of-the-box replacement functions have been added as static methods, such as `measurement_replacement_fn`.
+
+This class uses the typical basis change method found in most Quantum Computing textbooks (such as on page 210 of Nielsen and Chuang’s, “Quantum Computation and Quantum Information”, ISBN: 978-1-107-00217-3), which involves diagonalizing the single-qubit Paulis with H and S† gates, mapping the eigenvectors of the diagonalized origin Pauli to the diagonalized destination Pauli using CNOTS, and then de-diagonalizing any single qubit Paulis to their non-diagonal destination values. Many other methods are possible, as well as variations on this method, such as the placement of the CNOT chains.
+
+
+ The class `qiskit.opflow.converters.pauli_basis_change.PauliBasisChange` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **destination\_basis** ([*Pauli*](qiskit.quantum_info.Pauli "qiskit.quantum_info.operators.symplectic.pauli.Pauli") *|*[*PauliOp*](qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.pauli_op.PauliOp") *| None*) – The Pauli into the basis of which the operators will be converted. If None is specified, the destination basis will be the diagonal (\{I, Z}^n) basis requiring only single qubit rotations.
+
+* **traverse** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If true and the operator passed into convert contains sub-Operators, such as ListOp, traverse the Operator and apply the conversion to every applicable sub-operator within it.
+
+* **replacement\_fn** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *| None*) –
+
+ A function specifying what to do with the basis-change `CircuitOp` and destination `PauliOp` when converting an Operator and replacing converted values. By default, this will be
+
+ > 1. For StateFns (or Measurements): replacing the StateFn with ComposedOp(StateFn(d), c) where c is the conversion circuit and d is the destination Pauli, so the overall beginning and ending operators are equivalent.
+ > 2. For non-StateFn Operators: replacing the origin p with c·d·c†, where c is the conversion circuit and d is the destination, so the overall beginning and ending operators are equivalent.
+
+## Attributes
+
+
+
+### destination
+
+The destination `PauliOp`, or `None` if using the default destination, the diagonal basis.
+
+## Methods
+
+### construct\_cnot\_chain
+
+
+
+`construct_cnot_chain(diag_pauli_op1, diag_pauli_op2)`
+
+Construct a `CircuitOp` (or `PauliOp` if equal to the identity) which takes the eigenvectors of `diag_pauli_op1` to the eigenvectors of `diag_pauli_op2`, assuming both are diagonal (or performing this operation on their diagonalized Paulis implicitly if not). This works by the insight that the eigenvalue of a diagonal Pauli’s eigenvector is equal to or -1 if the parity is 1 and 1 if the parity is 0, or 1 - (2 \* parity). Therefore, using CNOTs, we can write the parity of diag\_pauli\_op1’s significant bits onto some qubit, and then write out that parity onto diag\_pauli\_op2’s significant bits.
+
+**Parameters**
+
+* **diag\_pauli\_op1** ([*PauliOp*](qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.pauli_op.PauliOp")) – The origin `PauliOp`.
+* **diag\_pauli\_op2** ([*PauliOp*](qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.pauli_op.PauliOp")) – The destination `PauliOp`.
+
+**Returns**
+
+The `PrimitiveOp` performs the mapping.
+
+**Return type**
+
+[*PrimitiveOp*](qiskit.opflow.primitive_ops.PrimitiveOp "qiskit.opflow.primitive_ops.primitive_op.PrimitiveOp")
+
+### convert
+
+
+
+`convert(operator)`
+
+Given a `PauliOp`, or an Operator containing `PauliOps` if `_traverse` is True, converts each Pauli into the basis specified by self.\_destination and a basis-change-circuit, calls `replacement_fn` with these two Operators, and replaces the `PauliOps` with the output of `replacement_fn`. For example, for the built-in `operator_replacement_fn` below, each PauliOp p will be replaced by the composition of the basis-change Clifford `CircuitOp` c with the destination PauliOp d and c†, such that p = c·d·c†, up to global phase.
+
+**Parameters**
+
+**operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The Operator to convert.
+
+**Returns**
+
+The converted Operator.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### get\_cob\_circuit
+
+
+
+`get_cob_circuit(origin)`
+
+Construct an Operator which maps the +1 and -1 eigenvectors of the origin Pauli to the +1 and -1 eigenvectors of the destination Pauli. It does so by
+
+1. converting any |i+⟩ or |i+⟩ eigenvector bits in the origin to |+⟩ and |-⟩ with S†s, then
+2. converting any |+⟩ or |+⟩ eigenvector bits in the converted origin to |0⟩ and |1⟩ with Hs, then
+3. writing the parity of the significant (Z-measured, rather than I) bits in the origin to a single “origin anchor bit,” using cnots, which will hold the parity of these bits,
+4. swapping the parity of the pauli anchor bit into a destination anchor bit using a swap gate (only if they are different, if there are any bits which are significant in both origin and dest, we set both anchors to one of these bits to avoid a swap).
+5. writing the parity of the destination anchor bit into the other significant bits of the destination,
+6. converting the |0⟩ and |1⟩ significant eigenvector bits to |+⟩ and |-⟩ eigenvector bits in the destination where the destination demands it (e.g. pauli.x == true for a bit), using Hs 8) converting the |+⟩ and |-⟩ significant eigenvector bits to |i+⟩ and |i-⟩ eigenvector bits in the destination where the destination demands it (e.g. pauli.x == true and pauli.z == true for a bit), using Ss
+
+**Parameters**
+
+**origin** ([*Pauli*](qiskit.quantum_info.Pauli "qiskit.quantum_info.operators.symplectic.pauli.Pauli") *|*[*PauliOp*](qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.pauli_op.PauliOp")) – The `Pauli` or `PauliOp` to map.
+
+**Returns**
+
+A tuple of a `PrimitiveOp` which equals the basis change mapping and a `PauliOp` which equals the destination basis.
+
+**Raises**
+
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Attempting to convert from non-Pauli origin.
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – Attempting to change a non-identity Pauli to an identity Pauli, or vice versa.
+
+**Return type**
+
+[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")\[[*PrimitiveOp*](qiskit.opflow.primitive_ops.PrimitiveOp "qiskit.opflow.primitive_ops.primitive_op.PrimitiveOp"), [*PauliOp*](qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.pauli_op.PauliOp")]
+
+### get\_diagonal\_pauli\_op
+
+
+
+`get_diagonal_pauli_op(pauli_op)`
+
+Get the diagonal `PualiOp` to which `pauli_op` could be rotated with only single-qubit operations.
+
+**Parameters**
+
+**pauli\_op** ([*PauliOp*](qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.pauli_op.PauliOp")) – The `PauliOp` whose diagonal to compute.
+
+**Returns**
+
+The diagonal `PauliOp`.
+
+**Return type**
+
+[*PauliOp*](qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.pauli_op.PauliOp")
+
+### get\_diagonalizing\_clifford
+
+
+
+`get_diagonalizing_clifford(pauli)`
+
+Construct a `CircuitOp` with only single-qubit gates which takes the eigenvectors of `pauli` to eigenvectors composed only of |0⟩ and |1⟩ tensor products. Equivalently, finds the basis-change circuit to take `pauli` to a diagonal `PauliOp` composed only of Z and I tensor products.
+
+Note, underlying Pauli bits are in Qiskit endianness, so we need to reverse before we begin composing with Operator flow.
+
+**Parameters**
+
+**pauli** ([*Pauli*](qiskit.quantum_info.Pauli "qiskit.quantum_info.operators.symplectic.pauli.Pauli") *|*[*PauliOp*](qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.pauli_op.PauliOp")) – the `Pauli` or `PauliOp` to whose diagonalizing circuit to compute.
+
+**Returns**
+
+The diagonalizing `CircuitOp`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### get\_tpb\_pauli
+
+
+
+`get_tpb_pauli(list_op)`
+
+Gets the Pauli (not `PauliOp`!) whose diagonalizing single-qubit rotations is a superset of the diagonalizing single-qubit rotations for each of the Paulis in `list_op`. TPB stands for Tensor Product Basis.
+
+**Parameters**
+
+**list\_op** ([*ListOp*](qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.list_op.ListOp")) – the `ListOp` whose TPB Pauli to return.
+
+**Returns**
+
+The TBP Pauli.
+
+**Return type**
+
+[*Pauli*](qiskit.quantum_info.Pauli "qiskit.quantum_info.operators.symplectic.pauli.Pauli")
+
+### measurement\_replacement\_fn
+
+
+
+`static measurement_replacement_fn(cob_instr_op, dest_pauli_op)`
+
+A built-in convenience replacement function which produces measurements isomorphic to an `OperatorStateFn` measurement holding the origin `PauliOp`.
+
+**Parameters**
+
+* **cob\_instr\_op** ([*PrimitiveOp*](qiskit.opflow.primitive_ops.PrimitiveOp "qiskit.opflow.primitive_ops.primitive_op.PrimitiveOp")) – The basis-change `CircuitOp`.
+* **dest\_pauli\_op** ([*PauliOp*](qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.pauli_op.PauliOp") *|*[*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.pauli_sum_op.PauliSumOp") *|*[*ListOp*](qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.list_op.ListOp")) – The destination Pauli type operator.
+
+**Returns**
+
+The `~StateFn @ CircuitOp` composition equivalent to a measurement by the original `PauliOp`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### operator\_replacement\_fn
+
+
+
+`static operator_replacement_fn(cob_instr_op, dest_pauli_op)`
+
+A built-in convenience replacement function which produces Operators isomorphic to the origin `PauliOp`.
+
+**Parameters**
+
+* **cob\_instr\_op** ([*PrimitiveOp*](qiskit.opflow.primitive_ops.PrimitiveOp "qiskit.opflow.primitive_ops.primitive_op.PrimitiveOp")) – The basis-change `CircuitOp`.
+* **dest\_pauli\_op** ([*PauliOp*](qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.pauli_op.PauliOp") *|*[*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.pauli_sum_op.PauliSumOp") *|*[*ListOp*](qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.list_op.ListOp")) – The destination `PauliOp`.
+
+**Returns**
+
+The `~CircuitOp @ PauliOp @ CircuitOp` composition isomorphic to the original `PauliOp`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### pad\_paulis\_to\_equal\_length
+
+
+
+`pad_paulis_to_equal_length(pauli_op1, pauli_op2)`
+
+If `pauli_op1` and `pauli_op2` do not act over the same number of qubits, pad identities to the end of the shorter of the two so they are of equal length. Padding is applied to the end of the Paulis. Note that the Terra represents Paulis in big-endian order, so this will appear as padding to the beginning of the Pauli x and z bit arrays.
+
+**Parameters**
+
+* **pauli\_op1** ([*PauliOp*](qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.pauli_op.PauliOp")) – A pauli\_op to possibly pad.
+* **pauli\_op2** ([*PauliOp*](qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.pauli_op.PauliOp")) – A pauli\_op to possibly pad.
+
+**Returns**
+
+A tuple containing the padded PauliOps.
+
+**Return type**
+
+[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")\[[*PauliOp*](qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.pauli_op.PauliOp"), [*PauliOp*](qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.pauli_op.PauliOp")]
+
+### statefn\_replacement\_fn
+
+
+
+`static statefn_replacement_fn(cob_instr_op, dest_pauli_op)`
+
+A built-in convenience replacement function which produces state functions isomorphic to an `OperatorStateFn` state function holding the origin `PauliOp`.
+
+**Parameters**
+
+* **cob\_instr\_op** ([*PrimitiveOp*](qiskit.opflow.primitive_ops.PrimitiveOp "qiskit.opflow.primitive_ops.primitive_op.PrimitiveOp")) – The basis-change `CircuitOp`.
+* **dest\_pauli\_op** ([*PauliOp*](qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.pauli_op.PauliOp") *|*[*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.pauli_sum_op.PauliSumOp") *|*[*ListOp*](qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.list_op.ListOp")) – The destination Pauli type operator.
+
+**Returns**
+
+The `~CircuitOp @ StateFn` composition equivalent to a state function defined by the original `PauliOp`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.converters.TwoQubitReduction.md b/docs/api/qiskit/0.46/qiskit.opflow.converters.TwoQubitReduction.md
new file mode 100644
index 00000000000..4fb8b3aebfa
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.converters.TwoQubitReduction.md
@@ -0,0 +1,50 @@
+---
+title: TwoQubitReduction
+description: API reference for qiskit.opflow.converters.TwoQubitReduction
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.converters.TwoQubitReduction
+---
+
+# TwoQubitReduction
+
+
+
+`qiskit.opflow.converters.TwoQubitReduction(num_particles)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/converters/two_qubit_reduction.py "view source code")
+
+Bases: [`ConverterBase`](qiskit.opflow.converters.ConverterBase "qiskit.opflow.converters.converter_base.ConverterBase")
+
+Deprecated: Two qubit reduction converter which eliminates the central and last qubit in a list of Pauli that has diagonal operators (Z,I) at those positions.
+
+Chemistry specific method: It can be used to taper two qubits in parity and binary-tree mapped fermionic Hamiltonians when the spin orbitals are ordered in two spin sectors, (block spin order) according to the number of particles in the system.
+
+
+ The class `qiskit.opflow.converters.two_qubit_reduction.TwoQubitReduction` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+**num\_particles** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] |* [*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – number of particles, if it is a list, the first number is alpha and the second number if beta.
+
+## Methods
+
+### convert
+
+
+
+`convert(operator)`
+
+Converts the Operator to tapered one by Z2 symmetries.
+
+**Parameters**
+
+**operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – the operator
+
+**Returns**
+
+A new operator whose qubit number is reduced by 2.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.converters.md b/docs/api/qiskit/0.46/qiskit.opflow.converters.md
new file mode 100644
index 00000000000..1e134768011
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.converters.md
@@ -0,0 +1,52 @@
+---
+title: converters
+description: API reference for qiskit.opflow.converters
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.opflow.converters
+---
+
+
+
+
+
+# qiskit.opflow\.converters
+
+
+
+## Converters
+
+
+
+`qiskit.opflow.converters`
+
+
+ The [`qiskit.opflow`](opflow#module-qiskit.opflow "qiskit.opflow") module is deprecated and will be removed no earlier than 3 months after the release date. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+Converters are objects which manipulate Operators, usually traversing an Operator to change certain sub-Operators into a desired representation. Often the converted Operator is isomorphic or approximate to the original Operator in some way, but not always. For example, a converter may accept [`CircuitOp`](qiskit.opflow.primitive_ops.CircuitOp "qiskit.opflow.primitive_ops.CircuitOp") and return a [`SummedOp`](qiskit.opflow.list_ops.SummedOp "qiskit.opflow.list_ops.SummedOp") of [`PauliOp`](qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.PauliOp")’s representing the circuit unitary. Converters may not have polynomial space or time scaling in their operations. On the contrary, many converters, such as a [`MatrixExpectation`](qiskit.opflow.expectations.MatrixExpectation "qiskit.opflow.expectations.MatrixExpectation") or [`MatrixEvolution`](qiskit.opflow.evolutions.MatrixEvolution "qiskit.opflow.evolutions.MatrixEvolution"), which convert [`PauliOp`](qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.PauliOp")’s to [`MatrixOp`](qiskit.opflow.primitive_ops.MatrixOp "qiskit.opflow.primitive_ops.MatrixOp")’s internally, will require time or space exponential in the number of qubits unless a clever trick is known (such as the use of sparse matrices).
+
+
+ Not all converters are in this module, as [`expectations`](qiskit.opflow.expectations#module-qiskit.opflow.expectations "qiskit.opflow.expectations") and [`evolutions`](qiskit.opflow.evolutions#module-qiskit.opflow.evolutions "qiskit.opflow.evolutions") are also converters.
+
+
+### Converter Base Class
+
+The converter base class simply enforces the presence of a [`convert()`](qiskit.opflow.converters.ConverterBase#convert "qiskit.opflow.converters.ConverterBase.convert") method.
+
+| | |
+| ---------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`ConverterBase`](qiskit.opflow.converters.ConverterBase "qiskit.opflow.converters.ConverterBase")() | Deprecated: Converters take an Operator and return a new Operator, generally isomorphic in some way with the first, but with certain desired properties. |
+
+### Converters
+
+In addition to the base class, directory holds a few miscellaneous converters which are used frequently around the Operator flow.
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| [`CircuitSampler`](qiskit.opflow.converters.CircuitSampler "qiskit.opflow.converters.CircuitSampler")(backend\[, statevector, ...]) | Deprecated: The CircuitSampler traverses an Operator and converts any CircuitStateFns into approximations of the state function by a DictStateFn or VectorStateFn using a quantum backend. |
+| [`AbelianGrouper`](qiskit.opflow.converters.AbelianGrouper "qiskit.opflow.converters.AbelianGrouper")(\[traverse]) | Deprecated: The AbelianGrouper converts SummedOps into a sum of Abelian sums. |
+| [`DictToCircuitSum`](qiskit.opflow.converters.DictToCircuitSum "qiskit.opflow.converters.DictToCircuitSum")(\[traverse, convert\_dicts, ...]) | Deprecated: Converts `DictStateFns` or `VectorStateFns` to equivalent `CircuitStateFns` or sums thereof. |
+| [`PauliBasisChange`](qiskit.opflow.converters.PauliBasisChange "qiskit.opflow.converters.PauliBasisChange")(\[destination\_basis, ...]) | Deprecated: Converter for changing Paulis into other bases. |
+| [`TwoQubitReduction`](qiskit.opflow.converters.TwoQubitReduction "qiskit.opflow.converters.TwoQubitReduction")(num\_particles) | Deprecated: Two qubit reduction converter which eliminates the central and last qubit in a list of Pauli that has diagonal operators (Z,I) at those positions. |
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.evolutions.EvolutionBase.md b/docs/api/qiskit/0.46/qiskit.opflow.evolutions.EvolutionBase.md
new file mode 100644
index 00000000000..d1acbdd63fd
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.evolutions.EvolutionBase.md
@@ -0,0 +1,44 @@
+---
+title: EvolutionBase
+description: API reference for qiskit.opflow.evolutions.EvolutionBase
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.evolutions.EvolutionBase
+---
+
+# EvolutionBase
+
+
+
+`qiskit.opflow.evolutions.EvolutionBase`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/evolutions/evolution_base.py "view source code")
+
+Bases: [`ConverterBase`](qiskit.opflow.converters.ConverterBase "qiskit.opflow.converters.converter_base.ConverterBase"), [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Deprecated: A base for Evolution converters. Evolutions are converters which traverse an Operator tree, replacing any `EvolvedOp` e with a Schrodinger equation-style evolution `CircuitOp` equalling or approximating the matrix exponential of -i \* the Operator contained inside (e.primitive). The Evolutions are essentially implementations of Hamiltonian Simulation algorithms, including various methods for Trotterization.
+
+
+ The class `qiskit.opflow.evolutions.evolution_base.EvolutionBase` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+## Methods
+
+### convert
+
+
+
+`abstract convert(operator)`
+
+Traverse the operator, replacing any `EvolutionOps` with their equivalent evolution `CircuitOps`.
+
+> **Args:**
+>
+> operator: The Operator to convert.
+
+**Returns**
+
+The converted Operator, with `EvolutionOps` replaced by `CircuitOps`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.evolutions.EvolutionFactory.md b/docs/api/qiskit/0.46/qiskit.opflow.evolutions.EvolutionFactory.md
new file mode 100644
index 00000000000..5893c606076
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.evolutions.EvolutionFactory.md
@@ -0,0 +1,48 @@
+---
+title: EvolutionFactory
+description: API reference for qiskit.opflow.evolutions.EvolutionFactory
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.evolutions.EvolutionFactory
+---
+
+# EvolutionFactory
+
+
+
+`qiskit.opflow.evolutions.EvolutionFactory`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/evolutions/evolution_factory.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Deprecated: A factory class for convenient automatic selection of an Evolution algorithm based on the Operator to be converted.
+
+## Methods
+
+### build
+
+
+
+`static build(operator=None)`
+
+A factory method for convenient automatic selection of an Evolution algorithm based on the Operator to be converted.
+
+
+ The method `qiskit.opflow.evolutions.evolution_factory.EvolutionFactory.build()` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+**operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – the Operator being evolved
+
+**Returns**
+
+the `EvolutionBase` best suited to evolve operator.
+
+**Return type**
+
+[EvolutionBase](qiskit.opflow.evolutions.EvolutionBase "qiskit.opflow.evolutions.EvolutionBase")
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If operator is not of a composition for which we know the best Evolution method.
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.evolutions.EvolvedOp.md b/docs/api/qiskit/0.46/qiskit.opflow.evolutions.EvolvedOp.md
new file mode 100644
index 00000000000..991107e42e4
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.evolutions.EvolvedOp.md
@@ -0,0 +1,337 @@
+---
+title: EvolvedOp
+description: API reference for qiskit.opflow.evolutions.EvolvedOp
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.evolutions.EvolvedOp
+---
+
+# EvolvedOp
+
+
+
+`qiskit.opflow.evolutions.EvolvedOp(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/evolutions/evolved_op.py "view source code")
+
+Bases: [`PrimitiveOp`](qiskit.opflow.primitive_ops.PrimitiveOp "qiskit.opflow.primitive_ops.primitive_op.PrimitiveOp")
+
+Deprecated: Class for wrapping Operator Evolutions for compilation (`convert`) by an EvolutionBase method later, essentially acting as a placeholder. Note that EvolvedOp is a weird case of PrimitiveOp. It happens to be that it fits into the PrimitiveOp interface nearly perfectly, and it essentially represents a placeholder for a PrimitiveOp later, even though it doesn’t actually hold a primitive object. We could have chosen for it to be an OperatorBase, but would have ended up copying and pasting a lot of code from PrimitiveOp.
+
+
+ The class `qiskit.opflow.evolutions.evolved_op.EvolvedOp` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **primitive** – The operator being wrapped to signify evolution later.
+* **coeff** – A coefficient multiplying the operator
+
+## Attributes
+
+
+
+### INDENTATION
+
+`= ' '`
+
+
+
+### coeff
+
+The scalar coefficient multiplying the Operator.
+
+**Returns**
+
+The coefficient.
+
+
+
+### instance\_id
+
+Return the unique instance id.
+
+
+
+### num\_qubits
+
+
+
+### parameters
+
+
+
+### primitive
+
+`PrimitiveOp`
+
+The primitive defining the underlying function of the Operator.
+
+**Returns**
+
+The primitive object.
+
+
+
+### settings
+
+Return operator settings.
+
+## Methods
+
+### add
+
+
+
+`add(other)`
+
+Return Operator addition of self and other, overloaded by `+`.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – An `OperatorBase` with the same number of qubits as self, and in the same ‘Operator’, ‘State function’, or ‘Measurement’ category as self (i.e. the same type of underlying function).
+
+**Returns**
+
+An `OperatorBase` equivalent to the sum of self and other.
+
+**Return type**
+
+[*EvolvedOp*](#qiskit.opflow.evolutions.EvolvedOp "qiskit.opflow.evolutions.evolved_op.EvolvedOp") | [*SummedOp*](qiskit.opflow.list_ops.SummedOp "qiskit.opflow.list_ops.summed_op.SummedOp")
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return a new Operator equal to the Operator’s adjoint (conjugate transpose), overloaded by `~`. For StateFns, this also turns the StateFn into a measurement.
+
+**Returns**
+
+An `OperatorBase` equivalent to the adjoint of self.
+
+**Return type**
+
+[*EvolvedOp*](#qiskit.opflow.evolutions.EvolvedOp "qiskit.opflow.evolutions.evolved_op.EvolvedOp")
+
+### assign\_parameters
+
+
+
+`assign_parameters(param_dict)`
+
+Binds scalar values to any Terra `Parameters` in the coefficients or primitives of the Operator, or substitutes one `Parameter` for another. This method differs from Terra’s `assign_parameters` in that it also supports lists of values to assign for a give `Parameter`, in which case self will be copied for each parameterization in the binding list(s), and all the copies will be returned in an `OpList`. If lists of parameterizations are used, every `Parameter` in the param\_dict must have the same length list of parameterizations.
+
+**Parameters**
+
+**param\_dict** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – The dictionary of `Parameters` to replace, and values or lists of values by which to replace them.
+
+**Returns**
+
+The `OperatorBase` with the `Parameters` in self replaced by the values or `Parameters` in param\_dict. If param\_dict contains parameterization lists, this `OperatorBase` is an `OpList`.
+
+**Return type**
+
+[*EvolvedOp*](#qiskit.opflow.evolutions.EvolvedOp "qiskit.opflow.evolutions.evolved_op.EvolvedOp") | [*ListOp*](qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.list_op.ListOp")
+
+### compose
+
+
+
+`compose(other, permutation=None, front=False)`
+
+Return Operator Composition between self and other (linear algebra-style: A\@B(x) = A(B(x))), overloaded by `@`.
+
+Note: You must be conscious of Quantum Circuit vs. Linear Algebra ordering conventions. Meaning, X.compose(Y) produces an X∘Y on qubit 0, but would produce a QuantumCircuit which looks like
+
+> -\[Y]-\[X]-
+
+Because Terra prints circuits with the initial state at the left side of the circuit.
+
+**Parameters**
+
+* **other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` with which to compose self.
+* **permutation** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – `List[int]` which defines permutation on other operator.
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If front==True, return `other.compose(self)`.
+
+**Returns**
+
+An `OperatorBase` equivalent to the function composition of self and other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### equals
+
+
+
+`equals(other)`
+
+Evaluate Equality between Operators, overloaded by `==`. Only returns True if self and other are of the same representation (e.g. a DictStateFn and CircuitStateFn will never be equal, even if their vector representations are equal), their underlying primitives are equal (this means for ListOps, OperatorStateFns, or EvolvedOps the equality is evaluated recursively downwards), and their coefficients are equal.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to compare to self.
+
+**Returns**
+
+A bool equal to the equality of self and other.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### eval
+
+
+
+`eval(front=None)`
+
+Evaluate the Operator’s underlying function, either on a binary string or another Operator. A square binary Operator can be defined as a function taking a binary function to another binary function. This method returns the value of that function for a given StateFn or binary string. For example, `op.eval('0110').eval('1110')` can be seen as querying the Operator’s matrix representation by row 6 and column 14, and will return the complex value at those “indices.” Similarly for a StateFn, `op.eval('1011')` will return the complex value at row 11 of the vector representation of the StateFn, as all StateFns are defined to be evaluated from Zero implicitly (i.e. it is as if `.eval('0000')` is already called implicitly to always “indexing” from column 0).
+
+If `front` is None, the matrix-representation of the operator is returned.
+
+**Parameters**
+
+**front** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *|*[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") *|*[*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.states.statevector.Statevector") *| None*) – The bitstring, dict of bitstrings (with values being coefficients), or StateFn to evaluated by the Operator’s underlying function, or None.
+
+**Returns**
+
+The output of the Operator’s evaluation function. If self is a `StateFn`, the result is a float or complex. If self is an Operator (`PrimitiveOp, ComposedOp, SummedOp, EvolvedOp,` etc.), the result is a StateFn. If `front` is None, the matrix-representation of the operator is returned, which is a `MatrixOp` for the operators and a `VectorStateFn` for state-functions. If either self or front contain proper `ListOps` (not ListOp subclasses), the result is an n-dimensional list of complex or StateFn results, resulting from the recursive evaluation by each OperatorBase in the ListOps.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") | [complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")
+
+### log\_i
+
+
+
+`log_i(massive=False)`
+
+Return a `MatrixOp` equivalent to log(H)/-i for this operator H. This function is the effective inverse of exp\_i, equivalent to finding the Hermitian Operator which produces self when exponentiated.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### permute
+
+
+
+`permute(permutation)`
+
+Permutes the qubits of the operator.
+
+**Parameters**
+
+**permutation** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – A list defining where each qubit should be permuted. The qubit at index j should be permuted to position permutation\[j].
+
+**Returns**
+
+A new OperatorBase containing the permuted operator.
+
+**Raises**
+
+[**OpflowError**](opflow#qiskit.opflow.OpflowError "qiskit.opflow.OpflowError") – if indices do not define a new index for each qubit.
+
+**Return type**
+
+[*EvolvedOp*](#qiskit.opflow.evolutions.EvolvedOp "qiskit.opflow.evolutions.evolved_op.EvolvedOp")
+
+### primitive\_strings
+
+
+
+`primitive_strings()`
+
+Return a set of strings describing the primitives contained in the Operator. For example, `{'QuantumCircuit', 'Pauli'}`. For hierarchical Operators, such as `ListOps`, this can help illuminate the primitives represented in the various recursive levels, and therefore which conversions can be applied.
+
+**Returns**
+
+A set of strings describing the primitives contained within the Operator.
+
+**Return type**
+
+[*Set*](https://docs.python.org/3/library/typing.html#typing.Set "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")]
+
+### reduce
+
+
+
+`reduce()`
+
+Try collapsing the Operator structure, usually after some type of conversion, e.g. trying to add Operators in a SummedOp or delete needless IGates in a CircuitOp. If no reduction is available, just returns self.
+
+**Returns**
+
+The reduced `OperatorBase`.
+
+**Return type**
+
+[*EvolvedOp*](#qiskit.opflow.evolutions.EvolvedOp "qiskit.opflow.evolutions.evolved_op.EvolvedOp")
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return tensor product between self and other, overloaded by `^`. Note: You must be conscious of Qiskit’s big-endian bit printing convention. Meaning, X.tensor(Y) produces an X on qubit 0 and an Y on qubit 1, or X⨂Y, but would produce a QuantumCircuit which looks like
+
+> -\[Y]- -\[X]-
+
+Because Terra prints circuits and results with qubit 0 at the end of the string or circuit.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to tensor product with self.
+
+**Returns**
+
+An `OperatorBase` equivalent to the tensor product of self and other.
+
+**Return type**
+
+[*TensoredOp*](qiskit.opflow.list_ops.TensoredOp "qiskit.opflow.list_ops.tensored_op.TensoredOp")
+
+### to\_instruction
+
+
+
+`to_instruction(massive=False)`
+
+Returns an `Instruction` equivalent to this Operator.
+
+**Return type**
+
+[*Instruction*](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")
+
+### to\_matrix
+
+
+
+`to_matrix(massive=False)`
+
+Return NumPy representation of the Operator. Represents the evaluation of the Operator’s underlying function on every combination of basis binary strings. Warn if more than 16 qubits to force having to set `massive=True` if such a large vector is desired.
+
+**Returns**
+
+The NumPy `ndarray` equivalent to this Operator.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+### to\_matrix\_op
+
+
+
+`to_matrix_op(massive=False)`
+
+Returns a `MatrixOp` equivalent to this Operator.
+
+**Return type**
+
+[*ListOp*](qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.list_op.ListOp") | [*MatrixOp*](qiskit.opflow.primitive_ops.MatrixOp "qiskit.opflow.primitive_ops.matrix_op.MatrixOp")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.evolutions.MatrixEvolution.md b/docs/api/qiskit/0.46/qiskit.opflow.evolutions.MatrixEvolution.md
new file mode 100644
index 00000000000..2314e9f47a2
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.evolutions.MatrixEvolution.md
@@ -0,0 +1,44 @@
+---
+title: MatrixEvolution
+description: API reference for qiskit.opflow.evolutions.MatrixEvolution
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.evolutions.MatrixEvolution
+---
+
+# MatrixEvolution
+
+
+
+`qiskit.opflow.evolutions.MatrixEvolution`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/evolutions/matrix_evolution.py "view source code")
+
+Bases: [`EvolutionBase`](qiskit.opflow.evolutions.EvolutionBase "qiskit.opflow.evolutions.evolution_base.EvolutionBase")
+
+Deprecated: Performs Evolution by classical matrix exponentiation, constructing a circuit with `UnitaryGates` or `HamiltonianGates` containing the exponentiation of the Operator.
+
+
+ The class `qiskit.opflow.evolutions.matrix_evolution.MatrixEvolution` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+## Methods
+
+### convert
+
+
+
+`convert(operator)`
+
+Traverse the operator, replacing `EvolvedOps` with `CircuitOps` containing `UnitaryGates` or `HamiltonianGates` (if self.coeff is a `ParameterExpression`) equalling the exponentiation of -i \* operator. This is done by converting the `EvolvedOp.primitive` to a `MatrixOp` and simply calling `.exp_i()` on that.
+
+**Parameters**
+
+**operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The Operator to convert.
+
+**Returns**
+
+The converted operator.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.evolutions.PauliTrotterEvolution.md b/docs/api/qiskit/0.46/qiskit.opflow.evolutions.PauliTrotterEvolution.md
new file mode 100644
index 00000000000..789f15d0a5e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.evolutions.PauliTrotterEvolution.md
@@ -0,0 +1,96 @@
+---
+title: PauliTrotterEvolution
+description: API reference for qiskit.opflow.evolutions.PauliTrotterEvolution
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.evolutions.PauliTrotterEvolution
+---
+
+# PauliTrotterEvolution
+
+
+
+`qiskit.opflow.evolutions.PauliTrotterEvolution(trotter_mode='trotter', reps=1)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/evolutions/pauli_trotter_evolution.py "view source code")
+
+Bases: [`EvolutionBase`](qiskit.opflow.evolutions.EvolutionBase "qiskit.opflow.evolutions.evolution_base.EvolutionBase")
+
+Deprecated: An Evolution algorithm replacing exponentiated sums of Paulis by changing them each to the Z basis, rotating with an rZ, changing back, and Trotterizing.
+
+More specifically, we compute basis change circuits for each Pauli into a single-qubit Z, evolve the Z by the desired evolution time with an rZ gate, and change the basis back using the adjoint of the original basis change circuit. For sums of Paulis, the individual Pauli evolution circuits are composed together by Trotterization scheme.
+
+
+ The class `qiskit.opflow.evolutions.pauli_trotter_evolution.PauliTrotterEvolution` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **trotter\_mode** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*TrotterizationBase*](qiskit.opflow.evolutions.TrotterizationBase "qiskit.opflow.evolutions.trotterizations.trotterization_base.TrotterizationBase") *| None*) – A string (‘trotter’, ‘suzuki’, or ‘qdrift’) to pass to the TrotterizationFactory, or a TrotterizationBase, indicating how to combine individual Pauli evolution circuits to equal the exponentiation of the Pauli sum.
+* **reps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – How many Trotterization repetitions to make, to improve the approximation accuracy.
+* **evolution.** (*# TODO uncomment when we implement Abelian grouped*) –
+* **group\_paulis** (*#*) – Whether to group Pauli sums into Abelian
+* **sub-groups** (*#*) –
+* **group** (*so a single diagonalization circuit can be used for each*) –
+* **Pauli.** (*# rather than each*) –
+
+## Attributes
+
+
+
+### trotter
+
+TrotterizationBase used to evolve SummedOps.
+
+## Methods
+
+### convert
+
+
+
+`convert(operator)`
+
+Traverse the operator, replacing `EvolvedOps` with `CircuitOps` containing Trotterized evolutions equalling the exponentiation of -i \* operator.
+
+**Parameters**
+
+**operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The Operator to convert.
+
+**Returns**
+
+The converted operator.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### evolution\_for\_abelian\_paulisum
+
+
+
+`evolution_for_abelian_paulisum(op_sum)`
+
+Evolution for abelian pauli sum
+
+**Return type**
+
+[*PrimitiveOp*](qiskit.opflow.primitive_ops.PrimitiveOp "qiskit.opflow.primitive_ops.primitive_op.PrimitiveOp")
+
+### evolution\_for\_pauli
+
+
+
+`evolution_for_pauli(pauli_op)`
+
+Compute evolution Operator for a single Pauli using a `PauliBasisChange`.
+
+**Parameters**
+
+**pauli\_op** ([*PauliOp*](qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.pauli_op.PauliOp")) – The `PauliOp` to evolve.
+
+**Returns**
+
+A `PrimitiveOp`, either the evolution `CircuitOp` or a `PauliOp` equal to the identity if pauli\_op is the identity.
+
+**Return type**
+
+[*PrimitiveOp*](qiskit.opflow.primitive_ops.PrimitiveOp "qiskit.opflow.primitive_ops.primitive_op.PrimitiveOp")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.evolutions.QDrift.md b/docs/api/qiskit/0.46/qiskit.opflow.evolutions.QDrift.md
new file mode 100644
index 00000000000..efb089f3120
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.evolutions.QDrift.md
@@ -0,0 +1,60 @@
+---
+title: QDrift
+description: API reference for qiskit.opflow.evolutions.QDrift
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.evolutions.QDrift
+---
+
+# QDrift
+
+
+
+`qiskit.opflow.evolutions.QDrift(reps=1)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/evolutions/trotterizations/qdrift.py "view source code")
+
+Bases: [`TrotterizationBase`](qiskit.opflow.evolutions.TrotterizationBase "qiskit.opflow.evolutions.trotterizations.trotterization_base.TrotterizationBase")
+
+Deprecated: The QDrift Trotterization method, which selects each each term in the Trotterization randomly, with a probability proportional to its weight. Based on the work of Earl Campbell in [https://arxiv.org/abs/1811.08017](https://arxiv.org/abs/1811.08017).
+
+
+ The class `qiskit.opflow.evolutions.trotterizations.qdrift.QDrift` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+**reps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of times to repeat the Trotterization circuit.
+
+## Attributes
+
+
+
+### reps
+
+The number of repetitions to use in the Trotterization, improving the approximation accuracy.
+
+## Methods
+
+### convert
+
+
+
+`convert(operator)`
+
+Convert a `SummedOp` into a `ComposedOp` or `CircuitOp` representing an approximation of e^-i\*\`\`op\_sum\`\`.
+
+**Parameters**
+
+**operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `SummedOp` to evolve.
+
+**Returns**
+
+The Operator approximating op\_sum’s evolution.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – A non-SummedOps Operator is passed into `convert`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.evolutions.Suzuki.md b/docs/api/qiskit/0.46/qiskit.opflow.evolutions.Suzuki.md
new file mode 100644
index 00000000000..4b73ffa457f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.evolutions.Suzuki.md
@@ -0,0 +1,69 @@
+---
+title: Suzuki
+description: API reference for qiskit.opflow.evolutions.Suzuki
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.evolutions.Suzuki
+---
+
+# Suzuki
+
+
+
+`qiskit.opflow.evolutions.Suzuki(reps=1, order=2)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/evolutions/trotterizations/suzuki.py "view source code")
+
+Bases: [`TrotterizationBase`](qiskit.opflow.evolutions.TrotterizationBase "qiskit.opflow.evolutions.trotterizations.trotterization_base.TrotterizationBase")
+
+Deprecated: Suzuki Trotter expansion, composing the evolution circuits of each Operator in the sum together by a recursive “bookends” strategy, repeating the whole composed circuit `reps` times.
+
+Detailed in [https://arxiv.org/pdf/quant-ph/0508139.pdf](https://arxiv.org/pdf/quant-ph/0508139.pdf).
+
+
+ The class `qiskit.opflow.evolutions.trotterizations.suzuki.Suzuki` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **reps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of times to repeat the expansion circuit.
+* **order** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The order of the expansion to perform.
+
+## Attributes
+
+
+
+### order
+
+returns order
+
+
+
+### reps
+
+The number of repetitions to use in the Trotterization, improving the approximation accuracy.
+
+## Methods
+
+### convert
+
+
+
+`convert(operator)`
+
+Convert a `SummedOp` into a `ComposedOp` or `CircuitOp` representing an approximation of e^-i\*\`\`op\_sum\`\`.
+
+**Parameters**
+
+**operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `SummedOp` to evolve.
+
+**Returns**
+
+The Operator approximating op\_sum’s evolution.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – A non-SummedOps Operator is passed into `convert`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.evolutions.Trotter.md b/docs/api/qiskit/0.46/qiskit.opflow.evolutions.Trotter.md
new file mode 100644
index 00000000000..54c4cd95666
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.evolutions.Trotter.md
@@ -0,0 +1,40 @@
+---
+title: Trotter
+description: API reference for qiskit.opflow.evolutions.Trotter
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.evolutions.Trotter
+---
+
+# Trotter
+
+
+
+`qiskit.opflow.evolutions.Trotter(reps=1)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/evolutions/trotterizations/trotter.py "view source code")
+
+Bases: [`Suzuki`](qiskit.opflow.evolutions.Suzuki "qiskit.opflow.evolutions.trotterizations.suzuki.Suzuki")
+
+Deprecated: Simple Trotter expansion, composing the evolution circuits of each Operator in the sum together `reps` times and dividing the evolution time of each by `reps`.
+
+
+ The class `qiskit.opflow.evolutions.trotterizations.trotter.Trotter` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+**reps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of times to repeat the Trotterization circuit.
+
+## Attributes
+
+
+
+### order
+
+returns order
+
+
+
+### reps
+
+The number of repetitions to use in the Trotterization, improving the approximation accuracy.
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.evolutions.TrotterizationBase.md b/docs/api/qiskit/0.46/qiskit.opflow.evolutions.TrotterizationBase.md
new file mode 100644
index 00000000000..df4299e6e1a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.evolutions.TrotterizationBase.md
@@ -0,0 +1,56 @@
+---
+title: TrotterizationBase
+description: API reference for qiskit.opflow.evolutions.TrotterizationBase
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.evolutions.TrotterizationBase
+---
+
+# TrotterizationBase
+
+
+
+`qiskit.opflow.evolutions.TrotterizationBase(reps=1)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/evolutions/trotterizations/trotterization_base.py "view source code")
+
+Bases: [`EvolutionBase`](qiskit.opflow.evolutions.EvolutionBase "qiskit.opflow.evolutions.evolution_base.EvolutionBase")
+
+Deprecated: A base for Trotterization methods, algorithms for approximating exponentiations of operator sums by compositions of exponentiations.
+
+
+ The class `qiskit.opflow.evolutions.trotterizations.trotterization_base.TrotterizationBase` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+## Attributes
+
+
+
+### reps
+
+The number of repetitions to use in the Trotterization, improving the approximation accuracy.
+
+## Methods
+
+### convert
+
+
+
+`abstract convert(operator)`
+
+Convert a `SummedOp` into a `ComposedOp` or `CircuitOp` representing an approximation of e^-i\*\`\`op\_sum\`\`.
+
+**Parameters**
+
+**operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `SummedOp` to evolve.
+
+**Returns**
+
+The Operator approximating op\_sum’s evolution.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – A non-SummedOps Operator is passed into `convert`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.evolutions.TrotterizationFactory.md b/docs/api/qiskit/0.46/qiskit.opflow.evolutions.TrotterizationFactory.md
new file mode 100644
index 00000000000..34f6052a78b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.evolutions.TrotterizationFactory.md
@@ -0,0 +1,49 @@
+---
+title: TrotterizationFactory
+description: API reference for qiskit.opflow.evolutions.TrotterizationFactory
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.evolutions.TrotterizationFactory
+---
+
+# TrotterizationFactory
+
+
+
+`qiskit.opflow.evolutions.TrotterizationFactory`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/evolutions/trotterizations/trotterization_factory.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Deprecated: A factory for conveniently creating TrotterizationBase instances.
+
+## Methods
+
+### build
+
+
+
+`static build(mode='trotter', reps=1)`
+
+A factory for conveniently creating TrotterizationBase instances.
+
+
+ The method `qiskit.opflow.evolutions.trotterizations.trotterization_factory.TrotterizationFactory.build()` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **mode** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – One of ‘trotter’, ‘suzuki’, ‘qdrift’
+* **reps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of times to repeat the Trotterization circuit.
+
+**Returns**
+
+The desired TrotterizationBase instance.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – A string not in \[‘trotter’, ‘suzuki’, ‘qdrift’] is given for mode.
+
+**Return type**
+
+[*TrotterizationBase*](qiskit.opflow.evolutions.TrotterizationBase "qiskit.opflow.evolutions.trotterizations.trotterization_base.TrotterizationBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.evolutions.md b/docs/api/qiskit/0.46/qiskit.opflow.evolutions.md
new file mode 100644
index 00000000000..1e9dc9e774c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.evolutions.md
@@ -0,0 +1,61 @@
+---
+title: evolutions
+description: API reference for qiskit.opflow.evolutions
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.opflow.evolutions
+---
+
+
+
+
+
+# qiskit.opflow\.evolutions
+
+
+
+## Operator Evolutions
+
+
+
+`qiskit.opflow.evolutions`
+
+
+ The [`qiskit.opflow`](opflow#module-qiskit.opflow "qiskit.opflow") module is deprecated and will be removed no earlier than 3 months after the release date. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+Evolutions are converters which traverse an Operator tree, replacing any [`EvolvedOp`](qiskit.opflow.evolutions.EvolvedOp "qiskit.opflow.evolutions.EvolvedOp") e with a Schrodinger equation-style evolution [`CircuitOp`](qiskit.opflow.primitive_ops.CircuitOp "qiskit.opflow.primitive_ops.CircuitOp") equalling or approximating the matrix exponential of -i \* the Operator contained inside (e.primitive). The Evolutions are essentially implementations of Hamiltonian Simulation algorithms, including various methods for Trotterization.
+
+The [`EvolvedOp`](qiskit.opflow.evolutions.EvolvedOp "qiskit.opflow.evolutions.EvolvedOp") is simply a placeholder signifying that the Operator inside it should be converted to its exponential by the Evolution converter. All Operators (not [`state_fns`](qiskit.opflow.state_fns#module-qiskit.opflow.state_fns "qiskit.opflow.state_fns")) have `.exp_i()` methods which either return the exponential of the Operator directly, or an [`EvolvedOp`](qiskit.opflow.evolutions.EvolvedOp "qiskit.opflow.evolutions.EvolvedOp") containing the Operator.
+
+
+ Evolutions work with parameterized Operator coefficients, so `my_expectation.convert((t * H).exp_i())`, where t is a scalar or Terra Parameter and H is an Operator, will produce a [`CircuitOp`](qiskit.opflow.primitive_ops.CircuitOp "qiskit.opflow.primitive_ops.CircuitOp") equivalent to e^iHt.
+
+
+### Evolution Base Class
+
+The EvolutionBase class gives an interface for algorithms to ask for Evolutions as execution settings. For example, if an algorithm contains an Operator evolution step within it, such as [`QAOA`](qiskit.algorithms.QAOA "qiskit.algorithms.QAOA"), the algorithm can give the opportunity for the user to pass an EvolutionBase of their choice to be used in that evolution step.
+
+| | |
+| ---------------------------------------------------------------------------------------------------- | -------------------------------------------- |
+| [`EvolutionBase`](qiskit.opflow.evolutions.EvolutionBase "qiskit.opflow.evolutions.EvolutionBase")() | Deprecated: A base for Evolution converters. |
+
+### Evolutions
+
+| | |
+| -------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`EvolutionFactory`](qiskit.opflow.evolutions.EvolutionFactory "qiskit.opflow.evolutions.EvolutionFactory")() | Deprecated: A factory class for convenient automatic selection of an Evolution algorithm based on the Operator to be converted. |
+| [`EvolvedOp`](qiskit.opflow.evolutions.EvolvedOp "qiskit.opflow.evolutions.EvolvedOp")(\*args, \*\*kwargs) | Deprecated: Class for wrapping Operator Evolutions for compilation (`convert`) by an EvolutionBase method later, essentially acting as a placeholder. |
+| [`MatrixEvolution`](qiskit.opflow.evolutions.MatrixEvolution "qiskit.opflow.evolutions.MatrixEvolution")() | Deprecated: Performs Evolution by classical matrix exponentiation, constructing a circuit with `UnitaryGates` or `HamiltonianGates` containing the exponentiation of the Operator. |
+| [`PauliTrotterEvolution`](qiskit.opflow.evolutions.PauliTrotterEvolution "qiskit.opflow.evolutions.PauliTrotterEvolution")(\[trotter\_mode, reps]) | Deprecated: An Evolution algorithm replacing exponentiated sums of Paulis by changing them each to the Z basis, rotating with an rZ, changing back, and Trotterizing. |
+
+### Trotterizations
+
+| | |
+| ---------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`TrotterizationBase`](qiskit.opflow.evolutions.TrotterizationBase "qiskit.opflow.evolutions.TrotterizationBase")(\[reps]) | Deprecated: A base for Trotterization methods, algorithms for approximating exponentiations of operator sums by compositions of exponentiations. |
+| [`TrotterizationFactory`](qiskit.opflow.evolutions.TrotterizationFactory "qiskit.opflow.evolutions.TrotterizationFactory")() | Deprecated: A factory for conveniently creating TrotterizationBase instances. |
+| [`Trotter`](qiskit.opflow.evolutions.Trotter "qiskit.opflow.evolutions.Trotter")(\[reps]) | Deprecated: Simple Trotter expansion, composing the evolution circuits of each Operator in the sum together `reps` times and dividing the evolution time of each by `reps`. |
+| [`Suzuki`](qiskit.opflow.evolutions.Suzuki "qiskit.opflow.evolutions.Suzuki")(\[reps, order]) | Deprecated: Suzuki Trotter expansion, composing the evolution circuits of each Operator in the sum together by a recursive "bookends" strategy, repeating the whole composed circuit `reps` times. |
+| [`QDrift`](qiskit.opflow.evolutions.QDrift "qiskit.opflow.evolutions.QDrift")(\[reps]) | Deprecated: The QDrift Trotterization method, which selects each each term in the Trotterization randomly, with a probability proportional to its weight. |
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.expectations.AerPauliExpectation.md b/docs/api/qiskit/0.46/qiskit.opflow.expectations.AerPauliExpectation.md
new file mode 100644
index 00000000000..c953da7ecdd
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.expectations.AerPauliExpectation.md
@@ -0,0 +1,64 @@
+---
+title: AerPauliExpectation
+description: API reference for qiskit.opflow.expectations.AerPauliExpectation
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.expectations.AerPauliExpectation
+---
+
+# AerPauliExpectation
+
+
+
+`qiskit.opflow.expectations.AerPauliExpectation`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/expectations/aer_pauli_expectation.py "view source code")
+
+Bases: [`ExpectationBase`](qiskit.opflow.expectations.ExpectationBase "qiskit.opflow.expectations.expectation_base.ExpectationBase")
+
+An Expectation converter for using Aer’s operator snapshot to take expectations of quantum state circuits over Pauli observables.
+
+
+ The class `qiskit.opflow.expectations.aer_pauli_expectation.AerPauliExpectation` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+## Methods
+
+### compute\_variance
+
+
+
+`compute_variance(exp_op)`
+
+Compute the variance of the expectation estimator. Because Aer takes this expectation with matrix multiplication, the estimation is exact and the variance is always 0, but we need to return those values in a way which matches the Operator’s structure.
+
+**Parameters**
+
+**exp\_op** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The full expectation value Operator after sampling.
+
+**Returns**
+
+The variances or lists thereof (if exp\_op contains ListOps) of the expectation value estimation, equal to 0.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") | [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+### convert
+
+
+
+`convert(operator)`
+
+Accept an Operator and return a new Operator with the Pauli measurements replaced by AerSnapshot-based expectation circuits.
+
+**Parameters**
+
+**operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The operator to convert. If it contains non-hermitian terms, the operator is decomposed into hermitian and anti-hermitian parts.
+
+**Returns**
+
+The converted operator.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.expectations.CVaRExpectation.md b/docs/api/qiskit/0.46/qiskit.opflow.expectations.CVaRExpectation.md
new file mode 100644
index 00000000000..5df1539ef46
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.expectations.CVaRExpectation.md
@@ -0,0 +1,89 @@
+---
+title: CVaRExpectation
+description: API reference for qiskit.opflow.expectations.CVaRExpectation
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.expectations.CVaRExpectation
+---
+
+# CVaRExpectation
+
+
+
+`qiskit.opflow.expectations.CVaRExpectation(alpha, expectation=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/expectations/cvar_expectation.py "view source code")
+
+Bases: [`ExpectationBase`](qiskit.opflow.expectations.ExpectationBase "qiskit.opflow.expectations.expectation_base.ExpectationBase")
+
+Deprecated: Compute the Conditional Value at Risk (CVaR) expectation value.
+
+The standard approach to calculating the expectation value of a Hamiltonian w\.r.t. a state is to take the sample mean of the measurement outcomes. This corresponds to an estimator of the energy. However in several problem settings with a diagonal Hamiltonian, e.g. in combinatorial optimization where the Hamiltonian encodes a cost function, we are not interested in calculating the energy but in the lowest possible value we can find.
+
+To this end, we might consider using the best observed sample as a cost function during variational optimization. The issue here, is that this can result in a non-smooth optimization surface. To resolve this issue, we can smooth the optimization surface by using not just the best observed sample, but instead average over some fraction of best observed samples. This is exactly what the CVaR estimator accomplishes \[1].
+
+It is empirically shown, that this can lead to faster convergence for combinatorial optimization problems.
+
+Let $\alpha$ be a real number in $[0,1]$ which specifies the fraction of best observed samples which are used to compute the objective function. Observe that if $\alpha = 1$, CVaR is equivalent to a standard expectation value. Similarly, if $\alpha = 0$, then CVaR corresponds to using the best observed sample. Intermediate values of $\alpha$ interpolate between these two objective functions.
+
+**References**
+
+**\[1]: Barkoutsos, P. K., Nannicini, G., Robert, A., Tavernelli, I., and Woerner, S.,**
+
+“Improving Variational Quantum Optimization using CVaR” [arXiv:1907.04769](https://arxiv.org/abs/1907.04769)
+
+
+ The class `qiskit.opflow.expectations.cvar_expectation.CVaRExpectation` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **alpha** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The alpha value describing the quantile considered in the expectation value.
+* **expectation** ([*ExpectationBase*](qiskit.opflow.expectations.ExpectationBase "qiskit.opflow.expectations.expectation_base.ExpectationBase") *| None*) – An expectation object to compute the expectation value. Defaults to the PauliExpectation calculation.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – If the `expectation` is an AerPauliExpecation.
+
+## Methods
+
+### compute\_variance
+
+
+
+`compute_variance(exp_op)`
+
+Returns the variance of the CVaR calculation
+
+**Parameters**
+
+**exp\_op** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The operator whose evaluation yields an expectation of some StateFn against a diagonal observable.
+
+**Returns**
+
+**The variance of the CVaR estimate corresponding to the converted**
+
+exp\_op.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If the exp\_op does not correspond to an expectation value.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") | [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+### convert
+
+
+
+`convert(operator)`
+
+Return an expression that computes the CVaR expectation upon calling `eval`. :param operator: The operator to convert.
+
+**Returns**
+
+The converted operator.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.expectations.ExpectationBase.md b/docs/api/qiskit/0.46/qiskit.opflow.expectations.ExpectationBase.md
new file mode 100644
index 00000000000..d5ddd286108
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.expectations.ExpectationBase.md
@@ -0,0 +1,64 @@
+---
+title: ExpectationBase
+description: API reference for qiskit.opflow.expectations.ExpectationBase
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.expectations.ExpectationBase
+---
+
+# ExpectationBase
+
+
+
+`qiskit.opflow.expectations.ExpectationBase`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/expectations/expectation_base.py "view source code")
+
+Bases: [`ConverterBase`](qiskit.opflow.converters.ConverterBase "qiskit.opflow.converters.converter_base.ConverterBase")
+
+Deprecated: A base for Expectation value converters. Expectations are converters which enable the computation of the expectation value of an Observable with respect to some state function. They traverse an Operator tree, replacing OperatorStateFn measurements with equivalent measurements which are more amenable to computation on quantum or classical hardware. For example, if one would like to measure the expectation value of an Operator `o` expressed as a sum of Paulis with respect to some state function, but only has access to diagonal measurements on Quantum hardware, we can create a measurement \~StateFn(o), use a `PauliExpectation` to convert it to a diagonal measurement and circuit pre-rotations to a append to the state, and sample this circuit on Quantum hardware with a CircuitSampler. All in all, this would be: `my_sampler.convert(my_expect.convert(~StateFn(o)) @ my_state).eval()`.
+
+
+ The class `qiskit.opflow.expectations.expectation_base.ExpectationBase` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+## Methods
+
+### compute\_variance
+
+
+
+`abstract compute_variance(exp_op)`
+
+Compute the variance of the expectation estimator.
+
+**Parameters**
+
+**exp\_op** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The full expectation value Operator after sampling.
+
+**Returns**
+
+The variances or lists thereof (if exp\_op contains ListOps) of the expectation value estimation.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") | [complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") | [*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+### convert
+
+
+
+`abstract convert(operator)`
+
+Accept an Operator and return a new Operator with the measurements replaced by alternate methods to compute the expectation value.
+
+**Parameters**
+
+**operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The operator to convert.
+
+**Returns**
+
+The converted operator.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.expectations.ExpectationFactory.md b/docs/api/qiskit/0.46/qiskit.opflow.expectations.ExpectationFactory.md
new file mode 100644
index 00000000000..4f2df062d28
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.expectations.ExpectationFactory.md
@@ -0,0 +1,50 @@
+---
+title: ExpectationFactory
+description: API reference for qiskit.opflow.expectations.ExpectationFactory
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.expectations.ExpectationFactory
+---
+
+# ExpectationFactory
+
+
+
+`qiskit.opflow.expectations.ExpectationFactory`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/expectations/expectation_factory.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Deprecated: factory class for convenient automatic selection of an Expectation based on the Operator to be converted and backend used to sample the expectation value.
+
+## Methods
+
+### build
+
+
+
+`static build(operator, backend=None, include_custom=True)`
+
+A factory method for convenient automatic selection of an Expectation based on the Operator to be converted and backend used to sample the expectation value.
+
+
+ The method `qiskit.opflow.expectations.expectation_factory.ExpectationFactory.build()` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The Operator whose expectation value will be taken.
+* **backend** ([*Backend*](qiskit.providers.Backend "qiskit.providers.backend.Backend") *|*[*QuantumInstance*](qiskit.utils.QuantumInstance "qiskit.utils.quantum_instance.QuantumInstance") *| None*) – The backend which will be used to sample the expectation value.
+* **include\_custom** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether the factory will include the (Aer) specific custom expectations if their behavior against the backend might not be as expected. For instance when using Aer qasm\_simulator with paulis the Aer snapshot can be used but the outcome lacks shot noise and hence does not intuitively behave overall as people might expect when choosing a qasm\_simulator. It is however fast as long as the more state vector like behavior is acceptable.
+
+**Returns**
+
+The expectation algorithm which best fits the Operator and backend.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If operator is not of a composition for which we know the best Expectation method.
+
+**Return type**
+
+[*ExpectationBase*](qiskit.opflow.expectations.ExpectationBase "qiskit.opflow.expectations.expectation_base.ExpectationBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.expectations.MatrixExpectation.md b/docs/api/qiskit/0.46/qiskit.opflow.expectations.MatrixExpectation.md
new file mode 100644
index 00000000000..a2d9345e208
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.expectations.MatrixExpectation.md
@@ -0,0 +1,64 @@
+---
+title: MatrixExpectation
+description: API reference for qiskit.opflow.expectations.MatrixExpectation
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.expectations.MatrixExpectation
+---
+
+# MatrixExpectation
+
+
+
+`qiskit.opflow.expectations.MatrixExpectation`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/expectations/matrix_expectation.py "view source code")
+
+Bases: [`ExpectationBase`](qiskit.opflow.expectations.ExpectationBase "qiskit.opflow.expectations.expectation_base.ExpectationBase")
+
+An Expectation converter which converts Operator measurements to be matrix-based so they can be evaluated by matrix multiplication.
+
+
+ The class `qiskit.opflow.expectations.matrix_expectation.MatrixExpectation` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+## Methods
+
+### compute\_variance
+
+
+
+`compute_variance(exp_op)`
+
+Compute the variance of the expectation estimator. Because this expectation works by matrix multiplication, the estimation is exact and the variance is always 0, but we need to return those values in a way which matches the Operator’s structure.
+
+**Parameters**
+
+**exp\_op** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The full expectation value Operator.
+
+**Returns**
+
+The variances or lists thereof (if exp\_op contains ListOps) of the expectation value estimation, equal to 0.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") | [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+### convert
+
+
+
+`convert(operator)`
+
+Accept an Operator and return a new Operator with the Pauli measurements replaced by Matrix based measurements.
+
+**Parameters**
+
+**operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The operator to convert.
+
+**Returns**
+
+The converted operator.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.expectations.PauliExpectation.md b/docs/api/qiskit/0.46/qiskit.opflow.expectations.PauliExpectation.md
new file mode 100644
index 00000000000..b1aee536e3b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.expectations.PauliExpectation.md
@@ -0,0 +1,68 @@
+---
+title: PauliExpectation
+description: API reference for qiskit.opflow.expectations.PauliExpectation
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.expectations.PauliExpectation
+---
+
+# PauliExpectation
+
+
+
+`qiskit.opflow.expectations.PauliExpectation(group_paulis=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/expectations/pauli_expectation.py "view source code")
+
+Bases: [`ExpectationBase`](qiskit.opflow.expectations.ExpectationBase "qiskit.opflow.expectations.expectation_base.ExpectationBase")
+
+An Expectation converter for Pauli-basis observables by changing Pauli measurements to a diagonal (\{Z, I}^n) basis and appending circuit post-rotations to the measured state function. Optionally groups the Paulis with the same post-rotations (those that commute with one another, or form Abelian groups) into single measurements to reduce circuit execution overhead.
+
+
+ The class `qiskit.opflow.expectations.pauli_expectation.PauliExpectation` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+**group\_paulis** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to group the Pauli measurements into commuting sums, which all have the same diagonalizing circuit.
+
+## Methods
+
+### compute\_variance
+
+
+
+`compute_variance(exp_op)`
+
+Compute the variance of the expectation estimator.
+
+**Parameters**
+
+**exp\_op** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The full expectation value Operator after sampling.
+
+**Returns**
+
+The variances or lists thereof (if exp\_op contains ListOps) of the expectation value estimation.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") | [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") | [*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+### convert
+
+
+
+`convert(operator)`
+
+Accepts an Operator and returns a new Operator with the Pauli measurements replaced by diagonal Pauli post-rotation based measurements so they can be evaluated by sampling and averaging.
+
+**Parameters**
+
+**operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The operator to convert.
+
+**Returns**
+
+The converted operator.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.expectations.md b/docs/api/qiskit/0.46/qiskit.opflow.expectations.md
new file mode 100644
index 00000000000..50b011bb433
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.expectations.md
@@ -0,0 +1,46 @@
+---
+title: expectations
+description: API reference for qiskit.opflow.expectations
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.opflow.expectations
+---
+
+
+
+
+
+# qiskit.opflow\.expectations
+
+
+
+## Expectations
+
+
+
+`qiskit.opflow.expectations`
+
+
+ The [`qiskit.opflow`](opflow#module-qiskit.opflow "qiskit.opflow") module is deprecated and will be removed no earlier than 3 months after the release date. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+Expectations are converters which enable the computation of the expectation value of an Observable with respect to some state function. They traverse an Operator tree, replacing [`OperatorStateFn`](qiskit.opflow.state_fns.OperatorStateFn "qiskit.opflow.state_fns.OperatorStateFn") measurements with equivalent measurements which are more amenable to computation on quantum or classical hardware. For example, if one would like to measure the expectation value of an Operator `o` expressed as a sum of Paulis with respect to some state function, but only has access to diagonal measurements on Quantum hardware, we can create a measurement \~StateFn(o), use a [`PauliExpectation`](qiskit.opflow.expectations.PauliExpectation "qiskit.opflow.expectations.PauliExpectation") to convert it to a diagonal measurement and circuit pre-rotations to append to the state, and sample this circuit on Quantum hardware with a [`CircuitSampler`](qiskit.opflow.converters.CircuitSampler "qiskit.opflow.converters.CircuitSampler"). All in all, this would be: `my_sampler.convert(my_expect.convert(~StateFn(o)) @ my_state).eval()`.
+
+### Expectation Base Class
+
+The ExpectationBase class gives an interface for algorithms to ask for Expectations as execution settings. For example, if an algorithm contains an expectation value step within it, such as [`VQE`](qiskit.algorithms.VQE "qiskit.algorithms.VQE"), the algorithm can give the opportunity for the user to pass an ExpectationBase of their choice to be used in that expectation value step.
+
+| | |
+| -------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
+| [`ExpectationBase`](qiskit.opflow.expectations.ExpectationBase "qiskit.opflow.expectations.ExpectationBase")() | Deprecated: A base for Expectation value converters. |
+
+### Expectations
+
+| | |
+| ----------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`ExpectationFactory`](qiskit.opflow.expectations.ExpectationFactory "qiskit.opflow.expectations.ExpectationFactory")() | Deprecated: factory class for convenient automatic selection of an Expectation based on the Operator to be converted and backend used to sample the expectation value. |
+| [`AerPauliExpectation`](qiskit.opflow.expectations.AerPauliExpectation "qiskit.opflow.expectations.AerPauliExpectation")() | An Expectation converter for using Aer's operator snapshot to take expectations of quantum state circuits over Pauli observables. |
+| [`MatrixExpectation`](qiskit.opflow.expectations.MatrixExpectation "qiskit.opflow.expectations.MatrixExpectation")() | An Expectation converter which converts Operator measurements to be matrix-based so they can be evaluated by matrix multiplication. |
+| [`PauliExpectation`](qiskit.opflow.expectations.PauliExpectation "qiskit.opflow.expectations.PauliExpectation")(\[group\_paulis]) | An Expectation converter for Pauli-basis observables by changing Pauli measurements to a diagonal (\{Z, I}^n) basis and appending circuit post-rotations to the measured state function. |
+| [`CVaRExpectation`](qiskit.opflow.expectations.CVaRExpectation "qiskit.opflow.expectations.CVaRExpectation")(alpha\[, expectation]) | Deprecated: Compute the Conditional Value at Risk (CVaR) expectation value. |
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.gradients.CircuitGradient.md b/docs/api/qiskit/0.46/qiskit.opflow.gradients.CircuitGradient.md
new file mode 100644
index 00000000000..65d2d429cec
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.gradients.CircuitGradient.md
@@ -0,0 +1,53 @@
+---
+title: CircuitGradient
+description: API reference for qiskit.opflow.gradients.CircuitGradient
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.gradients.CircuitGradient
+---
+
+# CircuitGradient
+
+
+
+`qiskit.opflow.gradients.CircuitGradient`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/gradients/circuit_gradients/circuit_gradient.py "view source code")
+
+Bases: [`ConverterBase`](qiskit.opflow.converters.ConverterBase "qiskit.opflow.converters.converter_base.ConverterBase")
+
+Deprecated: Circuit to gradient operator converter.
+
+Converter for changing parameterized circuits into operators whose evaluation yields the gradient with respect to the circuit parameters.
+
+This is distinct from DerivativeBase converters which take gradients of composite operators and handle things like differentiating combo\_fn’s and enforcing product rules when operator coefficients are parameterized.
+
+CircuitGradient - uses quantum techniques to get derivatives of circuits DerivativeBase - uses classical techniques to differentiate operator flow data structures
+
+
+ The class `qiskit.opflow.gradients.circuit_gradients.circuit_gradient.CircuitGradient` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+## Methods
+
+### convert
+
+
+
+`abstract convert(operator, params=None)`
+
+**Parameters**
+
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The operator we are taking the gradient of
+* **params** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*ParameterVector*](qiskit.circuit.ParameterVector "qiskit.circuit.parametervector.ParameterVector") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*] |* [*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*,* [*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*] |* [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*,* [*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*]] | None*) – The parameters we are taking the gradient wrt: ω If a ParameterExpression, ParameterVector or List\[ParameterExpression] is given, then the 1st order derivative of the operator is calculated. If a Tuple\[ParameterExpression, ParameterExpression] or List\[Tuple\[ParameterExpression, ParameterExpression]] is given, then the 2nd order derivative of the operator is calculated.
+
+**Returns**
+
+An operator whose evaluation yields the Gradient.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `params` contains a parameter not present in `operator`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.gradients.CircuitQFI.md b/docs/api/qiskit/0.46/qiskit.opflow.gradients.CircuitQFI.md
new file mode 100644
index 00000000000..faf06323354
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.gradients.CircuitQFI.md
@@ -0,0 +1,53 @@
+---
+title: CircuitQFI
+description: API reference for qiskit.opflow.gradients.CircuitQFI
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.gradients.CircuitQFI
+---
+
+# CircuitQFI
+
+
+
+`qiskit.opflow.gradients.CircuitQFI`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/gradients/circuit_qfis/circuit_qfi.py "view source code")
+
+Bases: [`ConverterBase`](qiskit.opflow.converters.ConverterBase "qiskit.opflow.converters.converter_base.ConverterBase")
+
+Deprecated: Circuit to Quantum Fisher Information operator converter.
+
+Converter for changing parameterized circuits into operators whose evaluation yields Quantum Fisher Information metric tensor with respect to the given circuit parameters
+
+This is distinct from DerivativeBase converters which take gradients of composite operators and handle things like differentiating combo\_fn’s and enforcing product rules when operator coefficients are parameterized.
+
+CircuitQFI - uses quantum techniques to get the QFI of circuits DerivativeBase - uses classical techniques to differentiate opflow data structures
+
+
+ The class `qiskit.opflow.gradients.circuit_qfis.circuit_qfi.CircuitQFI` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+## Methods
+
+### convert
+
+
+
+`abstract convert(operator, params)`
+
+**Parameters**
+
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The operator corresponding to the quantum state $|\psi(\omega)\rangle$ for which we compute the QFI.
+* **params** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*ParameterVector*](qiskit.circuit.ParameterVector "qiskit.circuit.parametervector.ParameterVector") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*]*) – The parameters $\omega$ with respect to which we are computing the QFI.
+
+**Returns**
+
+An operator whose evaluation yields the QFI metric tensor.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `params` contains a parameter not present in `operator`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.gradients.DerivativeBase.md b/docs/api/qiskit/0.46/qiskit.opflow.gradients.DerivativeBase.md
new file mode 100644
index 00000000000..b8d8c50415c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.gradients.DerivativeBase.md
@@ -0,0 +1,102 @@
+---
+title: DerivativeBase
+description: API reference for qiskit.opflow.gradients.DerivativeBase
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.gradients.DerivativeBase
+---
+
+# DerivativeBase
+
+
+
+`qiskit.opflow.gradients.DerivativeBase`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/gradients/derivative_base.py "view source code")
+
+Bases: [`ConverterBase`](qiskit.opflow.converters.ConverterBase "qiskit.opflow.converters.converter_base.ConverterBase")
+
+Deprecated: Base class for differentiating opflow objects.
+
+Converter for differentiating opflow objects and handling things like properly differentiating combo\_fn’s and enforcing product rules when operator coefficients are parameterized.
+
+This is distinct from CircuitGradient converters which use quantum techniques such as parameter shifts and linear combination of unitaries to compute derivatives of circuits.
+
+CircuitGradient - uses quantum techniques to get derivatives of circuits DerivativeBase - uses classical techniques to differentiate opflow data structures
+
+
+ The class `qiskit.opflow.gradients.derivative_base.DerivativeBase` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+## Methods
+
+### convert
+
+
+
+`abstract convert(operator, params=None)`
+
+**Parameters**
+
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The operator we are taking the gradient, Hessian or QFI of
+* **params** ([*ParameterVector*](qiskit.circuit.ParameterVector "qiskit.circuit.parametervector.ParameterVector") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*] | None*) – The parameters we are taking the gradient, Hessian or QFI with respect to.
+
+**Returns**
+
+An operator whose evaluation yields the gradient, Hessian or QFI.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `params` contains a parameter not present in `operator`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### gradient\_wrapper
+
+
+
+`gradient_wrapper(operator, bind_params, grad_params=None, backend=None, expectation=None)`
+
+Get a callable function which provides the respective gradient, Hessian or QFI for given parameter values. This callable can be used as gradient function for optimizers.
+
+**Parameters**
+
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The operator for which we want to get the gradient, Hessian or QFI.
+* **bind\_params** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*ParameterVector*](qiskit.circuit.ParameterVector "qiskit.circuit.parametervector.ParameterVector") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*]*) – The operator parameters to which the parameter values are assigned.
+* **grad\_params** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*ParameterVector*](qiskit.circuit.ParameterVector "qiskit.circuit.parametervector.ParameterVector") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*] |* [*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*,* [*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*] |* [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*,* [*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*]] | None*) – The parameters with respect to which we are taking the gradient, Hessian or QFI. If grad\_params = None, then grad\_params = bind\_params
+* **backend** ([*Backend*](qiskit.providers.Backend "qiskit.providers.backend.Backend") *|*[*QuantumInstance*](qiskit.utils.QuantumInstance "qiskit.utils.quantum_instance.QuantumInstance") *| None*) – The quantum backend or QuantumInstance to use to evaluate the gradient, Hessian or QFI.
+* **expectation** ([*ExpectationBase*](qiskit.opflow.expectations.ExpectationBase "qiskit.opflow.expectations.expectation_base.ExpectationBase") *| None*) – The expectation converter to be used. If none is set then PauliExpectation() is used.
+
+**Returns**
+
+Function to compute a gradient, Hessian or QFI. The function takes an iterable as argument which holds the parameter values.
+
+**Return type**
+
+[*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")\[\[[*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")], [*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")]
+
+### parameter\_expression\_grad
+
+
+
+`static parameter_expression_grad(param_expr, param)`
+
+Get the derivative of a parameter expression w\.r.t. the given parameter.
+
+
+ The method `qiskit.opflow.gradients.derivative_base.DerivativeBase.parameter_expression_grad()` is deprecated as of qiskit-terra 0.18.0. It will be removed in the Qiskit 1.0 release. Instead, use the ParameterExpression.gradient method.
+
+
+**Parameters**
+
+* **param\_expr** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The Parameter Expression for which we compute the derivative
+* **param** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – Parameter w\.r.t. which we want to take the derivative
+
+**Returns**
+
+ParameterExpression representing the gradient of param\_expr w\.r.t. param
+
+**Return type**
+
+[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") | [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.gradients.Gradient.md b/docs/api/qiskit/0.46/qiskit.opflow.gradients.Gradient.md
new file mode 100644
index 00000000000..885c06ef981
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.gradients.Gradient.md
@@ -0,0 +1,90 @@
+---
+title: Gradient
+description: API reference for qiskit.opflow.gradients.Gradient
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.gradients.Gradient
+---
+
+# Gradient
+
+
+
+`qiskit.opflow.gradients.Gradient(grad_method='param_shift', **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/gradients/gradient.py "view source code")
+
+Bases: [`GradientBase`](qiskit.opflow.gradients.GradientBase "qiskit.opflow.gradients.gradient_base.GradientBase")
+
+Deprecated: Convert an operator expression to the first-order gradient.
+
+
+ The class `qiskit.opflow.gradients.gradient.Gradient` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+## Attributes
+
+
+
+### grad\_method
+
+Returns `CircuitGradient`.
+
+**Returns**
+
+`CircuitGradient`.
+
+## Methods
+
+### convert
+
+
+
+`convert(operator, params=None)`
+
+**Parameters**
+
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The operator we are taking the gradient of.
+* **params** ([*ParameterVector*](qiskit.circuit.ParameterVector "qiskit.circuit.parametervector.ParameterVector") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*] | None*) – The parameters we are taking the gradient with respect to. If not explicitly passed, they are inferred from the operator and sorted by name.
+
+**Returns**
+
+An operator whose evaluation yields the Gradient.
+
+**Raises**
+
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `params` contains a parameter not present in `operator`.
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `operator` is not parameterized.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### get\_gradient
+
+
+
+`get_gradient(operator, params)`
+
+Get the gradient for the given operator w\.r.t. the given parameters
+
+**Parameters**
+
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – Operator w\.r.t. which we take the gradient.
+* **params** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*ParameterVector*](qiskit.circuit.ParameterVector "qiskit.circuit.parametervector.ParameterVector") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*]*) – Parameters w\.r.t. which we compute the gradient.
+
+**Returns**
+
+Operator which represents the gradient w\.r.t. the given params.
+
+**Raises**
+
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `params` contains a parameter not present in `operator`.
+* [**OpflowError**](opflow#qiskit.opflow.OpflowError "qiskit.opflow.OpflowError") – If the coefficient of the operator could not be reduced to 1.
+* [**OpflowError**](opflow#qiskit.opflow.OpflowError "qiskit.opflow.OpflowError") – If the differentiation of a combo\_fn requires JAX but the package is not installed.
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – If the operator does not include a StateFn given by a quantum circuit
+* [**Exception**](https://docs.python.org/3/library/exceptions.html#Exception "(in Python v3.12)") – Unintended code is reached
+* [**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – jax not installed
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.gradients.GradientBase.md b/docs/api/qiskit/0.46/qiskit.opflow.gradients.GradientBase.md
new file mode 100644
index 00000000000..ca5fac01841
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.gradients.GradientBase.md
@@ -0,0 +1,45 @@
+---
+title: GradientBase
+description: API reference for qiskit.opflow.gradients.GradientBase
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.gradients.GradientBase
+---
+
+# GradientBase
+
+
+
+`qiskit.opflow.gradients.GradientBase(grad_method='param_shift', **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/gradients/gradient_base.py "view source code")
+
+Bases: [`DerivativeBase`](qiskit.opflow.gradients.DerivativeBase "qiskit.opflow.gradients.derivative_base.DerivativeBase")
+
+Deprecated: Base class for first-order operator gradient.
+
+Convert an operator expression to the first-order gradient.
+
+
+ The class `qiskit.opflow.gradients.gradient_base.GradientBase` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **grad\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*CircuitGradient*](qiskit.opflow.gradients.CircuitGradient "qiskit.opflow.gradients.circuit_gradients.circuit_gradient.CircuitGradient")) – The method used to compute the state/probability gradient. Can be either `'param_shift'` or `'lin_comb'` or `'fin_diff'`. Ignored for gradients w\.r.t observable parameters.
+* **kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – Optional parameters for a CircuitGradient
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If method != `fin_diff` and `epsilon` is not None.
+
+## Attributes
+
+
+
+### grad\_method
+
+Returns `CircuitGradient`.
+
+**Returns**
+
+`CircuitGradient`.
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.gradients.Hessian.md b/docs/api/qiskit/0.46/qiskit.opflow.gradients.Hessian.md
new file mode 100644
index 00000000000..7ec267a1205
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.gradients.Hessian.md
@@ -0,0 +1,87 @@
+---
+title: Hessian
+description: API reference for qiskit.opflow.gradients.Hessian
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.gradients.Hessian
+---
+
+# Hessian
+
+
+
+`qiskit.opflow.gradients.Hessian(hess_method='param_shift', **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/gradients/hessian.py "view source code")
+
+Bases: [`HessianBase`](qiskit.opflow.gradients.HessianBase "qiskit.opflow.gradients.hessian_base.HessianBase")
+
+Deprecated: Compute the Hessian of an expected value.
+
+
+ The class `qiskit.opflow.gradients.hessian.Hessian` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+## Attributes
+
+
+
+### hess\_method
+
+Returns `CircuitGradient`.
+
+**Returns**
+
+`CircuitGradient`.
+
+## Methods
+
+### convert
+
+
+
+`convert(operator, params=None)`
+
+**Parameters**
+
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The operator for which we compute the Hessian
+* **params** ([*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*,* [*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*] |* [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*,* [*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*]] |* [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*] |* [*ParameterVector*](qiskit.circuit.ParameterVector "qiskit.circuit.parametervector.ParameterVector") *| None*) – The parameters we are computing the Hessian with respect to Either give directly the tuples/list of tuples for which the second order derivative is to be computed or give a list of parameters to build the full Hessian for those parameters. If not explicitly passed, the full Hessian is constructed. The parameters are then inferred from the operator and sorted by name.
+
+**Returns**
+
+An operator whose evaluation yields the Hessian
+
+**Return type**
+
+[OperatorBase](qiskit.opflow.OperatorBase "qiskit.opflow.OperatorBase")
+
+### get\_hessian
+
+
+
+`get_hessian(operator, params=None)`
+
+Get the Hessian for the given operator w\.r.t. the given parameters
+
+**Parameters**
+
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – Operator w\.r.t. which we take the Hessian.
+* **params** ([*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*,* [*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*] |* [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*,* [*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*]] |* [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*] |* [*ParameterVector*](qiskit.circuit.ParameterVector "qiskit.circuit.parametervector.ParameterVector") *| None*) – Parameters w\.r.t. which we compute the Hessian. If not explicitly passed, the full Hessian is constructed. The parameters are then inferred from the operator and sorted by name.
+
+**Returns**
+
+Operator which represents the gradient w\.r.t. the given params.
+
+**Raises**
+
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `params` contains a parameter not present in `operator`.
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `operator` is not parameterized.
+* [**OpflowError**](opflow#qiskit.opflow.OpflowError "qiskit.opflow.OpflowError") – If the coefficient of the operator could not be reduced to 1.
+* [**OpflowError**](opflow#qiskit.opflow.OpflowError "qiskit.opflow.OpflowError") – If the differentiation of a combo\_fn requires JAX but the package is not installed.
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – If the operator does not include a StateFn given by a quantum circuit
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – If the parameters were given in an unsupported format.
+* [**Exception**](https://docs.python.org/3/library/exceptions.html#Exception "(in Python v3.12)") – Unintended code is reached
+* [**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – jax not installed
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.gradients.HessianBase.md b/docs/api/qiskit/0.46/qiskit.opflow.gradients.HessianBase.md
new file mode 100644
index 00000000000..5b748e0e0fe
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.gradients.HessianBase.md
@@ -0,0 +1,43 @@
+---
+title: HessianBase
+description: API reference for qiskit.opflow.gradients.HessianBase
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.gradients.HessianBase
+---
+
+# HessianBase
+
+
+
+`qiskit.opflow.gradients.HessianBase(hess_method='param_shift', **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/gradients/hessian_base.py "view source code")
+
+Bases: [`DerivativeBase`](qiskit.opflow.gradients.DerivativeBase "qiskit.opflow.gradients.derivative_base.DerivativeBase")
+
+Deprecated: Base class for the Hessian of an expected value.
+
+
+ The class `qiskit.opflow.gradients.hessian_base.HessianBase` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **hess\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*CircuitGradient*](qiskit.opflow.gradients.CircuitGradient "qiskit.opflow.gradients.circuit_gradients.circuit_gradient.CircuitGradient")) – The method used to compute the state/probability gradient. Can be either `'param_shift'` or `'lin_comb'` or `'fin_diff'`. Ignored for gradients w\.r.t observable parameters.
+* **kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – Optional parameters for a CircuitGradient
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If method != `fin_diff` and `epsilon` is not None.
+
+## Attributes
+
+
+
+### hess\_method
+
+Returns `CircuitGradient`.
+
+**Returns**
+
+`CircuitGradient`.
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.gradients.NaturalGradient.md b/docs/api/qiskit/0.46/qiskit.opflow.gradients.NaturalGradient.md
new file mode 100644
index 00000000000..d894df8caba
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.gradients.NaturalGradient.md
@@ -0,0 +1,119 @@
+---
+title: NaturalGradient
+description: API reference for qiskit.opflow.gradients.NaturalGradient
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.gradients.NaturalGradient
+---
+
+# NaturalGradient
+
+
+
+`qiskit.opflow.gradients.NaturalGradient(grad_method='lin_comb', qfi_method='lin_comb_full', regularization=None, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/gradients/natural_gradient.py "view source code")
+
+Bases: [`GradientBase`](qiskit.opflow.gradients.GradientBase "qiskit.opflow.gradients.gradient_base.GradientBase")
+
+Deprecated: Convert an operator expression to the first-order gradient.
+
+Given an ill-posed inverse problem
+
+> x = arg min\{||Ax-C||^2} (1)
+
+one can use regularization schemes can be used to stabilize the system and find a numerical solution
+
+> x\_lambda = arg min\{||Ax-C||^2 + lambda\*R(x)} (2)
+
+where R(x) represents the penalization term.
+
+
+ The class `qiskit.opflow.gradients.natural_gradient.NaturalGradient` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **grad\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*CircuitGradient*](qiskit.opflow.gradients.CircuitGradient "qiskit.opflow.gradients.circuit_gradients.circuit_gradient.CircuitGradient")) – The method used to compute the state gradient. Can be either `'param_shift'` or `'lin_comb'` or `'fin_diff'`.
+* **qfi\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*CircuitQFI*](qiskit.opflow.gradients.CircuitQFI "qiskit.opflow.gradients.circuit_qfis.circuit_qfi.CircuitQFI")) – The method used to compute the QFI. Can be either `'lin_comb_full'` or `'overlap_block_diag'` or `'overlap_diag'`.
+* **regularization** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Use the following regularization with a least square method to solve the underlying system of linear equations Can be either None or `'ridge'` or `'lasso'` or `'perturb_diag'` `'ridge'` and `'lasso'` use an automatic optimal parameter search If regularization is None but the metric is ill-conditioned or singular then a least square solver is used without regularization
+* **kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – Optional parameters for a CircuitGradient
+
+## Attributes
+
+
+
+### grad\_method
+
+Returns `CircuitGradient`.
+
+**Returns**
+
+`CircuitGradient`.
+
+
+
+### qfi\_method
+
+Returns `CircuitQFI`.
+
+Returns: `CircuitQFI`.
+
+
+
+### regularization
+
+Returns the regularization option.
+
+Returns: the regularization option.
+
+## Methods
+
+### convert
+
+
+
+`convert(operator, params=None)`
+
+**Parameters**
+
+* **operator** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The operator we are taking the gradient of.
+* **params** ([*ParameterVector*](qiskit.circuit.ParameterVector "qiskit.circuit.parametervector.ParameterVector") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*] | None*) – The parameters we are taking the gradient with respect to. If not explicitly passed, they are inferred from the operator and sorted by name.
+
+**Returns**
+
+An operator whose evaluation yields the NaturalGradient.
+
+**Raises**
+
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – If `operator` does not represent an expectation value or the quantum state is not `CircuitStateFn`.
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `params` contains a parameter not present in `operator`.
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `operator` is not parameterized.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### nat\_grad\_combo\_fn
+
+
+
+`static nat_grad_combo_fn(x, regularization=None)`
+
+Natural Gradient Function Implementation.
+
+**Parameters**
+
+* **x** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – Iterable consisting of Gradient, Quantum Fisher Information.
+* **regularization** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Regularization method.
+
+**Returns**
+
+Natural Gradient.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If the gradient has imaginary components that are non-negligible.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.gradients.QFI.md b/docs/api/qiskit/0.46/qiskit.opflow.gradients.QFI.md
new file mode 100644
index 00000000000..eab7417bdc2
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.gradients.QFI.md
@@ -0,0 +1,66 @@
+---
+title: QFI
+description: API reference for qiskit.opflow.gradients.QFI
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.gradients.QFI
+---
+
+# QFI
+
+
+
+`qiskit.opflow.gradients.QFI(qfi_method='lin_comb_full')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/gradients/qfi.py "view source code")
+
+Bases: [`QFIBase`](qiskit.opflow.gradients.QFIBase "qiskit.opflow.gradients.qfi_base.QFIBase")
+
+Deprecated: Compute the Quantum Fisher Information (QFI).
+
+Computes the QFI given a pure, parameterized quantum state, where QFI is:
+
+$$
+\mathrm{QFI}_{kl}= 4 \mathrm{Re}[\langle \partial_k \psi | \partial_l \psi \rangle
+ − \langle\partial_k \psi | \psi \rangle \langle\psi | \partial_l \psi \rangle].
+$$
+
+
+ The class `qiskit.opflow.gradients.qfi.QFI` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+## Attributes
+
+
+
+### qfi\_method
+
+Returns `CircuitQFI`.
+
+**Returns**
+
+`CircuitQFI`.
+
+## Methods
+
+### convert
+
+
+
+`convert(operator, params=None)`
+
+**Parameters**
+
+* **operator** ([*CircuitStateFn*](qiskit.opflow.state_fns.CircuitStateFn "qiskit.opflow.state_fns.circuit_state_fn.CircuitStateFn")) – The operator corresponding to the quantum state |ψ(ω)〉for which we compute the QFI
+* **params** ([*ParameterVector*](qiskit.circuit.ParameterVector "qiskit.circuit.parametervector.ParameterVector") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*] | None*) – The parameters we are computing the QFI wrt: ω If not explicitly passed, they are inferred from the operator and sorted by name.
+
+**Returns**
+
+ListOp\[ListOp] where the operator at position k,l corresponds to QFI\_kl
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If operator is not parameterized.
+
+**Return type**
+
+[*ListOp*](qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.list_op.ListOp")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.gradients.QFIBase.md b/docs/api/qiskit/0.46/qiskit.opflow.gradients.QFIBase.md
new file mode 100644
index 00000000000..552b5165d0f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.gradients.QFIBase.md
@@ -0,0 +1,48 @@
+---
+title: QFIBase
+description: API reference for qiskit.opflow.gradients.QFIBase
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.gradients.QFIBase
+---
+
+# QFIBase
+
+
+
+`qiskit.opflow.gradients.QFIBase(qfi_method='lin_comb_full')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/gradients/qfi_base.py "view source code")
+
+Bases: [`DerivativeBase`](qiskit.opflow.gradients.DerivativeBase "qiskit.opflow.gradients.derivative_base.DerivativeBase")
+
+Deprecated: Base class for Quantum Fisher Information (QFI).
+
+Compute the Quantum Fisher Information (QFI) given a pure, parameterized quantum state.
+
+The QFI is:
+
+> \[QFI]kl= Re\[〈∂kψ|∂lψ〉−〈∂kψ|ψ〉〈ψ|∂lψ〉] \* 4.
+
+
+ The class `qiskit.opflow.gradients.qfi_base.QFIBase` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+**qfi\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*CircuitQFI*](qiskit.opflow.gradients.CircuitQFI "qiskit.opflow.gradients.circuit_qfis.circuit_qfi.CircuitQFI")) – The method used to compute the state/probability gradient. Can be either a [`CircuitQFI`](qiskit.opflow.gradients.CircuitQFI "qiskit.opflow.gradients.CircuitQFI") instance or one of the following pre-defined strings `'lin_comb_full'`, `` 'overlap_diag'` `` or `` 'overlap_block_diag'` ``.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – if `qfi_method` is neither a `CircuitQFI` object nor one of the predefined strings.
+
+## Attributes
+
+
+
+### qfi\_method
+
+Returns `CircuitQFI`.
+
+**Returns**
+
+`CircuitQFI`.
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.gradients.md b/docs/api/qiskit/0.46/qiskit.opflow.gradients.md
new file mode 100644
index 00000000000..982d7fe6c5a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.gradients.md
@@ -0,0 +1,132 @@
+---
+title: gradients
+description: API reference for qiskit.opflow.gradients
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.opflow.gradients
+---
+
+
+
+
+
+# qiskit.opflow\.gradients
+
+
+
+## Gradients
+
+
+
+`qiskit.opflow.gradients`
+
+
+ The [`qiskit.opflow`](opflow#module-qiskit.opflow "qiskit.opflow") module is deprecated and will be removed no earlier than 3 months after the release date. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+Given an operator that represents either a quantum state resp. an expectation value, the gradient framework enables the evaluation of gradients, natural gradients, Hessians, as well as the Quantum Fisher Information.
+
+Suppose a parameterized quantum state |ψ(θ)〉 = V(θ)|ψ〉 with input state |ψ〉 and parameterized Ansatz V(θ), and an Operator O(ω).
+
+**Gradients**
+
+We want to compute one of: \* $d⟨ψ(θ)|O(ω)|ψ(θ)〉/ dω$ \* $d⟨ψ(θ)|O(ω)|ψ(θ)〉/ dθ$ \* $d⟨ψ(θ)|i〉⟨i|ψ(θ)〉/ dθ$
+
+The last case corresponds to the gradient w\.r.t. the sampling probabilities of |ψ(θ). These gradients can be computed with different methods, i.e. a parameter shift, a linear combination of unitaries and a finite difference method.
+
+**Examples**
+
+```python
+x = Parameter('x')
+ham = x * X
+a = Parameter('a')
+
+q = QuantumRegister(1)
+qc = QuantumCircuit(q)
+qc.h(q)
+qc.p(params[0], q[0])
+op = ~StateFn(ham) @ CircuitStateFn(primitive=qc, coeff=1.)
+
+value_dict = {x: 0.1, a: np.pi / 4}
+
+ham_grad = Gradient(grad_method='param_shift').convert(operator=op, params=[x])
+ham_grad.assign_parameters(value_dict).eval()
+
+state_grad = Gradient(grad_method='lin_comb').convert(operator=op, params=[a])
+state_grad.assign_parameters(value_dict).eval()
+
+prob_grad = Gradient(grad_method='fin_diff').convert(
+ operator=CircuitStateFn(primitive=qc, coeff=1.), params=[a]
+)
+prob_grad.assign_parameters(value_dict).eval()
+```
+
+**Hessians**
+
+We want to compute one of: \* $d^2⟨ψ(θ)|O(ω)|ψ(θ)〉/ dω^2$ \* $d^2⟨ψ(θ)|O(ω)|ψ(θ)〉/ dθ^2$ \* $d^2⟨ψ(θ)|O(ω)|ψ(θ)〉/ dθ dω$ \* $d^2⟨ψ(θ)|i〉⟨i|ψ(θ)〉/ dθ^2$
+
+The last case corresponds to the Hessian w\.r.t. the sampling probabilities of |ψ(θ)〉. Just as the first order gradients, the Hessians can be evaluated with different methods, i.e. a parameter shift, a linear combination of unitaries and a finite difference method. Given a tuple of parameters `Hessian().convert(op, param_tuple)` returns the value for the second order derivative. If a list of parameters is given `Hessian().convert(op, param_list)` returns the full Hessian for all the given parameters according to the given parameter order.
+
+**QFI**
+
+The Quantum Fisher Information QFI is a metric tensor which is representative for the representation capacity of a parameterized quantum state |ψ(θ)〉 = V(θ)|ψ〉 generated by an input state |ψ〉 and a parameterized Ansatz V(θ). The entries of the QFI for a pure state read $\mathrm{QFI}_{kl} = 4 \mathrm{Re}[〈∂kψ|∂lψ〉−〈∂kψ|ψ〉〈ψ|∂lψ〉]$.
+
+Just as for the previous derivative types, the QFI can be computed using different methods: a full representation based on a linear combination of unitaries implementation, a block-diagonal and a diagonal representation based on an overlap method.
+
+**Examples**
+
+```python
+q = QuantumRegister(1)
+qc = QuantumCircuit(q)
+qc.h(q)
+qc.p(params[0], q[0])
+op = ~StateFn(ham) @ CircuitStateFn(primitive=qc, coeff=1.)
+
+value_dict = {x: 0.1, a: np.pi / 4}
+
+qfi = QFI('lin_comb_full').convert(
+ operator=CircuitStateFn(primitive=qc, coeff=1.), params=[a]
+)
+qfi.assign_parameters(value_dict).eval()
+```
+
+**NaturalGradients**
+
+The natural gradient is a special gradient method which re-scales a gradient w\.r.t. a state parameter with the inverse of the corresponding Quantum Fisher Information (QFI) $\mathrm{QFI}^{-1} d⟨ψ(θ)|O(ω)|ψ(θ)〉/ dθ$. Hereby, we can choose a gradient as well as a QFI method and a regularization method which is used together with a least square solver instead of exact inversion of the QFI:
+
+**Examples**
+
+```python
+op = ~StateFn(ham) @ CircuitStateFn(primitive=qc, coeff=1.)
+nat_grad = NaturalGradient(grad_method='lin_comb,
+ qfi_method='lin_comb_full',
+ regularization='ridge').convert(operator=op, params=params)
+```
+
+The derivative classes come with a gradient\_wrapper() function which returns the corresponding callable and are thus compatible with the optimizers.
+
+### Base Classes
+
+| | |
+| -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
+| [`DerivativeBase`](qiskit.opflow.gradients.DerivativeBase "qiskit.opflow.gradients.DerivativeBase")() | Deprecated: Base class for differentiating opflow objects. |
+| [`GradientBase`](qiskit.opflow.gradients.GradientBase "qiskit.opflow.gradients.GradientBase")(\[grad\_method]) | Deprecated: Base class for first-order operator gradient. |
+| [`HessianBase`](qiskit.opflow.gradients.HessianBase "qiskit.opflow.gradients.HessianBase")(\[hess\_method]) | Deprecated: Base class for the Hessian of an expected value. |
+| [`QFIBase`](qiskit.opflow.gradients.QFIBase "qiskit.opflow.gradients.QFIBase")(\[qfi\_method]) | Deprecated: Base class for Quantum Fisher Information (QFI). |
+
+### Converters
+
+| | |
+| -------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
+| [`CircuitGradient`](qiskit.opflow.gradients.CircuitGradient "qiskit.opflow.gradients.CircuitGradient")() | Deprecated: Circuit to gradient operator converter. |
+| [`CircuitQFI`](qiskit.opflow.gradients.CircuitQFI "qiskit.opflow.gradients.CircuitQFI")() | Deprecated: Circuit to Quantum Fisher Information operator converter. |
+
+### Derivatives
+
+| | |
+| ----------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
+| [`Gradient`](qiskit.opflow.gradients.Gradient "qiskit.opflow.gradients.Gradient")(\[grad\_method]) | Deprecated: Convert an operator expression to the first-order gradient. |
+| [`Hessian`](qiskit.opflow.gradients.Hessian "qiskit.opflow.gradients.Hessian")(\[hess\_method]) | Deprecated: Compute the Hessian of an expected value. |
+| [`NaturalGradient`](qiskit.opflow.gradients.NaturalGradient "qiskit.opflow.gradients.NaturalGradient")(\[grad\_method, qfi\_method, ...]) | Deprecated: Convert an operator expression to the first-order gradient. |
+| [`QFI`](qiskit.opflow.gradients.QFI "qiskit.opflow.gradients.QFI")(\[qfi\_method]) | Deprecated: Compute the Quantum Fisher Information (QFI). |
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.list_ops.ComposedOp.md b/docs/api/qiskit/0.46/qiskit.opflow.list_ops.ComposedOp.md
new file mode 100644
index 00000000000..19c3f912911
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.list_ops.ComposedOp.md
@@ -0,0 +1,254 @@
+---
+title: ComposedOp
+description: API reference for qiskit.opflow.list_ops.ComposedOp
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.list_ops.ComposedOp
+---
+
+# ComposedOp
+
+
+
+`qiskit.opflow.list_ops.ComposedOp(oplist, coeff=1.0, abelian=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/list_ops/composed_op.py "view source code")
+
+Bases: [`ListOp`](qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.list_op.ListOp")
+
+Deprecated: A class for lazily representing compositions of Operators. Often Operators cannot be efficiently composed with one another, but may be manipulated further so that they can be composed later. This class holds logic to indicate that the Operators in `oplist` are meant to be composed, and therefore if they reach a point in which they can be, such as after conversion to QuantumCircuits or matrices, they can be reduced by composition.
+
+
+ The class `qiskit.opflow.list_ops.composed_op.ComposedOp` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **oplist** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")*]*) – The Operators being composed.
+* **coeff** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – A coefficient multiplying the operator
+* **abelian** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Indicates whether the Operators in `oplist` are known to mutually commute.
+
+## Attributes
+
+
+
+### INDENTATION
+
+`= ' '`
+
+
+
+### abelian
+
+Whether the Operators in `oplist` are known to commute with one another.
+
+**Returns**
+
+A bool indicating whether the `oplist` is Abelian.
+
+
+
+### coeff
+
+The scalar coefficient multiplying the Operator.
+
+**Returns**
+
+The coefficient.
+
+
+
+### coeffs
+
+Return a list of the coefficients of the operators listed. Raises exception for nested Listops.
+
+
+
+### combo\_fn
+
+The function defining how to combine `oplist` (or Numbers, or NumPy arrays) to produce the Operator’s underlying function. For example, SummedOp’s combination function is to add all of the Operators in `oplist`.
+
+**Returns**
+
+The combination function.
+
+
+
+### distributive
+
+
+
+### grad\_combo\_fn
+
+The gradient of `combo_fn`.
+
+
+
+### instance\_id
+
+Return the unique instance id.
+
+
+
+### num\_qubits
+
+
+
+### oplist
+
+The list of `OperatorBases` defining the underlying function of this Operator.
+
+**Returns**
+
+The Operators defining the ListOp
+
+
+
+### parameters
+
+
+
+### settings
+
+Return settings.
+
+## Methods
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return a new Operator equal to the Operator’s adjoint (conjugate transpose), overloaded by `~`. For StateFns, this also turns the StateFn into a measurement.
+
+**Returns**
+
+An `OperatorBase` equivalent to the adjoint of self.
+
+**Return type**
+
+[*ComposedOp*](#qiskit.opflow.list_ops.ComposedOp "qiskit.opflow.list_ops.composed_op.ComposedOp")
+
+### compose
+
+
+
+`compose(other, permutation=None, front=False)`
+
+Return Operator Composition between self and other (linear algebra-style: A\@B(x) = A(B(x))), overloaded by `@`.
+
+Note: You must be conscious of Quantum Circuit vs. Linear Algebra ordering conventions. Meaning, X.compose(Y) produces an X∘Y on qubit 0, but would produce a QuantumCircuit which looks like
+
+> -\[Y]-\[X]-
+
+Because Terra prints circuits with the initial state at the left side of the circuit.
+
+**Parameters**
+
+* **other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` with which to compose self.
+* **permutation** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – `List[int]` which defines permutation on other operator.
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If front==True, return `other.compose(self)`.
+
+**Returns**
+
+An `OperatorBase` equivalent to the function composition of self and other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### eval
+
+
+
+`eval(front=None)`
+
+Evaluate the Operator’s underlying function, either on a binary string or another Operator. A square binary Operator can be defined as a function taking a binary function to another binary function. This method returns the value of that function for a given StateFn or binary string. For example, `op.eval('0110').eval('1110')` can be seen as querying the Operator’s matrix representation by row 6 and column 14, and will return the complex value at those “indices.” Similarly for a StateFn, `op.eval('1011')` will return the complex value at row 11 of the vector representation of the StateFn, as all StateFns are defined to be evaluated from Zero implicitly (i.e. it is as if `.eval('0000')` is already called implicitly to always “indexing” from column 0).
+
+ListOp’s eval recursively evaluates each Operator in `oplist`, and combines the results using the recombination function `combo_fn`.
+
+**Parameters**
+
+**front** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *|*[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") *|*[*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.states.statevector.Statevector") *| None*) – The bitstring, dict of bitstrings (with values being coefficients), or StateFn to evaluated by the Operator’s underlying function.
+
+**Returns**
+
+The output of the `oplist` Operators’ evaluation function, combined with the `combo_fn`. If either self or front contain proper `ListOps` (not ListOp subclasses), the result is an n-dimensional list of complex or StateFn results, resulting from the recursive evaluation by each OperatorBase in the ListOps.
+
+**Raises**
+
+* [**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – Raised if called for a subclass which is not distributive.
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Operators with mixed hierarchies, such as a ListOp containing both PrimitiveOps and ListOps, are not supported.
+* [**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – Attempting to call ListOp’s eval from a non-distributive subclass.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") | [complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")
+
+### non\_distributive\_reduce
+
+
+
+`non_distributive_reduce()`
+
+Reduce without attempting to expand all distributive compositions.
+
+**Returns**
+
+The reduced Operator.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### reduce
+
+
+
+`reduce()`
+
+Try collapsing the Operator structure, usually after some type of conversion, e.g. trying to add Operators in a SummedOp or delete needless IGates in a CircuitOp. If no reduction is available, just returns self.
+
+**Returns**
+
+The reduced `OperatorBase`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### to\_circuit
+
+
+
+`to_circuit()`
+
+Returns the quantum circuit, representing the composed operator.
+
+**Returns**
+
+The circuit representation of the composed operator.
+
+**Raises**
+
+[**OpflowError**](opflow#qiskit.opflow.OpflowError "qiskit.opflow.OpflowError") – for operators where a single underlying circuit can not be obtained.
+
+**Return type**
+
+[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+### to\_matrix
+
+
+
+`to_matrix(massive=False)`
+
+Return NumPy representation of the Operator. Represents the evaluation of the Operator’s underlying function on every combination of basis binary strings. Warn if more than 16 qubits to force having to set `massive=True` if such a large vector is desired.
+
+**Returns**
+
+The NumPy `ndarray` equivalent to this Operator.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.list_ops.ListOp.md b/docs/api/qiskit/0.46/qiskit.opflow.list_ops.ListOp.md
new file mode 100644
index 00000000000..be84b38a21d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.list_ops.ListOp.md
@@ -0,0 +1,518 @@
+---
+title: ListOp
+description: API reference for qiskit.opflow.list_ops.ListOp
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.list_ops.ListOp
+---
+
+# ListOp
+
+
+
+`qiskit.opflow.list_ops.ListOp(oplist, combo_fn=None, coeff=1.0, abelian=False, grad_combo_fn=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/list_ops/list_op.py "view source code")
+
+Bases: [`OperatorBase`](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+Deprecated: A Class for manipulating List Operators, and parent class to `SummedOp`, `ComposedOp` and `TensoredOp`.
+
+List Operators are classes for storing and manipulating lists of Operators, State functions, or Measurements, and include some rule or `combo_fn` defining how the Operator functions of the list constituents should be combined to form to cumulative Operator function of the `ListOp`. For example, a `SummedOp` has an addition-based `combo_fn`, so once the Operators in its list are evaluated against some bitstring to produce a list of results, we know to add up those results to produce the final result of the `SummedOp`’s evaluation. In theory, this `combo_fn` can be any function over classical complex values, but for convenience we’ve chosen for them to be defined over NumPy arrays and values. This way, large numbers of evaluations, such as after calling `to_matrix` on the list constituents, can be efficiently combined. While the combination function is defined over classical values, it should be understood as the operation by which each Operators’ underlying function is combined to form the underlying Operator function of the `ListOp`. In this way, the `ListOps` are the basis for constructing large and sophisticated Operators, State Functions, and Measurements.
+
+The base `ListOp` class is particularly interesting, as its `combo_fn` is “the identity list Operation”. Meaning, if we understand the `combo_fn` as a function from a list of complex values to some output, one such function is returning the list as-is. This is powerful for constructing compact hierarchical Operators which return many measurements in multiple dimensional lists.
+
+
+ The class `qiskit.opflow.list_ops.list_op.ListOp` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **oplist** ([*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")*]*) – The list of `OperatorBases` defining this Operator’s underlying function.
+* **combo\_fn** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *| None*) – The recombination function to combine classical results of the `oplist` Operators’ eval functions (e.g. sum). Default is lambda x: x.
+* **coeff** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – A coefficient multiplying the operator
+* **abelian** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Indicates whether the Operators in `oplist` are known to mutually commute.
+* **grad\_combo\_fn** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *| None*) – The gradient of recombination function. If None, the gradient will be computed automatically.
+* **the** (*Note that the default "recombination function" lambda above is essentially*) –
+* **values** (*identity - it accepts the list of*) –
+* **list.** (*and returns them in a*) –
+
+## Attributes
+
+
+
+### INDENTATION
+
+`= ' '`
+
+
+
+### abelian
+
+Whether the Operators in `oplist` are known to commute with one another.
+
+**Returns**
+
+A bool indicating whether the `oplist` is Abelian.
+
+
+
+### coeff
+
+The scalar coefficient multiplying the Operator.
+
+**Returns**
+
+The coefficient.
+
+
+
+### coeffs
+
+Return a list of the coefficients of the operators listed. Raises exception for nested Listops.
+
+
+
+### combo\_fn
+
+The function defining how to combine `oplist` (or Numbers, or NumPy arrays) to produce the Operator’s underlying function. For example, SummedOp’s combination function is to add all of the Operators in `oplist`.
+
+**Returns**
+
+The combination function.
+
+
+
+### distributive
+
+Indicates whether the ListOp or subclass is distributive under composition. ListOp and SummedOp are, meaning that (opv @ op) = (opv\[0] @ op + opv\[1] @ op) (using plus for SummedOp, list for ListOp, etc.), while ComposedOp and TensoredOp do not behave this way.
+
+**Returns**
+
+A bool indicating whether the ListOp is distributive under composition.
+
+
+
+### grad\_combo\_fn
+
+The gradient of `combo_fn`.
+
+
+
+### instance\_id
+
+Return the unique instance id.
+
+
+
+### num\_qubits
+
+
+
+### oplist
+
+The list of `OperatorBases` defining the underlying function of this Operator.
+
+**Returns**
+
+The Operators defining the ListOp
+
+
+
+### parameters
+
+
+
+### settings
+
+Return settings.
+
+## Methods
+
+### add
+
+
+
+`add(other)`
+
+Return Operator addition of self and other, overloaded by `+`.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – An `OperatorBase` with the same number of qubits as self, and in the same ‘Operator’, ‘State function’, or ‘Measurement’ category as self (i.e. the same type of underlying function).
+
+**Returns**
+
+An `OperatorBase` equivalent to the sum of self and other.
+
+**Return type**
+
+[*ListOp*](#qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.list_op.ListOp")
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return a new Operator equal to the Operator’s adjoint (conjugate transpose), overloaded by `~`. For StateFns, this also turns the StateFn into a measurement.
+
+**Returns**
+
+An `OperatorBase` equivalent to the adjoint of self.
+
+**Return type**
+
+[*ListOp*](#qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.list_op.ListOp")
+
+### assign\_parameters
+
+
+
+`assign_parameters(param_dict)`
+
+Binds scalar values to any Terra `Parameters` in the coefficients or primitives of the Operator, or substitutes one `Parameter` for another. This method differs from Terra’s `assign_parameters` in that it also supports lists of values to assign for a give `Parameter`, in which case self will be copied for each parameterization in the binding list(s), and all the copies will be returned in an `OpList`. If lists of parameterizations are used, every `Parameter` in the param\_dict must have the same length list of parameterizations.
+
+**Parameters**
+
+**param\_dict** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – The dictionary of `Parameters` to replace, and values or lists of values by which to replace them.
+
+**Returns**
+
+The `OperatorBase` with the `Parameters` in self replaced by the values or `Parameters` in param\_dict. If param\_dict contains parameterization lists, this `OperatorBase` is an `OpList`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### compose
+
+
+
+`compose(other, permutation=None, front=False)`
+
+Return Operator Composition between self and other (linear algebra-style: A\@B(x) = A(B(x))), overloaded by `@`.
+
+Note: You must be conscious of Quantum Circuit vs. Linear Algebra ordering conventions. Meaning, X.compose(Y) produces an X∘Y on qubit 0, but would produce a QuantumCircuit which looks like
+
+> -\[Y]-\[X]-
+
+Because Terra prints circuits with the initial state at the left side of the circuit.
+
+**Parameters**
+
+* **other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` with which to compose self.
+* **permutation** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – `List[int]` which defines permutation on other operator.
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If front==True, return `other.compose(self)`.
+
+**Returns**
+
+An `OperatorBase` equivalent to the function composition of self and other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### default\_combo\_fn
+
+
+
+`static default_combo_fn(x)`
+
+ListOp default combo function i.e. lambda x: x
+
+**Return type**
+
+[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")
+
+### equals
+
+
+
+`equals(other)`
+
+Evaluate Equality between Operators, overloaded by `==`. Only returns True if self and other are of the same representation (e.g. a DictStateFn and CircuitStateFn will never be equal, even if their vector representations are equal), their underlying primitives are equal (this means for ListOps, OperatorStateFns, or EvolvedOps the equality is evaluated recursively downwards), and their coefficients are equal.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to compare to self.
+
+**Returns**
+
+A bool equal to the equality of self and other.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### eval
+
+
+
+`eval(front=None)`
+
+Evaluate the Operator’s underlying function, either on a binary string or another Operator. A square binary Operator can be defined as a function taking a binary function to another binary function. This method returns the value of that function for a given StateFn or binary string. For example, `op.eval('0110').eval('1110')` can be seen as querying the Operator’s matrix representation by row 6 and column 14, and will return the complex value at those “indices.” Similarly for a StateFn, `op.eval('1011')` will return the complex value at row 11 of the vector representation of the StateFn, as all StateFns are defined to be evaluated from Zero implicitly (i.e. it is as if `.eval('0000')` is already called implicitly to always “indexing” from column 0).
+
+ListOp’s eval recursively evaluates each Operator in `oplist`, and combines the results using the recombination function `combo_fn`.
+
+**Parameters**
+
+**front** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*] |* [*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") *|*[*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.states.statevector.Statevector") *| None*) – The bitstring, dict of bitstrings (with values being coefficients), or StateFn to evaluated by the Operator’s underlying function.
+
+**Returns**
+
+The output of the `oplist` Operators’ evaluation function, combined with the `combo_fn`. If either self or front contain proper `ListOps` (not ListOp subclasses), the result is an n-dimensional list of complex or StateFn results, resulting from the recursive evaluation by each OperatorBase in the ListOps.
+
+**Raises**
+
+* [**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – Raised if called for a subclass which is not distributive.
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Operators with mixed hierarchies, such as a ListOp containing both PrimitiveOps and ListOps, are not supported.
+* [**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – Attempting to call ListOp’s eval from a non-distributive subclass.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") | [complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")
+
+### exp\_i
+
+
+
+`exp_i()`
+
+Return an `OperatorBase` equivalent to an exponentiation of self \* -i, e^(-i\*op).
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### log\_i
+
+
+
+`log_i(massive=False)`
+
+Return a `MatrixOp` equivalent to log(H)/-i for this operator H. This function is the effective inverse of exp\_i, equivalent to finding the Hermitian Operator which produces self when exponentiated. For proper ListOps, applies `log_i` to all ops in oplist.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### mul
+
+
+
+`mul(scalar)`
+
+Returns the scalar multiplication of the Operator, overloaded by `*`, including support for Terra’s `Parameters`, which can be bound to values later (via `bind_parameters`).
+
+**Parameters**
+
+**scalar** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The real or complex scalar by which to multiply the Operator, or the `ParameterExpression` to serve as a placeholder for a scalar factor.
+
+**Returns**
+
+An `OperatorBase` equivalent to product of self and scalar.
+
+**Return type**
+
+[*ListOp*](#qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.list_op.ListOp")
+
+### permute
+
+
+
+`permute(permutation)`
+
+Permute the qubits of the operator.
+
+**Parameters**
+
+**permutation** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – A list defining where each qubit should be permuted. The qubit at index j should be permuted to position permutation\[j].
+
+**Returns**
+
+A new ListOp representing the permuted operator.
+
+**Raises**
+
+[**OpflowError**](opflow#qiskit.opflow.OpflowError "qiskit.opflow.OpflowError") – if indices do not define a new index for each qubit.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### power
+
+
+
+`power(exponent)`
+
+Return Operator composed with self multiple times, overloaded by `**`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### primitive\_strings
+
+
+
+`primitive_strings()`
+
+Return a set of strings describing the primitives contained in the Operator. For example, `{'QuantumCircuit', 'Pauli'}`. For hierarchical Operators, such as `ListOps`, this can help illuminate the primitives represented in the various recursive levels, and therefore which conversions can be applied.
+
+**Returns**
+
+A set of strings describing the primitives contained within the Operator.
+
+**Return type**
+
+[*Set*](https://docs.python.org/3/library/typing.html#typing.Set "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")]
+
+### reduce
+
+
+
+`reduce()`
+
+Try collapsing the Operator structure, usually after some type of conversion, e.g. trying to add Operators in a SummedOp or delete needless IGates in a CircuitOp. If no reduction is available, just returns self.
+
+**Returns**
+
+The reduced `OperatorBase`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return tensor product between self and other, overloaded by `^`. Note: You must be conscious of Qiskit’s big-endian bit printing convention. Meaning, X.tensor(Y) produces an X on qubit 0 and an Y on qubit 1, or X⨂Y, but would produce a QuantumCircuit which looks like
+
+> -\[Y]- -\[X]-
+
+Because Terra prints circuits and results with qubit 0 at the end of the string or circuit.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to tensor product with self.
+
+**Returns**
+
+An `OperatorBase` equivalent to the tensor product of self and other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### tensorpower
+
+
+
+`tensorpower(other)`
+
+Return tensor product with self multiple times, overloaded by `^`.
+
+**Parameters**
+
+**other** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The int number of times to tensor product self with itself via `tensorpower`.
+
+**Returns**
+
+An `OperatorBase` equivalent to the tensorpower of self by other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") | [int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### to\_circuit\_op
+
+
+
+`to_circuit_op()`
+
+Returns an equivalent Operator composed of only QuantumCircuit-based primitives, such as `CircuitOp` and `CircuitStateFn`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### to\_matrix
+
+
+
+`to_matrix(massive=False)`
+
+Return NumPy representation of the Operator. Represents the evaluation of the Operator’s underlying function on every combination of basis binary strings. Warn if more than 16 qubits to force having to set `massive=True` if such a large vector is desired.
+
+**Returns**
+
+The NumPy `ndarray` equivalent to this Operator.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+### to\_matrix\_op
+
+
+
+`to_matrix_op(massive=False)`
+
+Returns an equivalent Operator composed of only NumPy-based primitives, such as `MatrixOp` and `VectorStateFn`.
+
+**Return type**
+
+[*ListOp*](#qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.list_op.ListOp")
+
+### to\_pauli\_op
+
+
+
+`to_pauli_op(massive=False)`
+
+Returns an equivalent Operator composed of only Pauli-based primitives, such as `PauliOp`.
+
+**Return type**
+
+[*ListOp*](#qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.list_op.ListOp")
+
+### to\_spmatrix
+
+
+
+`to_spmatrix()`
+
+Returns SciPy sparse matrix representation of the Operator.
+
+**Returns**
+
+CSR sparse matrix representation of the Operator, or List thereof.
+
+**Return type**
+
+*spmatrix* | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[*spmatrix*]
+
+### traverse
+
+
+
+`traverse(convert_fn, coeff=None)`
+
+Apply the convert\_fn to each node in the oplist.
+
+**Parameters**
+
+* **convert\_fn** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")) – The function to apply to the internal OperatorBase.
+* **coeff** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *| None*) – A coefficient to multiply by after applying convert\_fn. If it is None, self.coeff is used instead.
+
+**Returns**
+
+The converted ListOp.
+
+**Return type**
+
+[*ListOp*](#qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.list_op.ListOp")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.list_ops.SummedOp.md b/docs/api/qiskit/0.46/qiskit.opflow.list_ops.SummedOp.md
new file mode 100644
index 00000000000..0fe3009f156
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.list_ops.SummedOp.md
@@ -0,0 +1,253 @@
+---
+title: SummedOp
+description: API reference for qiskit.opflow.list_ops.SummedOp
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.list_ops.SummedOp
+---
+
+# SummedOp
+
+
+
+`qiskit.opflow.list_ops.SummedOp(oplist, coeff=1.0, abelian=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/list_ops/summed_op.py "view source code")
+
+Bases: [`ListOp`](qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.list_op.ListOp")
+
+Deprecated: A class for lazily representing sums of Operators. Often Operators cannot be efficiently added to one another, but may be manipulated further so that they can be later. This class holds logic to indicate that the Operators in `oplist` are meant to be added together, and therefore if they reach a point in which they can be, such as after evaluation or conversion to matrices, they can be reduced by addition.
+
+
+ The class `qiskit.opflow.list_ops.summed_op.SummedOp` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **oplist** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")*]*) – The Operators being summed.
+* **coeff** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – A coefficient multiplying the operator
+* **abelian** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Indicates whether the Operators in `oplist` are known to mutually commute.
+
+## Attributes
+
+
+
+### INDENTATION
+
+`= ' '`
+
+
+
+### abelian
+
+Whether the Operators in `oplist` are known to commute with one another.
+
+**Returns**
+
+A bool indicating whether the `oplist` is Abelian.
+
+
+
+### coeff
+
+The scalar coefficient multiplying the Operator.
+
+**Returns**
+
+The coefficient.
+
+
+
+### coeffs
+
+Return a list of the coefficients of the operators listed. Raises exception for nested Listops.
+
+
+
+### combo\_fn
+
+The function defining how to combine `oplist` (or Numbers, or NumPy arrays) to produce the Operator’s underlying function. For example, SummedOp’s combination function is to add all of the Operators in `oplist`.
+
+**Returns**
+
+The combination function.
+
+
+
+### distributive
+
+
+
+### grad\_combo\_fn
+
+The gradient of `combo_fn`.
+
+
+
+### instance\_id
+
+Return the unique instance id.
+
+
+
+### num\_qubits
+
+
+
+### oplist
+
+The list of `OperatorBases` defining the underlying function of this Operator.
+
+**Returns**
+
+The Operators defining the ListOp
+
+
+
+### parameters
+
+
+
+### settings
+
+Return settings.
+
+## Methods
+
+### add
+
+
+
+`add(other)`
+
+Return Operator addition of `self` and `other`, overloaded by `+`.
+
+
+ This appends `other` to `self.oplist` without checking `other` is already included or not. If you want to simplify them, please use `simplify()`.
+
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – An `OperatorBase` with the same number of qubits as self, and in the same ‘Operator’, ‘State function’, or ‘Measurement’ category as self (i.e. the same type of underlying function).
+
+**Returns**
+
+A `SummedOp` equivalent to the sum of self and other.
+
+**Return type**
+
+[*SummedOp*](#qiskit.opflow.list_ops.SummedOp "qiskit.opflow.list_ops.summed_op.SummedOp")
+
+### collapse\_summands
+
+
+
+`collapse_summands()`
+
+Return Operator by simplifying duplicate operators.
+
+E.g., `SummedOp([2 * X ^ Y, X ^ Y]).collapse_summands() -> SummedOp([3 * X ^ Y])`.
+
+**Returns**
+
+A simplified `SummedOp` equivalent to self.
+
+**Return type**
+
+[*SummedOp*](#qiskit.opflow.list_ops.SummedOp "qiskit.opflow.list_ops.summed_op.SummedOp")
+
+### equals
+
+
+
+`equals(other)`
+
+Check if other is equal to self.
+
+
+ This is not a mathematical check for equality. If `self` and `other` implement the same operation but differ in the representation (e.g. different type of summands) `equals` will evaluate to `False`.
+
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The other operator to check for equality.
+
+**Returns**
+
+True, if other and self are equal, otherwise False.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+**Examples**
+
+```python
+>>> from qiskit.opflow import X, Z
+>>> 2 * X == X + X
+True
+>>> X + Z == Z + X
+True
+```
+
+### reduce
+
+
+
+`reduce()`
+
+Try collapsing list or trees of sums.
+
+Tries to sum up duplicate operators and reduces the operators in the sum.
+
+**Returns**
+
+A collapsed version of self, if possible.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### to\_circuit
+
+
+
+`to_circuit()`
+
+Returns the quantum circuit, representing the SummedOp. In the first step, the SummedOp is converted to MatrixOp. This is straightforward for most operators, but it is not supported for operators containing parameterized PrimitiveOps (in that case, OpflowError is raised). In the next step, the MatrixOp representation of SummedOp is converted to circuit. In most cases, if the summands themselves are unitary operators, the SummedOp itself is non-unitary and can not be converted to circuit. In that case, ExtensionError is raised in the underlying modules.
+
+**Returns**
+
+The circuit representation of the summed operator.
+
+**Raises**
+
+* [**OpflowError**](opflow#qiskit.opflow.OpflowError "qiskit.opflow.OpflowError") – if SummedOp can not be converted to MatrixOp (e.g. SummedOp is composed of
+* **parameterized PrimitiveOps**\*\*)\*\*\*\*.\*\* –
+
+**Return type**
+
+[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+### to\_matrix\_op
+
+
+
+`to_matrix_op(massive=False)`
+
+Returns an equivalent Operator composed of only NumPy-based primitives, such as `MatrixOp` and `VectorStateFn`.
+
+**Return type**
+
+[*SummedOp*](#qiskit.opflow.list_ops.SummedOp "qiskit.opflow.list_ops.summed_op.SummedOp")
+
+### to\_pauli\_op
+
+
+
+`to_pauli_op(massive=False)`
+
+Returns an equivalent Operator composed of only Pauli-based primitives, such as `PauliOp`.
+
+**Return type**
+
+[*SummedOp*](#qiskit.opflow.list_ops.SummedOp "qiskit.opflow.list_ops.summed_op.SummedOp")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.list_ops.TensoredOp.md b/docs/api/qiskit/0.46/qiskit.opflow.list_ops.TensoredOp.md
new file mode 100644
index 00000000000..bea4f8dcec2
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.list_ops.TensoredOp.md
@@ -0,0 +1,218 @@
+---
+title: TensoredOp
+description: API reference for qiskit.opflow.list_ops.TensoredOp
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.list_ops.TensoredOp
+---
+
+# TensoredOp
+
+
+
+`qiskit.opflow.list_ops.TensoredOp(oplist, coeff=1.0, abelian=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/list_ops/tensored_op.py "view source code")
+
+Bases: [`ListOp`](qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.list_op.ListOp")
+
+Deprecated: A class for lazily representing tensor products of Operators. Often Operators cannot be efficiently tensored to one another, but may be manipulated further so that they can be later. This class holds logic to indicate that the Operators in `oplist` are meant to be tensored together, and therefore if they reach a point in which they can be, such as after conversion to QuantumCircuits, they can be reduced by tensor product.
+
+
+ The class `qiskit.opflow.list_ops.tensored_op.TensoredOp` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **oplist** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")*]*) – The Operators being tensored.
+* **coeff** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – A coefficient multiplying the operator
+* **abelian** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Indicates whether the Operators in `oplist` are known to mutually commute.
+
+## Attributes
+
+
+
+### INDENTATION
+
+`= ' '`
+
+
+
+### abelian
+
+Whether the Operators in `oplist` are known to commute with one another.
+
+**Returns**
+
+A bool indicating whether the `oplist` is Abelian.
+
+
+
+### coeff
+
+The scalar coefficient multiplying the Operator.
+
+**Returns**
+
+The coefficient.
+
+
+
+### coeffs
+
+Return a list of the coefficients of the operators listed. Raises exception for nested Listops.
+
+
+
+### combo\_fn
+
+The function defining how to combine `oplist` (or Numbers, or NumPy arrays) to produce the Operator’s underlying function. For example, SummedOp’s combination function is to add all of the Operators in `oplist`.
+
+**Returns**
+
+The combination function.
+
+
+
+### distributive
+
+
+
+### grad\_combo\_fn
+
+The gradient of `combo_fn`.
+
+
+
+### instance\_id
+
+Return the unique instance id.
+
+
+
+### num\_qubits
+
+
+
+### oplist
+
+The list of `OperatorBases` defining the underlying function of this Operator.
+
+**Returns**
+
+The Operators defining the ListOp
+
+
+
+### parameters
+
+
+
+### settings
+
+Return settings.
+
+## Methods
+
+### eval
+
+
+
+`eval(front=None)`
+
+Evaluate the Operator’s underlying function, either on a binary string or another Operator. A square binary Operator can be defined as a function taking a binary function to another binary function. This method returns the value of that function for a given StateFn or binary string. For example, `op.eval('0110').eval('1110')` can be seen as querying the Operator’s matrix representation by row 6 and column 14, and will return the complex value at those “indices.” Similarly for a StateFn, `op.eval('1011')` will return the complex value at row 11 of the vector representation of the StateFn, as all StateFns are defined to be evaluated from Zero implicitly (i.e. it is as if `.eval('0000')` is already called implicitly to always “indexing” from column 0).
+
+ListOp’s eval recursively evaluates each Operator in `oplist`, and combines the results using the recombination function `combo_fn`.
+
+**Parameters**
+
+**front** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *|*[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") *|*[*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.states.statevector.Statevector") *| None*) – The bitstring, dict of bitstrings (with values being coefficients), or StateFn to evaluated by the Operator’s underlying function.
+
+**Returns**
+
+The output of the `oplist` Operators’ evaluation function, combined with the `combo_fn`. If either self or front contain proper `ListOps` (not ListOp subclasses), the result is an n-dimensional list of complex or StateFn results, resulting from the recursive evaluation by each OperatorBase in the ListOps.
+
+**Raises**
+
+* [**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – Raised if called for a subclass which is not distributive.
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Operators with mixed hierarchies, such as a ListOp containing both PrimitiveOps and ListOps, are not supported.
+* [**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – Attempting to call ListOp’s eval from a non-distributive subclass.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") | [complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")
+
+### reduce
+
+
+
+`reduce()`
+
+Try collapsing the Operator structure, usually after some type of conversion, e.g. trying to add Operators in a SummedOp or delete needless IGates in a CircuitOp. If no reduction is available, just returns self.
+
+**Returns**
+
+The reduced `OperatorBase`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return tensor product between self and other, overloaded by `^`. Note: You must be conscious of Qiskit’s big-endian bit printing convention. Meaning, X.tensor(Y) produces an X on qubit 0 and an Y on qubit 1, or X⨂Y, but would produce a QuantumCircuit which looks like
+
+> -\[Y]- -\[X]-
+
+Because Terra prints circuits and results with qubit 0 at the end of the string or circuit.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to tensor product with self.
+
+**Returns**
+
+An `OperatorBase` equivalent to the tensor product of self and other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### to\_circuit
+
+
+
+`to_circuit()`
+
+Returns the quantum circuit, representing the tensored operator.
+
+**Returns**
+
+The circuit representation of the tensored operator.
+
+**Raises**
+
+[**OpflowError**](opflow#qiskit.opflow.OpflowError "qiskit.opflow.OpflowError") – for operators where a single underlying circuit can not be produced.
+
+**Return type**
+
+[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+### to\_matrix
+
+
+
+`to_matrix(massive=False)`
+
+Return NumPy representation of the Operator. Represents the evaluation of the Operator’s underlying function on every combination of basis binary strings. Warn if more than 16 qubits to force having to set `massive=True` if such a large vector is desired.
+
+**Returns**
+
+The NumPy `ndarray` equivalent to this Operator.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.list_ops.md b/docs/api/qiskit/0.46/qiskit.opflow.list_ops.md
new file mode 100644
index 00000000000..2552c2938c8
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.list_ops.md
@@ -0,0 +1,54 @@
+---
+title: list_ops
+description: API reference for qiskit.opflow.list_ops
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.opflow.list_ops
+---
+
+
+
+
+
+# qiskit.opflow\.list\_ops
+
+
+
+## List Operators
+
+
+
+`qiskit.opflow.list_ops`
+
+
+ The [`qiskit.opflow`](opflow#module-qiskit.opflow "qiskit.opflow") module is deprecated and will be removed no earlier than 3 months after the release date. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+List Operators are classes for storing and manipulating lists of Operators, State functions, or Measurements, and include some rule or `combo_fn` defining how the Operator functions of the list constituents should be combined to form to cumulative Operator function of the [`ListOp`](qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.ListOp"). For example, a [`SummedOp`](qiskit.opflow.list_ops.SummedOp "qiskit.opflow.list_ops.SummedOp") has an addition-based `combo_fn`, so once the Operators in its list are evaluated against some bitstring to produce a list of results, we know to add up those results to produce the final result of the [`SummedOp`](qiskit.opflow.list_ops.SummedOp "qiskit.opflow.list_ops.SummedOp")’s evaluation. In theory, this `combo_fn` can be any function over classical complex values, but for convenience we’ve chosen for them to be defined over NumPy arrays and values. This way, large numbers of evaluations, such as after calling [`to_matrix()`](qiskit.opflow.list_ops.ListOp#to_matrix "qiskit.opflow.list_ops.ListOp.to_matrix") on the list constituents, can be efficiently combined. While the combination function is defined over classical values, it should be understood as the operation by which each Operators’ underlying function is combined to form the underlying Operator function of the [`ListOp`](qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.ListOp"). In this way, the [`list_ops`](#module-qiskit.opflow.list_ops "qiskit.opflow.list_ops") are the basis for constructing large and sophisticated Operators, State Functions, and Measurements.
+
+The base [`ListOp`](qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.ListOp") class is particularly interesting, as its `combo_fn` is “the identity list Operation”. Meaning, if we understand the `combo_fn` as a function from a list of complex values to some output, one such function is returning the list as-is. This is powerful for constructing compact hierarchical Operators which return many measurements in multiple dimensional lists. For example, if we want to estimate the gradient of some Observable measurement with respect to some parameters in the State function, we can construct separate evaluation Operators for each parameter’s gradient which we must keep track of ourselves in a list, or we can construct a single [`ListOp`](qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.ListOp") containing the evaluation Operators for each parameter, so the [`eval()`](qiskit.opflow.list_ops.ListOp#eval "qiskit.opflow.list_ops.ListOp.eval") function returns the full gradient vector. Another excellent example of this power is constructing a Quantum kernel matrix:
+
+```python
+data_sfn_list_op = ListOp(data_circuit_state_fns)
+qkernel_op_circuits = ~data_sfn_list_op @ data_sfn_list_op
+qkernel_sampled = CircuitSampler(backend).convert(qkernel_op_circuits)
+qkernel_sampled.eval()
+```
+
+This will return the two dimensional Quantum kernel matrix, where each element is the inner product of some pair of the data State functions, or in other terms, a measurement of one data [`CircuitStateFn`](qiskit.opflow.state_fns.CircuitStateFn "qiskit.opflow.state_fns.CircuitStateFn") by another.
+
+You’ll encounter the [`ListOp`](qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.ListOp") subclasses ([`SummedOp`](qiskit.opflow.list_ops.SummedOp "qiskit.opflow.list_ops.SummedOp"), [`ComposedOp`](qiskit.opflow.list_ops.ComposedOp "qiskit.opflow.list_ops.ComposedOp"), or [`TensoredOp`](qiskit.opflow.list_ops.TensoredOp "qiskit.opflow.list_ops.TensoredOp")) more often as lazy results of Operator construction operations than as something you need to explicitly construct. Any time we don’t know how to efficiently add, compose, or tensor two [`primitive_ops`](qiskit.opflow.primitive_ops#module-qiskit.opflow.primitive_ops "qiskit.opflow.primitive_ops") or [`state_fns`](qiskit.opflow.state_fns#module-qiskit.opflow.state_fns "qiskit.opflow.state_fns") together, they’re returned in a [`SummedOp`](qiskit.opflow.list_ops.SummedOp "qiskit.opflow.list_ops.SummedOp"), [`ComposedOp`](qiskit.opflow.list_ops.ComposedOp "qiskit.opflow.list_ops.ComposedOp"), or [`TensoredOp`](qiskit.opflow.list_ops.TensoredOp "qiskit.opflow.list_ops.TensoredOp"), respectively, so we can still work with their combined function and perhaps convert them into an efficiently combine-able format later.
+
+
+ Combination functions do not always behave predictably, and you must understand the conversions you’re making when you working with [`list_ops`](#module-qiskit.opflow.list_ops "qiskit.opflow.list_ops"). Most notably - sampling a sum of two circuits on Quantum hardware does not incorporate interference between the wavefunctions! In this case, we’re sending our State functions through a depolarizing channel before adding them, rather than adding them directly before the measurement.
+
+
+### List Operators
+
+| | |
+| -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
+| [`ListOp`](qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.ListOp")(oplist\[, combo\_fn, coeff, abelian, ...]) | Deprecated: A Class for manipulating List Operators, and parent class to `SummedOp`, `ComposedOp` and `TensoredOp`. |
+| [`ComposedOp`](qiskit.opflow.list_ops.ComposedOp "qiskit.opflow.list_ops.ComposedOp")(oplist\[, coeff, abelian]) | Deprecated: A class for lazily representing compositions of Operators. |
+| [`SummedOp`](qiskit.opflow.list_ops.SummedOp "qiskit.opflow.list_ops.SummedOp")(oplist\[, coeff, abelian]) | Deprecated: A class for lazily representing sums of Operators. |
+| [`TensoredOp`](qiskit.opflow.list_ops.TensoredOp "qiskit.opflow.list_ops.TensoredOp")(oplist\[, coeff, abelian]) | Deprecated: A class for lazily representing tensor products of Operators. |
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.CircuitOp.md b/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.CircuitOp.md
new file mode 100644
index 00000000000..749d22e0a5d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.CircuitOp.md
@@ -0,0 +1,338 @@
+---
+title: CircuitOp
+description: API reference for qiskit.opflow.primitive_ops.CircuitOp
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.primitive_ops.CircuitOp
+---
+
+# CircuitOp
+
+
+
+`qiskit.opflow.primitive_ops.CircuitOp(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/primitive_ops/circuit_op.py "view source code")
+
+Bases: [`PrimitiveOp`](qiskit.opflow.primitive_ops.PrimitiveOp "qiskit.opflow.primitive_ops.primitive_op.PrimitiveOp")
+
+Deprecated: Class for Operators backed by Terra’s `QuantumCircuit` module.
+
+
+ The class `qiskit.opflow.primitive_ops.circuit_op.CircuitOp` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **primitive** – The QuantumCircuit which defines the
+* **function.** (*behavior of the underlying*) –
+* **coeff** – A coefficient multiplying the primitive
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Unsupported primitive, or primitive has ClassicalRegisters.
+
+## Attributes
+
+
+
+### INDENTATION
+
+`= ' '`
+
+
+
+### coeff
+
+The scalar coefficient multiplying the Operator.
+
+**Returns**
+
+The coefficient.
+
+
+
+### instance\_id
+
+Return the unique instance id.
+
+
+
+### num\_qubits
+
+
+
+### parameters
+
+
+
+### primitive
+
+`QuantumCircuit`
+
+The primitive defining the underlying function of the Operator.
+
+**Returns**
+
+The primitive object.
+
+
+
+### settings
+
+Return operator settings.
+
+## Methods
+
+### add
+
+
+
+`add(other)`
+
+Return Operator addition of self and other, overloaded by `+`.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – An `OperatorBase` with the same number of qubits as self, and in the same ‘Operator’, ‘State function’, or ‘Measurement’ category as self (i.e. the same type of underlying function).
+
+**Returns**
+
+An `OperatorBase` equivalent to the sum of self and other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return a new Operator equal to the Operator’s adjoint (conjugate transpose), overloaded by `~`. For StateFns, this also turns the StateFn into a measurement.
+
+**Returns**
+
+An `OperatorBase` equivalent to the adjoint of self.
+
+**Return type**
+
+[*CircuitOp*](#qiskit.opflow.primitive_ops.CircuitOp "qiskit.opflow.primitive_ops.circuit_op.CircuitOp")
+
+### assign\_parameters
+
+
+
+`assign_parameters(param_dict)`
+
+Binds scalar values to any Terra `Parameters` in the coefficients or primitives of the Operator, or substitutes one `Parameter` for another. This method differs from Terra’s `assign_parameters` in that it also supports lists of values to assign for a give `Parameter`, in which case self will be copied for each parameterization in the binding list(s), and all the copies will be returned in an `OpList`. If lists of parameterizations are used, every `Parameter` in the param\_dict must have the same length list of parameterizations.
+
+**Parameters**
+
+**param\_dict** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – The dictionary of `Parameters` to replace, and values or lists of values by which to replace them.
+
+**Returns**
+
+The `OperatorBase` with the `Parameters` in self replaced by the values or `Parameters` in param\_dict. If param\_dict contains parameterization lists, this `OperatorBase` is an `OpList`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### compose
+
+
+
+`compose(other, permutation=None, front=False)`
+
+Return Operator Composition between self and other (linear algebra-style: A\@B(x) = A(B(x))), overloaded by `@`.
+
+Note: You must be conscious of Quantum Circuit vs. Linear Algebra ordering conventions. Meaning, X.compose(Y) produces an X∘Y on qubit 0, but would produce a QuantumCircuit which looks like
+
+> -\[Y]-\[X]-
+
+Because Terra prints circuits with the initial state at the left side of the circuit.
+
+**Parameters**
+
+* **other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` with which to compose self.
+* **permutation** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – `List[int]` which defines permutation on other operator.
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If front==True, return `other.compose(self)`.
+
+**Returns**
+
+An `OperatorBase` equivalent to the function composition of self and other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### equals
+
+
+
+`equals(other)`
+
+Evaluate Equality between Operators, overloaded by `==`. Only returns True if self and other are of the same representation (e.g. a DictStateFn and CircuitStateFn will never be equal, even if their vector representations are equal), their underlying primitives are equal (this means for ListOps, OperatorStateFns, or EvolvedOps the equality is evaluated recursively downwards), and their coefficients are equal.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to compare to self.
+
+**Returns**
+
+A bool equal to the equality of self and other.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### eval
+
+
+
+`eval(front=None)`
+
+Evaluate the Operator’s underlying function, either on a binary string or another Operator. A square binary Operator can be defined as a function taking a binary function to another binary function. This method returns the value of that function for a given StateFn or binary string. For example, `op.eval('0110').eval('1110')` can be seen as querying the Operator’s matrix representation by row 6 and column 14, and will return the complex value at those “indices.” Similarly for a StateFn, `op.eval('1011')` will return the complex value at row 11 of the vector representation of the StateFn, as all StateFns are defined to be evaluated from Zero implicitly (i.e. it is as if `.eval('0000')` is already called implicitly to always “indexing” from column 0).
+
+If `front` is None, the matrix-representation of the operator is returned.
+
+**Parameters**
+
+**front** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*] |* [*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") *|*[*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.states.statevector.Statevector") *| None*) – The bitstring, dict of bitstrings (with values being coefficients), or StateFn to evaluated by the Operator’s underlying function, or None.
+
+**Returns**
+
+The output of the Operator’s evaluation function. If self is a `StateFn`, the result is a float or complex. If self is an Operator (`PrimitiveOp, ComposedOp, SummedOp, EvolvedOp,` etc.), the result is a StateFn. If `front` is None, the matrix-representation of the operator is returned, which is a `MatrixOp` for the operators and a `VectorStateFn` for state-functions. If either self or front contain proper `ListOps` (not ListOp subclasses), the result is an n-dimensional list of complex or StateFn results, resulting from the recursive evaluation by each OperatorBase in the ListOps.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") | [complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")
+
+### permute
+
+
+
+`permute(permutation)`
+
+Permute the qubits of the circuit.
+
+**Parameters**
+
+**permutation** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – A list defining where each qubit should be permuted. The qubit at index j of the circuit should be permuted to position permutation\[j].
+
+**Returns**
+
+A new CircuitOp containing the permuted circuit.
+
+**Return type**
+
+[*CircuitOp*](#qiskit.opflow.primitive_ops.CircuitOp "qiskit.opflow.primitive_ops.circuit_op.CircuitOp")
+
+### primitive\_strings
+
+
+
+`primitive_strings()`
+
+Return a set of strings describing the primitives contained in the Operator. For example, `{'QuantumCircuit', 'Pauli'}`. For hierarchical Operators, such as `ListOps`, this can help illuminate the primitives represented in the various recursive levels, and therefore which conversions can be applied.
+
+**Returns**
+
+A set of strings describing the primitives contained within the Operator.
+
+**Return type**
+
+[*Set*](https://docs.python.org/3/library/typing.html#typing.Set "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")]
+
+### reduce
+
+
+
+`reduce()`
+
+Try collapsing the Operator structure, usually after some type of conversion, e.g. trying to add Operators in a SummedOp or delete needless IGates in a CircuitOp. If no reduction is available, just returns self.
+
+**Returns**
+
+The reduced `OperatorBase`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return tensor product between self and other, overloaded by `^`. Note: You must be conscious of Qiskit’s big-endian bit printing convention. Meaning, X.tensor(Y) produces an X on qubit 0 and an Y on qubit 1, or X⨂Y, but would produce a QuantumCircuit which looks like
+
+> -\[Y]- -\[X]-
+
+Because Terra prints circuits and results with qubit 0 at the end of the string or circuit.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to tensor product with self.
+
+**Returns**
+
+An `OperatorBase` equivalent to the tensor product of self and other.
+
+**Return type**
+
+[*CircuitOp*](#qiskit.opflow.primitive_ops.CircuitOp "qiskit.opflow.primitive_ops.circuit_op.CircuitOp") | [*TensoredOp*](qiskit.opflow.list_ops.TensoredOp "qiskit.opflow.list_ops.tensored_op.TensoredOp")
+
+### to\_circuit
+
+
+
+`to_circuit()`
+
+Returns a `QuantumCircuit` equivalent to this Operator.
+
+**Return type**
+
+[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+### to\_circuit\_op
+
+
+
+`to_circuit_op()`
+
+Returns a `CircuitOp` equivalent to this Operator.
+
+**Return type**
+
+[*CircuitOp*](#qiskit.opflow.primitive_ops.CircuitOp "qiskit.opflow.primitive_ops.circuit_op.CircuitOp")
+
+### to\_instruction
+
+
+
+`to_instruction()`
+
+Returns an `Instruction` equivalent to this Operator.
+
+**Return type**
+
+[*Instruction*](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")
+
+### to\_matrix
+
+
+
+`to_matrix(massive=False)`
+
+Return NumPy representation of the Operator. Represents the evaluation of the Operator’s underlying function on every combination of basis binary strings. Warn if more than 16 qubits to force having to set `massive=True` if such a large vector is desired.
+
+**Returns**
+
+The NumPy `ndarray` equivalent to this Operator.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.MatrixOp.md b/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.MatrixOp.md
new file mode 100644
index 00000000000..5d2829aa22b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.MatrixOp.md
@@ -0,0 +1,306 @@
+---
+title: MatrixOp
+description: API reference for qiskit.opflow.primitive_ops.MatrixOp
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.primitive_ops.MatrixOp
+---
+
+# MatrixOp
+
+
+
+`qiskit.opflow.primitive_ops.MatrixOp(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/primitive_ops/matrix_op.py "view source code")
+
+Bases: [`PrimitiveOp`](qiskit.opflow.primitive_ops.PrimitiveOp "qiskit.opflow.primitive_ops.primitive_op.PrimitiveOp")
+
+Deprecated: Class for Operators represented by matrices, backed by Terra’s `Operator` module.
+
+
+ The class `qiskit.opflow.primitive_ops.matrix_op.MatrixOp` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **primitive** – The matrix-like object which defines the behavior of the underlying function.
+* **coeff** – A coefficient multiplying the primitive
+
+**Raises**
+
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – invalid parameters.
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – invalid parameters.
+
+## Attributes
+
+
+
+### INDENTATION
+
+`= ' '`
+
+
+
+### coeff
+
+The scalar coefficient multiplying the Operator.
+
+**Returns**
+
+The coefficient.
+
+
+
+### instance\_id
+
+Return the unique instance id.
+
+
+
+### num\_qubits
+
+
+
+### parameters
+
+
+
+### primitive
+
+`Operator`
+
+The primitive defining the underlying function of the Operator.
+
+**Returns**
+
+The primitive object.
+
+
+
+### settings
+
+Return operator settings.
+
+## Methods
+
+### add
+
+
+
+`add(other)`
+
+Return Operator addition of self and other, overloaded by `+`.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – An `OperatorBase` with the same number of qubits as self, and in the same ‘Operator’, ‘State function’, or ‘Measurement’ category as self (i.e. the same type of underlying function).
+
+**Returns**
+
+An `OperatorBase` equivalent to the sum of self and other.
+
+**Return type**
+
+[*MatrixOp*](#qiskit.opflow.primitive_ops.MatrixOp "qiskit.opflow.primitive_ops.matrix_op.MatrixOp") | [*SummedOp*](qiskit.opflow.list_ops.SummedOp "qiskit.opflow.list_ops.summed_op.SummedOp")
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return a new Operator equal to the Operator’s adjoint (conjugate transpose), overloaded by `~`. For StateFns, this also turns the StateFn into a measurement.
+
+**Returns**
+
+An `OperatorBase` equivalent to the adjoint of self.
+
+**Return type**
+
+[*MatrixOp*](#qiskit.opflow.primitive_ops.MatrixOp "qiskit.opflow.primitive_ops.matrix_op.MatrixOp")
+
+### compose
+
+
+
+`compose(other, permutation=None, front=False)`
+
+Return Operator Composition between self and other (linear algebra-style: A\@B(x) = A(B(x))), overloaded by `@`.
+
+Note: You must be conscious of Quantum Circuit vs. Linear Algebra ordering conventions. Meaning, X.compose(Y) produces an X∘Y on qubit 0, but would produce a QuantumCircuit which looks like
+
+> -\[Y]-\[X]-
+
+Because Terra prints circuits with the initial state at the left side of the circuit.
+
+**Parameters**
+
+* **other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` with which to compose self.
+* **permutation** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – `List[int]` which defines permutation on other operator.
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If front==True, return `other.compose(self)`.
+
+**Returns**
+
+An `OperatorBase` equivalent to the function composition of self and other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### equals
+
+
+
+`equals(other)`
+
+Evaluate Equality between Operators, overloaded by `==`. Only returns True if self and other are of the same representation (e.g. a DictStateFn and CircuitStateFn will never be equal, even if their vector representations are equal), their underlying primitives are equal (this means for ListOps, OperatorStateFns, or EvolvedOps the equality is evaluated recursively downwards), and their coefficients are equal.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to compare to self.
+
+**Returns**
+
+A bool equal to the equality of self and other.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### eval
+
+
+
+`eval(front=None)`
+
+Evaluate the Operator’s underlying function, either on a binary string or another Operator. A square binary Operator can be defined as a function taking a binary function to another binary function. This method returns the value of that function for a given StateFn or binary string. For example, `op.eval('0110').eval('1110')` can be seen as querying the Operator’s matrix representation by row 6 and column 14, and will return the complex value at those “indices.” Similarly for a StateFn, `op.eval('1011')` will return the complex value at row 11 of the vector representation of the StateFn, as all StateFns are defined to be evaluated from Zero implicitly (i.e. it is as if `.eval('0000')` is already called implicitly to always “indexing” from column 0).
+
+If `front` is None, the matrix-representation of the operator is returned.
+
+**Parameters**
+
+**front** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*] |* [*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") *|*[*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.states.statevector.Statevector") *| None*) – The bitstring, dict of bitstrings (with values being coefficients), or StateFn to evaluated by the Operator’s underlying function, or None.
+
+**Returns**
+
+The output of the Operator’s evaluation function. If self is a `StateFn`, the result is a float or complex. If self is an Operator (`PrimitiveOp, ComposedOp, SummedOp, EvolvedOp,` etc.), the result is a StateFn. If `front` is None, the matrix-representation of the operator is returned, which is a `MatrixOp` for the operators and a `VectorStateFn` for state-functions. If either self or front contain proper `ListOps` (not ListOp subclasses), the result is an n-dimensional list of complex or StateFn results, resulting from the recursive evaluation by each OperatorBase in the ListOps.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") | [complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")
+
+### exp\_i
+
+
+
+`exp_i()`
+
+Return a `CircuitOp` equivalent to e^-iH for this operator H
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### permute
+
+
+
+`permute(permutation=None)`
+
+Creates a new MatrixOp that acts on the permuted qubits.
+
+**Parameters**
+
+**permutation** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – A list defining where each qubit should be permuted. The qubit at index j should be permuted to position permutation\[j].
+
+**Returns**
+
+A new MatrixOp representing the permuted operator.
+
+**Raises**
+
+[**OpflowError**](opflow#qiskit.opflow.OpflowError "qiskit.opflow.OpflowError") – if indices do not define a new index for each qubit.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### primitive\_strings
+
+
+
+`primitive_strings()`
+
+Return a set of strings describing the primitives contained in the Operator. For example, `{'QuantumCircuit', 'Pauli'}`. For hierarchical Operators, such as `ListOps`, this can help illuminate the primitives represented in the various recursive levels, and therefore which conversions can be applied.
+
+**Returns**
+
+A set of strings describing the primitives contained within the Operator.
+
+**Return type**
+
+[*Set*](https://docs.python.org/3/library/typing.html#typing.Set "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")]
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return tensor product between self and other, overloaded by `^`. Note: You must be conscious of Qiskit’s big-endian bit printing convention. Meaning, X.tensor(Y) produces an X on qubit 0 and an Y on qubit 1, or X⨂Y, but would produce a QuantumCircuit which looks like
+
+> -\[Y]- -\[X]-
+
+Because Terra prints circuits and results with qubit 0 at the end of the string or circuit.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to tensor product with self.
+
+**Returns**
+
+An `OperatorBase` equivalent to the tensor product of self and other.
+
+**Return type**
+
+[*MatrixOp*](#qiskit.opflow.primitive_ops.MatrixOp "qiskit.opflow.primitive_ops.matrix_op.MatrixOp") | [*TensoredOp*](qiskit.opflow.list_ops.TensoredOp "qiskit.opflow.list_ops.tensored_op.TensoredOp")
+
+### to\_instruction
+
+
+
+`to_instruction()`
+
+Returns an `Instruction` equivalent to this Operator.
+
+**Return type**
+
+[*Instruction*](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")
+
+### to\_matrix
+
+
+
+`to_matrix(massive=False)`
+
+Return NumPy representation of the Operator. Represents the evaluation of the Operator’s underlying function on every combination of basis binary strings. Warn if more than 16 qubits to force having to set `massive=True` if such a large vector is desired.
+
+**Returns**
+
+The NumPy `ndarray` equivalent to this Operator.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+### to\_matrix\_op
+
+
+
+`to_matrix_op(massive=False)`
+
+Returns a `MatrixOp` equivalent to this Operator.
+
+**Return type**
+
+[*MatrixOp*](#qiskit.opflow.primitive_ops.MatrixOp "qiskit.opflow.primitive_ops.matrix_op.MatrixOp")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.PauliOp.md b/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.PauliOp.md
new file mode 100644
index 00000000000..b199d43267a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.PauliOp.md
@@ -0,0 +1,337 @@
+---
+title: PauliOp
+description: API reference for qiskit.opflow.primitive_ops.PauliOp
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.primitive_ops.PauliOp
+---
+
+# PauliOp
+
+
+
+`qiskit.opflow.primitive_ops.PauliOp(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/primitive_ops/pauli_op.py "view source code")
+
+Bases: [`PrimitiveOp`](qiskit.opflow.primitive_ops.PrimitiveOp "qiskit.opflow.primitive_ops.primitive_op.PrimitiveOp")
+
+Deprecated: Class for Operators backed by Terra’s `Pauli` module.
+
+
+ The class `qiskit.opflow.primitive_ops.pauli_op.PauliOp` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **primitive** – The Pauli which defines the behavior of the underlying function.
+* **coeff** – A coefficient multiplying the primitive.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – invalid parameters.
+
+## Attributes
+
+
+
+### INDENTATION
+
+`= ' '`
+
+
+
+### coeff
+
+The scalar coefficient multiplying the Operator.
+
+**Returns**
+
+The coefficient.
+
+
+
+### instance\_id
+
+Return the unique instance id.
+
+
+
+### num\_qubits
+
+
+
+### parameters
+
+
+
+### primitive
+
+`Pauli`
+
+The primitive defining the underlying function of the Operator.
+
+**Returns**
+
+The primitive object.
+
+
+
+### settings
+
+Return operator settings.
+
+## Methods
+
+### add
+
+
+
+`add(other)`
+
+Return Operator addition of self and other, overloaded by `+`.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – An `OperatorBase` with the same number of qubits as self, and in the same ‘Operator’, ‘State function’, or ‘Measurement’ category as self (i.e. the same type of underlying function).
+
+**Returns**
+
+An `OperatorBase` equivalent to the sum of self and other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return a new Operator equal to the Operator’s adjoint (conjugate transpose), overloaded by `~`. For StateFns, this also turns the StateFn into a measurement.
+
+**Returns**
+
+An `OperatorBase` equivalent to the adjoint of self.
+
+**Return type**
+
+[*PauliOp*](#qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.pauli_op.PauliOp")
+
+### compose
+
+
+
+`compose(other, permutation=None, front=False)`
+
+Return Operator Composition between self and other (linear algebra-style: A\@B(x) = A(B(x))), overloaded by `@`.
+
+Note: You must be conscious of Quantum Circuit vs. Linear Algebra ordering conventions. Meaning, X.compose(Y) produces an X∘Y on qubit 0, but would produce a QuantumCircuit which looks like
+
+> -\[Y]-\[X]-
+
+Because Terra prints circuits with the initial state at the left side of the circuit.
+
+**Parameters**
+
+* **other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` with which to compose self.
+* **permutation** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – `List[int]` which defines permutation on other operator.
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If front==True, return `other.compose(self)`.
+
+**Returns**
+
+An `OperatorBase` equivalent to the function composition of self and other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### equals
+
+
+
+`equals(other)`
+
+Evaluate Equality between Operators, overloaded by `==`. Only returns True if self and other are of the same representation (e.g. a DictStateFn and CircuitStateFn will never be equal, even if their vector representations are equal), their underlying primitives are equal (this means for ListOps, OperatorStateFns, or EvolvedOps the equality is evaluated recursively downwards), and their coefficients are equal.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to compare to self.
+
+**Returns**
+
+A bool equal to the equality of self and other.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### eval
+
+
+
+`eval(front=None)`
+
+Evaluate the Operator’s underlying function, either on a binary string or another Operator. A square binary Operator can be defined as a function taking a binary function to another binary function. This method returns the value of that function for a given StateFn or binary string. For example, `op.eval('0110').eval('1110')` can be seen as querying the Operator’s matrix representation by row 6 and column 14, and will return the complex value at those “indices.” Similarly for a StateFn, `op.eval('1011')` will return the complex value at row 11 of the vector representation of the StateFn, as all StateFns are defined to be evaluated from Zero implicitly (i.e. it is as if `.eval('0000')` is already called implicitly to always “indexing” from column 0).
+
+If `front` is None, the matrix-representation of the operator is returned.
+
+**Parameters**
+
+**front** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*] |* [*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") *|*[*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.states.statevector.Statevector") *| None*) – The bitstring, dict of bitstrings (with values being coefficients), or StateFn to evaluated by the Operator’s underlying function, or None.
+
+**Returns**
+
+The output of the Operator’s evaluation function. If self is a `StateFn`, the result is a float or complex. If self is an Operator (`PrimitiveOp, ComposedOp, SummedOp, EvolvedOp,` etc.), the result is a StateFn. If `front` is None, the matrix-representation of the operator is returned, which is a `MatrixOp` for the operators and a `VectorStateFn` for state-functions. If either self or front contain proper `ListOps` (not ListOp subclasses), the result is an n-dimensional list of complex or StateFn results, resulting from the recursive evaluation by each OperatorBase in the ListOps.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") | [complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")
+
+### exp\_i
+
+
+
+`exp_i()`
+
+Return a `CircuitOp` equivalent to e^-iH for this operator H.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### permute
+
+
+
+`permute(permutation)`
+
+Permutes the sequence of Pauli matrices.
+
+**Parameters**
+
+**permutation** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – A list defining where each Pauli should be permuted. The Pauli at index j of the primitive should be permuted to position permutation\[j].
+
+**Returns**
+
+A new PauliOp representing the permuted operator. For operator (X ^ Y ^ Z) and indices=\[1,2,4], it returns (X ^ I ^ Y ^ Z ^ I).
+
+**Raises**
+
+[**OpflowError**](opflow#qiskit.opflow.OpflowError "qiskit.opflow.OpflowError") – if indices do not define a new index for each qubit.
+
+**Return type**
+
+[*PauliOp*](#qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.pauli_op.PauliOp")
+
+### primitive\_strings
+
+
+
+`primitive_strings()`
+
+Return a set of strings describing the primitives contained in the Operator. For example, `{'QuantumCircuit', 'Pauli'}`. For hierarchical Operators, such as `ListOps`, this can help illuminate the primitives represented in the various recursive levels, and therefore which conversions can be applied.
+
+**Returns**
+
+A set of strings describing the primitives contained within the Operator.
+
+**Return type**
+
+[*Set*](https://docs.python.org/3/library/typing.html#typing.Set "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")]
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return tensor product between self and other, overloaded by `^`. Note: You must be conscious of Qiskit’s big-endian bit printing convention. Meaning, X.tensor(Y) produces an X on qubit 0 and an Y on qubit 1, or X⨂Y, but would produce a QuantumCircuit which looks like
+
+> -\[Y]- -\[X]-
+
+Because Terra prints circuits and results with qubit 0 at the end of the string or circuit.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to tensor product with self.
+
+**Returns**
+
+An `OperatorBase` equivalent to the tensor product of self and other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### to\_circuit
+
+
+
+`to_circuit()`
+
+Returns a `QuantumCircuit` equivalent to this Operator.
+
+**Return type**
+
+[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+### to\_instruction
+
+
+
+`to_instruction()`
+
+Returns an `Instruction` equivalent to this Operator.
+
+**Return type**
+
+[*Instruction*](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")
+
+### to\_matrix
+
+
+
+`to_matrix(massive=False)`
+
+Return NumPy representation of the Operator. Represents the evaluation of the Operator’s underlying function on every combination of basis binary strings. Warn if more than 16 qubits to force having to set `massive=True` if such a large vector is desired.
+
+**Returns**
+
+The NumPy `ndarray` equivalent to this Operator.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+### to\_pauli\_op
+
+
+
+`to_pauli_op(massive=False)`
+
+Returns a sum of `PauliOp` s equivalent to this Operator.
+
+**Return type**
+
+[*PauliOp*](#qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.pauli_op.PauliOp")
+
+### to\_spmatrix
+
+
+
+`to_spmatrix()`
+
+Returns SciPy sparse matrix representation of the Operator.
+
+**Returns**
+
+CSR sparse matrix representation of the Operator.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – invalid parameters.
+
+**Return type**
+
+*spmatrix*
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.PauliSumOp.md b/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.PauliSumOp.md
new file mode 100644
index 00000000000..20776cec8f6
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.PauliSumOp.md
@@ -0,0 +1,449 @@
+---
+title: PauliSumOp
+description: API reference for qiskit.opflow.primitive_ops.PauliSumOp
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.primitive_ops.PauliSumOp
+---
+
+# PauliSumOp
+
+
+
+`qiskit.opflow.primitive_ops.PauliSumOp(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/primitive_ops/pauli_sum_op.py "view source code")
+
+Bases: [`PrimitiveOp`](qiskit.opflow.primitive_ops.PrimitiveOp "qiskit.opflow.primitive_ops.primitive_op.PrimitiveOp")
+
+Deprecated: Class for Operators backed by Terra’s `SparsePauliOp` class.
+
+
+ The class `qiskit.opflow.primitive_ops.pauli_sum_op.PauliSumOp` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **primitive** – The SparsePauliOp which defines the behavior of the underlying function.
+* **coeff** – A coefficient multiplying the primitive.
+* **grouping\_type** – The type of grouping. If None, the operator is not grouped.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – invalid parameters.
+
+## Attributes
+
+
+
+### INDENTATION
+
+`= ' '`
+
+
+
+### coeff
+
+The scalar coefficient multiplying the Operator.
+
+**Returns**
+
+The coefficient.
+
+
+
+### coeffs
+
+Return the Pauli coefficients.
+
+
+
+### grouping\_type
+
+Type of Grouping
+
+**Type**
+
+Returns
+
+
+
+### instance\_id
+
+Return the unique instance id.
+
+
+
+### num\_qubits
+
+
+
+### parameters
+
+
+
+### primitive
+
+`SparsePauliOp`
+
+The primitive defining the underlying function of the Operator.
+
+**Returns**
+
+The primitive object.
+
+
+
+### settings
+
+Return operator settings.
+
+## Methods
+
+### add
+
+
+
+`add(other)`
+
+Return Operator addition of self and other, overloaded by `+`.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – An `OperatorBase` with the same number of qubits as self, and in the same ‘Operator’, ‘State function’, or ‘Measurement’ category as self (i.e. the same type of underlying function).
+
+**Returns**
+
+An `OperatorBase` equivalent to the sum of self and other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return a new Operator equal to the Operator’s adjoint (conjugate transpose), overloaded by `~`. For StateFns, this also turns the StateFn into a measurement.
+
+**Returns**
+
+An `OperatorBase` equivalent to the adjoint of self.
+
+**Return type**
+
+[*PauliSumOp*](#qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.pauli_sum_op.PauliSumOp")
+
+### compose
+
+
+
+`compose(other, permutation=None, front=False)`
+
+Return Operator Composition between self and other (linear algebra-style: A\@B(x) = A(B(x))), overloaded by `@`.
+
+Note: You must be conscious of Quantum Circuit vs. Linear Algebra ordering conventions. Meaning, X.compose(Y) produces an X∘Y on qubit 0, but would produce a QuantumCircuit which looks like
+
+> -\[Y]-\[X]-
+
+Because Terra prints circuits with the initial state at the left side of the circuit.
+
+**Parameters**
+
+* **other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` with which to compose self.
+* **permutation** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – `List[int]` which defines permutation on other operator.
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If front==True, return `other.compose(self)`.
+
+**Returns**
+
+An `OperatorBase` equivalent to the function composition of self and other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### equals
+
+
+
+`equals(other)`
+
+Evaluate Equality between Operators, overloaded by `==`. Only returns True if self and other are of the same representation (e.g. a DictStateFn and CircuitStateFn will never be equal, even if their vector representations are equal), their underlying primitives are equal (this means for ListOps, OperatorStateFns, or EvolvedOps the equality is evaluated recursively downwards), and their coefficients are equal.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to compare to self.
+
+**Returns**
+
+A bool equal to the equality of self and other.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### eval
+
+
+
+`eval(front=None)`
+
+Evaluate the Operator’s underlying function, either on a binary string or another Operator. A square binary Operator can be defined as a function taking a binary function to another binary function. This method returns the value of that function for a given StateFn or binary string. For example, `op.eval('0110').eval('1110')` can be seen as querying the Operator’s matrix representation by row 6 and column 14, and will return the complex value at those “indices.” Similarly for a StateFn, `op.eval('1011')` will return the complex value at row 11 of the vector representation of the StateFn, as all StateFns are defined to be evaluated from Zero implicitly (i.e. it is as if `.eval('0000')` is already called implicitly to always “indexing” from column 0).
+
+If `front` is None, the matrix-representation of the operator is returned.
+
+**Parameters**
+
+**front** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*] |* [*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") *|*[*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.states.statevector.Statevector") *| None*) – The bitstring, dict of bitstrings (with values being coefficients), or StateFn to evaluated by the Operator’s underlying function, or None.
+
+**Returns**
+
+The output of the Operator’s evaluation function. If self is a `StateFn`, the result is a float or complex. If self is an Operator (`PrimitiveOp, ComposedOp, SummedOp, EvolvedOp,` etc.), the result is a StateFn. If `front` is None, the matrix-representation of the operator is returned, which is a `MatrixOp` for the operators and a `VectorStateFn` for state-functions. If either self or front contain proper `ListOps` (not ListOp subclasses), the result is an n-dimensional list of complex or StateFn results, resulting from the recursive evaluation by each OperatorBase in the ListOps.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") | [complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")
+
+### exp\_i
+
+
+
+`exp_i()`
+
+Return a `CircuitOp` equivalent to e^-iH for this operator H.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### from\_list
+
+
+
+`classmethod from_list(pauli_list, coeff=1.0, dtype=)`
+
+Construct from a pauli\_list with the form \[(pauli\_str, coeffs)]
+
+**Parameters**
+
+* **pauli\_list** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*]]*) – A list of Tuple of pauli\_str and coefficient.
+* **coeff** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – A coefficient multiplying the primitive.
+* **dtype** ([*type*](https://docs.python.org/3/library/functions.html#type "(in Python v3.12)")) – The dtype to use to construct the internal SparsePauliOp. Defaults to `complex`.
+
+**Returns**
+
+The PauliSumOp constructed from the pauli\_list.
+
+**Return type**
+
+[*PauliSumOp*](#qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.pauli_sum_op.PauliSumOp")
+
+### is\_hermitian
+
+
+
+`is_hermitian()`
+
+Return True if the operator is hermitian.
+
+Returns: Boolean value
+
+### is\_zero
+
+
+
+`is_zero()`
+
+Return this operator is zero operator or not.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### matrix\_iter
+
+
+
+`matrix_iter(sparse=False)`
+
+Return a matrix representation iterator.
+
+This is a lazy iterator that converts each term in the PauliSumOp into a matrix as it is used. To convert to a single matrix use the [`to_matrix()`](#qiskit.opflow.primitive_ops.PauliSumOp.to_matrix "qiskit.opflow.primitive_ops.PauliSumOp.to_matrix") method.
+
+**Parameters**
+
+**sparse** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – optionally return sparse CSR matrices if True, otherwise return Numpy array matrices (Default: False)
+
+**Returns**
+
+matrix iterator object for the PauliSumOp.
+
+**Return type**
+
+MatrixIterator
+
+### mul
+
+
+
+`mul(scalar)`
+
+Returns the scalar multiplication of the Operator, overloaded by `*`, including support for Terra’s `Parameters`, which can be bound to values later (via `bind_parameters`).
+
+**Parameters**
+
+**scalar** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The real or complex scalar by which to multiply the Operator, or the `ParameterExpression` to serve as a placeholder for a scalar factor.
+
+**Returns**
+
+An `OperatorBase` equivalent to product of self and scalar.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### permute
+
+
+
+`permute(permutation)`
+
+Permutes the sequence of `PauliSumOp`.
+
+**Parameters**
+
+**permutation** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – A list defining where each Pauli should be permuted. The Pauli at index j of the primitive should be permuted to position permutation\[j].
+
+**Returns**
+
+A new PauliSumOp representing the permuted operator. For operator (X ^ Y ^ Z) and indices=\[1,2,4], it returns (X ^ I ^ Y ^ Z ^ I).
+
+**Raises**
+
+[**OpflowError**](opflow#qiskit.opflow.OpflowError "qiskit.opflow.OpflowError") – if indices do not define a new index for each qubit.
+
+**Return type**
+
+[*PauliSumOp*](#qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.pauli_sum_op.PauliSumOp")
+
+### primitive\_strings
+
+
+
+`primitive_strings()`
+
+Return a set of strings describing the primitives contained in the Operator. For example, `{'QuantumCircuit', 'Pauli'}`. For hierarchical Operators, such as `ListOps`, this can help illuminate the primitives represented in the various recursive levels, and therefore which conversions can be applied.
+
+**Returns**
+
+A set of strings describing the primitives contained within the Operator.
+
+**Return type**
+
+[*Set*](https://docs.python.org/3/library/typing.html#typing.Set "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")]
+
+### reduce
+
+
+
+`reduce(atol=None, rtol=None)`
+
+Simplify the primitive `SparsePauliOp`.
+
+**Parameters**
+
+* **atol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – Absolute tolerance for checking if coefficients are zero (Default: 1e-8).
+* **rtol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – Relative tolerance for checking if coefficients are zero (Default: 1e-5).
+
+**Returns**
+
+The simplified `PauliSumOp`.
+
+**Return type**
+
+[*PauliSumOp*](#qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.pauli_sum_op.PauliSumOp")
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return tensor product between self and other, overloaded by `^`. Note: You must be conscious of Qiskit’s big-endian bit printing convention. Meaning, X.tensor(Y) produces an X on qubit 0 and an Y on qubit 1, or X⨂Y, but would produce a QuantumCircuit which looks like
+
+> -\[Y]- -\[X]-
+
+Because Terra prints circuits and results with qubit 0 at the end of the string or circuit.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to tensor product with self.
+
+**Returns**
+
+An `OperatorBase` equivalent to the tensor product of self and other.
+
+**Return type**
+
+[*PauliSumOp*](#qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.pauli_sum_op.PauliSumOp") | [*TensoredOp*](qiskit.opflow.list_ops.TensoredOp "qiskit.opflow.list_ops.tensored_op.TensoredOp")
+
+### to\_instruction
+
+
+
+`to_instruction()`
+
+Returns an `Instruction` equivalent to this Operator.
+
+**Return type**
+
+[*Instruction*](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")
+
+### to\_matrix
+
+
+
+`to_matrix(massive=False)`
+
+Return NumPy representation of the Operator. Represents the evaluation of the Operator’s underlying function on every combination of basis binary strings. Warn if more than 16 qubits to force having to set `massive=True` if such a large vector is desired.
+
+**Returns**
+
+The NumPy `ndarray` equivalent to this Operator.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+### to\_pauli\_op
+
+
+
+`to_pauli_op(massive=False)`
+
+Returns a sum of `PauliOp` s equivalent to this Operator.
+
+**Return type**
+
+[*PauliOp*](qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.pauli_op.PauliOp") | [*SummedOp*](qiskit.opflow.list_ops.SummedOp "qiskit.opflow.list_ops.summed_op.SummedOp")
+
+### to\_spmatrix
+
+
+
+`to_spmatrix()`
+
+Returns SciPy sparse matrix representation of the `PauliSumOp`.
+
+**Returns**
+
+CSR sparse matrix representation of the `PauliSumOp`.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – invalid parameters.
+
+**Return type**
+
+*spmatrix*
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.PrimitiveOp.md b/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.PrimitiveOp.md
new file mode 100644
index 00000000000..65736076e39
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.PrimitiveOp.md
@@ -0,0 +1,429 @@
+---
+title: PrimitiveOp
+description: API reference for qiskit.opflow.primitive_ops.PrimitiveOp
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.primitive_ops.PrimitiveOp
+---
+
+# PrimitiveOp
+
+
+
+`qiskit.opflow.primitive_ops.PrimitiveOp(primitive, coeff=1.0)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/primitive_ops/primitive_op.py "view source code")
+
+Bases: [`OperatorBase`](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+Deprecated: A class for representing basic Operators, backed by Operator primitives from Terra. This class (and inheritors) primarily serves to allow the underlying primitives to “flow” - i.e. interoperability and adherence to the Operator formalism - while the core computational logic mostly remains in the underlying primitives. For example, we would not produce an interface in Terra in which `QuantumCircuit1 + QuantumCircuit2` equaled the Operator sum of the circuit unitaries, rather than simply appending the circuits. However, within the Operator flow summing the unitaries is the expected behavior.
+
+Note that all mathematical methods are not in-place, meaning that they return a new object, but the underlying primitives are not copied.
+
+
+ The class `qiskit.opflow.primitive_ops.primitive_op.PrimitiveOp` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **primitive** ([*Instruction*](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction") *|*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)") *|*[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *| spmatrix |*[*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.operators.operator.Operator") *|*[*Pauli*](qiskit.quantum_info.Pauli "qiskit.quantum_info.operators.symplectic.pauli.Pauli") *|*[*SparsePauliOp*](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.operators.symplectic.sparse_pauli_op.SparsePauliOp")) – The operator primitive being wrapped.
+* **coeff** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – A coefficient multiplying the primitive.
+
+**Return type**
+
+[PrimitiveOp](#qiskit.opflow.primitive_ops.PrimitiveOp "qiskit.opflow.primitive_ops.PrimitiveOp")
+
+## Attributes
+
+
+
+### INDENTATION
+
+`= ' '`
+
+
+
+### coeff
+
+The scalar coefficient multiplying the Operator.
+
+**Returns**
+
+The coefficient.
+
+
+
+### instance\_id
+
+Return the unique instance id.
+
+
+
+### num\_qubits
+
+
+
+### parameters
+
+
+
+### primitive
+
+The primitive defining the underlying function of the Operator.
+
+**Returns**
+
+The primitive object.
+
+
+
+### settings
+
+Return operator settings.
+
+## Methods
+
+### add
+
+
+
+`add(other)`
+
+Return Operator addition of self and other, overloaded by `+`.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – An `OperatorBase` with the same number of qubits as self, and in the same ‘Operator’, ‘State function’, or ‘Measurement’ category as self (i.e. the same type of underlying function).
+
+**Returns**
+
+An `OperatorBase` equivalent to the sum of self and other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return a new Operator equal to the Operator’s adjoint (conjugate transpose), overloaded by `~`. For StateFns, this also turns the StateFn into a measurement.
+
+**Returns**
+
+An `OperatorBase` equivalent to the adjoint of self.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### assign\_parameters
+
+
+
+`assign_parameters(param_dict)`
+
+Binds scalar values to any Terra `Parameters` in the coefficients or primitives of the Operator, or substitutes one `Parameter` for another. This method differs from Terra’s `assign_parameters` in that it also supports lists of values to assign for a give `Parameter`, in which case self will be copied for each parameterization in the binding list(s), and all the copies will be returned in an `OpList`. If lists of parameterizations are used, every `Parameter` in the param\_dict must have the same length list of parameterizations.
+
+**Parameters**
+
+**param\_dict** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – The dictionary of `Parameters` to replace, and values or lists of values by which to replace them.
+
+**Returns**
+
+The `OperatorBase` with the `Parameters` in self replaced by the values or `Parameters` in param\_dict. If param\_dict contains parameterization lists, this `OperatorBase` is an `OpList`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### compose
+
+
+
+`compose(other, permutation=None, front=False)`
+
+Return Operator Composition between self and other (linear algebra-style: A\@B(x) = A(B(x))), overloaded by `@`.
+
+Note: You must be conscious of Quantum Circuit vs. Linear Algebra ordering conventions. Meaning, X.compose(Y) produces an X∘Y on qubit 0, but would produce a QuantumCircuit which looks like
+
+> -\[Y]-\[X]-
+
+Because Terra prints circuits with the initial state at the left side of the circuit.
+
+**Parameters**
+
+* **other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` with which to compose self.
+* **permutation** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – `List[int]` which defines permutation on other operator.
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If front==True, return `other.compose(self)`.
+
+**Returns**
+
+An `OperatorBase` equivalent to the function composition of self and other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### equals
+
+
+
+`equals(other)`
+
+Evaluate Equality between Operators, overloaded by `==`. Only returns True if self and other are of the same representation (e.g. a DictStateFn and CircuitStateFn will never be equal, even if their vector representations are equal), their underlying primitives are equal (this means for ListOps, OperatorStateFns, or EvolvedOps the equality is evaluated recursively downwards), and their coefficients are equal.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to compare to self.
+
+**Returns**
+
+A bool equal to the equality of self and other.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### eval
+
+
+
+`eval(front=None)`
+
+Evaluate the Operator’s underlying function, either on a binary string or another Operator. A square binary Operator can be defined as a function taking a binary function to another binary function. This method returns the value of that function for a given StateFn or binary string. For example, `op.eval('0110').eval('1110')` can be seen as querying the Operator’s matrix representation by row 6 and column 14, and will return the complex value at those “indices.” Similarly for a StateFn, `op.eval('1011')` will return the complex value at row 11 of the vector representation of the StateFn, as all StateFns are defined to be evaluated from Zero implicitly (i.e. it is as if `.eval('0000')` is already called implicitly to always “indexing” from column 0).
+
+If `front` is None, the matrix-representation of the operator is returned.
+
+**Parameters**
+
+**front** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*] |* [*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") *|*[*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.states.statevector.Statevector") *| None*) – The bitstring, dict of bitstrings (with values being coefficients), or StateFn to evaluated by the Operator’s underlying function, or None.
+
+**Returns**
+
+The output of the Operator’s evaluation function. If self is a `StateFn`, the result is a float or complex. If self is an Operator (`PrimitiveOp, ComposedOp, SummedOp, EvolvedOp,` etc.), the result is a StateFn. If `front` is None, the matrix-representation of the operator is returned, which is a `MatrixOp` for the operators and a `VectorStateFn` for state-functions. If either self or front contain proper `ListOps` (not ListOp subclasses), the result is an n-dimensional list of complex or StateFn results, resulting from the recursive evaluation by each OperatorBase in the ListOps.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") | [complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")
+
+### exp\_i
+
+
+
+`exp_i()`
+
+Return Operator exponentiation, equaling e^(-i \* op)
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### log\_i
+
+
+
+`log_i(massive=False)`
+
+Return a `MatrixOp` equivalent to log(H)/-i for this operator H. This function is the effective inverse of exp\_i, equivalent to finding the Hermitian Operator which produces self when exponentiated.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### mul
+
+
+
+`mul(scalar)`
+
+Returns the scalar multiplication of the Operator, overloaded by `*`, including support for Terra’s `Parameters`, which can be bound to values later (via `bind_parameters`).
+
+**Parameters**
+
+**scalar** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The real or complex scalar by which to multiply the Operator, or the `ParameterExpression` to serve as a placeholder for a scalar factor.
+
+**Returns**
+
+An `OperatorBase` equivalent to product of self and scalar.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### permute
+
+
+
+`permute(permutation)`
+
+Permutes the qubits of the operator.
+
+**Parameters**
+
+**permutation** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – A list defining where each qubit should be permuted. The qubit at index j should be permuted to position permutation\[j].
+
+**Returns**
+
+A new OperatorBase containing the permuted operator.
+
+**Raises**
+
+[**OpflowError**](opflow#qiskit.opflow.OpflowError "qiskit.opflow.OpflowError") – if indices do not define a new index for each qubit.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### primitive\_strings
+
+
+
+`primitive_strings()`
+
+Return a set of strings describing the primitives contained in the Operator. For example, `{'QuantumCircuit', 'Pauli'}`. For hierarchical Operators, such as `ListOps`, this can help illuminate the primitives represented in the various recursive levels, and therefore which conversions can be applied.
+
+**Returns**
+
+A set of strings describing the primitives contained within the Operator.
+
+**Return type**
+
+[*Set*](https://docs.python.org/3/library/typing.html#typing.Set "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")]
+
+### reduce
+
+
+
+`reduce()`
+
+Try collapsing the Operator structure, usually after some type of conversion, e.g. trying to add Operators in a SummedOp or delete needless IGates in a CircuitOp. If no reduction is available, just returns self.
+
+**Returns**
+
+The reduced `OperatorBase`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return tensor product between self and other, overloaded by `^`. Note: You must be conscious of Qiskit’s big-endian bit printing convention. Meaning, X.tensor(Y) produces an X on qubit 0 and an Y on qubit 1, or X⨂Y, but would produce a QuantumCircuit which looks like
+
+> -\[Y]- -\[X]-
+
+Because Terra prints circuits and results with qubit 0 at the end of the string or circuit.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to tensor product with self.
+
+**Returns**
+
+An `OperatorBase` equivalent to the tensor product of self and other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### tensorpower
+
+
+
+`tensorpower(other)`
+
+Return tensor product with self multiple times, overloaded by `^`.
+
+**Parameters**
+
+**other** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The int number of times to tensor product self with itself via `tensorpower`.
+
+**Returns**
+
+An `OperatorBase` equivalent to the tensorpower of self by other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") | [int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### to\_circuit
+
+
+
+`to_circuit()`
+
+Returns a `QuantumCircuit` equivalent to this Operator.
+
+**Return type**
+
+[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+### to\_circuit\_op
+
+
+
+`to_circuit_op()`
+
+Returns a `CircuitOp` equivalent to this Operator.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### to\_instruction
+
+
+
+`to_instruction()`
+
+Returns an `Instruction` equivalent to this Operator.
+
+**Return type**
+
+[*Instruction*](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")
+
+### to\_matrix
+
+
+
+`to_matrix(massive=False)`
+
+Return NumPy representation of the Operator. Represents the evaluation of the Operator’s underlying function on every combination of basis binary strings. Warn if more than 16 qubits to force having to set `massive=True` if such a large vector is desired.
+
+**Returns**
+
+The NumPy `ndarray` equivalent to this Operator.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+### to\_matrix\_op
+
+
+
+`to_matrix_op(massive=False)`
+
+Returns a `MatrixOp` equivalent to this Operator.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### to\_pauli\_op
+
+
+
+`to_pauli_op(massive=False)`
+
+Returns a sum of `PauliOp` s equivalent to this Operator.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.TaperedPauliSumOp.md b/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.TaperedPauliSumOp.md
new file mode 100644
index 00000000000..ab1b0c6ac54
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.TaperedPauliSumOp.md
@@ -0,0 +1,130 @@
+---
+title: TaperedPauliSumOp
+description: API reference for qiskit.opflow.primitive_ops.TaperedPauliSumOp
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.primitive_ops.TaperedPauliSumOp
+---
+
+# TaperedPauliSumOp
+
+
+
+`qiskit.opflow.primitive_ops.TaperedPauliSumOp(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/primitive_ops/tapered_pauli_sum_op.py "view source code")
+
+Bases: [`PauliSumOp`](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.pauli_sum_op.PauliSumOp")
+
+Deprecated: Class for PauliSumOp after tapering
+
+
+ The class `qiskit.opflow.primitive_ops.tapered_pauli_sum_op.TaperedPauliSumOp` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **primitive** – The SparsePauliOp which defines the behavior of the underlying function.
+* **z2\_symmetries** – Z2 symmetries which the Operator has.
+* **coeff** – A coefficient multiplying the primitive.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – invalid parameters.
+
+## Attributes
+
+
+
+### INDENTATION
+
+`= ' '`
+
+
+
+### coeff
+
+The scalar coefficient multiplying the Operator.
+
+**Returns**
+
+The coefficient.
+
+
+
+### coeffs
+
+Return the Pauli coefficients.
+
+
+
+### grouping\_type
+
+Type of Grouping
+
+**Type**
+
+Returns
+
+
+
+### instance\_id
+
+Return the unique instance id.
+
+
+
+### num\_qubits
+
+
+
+### parameters
+
+
+
+### primitive
+
+`SparsePauliOp`
+
+The primitive defining the underlying function of the Operator.
+
+**Returns**
+
+The primitive object.
+
+
+
+### settings
+
+Return operator settings.
+
+
+
+### z2\_symmetries
+
+Z2 symmetries which the Operator has.
+
+**Returns**
+
+The Z2 Symmetries.
+
+## Methods
+
+### assign\_parameters
+
+
+
+`assign_parameters(param_dict)`
+
+Binds scalar values to any Terra `Parameters` in the coefficients or primitives of the Operator, or substitutes one `Parameter` for another. This method differs from Terra’s `assign_parameters` in that it also supports lists of values to assign for a give `Parameter`, in which case self will be copied for each parameterization in the binding list(s), and all the copies will be returned in an `OpList`. If lists of parameterizations are used, every `Parameter` in the param\_dict must have the same length list of parameterizations.
+
+**Parameters**
+
+**param\_dict** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – The dictionary of `Parameters` to replace, and values or lists of values by which to replace them.
+
+**Returns**
+
+The `OperatorBase` with the `Parameters` in self replaced by the values or `Parameters` in param\_dict. If param\_dict contains parameterization lists, this `OperatorBase` is an `OpList`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.Z2Symmetries.md b/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.Z2Symmetries.md
new file mode 100644
index 00000000000..6584875379a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.Z2Symmetries.md
@@ -0,0 +1,220 @@
+---
+title: Z2Symmetries
+description: API reference for qiskit.opflow.primitive_ops.Z2Symmetries
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.primitive_ops.Z2Symmetries
+---
+
+# Z2Symmetries
+
+
+
+`qiskit.opflow.primitive_ops.Z2Symmetries(symmetries, sq_paulis, sq_list, tapering_values=None, tol=1e-14)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/primitive_ops/tapered_pauli_sum_op.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Deprecated: Z2 Symmetries
+
+
+ The class `qiskit.opflow.primitive_ops.tapered_pauli_sum_op.Z2Symmetries` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **symmetries** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Pauli*](qiskit.quantum_info.Pauli "qiskit.quantum_info.operators.symplectic.pauli.Pauli")*]*) – the list of Pauli objects representing the Z\_2 symmetries
+* **sq\_paulis** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Pauli*](qiskit.quantum_info.Pauli "qiskit.quantum_info.operators.symplectic.pauli.Pauli")*]*) – the list of single - qubit Pauli objects to construct the Clifford operators
+* **sq\_list** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – the list of support of the single-qubit Pauli objects used to build the Clifford operators
+* **tapering\_values** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – values determines the sector.
+* **tol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Tolerance threshold for ignoring real and complex parts of a coefficient.
+
+**Raises**
+
+[**OpflowError**](opflow#qiskit.opflow.OpflowError "qiskit.opflow.OpflowError") – Invalid paulis
+
+## Attributes
+
+
+
+### cliffords
+
+Get clifford operators, build based on symmetries and single-qubit X. :returns: a list of unitaries used to diagonalize the Hamiltonian.
+
+
+
+### settings
+
+Return operator settings.
+
+
+
+### sq\_list
+
+returns sq list
+
+
+
+### sq\_paulis
+
+returns sq paulis
+
+
+
+### symmetries
+
+return symmetries
+
+
+
+### tapering\_values
+
+returns tapering values
+
+
+
+### tol
+
+Tolerance threshold for ignoring real and complex parts of a coefficient.
+
+## Methods
+
+### consistent\_tapering
+
+
+
+`consistent_tapering(operator)`
+
+Tapering the operator with the same manner of how this tapered operator is created. i.e., using the same Cliffords and tapering values.
+
+**Parameters**
+
+**operator** ([*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.pauli_sum_op.PauliSumOp")) – the to-be-tapered operator
+
+**Returns**
+
+The tapered operator
+
+**Raises**
+
+[**OpflowError**](opflow#qiskit.opflow.OpflowError "qiskit.opflow.OpflowError") – The given operator does not commute with the symmetry
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### convert\_clifford
+
+
+
+`convert_clifford(operator)`
+
+This method operates the first part of the tapering. It converts the operator by composing it with the clifford unitaries defined in the current symmetry.
+
+**Parameters**
+
+**operator** ([*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.pauli_sum_op.PauliSumOp")) – to-be-tapered operator
+
+**Returns**
+
+[`PauliSumOp`](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp") corresponding to the converted operator.
+
+**Raises**
+
+[**OpflowError**](opflow#qiskit.opflow.OpflowError "qiskit.opflow.OpflowError") – Z2 symmetries, single qubit pauli and single qubit list cannot be empty
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### copy
+
+
+
+`copy()`
+
+Get a copy of self. :returns: copy
+
+**Return type**
+
+[*Z2Symmetries*](#qiskit.opflow.primitive_ops.Z2Symmetries "qiskit.opflow.primitive_ops.tapered_pauli_sum_op.Z2Symmetries")
+
+### find\_Z2\_symmetries
+
+
+
+`classmethod find_Z2_symmetries(operator)`
+
+Finds Z2 Pauli-type symmetries of an Operator.
+
+**Returns**
+
+a z2\_symmetries object contains symmetries, single-qubit X, single-qubit list.
+
+**Return type**
+
+[*Z2Symmetries*](#qiskit.opflow.primitive_ops.Z2Symmetries "qiskit.opflow.primitive_ops.tapered_pauli_sum_op.Z2Symmetries")
+
+### is\_empty
+
+
+
+`is_empty()`
+
+Check the z2\_symmetries is empty or not. :returns: Empty or not
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### taper
+
+
+
+`taper(operator)`
+
+Taper an operator based on the z2\_symmetries info and sector defined by tapering\_values. The tapering\_values will be stored into the resulted operator for a record.
+
+The tapering is a two-step algorithm which first converts the operator into a [`PauliSumOp`](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp") with same eigenvalues but where some qubits are only acted upon with the Pauli operators I or X. The number M of these redundant qubits is equal to the number M of identified symmetries.
+
+The second step of the reduction consists in replacing these qubits with the possible eigenvalues of the corresponding Pauli X, giving 2^M new operators with M less qubits. If an eigenvalue sector was previously identified for the solution, then this reduces to 1 new operator with M less qubits.
+
+**Parameters**
+
+**operator** ([*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.pauli_sum_op.PauliSumOp")) – the to-be-tapered operator
+
+**Returns**
+
+\[[`PauliSumOp`](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")]; otherwise, [`PauliSumOp`](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")
+
+**Return type**
+
+If tapering\_values is None
+
+**Raises**
+
+[**OpflowError**](opflow#qiskit.opflow.OpflowError "qiskit.opflow.OpflowError") – Z2 symmetries, single qubit pauli and single qubit list cannot be empty
+
+### taper\_clifford
+
+
+
+`taper_clifford(operator)`
+
+This method operates the second part of the tapering. This function assumes that the input operators have already been transformed using [`convert_clifford()`](#qiskit.opflow.primitive_ops.Z2Symmetries.convert_clifford "qiskit.opflow.primitive_ops.Z2Symmetries.convert_clifford"). The redundant qubits due to the symmetries are dropped and replaced by their two possible eigenvalues. The tapering\_values will be stored into the resulted operator for a record.
+
+**Parameters**
+
+**operator** ([*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.pauli_sum_op.PauliSumOp")) – Partially tapered operator resulting from a call to [`convert_clifford()`](#qiskit.opflow.primitive_ops.Z2Symmetries.convert_clifford "qiskit.opflow.primitive_ops.Z2Symmetries.convert_clifford")
+
+**Returns**
+
+\[[`PauliSumOp`](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")]; otherwise, [`PauliSumOp`](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")
+
+**Return type**
+
+If tapering\_values is None
+
+**Raises**
+
+[**OpflowError**](opflow#qiskit.opflow.OpflowError "qiskit.opflow.OpflowError") – Z2 symmetries, single qubit pauli and single qubit list cannot be empty
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.md b/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.md
new file mode 100644
index 00000000000..56d01731352
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.md
@@ -0,0 +1,51 @@
+---
+title: primitive_ops
+description: API reference for qiskit.opflow.primitive_ops
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.opflow.primitive_ops
+---
+
+
+
+
+
+# qiskit.opflow\.primitive\_ops
+
+
+
+## Primitive Operators
+
+
+
+`qiskit.opflow.primitive_ops`
+
+
+ The [`qiskit.opflow`](opflow#module-qiskit.opflow "qiskit.opflow") module is deprecated and will be removed no earlier than 3 months after the release date. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+Operators are defined to be functions which take State functions to State functions.
+
+PrimitiveOps are the classes for representing basic Operators, backed by computational Operator primitives from Terra. These classes (and inheritors) primarily serve to allow the underlying primitives to “flow” - i.e. interoperability and adherence to the Operator formalism - while the core computational logic mostly remains in the underlying primitives. For example, we would not produce an interface in Terra in which `QuantumCircuit1 + QuantumCircuit2` equaled the Operator sum of the circuit unitaries, rather than simply appending the circuits. However, within the Operator flow summing the unitaries is the expected behavior.
+
+
+ All mathematical methods are not in-place, meaning that they return a new object, but the underlying primitives are not copied.
+
+
+### Primitive Operators
+
+| | |
+| ---------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
+| [`PrimitiveOp`](qiskit.opflow.primitive_ops.PrimitiveOp "qiskit.opflow.primitive_ops.PrimitiveOp")(primitive\[, coeff]) | Deprecated: A class for representing basic Operators, backed by Operator primitives from Terra. |
+| [`CircuitOp`](qiskit.opflow.primitive_ops.CircuitOp "qiskit.opflow.primitive_ops.CircuitOp")(\*args, \*\*kwargs) | Deprecated: Class for Operators backed by Terra's `QuantumCircuit` module. |
+| [`MatrixOp`](qiskit.opflow.primitive_ops.MatrixOp "qiskit.opflow.primitive_ops.MatrixOp")(\*args, \*\*kwargs) | Deprecated: Class for Operators represented by matrices, backed by Terra's `Operator` module. |
+| [`PauliOp`](qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.PauliOp")(\*args, \*\*kwargs) | Deprecated: Class for Operators backed by Terra's `Pauli` module. |
+| [`PauliSumOp`](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")(\*args, \*\*kwargs) | Deprecated: Class for Operators backed by Terra's `SparsePauliOp` class. |
+| [`TaperedPauliSumOp`](qiskit.opflow.primitive_ops.TaperedPauliSumOp "qiskit.opflow.primitive_ops.TaperedPauliSumOp")(\*args, \*\*kwargs) | Deprecated: Class for PauliSumOp after tapering |
+
+### Symmetries
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
+| [`Z2Symmetries`](qiskit.opflow.primitive_ops.Z2Symmetries "qiskit.opflow.primitive_ops.Z2Symmetries")(symmetries, sq\_paulis, sq\_list) | Deprecated: Z2 Symmetries |
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.state_fns.CVaRMeasurement.md b/docs/api/qiskit/0.46/qiskit.opflow.state_fns.CVaRMeasurement.md
new file mode 100644
index 00000000000..cec5387bd2d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.state_fns.CVaRMeasurement.md
@@ -0,0 +1,352 @@
+---
+title: CVaRMeasurement
+description: API reference for qiskit.opflow.state_fns.CVaRMeasurement
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.state_fns.CVaRMeasurement
+---
+
+# CVaRMeasurement
+
+
+
+`qiskit.opflow.state_fns.CVaRMeasurement(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/state_fns/cvar_measurement.py "view source code")
+
+Bases: [`OperatorStateFn`](qiskit.opflow.state_fns.OperatorStateFn "qiskit.opflow.state_fns.operator_state_fn.OperatorStateFn")
+
+**Deprecated: A specialized measurement class to compute CVaR expectation values.**
+
+See [https://arxiv.org/pdf/1907.04769.pdf](https://arxiv.org/pdf/1907.04769.pdf) for further details.
+
+Used in `CVaRExpectation`, see there for more details.
+
+
+ The class `qiskit.opflow.state_fns.cvar_measurement.CVaRMeasurement` is deprecated as of qiskit 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **primitive** – The `OperatorBase` which defines the diagonal operator measurement.
+* **coeff** – A coefficient by which to multiply the state function
+* **alpha** – A real-valued parameter between 0 and 1 which specifies the fraction of observed samples to include when computing the objective value. alpha = 1 corresponds to a standard observable expectation value. alpha = 0 corresponds to only using the single sample with the lowest energy. alpha = 0.5 corresponds to ranking each observation by lowest energy and using the best
+
+**Raises**
+
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – TODO remove that this raises an error
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If alpha is not in \[0, 1].
+* [**OpflowError**](opflow#qiskit.opflow.OpflowError "qiskit.opflow.OpflowError") – If the primitive is not diagonal.
+
+## Attributes
+
+
+
+### INDENTATION
+
+`= ' '`
+
+
+
+### alpha
+
+**A real-valued parameter between 0 and 1 which specifies the**
+
+fraction of observed samples to include when computing the objective value. alpha = 1 corresponds to a standard observable expectation value. alpha = 0 corresponds to only using the single sample with the lowest energy. alpha = 0.5 corresponds to ranking each observation by lowest energy and using the best half.
+
+**Returns**
+
+The parameter alpha which was given at initialization
+
+
+
+### coeff
+
+A coefficient by which the state function is multiplied.
+
+
+
+### instance\_id
+
+Return the unique instance id.
+
+
+
+### is\_measurement
+
+Whether the StateFn object is a measurement Operator.
+
+
+
+### num\_qubits
+
+
+
+### parameters
+
+
+
+### primitive
+
+`OperatorBase`
+
+The primitive which defines the behavior of the underlying State function.
+
+
+
+### settings
+
+Return settings.
+
+## Methods
+
+### add
+
+
+
+`add(other)`
+
+Return Operator addition of self and other, overloaded by `+`.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – An `OperatorBase` with the same number of qubits as self, and in the same ‘Operator’, ‘State function’, or ‘Measurement’ category as self (i.e. the same type of underlying function).
+
+**Returns**
+
+An `OperatorBase` equivalent to the sum of self and other.
+
+**Return type**
+
+[*SummedOp*](qiskit.opflow.list_ops.SummedOp "qiskit.opflow.list_ops.summed_op.SummedOp")
+
+### adjoint
+
+
+
+`adjoint()`
+
+The adjoint of a CVaRMeasurement is not defined.
+
+**Returns**
+
+Does not return anything, raises an error.
+
+**Raises**
+
+[**OpflowError**](opflow#qiskit.opflow.OpflowError "qiskit.opflow.OpflowError") – The adjoint of a CVaRMeasurement is not defined.
+
+### compute\_cvar
+
+
+
+`compute_cvar(energies, probabilities)`
+
+Given the energies of each sampled measurement outcome (H\_i) as well as the sampling probability of each measurement outcome (p\_i, we can compute the CVaR. Note that the sampling probabilities serve as an alternative to knowing the counts of each observation and that the input energies are assumed to be sorted in increasing order.
+
+Consider the outcome with index j, such that only some of the samples with measurement outcome j will be used in computing CVaR. The CVaR calculation can then be separated into two parts. First we sum each of the energies for outcomes i \< j, weighted by the probability of observing that outcome (i.e the normalized counts). Second, we add the energy for outcome j, weighted by the difference (α - sum\_i\
+
+`eval(front=None)`
+
+Given the energies of each sampled measurement outcome (H\_i) as well as the sampling probability of each measurement outcome (p\_i, we can compute the CVaR as H\_j + 1/α\*(sum\_i\
+
+`eval_variance(front=None)`
+
+Given the energies of each sampled measurement outcome (H\_i) as well as the sampling probability of each measurement outcome (p\_i, we can compute the variance of the CVaR estimator as H\_j^2 + 1/α \* (sum\_i\], where H is the diagonal observable and bi corresponds to measurement outcome i. Given this, E\[X^2] = E\[\^2]
+
+**Parameters**
+
+**front** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *|*[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") *| None*) – A StateFn or primitive which specifies the results of evaluating a quantum state.
+
+**Returns**
+
+**The Var\[CVaR] of the diagonal observable specified by self.primitive**
+
+and the sampled quantum state described by the inputs (energies, probabilities). For index j (described above), the CVaR is computed as H\_j^2 + 1/α\*(sum\_i\
+
+`get_outcome_energies_probabilities(front=None)`
+
+In order to compute the CVaR of an observable expectation, we require the energies of each sampled measurement outcome as well as the sampling probability of each measurement outcome. Note that the counts for each measurement outcome will also suffice (and this is often how the CVaR is presented).
+
+**Parameters**
+
+**front** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *|*[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") *|*[*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.states.statevector.Statevector") *| None*) – A StateFn or a primitive which defines a StateFn. This input holds the results of a sampled/simulated circuit.
+
+**Returns**
+
+**Two lists of equal length. energies contains the energy of each**
+
+unique measurement outcome computed against the diagonal observable stored in self.primitive. probabilities contains the corresponding sampling probability for each measurement outcome in energies.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – front isn’t a DictStateFn or VectorStateFn
+
+**Return type**
+
+[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")\[[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)"), [list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")]
+
+### mul
+
+
+
+`mul(scalar)`
+
+Returns the scalar multiplication of the Operator, overloaded by `*`, including support for Terra’s `Parameters`, which can be bound to values later (via `bind_parameters`).
+
+**Parameters**
+
+**scalar** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The real or complex scalar by which to multiply the Operator, or the `ParameterExpression` to serve as a placeholder for a scalar factor.
+
+**Returns**
+
+An `OperatorBase` equivalent to product of self and scalar.
+
+**Return type**
+
+[*CVaRMeasurement*](#qiskit.opflow.state_fns.CVaRMeasurement "qiskit.opflow.state_fns.cvar_measurement.CVaRMeasurement")
+
+### sample
+
+
+
+`sample(shots=1024, massive=False, reverse_endianness=False)`
+
+Sample the state function as a normalized probability distribution. Returns dict of bitstrings in order of probability, with values being probability.
+
+**Parameters**
+
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of samples to take to approximate the State function.
+* **massive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to allow large conversions, e.g. creating a matrix representing over 16 qubits.
+* **reverse\_endianness** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to reverse the endianness of the bitstrings in the return dict to match Terra’s big-endianness.
+
+**Returns**
+
+A dict containing pairs sampled strings from the State function and sampling frequency divided by shots.
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return tensor product between self and other, overloaded by `^`. Note: You must be conscious of Qiskit’s big-endian bit printing convention. Meaning, Plus.tensor(Zero) produces a |+⟩ on qubit 0 and a |0⟩ on qubit 1, or |+⟩⨂|0⟩, but would produce a QuantumCircuit like
+
+> |0⟩– |+⟩–
+
+Because Terra prints circuits and results with qubit 0 at the end of the string or circuit.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to tensor product with self.
+
+**Returns**
+
+An `OperatorBase` equivalent to the tensor product of self and other.
+
+**Return type**
+
+[*OperatorStateFn*](qiskit.opflow.state_fns.OperatorStateFn "qiskit.opflow.state_fns.operator_state_fn.OperatorStateFn") | [*TensoredOp*](qiskit.opflow.list_ops.TensoredOp "qiskit.opflow.list_ops.tensored_op.TensoredOp")
+
+### to\_circuit\_op
+
+
+
+`to_circuit_op()`
+
+Not defined.
+
+### to\_density\_matrix
+
+
+
+`to_density_matrix(massive=False)`
+
+Not defined.
+
+### to\_matrix
+
+
+
+`to_matrix(massive=False)`
+
+Not defined.
+
+### to\_matrix\_op
+
+
+
+`to_matrix_op(massive=False)`
+
+Not defined.
+
+### traverse
+
+
+
+`traverse(convert_fn, coeff=None)`
+
+Apply the convert\_fn to the internal primitive if the primitive is an Operator (as in the case of `OperatorStateFn`). Otherwise do nothing. Used by converters.
+
+**Parameters**
+
+* **convert\_fn** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")) – The function to apply to the internal OperatorBase.
+* **coeff** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *| None*) – A coefficient to multiply by after applying convert\_fn. If it is None, self.coeff is used instead.
+
+**Returns**
+
+The converted StateFn.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.state_fns.CircuitStateFn.md b/docs/api/qiskit/0.46/qiskit.opflow.state_fns.CircuitStateFn.md
new file mode 100644
index 00000000000..79358a9611d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.state_fns.CircuitStateFn.md
@@ -0,0 +1,375 @@
+---
+title: CircuitStateFn
+description: API reference for qiskit.opflow.state_fns.CircuitStateFn
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.state_fns.CircuitStateFn
+---
+
+# CircuitStateFn
+
+
+
+`qiskit.opflow.state_fns.CircuitStateFn(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/state_fns/circuit_state_fn.py "view source code")
+
+Bases: [`StateFn`](qiskit.opflow.state_fns.StateFn "qiskit.opflow.state_fns.state_fn.StateFn")
+
+Deprecated: A class for state functions and measurements which are defined by the action of a QuantumCircuit starting from |0⟩, and stored using Terra’s `QuantumCircuit` class.
+
+
+ The class `qiskit.opflow.state_fns.circuit_state_fn.CircuitStateFn` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **primitive** – The `QuantumCircuit` (or `Instruction`, which will be converted) which defines the behavior of the underlying function.
+* **coeff** – A coefficient multiplying the state function.
+* **is\_measurement** – Whether the StateFn is a measurement operator.
+* **from\_operator** – if True the StateFn is derived from OperatorStateFn. (Default: False)
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Unsupported primitive, or primitive has ClassicalRegisters.
+
+## Attributes
+
+
+
+### INDENTATION
+
+`= ' '`
+
+
+
+### coeff
+
+A coefficient by which the state function is multiplied.
+
+
+
+### instance\_id
+
+Return the unique instance id.
+
+
+
+### is\_measurement
+
+Whether the StateFn object is a measurement Operator.
+
+
+
+### num\_qubits
+
+
+
+### parameters
+
+
+
+### primitive
+
+`QuantumCircuit`
+
+The primitive which defines the behavior of the underlying State function.
+
+
+
+### settings
+
+Return settings.
+
+## Methods
+
+### add
+
+
+
+`add(other)`
+
+Return Operator addition of self and other, overloaded by `+`.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – An `OperatorBase` with the same number of qubits as self, and in the same ‘Operator’, ‘State function’, or ‘Measurement’ category as self (i.e. the same type of underlying function).
+
+**Returns**
+
+An `OperatorBase` equivalent to the sum of self and other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return a new Operator equal to the Operator’s adjoint (conjugate transpose), overloaded by `~`. For StateFns, this also turns the StateFn into a measurement.
+
+**Returns**
+
+An `OperatorBase` equivalent to the adjoint of self.
+
+**Return type**
+
+[*CircuitStateFn*](#qiskit.opflow.state_fns.CircuitStateFn "qiskit.opflow.state_fns.circuit_state_fn.CircuitStateFn")
+
+### assign\_parameters
+
+
+
+`assign_parameters(param_dict)`
+
+Binds scalar values to any Terra `Parameters` in the coefficients or primitives of the Operator, or substitutes one `Parameter` for another. This method differs from Terra’s `assign_parameters` in that it also supports lists of values to assign for a give `Parameter`, in which case self will be copied for each parameterization in the binding list(s), and all the copies will be returned in an `OpList`. If lists of parameterizations are used, every `Parameter` in the param\_dict must have the same length list of parameterizations.
+
+**Parameters**
+
+**param\_dict** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – The dictionary of `Parameters` to replace, and values or lists of values by which to replace them.
+
+**Returns**
+
+The `OperatorBase` with the `Parameters` in self replaced by the values or `Parameters` in param\_dict. If param\_dict contains parameterization lists, this `OperatorBase` is an `OpList`.
+
+**Return type**
+
+[*CircuitStateFn*](#qiskit.opflow.state_fns.CircuitStateFn "qiskit.opflow.state_fns.circuit_state_fn.CircuitStateFn") | [*ListOp*](qiskit.opflow.list_ops.ListOp "qiskit.opflow.list_ops.list_op.ListOp")
+
+### compose
+
+
+
+`compose(other, permutation=None, front=False)`
+
+Composition (Linear algebra-style: A\@B(x) = A(B(x))) is not well defined for states in the binary function model, but is well defined for measurements.
+
+**Parameters**
+
+* **other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The Operator to compose with self.
+* **permutation** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – `List[int]` which defines permutation on other operator.
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If front==True, return `other.compose(self)`.
+
+**Returns**
+
+An Operator equivalent to the function composition of self and other.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If self is not a measurement, it cannot be composed from the right.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### eval
+
+
+
+`eval(front=None)`
+
+Evaluate the Operator’s underlying function, either on a binary string or another Operator. A square binary Operator can be defined as a function taking a binary function to another binary function. This method returns the value of that function for a given StateFn or binary string. For example, `op.eval('0110').eval('1110')` can be seen as querying the Operator’s matrix representation by row 6 and column 14, and will return the complex value at those “indices.” Similarly for a StateFn, `op.eval('1011')` will return the complex value at row 11 of the vector representation of the StateFn, as all StateFns are defined to be evaluated from Zero implicitly (i.e. it is as if `.eval('0000')` is already called implicitly to always “indexing” from column 0).
+
+If `front` is None, the matrix-representation of the operator is returned.
+
+**Parameters**
+
+**front** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*] |* [*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") *|*[*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.states.statevector.Statevector") *| None*) – The bitstring, dict of bitstrings (with values being coefficients), or StateFn to evaluated by the Operator’s underlying function, or None.
+
+**Returns**
+
+The output of the Operator’s evaluation function. If self is a `StateFn`, the result is a float or complex. If self is an Operator (`PrimitiveOp, ComposedOp, SummedOp, EvolvedOp,` etc.), the result is a StateFn. If `front` is None, the matrix-representation of the operator is returned, which is a `MatrixOp` for the operators and a `VectorStateFn` for state-functions. If either self or front contain proper `ListOps` (not ListOp subclasses), the result is an n-dimensional list of complex or StateFn results, resulting from the recursive evaluation by each OperatorBase in the ListOps.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") | [complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")
+
+### from\_dict
+
+
+
+`static from_dict(density_dict)`
+
+Construct the CircuitStateFn from a dict mapping strings to probability densities.
+
+**Parameters**
+
+**density\_dict** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – The dict representing the desired state.
+
+**Returns**
+
+The CircuitStateFn created from the dict.
+
+**Return type**
+
+[*CircuitStateFn*](#qiskit.opflow.state_fns.CircuitStateFn "qiskit.opflow.state_fns.circuit_state_fn.CircuitStateFn")
+
+### from\_vector
+
+
+
+`static from_vector(statevector)`
+
+Construct the CircuitStateFn from a vector representing the statevector.
+
+**Parameters**
+
+**statevector** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – The statevector representing the desired state.
+
+**Returns**
+
+The CircuitStateFn created from the vector.
+
+**Return type**
+
+[*CircuitStateFn*](#qiskit.opflow.state_fns.CircuitStateFn "qiskit.opflow.state_fns.circuit_state_fn.CircuitStateFn")
+
+### permute
+
+
+
+`permute(permutation)`
+
+Permute the qubits of the circuit.
+
+**Parameters**
+
+**permutation** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – A list defining where each qubit should be permuted. The qubit at index j of the circuit should be permuted to position permutation\[j].
+
+**Returns**
+
+A new CircuitStateFn containing the permuted circuit.
+
+**Return type**
+
+[*CircuitStateFn*](#qiskit.opflow.state_fns.CircuitStateFn "qiskit.opflow.state_fns.circuit_state_fn.CircuitStateFn")
+
+### primitive\_strings
+
+
+
+`primitive_strings()`
+
+Return a set of strings describing the primitives contained in the Operator. For example, `{'QuantumCircuit', 'Pauli'}`. For hierarchical Operators, such as `ListOps`, this can help illuminate the primitives represented in the various recursive levels, and therefore which conversions can be applied.
+
+**Returns**
+
+A set of strings describing the primitives contained within the Operator.
+
+**Return type**
+
+[*Set*](https://docs.python.org/3/library/typing.html#typing.Set "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")]
+
+### reduce
+
+
+
+`reduce()`
+
+Try collapsing the Operator structure, usually after some type of conversion, e.g. trying to add Operators in a SummedOp or delete needless IGates in a CircuitOp. If no reduction is available, just returns self.
+
+**Returns**
+
+The reduced `OperatorBase`.
+
+**Return type**
+
+[*CircuitStateFn*](#qiskit.opflow.state_fns.CircuitStateFn "qiskit.opflow.state_fns.circuit_state_fn.CircuitStateFn")
+
+### sample
+
+
+
+`sample(shots=1024, massive=False, reverse_endianness=False)`
+
+Sample the state function as a normalized probability distribution. Returns dict of bitstrings in order of probability, with values being probability.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return tensor product between self and other, overloaded by `^`. Note: You must be conscious of Qiskit’s big-endian bit printing convention. Meaning, Plus.tensor(Zero) produces a |+⟩ on qubit 0 and a |0⟩ on qubit 1, or |+⟩⨂|0⟩, but would produce a QuantumCircuit like:
+
+> |0⟩– |+⟩–
+
+Because Terra prints circuits and results with qubit 0 at the end of the string or circuit.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to tensor product with self.
+
+**Returns**
+
+An `OperatorBase` equivalent to the tensor product of self and other.
+
+**Return type**
+
+[*CircuitStateFn*](#qiskit.opflow.state_fns.CircuitStateFn "qiskit.opflow.state_fns.circuit_state_fn.CircuitStateFn") | [*TensoredOp*](qiskit.opflow.list_ops.TensoredOp "qiskit.opflow.list_ops.tensored_op.TensoredOp")
+
+### to\_circuit
+
+
+
+`to_circuit(meas=False)`
+
+Return QuantumCircuit representing StateFn
+
+**Return type**
+
+[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")
+
+### to\_circuit\_op
+
+
+
+`to_circuit_op()`
+
+Return `StateFnCircuit` corresponding to this StateFn.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### to\_density\_matrix
+
+
+
+`to_density_matrix(massive=False)`
+
+Return numpy matrix of density operator, warn if more than 16 qubits to force the user to set massive=True if they want such a large matrix. Generally big methods like this should require the use of a converter, but in this case a convenience method for quick hacking and access to classical tools is appropriate.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+### to\_instruction
+
+
+
+`to_instruction()`
+
+Return Instruction corresponding to primitive.
+
+### to\_matrix
+
+
+
+`to_matrix(massive=False)`
+
+Return NumPy representation of the Operator. Represents the evaluation of the Operator’s underlying function on every combination of basis binary strings. Warn if more than 16 qubits to force having to set `massive=True` if such a large vector is desired.
+
+**Returns**
+
+The NumPy `ndarray` equivalent to this Operator.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.state_fns.DictStateFn.md b/docs/api/qiskit/0.46/qiskit.opflow.state_fns.DictStateFn.md
new file mode 100644
index 00000000000..b147143c283
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.state_fns.DictStateFn.md
@@ -0,0 +1,307 @@
+---
+title: DictStateFn
+description: API reference for qiskit.opflow.state_fns.DictStateFn
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.state_fns.DictStateFn
+---
+
+# DictStateFn
+
+
+
+`qiskit.opflow.state_fns.DictStateFn(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/state_fns/dict_state_fn.py "view source code")
+
+Bases: [`StateFn`](qiskit.opflow.state_fns.StateFn "qiskit.opflow.state_fns.state_fn.StateFn")
+
+Deprecated: A class for state functions and measurements which are defined by a lookup table, stored in a dict.
+
+
+ The class `qiskit.opflow.state_fns.dict_state_fn.DictStateFn` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **primitive** – The dict, single bitstring (if defining a basis sate), or Qiskit Result, which defines the behavior of the underlying function.
+* **coeff** – A coefficient by which to multiply the state function.
+* **is\_measurement** – Whether the StateFn is a measurement operator.
+* **from\_operator** – if True the StateFn is derived from OperatorStateFn. (Default: False)
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – invalid parameters.
+
+## Attributes
+
+
+
+### INDENTATION
+
+`= ' '`
+
+
+
+### coeff
+
+A coefficient by which the state function is multiplied.
+
+
+
+### instance\_id
+
+Return the unique instance id.
+
+
+
+### is\_measurement
+
+Whether the StateFn object is a measurement Operator.
+
+
+
+### num\_qubits
+
+
+
+### parameters
+
+
+
+### primitive
+
+`Dict[str, complex]`
+
+The primitive which defines the behavior of the underlying State function.
+
+
+
+### settings
+
+Return settings.
+
+## Methods
+
+### add
+
+
+
+`add(other)`
+
+Return Operator addition of self and other, overloaded by `+`.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – An `OperatorBase` with the same number of qubits as self, and in the same ‘Operator’, ‘State function’, or ‘Measurement’ category as self (i.e. the same type of underlying function).
+
+**Returns**
+
+An `OperatorBase` equivalent to the sum of self and other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return a new Operator equal to the Operator’s adjoint (conjugate transpose), overloaded by `~`. For StateFns, this also turns the StateFn into a measurement.
+
+**Returns**
+
+An `OperatorBase` equivalent to the adjoint of self.
+
+**Return type**
+
+[*DictStateFn*](#qiskit.opflow.state_fns.DictStateFn "qiskit.opflow.state_fns.dict_state_fn.DictStateFn")
+
+### eval
+
+
+
+`eval(front=None)`
+
+Evaluate the Operator’s underlying function, either on a binary string or another Operator. A square binary Operator can be defined as a function taking a binary function to another binary function. This method returns the value of that function for a given StateFn or binary string. For example, `op.eval('0110').eval('1110')` can be seen as querying the Operator’s matrix representation by row 6 and column 14, and will return the complex value at those “indices.” Similarly for a StateFn, `op.eval('1011')` will return the complex value at row 11 of the vector representation of the StateFn, as all StateFns are defined to be evaluated from Zero implicitly (i.e. it is as if `.eval('0000')` is already called implicitly to always “indexing” from column 0).
+
+If `front` is None, the matrix-representation of the operator is returned.
+
+**Parameters**
+
+**front** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*] |* [*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") *|*[*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.states.statevector.Statevector") *| None*) – The bitstring, dict of bitstrings (with values being coefficients), or StateFn to evaluated by the Operator’s underlying function, or None.
+
+**Returns**
+
+The output of the Operator’s evaluation function. If self is a `StateFn`, the result is a float or complex. If self is an Operator (`PrimitiveOp, ComposedOp, SummedOp, EvolvedOp,` etc.), the result is a StateFn. If `front` is None, the matrix-representation of the operator is returned, which is a `MatrixOp` for the operators and a `VectorStateFn` for state-functions. If either self or front contain proper `ListOps` (not ListOp subclasses), the result is an n-dimensional list of complex or StateFn results, resulting from the recursive evaluation by each OperatorBase in the ListOps.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") | [complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")
+
+### permute
+
+
+
+`permute(permutation)`
+
+Permute the qubits of the state function.
+
+**Parameters**
+
+**permutation** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – A list defining where each qubit should be permuted. The qubit at index j of the circuit should be permuted to position permutation\[j].
+
+**Returns**
+
+A new StateFn containing the permuted primitive.
+
+**Return type**
+
+[*DictStateFn*](#qiskit.opflow.state_fns.DictStateFn "qiskit.opflow.state_fns.dict_state_fn.DictStateFn")
+
+### primitive\_strings
+
+
+
+`primitive_strings()`
+
+Return a set of strings describing the primitives contained in the Operator. For example, `{'QuantumCircuit', 'Pauli'}`. For hierarchical Operators, such as `ListOps`, this can help illuminate the primitives represented in the various recursive levels, and therefore which conversions can be applied.
+
+**Returns**
+
+A set of strings describing the primitives contained within the Operator.
+
+**Return type**
+
+[*Set*](https://docs.python.org/3/library/typing.html#typing.Set "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")]
+
+### sample
+
+
+
+`sample(shots=1024, massive=False, reverse_endianness=False)`
+
+Sample the state function as a normalized probability distribution. Returns dict of bitstrings in order of probability, with values being probability.
+
+**Parameters**
+
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of samples to take to approximate the State function.
+* **massive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to allow large conversions, e.g. creating a matrix representing over 16 qubits.
+* **reverse\_endianness** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to reverse the endianness of the bitstrings in the return dict to match Terra’s big-endianness.
+
+**Returns**
+
+A dict containing pairs sampled strings from the State function and sampling frequency divided by shots.
+
+**Return type**
+
+[*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)"), [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")]
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return tensor product between self and other, overloaded by `^`. Note: You must be conscious of Qiskit’s big-endian bit printing convention. Meaning, Plus.tensor(Zero) produces a |+⟩ on qubit 0 and a |0⟩ on qubit 1, or |+⟩⨂|0⟩, but would produce a QuantumCircuit like
+
+> |0⟩– |+⟩–
+
+Because Terra prints circuits and results with qubit 0 at the end of the string or circuit.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to tensor product with self.
+
+**Returns**
+
+An `OperatorBase` equivalent to the tensor product of self and other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### to\_circuit\_op
+
+
+
+`to_circuit_op()`
+
+Convert this state function to a `CircuitStateFn`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### to\_density\_matrix
+
+
+
+`to_density_matrix(massive=False)`
+
+Return matrix representing product of StateFn evaluated on pairs of basis states. Overridden by child classes.
+
+**Parameters**
+
+**massive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to allow large conversions, e.g. creating a matrix representing over 16 qubits.
+
+**Returns**
+
+The NumPy array representing the density matrix of the State function.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If massive is set to False, and exponentially large computation is needed.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+### to\_matrix
+
+
+
+`to_matrix(massive=False)`
+
+Return NumPy representation of the Operator. Represents the evaluation of the Operator’s underlying function on every combination of basis binary strings. Warn if more than 16 qubits to force having to set `massive=True` if such a large vector is desired.
+
+**Returns**
+
+The NumPy `ndarray` equivalent to this Operator.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+### to\_spmatrix
+
+
+
+`to_spmatrix()`
+
+Same as to\_matrix, but returns csr sparse matrix.
+
+**Returns**
+
+CSR sparse matrix representation of the State function.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – invalid parameters.
+
+**Return type**
+
+*spmatrix*
+
+### to\_spmatrix\_op
+
+
+
+`to_spmatrix_op()`
+
+Convert this state function to a `SparseVectorStateFn`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.state_fns.OperatorStateFn.md b/docs/api/qiskit/0.46/qiskit.opflow.state_fns.OperatorStateFn.md
new file mode 100644
index 00000000000..081f30b6006
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.state_fns.OperatorStateFn.md
@@ -0,0 +1,272 @@
+---
+title: OperatorStateFn
+description: API reference for qiskit.opflow.state_fns.OperatorStateFn
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.state_fns.OperatorStateFn
+---
+
+# OperatorStateFn
+
+
+
+`qiskit.opflow.state_fns.OperatorStateFn(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/state_fns/operator_state_fn.py "view source code")
+
+Bases: [`StateFn`](qiskit.opflow.state_fns.StateFn "qiskit.opflow.state_fns.state_fn.StateFn")
+
+Deprecated: A class for state functions and measurements which are defined by a density Operator, stored using an `OperatorBase`.
+
+
+ The class `qiskit.opflow.state_fns.operator_state_fn.OperatorStateFn` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **primitive** – The `OperatorBase` which defines the behavior of the underlying State function.
+* **coeff** – A coefficient by which to multiply the state function
+* **is\_measurement** – Whether the StateFn is a measurement operator
+
+## Attributes
+
+
+
+### INDENTATION
+
+`= ' '`
+
+
+
+### coeff
+
+A coefficient by which the state function is multiplied.
+
+
+
+### instance\_id
+
+Return the unique instance id.
+
+
+
+### is\_measurement
+
+Whether the StateFn object is a measurement Operator.
+
+
+
+### num\_qubits
+
+
+
+### parameters
+
+
+
+### primitive
+
+`OperatorBase`
+
+The primitive which defines the behavior of the underlying State function.
+
+
+
+### settings
+
+Return settings.
+
+## Methods
+
+### add
+
+
+
+`add(other)`
+
+Return Operator addition of self and other, overloaded by `+`.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – An `OperatorBase` with the same number of qubits as self, and in the same ‘Operator’, ‘State function’, or ‘Measurement’ category as self (i.e. the same type of underlying function).
+
+**Returns**
+
+An `OperatorBase` equivalent to the sum of self and other.
+
+**Return type**
+
+[*OperatorStateFn*](#qiskit.opflow.state_fns.OperatorStateFn "qiskit.opflow.state_fns.operator_state_fn.OperatorStateFn") | [*SummedOp*](qiskit.opflow.list_ops.SummedOp "qiskit.opflow.list_ops.summed_op.SummedOp")
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return a new Operator equal to the Operator’s adjoint (conjugate transpose), overloaded by `~`. For StateFns, this also turns the StateFn into a measurement.
+
+**Returns**
+
+An `OperatorBase` equivalent to the adjoint of self.
+
+**Return type**
+
+[*OperatorStateFn*](#qiskit.opflow.state_fns.OperatorStateFn "qiskit.opflow.state_fns.operator_state_fn.OperatorStateFn")
+
+### eval
+
+
+
+`eval(front=None)`
+
+Evaluate the Operator’s underlying function, either on a binary string or another Operator. A square binary Operator can be defined as a function taking a binary function to another binary function. This method returns the value of that function for a given StateFn or binary string. For example, `op.eval('0110').eval('1110')` can be seen as querying the Operator’s matrix representation by row 6 and column 14, and will return the complex value at those “indices.” Similarly for a StateFn, `op.eval('1011')` will return the complex value at row 11 of the vector representation of the StateFn, as all StateFns are defined to be evaluated from Zero implicitly (i.e. it is as if `.eval('0000')` is already called implicitly to always “indexing” from column 0).
+
+If `front` is None, the matrix-representation of the operator is returned.
+
+**Parameters**
+
+**front** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *|*[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") *|*[*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.states.statevector.Statevector") *| None*) – The bitstring, dict of bitstrings (with values being coefficients), or StateFn to evaluated by the Operator’s underlying function, or None.
+
+**Returns**
+
+The output of the Operator’s evaluation function. If self is a `StateFn`, the result is a float or complex. If self is an Operator (`PrimitiveOp, ComposedOp, SummedOp, EvolvedOp,` etc.), the result is a StateFn. If `front` is None, the matrix-representation of the operator is returned, which is a `MatrixOp` for the operators and a `VectorStateFn` for state-functions. If either self or front contain proper `ListOps` (not ListOp subclasses), the result is an n-dimensional list of complex or StateFn results, resulting from the recursive evaluation by each OperatorBase in the ListOps.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") | [complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")
+
+### permute
+
+
+
+`permute(permutation)`
+
+Permute the qubits of the state function.
+
+**Parameters**
+
+**permutation** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – A list defining where each qubit should be permuted. The qubit at index j of the circuit should be permuted to position permutation\[j].
+
+**Returns**
+
+A new StateFn containing the permuted primitive.
+
+**Return type**
+
+[*OperatorStateFn*](#qiskit.opflow.state_fns.OperatorStateFn "qiskit.opflow.state_fns.operator_state_fn.OperatorStateFn")
+
+### primitive\_strings
+
+
+
+`primitive_strings()`
+
+Return a set of strings describing the primitives contained in the Operator. For example, `{'QuantumCircuit', 'Pauli'}`. For hierarchical Operators, such as `ListOps`, this can help illuminate the primitives represented in the various recursive levels, and therefore which conversions can be applied.
+
+**Returns**
+
+A set of strings describing the primitives contained within the Operator.
+
+**Return type**
+
+[*Set*](https://docs.python.org/3/library/typing.html#typing.Set "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")]
+
+### sample
+
+
+
+`sample(shots=1024, massive=False, reverse_endianness=False)`
+
+Sample the state function as a normalized probability distribution. Returns dict of bitstrings in order of probability, with values being probability.
+
+**Parameters**
+
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of samples to take to approximate the State function.
+* **massive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to allow large conversions, e.g. creating a matrix representing over 16 qubits.
+* **reverse\_endianness** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to reverse the endianness of the bitstrings in the return dict to match Terra’s big-endianness.
+
+**Returns**
+
+A dict containing pairs sampled strings from the State function and sampling frequency divided by shots.
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return tensor product between self and other, overloaded by `^`. Note: You must be conscious of Qiskit’s big-endian bit printing convention. Meaning, Plus.tensor(Zero) produces a |+⟩ on qubit 0 and a |0⟩ on qubit 1, or |+⟩⨂|0⟩, but would produce a QuantumCircuit like
+
+> |0⟩– |+⟩–
+
+Because Terra prints circuits and results with qubit 0 at the end of the string or circuit.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to tensor product with self.
+
+**Returns**
+
+An `OperatorBase` equivalent to the tensor product of self and other.
+
+**Return type**
+
+[*OperatorStateFn*](#qiskit.opflow.state_fns.OperatorStateFn "qiskit.opflow.state_fns.operator_state_fn.OperatorStateFn") | [*TensoredOp*](qiskit.opflow.list_ops.TensoredOp "qiskit.opflow.list_ops.tensored_op.TensoredOp")
+
+### to\_circuit\_op
+
+
+
+`to_circuit_op()`
+
+Return `StateFnCircuit` corresponding to this StateFn. Ignore for now because this is undefined. TODO maybe call to\_pauli\_op and diagonalize here, but that could be very inefficient, e.g. splitting one Stabilizer measurement into hundreds of 1 qubit Paulis.
+
+### to\_density\_matrix
+
+
+
+`to_density_matrix(massive=False)`
+
+Return numpy matrix of density operator, warn if more than 16 qubits to force the user to set massive=True if they want such a large matrix. Generally big methods like this should require the use of a converter, but in this case a convenience method for quick hacking and access to classical tools is appropriate.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+### to\_matrix
+
+
+
+`to_matrix(massive=False)`
+
+Note: this does not return a density matrix, it returns a classical matrix containing the quantum or classical vector representing the evaluation of the state function on each binary basis state. Do not assume this is is a normalized quantum or classical probability vector. If we allowed this to return a density matrix, then we would need to change the definition of composition to be \~Op @ StateFn @ Op for those cases, whereas by this methodology we can ensure that composition always means Op @ StateFn.
+
+Return numpy vector of state vector, warn if more than 16 qubits to force the user to set massive=True if they want such a large vector.
+
+**Parameters**
+
+**massive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to allow large conversions, e.g. creating a matrix representing over 16 qubits.
+
+**Returns**
+
+Vector of state vector
+
+**Return type**
+
+np.ndarray
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – Invalid parameters.
+
+### to\_matrix\_op
+
+
+
+`to_matrix_op(massive=False)`
+
+Return a MatrixOp for this operator.
+
+**Return type**
+
+[*OperatorStateFn*](#qiskit.opflow.state_fns.OperatorStateFn "qiskit.opflow.state_fns.operator_state_fn.OperatorStateFn")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.state_fns.SparseVectorStateFn.md b/docs/api/qiskit/0.46/qiskit.opflow.state_fns.SparseVectorStateFn.md
new file mode 100644
index 00000000000..66570accf44
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.state_fns.SparseVectorStateFn.md
@@ -0,0 +1,281 @@
+---
+title: SparseVectorStateFn
+description: API reference for qiskit.opflow.state_fns.SparseVectorStateFn
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.state_fns.SparseVectorStateFn
+---
+
+# SparseVectorStateFn
+
+
+
+`qiskit.opflow.state_fns.SparseVectorStateFn(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/state_fns/sparse_vector_state_fn.py "view source code")
+
+Bases: [`StateFn`](qiskit.opflow.state_fns.StateFn "qiskit.opflow.state_fns.state_fn.StateFn")
+
+Deprecated: A class for sparse state functions and measurements in vector representation.
+
+This class uses `scipy.sparse.spmatrix` for the internal representation.
+
+
+ The class `qiskit.opflow.state_fns.sparse_vector_state_fn.SparseVectorStateFn` is deprecated as of qiskit 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **primitive** – The underlying sparse vector.
+* **coeff** – A coefficient multiplying the state function.
+* **is\_measurement** – Whether the StateFn is a measurement operator
+
+**Raises**
+
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If the primitive is not a column vector.
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If the number of elements in the primitive is not a power of 2.
+
+## Attributes
+
+
+
+### INDENTATION
+
+`= ' '`
+
+
+
+### coeff
+
+A coefficient by which the state function is multiplied.
+
+
+
+### instance\_id
+
+Return the unique instance id.
+
+
+
+### is\_measurement
+
+Whether the StateFn object is a measurement Operator.
+
+
+
+### num\_qubits
+
+
+
+### parameters
+
+
+
+### primitive
+
+`spmatrix`
+
+The primitive which defines the behavior of the underlying State function.
+
+
+
+### settings
+
+Return settings.
+
+## Methods
+
+### add
+
+
+
+`add(other)`
+
+Return Operator addition of self and other, overloaded by `+`.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – An `OperatorBase` with the same number of qubits as self, and in the same ‘Operator’, ‘State function’, or ‘Measurement’ category as self (i.e. the same type of underlying function).
+
+**Returns**
+
+An `OperatorBase` equivalent to the sum of self and other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return a new Operator equal to the Operator’s adjoint (conjugate transpose), overloaded by `~`. For StateFns, this also turns the StateFn into a measurement.
+
+**Returns**
+
+An `OperatorBase` equivalent to the adjoint of self.
+
+**Return type**
+
+[*SparseVectorStateFn*](#qiskit.opflow.state_fns.SparseVectorStateFn "qiskit.opflow.state_fns.sparse_vector_state_fn.SparseVectorStateFn")
+
+### equals
+
+
+
+`equals(other)`
+
+Evaluate Equality between Operators, overloaded by `==`. Only returns True if self and other are of the same representation (e.g. a DictStateFn and CircuitStateFn will never be equal, even if their vector representations are equal), their underlying primitives are equal (this means for ListOps, OperatorStateFns, or EvolvedOps the equality is evaluated recursively downwards), and their coefficients are equal.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to compare to self.
+
+**Returns**
+
+A bool equal to the equality of self and other.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### eval
+
+
+
+`eval(front=None)`
+
+Evaluate the Operator’s underlying function, either on a binary string or another Operator. A square binary Operator can be defined as a function taking a binary function to another binary function. This method returns the value of that function for a given StateFn or binary string. For example, `op.eval('0110').eval('1110')` can be seen as querying the Operator’s matrix representation by row 6 and column 14, and will return the complex value at those “indices.” Similarly for a StateFn, `op.eval('1011')` will return the complex value at row 11 of the vector representation of the StateFn, as all StateFns are defined to be evaluated from Zero implicitly (i.e. it is as if `.eval('0000')` is already called implicitly to always “indexing” from column 0).
+
+If `front` is None, the matrix-representation of the operator is returned.
+
+**Parameters**
+
+**front** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*] |* [*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") *|*[*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.states.statevector.Statevector") *| None*) – The bitstring, dict of bitstrings (with values being coefficients), or StateFn to evaluated by the Operator’s underlying function, or None.
+
+**Returns**
+
+The output of the Operator’s evaluation function. If self is a `StateFn`, the result is a float or complex. If self is an Operator (`PrimitiveOp, ComposedOp, SummedOp, EvolvedOp,` etc.), the result is a StateFn. If `front` is None, the matrix-representation of the operator is returned, which is a `MatrixOp` for the operators and a `VectorStateFn` for state-functions. If either self or front contain proper `ListOps` (not ListOp subclasses), the result is an n-dimensional list of complex or StateFn results, resulting from the recursive evaluation by each OperatorBase in the ListOps.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") | [complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")
+
+### primitive\_strings
+
+
+
+`primitive_strings()`
+
+Return a set of strings describing the primitives contained in the Operator. For example, `{'QuantumCircuit', 'Pauli'}`. For hierarchical Operators, such as `ListOps`, this can help illuminate the primitives represented in the various recursive levels, and therefore which conversions can be applied.
+
+**Returns**
+
+A set of strings describing the primitives contained within the Operator.
+
+**Return type**
+
+[*Set*](https://docs.python.org/3/library/typing.html#typing.Set "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")]
+
+### sample
+
+
+
+`sample(shots=1024, massive=False, reverse_endianness=False)`
+
+Sample the state function as a normalized probability distribution. Returns dict of bitstrings in order of probability, with values being probability.
+
+**Parameters**
+
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of samples to take to approximate the State function.
+* **massive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to allow large conversions, e.g. creating a matrix representing over 16 qubits.
+* **reverse\_endianness** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to reverse the endianness of the bitstrings in the return dict to match Terra’s big-endianness.
+
+**Returns**
+
+A dict containing pairs sampled strings from the State function and sampling frequency divided by shots.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+### to\_circuit\_op
+
+
+
+`to_circuit_op()`
+
+Convert this state function to a `CircuitStateFn`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### to\_dict\_fn
+
+
+
+`to_dict_fn()`
+
+Convert this state function to a `DictStateFn`.
+
+**Returns**
+
+A new DictStateFn equivalent to `self`.
+
+**Return type**
+
+[*StateFn*](qiskit.opflow.state_fns.StateFn "qiskit.opflow.state_fns.state_fn.StateFn")
+
+### to\_matrix
+
+
+
+`to_matrix(massive=False)`
+
+Return NumPy representation of the Operator. Represents the evaluation of the Operator’s underlying function on every combination of basis binary strings. Warn if more than 16 qubits to force having to set `massive=True` if such a large vector is desired.
+
+**Returns**
+
+The NumPy `ndarray` equivalent to this Operator.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+### to\_matrix\_op
+
+
+
+`to_matrix_op(massive=False)`
+
+Return a `VectorStateFn` for this `StateFn`.
+
+**Parameters**
+
+**massive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to allow large conversions, e.g. creating a matrix representing over 16 qubits.
+
+**Returns**
+
+A VectorStateFn equivalent to self.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### to\_spmatrix
+
+
+
+`to_spmatrix()`
+
+Return SciPy sparse matrix representation of the Operator. Represents the evaluation of the Operator’s underlying function on every combination of basis binary strings.
+
+**Returns**
+
+The SciPy `spmatrix` equivalent to this Operator.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.state_fns.StateFn.md b/docs/api/qiskit/0.46/qiskit.opflow.state_fns.StateFn.md
new file mode 100644
index 00000000000..f16bc314acd
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.state_fns.StateFn.md
@@ -0,0 +1,461 @@
+---
+title: StateFn
+description: API reference for qiskit.opflow.state_fns.StateFn
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.state_fns.StateFn
+---
+
+# StateFn
+
+
+
+`qiskit.opflow.state_fns.StateFn(primitive=None, coeff=1.0, is_measurement=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/state_fns/state_fn.py "view source code")
+
+Bases: [`OperatorBase`](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+Deprecated: A class for representing state functions and measurements.
+
+State functions are defined to be complex functions over a single binary string (as compared to an operator, which is defined as a function over two binary strings, or a function taking a binary function to another binary function). This function may be called by the eval() method.
+
+Measurements are defined to be functionals over StateFns, taking them to real values. Generally, this real value is interpreted to represent the probability of some classical state (binary string) being observed from a probabilistic or quantum system represented by a StateFn. This leads to the equivalent definition, which is that a measurement m is a function over binary strings producing StateFns, such that the probability of measuring a given binary string b from a system with StateFn f is equal to the inner product between f and m(b).
+
+NOTE: State functions here are not restricted to wave functions, as there is no requirement of normalization.
+
+
+ The class `qiskit.opflow.state_fns.state_fn.StateFn` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **primitive** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *|*[*Result*](qiskit.result.Result "qiskit.result.result.Result") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *|*[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.states.statevector.Statevector") *|*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit") *|*[*Instruction*](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction") *|*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The primitive which defines the behavior of the underlying State function.
+* **coeff** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – A coefficient by which the state function is multiplied.
+* **is\_measurement** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether the StateFn is a measurement operator
+
+**Return type**
+
+[StateFn](#qiskit.opflow.state_fns.StateFn "qiskit.opflow.state_fns.StateFn")
+
+## Attributes
+
+
+
+### INDENTATION
+
+`= ' '`
+
+
+
+### coeff
+
+A coefficient by which the state function is multiplied.
+
+
+
+### instance\_id
+
+Return the unique instance id.
+
+
+
+### is\_measurement
+
+Whether the StateFn object is a measurement Operator.
+
+
+
+### num\_qubits
+
+
+
+### parameters
+
+
+
+### primitive
+
+The primitive which defines the behavior of the underlying State function.
+
+
+
+### settings
+
+Return settings.
+
+## Methods
+
+### add
+
+
+
+`add(other)`
+
+Return Operator addition of self and other, overloaded by `+`.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – An `OperatorBase` with the same number of qubits as self, and in the same ‘Operator’, ‘State function’, or ‘Measurement’ category as self (i.e. the same type of underlying function).
+
+**Returns**
+
+An `OperatorBase` equivalent to the sum of self and other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return a new Operator equal to the Operator’s adjoint (conjugate transpose), overloaded by `~`. For StateFns, this also turns the StateFn into a measurement.
+
+**Returns**
+
+An `OperatorBase` equivalent to the adjoint of self.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### assign\_parameters
+
+
+
+`assign_parameters(param_dict)`
+
+Binds scalar values to any Terra `Parameters` in the coefficients or primitives of the Operator, or substitutes one `Parameter` for another. This method differs from Terra’s `assign_parameters` in that it also supports lists of values to assign for a give `Parameter`, in which case self will be copied for each parameterization in the binding list(s), and all the copies will be returned in an `OpList`. If lists of parameterizations are used, every `Parameter` in the param\_dict must have the same length list of parameterizations.
+
+**Parameters**
+
+**param\_dict** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – The dictionary of `Parameters` to replace, and values or lists of values by which to replace them.
+
+**Returns**
+
+The `OperatorBase` with the `Parameters` in self replaced by the values or `Parameters` in param\_dict. If param\_dict contains parameterization lists, this `OperatorBase` is an `OpList`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### compose
+
+
+
+`compose(other, permutation=None, front=False)`
+
+Composition (Linear algebra-style: A\@B(x) = A(B(x))) is not well defined for states in the binary function model, but is well defined for measurements.
+
+**Parameters**
+
+* **other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The Operator to compose with self.
+* **permutation** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – `List[int]` which defines permutation on other operator.
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If front==True, return `other.compose(self)`.
+
+**Returns**
+
+An Operator equivalent to the function composition of self and other.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If self is not a measurement, it cannot be composed from the right.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### equals
+
+
+
+`equals(other)`
+
+Evaluate Equality between Operators, overloaded by `==`. Only returns True if self and other are of the same representation (e.g. a DictStateFn and CircuitStateFn will never be equal, even if their vector representations are equal), their underlying primitives are equal (this means for ListOps, OperatorStateFns, or EvolvedOps the equality is evaluated recursively downwards), and their coefficients are equal.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to compare to self.
+
+**Returns**
+
+A bool equal to the equality of self and other.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### eval
+
+
+
+`eval(front=None)`
+
+Evaluate the Operator’s underlying function, either on a binary string or another Operator. A square binary Operator can be defined as a function taking a binary function to another binary function. This method returns the value of that function for a given StateFn or binary string. For example, `op.eval('0110').eval('1110')` can be seen as querying the Operator’s matrix representation by row 6 and column 14, and will return the complex value at those “indices.” Similarly for a StateFn, `op.eval('1011')` will return the complex value at row 11 of the vector representation of the StateFn, as all StateFns are defined to be evaluated from Zero implicitly (i.e. it is as if `.eval('0000')` is already called implicitly to always “indexing” from column 0).
+
+If `front` is None, the matrix-representation of the operator is returned.
+
+**Parameters**
+
+**front** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*] |* [*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") *|*[*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.states.statevector.Statevector") *| None*) – The bitstring, dict of bitstrings (with values being coefficients), or StateFn to evaluated by the Operator’s underlying function, or None.
+
+**Returns**
+
+The output of the Operator’s evaluation function. If self is a `StateFn`, the result is a float or complex. If self is an Operator (`PrimitiveOp, ComposedOp, SummedOp, EvolvedOp,` etc.), the result is a StateFn. If `front` is None, the matrix-representation of the operator is returned, which is a `MatrixOp` for the operators and a `VectorStateFn` for state-functions. If either self or front contain proper `ListOps` (not ListOp subclasses), the result is an n-dimensional list of complex or StateFn results, resulting from the recursive evaluation by each OperatorBase in the ListOps.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") | [complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")
+
+### mul
+
+
+
+`mul(scalar)`
+
+Returns the scalar multiplication of the Operator, overloaded by `*`, including support for Terra’s `Parameters`, which can be bound to values later (via `bind_parameters`).
+
+**Parameters**
+
+**scalar** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The real or complex scalar by which to multiply the Operator, or the `ParameterExpression` to serve as a placeholder for a scalar factor.
+
+**Returns**
+
+An `OperatorBase` equivalent to product of self and scalar.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### permute
+
+
+
+`permute(permutation)`
+
+Permute the qubits of the state function.
+
+**Parameters**
+
+**permutation** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – A list defining where each qubit should be permuted. The qubit at index j of the circuit should be permuted to position permutation\[j].
+
+**Returns**
+
+A new StateFn containing the permuted primitive.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### power
+
+
+
+`power(exponent)`
+
+Compose with Self Multiple Times, undefined for StateFns.
+
+**Parameters**
+
+**exponent** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of times to compose self with self.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – This function is not defined for StateFns.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### primitive\_strings
+
+
+
+`primitive_strings()`
+
+Return a set of strings describing the primitives contained in the Operator. For example, `{'QuantumCircuit', 'Pauli'}`. For hierarchical Operators, such as `ListOps`, this can help illuminate the primitives represented in the various recursive levels, and therefore which conversions can be applied.
+
+**Returns**
+
+A set of strings describing the primitives contained within the Operator.
+
+**Return type**
+
+[*Set*](https://docs.python.org/3/library/typing.html#typing.Set "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")]
+
+### reduce
+
+
+
+`reduce()`
+
+Try collapsing the Operator structure, usually after some type of conversion, e.g. trying to add Operators in a SummedOp or delete needless IGates in a CircuitOp. If no reduction is available, just returns self.
+
+**Returns**
+
+The reduced `OperatorBase`.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### sample
+
+
+
+`sample(shots=1024, massive=False, reverse_endianness=False)`
+
+Sample the state function as a normalized probability distribution. Returns dict of bitstrings in order of probability, with values being probability.
+
+**Parameters**
+
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of samples to take to approximate the State function.
+* **massive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to allow large conversions, e.g. creating a matrix representing over 16 qubits.
+* **reverse\_endianness** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to reverse the endianness of the bitstrings in the return dict to match Terra’s big-endianness.
+
+**Returns**
+
+A dict containing pairs sampled strings from the State function and sampling frequency divided by shots.
+
+**Return type**
+
+[*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)"), [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")]
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return tensor product between self and other, overloaded by `^`. Note: You must be conscious of Qiskit’s big-endian bit printing convention. Meaning, Plus.tensor(Zero) produces a |+⟩ on qubit 0 and a |0⟩ on qubit 1, or |+⟩⨂|0⟩, but would produce a QuantumCircuit like
+
+> |0⟩– |+⟩–
+
+Because Terra prints circuits and results with qubit 0 at the end of the string or circuit.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to tensor product with self.
+
+**Returns**
+
+An `OperatorBase` equivalent to the tensor product of self and other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### tensorpower
+
+
+
+`tensorpower(other)`
+
+Return tensor product with self multiple times, overloaded by `^`.
+
+**Parameters**
+
+**other** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The int number of times to tensor product self with itself via `tensorpower`.
+
+**Returns**
+
+An `OperatorBase` equivalent to the tensorpower of self by other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") | [int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### to\_circuit\_op
+
+
+
+`to_circuit_op()`
+
+Returns a `CircuitOp` equivalent to this Operator.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### to\_density\_matrix
+
+
+
+`to_density_matrix(massive=False)`
+
+Return matrix representing product of StateFn evaluated on pairs of basis states. Overridden by child classes.
+
+**Parameters**
+
+**massive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to allow large conversions, e.g. creating a matrix representing over 16 qubits.
+
+**Returns**
+
+The NumPy array representing the density matrix of the State function.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If massive is set to False, and exponentially large computation is needed.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+### to\_matrix
+
+
+
+`to_matrix(massive=False)`
+
+Return NumPy representation of the Operator. Represents the evaluation of the Operator’s underlying function on every combination of basis binary strings. Warn if more than 16 qubits to force having to set `massive=True` if such a large vector is desired.
+
+**Returns**
+
+The NumPy `ndarray` equivalent to this Operator.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+### to\_matrix\_op
+
+
+
+`to_matrix_op(massive=False)`
+
+Return a `VectorStateFn` for this `StateFn`.
+
+**Parameters**
+
+**massive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to allow large conversions, e.g. creating a matrix representing over 16 qubits.
+
+**Returns**
+
+A VectorStateFn equivalent to self.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### traverse
+
+
+
+`traverse(convert_fn, coeff=None)`
+
+Apply the convert\_fn to the internal primitive if the primitive is an Operator (as in the case of `OperatorStateFn`). Otherwise do nothing. Used by converters.
+
+**Parameters**
+
+* **convert\_fn** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")) – The function to apply to the internal OperatorBase.
+* **coeff** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *| None*) – A coefficient to multiply by after applying convert\_fn. If it is None, self.coeff is used instead.
+
+**Returns**
+
+The converted StateFn.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.state_fns.VectorStateFn.md b/docs/api/qiskit/0.46/qiskit.opflow.state_fns.VectorStateFn.md
new file mode 100644
index 00000000000..c34f2bce9be
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.state_fns.VectorStateFn.md
@@ -0,0 +1,306 @@
+---
+title: VectorStateFn
+description: API reference for qiskit.opflow.state_fns.VectorStateFn
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.opflow.state_fns.VectorStateFn
+---
+
+# VectorStateFn
+
+
+
+`qiskit.opflow.state_fns.VectorStateFn(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/opflow/state_fns/vector_state_fn.py "view source code")
+
+Bases: [`StateFn`](qiskit.opflow.state_fns.StateFn "qiskit.opflow.state_fns.state_fn.StateFn")
+
+Deprecated: A class for state functions and measurements which are defined in vector representation, and stored using Terra’s `Statevector` class.
+
+
+ The class `qiskit.opflow.state_fns.vector_state_fn.VectorStateFn` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+**Parameters**
+
+* **primitive** – The `Statevector`, NumPy array, or list, which defines the behavior of the underlying function.
+* **coeff** – A coefficient multiplying the state function.
+* **is\_measurement** – Whether the StateFn is a measurement operator
+
+## Attributes
+
+
+
+### INDENTATION
+
+`= ' '`
+
+
+
+### coeff
+
+A coefficient by which the state function is multiplied.
+
+
+
+### instance\_id
+
+Return the unique instance id.
+
+
+
+### is\_measurement
+
+Whether the StateFn object is a measurement Operator.
+
+
+
+### num\_qubits
+
+
+
+### parameters
+
+
+
+### primitive
+
+`Statevector`
+
+The primitive which defines the behavior of the underlying State function.
+
+
+
+### settings
+
+Return settings.
+
+## Methods
+
+### add
+
+
+
+`add(other)`
+
+Return Operator addition of self and other, overloaded by `+`.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – An `OperatorBase` with the same number of qubits as self, and in the same ‘Operator’, ‘State function’, or ‘Measurement’ category as self (i.e. the same type of underlying function).
+
+**Returns**
+
+An `OperatorBase` equivalent to the sum of self and other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return a new Operator equal to the Operator’s adjoint (conjugate transpose), overloaded by `~`. For StateFns, this also turns the StateFn into a measurement.
+
+**Returns**
+
+An `OperatorBase` equivalent to the adjoint of self.
+
+**Return type**
+
+[*VectorStateFn*](#qiskit.opflow.state_fns.VectorStateFn "qiskit.opflow.state_fns.vector_state_fn.VectorStateFn")
+
+### eval
+
+
+
+`eval(front=None)`
+
+Evaluate the Operator’s underlying function, either on a binary string or another Operator. A square binary Operator can be defined as a function taking a binary function to another binary function. This method returns the value of that function for a given StateFn or binary string. For example, `op.eval('0110').eval('1110')` can be seen as querying the Operator’s matrix representation by row 6 and column 14, and will return the complex value at those “indices.” Similarly for a StateFn, `op.eval('1011')` will return the complex value at row 11 of the vector representation of the StateFn, as all StateFns are defined to be evaluated from Zero implicitly (i.e. it is as if `.eval('0000')` is already called implicitly to always “indexing” from column 0).
+
+If `front` is None, the matrix-representation of the operator is returned.
+
+**Parameters**
+
+**front** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*] |* [*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") *|*[*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.states.statevector.Statevector") *| None*) – The bitstring, dict of bitstrings (with values being coefficients), or StateFn to evaluated by the Operator’s underlying function, or None.
+
+**Returns**
+
+The output of the Operator’s evaluation function. If self is a `StateFn`, the result is a float or complex. If self is an Operator (`PrimitiveOp, ComposedOp, SummedOp, EvolvedOp,` etc.), the result is a StateFn. If `front` is None, the matrix-representation of the operator is returned, which is a `MatrixOp` for the operators and a `VectorStateFn` for state-functions. If either self or front contain proper `ListOps` (not ListOp subclasses), the result is an n-dimensional list of complex or StateFn results, resulting from the recursive evaluation by each OperatorBase in the ListOps.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase") | [complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")
+
+### permute
+
+
+
+`permute(permutation)`
+
+Permute the qubits of the state function.
+
+**Parameters**
+
+**permutation** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – A list defining where each qubit should be permuted. The qubit at index j of the circuit should be permuted to position permutation\[j].
+
+**Returns**
+
+A new StateFn containing the permuted primitive.
+
+**Return type**
+
+[*VectorStateFn*](#qiskit.opflow.state_fns.VectorStateFn "qiskit.opflow.state_fns.vector_state_fn.VectorStateFn")
+
+### primitive\_strings
+
+
+
+`primitive_strings()`
+
+Return a set of strings describing the primitives contained in the Operator. For example, `{'QuantumCircuit', 'Pauli'}`. For hierarchical Operators, such as `ListOps`, this can help illuminate the primitives represented in the various recursive levels, and therefore which conversions can be applied.
+
+**Returns**
+
+A set of strings describing the primitives contained within the Operator.
+
+**Return type**
+
+[*Set*](https://docs.python.org/3/library/typing.html#typing.Set "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")]
+
+### sample
+
+
+
+`sample(shots=1024, massive=False, reverse_endianness=False)`
+
+Sample the state function as a normalized probability distribution. Returns dict of bitstrings in order of probability, with values being probability.
+
+**Parameters**
+
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of samples to take to approximate the State function.
+* **massive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to allow large conversions, e.g. creating a matrix representing over 16 qubits.
+* **reverse\_endianness** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to reverse the endianness of the bitstrings in the return dict to match Terra’s big-endianness.
+
+**Returns**
+
+A dict containing pairs sampled strings from the State function and sampling frequency divided by shots.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return tensor product between self and other, overloaded by `^`. Note: You must be conscious of Qiskit’s big-endian bit printing convention. Meaning, Plus.tensor(Zero) produces a |+⟩ on qubit 0 and a |0⟩ on qubit 1, or |+⟩⨂|0⟩, but would produce a QuantumCircuit like
+
+> |0⟩– |+⟩–
+
+Because Terra prints circuits and results with qubit 0 at the end of the string or circuit.
+
+**Parameters**
+
+**other** ([*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")) – The `OperatorBase` to tensor product with self.
+
+**Returns**
+
+An `OperatorBase` equivalent to the tensor product of self and other.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### to\_circuit\_op
+
+
+
+`to_circuit_op()`
+
+Return `StateFnCircuit` corresponding to this StateFn.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
+### to\_density\_matrix
+
+
+
+`to_density_matrix(massive=False)`
+
+Return matrix representing product of StateFn evaluated on pairs of basis states. Overridden by child classes.
+
+**Parameters**
+
+**massive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to allow large conversions, e.g. creating a matrix representing over 16 qubits.
+
+**Returns**
+
+The NumPy array representing the density matrix of the State function.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If massive is set to False, and exponentially large computation is needed.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+### to\_dict\_fn
+
+
+
+`to_dict_fn()`
+
+Creates the equivalent state function of type DictStateFn.
+
+**Returns**
+
+A new DictStateFn equivalent to `self`.
+
+**Return type**
+
+[*StateFn*](qiskit.opflow.state_fns.StateFn "qiskit.opflow.state_fns.state_fn.StateFn")
+
+### to\_matrix
+
+
+
+`to_matrix(massive=False)`
+
+Return NumPy representation of the Operator. Represents the evaluation of the Operator’s underlying function on every combination of basis binary strings. Warn if more than 16 qubits to force having to set `massive=True` if such a large vector is desired.
+
+**Returns**
+
+The NumPy `ndarray` equivalent to this Operator.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+### to\_matrix\_op
+
+
+
+`to_matrix_op(massive=False)`
+
+Return a `VectorStateFn` for this `StateFn`.
+
+**Parameters**
+
+**massive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to allow large conversions, e.g. creating a matrix representing over 16 qubits.
+
+**Returns**
+
+A VectorStateFn equivalent to self.
+
+**Return type**
+
+[*OperatorBase*](qiskit.opflow.OperatorBase "qiskit.opflow.operator_base.OperatorBase")
+
diff --git a/docs/api/qiskit/0.46/qiskit.opflow.state_fns.md b/docs/api/qiskit/0.46/qiskit.opflow.state_fns.md
new file mode 100644
index 00000000000..17a36c8009d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.opflow.state_fns.md
@@ -0,0 +1,50 @@
+---
+title: state_fns
+description: API reference for qiskit.opflow.state_fns
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.opflow.state_fns
+---
+
+
+
+
+
+# qiskit.opflow\.state\_fns
+
+
+
+## State Functions
+
+
+
+`qiskit.opflow.state_fns`
+
+
+ The [`qiskit.opflow`](opflow#module-qiskit.opflow "qiskit.opflow") module is deprecated and will be removed no earlier than 3 months after the release date. For code migration guidelines, visit [https://qisk.it/opflow\_migration](https://qisk.it/opflow_migration).
+
+
+State functions are defined to be complex functions over a single binary string (as compared to an operator, which is defined as a function over two binary strings, or a function taking a binary function to another binary function). This function may be called by the eval() method.
+
+Measurements are defined to be functionals over StateFns, taking them to real values. Generally, this real value is interpreted to represent the probability of some classical state (binary string) being observed from a probabilistic or quantum system represented by a StateFn. This leads to the equivalent definition, which is that a measurement m is a function over binary strings producing StateFns, such that the probability of measuring a given binary string b from a system with StateFn f is equal to the inner product between f and m(b).
+
+
+ All mathematical methods between StateFns are not in-place, meaning that they return a new object, but the underlying primitives are not copied.
+
+
+
+ State functions here are not restricted to wave functions, as there is no requirement of normalization.
+
+
+### State Functions
+
+| | |
+| -------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`StateFn`](qiskit.opflow.state_fns.StateFn "qiskit.opflow.state_fns.StateFn")(\[primitive, coeff, is\_measurement]) | Deprecated: A class for representing state functions and measurements. |
+| [`CircuitStateFn`](qiskit.opflow.state_fns.CircuitStateFn "qiskit.opflow.state_fns.CircuitStateFn")(\*args, \*\*kwargs) | Deprecated: A class for state functions and measurements which are defined by the action of a QuantumCircuit starting from \|0⟩, and stored using Terra's `QuantumCircuit` class. |
+| [`DictStateFn`](qiskit.opflow.state_fns.DictStateFn "qiskit.opflow.state_fns.DictStateFn")(\*args, \*\*kwargs) | Deprecated: A class for state functions and measurements which are defined by a lookup table, stored in a dict. |
+| [`VectorStateFn`](qiskit.opflow.state_fns.VectorStateFn "qiskit.opflow.state_fns.VectorStateFn")(\*args, \*\*kwargs) | Deprecated: A class for state functions and measurements which are defined in vector representation, and stored using Terra's `Statevector` class. |
+| [`SparseVectorStateFn`](qiskit.opflow.state_fns.SparseVectorStateFn "qiskit.opflow.state_fns.SparseVectorStateFn")(\*args, \*\*kwargs) | Deprecated: A class for sparse state functions and measurements in vector representation. |
+| [`OperatorStateFn`](qiskit.opflow.state_fns.OperatorStateFn "qiskit.opflow.state_fns.OperatorStateFn")(\*args, \*\*kwargs) | Deprecated: A class for state functions and measurements which are defined by a density Operator, stored using an `OperatorBase`. |
+| [`CVaRMeasurement`](qiskit.opflow.state_fns.CVaRMeasurement "qiskit.opflow.state_fns.CVaRMeasurement")(\*args, \*\*kwargs) | Deprecated: A specialized measurement class to compute CVaR expectation values. |
+
diff --git a/docs/api/qiskit/0.46/qiskit.passmanager.BaseController.md b/docs/api/qiskit/0.46/qiskit.passmanager.BaseController.md
new file mode 100644
index 00000000000..e7c19d26414
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.passmanager.BaseController.md
@@ -0,0 +1,73 @@
+---
+title: BaseController
+description: API reference for qiskit.passmanager.BaseController
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.passmanager.BaseController
+---
+
+# BaseController
+
+
+
+`qiskit.passmanager.BaseController(options=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/passmanager/base_tasks.py "view source code")
+
+Bases: `Task`, [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Base class of controller.
+
+A controller is built with a collection of pass manager tasks, and a subclass provides a custom logic to choose next task to run. Note a controller can be nested into another controller, and a controller itself doesn’t provide any subroutine to modify the input IR.
+
+Create new flow controller.
+
+**Parameters**
+
+**options** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*, Any] | None*) – Option for this flow controller.
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### iter\_tasks
+
+
+
+`abstract iter_tasks(state)`
+
+A custom logic to choose a next task to run.
+
+Controller subclass can consume the state to build a proper task pipeline. The updated state after a task execution will be fed back in as the “return” value of any `yield` statements. This indicates the order of task execution is only determined at running time. This method is not allowed to mutate the given state object.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – The state of the passmanager workflow at the beginning of this flow controller’s execution.
+* **state** – the state of pass manager after the execution of the last task that was yielded. The generator does not need to inspect this if it is irrelevant to its logic, nor update it.
+
+**Yields**
+
+*Task* – Next task to run.
+
+**Return type**
+
+[*Generator*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Generator "(in Python v3.12)")\[*Task*, [*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState"), None]
+
diff --git a/docs/api/qiskit/0.46/qiskit.passmanager.BasePassManager.md b/docs/api/qiskit/0.46/qiskit.passmanager.BasePassManager.md
new file mode 100644
index 00000000000..a5a9ca4523b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.passmanager.BasePassManager.md
@@ -0,0 +1,141 @@
+---
+title: BasePassManager
+description: API reference for qiskit.passmanager.BasePassManager
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.passmanager.BasePassManager
+---
+
+# BasePassManager
+
+
+
+`qiskit.passmanager.BasePassManager(tasks=(), max_iteration=1000)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/passmanager/passmanager.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Pass manager base class.
+
+Initialize an empty pass manager object.
+
+**Parameters**
+
+* **tasks** (*Task |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[Task]*) – A pass set to be added to the pass manager schedule.
+* **max\_iteration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The maximum number of iterations the schedule will be looped if the condition is not met.
+
+## Methods
+
+### append
+
+
+
+`append(tasks)`
+
+Append tasks to the schedule of passes.
+
+**Parameters**
+
+**tasks** (*Task |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[Task]*) – A set of pass manager tasks to be added to schedule.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – When any element of tasks is not a subclass of passmanager Task.
+
+### remove
+
+
+
+`remove(index)`
+
+Removes a particular pass in the scheduler.
+
+**Parameters**
+
+**index** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Pass index to remove, based on the position in `passes()`.
+
+**Raises**
+
+[**PassManagerError**](passmanager#qiskit.passmanager.PassManagerError "qiskit.passmanager.PassManagerError") – If the index is not found.
+
+### replace
+
+
+
+`replace(index, tasks)`
+
+Replace a particular pass in the scheduler.
+
+**Parameters**
+
+* **index** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Task index to replace, based on the position in `tasks()`
+* **tasks** (*Task |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[Task]*) – A set of pass manager tasks to be added to schedule.
+
+**Raises**
+
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – When any element of tasks is not a subclass of passmanager Task.
+* [**PassManagerError**](passmanager#qiskit.passmanager.PassManagerError "qiskit.passmanager.PassManagerError") – If the index is not found.
+
+### run
+
+
+
+`run(in_programs, callback=None, **kwargs)`
+
+Run all the passes on the specified `in_programs`.
+
+**Parameters**
+
+* **in\_programs** (*Any |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[Any]*) – Input programs to transform via all the registered passes. A single input object cannot be a Python builtin list object. A list object is considered as multiple input objects to optimize.
+
+* **callback** (*Callable*) –
+
+ A callback function that will be called after each pass execution. The function will be called with 4 keyword arguments:
+
+ ```python
+ task (GenericPass): the pass being run
+ passmanager_ir (Any): depending on pass manager subclass
+ property_set (PropertySet): the property set
+ running_time (float): the time to execute the pass
+ count (int): the index for the pass execution
+ ```
+
+ The exact arguments pass expose the internals of the pass manager and are subject to change as the pass manager internals change. If you intend to reuse a callback function over multiple releases be sure to check that the arguments being passed are the same.
+
+ To use the callback feature you define a function that will take in kwargs dict and access the variables. For example:
+
+ ```python
+ def callback_func(**kwargs):
+ task = kwargs['task']
+ passmanager_ir = kwargs['passmanager_ir']
+ property_set = kwargs['property_set']
+ running_time = kwargs['running_time']
+ count = kwargs['count']
+ ...
+ ```
+
+* **kwargs** – Arbitrary arguments passed to the compiler frontend and backend.
+
+**Returns**
+
+The transformed program(s).
+
+**Return type**
+
+Any
+
+### to\_flow\_controller
+
+
+
+`to_flow_controller()`
+
+Linearize this manager into a single [`FlowControllerLinear`](qiskit.passmanager.FlowControllerLinear "qiskit.passmanager.FlowControllerLinear"), so that it can be nested inside another pass manager.
+
+**Returns**
+
+A linearized pass manager.
+
+**Return type**
+
+[*FlowControllerLinear*](qiskit.passmanager.FlowControllerLinear "qiskit.passmanager.flow_controllers.FlowControllerLinear")
+
diff --git a/docs/api/qiskit/0.46/qiskit.passmanager.ConditionalController.md b/docs/api/qiskit/0.46/qiskit.passmanager.ConditionalController.md
new file mode 100644
index 00000000000..d889dfc2896
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.passmanager.ConditionalController.md
@@ -0,0 +1,95 @@
+---
+title: ConditionalController
+description: API reference for qiskit.passmanager.ConditionalController
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.passmanager.ConditionalController
+---
+
+# ConditionalController
+
+
+
+`qiskit.passmanager.ConditionalController(tasks=(), condition=None, *, options=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/passmanager/flow_controllers.py "view source code")
+
+Bases: [`BaseController`](qiskit.passmanager.BaseController "qiskit.passmanager.base_tasks.BaseController")
+
+A flow controller runs the pipeline once if the condition is true, or does nothing if the condition is false.
+
+Create new flow controller.
+
+**Parameters**
+
+**options** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*, Any] | None*) – Option for this flow controller.
+
+## Attributes
+
+
+
+### passes
+
+Alias of tasks for backward compatibility.
+
+## Methods
+
+### append
+
+
+
+`append(passes)`
+
+Add new task to pipeline.
+
+
+ The method `qiskit.passmanager.flow_controllers.ConditionalController.append()` is deprecated as of qiskit 0.45.0. It will be removed in the Qiskit 1.0 release. All tasks must be provided at construction time of the controller object.
+
+
+**Parameters**
+
+**passes** (*Task |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[Task]*) – A new task or list of tasks to add.
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### iter\_tasks
+
+
+
+`iter_tasks(state)`
+
+A custom logic to choose a next task to run.
+
+Controller subclass can consume the state to build a proper task pipeline. The updated state after a task execution will be fed back in as the “return” value of any `yield` statements. This indicates the order of task execution is only determined at running time. This method is not allowed to mutate the given state object.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – The state of the passmanager workflow at the beginning of this flow controller’s execution.
+* **state** – the state of pass manager after the execution of the last task that was yielded. The generator does not need to inspect this if it is irrelevant to its logic, nor update it.
+
+**Yields**
+
+*Task* – Next task to run.
+
+**Return type**
+
+[*Generator*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Generator "(in Python v3.12)")\[*Task*, [*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState"), None]
+
diff --git a/docs/api/qiskit/0.46/qiskit.passmanager.DoWhileController.md b/docs/api/qiskit/0.46/qiskit.passmanager.DoWhileController.md
new file mode 100644
index 00000000000..20ce34f6c77
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.passmanager.DoWhileController.md
@@ -0,0 +1,97 @@
+---
+title: DoWhileController
+description: API reference for qiskit.passmanager.DoWhileController
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.passmanager.DoWhileController
+---
+
+# DoWhileController
+
+
+
+`qiskit.passmanager.DoWhileController(tasks=(), do_while=None, *, options=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/passmanager/flow_controllers.py "view source code")
+
+Bases: [`BaseController`](qiskit.passmanager.BaseController "qiskit.passmanager.base_tasks.BaseController")
+
+Run the given tasks in a loop until the `do_while` condition on the property set becomes `False`.
+
+The given tasks will always run at least once, and on iteration of the loop, all the tasks will be run (with the exception of a failure state being set).
+
+Create new flow controller.
+
+**Parameters**
+
+**options** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*, Any] | None*) – Option for this flow controller.
+
+## Attributes
+
+
+
+### passes
+
+Alias of tasks for backward compatibility.
+
+## Methods
+
+### append
+
+
+
+`append(passes)`
+
+Add new task to pipeline.
+
+
+ The method `qiskit.passmanager.flow_controllers.DoWhileController.append()` is deprecated as of qiskit 0.45.0. It will be removed in the Qiskit 1.0 release. All tasks must be provided at construction time of the controller object.
+
+
+**Parameters**
+
+**passes** (*Task |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[Task]*) – A new task or list of tasks to add.
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### iter\_tasks
+
+
+
+`iter_tasks(state)`
+
+A custom logic to choose a next task to run.
+
+Controller subclass can consume the state to build a proper task pipeline. The updated state after a task execution will be fed back in as the “return” value of any `yield` statements. This indicates the order of task execution is only determined at running time. This method is not allowed to mutate the given state object.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – The state of the passmanager workflow at the beginning of this flow controller’s execution.
+* **state** – the state of pass manager after the execution of the last task that was yielded. The generator does not need to inspect this if it is irrelevant to its logic, nor update it.
+
+**Yields**
+
+*Task* – Next task to run.
+
+**Return type**
+
+[*Generator*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Generator "(in Python v3.12)")\[*Task*, [*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState"), None]
+
diff --git a/docs/api/qiskit/0.46/qiskit.passmanager.FlowController.md b/docs/api/qiskit/0.46/qiskit.passmanager.FlowController.md
new file mode 100644
index 00000000000..9d4a3323f1e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.passmanager.FlowController.md
@@ -0,0 +1,168 @@
+---
+title: FlowController
+description: API reference for qiskit.passmanager.FlowController
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.passmanager.FlowController
+---
+
+# FlowController
+
+
+
+`qiskit.passmanager.FlowController(options=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/passmanager/flow_controllers.py "view source code")
+
+Bases: [`BaseController`](qiskit.passmanager.BaseController "qiskit.passmanager.base_tasks.BaseController")
+
+A legacy factory for other flow controllers.
+
+
+ This class is primarily for compatibility with legacy versions of Qiskit, and in general, you should prefer simply instantiating the controller you want, and adding it to the relevant [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager") or other controller. Its use is deprecated.
+
+
+This allows syntactic sugar for writing pipelines. For example:
+
+```python
+FlowController.add_flow_controller("my_condition", CustomController)
+
+controller = FlowController.controller_factory(
+ [PassA(), PassB()],
+ {"max_iteration": 1000},
+ condition=lambda prop_set: prop_set["x"] == 0,
+ do_while=lambda prop_set: prop_set["x"] < 100,
+ my_condition=lambda prop_set: prop_set["y"] = "abc",
+)
+```
+
+This creates a nested flow controller that runs when the value `x` in the [`PropertySet`](qiskit.passmanager.PropertySet "qiskit.passmanager.PropertySet") is zero and repeats the pipeline until the value becomes 100. In each innermost loop, the custom iteration condition provided by the `CustomController` is also evaluated.
+
+
+ [`BaseController`](qiskit.passmanager.BaseController "qiskit.passmanager.BaseController") must be directly subclassed to define a custom flow controller. This class provides a controller factory method, which consumes a class variable [`registered_controllers`](#qiskit.passmanager.FlowController.registered_controllers "qiskit.passmanager.FlowController.registered_controllers"). Subclassing FlowController may cause unexpected behavior in the factory method. Note that factory method implicitly determines the priority of the builtin controllers when multiple controllers are called together, and the behavior of generated controller is hardly debugged.
+
+
+
+ The class `qiskit.passmanager.flow_controllers.FlowController` is deprecated as of qiskit 0.46.0. It will be removed in the 1.0 release. The base class of flow controller is now qiskit.passmanager.BaseController. This class exists only for the controller namespace used to map a controller name tothe corresponding class object, which is used to instantiate a controller with keyword argument in PassManager.append method. This pattern was also deprecated.
+
+
+## Attributes
+
+
+
+### hierarchy
+
+`= ['condition', 'do_while']`
+
+
+
+### registered\_controllers = \{'condition'
+
+`= {'condition':`
+
+`= {'condition': , 'do_while': }`
+
+## Methods
+
+### add\_flow\_controller
+
+
+
+`classmethod add_flow_controller(name, controller)`
+
+Adds a flow controller.
+
+
+ The method `qiskit.passmanager.flow_controllers.FlowController.add_flow_controller()` is deprecated as of qiskit 0.45.0. It will be removed in the 1.0 release. The controller factory method is deprecated and managing the custom flow controllers with aliases no longer helps building the task pipeline. Controllers must be explicitly instantiated and appended to the pipeline.
+
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Alias of controller class in the namespace.
+* **controller** ([*Type*](https://docs.python.org/3/library/typing.html#typing.Type "(in Python v3.12)")*\[*[*BaseController*](qiskit.passmanager.BaseController "qiskit.passmanager.base_tasks.BaseController")*]*) – Flow controller class.
+
+### controller\_factory
+
+
+
+`classmethod controller_factory(passes, options, **controllers)`
+
+Create a new flow controller with normalization.
+
+
+ The method `qiskit.passmanager.flow_controllers.FlowController.controller_factory()` is deprecated as of qiskit 0.45.0. It will be removed in the 1.0 release. FlowController objects must be explicitly instantiated. Building controllers with keyword arguments ignores the order when multiple keyword arguments are provided together, which is likely unsafe.
+
+
+**Parameters**
+
+* **passes** (*Task |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[Task]*) – A list of optimization tasks.
+* **options** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – Option for this flow controller.
+* **controllers** – Dictionary of controller callables keyed on flow controller alias.
+
+**Returns**
+
+An instance of normalized flow controller.
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### iter\_tasks
+
+
+
+`abstract iter_tasks(state)`
+
+A custom logic to choose a next task to run.
+
+Controller subclass can consume the state to build a proper task pipeline. The updated state after a task execution will be fed back in as the “return” value of any `yield` statements. This indicates the order of task execution is only determined at running time. This method is not allowed to mutate the given state object.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – The state of the passmanager workflow at the beginning of this flow controller’s execution.
+* **state** – the state of pass manager after the execution of the last task that was yielded. The generator does not need to inspect this if it is irrelevant to its logic, nor update it.
+
+**Yields**
+
+*Task* – Next task to run.
+
+**Return type**
+
+[*Generator*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Generator "(in Python v3.12)")\[*Task*, [*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState"), None]
+
+### remove\_flow\_controller
+
+
+
+`classmethod remove_flow_controller(name)`
+
+Removes a flow controller.
+
+
+ The method `qiskit.passmanager.flow_controllers.FlowController.remove_flow_controller()` is deprecated as of qiskit 0.45.0. It will be removed in the 1.0 release. The controller factory method is deprecated and managing the custom flow controllers with aliases no longer helps building the task pipeline. Controllers must be explicitly instantiated and appended to the pipeline.
+
+
+**Parameters**
+
+**name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Alias of the controller to remove.
+
+**Raises**
+
+[**KeyError**](https://docs.python.org/3/library/exceptions.html#KeyError "(in Python v3.12)") – If the controller to remove was not registered.
+
diff --git a/docs/api/qiskit/0.46/qiskit.passmanager.FlowControllerLinear.md b/docs/api/qiskit/0.46/qiskit.passmanager.FlowControllerLinear.md
new file mode 100644
index 00000000000..78c2403a6cc
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.passmanager.FlowControllerLinear.md
@@ -0,0 +1,95 @@
+---
+title: FlowControllerLinear
+description: API reference for qiskit.passmanager.FlowControllerLinear
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.passmanager.FlowControllerLinear
+---
+
+# FlowControllerLinear
+
+
+
+`qiskit.passmanager.FlowControllerLinear(tasks=(), *, options=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/passmanager/flow_controllers.py "view source code")
+
+Bases: [`BaseController`](qiskit.passmanager.BaseController "qiskit.passmanager.base_tasks.BaseController")
+
+A standard flow controller that runs tasks one after the other.
+
+Create new flow controller.
+
+**Parameters**
+
+**options** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*, Any] | None*) – Option for this flow controller.
+
+## Attributes
+
+
+
+### passes
+
+Alias of tasks for backward compatibility.
+
+## Methods
+
+### append
+
+
+
+`append(passes)`
+
+Add new task to pipeline.
+
+
+ The method `qiskit.passmanager.flow_controllers.FlowControllerLinear.append()` is deprecated as of qiskit 0.45.0. It will be removed in the Qiskit 1.0 release. All tasks must be provided at construction time of the controller object.
+
+
+**Parameters**
+
+**passes** (*Task |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[Task]*) – A new task or list of tasks to add.
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### iter\_tasks
+
+
+
+`iter_tasks(state)`
+
+A custom logic to choose a next task to run.
+
+Controller subclass can consume the state to build a proper task pipeline. The updated state after a task execution will be fed back in as the “return” value of any `yield` statements. This indicates the order of task execution is only determined at running time. This method is not allowed to mutate the given state object.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – The state of the passmanager workflow at the beginning of this flow controller’s execution.
+* **state** – the state of pass manager after the execution of the last task that was yielded. The generator does not need to inspect this if it is irrelevant to its logic, nor update it.
+
+**Yields**
+
+*Task* – Next task to run.
+
+**Return type**
+
+[*Generator*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Generator "(in Python v3.12)")\[*Task*, [*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState"), None]
+
diff --git a/docs/api/qiskit/0.46/qiskit.passmanager.GenericPass.md b/docs/api/qiskit/0.46/qiskit.passmanager.GenericPass.md
new file mode 100644
index 00000000000..20f324c196d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.passmanager.GenericPass.md
@@ -0,0 +1,97 @@
+---
+title: GenericPass
+description: API reference for qiskit.passmanager.GenericPass
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.passmanager.GenericPass
+---
+
+# GenericPass
+
+
+
+`qiskit.passmanager.GenericPass`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/passmanager/base_tasks.py "view source code")
+
+Bases: `Task`, [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Base class of a single pass manager task.
+
+A pass instance can read and write to the provided [`PropertySet`](qiskit.passmanager.PropertySet "qiskit.passmanager.PropertySet"), and may modify the input pass manager IR.
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`abstract run(passmanager_ir)`
+
+Run optimization task.
+
+**Parameters**
+
+**passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+
+**Returns**
+
+Optimized Qiskit IR.
+
+**Return type**
+
+[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.passmanager.PassManagerState.md b/docs/api/qiskit/0.46/qiskit.passmanager.PassManagerState.md
new file mode 100644
index 00000000000..4d876b0c43d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.passmanager.PassManagerState.md
@@ -0,0 +1,40 @@
+---
+title: PassManagerState
+description: API reference for qiskit.passmanager.PassManagerState
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.passmanager.PassManagerState
+---
+
+# PassManagerState
+
+
+
+`qiskit.passmanager.PassManagerState(workflow_status, property_set)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/passmanager/compilation_status.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+A portable container object that pass manager tasks communicate through generator.
+
+This object can contain every information about the running pass manager workflow, except for the IR object being optimized. The data structure consists of two elements; one for the status of the workflow itself, and another one for the additional information about the IR analyzed through pass executions. This container aims at just providing a robust interface for the `Task.execute()`, and no logic that modifies the container elements must be implemented.
+
+This object is mutable, and might be mutated by pass executions.
+
+## Attributes
+
+
+
+### workflow\_status
+
+`WorkflowStatus`
+
+Status of the current compilation workflow.
+
+
+
+### property\_set
+
+`PropertySet`
+
+Information about IR being optimized.
+
diff --git a/docs/api/qiskit/0.46/qiskit.passmanager.PropertySet.md b/docs/api/qiskit/0.46/qiskit.passmanager.PropertySet.md
new file mode 100644
index 00000000000..735c0e8b0b3
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.passmanager.PropertySet.md
@@ -0,0 +1,102 @@
+---
+title: PropertySet
+description: API reference for qiskit.passmanager.PropertySet
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.passmanager.PropertySet
+---
+
+# PropertySet
+
+
+
+`qiskit.passmanager.PropertySet`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/passmanager/compilation_status.py "view source code")
+
+Bases: [`dict`](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+A default dictionary-like object.
+
+## Methods
+
+### clear
+
+
+
+`clear() → None. Remove all items from D.`
+
+### copy
+
+
+
+`copy() → a shallow copy of D`
+
+### fromkeys
+
+
+
+`fromkeys(value=None, /)`
+
+Create a new dictionary with keys from iterable and values set to value.
+
+### get
+
+
+
+`get(key, default=None, /)`
+
+Return the value for key if key is in the dictionary, else default.
+
+### items
+
+
+
+`items() → a set-like object providing a view on D's items`
+
+### keys
+
+
+
+`keys() → a set-like object providing a view on D's keys`
+
+### pop
+
+
+
+`pop(k[, d]) → v, remove specified key and return the corresponding value.`
+
+If key is not found, default is returned if given, otherwise KeyError is raised
+
+### popitem
+
+
+
+`popitem()`
+
+Remove and return a (key, value) pair as a 2-tuple.
+
+Pairs are returned in LIFO (last-in, first-out) order. Raises KeyError if the dict is empty.
+
+### setdefault
+
+
+
+`setdefault(key, default=None, /)`
+
+Insert key with a value of default if key is not in the dictionary.
+
+Return the value for key if key is in the dictionary, else default.
+
+### update
+
+
+
+`update([E, ]**F) → None. Update D from dict/iterable E and F.`
+
+If E is present and has a .keys() method, then does: for k in E: D\[k] = E\[k] If E is present and lacks a .keys() method, then does: for k, v in E: D\[k] = v In either case, this is followed by: for k in F: D\[k] = F\[k]
+
+### values
+
+
+
+`values() → an object providing a view on D's values`
+
diff --git a/docs/api/qiskit/0.46/qiskit.passmanager.WorkflowStatus.md b/docs/api/qiskit/0.46/qiskit.passmanager.WorkflowStatus.md
new file mode 100644
index 00000000000..9b1711c7bc8
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.passmanager.WorkflowStatus.md
@@ -0,0 +1,50 @@
+---
+title: WorkflowStatus
+description: API reference for qiskit.passmanager.WorkflowStatus
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.passmanager.WorkflowStatus
+---
+
+# WorkflowStatus
+
+
+
+`qiskit.passmanager.WorkflowStatus(count=0, completed_passes=, previous_run=RunState.FAIL)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/passmanager/compilation_status.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Collection of compilation status of workflow, i.e. pass manager run.
+
+This data structure is initialized when the pass manager is run, and recursively handed over to underlying tasks. Each pass will update this status once after being executed, and the lifetime of the workflow status object is the time during which the pass manager is running.
+
+## Attributes
+
+
+
+### count
+
+`int`
+
+`= 0`
+
+Current number of pass execution.
+
+
+
+### previous\_run
+
+`RunState`
+
+`= 1`
+
+Status of the latest pass run.
+
+
+
+### completed\_passes
+
+`set`
+
+Passes already run that have not been invalidated.
+
diff --git a/docs/api/qiskit/0.46/qiskit.primitives.BackendEstimator.md b/docs/api/qiskit/0.46/qiskit.primitives.BackendEstimator.md
new file mode 100644
index 00000000000..698aae34ecd
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.primitives.BackendEstimator.md
@@ -0,0 +1,172 @@
+---
+title: BackendEstimator
+description: API reference for qiskit.primitives.BackendEstimator
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.primitives.BackendEstimator
+---
+
+# BackendEstimator
+
+
+
+`qiskit.primitives.BackendEstimator(backend, options=None, abelian_grouping=True, bound_pass_manager=None, skip_transpilation=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/primitives/backend_estimator.py "view source code")
+
+Bases: [`BaseEstimator`](qiskit.primitives.BaseEstimator "qiskit.primitives.base.base_estimator.BaseEstimator")\[`PrimitiveJob`\[[`EstimatorResult`](qiskit.primitives.EstimatorResult "qiskit.primitives.base.estimator_result.EstimatorResult")]]
+
+Evaluates expectation value using Pauli rotation gates.
+
+The [`BackendEstimator`](#qiskit.primitives.BackendEstimator "qiskit.primitives.BackendEstimator") class is a generic implementation of the [`BaseEstimator`](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator") interface that is used to wrap a [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") (or [`BackendV1`](qiskit.providers.BackendV1 "qiskit.providers.BackendV1")) object in the [`BaseEstimator`](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator") API. It facilitates using backends that do not provide a native [`BaseEstimator`](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator") implementation in places that work with [`BaseEstimator`](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator"), such as algorithms in [`qiskit.algorithms`](algorithms#module-qiskit.algorithms "qiskit.algorithms") including [`VQE`](qiskit.algorithms.minimum_eigensolvers.VQE "qiskit.algorithms.minimum_eigensolvers.VQE"). However, if you’re using a provider that has a native implementation of [`BaseEstimator`](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator"), it is a better choice to leverage that native implementation as it will likely include additional optimizations and be a more efficient implementation. The generic nature of this class precludes doing any provider- or backend-specific optimizations.
+
+Initialize a new BackendEstimator instance
+
+**Parameters**
+
+* **backend** ([*BackendV1*](qiskit.providers.BackendV1 "qiskit.providers.BackendV1") *|*[*BackendV2*](qiskit.providers.BackendV2 "qiskit.providers.BackendV2")) – Required: the backend to run the primitive on
+* **options** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *| None*) – Default options.
+* **abelian\_grouping** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether the observable should be grouped into commuting
+* **bound\_pass\_manager** ([*PassManager*](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager") *| None*) – An optional pass manager to run after parameter binding.
+* **skip\_transpilation** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If this is set to True the internal compilation of the input circuits is skipped and the circuit objects will be directly executed when this object is called.
+
+## Attributes
+
+
+
+### backend
+
+Returns: The backend which this estimator object based on
+
+
+
+### circuits
+
+Quantum circuits that represents quantum states.
+
+**Returns**
+
+The quantum circuits.
+
+
+
+### observables
+
+Observables to be estimated.
+
+**Returns**
+
+The observables.
+
+
+
+### options
+
+Return options values for the estimator.
+
+**Returns**
+
+options
+
+
+
+### parameters
+
+Parameters of the quantum circuits.
+
+**Returns**
+
+Parameters, where `parameters[i][j]` is the j-th parameter of the i-th circuit.
+
+
+
+### preprocessed\_circuits
+
+Transpiled quantum circuits produced by preprocessing :returns: List of the transpiled quantum circuit
+
+
+
+### transpile\_options
+
+Return the transpiler options for transpiling the circuits.
+
+
+
+### transpiled\_circuits
+
+Transpiled quantum circuits. :returns: List of the transpiled quantum circuit
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the instance has been closed.
+
+## Methods
+
+### run
+
+
+
+`run(circuits, observables, parameter_values=None, **run_options)`
+
+Run the job of the estimation of expectation value(s).
+
+`circuits`, `observables`, and `parameter_values` should have the same length. The i-th element of the result is the expectation of observable
+
+```python
+obs = observables[i]
+```
+
+for the state prepared by
+
+```python
+circ = circuits[i]
+```
+
+with bound parameters
+
+```python
+values = parameter_values[i].
+```
+
+
+ Implicit conversion from a `PauliList` to a `SparsePauliOp` with `coeffs=1` in the `observables` arguments is deprecated as of Qiskit 0.46 and will be removed in Qiskit 1.0. You should explicitly convert to a `SparsePauli` using `SparsePauliOp(pauli_list)` to avoid this warning.
+
+
+**Parameters**
+
+* **circuits** (*Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*] |* [*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – one or more circuit objects.
+* **observables** (*Sequence\[BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp") *|*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*] | BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp") *|*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – one or more observable objects. Several formats are allowed; importantly, `str` should follow the string representation format for [`Pauli`](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli") objects.
+* **parameter\_values** (*Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] |* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – concrete parameters to be bound.
+* **run\_options** – runtime options used for circuit execution.
+
+**Returns**
+
+The job object of EstimatorResult.
+
+**Raises**
+
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Invalid argument type given.
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – Invalid argument values given.
+
+**Return type**
+
+T
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set options values for the estimator.
+
+**Parameters**
+
+**\*\*fields** – The fields to update the options
+
+### set\_transpile\_options
+
+
+
+`set_transpile_options(**fields)`
+
+Set the transpiler options for transpiler. :param \*\*fields: The fields to update the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.primitives.BackendSampler.md b/docs/api/qiskit/0.46/qiskit.primitives.BackendSampler.md
new file mode 100644
index 00000000000..b10f1c3958e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.primitives.BackendSampler.md
@@ -0,0 +1,153 @@
+---
+title: BackendSampler
+description: API reference for qiskit.primitives.BackendSampler
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.primitives.BackendSampler
+---
+
+# BackendSampler
+
+
+
+`qiskit.primitives.BackendSampler(backend, options=None, bound_pass_manager=None, skip_transpilation=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/primitives/backend_sampler.py "view source code")
+
+Bases: [`BaseSampler`](qiskit.primitives.BaseSampler "qiskit.primitives.base.base_sampler.BaseSampler")\[`PrimitiveJob`\[[`SamplerResult`](qiskit.primitives.SamplerResult "qiskit.primitives.base.sampler_result.SamplerResult")]]
+
+A [`BaseSampler`](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler") implementation that provides an interface for leveraging the sampler interface from any backend.
+
+This class provides a sampler interface from any backend and doesn’t do any measurement mitigation, it just computes the probability distribution from the counts. It facilitates using backends that do not provide a native [`BaseSampler`](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler") implementation in places that work with [`BaseSampler`](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler"), such as algorithms in [`qiskit.algorithms`](algorithms#module-qiskit.algorithms "qiskit.algorithms") including [`SamplingVQE`](qiskit.algorithms.minimum_eigensolvers.SamplingVQE "qiskit.algorithms.minimum_eigensolvers.SamplingVQE"). However, if you’re using a provider that has a native implementation of [`BaseSampler`](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler"), it is a better choice to leverage that native implementation as it will likely include additional optimizations and be a more efficient implementation. The generic nature of this class precludes doing any provider- or backend-specific optimizations.
+
+Initialize a new BackendSampler
+
+**Parameters**
+
+* **backend** ([*BackendV1*](qiskit.providers.BackendV1 "qiskit.providers.BackendV1") *|*[*BackendV2*](qiskit.providers.BackendV2 "qiskit.providers.BackendV2")) – Required: the backend to run the sampler primitive on
+* **options** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *| None*) – Default options.
+* **bound\_pass\_manager** ([*PassManager*](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager") *| None*) – An optional pass manager to run after parameter binding.
+* **skip\_transpilation** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If this is set to True the internal compilation of the input circuits is skipped and the circuit objects will be directly executed when this objected is called.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If backend is not provided
+
+## Attributes
+
+
+
+### backend
+
+Returns: The backend which this sampler object based on
+
+
+
+### circuits
+
+Quantum circuits to be sampled.
+
+**Returns**
+
+The quantum circuits to be sampled.
+
+
+
+### options
+
+Return options values for the estimator.
+
+**Returns**
+
+options
+
+
+
+### parameters
+
+Parameters of quantum circuits.
+
+**Returns**
+
+List of the parameters in each quantum circuit.
+
+
+
+### preprocessed\_circuits
+
+Preprocessed quantum circuits produced by preprocessing :returns: List of the transpiled quantum circuit
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the instance has been closed.
+
+
+
+### transpile\_options
+
+Return the transpiler options for transpiling the circuits.
+
+
+
+### transpiled\_circuits
+
+Transpiled quantum circuits. :returns: List of the transpiled quantum circuit
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the instance has been closed.
+
+## Methods
+
+### run
+
+
+
+`run(circuits, parameter_values=None, **run_options)`
+
+Run the job of the sampling of bitstrings.
+
+**Parameters**
+
+* **circuits** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – One of more circuit objects.
+* **parameter\_values** (*Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Parameters to be bound to the circuit.
+* **run\_options** – Backend runtime options used for circuit execution.
+
+**Returns**
+
+The job object of the result of the sampler. The i-th result corresponds to `circuits[i]` evaluated with parameters bound as `parameter_values[i]`.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – Invalid arguments are given.
+
+**Return type**
+
+T
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set options values for the estimator.
+
+**Parameters**
+
+**\*\*fields** – The fields to update the options
+
+### set\_transpile\_options
+
+
+
+`set_transpile_options(**fields)`
+
+Set the transpiler options for transpiler. :param \*\*fields: The fields to update the options.
+
+**Returns**
+
+self.
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the instance has been closed.
+
diff --git a/docs/api/qiskit/0.46/qiskit.primitives.BaseEstimator.md b/docs/api/qiskit/0.46/qiskit.primitives.BaseEstimator.md
new file mode 100644
index 00000000000..e1a0f4cdf54
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.primitives.BaseEstimator.md
@@ -0,0 +1,132 @@
+---
+title: BaseEstimator
+description: API reference for qiskit.primitives.BaseEstimator
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.primitives.BaseEstimator
+---
+
+# BaseEstimator
+
+
+
+`qiskit.primitives.BaseEstimator(*, options=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/primitives/base/base_estimator.py "view source code")
+
+Bases: `BasePrimitive`, [`Generic`](https://docs.python.org/3/library/typing.html#typing.Generic "(in Python v3.12)")\[`T`]
+
+Estimator base class.
+
+Base class for Estimator that estimates expectation values of quantum circuits and observables.
+
+Creating an instance of an Estimator, or using one in a `with` context opens a session that holds resources until the instance is `close()` ed or the context is exited.
+
+**Parameters**
+
+**options** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *| None*) – Default options.
+
+## Attributes
+
+
+
+### circuits
+
+Quantum circuits that represents quantum states.
+
+**Returns**
+
+The quantum circuits.
+
+
+
+### observables
+
+Observables to be estimated.
+
+**Returns**
+
+The observables.
+
+
+
+### options
+
+Return options values for the estimator.
+
+**Returns**
+
+options
+
+
+
+### parameters
+
+Parameters of the quantum circuits.
+
+**Returns**
+
+Parameters, where `parameters[i][j]` is the j-th parameter of the i-th circuit.
+
+## Methods
+
+### run
+
+
+
+`run(circuits, observables, parameter_values=None, **run_options)`
+
+Run the job of the estimation of expectation value(s).
+
+`circuits`, `observables`, and `parameter_values` should have the same length. The i-th element of the result is the expectation of observable
+
+```python
+obs = observables[i]
+```
+
+for the state prepared by
+
+```python
+circ = circuits[i]
+```
+
+with bound parameters
+
+```python
+values = parameter_values[i].
+```
+
+
+ Implicit conversion from a `PauliList` to a `SparsePauliOp` with `coeffs=1` in the `observables` arguments is deprecated as of Qiskit 0.46 and will be removed in Qiskit 1.0. You should explicitly convert to a `SparsePauli` using `SparsePauliOp(pauli_list)` to avoid this warning.
+
+
+**Parameters**
+
+* **circuits** (*Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*] |* [*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – one or more circuit objects.
+* **observables** (*Sequence\[BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp") *|*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*] | BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp") *|*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – one or more observable objects. Several formats are allowed; importantly, `str` should follow the string representation format for [`Pauli`](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli") objects.
+* **parameter\_values** (*Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] |* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – concrete parameters to be bound.
+* **run\_options** – runtime options used for circuit execution.
+
+**Returns**
+
+The job object of EstimatorResult.
+
+**Raises**
+
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Invalid argument type given.
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – Invalid argument values given.
+
+**Return type**
+
+T
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set options values for the estimator.
+
+**Parameters**
+
+**\*\*fields** – The fields to update the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.primitives.BaseSampler.md b/docs/api/qiskit/0.46/qiskit.primitives.BaseSampler.md
new file mode 100644
index 00000000000..a2634c0d2c9
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.primitives.BaseSampler.md
@@ -0,0 +1,96 @@
+---
+title: BaseSampler
+description: API reference for qiskit.primitives.BaseSampler
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.primitives.BaseSampler
+---
+
+# BaseSampler
+
+
+
+`qiskit.primitives.BaseSampler(*, options=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/primitives/base/base_sampler.py "view source code")
+
+Bases: `BasePrimitive`, [`Generic`](https://docs.python.org/3/library/typing.html#typing.Generic "(in Python v3.12)")\[`T`]
+
+Sampler base class
+
+Base class of Sampler that calculates quasi-probabilities of bitstrings from quantum circuits.
+
+**Parameters**
+
+**options** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *| None*) – Default options.
+
+## Attributes
+
+
+
+### circuits
+
+Quantum circuits to be sampled.
+
+**Returns**
+
+The quantum circuits to be sampled.
+
+
+
+### options
+
+Return options values for the estimator.
+
+**Returns**
+
+options
+
+
+
+### parameters
+
+Parameters of quantum circuits.
+
+**Returns**
+
+List of the parameters in each quantum circuit.
+
+## Methods
+
+### run
+
+
+
+`run(circuits, parameter_values=None, **run_options)`
+
+Run the job of the sampling of bitstrings.
+
+**Parameters**
+
+* **circuits** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – One of more circuit objects.
+* **parameter\_values** (*Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Parameters to be bound to the circuit.
+* **run\_options** – Backend runtime options used for circuit execution.
+
+**Returns**
+
+The job object of the result of the sampler. The i-th result corresponds to `circuits[i]` evaluated with parameters bound as `parameter_values[i]`.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – Invalid arguments are given.
+
+**Return type**
+
+T
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set options values for the estimator.
+
+**Parameters**
+
+**\*\*fields** – The fields to update the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.primitives.Estimator.md b/docs/api/qiskit/0.46/qiskit.primitives.Estimator.md
new file mode 100644
index 00000000000..997c9dcd96d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.primitives.Estimator.md
@@ -0,0 +1,137 @@
+---
+title: Estimator
+description: API reference for qiskit.primitives.Estimator
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.primitives.Estimator
+---
+
+# Estimator
+
+
+
+`qiskit.primitives.Estimator(*, options=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/primitives/estimator.py "view source code")
+
+Bases: [`BaseEstimator`](qiskit.primitives.BaseEstimator "qiskit.primitives.base.base_estimator.BaseEstimator")\[`PrimitiveJob`\[[`EstimatorResult`](qiskit.primitives.EstimatorResult "qiskit.primitives.base.estimator_result.EstimatorResult")]]
+
+Reference implementation of [`BaseEstimator`](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator").
+
+**Run Options**
+
+* **shots** (None or int) – The number of shots. If None, it calculates the exact expectation values. Otherwise, it samples from normal distributions with standard errors as standard deviations using normal distribution approximation.
+* **seed** (np.random.Generator or int) – Set a fixed seed or generator for the normal distribution. If shots is None, this option is ignored.
+
+**Parameters**
+
+**options** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *| None*) – Default options.
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if some classical bits are not used for measurements.
+
+## Attributes
+
+
+
+### circuits
+
+Quantum circuits that represents quantum states.
+
+**Returns**
+
+The quantum circuits.
+
+
+
+### observables
+
+Observables to be estimated.
+
+**Returns**
+
+The observables.
+
+
+
+### options
+
+Return options values for the estimator.
+
+**Returns**
+
+options
+
+
+
+### parameters
+
+Parameters of the quantum circuits.
+
+**Returns**
+
+Parameters, where `parameters[i][j]` is the j-th parameter of the i-th circuit.
+
+## Methods
+
+### run
+
+
+
+`run(circuits, observables, parameter_values=None, **run_options)`
+
+Run the job of the estimation of expectation value(s).
+
+`circuits`, `observables`, and `parameter_values` should have the same length. The i-th element of the result is the expectation of observable
+
+```python
+obs = observables[i]
+```
+
+for the state prepared by
+
+```python
+circ = circuits[i]
+```
+
+with bound parameters
+
+```python
+values = parameter_values[i].
+```
+
+
+ Implicit conversion from a `PauliList` to a `SparsePauliOp` with `coeffs=1` in the `observables` arguments is deprecated as of Qiskit 0.46 and will be removed in Qiskit 1.0. You should explicitly convert to a `SparsePauli` using `SparsePauliOp(pauli_list)` to avoid this warning.
+
+
+**Parameters**
+
+* **circuits** (*Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*] |* [*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – one or more circuit objects.
+* **observables** (*Sequence\[BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp") *|*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*] | BaseOperator |* [*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp") *|*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – one or more observable objects. Several formats are allowed; importantly, `str` should follow the string representation format for [`Pauli`](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli") objects.
+* **parameter\_values** (*Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] |* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – concrete parameters to be bound.
+* **run\_options** – runtime options used for circuit execution.
+
+**Returns**
+
+The job object of EstimatorResult.
+
+**Raises**
+
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – Invalid argument type given.
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – Invalid argument values given.
+
+**Return type**
+
+T
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set options values for the estimator.
+
+**Parameters**
+
+**\*\*fields** – The fields to update the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.primitives.EstimatorResult.md b/docs/api/qiskit/0.46/qiskit.primitives.EstimatorResult.md
new file mode 100644
index 00000000000..3ef9672c1ca
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.primitives.EstimatorResult.md
@@ -0,0 +1,81 @@
+---
+title: EstimatorResult
+description: API reference for qiskit.primitives.EstimatorResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.primitives.EstimatorResult
+---
+
+# EstimatorResult
+
+
+
+`qiskit.primitives.EstimatorResult(values, metadata)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/primitives/base/estimator_result.py "view source code")
+
+Bases: `_BasePrimitiveResult`
+
+Result of Estimator.
+
+```python
+result = estimator.run(circuits, observables, params).result()
+```
+
+where the i-th elements of `result` correspond to the circuit and observable given by `circuits[i]`, `observables[i]`, and the parameter values bounds by `params[i]`. For example, `results.values[i]` gives the expectation value, and `result.metadata[i]` is a metadata dictionary for this circuit and parameters.
+
+**Parameters**
+
+* **values** (*np.ndarray*) – The array of the expectation values.
+* **metadata** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*]*) – List of the metadata.
+
+## Attributes
+
+
+
+### experiments
+
+Experiment data dicts in any inheriting result dataclass.
+
+
+ The property `qiskit.primitives.base.base_result._BasePrimitiveResult.experiments` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release.
+
+
+
+
+### num\_experiments
+
+Number of experiments in any inheriting result dataclass.
+
+
+ The property `qiskit.primitives.base.base_result._BasePrimitiveResult.num_experiments` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release.
+
+
+
+
+### values
+
+`np.ndarray[Any, np.dtype[np.float64]]`
+
+
+
+### metadata
+
+`list[dict[str, Any]]`
+
+## Methods
+
+### decompose
+
+
+
+`decompose()`
+
+Generate single experiment result objects from self.
+
+
+ The method `qiskit.primitives.base.base_result._BasePrimitiveResult.decompose()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release.
+
+
+**Return type**
+
+[*Iterator*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Iterator "(in Python v3.12)")\[*\_BasePrimitiveResult*]
+
diff --git a/docs/api/qiskit/0.46/qiskit.primitives.Sampler.md b/docs/api/qiskit/0.46/qiskit.primitives.Sampler.md
new file mode 100644
index 00000000000..e37a1dde922
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.primitives.Sampler.md
@@ -0,0 +1,105 @@
+---
+title: Sampler
+description: API reference for qiskit.primitives.Sampler
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.primitives.Sampler
+---
+
+# Sampler
+
+
+
+`qiskit.primitives.Sampler(*, options=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/primitives/sampler.py "view source code")
+
+Bases: [`BaseSampler`](qiskit.primitives.BaseSampler "qiskit.primitives.base.base_sampler.BaseSampler")\[`PrimitiveJob`\[[`SamplerResult`](qiskit.primitives.SamplerResult "qiskit.primitives.base.sampler_result.SamplerResult")]]
+
+Sampler class.
+
+[`Sampler`](#qiskit.primitives.Sampler "qiskit.primitives.Sampler") is a reference implementation of [`BaseSampler`](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler").
+
+**Run Options**
+
+* **shots** (None or int) – The number of shots. If None, it calculates the probabilities. Otherwise, it samples from multinomial distributions.
+* **seed** (np.random.Generator or int) – Set a fixed seed or generator for the multinomial distribution. If shots is None, this option is ignored.
+
+**Parameters**
+
+**options** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *| None*) – Default options.
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if some classical bits are not used for measurements.
+
+## Attributes
+
+
+
+### circuits
+
+Quantum circuits to be sampled.
+
+**Returns**
+
+The quantum circuits to be sampled.
+
+
+
+### options
+
+Return options values for the estimator.
+
+**Returns**
+
+options
+
+
+
+### parameters
+
+Parameters of quantum circuits.
+
+**Returns**
+
+List of the parameters in each quantum circuit.
+
+## Methods
+
+### run
+
+
+
+`run(circuits, parameter_values=None, **run_options)`
+
+Run the job of the sampling of bitstrings.
+
+**Parameters**
+
+* **circuits** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *| Sequence\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – One of more circuit objects.
+* **parameter\_values** (*Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | Sequence\[Sequence\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]] | None*) – Parameters to be bound to the circuit.
+* **run\_options** – Backend runtime options used for circuit execution.
+
+**Returns**
+
+The job object of the result of the sampler. The i-th result corresponds to `circuits[i]` evaluated with parameters bound as `parameter_values[i]`.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – Invalid arguments are given.
+
+**Return type**
+
+T
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set options values for the estimator.
+
+**Parameters**
+
+**\*\*fields** – The fields to update the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.primitives.SamplerResult.md b/docs/api/qiskit/0.46/qiskit.primitives.SamplerResult.md
new file mode 100644
index 00000000000..0cc0ee6acda
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.primitives.SamplerResult.md
@@ -0,0 +1,81 @@
+---
+title: SamplerResult
+description: API reference for qiskit.primitives.SamplerResult
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.primitives.SamplerResult
+---
+
+# SamplerResult
+
+
+
+`qiskit.primitives.SamplerResult(quasi_dists, metadata)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/primitives/base/sampler_result.py "view source code")
+
+Bases: `_BasePrimitiveResult`
+
+Result of Sampler.
+
+```python
+result = sampler.run(circuits, params).result()
+```
+
+where the i-th elements of `result` correspond to the circuit given by `circuits[i]`, and the parameter values bounds by `params[i]`. For example, `results.quasi_dists[i]` gives the quasi-probabilities of bitstrings, and `result.metadata[i]` is a metadata dictionary for this circuit and parameters.
+
+**Parameters**
+
+* **quasi\_dists** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*QuasiDistribution*](qiskit.result.QuasiDistribution "qiskit.result.QuasiDistribution")*]*) – List of the quasi-probabilities.
+* **metadata** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*]*) – List of the metadata.
+
+## Attributes
+
+
+
+### experiments
+
+Experiment data dicts in any inheriting result dataclass.
+
+
+ The property `qiskit.primitives.base.base_result._BasePrimitiveResult.experiments` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release.
+
+
+
+
+### num\_experiments
+
+Number of experiments in any inheriting result dataclass.
+
+
+ The property `qiskit.primitives.base.base_result._BasePrimitiveResult.num_experiments` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release.
+
+
+
+
+### quasi\_dists
+
+`list[qiskit.result.distributions.quasi.QuasiDistribution]`
+
+
+
+### metadata
+
+`list[dict[str, Any]]`
+
+## Methods
+
+### decompose
+
+
+
+`decompose()`
+
+Generate single experiment result objects from self.
+
+
+ The method `qiskit.primitives.base.base_result._BasePrimitiveResult.decompose()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release.
+
+
+**Return type**
+
+[*Iterator*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Iterator "(in Python v3.12)")\[*\_BasePrimitiveResult*]
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.Backend.md b/docs/api/qiskit/0.46/qiskit.providers.Backend.md
new file mode 100644
index 00000000000..ccc88952e78
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.Backend.md
@@ -0,0 +1,28 @@
+---
+title: Backend
+description: API reference for qiskit.providers.Backend
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.Backend
+---
+
+# Backend
+
+
+
+`qiskit.providers.Backend`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/backend.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Base common type for all versioned Backend abstract classes.
+
+Note this class should not be inherited from directly, it is intended to be used for type checking. When implementing a provider you should use the versioned abstract classes as the parent class and not this class directly.
+
+## Attributes
+
+
+
+### version
+
+`= 0`
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.BackendV1.md b/docs/api/qiskit/0.46/qiskit.providers.BackendV1.md
new file mode 100644
index 00000000000..535cb868e57
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.BackendV1.md
@@ -0,0 +1,213 @@
+---
+title: BackendV1
+description: API reference for qiskit.providers.BackendV1
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.BackendV1
+---
+
+# BackendV1
+
+
+
+`qiskit.providers.BackendV1(configuration, provider=None, **fields)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/backend.py "view source code")
+
+Bases: [`Backend`](qiskit.providers.Backend "qiskit.providers.backend.Backend"), [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Abstract class for Backends
+
+This abstract class is to be used for all Backend objects created by a provider. There are several classes of information contained in a Backend. The first are the attributes of the class itself. These should be used to defined the immutable characteristics of the backend. The `options` attribute of the backend is used to contain the dynamic user configurable options of the backend. It should be used more for runtime options that configure how the backend is used. For example, something like a `shots` field for a backend that runs experiments which would contain an int for how many shots to execute. The `properties` attribute is optionally defined [`BackendProperties`](qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties") object and is used to return measured properties, or properties of a backend that may change over time. The simplest example of this would be a version string, which will change as a backend is updated, but also could be something like noise parameters for backends that run experiments.
+
+This first version of the Backend abstract class is written to be mostly backwards compatible with the legacy providers interface. This includes reusing the model objects [`BackendProperties`](qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties") and [`BackendConfiguration`](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration"). This was done to ease the transition for users and provider maintainers to the new versioned providers. Expect, future versions of this abstract class to change the data model and interface.
+
+Subclasses of this should override the public method [`run()`](#qiskit.providers.BackendV1.run "qiskit.providers.BackendV1.run") and the internal [`_default_options()`](#qiskit.providers.BackendV1._default_options "qiskit.providers.BackendV1._default_options"):
+
+### \_default\_options
+
+
+
+`abstract classmethod _default_options()`
+
+Return the default options
+
+This method will return a [`qiskit.providers.Options`](qiskit.providers.Options "qiskit.providers.Options") subclass object that will be used for the default options. These should be the default parameters to use for the options of the backend.
+
+**Returns**
+
+**A options object with**
+
+default values set
+
+**Return type**
+
+[qiskit.providers.Options](qiskit.providers.Options "qiskit.providers.Options")
+
+Initialize a backend class
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – A backend configuration object for the backend object.
+* **provider** ([*qiskit.providers.Provider*](qiskit.providers.Provider "qiskit.providers.Provider")) – Optionally, the provider object that this Backend comes from.
+* **fields** – kwargs for the values to use to override the default options.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – if input field not a valid options
+
+In addition to the public abstract methods, subclasses should also implement the following private methods:
+
+`abstract classmethod _default_options()`
+
+Return the default options
+
+This method will return a [`qiskit.providers.Options`](qiskit.providers.Options "qiskit.providers.Options") subclass object that will be used for the default options. These should be the default parameters to use for the options of the backend.
+
+**Returns**
+
+**A options object with**
+
+default values set
+
+**Return type**
+
+[qiskit.providers.Options](qiskit.providers.Options "qiskit.providers.Options")
+
+## Attributes
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.BackendV1.run "qiskit.providers.BackendV1.run") method.
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Return the backend properties.
+
+**Returns**
+
+the configuration for the backend. If the backend does not support properties, it returns `None`.
+
+**Return type**
+
+[BackendProperties](qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties")
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`abstract run(run_input, **options)`
+
+Run on the backend.
+
+This method returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object that runs circuits. Depending on the backend this may be either an async or sync call. It is at the discretion of the provider to decide whether running should block until the execution is finished or not: the Job class can handle either situation.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend. For legacy providers migrating to the new versioned providers, provider interface a [`QasmQobj`](qiskit.qobj.QasmQobj "qiskit.qobj.QasmQobj") or [`PulseQobj`](qiskit.qobj.PulseQobj "qiskit.qobj.PulseQobj") objects should probably be supported too (but deprecated) for backwards compatibility. Be sure to update the docstrings of subclasses implementing this method to document that. New provider implementations should not do this though as [`qiskit.qobj`](qobj#module-qiskit.qobj "qiskit.qobj") will be deprecated and removed along with the legacy providers interface.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.BackendV2.md b/docs/api/qiskit/0.46/qiskit.providers.BackendV2.md
new file mode 100644
index 00000000000..a7b0012d7b0
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.BackendV2.md
@@ -0,0 +1,382 @@
+---
+title: BackendV2
+description: API reference for qiskit.providers.BackendV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.BackendV2
+---
+
+# BackendV2
+
+
+
+`qiskit.providers.BackendV2(provider=None, name=None, description=None, online_date=None, backend_version=None, **fields)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/backend.py "view source code")
+
+Bases: [`Backend`](qiskit.providers.Backend "qiskit.providers.backend.Backend"), [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Abstract class for Backends
+
+This abstract class is to be used for all Backend objects created by a provider. This version differs from earlier abstract Backend classes in that the configuration attribute no longer exists. Instead, attributes exposing equivalent required immutable properties of the backend device are added. For example `backend.configuration().n_qubits` is accessible from `backend.num_qubits` now.
+
+The `options` attribute of the backend is used to contain the dynamic user configurable options of the backend. It should be used more for runtime options that configure how the backend is used. For example, something like a `shots` field for a backend that runs experiments which would contain an int for how many shots to execute.
+
+If migrating a provider from [`BackendV1`](qiskit.providers.BackendV1 "qiskit.providers.BackendV1") one thing to keep in mind is for backwards compatibility you might need to add a configuration method that will build a [`BackendConfiguration`](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration") object and [`BackendProperties`](qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties") from the attributes defined in this class for backwards compatibility.
+
+A backend object can optionally contain methods named `get_translation_stage_plugin` and `get_scheduling_stage_plugin`. If these methods are present on a backend object and this object is used for [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`generate_preset_pass_manager()`](transpiler_preset#qiskit.transpiler.preset_passmanagers.generate_preset_pass_manager "qiskit.transpiler.preset_passmanagers.generate_preset_pass_manager") the transpilation process will default to using the output from those methods as the scheduling stage and the translation compilation stage. This enables a backend which has custom requirements for compilation to specify a stage plugin for these stages to enable custom transformation of the circuit to ensure it is runnable on the backend. These hooks are enabled by default and should only be used to enable extra compilation steps if they are **required** to ensure a circuit is executable on the backend or have the expected level of performance. These methods are passed no input arguments and are expected to return a `str` representing the method name which should be a stage plugin (see: [`qiskit.transpiler.preset_passmanagers.plugin`](transpiler_plugins#module-qiskit.transpiler.preset_passmanagers.plugin "qiskit.transpiler.preset_passmanagers.plugin") for more details on plugins). The typical expected use case is for a backend provider to implement a stage plugin for `translation` or `scheduling` that contains the custom compilation passes and then for the hook methods on the backend object to return the plugin name so that [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") will use it by default when targetting the backend.
+
+Subclasses of this should override the public method [`run()`](#qiskit.providers.BackendV2.run "qiskit.providers.BackendV2.run") and the internal [`_default_options()`](#qiskit.providers.BackendV2._default_options "qiskit.providers.BackendV2._default_options"):
+
+### \_default\_options
+
+
+
+`abstract classmethod _default_options()`
+
+Return the default options
+
+This method will return a [`qiskit.providers.Options`](qiskit.providers.Options "qiskit.providers.Options") subclass object that will be used for the default options. These should be the default parameters to use for the options of the backend.
+
+**Returns**
+
+**A options object with**
+
+default values set
+
+**Return type**
+
+[qiskit.providers.Options](qiskit.providers.Options "qiskit.providers.Options")
+
+Initialize a BackendV2 based backend
+
+**Parameters**
+
+* **provider** ([*Provider*](qiskit.providers.Provider "qiskit.providers.provider.Provider")) – An optional backwards reference to the [`Provider`](qiskit.providers.Provider "qiskit.providers.Provider") object that the backend is from
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – An optional name for the backend
+* **description** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – An optional description of the backend
+* **online\_date** ([*datetime*](https://docs.python.org/3/library/datetime.html#datetime.datetime "(in Python v3.12)")) – An optional datetime the backend was brought online
+* **backend\_version** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – An optional backend version string. This differs from the [`version`](#qiskit.providers.BackendV2.version "qiskit.providers.BackendV2.version") attribute as [`version`](#qiskit.providers.BackendV2.version "qiskit.providers.BackendV2.version") is for the abstract [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface version of the object while `backend_version` is for versioning the backend itself.
+* **fields** – kwargs for the values to use to override the default options.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If a field is specified that’s outside the backend’s options
+
+## Attributes
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the output signal timestep
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+The maximum number of circuits (or Pulse schedules) that can be run in a single job.
+
+If there is no limit this will return None
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.BackendV2.run "qiskit.providers.BackendV2.run") method.
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](#qiskit.providers.BackendV2.version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`abstract run(run_input, **options)`
+
+Run on the backend.
+
+This method returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object that runs circuits. Depending on the backend this may be either an async or sync call. It is at the discretion of the provider to decide whether running should block until the execution is finished or not: the Job class can handle either situation.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.BackendV2Converter.md b/docs/api/qiskit/0.46/qiskit.providers.BackendV2Converter.md
new file mode 100644
index 00000000000..639851eb89f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.BackendV2Converter.md
@@ -0,0 +1,333 @@
+---
+title: BackendV2Converter
+description: API reference for qiskit.providers.BackendV2Converter
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.BackendV2Converter
+---
+
+# BackendV2Converter
+
+
+
+`qiskit.providers.BackendV2Converter(backend, name_mapping=None, add_delay=False, filter_faulty=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/backend_compat.py "view source code")
+
+Bases: [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.backend.BackendV2")
+
+A converter class that takes a [`BackendV1`](qiskit.providers.BackendV1 "qiskit.providers.BackendV1") instance and wraps it in a [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") interface.
+
+This class implements the [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") interface and is used to enable common access patterns between [`BackendV1`](qiskit.providers.BackendV1 "qiskit.providers.BackendV1") and [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2"). This class should only be used if you need a [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") and still need compatibility with [`BackendV1`](qiskit.providers.BackendV1 "qiskit.providers.BackendV1").
+
+When using custom calibrations (or other custom workflows) it is **not** recommended to mutate the `BackendV1` object before applying this converter. For example, in order to convert a `BackendV1` object with a customized `defaults().instruction_schedule_map`, which has a custom calibration for an operation, the operation name must be in `configuration().basis_gates` and `name_mapping` must be supplied for the operation. Otherwise, the operation will be dropped in the resulting `BackendV2` object.
+
+Instead it is typically better to add custom calibrations **after** applying this converter instead of updating `BackendV1.defaults()` in advance. For example:
+
+```python
+backend_v2 = BackendV2Converter(backend_v1)
+backend_v2.target.add_instruction(
+ custom_gate, {(0, 1): InstructionProperties(calibration=custom_sched)}
+)
+```
+
+Initialize a BackendV2 converter instance based on a BackendV1 instance.
+
+**Parameters**
+
+* **backend** ([*BackendV1*](qiskit.providers.BackendV1 "qiskit.providers.BackendV1")) – The input [`BackendV1`](qiskit.providers.BackendV1 "qiskit.providers.BackendV1") based backend to wrap in a [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") interface
+* **name\_mapping** (*Optional\[Dict\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*, Any]]*) – An optional dictionary that maps custom gate/operation names in `backend` to an [`Operation`](qiskit.circuit.Operation "qiskit.circuit.Operation") object representing that gate/operation. By default most standard gates names are mapped to the standard gate object from [`qiskit.circuit.library`](circuit_library#module-qiskit.circuit.library "qiskit.circuit.library") this only needs to be specified if the input `backend` defines gates in names outside that set.
+* **add\_delay** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If set to true a [`Delay`](qiskit.circuit.Delay "qiskit.circuit.Delay") operation will be added to the target as a supported operation for all qubits
+* **filter\_faulty** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If the [`BackendProperties`](qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties") object (if present) for `backend` has any qubits or gates flagged as non-operational filter those from the output target.
+
+## Attributes
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.BackendV2Converter.run "qiskit.providers.BackendV2Converter.run") method.
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the backend.
+
+This method returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object that runs circuits. Depending on the backend this may be either an async or sync call. It is at the discretion of the provider to decide whether running should block until the execution is finished or not: the Job class can handle either situation.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.Job.md b/docs/api/qiskit/0.46/qiskit.providers.Job.md
new file mode 100644
index 00000000000..9942bfc73fd
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.Job.md
@@ -0,0 +1,28 @@
+---
+title: Job
+description: API reference for qiskit.providers.Job
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.Job
+---
+
+# Job
+
+
+
+`qiskit.providers.Job`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/job.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Base common type for all versioned Job abstract classes.
+
+Note this class should not be inherited from directly, it is intended to be used for type checking. When implementing a provider you should use the versioned abstract classes as the parent class and not this class directly.
+
+## Attributes
+
+
+
+### version
+
+`= 0`
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.JobStatus.md b/docs/api/qiskit/0.46/qiskit.providers.JobStatus.md
new file mode 100644
index 00000000000..90d8f04f89c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.JobStatus.md
@@ -0,0 +1,62 @@
+---
+title: JobStatus
+description: API reference for qiskit.providers.JobStatus
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.JobStatus
+---
+
+# JobStatus
+
+
+
+`qiskit.providers.JobStatus(value)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/jobstatus.py "view source code")
+
+Bases: [`Enum`](https://docs.python.org/3/library/enum.html#enum.Enum "(in Python v3.12)")
+
+Class for job status enumerated type.
+
+## Attributes
+
+
+
+### INITIALIZING
+
+`= 'job is being initialized'`
+
+
+
+### QUEUED
+
+`= 'job is queued'`
+
+
+
+### VALIDATING
+
+`= 'job is being validated'`
+
+
+
+### RUNNING
+
+`= 'job is actively running'`
+
+
+
+### CANCELLED
+
+`= 'job has been cancelled'`
+
+
+
+### DONE
+
+`= 'job has successfully run'`
+
+
+
+### ERROR
+
+`= 'job incurred error'`
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.JobV1.md b/docs/api/qiskit/0.46/qiskit.providers.JobV1.md
new file mode 100644
index 00000000000..ae761dec4f1
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.JobV1.md
@@ -0,0 +1,170 @@
+---
+title: JobV1
+description: API reference for qiskit.providers.JobV1
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.JobV1
+---
+
+# JobV1
+
+
+
+`qiskit.providers.JobV1(backend, job_id, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/job.py "view source code")
+
+Bases: [`Job`](qiskit.providers.Job "qiskit.providers.job.Job"), [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Class to handle jobs
+
+This first version of the Backend abstract class is written to be mostly backwards compatible with the legacy providers interface. This was done to ease the transition for users and provider maintainers to the new versioned providers. Expect, future versions of this abstract class to change the data model and interface.
+
+Initializes the asynchronous job.
+
+**Parameters**
+
+* **backend** ([*Backend*](qiskit.providers.Backend "qiskit.providers.backend.Backend") *| None*) – the backend used to run the job.
+* **job\_id** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – a unique id in the context of the backend used to run the job.
+* **kwargs** – Any key value metadata to associate with this job.
+
+## Attributes
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### backend
+
+
+
+`backend()`
+
+Return the backend where this job was executed.
+
+**Return type**
+
+[*Backend*](qiskit.providers.Backend "qiskit.providers.backend.Backend")
+
+### cancel
+
+
+
+`cancel()`
+
+Attempt to cancel the job.
+
+### cancelled
+
+
+
+`cancelled()`
+
+Return whether the job has been cancelled.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### done
+
+
+
+`done()`
+
+Return whether the job has successfully run.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### in\_final\_state
+
+
+
+`in_final_state()`
+
+Return whether the job is in a final job state such as `DONE` or `ERROR`.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### job\_id
+
+
+
+`job_id()`
+
+Return a unique id identifying the job.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### result
+
+
+
+`abstract result()`
+
+Return the results of the job.
+
+### running
+
+
+
+`running()`
+
+Return whether the job is actively running.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### status
+
+
+
+`abstract status()`
+
+Return the status of the job, among the values of `JobStatus`.
+
+### submit
+
+
+
+`abstract submit()`
+
+Submit the job to the backend for execution.
+
+### wait\_for\_final\_state
+
+
+
+`wait_for_final_state(timeout=None, wait=5, callback=None)`
+
+Poll the job status until it progresses to a final state such as `DONE` or `ERROR`.
+
+**Parameters**
+
+* **timeout** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – Seconds to wait for the job. If `None`, wait indefinitely.
+
+* **wait** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Seconds between queries.
+
+* **callback** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *| None*) –
+
+ Callback function invoked after each query. The following positional arguments are provided to the callback function:
+
+ * job\_id: Job ID
+ * job\_status: Status of the job from the last query
+ * job: This BaseJob instance
+
+ Note: different subclass might provide different arguments to the callback function.
+
+**Raises**
+
+[**JobTimeoutError**](providers#qiskit.providers.JobTimeoutError "qiskit.providers.JobTimeoutError") – If the job does not reach a final state before the specified timeout.
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.Options.md b/docs/api/qiskit/0.46/qiskit.providers.Options.md
new file mode 100644
index 00000000000..a2e57a2bf0a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.Options.md
@@ -0,0 +1,125 @@
+---
+title: Options
+description: API reference for qiskit.providers.Options
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.Options
+---
+
+# Options
+
+
+
+`qiskit.providers.Options(**kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/options.py "view source code")
+
+Bases: [`Mapping`](https://docs.python.org/3/library/collections.abc.html#collections.abc.Mapping "(in Python v3.12)")
+
+Base options object
+
+This class is what all backend options are based on. The properties of the class are intended to be all dynamically adjustable so that a user can reconfigure the backend on demand. If a property is immutable to the user (eg something like number of qubits) that should be a configuration of the backend class itself instead of the options.
+
+Instances of this class behave like dictionaries. Accessing an option with a default value can be done with the get() method:
+
+```python
+>>> options = Options(opt1=1, opt2=2)
+>>> options.get("opt1")
+1
+>>> options.get("opt3", default="hello")
+'hello'
+```
+
+Key-value pairs for all options can be retrieved using the items() method:
+
+```python
+>>> list(options.items())
+[('opt1', 1), ('opt2', 2)]
+```
+
+Options can be updated by name:
+
+```python
+>>> options["opt1"] = 3
+>>> options.get("opt1")
+3
+```
+
+Runtime validators can be registered. See set\_validator. Updates through update\_options and indexing (\_\_setitem\_\_) validate the new value before performing the update and raise ValueError if the new value is invalid.
+
+```python
+>>> options.set_validator("opt1", (1, 5))
+>>> options["opt1"] = 4
+>>> options["opt1"]
+4
+>>> options["opt1"] = 10
+Traceback (most recent call last):
+...
+ValueError: ...
+```
+
+## Attributes
+
+
+
+### validator
+
+## Methods
+
+### get
+
+
+
+`get(k[, d]) → D[k] if k in D, else d. d defaults to None.`
+
+### items
+
+
+
+`items() → a set-like object providing a view on D's items`
+
+### keys
+
+
+
+`keys() → a set-like object providing a view on D's keys`
+
+### set\_validator
+
+
+
+`set_validator(field, validator_value)`
+
+Set an optional validator for a field in the options
+
+Setting a validator enables changes to an options values to be validated for correctness when [`update_options()`](#qiskit.providers.Options.update_options "qiskit.providers.Options.update_options") is called. For example if you have a numeric field like `shots` you can specify a bounds tuple that set an upper and lower bound on the value such as:
+
+```python
+options.set_validator("shots", (1, 4096))
+```
+
+In this case whenever the `"shots"` option is updated by the user it will enforce that the value is >=1 and \<=4096. A `ValueError` will be raised if it’s outside those bounds. If a validator is already present for the specified field it will be silently overridden.
+
+**Parameters**
+
+* **field** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The field name to set the validator on
+* **validator\_value** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)") *or*[*type*](https://docs.python.org/3/library/functions.html#type "(in Python v3.12)")) – The value to use for the validator depending on the type indicates on how the value for a field is enforced. If a tuple is passed in it must have a length of two and will enforce the min and max value (inclusive) for an integer or float value option. If it’s a list it will list the valid values for a field. If it’s a `type` the validator will just enforce the value is of a certain type.
+
+**Raises**
+
+* [**KeyError**](https://docs.python.org/3/library/exceptions.html#KeyError "(in Python v3.12)") – If field is not present in the options object
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If the `validator_value` has an invalid value for a given type
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – If `validator_value` is not a valid type
+
+### update\_options
+
+
+
+`update_options(**fields)`
+
+Update options with kwargs
+
+### values
+
+
+
+`values() → an object providing a view on D's values`
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.Provider.md b/docs/api/qiskit/0.46/qiskit.providers.Provider.md
new file mode 100644
index 00000000000..5fd5f851fa3
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.Provider.md
@@ -0,0 +1,28 @@
+---
+title: Provider
+description: API reference for qiskit.providers.Provider
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.Provider
+---
+
+# Provider
+
+
+
+`qiskit.providers.Provider`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/provider.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Base common type for all versioned Provider abstract classes.
+
+Note this class should not be inherited from directly, it is intended to be used for type checking. When implementing a provider you should use the versioned abstract classes as the parent class and not this class directly.
+
+## Attributes
+
+
+
+### version
+
+`= 0`
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.ProviderV1.md b/docs/api/qiskit/0.46/qiskit.providers.ProviderV1.md
new file mode 100644
index 00000000000..fe8f1f180f4
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.ProviderV1.md
@@ -0,0 +1,76 @@
+---
+title: ProviderV1
+description: API reference for qiskit.providers.ProviderV1
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.ProviderV1
+---
+
+# ProviderV1
+
+
+
+`qiskit.providers.ProviderV1`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/provider.py "view source code")
+
+Bases: [`Provider`](qiskit.providers.Provider "qiskit.providers.provider.Provider"), [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Base class for a Backend Provider.
+
+## Attributes
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### backends
+
+
+
+`abstract backends(name=None, **kwargs)`
+
+Return a list of backends matching the specified filtering.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name of the backend.
+* **\*\*kwargs** – dict used for filtering.
+
+**Returns**
+
+**a list of Backends that match the filtering**
+
+criteria.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[Backend](qiskit.providers.Backend "qiskit.providers.Backend")]
+
+### get\_backend
+
+
+
+`get_backend(name=None, **kwargs)`
+
+Return a single backend matching the specified filtering.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name of the backend.
+* **\*\*kwargs** – dict used for filtering.
+
+**Returns**
+
+a backend matching the filtering.
+
+**Return type**
+
+[Backend](qiskit.providers.Backend "qiskit.providers.Backend")
+
+**Raises**
+
+[**QiskitBackendNotFoundError**](providers#qiskit.providers.QiskitBackendNotFoundError "qiskit.providers.QiskitBackendNotFoundError") – if no backend could be found or more than one backend matches the filtering criteria.
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.QubitProperties.md b/docs/api/qiskit/0.46/qiskit.providers.QubitProperties.md
new file mode 100644
index 00000000000..18e1359e16f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.QubitProperties.md
@@ -0,0 +1,42 @@
+---
+title: QubitProperties
+description: API reference for qiskit.providers.QubitProperties
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.QubitProperties
+---
+
+# QubitProperties
+
+
+
+`qiskit.providers.QubitProperties(t1=None, t2=None, frequency=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/backend.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+A representation of the properties of a qubit on a backend.
+
+This class provides the optional properties that a backend can provide for a qubit. These represent the set of qubit properties that Qiskit can currently work with if present. However if your backend provides additional properties of qubits you should subclass this to add additional custom attributes for those custom/additional properties provided by the backend.
+
+Create a new [`QubitProperties`](#qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object.
+
+**Parameters**
+
+* **t1** – The T1 time for a qubit in seconds
+* **t2** – The T2 time for a qubit in seconds
+* **frequency** – The frequency of a qubit in Hz
+
+## Attributes
+
+
+
+### t1
+
+
+
+### t2
+
+
+
+### frequency
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.basic_provider.BasicProvider.md b/docs/api/qiskit/0.46/qiskit.providers.basic_provider.BasicProvider.md
new file mode 100644
index 00000000000..ca72ea48800
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.basic_provider.BasicProvider.md
@@ -0,0 +1,76 @@
+---
+title: BasicProvider
+description: API reference for qiskit.providers.basic_provider.BasicProvider
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.basic_provider.BasicProvider
+---
+
+# BasicProvider
+
+
+
+`qiskit.providers.basic_provider.BasicProvider`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/basic_provider/basic_provider.py "view source code")
+
+Bases: [`ProviderV1`](qiskit.providers.ProviderV1 "qiskit.providers.provider.ProviderV1")
+
+Provider for test simulators.
+
+## Attributes
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### backends
+
+
+
+`backends(name=None, filters=None, **kwargs)`
+
+Return a list of backends matching the specified filtering.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name of the backend.
+* **\*\*kwargs** – dict used for filtering.
+
+**Returns**
+
+**a list of Backends that match the filtering**
+
+criteria.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[Backend](qiskit.providers.Backend "qiskit.providers.Backend")]
+
+### get\_backend
+
+
+
+`get_backend(name=None, **kwargs)`
+
+Return a single backend matching the specified filtering.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name of the backend.
+* **\*\*kwargs** – dict used for filtering.
+
+**Returns**
+
+a backend matching the filtering.
+
+**Return type**
+
+[Backend](qiskit.providers.Backend "qiskit.providers.Backend")
+
+**Raises**
+
+[**QiskitBackendNotFoundError**](providers#qiskit.providers.QiskitBackendNotFoundError "qiskit.providers.QiskitBackendNotFoundError") – if no backend could be found or more than one backend matches the filtering criteria.
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.basic_provider.BasicProviderError.md b/docs/api/qiskit/0.46/qiskit.providers.basic_provider.BasicProviderError.md
new file mode 100644
index 00000000000..46cc6dc012c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.basic_provider.BasicProviderError.md
@@ -0,0 +1,20 @@
+---
+title: BasicProviderError
+description: API reference for qiskit.providers.basic_provider.BasicProviderError
+in_page_toc_min_heading_level: 1
+python_api_type: exception
+python_api_name: qiskit.providers.basic_provider.BasicProviderError
+---
+
+
+
+# qiskit.providers.basic\_provider.BasicProviderError
+
+
+
+`qiskit.providers.basic_provider.BasicProviderError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/basic_provider/exceptions.py "view source code")
+
+Base class for errors raised by the Basic Provider.
+
+Set the error message.
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.basic_provider.BasicProviderJob.md b/docs/api/qiskit/0.46/qiskit.providers.basic_provider.BasicProviderJob.md
new file mode 100644
index 00000000000..1a4b9701207
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.basic_provider.BasicProviderJob.md
@@ -0,0 +1,184 @@
+---
+title: BasicProviderJob
+description: API reference for qiskit.providers.basic_provider.BasicProviderJob
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.basic_provider.BasicProviderJob
+---
+
+# BasicProviderJob
+
+
+
+`qiskit.providers.basic_provider.BasicProviderJob(backend, job_id, result)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/basic_provider/basic_provider_job.py "view source code")
+
+Bases: [`JobV1`](qiskit.providers.JobV1 "qiskit.providers.job.JobV1")
+
+BasicProviderJob class.
+
+Initializes the asynchronous job.
+
+**Parameters**
+
+* **backend** – the backend used to run the job.
+* **job\_id** – a unique id in the context of the backend used to run the job.
+* **kwargs** – Any key value metadata to associate with this job.
+
+## Attributes
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### backend
+
+
+
+`backend()`
+
+Return the instance of the backend used for this job.
+
+### cancel
+
+
+
+`cancel()`
+
+Attempt to cancel the job.
+
+### cancelled
+
+
+
+`cancelled()`
+
+Return whether the job has been cancelled.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### done
+
+
+
+`done()`
+
+Return whether the job has successfully run.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### in\_final\_state
+
+
+
+`in_final_state()`
+
+Return whether the job is in a final job state such as `DONE` or `ERROR`.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### job\_id
+
+
+
+`job_id()`
+
+Return a unique id identifying the job.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### result
+
+
+
+`result(timeout=None)`
+
+Get job result .
+
+**Returns**
+
+Result object
+
+**Return type**
+
+[qiskit.result.Result](qiskit.result.Result "qiskit.result.Result")
+
+### running
+
+
+
+`running()`
+
+Return whether the job is actively running.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### status
+
+
+
+`status()`
+
+Gets the status of the job by querying the Python’s future
+
+**Returns**
+
+The current JobStatus
+
+**Return type**
+
+[qiskit.providers.JobStatus](qiskit.providers.JobStatus "qiskit.providers.JobStatus")
+
+### submit
+
+
+
+`submit()`
+
+Submit the job to the backend for execution.
+
+**Raises**
+
+[**JobError**](providers#qiskit.providers.JobError "qiskit.providers.JobError") – if trying to re-submit the job.
+
+### wait\_for\_final\_state
+
+
+
+`wait_for_final_state(timeout=None, wait=5, callback=None)`
+
+Poll the job status until it progresses to a final state such as `DONE` or `ERROR`.
+
+**Parameters**
+
+* **timeout** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – Seconds to wait for the job. If `None`, wait indefinitely.
+
+* **wait** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Seconds between queries.
+
+* **callback** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *| None*) –
+
+ Callback function invoked after each query. The following positional arguments are provided to the callback function:
+
+ * job\_id: Job ID
+ * job\_status: Status of the job from the last query
+ * job: This BaseJob instance
+
+ Note: different subclass might provide different arguments to the callback function.
+
+**Raises**
+
+[**JobTimeoutError**](providers#qiskit.providers.JobTimeoutError "qiskit.providers.JobTimeoutError") – If the job does not reach a final state before the specified timeout.
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.basic_provider.BasicSimulator.md b/docs/api/qiskit/0.46/qiskit.providers.basic_provider.BasicSimulator.md
new file mode 100644
index 00000000000..14de5eb5476
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.basic_provider.BasicSimulator.md
@@ -0,0 +1,413 @@
+---
+title: BasicSimulator
+description: API reference for qiskit.providers.basic_provider.BasicSimulator
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.basic_provider.BasicSimulator
+---
+
+# BasicSimulator
+
+
+
+`qiskit.providers.basic_provider.BasicSimulator(provider=None, target=None, **fields)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/basic_provider/basic_simulator.py "view source code")
+
+Bases: [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.backend.BackendV2")
+
+Python implementation of a basic (non-efficient) quantum simulator.
+
+**Parameters**
+
+* **provider** ([*Provider*](qiskit.providers.Provider "qiskit.providers.Provider") *| None*) – An optional backwards reference to the [`Provider`](qiskit.providers.Provider "qiskit.providers.Provider") object that the backend is from.
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target") *| None*) – An optional target to configure the simulator.
+* **fields** – kwargs for the values to use to override the default options.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If a field is specified that’s outside the backend’s options.
+
+## Attributes
+
+
+
+### MAX\_QUBITS\_MEMORY
+
+`= 24`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the output signal timestep
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.basic_provider.BasicSimulator.run "qiskit.providers.basic_provider.BasicSimulator.run") method.
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### configuration
+
+
+
+`configuration()`
+
+Return the simulator backend configuration.
+
+**Returns**
+
+The configuration for the backend.
+
+**Return type**
+
+[*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.backendconfiguration.BackendConfiguration")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **backend_options)`
+
+Run on the backend.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – payload of the experiment
+* **backend\_options** – backend options
+
+**Returns**
+
+derived from BaseJob
+
+**Return type**
+
+[BasicProviderJob](qiskit.providers.basic_provider.BasicProviderJob "qiskit.providers.basic_provider.BasicProviderJob")
+
+**Additional Information:**
+
+**backend\_options: Is a dict of options for the backend. It may contain**
+
+* “initial\_statevector”: vector\_like
+
+The “initial\_statevector” option specifies a custom initial initial statevector for the simulator to be used instead of the all zero state. This size of this vector must be correct for the number of qubits in `run_input` parameter.
+
+Example:
+
+```python
+backend_options = {
+ "initial_statevector": np.array([1, 0, 0, 1j]) / np.sqrt(2),
+}
+```
+
+### run\_experiment
+
+
+
+`run_experiment(experiment)`
+
+Run an experiment (circuit) and return a single experiment result.
+
+**Parameters**
+
+**experiment** ([*QasmQobjExperiment*](qiskit.qobj.QasmQobjExperiment "qiskit.qobj.qasm_qobj.QasmQobjExperiment")) – experiment from qobj experiments list
+
+**Returns**
+
+A result dictionary which looks something like:
+
+```python
+{
+"name": name of this experiment (obtained from qobj.experiment header)
+"seed": random seed used for simulation
+"shots": number of shots used in the simulation
+"data":
+ {
+ "counts": {'0x9: 5, ...},
+ "memory": ['0x9', '0xF', '0x1D', ..., '0x9']
+ },
+"status": status string for the simulation
+"success": boolean
+"time_taken": simulation time of this single experiment
+}
+```
+
+**Raises**
+
+[**BasicProviderError**](qiskit.providers.basic_provider.BasicProviderError "qiskit.providers.basic_provider.BasicProviderError") – if an error occurred.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)"), …]
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.basicaer.BasicAerError.md b/docs/api/qiskit/0.46/qiskit.providers.basicaer.BasicAerError.md
new file mode 100644
index 00000000000..0e74ac66148
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.basicaer.BasicAerError.md
@@ -0,0 +1,24 @@
+---
+title: BasicAerError
+description: API reference for qiskit.providers.basicaer.BasicAerError
+in_page_toc_min_heading_level: 1
+python_api_type: exception
+python_api_name: qiskit.providers.basicaer.BasicAerError
+---
+
+
+
+# qiskit.providers.basicaer.BasicAerError
+
+
+
+`qiskit.providers.basicaer.BasicAerError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/basicaer/exceptions.py "view source code")
+
+Base class for errors raised by Basic Aer.
+
+Set the error message.
+
+
+ The class `qiskit.providers.basicaer.exceptions.BasicAerError` is deprecated as of qiskit 0.46.0. It will be removed in Qiskit 1.0.0. The qiskit.providers.basicaer module has been superseded by qiskit.providers.basic\_provider. Use the new qiskit.providers.basic\_provider.BasicProviderError class instead.
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.basicaer.BasicAerJob.md b/docs/api/qiskit/0.46/qiskit.providers.basicaer.BasicAerJob.md
new file mode 100644
index 00000000000..f8372e79924
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.basicaer.BasicAerJob.md
@@ -0,0 +1,180 @@
+---
+title: BasicAerJob
+description: API reference for qiskit.providers.basicaer.BasicAerJob
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.basicaer.BasicAerJob
+---
+
+# BasicAerJob
+
+
+
+`qiskit.providers.basicaer.BasicAerJob(backend, job_id, result)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/basicaer/basicaerjob.py "view source code")
+
+Bases: [`JobV1`](qiskit.providers.JobV1 "qiskit.providers.job.JobV1")
+
+BasicAerJob class.
+
+
+ The class `qiskit.providers.basicaer.basicaerjob.BasicAerJob` is deprecated as of qiskit 0.46.0. It will be removed in Qiskit 1.0.0. The qiskit.providers.basicaer module has been superseded by qiskit.providers.basic\_provider, and all its classes have been renamed to follow a new naming convention. Use the new qiskit.providers.basic\_provider.BasicProviderJob class instead.
+
+
+## Attributes
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### backend
+
+
+
+`backend()`
+
+Return the instance of the backend used for this job.
+
+### cancel
+
+
+
+`cancel()`
+
+Attempt to cancel the job.
+
+### cancelled
+
+
+
+`cancelled()`
+
+Return whether the job has been cancelled.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### done
+
+
+
+`done()`
+
+Return whether the job has successfully run.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### in\_final\_state
+
+
+
+`in_final_state()`
+
+Return whether the job is in a final job state such as `DONE` or `ERROR`.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### job\_id
+
+
+
+`job_id()`
+
+Return a unique id identifying the job.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### result
+
+
+
+`result(timeout=None)`
+
+Get job result .
+
+**Returns**
+
+Result object
+
+**Return type**
+
+[qiskit.result.Result](qiskit.result.Result "qiskit.result.Result")
+
+### running
+
+
+
+`running()`
+
+Return whether the job is actively running.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### status
+
+
+
+`status()`
+
+Gets the status of the job by querying the Python’s future
+
+**Returns**
+
+The current JobStatus
+
+**Return type**
+
+[qiskit.providers.JobStatus](qiskit.providers.JobStatus "qiskit.providers.JobStatus")
+
+### submit
+
+
+
+`submit()`
+
+Submit the job to the backend for execution.
+
+**Raises**
+
+[**JobError**](providers#qiskit.providers.JobError "qiskit.providers.JobError") – if trying to re-submit the job.
+
+### wait\_for\_final\_state
+
+
+
+`wait_for_final_state(timeout=None, wait=5, callback=None)`
+
+Poll the job status until it progresses to a final state such as `DONE` or `ERROR`.
+
+**Parameters**
+
+* **timeout** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – Seconds to wait for the job. If `None`, wait indefinitely.
+
+* **wait** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Seconds between queries.
+
+* **callback** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *| None*) –
+
+ Callback function invoked after each query. The following positional arguments are provided to the callback function:
+
+ * job\_id: Job ID
+ * job\_status: Status of the job from the last query
+ * job: This BaseJob instance
+
+ Note: different subclass might provide different arguments to the callback function.
+
+**Raises**
+
+[**JobTimeoutError**](providers#qiskit.providers.JobTimeoutError "qiskit.providers.JobTimeoutError") – If the job does not reach a final state before the specified timeout.
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.basicaer.BasicAerProvider.md b/docs/api/qiskit/0.46/qiskit.providers.basicaer.BasicAerProvider.md
new file mode 100644
index 00000000000..1bdd93c0dd3
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.basicaer.BasicAerProvider.md
@@ -0,0 +1,80 @@
+---
+title: BasicAerProvider
+description: API reference for qiskit.providers.basicaer.BasicAerProvider
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.basicaer.BasicAerProvider
+---
+
+# BasicAerProvider
+
+
+
+`qiskit.providers.basicaer.BasicAerProvider`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/basicaer/basicaerprovider.py "view source code")
+
+Bases: [`ProviderV1`](qiskit.providers.ProviderV1 "qiskit.providers.provider.ProviderV1")
+
+Provider for Basic Aer backends.
+
+
+ The class `qiskit.providers.basicaer.basicaerprovider.BasicAerProvider` is deprecated as of qiskit 0.46.0. It will be removed in Qiskit 1.0.0. The qiskit.providers.basicaer module has been superseded by qiskit.providers.basic\_provider, and all its classes have been renamed to follow a new naming convention. Use the new qiskit.providers.basic\_provider.BasicProvider class instead.
+
+
+## Attributes
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### backends
+
+
+
+`backends(name=None, filters=None, **kwargs)`
+
+Return a list of backends matching the specified filtering.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name of the backend.
+* **\*\*kwargs** – dict used for filtering.
+
+**Returns**
+
+**a list of Backends that match the filtering**
+
+criteria.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[Backend](qiskit.providers.Backend "qiskit.providers.Backend")]
+
+### get\_backend
+
+
+
+`get_backend(name=None, **kwargs)`
+
+Return a single backend matching the specified filtering.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name of the backend.
+* **\*\*kwargs** – dict used for filtering.
+
+**Returns**
+
+a backend matching the filtering.
+
+**Return type**
+
+[Backend](qiskit.providers.Backend "qiskit.providers.Backend")
+
+**Raises**
+
+[**QiskitBackendNotFoundError**](providers#qiskit.providers.QiskitBackendNotFoundError "qiskit.providers.QiskitBackendNotFoundError") – if no backend could be found or more than one backend matches the filtering criteria.
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.basicaer.QasmSimulatorPy.md b/docs/api/qiskit/0.46/qiskit.providers.basicaer.QasmSimulatorPy.md
new file mode 100644
index 00000000000..6cf79e8f056
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.basicaer.QasmSimulatorPy.md
@@ -0,0 +1,243 @@
+---
+title: QasmSimulatorPy
+description: API reference for qiskit.providers.basicaer.QasmSimulatorPy
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.basicaer.QasmSimulatorPy
+---
+
+# QasmSimulatorPy
+
+
+
+`qiskit.providers.basicaer.QasmSimulatorPy(configuration=None, provider=None, **fields)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/basicaer/qasm_simulator.py "view source code")
+
+Bases: [`BackendV1`](qiskit.providers.BackendV1 "qiskit.providers.backend.BackendV1")
+
+Python implementation of an OpenQASM 2 simulator.
+
+
+ The class `qiskit.providers.basicaer.qasm_simulator.QasmSimulatorPy` is deprecated as of qiskit 0.46.0. It will be removed in Qiskit 1.0.0. The qiskit.providers.basicaer module has been superseded by qiskit.providers.basic\_provider. Use the new qiskit.providers.basic\_provider.BasicSimulator class instead.
+
+
+## Attributes
+
+
+
+### DEFAULT\_CONFIGURATION = \{'backend\_name'
+
+`= {'backend_name':`
+
+`= {'backend_name': 'qasm_simulator', 'backend_version': '2.1.0', 'basis_gates': ['h', 'u', 'p', 'u1', 'u2', 'u3', 'rz', 'sx', 'x', 'cx', 'id', 'unitary'], 'conditional': True, 'coupling_map': None, 'description': 'A python simulator for qasm experiments', 'gates': [{'name': 'h', 'parameters': [], 'qasm_def': 'gate h q { U(pi/2,0,pi) q; }'}, {'name': 'p', 'parameters': ['lambda'], 'qasm_def': 'gate p(lambda) q { U(0,0,lambda) q; }'}, {'name': 'u', 'parameters': ['theta', 'phi', 'lambda'], 'qasm_def': 'gate u(theta,phi,lambda) q { U(theta,phi,lambda) q; }'}, {'name': 'u1', 'parameters': ['lambda'], 'qasm_def': 'gate u1(lambda) q { U(0,0,lambda) q; }'}, {'name': 'u2', 'parameters': ['phi', 'lambda'], 'qasm_def': 'gate u2(phi,lambda) q { U(pi/2,phi,lambda) q; }'}, {'name': 'u3', 'parameters': ['theta', 'phi', 'lambda'], 'qasm_def': 'gate u3(theta,phi,lambda) q { U(theta,phi,lambda) q; }'}, {'name': 'rz', 'parameters': ['phi'], 'qasm_def': 'gate rz(phi) q { U(0,0,phi) q; }'}, {'name': 'sx', 'parameters': [], 'qasm_def': 'gate sx(phi) q { U(pi/2,7*pi/2,pi/2) q; }'}, {'name': 'x', 'parameters': [], 'qasm_def': 'gate x q { U(pi,7*pi/2,pi/2) q; }'}, {'name': 'cx', 'parameters': [], 'qasm_def': 'gate cx c,t { CX c,t; }'}, {'name': 'id', 'parameters': [], 'qasm_def': 'gate id a { U(0,0,0) a; }'}, {'name': 'unitary', 'parameters': ['matrix'], 'qasm_def': 'unitary(matrix) q1, q2,...'}], 'local': True, 'max_shots': 0, 'memory': True, 'n_qubits': 24, 'open_pulse': False, 'simulator': True, 'url': 'https://github.com/Qiskit/qiskit-terra'}`
+
+
+
+### DEFAULT\_OPTIONS = \{'chop\_threshold'
+
+`= {'chop_threshold':`
+
+`= {'chop_threshold': 1e-15, 'initial_statevector': None}`
+
+
+
+### MAX\_QUBITS\_MEMORY
+
+`= 29`
+
+
+
+### SHOW\_FINAL\_STATE
+
+`= False`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.basicaer.QasmSimulatorPy.run "qiskit.providers.basicaer.QasmSimulatorPy.run") method.
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Return the backend properties.
+
+**Returns**
+
+the configuration for the backend. If the backend does not support properties, it returns `None`.
+
+**Return type**
+
+[BackendProperties](qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties")
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **backend_options)`
+
+Run on the backend.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – payload of the experiment
+* **backend\_options** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – backend options
+
+**Returns**
+
+derived from BaseJob
+
+**Return type**
+
+[BasicAerJob](qiskit.providers.basicaer.BasicAerJob "qiskit.providers.basicaer.BasicAerJob")
+
+**Additional Information:**
+
+**backend\_options: Is a dict of options for the backend. It may contain**
+
+* “initial\_statevector”: vector\_like
+
+The “initial\_statevector” option specifies a custom initial initial statevector for the simulator to be used instead of the all zero state. This size of this vector must be correct for the number of qubits in `run_input` parameter.
+
+Example:
+
+```python
+backend_options = {
+ "initial_statevector": np.array([1, 0, 0, 1j]) / np.sqrt(2),
+}
+```
+
+### run\_experiment
+
+
+
+`run_experiment(experiment)`
+
+Run an experiment (circuit) and return a single experiment result.
+
+**Parameters**
+
+**experiment** ([*QasmQobjExperiment*](qiskit.qobj.QasmQobjExperiment "qiskit.qobj.QasmQobjExperiment")) – experiment from qobj experiments list
+
+**Returns**
+
+A result dictionary which looks something like:
+
+```python
+{
+"name": name of this experiment (obtained from qobj.experiment header)
+"seed": random seed used for simulation
+"shots": number of shots used in the simulation
+"data":
+ {
+ "counts": {'0x9: 5, ...},
+ "memory": ['0x9', '0xF', '0x1D', ..., '0x9']
+ },
+"status": status string for the simulation
+"success": boolean
+"time_taken": simulation time of this single experiment
+}
+```
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+**Raises**
+
+[**BasicAerError**](qiskit.providers.basicaer.BasicAerError "qiskit.providers.basicaer.BasicAerError") – if an error occurred.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.basicaer.StatevectorSimulatorPy.md b/docs/api/qiskit/0.46/qiskit.providers.basicaer.StatevectorSimulatorPy.md
new file mode 100644
index 00000000000..d1c39d8fbbf
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.basicaer.StatevectorSimulatorPy.md
@@ -0,0 +1,243 @@
+---
+title: StatevectorSimulatorPy
+description: API reference for qiskit.providers.basicaer.StatevectorSimulatorPy
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.basicaer.StatevectorSimulatorPy
+---
+
+# StatevectorSimulatorPy
+
+
+
+`qiskit.providers.basicaer.StatevectorSimulatorPy(configuration=None, provider=None, **fields)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/basicaer/statevector_simulator.py "view source code")
+
+Bases: [`QasmSimulatorPy`](qiskit.providers.basicaer.QasmSimulatorPy "qiskit.providers.basicaer.qasm_simulator.QasmSimulatorPy")
+
+Python statevector simulator.
+
+
+ The class `qiskit.providers.basicaer.statevector_simulator.StatevectorSimulatorPy` is deprecated as of qiskit 0.46.0. It will be removed in Qiskit 1.0.0. The qiskit.providers.basicaer module has been superseded by qiskit.providers.basic\_provider. The new module has no replacement for this class. Use the qiskit.quantum\_info.Statevector class instead.
+
+
+## Attributes
+
+
+
+### DEFAULT\_CONFIGURATION = \{'backend\_name'
+
+`= {'backend_name':`
+
+`= {'backend_name': 'statevector_simulator', 'backend_version': '1.1.0', 'basis_gates': ['u1', 'u2', 'u3', 'rz', 'sx', 'x', 'cx', 'id', 'unitary'], 'conditional': True, 'coupling_map': None, 'description': 'A Python statevector simulator for qobj files', 'gates': [{'name': 'u1', 'parameters': ['lambda'], 'qasm_def': 'gate u1(lambda) q { U(0,0,lambda) q; }'}, {'name': 'u2', 'parameters': ['phi', 'lambda'], 'qasm_def': 'gate u2(phi,lambda) q { U(pi/2,phi,lambda) q; }'}, {'name': 'u3', 'parameters': ['theta', 'phi', 'lambda'], 'qasm_def': 'gate u3(theta,phi,lambda) q { U(theta,phi,lambda) q; }'}, {'name': 'rz', 'parameters': ['phi'], 'qasm_def': 'gate rz(phi) q { U(0,0,phi) q; }'}, {'name': 'sx', 'parameters': [], 'qasm_def': 'gate sx(phi) q { U(pi/2,7*pi/2,pi/2) q; }'}, {'name': 'x', 'parameters': [], 'qasm_def': 'gate x q { U(pi,7*pi/2,pi/2) q; }'}, {'name': 'cx', 'parameters': [], 'qasm_def': 'gate cx c,t { CX c,t; }'}, {'name': 'id', 'parameters': [], 'qasm_def': 'gate id a { U(0,0,0) a; }'}, {'name': 'unitary', 'parameters': ['matrix'], 'qasm_def': 'unitary(matrix) q1, q2,...'}], 'local': True, 'max_shots': 0, 'memory': True, 'n_qubits': 24, 'open_pulse': False, 'simulator': True, 'url': 'https://github.com/Qiskit/qiskit-terra'}`
+
+
+
+### DEFAULT\_OPTIONS = \{'chop\_threshold'
+
+`= {'chop_threshold':`
+
+`= {'chop_threshold': 1e-15, 'initial_statevector': None}`
+
+
+
+### MAX\_QUBITS\_MEMORY
+
+`= 29`
+
+
+
+### SHOW\_FINAL\_STATE
+
+`= True`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.basicaer.StatevectorSimulatorPy.run "qiskit.providers.basicaer.StatevectorSimulatorPy.run") method.
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Return the backend properties.
+
+**Returns**
+
+the configuration for the backend. If the backend does not support properties, it returns `None`.
+
+**Return type**
+
+[BackendProperties](qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties")
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **backend_options)`
+
+Run on the backend.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – payload of the experiment
+* **backend\_options** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – backend options
+
+**Returns**
+
+derived from BaseJob
+
+**Return type**
+
+[BasicAerJob](qiskit.providers.basicaer.BasicAerJob "qiskit.providers.basicaer.BasicAerJob")
+
+**Additional Information:**
+
+**backend\_options: Is a dict of options for the backend. It may contain**
+
+* “initial\_statevector”: vector\_like
+
+The “initial\_statevector” option specifies a custom initial initial statevector for the simulator to be used instead of the all zero state. This size of this vector must be correct for the number of qubits in `run_input` parameter.
+
+Example:
+
+```python
+backend_options = {
+ "initial_statevector": np.array([1, 0, 0, 1j]) / np.sqrt(2),
+}
+```
+
+### run\_experiment
+
+
+
+`run_experiment(experiment)`
+
+Run an experiment (circuit) and return a single experiment result.
+
+**Parameters**
+
+**experiment** ([*QasmQobjExperiment*](qiskit.qobj.QasmQobjExperiment "qiskit.qobj.QasmQobjExperiment")) – experiment from qobj experiments list
+
+**Returns**
+
+A result dictionary which looks something like:
+
+```python
+{
+"name": name of this experiment (obtained from qobj.experiment header)
+"seed": random seed used for simulation
+"shots": number of shots used in the simulation
+"data":
+ {
+ "counts": {'0x9: 5, ...},
+ "memory": ['0x9', '0xF', '0x1D', ..., '0x9']
+ },
+"status": status string for the simulation
+"success": boolean
+"time_taken": simulation time of this single experiment
+}
+```
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+**Raises**
+
+[**BasicAerError**](qiskit.providers.basicaer.BasicAerError "qiskit.providers.basicaer.BasicAerError") – if an error occurred.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.basicaer.UnitarySimulatorPy.md b/docs/api/qiskit/0.46/qiskit.providers.basicaer.UnitarySimulatorPy.md
new file mode 100644
index 00000000000..6b81a8dfa67
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.basicaer.UnitarySimulatorPy.md
@@ -0,0 +1,252 @@
+---
+title: UnitarySimulatorPy
+description: API reference for qiskit.providers.basicaer.UnitarySimulatorPy
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.basicaer.UnitarySimulatorPy
+---
+
+# UnitarySimulatorPy
+
+
+
+`qiskit.providers.basicaer.UnitarySimulatorPy(configuration=None, provider=None, **fields)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/basicaer/unitary_simulator.py "view source code")
+
+Bases: [`BackendV1`](qiskit.providers.BackendV1 "qiskit.providers.backend.BackendV1")
+
+Python implementation of a unitary simulator.
+
+
+ The class `qiskit.providers.basicaer.unitary_simulator.UnitarySimulatorPy` is deprecated as of qiskit 0.46.0. It will be removed in Qiskit 1.0.0. The qiskit.providers.basicaer module has been superseded by qiskit.providers.basic\_provider. The new module has no replacement for this class. Use the qiskit.quantum\_info.Operator class instead.
+
+
+## Attributes
+
+
+
+### DEFAULT\_CONFIGURATION = \{'backend\_name'
+
+`= {'backend_name':`
+
+`= {'backend_name': 'unitary_simulator', 'backend_version': '1.1.0', 'basis_gates': ['u1', 'u2', 'u3', 'rz', 'sx', 'x', 'cx', 'id', 'unitary'], 'conditional': False, 'coupling_map': None, 'description': 'A python simulator for unitary matrix corresponding to a circuit', 'gates': [{'name': 'u1', 'parameters': ['lambda'], 'qasm_def': 'gate u1(lambda) q { U(0,0,lambda) q; }'}, {'name': 'u2', 'parameters': ['phi', 'lambda'], 'qasm_def': 'gate u2(phi,lambda) q { U(pi/2,phi,lambda) q; }'}, {'name': 'u3', 'parameters': ['theta', 'phi', 'lambda'], 'qasm_def': 'gate u3(theta,phi,lambda) q { U(theta,phi,lambda) q; }'}, {'name': 'rz', 'parameters': ['phi'], 'qasm_def': 'gate rz(phi) q { U(0,0,phi) q; }'}, {'name': 'sx', 'parameters': [], 'qasm_def': 'gate sx(phi) q { U(pi/2,7*pi/2,pi/2) q; }'}, {'name': 'x', 'parameters': [], 'qasm_def': 'gate x q { U(pi,7*pi/2,pi/2) q; }'}, {'name': 'cx', 'parameters': [], 'qasm_def': 'gate cx c,t { CX c,t; }'}, {'name': 'id', 'parameters': [], 'qasm_def': 'gate id a { U(0,0,0) a; }'}, {'name': 'unitary', 'parameters': ['matrix'], 'qasm_def': 'unitary(matrix) q1, q2,...'}], 'local': True, 'max_shots': 0, 'memory': False, 'n_qubits': 14, 'open_pulse': False, 'simulator': True, 'url': 'https://github.com/Qiskit/qiskit-terra'}`
+
+
+
+### DEFAULT\_OPTIONS = \{'chop\_threshold'
+
+`= {'chop_threshold':`
+
+`= {'chop_threshold': 1e-15, 'initial_unitary': None}`
+
+
+
+### MAX\_QUBITS\_MEMORY
+
+`= 14`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.basicaer.UnitarySimulatorPy.run "qiskit.providers.basicaer.UnitarySimulatorPy.run") method.
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Return the backend properties.
+
+**Returns**
+
+the configuration for the backend. If the backend does not support properties, it returns `None`.
+
+**Return type**
+
+[BackendProperties](qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties")
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **backend_options)`
+
+Run experiments in run\_input asynchronously.
+
+
+ Using a QasmQobj for the first argument to UnitarySimulatorPy.run() is deprecated as of qiskit 0.46.0. It will be removed no earlier than 3 months after the release date.
+
+
+**Parameters**
+
+* **run\_input** (*Qobj,* [*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*,* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – payload of the experiment
+* **backend\_options** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – backend options
+
+**Returns**
+
+derived from BaseJob
+
+**Return type**
+
+[BasicAerJob](qiskit.providers.basicaer.BasicAerJob "qiskit.providers.basicaer.BasicAerJob")
+
+Additional Information:
+
+```python
+backend_options: Is a dict of options for the backend. It may contain
+ * "initial_unitary": matrix_like
+ * "chop_threshold": double
+
+The "initial_unitary" option specifies a custom initial unitary
+matrix for the simulator to be used instead of the identity
+matrix. This size of this matrix must be correct for the number
+of qubits in all experiments in the run_input.
+
+The "chop_threshold" option specifies a truncation value for
+setting small values to zero in the output unitary. The default
+value is 1e-15.
+
+Example::
+
+ backend_options = {
+ "initial_unitary": np.array([[1, 0, 0, 0],
+ [0, 0, 0, 1],
+ [0, 0, 1, 0],
+ [0, 1, 0, 0]])
+ "chop_threshold": 1e-15
+ }
+```
+
+### run\_experiment
+
+
+
+`run_experiment(experiment)`
+
+Run an experiment (circuit) and return a single experiment result.
+
+**Parameters**
+
+**experiment** ([*QasmQobjExperiment*](qiskit.qobj.QasmQobjExperiment "qiskit.qobj.QasmQobjExperiment")) – experiment from qobj experiments list
+
+**Returns**
+
+A result dictionary which looks something like:
+
+```python
+{
+"name": name of this experiment (obtained from qobj.experiment header)
+"seed": random seed used for simulation
+"shots": number of shots used in the simulation
+"data":
+ {
+ "unitary": [[[0.0, 0.0], [1.0, 0.0]],
+ [[1.0, 0.0], [0.0, 0.0]]]
+ },
+"status": status string for the simulation
+"success": boolean
+"time taken": simulation time of this single experiment
+}
+```
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+**Raises**
+
+[**BasicAerError**](qiskit.providers.basicaer.BasicAerError "qiskit.providers.basicaer.BasicAerError") – if the number of qubits in the circuit is greater than 24. Note that the practical qubit limit is much lower than 24.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.convert_to_target.md b/docs/api/qiskit/0.46/qiskit.providers.convert_to_target.md
new file mode 100644
index 00000000000..4aa5d43ca88
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.convert_to_target.md
@@ -0,0 +1,26 @@
+---
+title: convert_to_target
+description: API reference for qiskit.providers.convert_to_target
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.providers.convert_to_target
+---
+
+
+
+# qiskit.providers.convert\_to\_target
+
+
+
+`qiskit.providers.convert_to_target(configuration, properties=None, defaults=None, custom_name_mapping=None, add_delay=False, filter_faulty=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/backend_compat.py "view source code")
+
+Uses configuration, properties and pulse defaults to construct and return Target class.
+
+In order to convert with a `defaults.instruction_schedule_map`, which has a custom calibration for an operation, the operation name must be in `configuration.basis_gates` and `custom_name_mapping` must be supplied for the operation. Otherwise, the operation will be dropped in the resulting `Target` object.
+
+That suggests it is recommended to add custom calibrations **after** creating a target with this function instead of adding them to `defaults` in advance. For example:
+
+```python
+target.add_instruction(custom_gate, {(0, 1): InstructionProperties(calibration=custom_sched)})
+```
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.ConfigurableFakeBackend.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.ConfigurableFakeBackend.md
new file mode 100644
index 00000000000..2b03224f790
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.ConfigurableFakeBackend.md
@@ -0,0 +1,164 @@
+---
+title: ConfigurableFakeBackend
+description: API reference for qiskit.providers.fake_provider.ConfigurableFakeBackend
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.ConfigurableFakeBackend
+---
+
+# ConfigurableFakeBackend
+
+
+
+`qiskit.providers.fake_provider.ConfigurableFakeBackend(name, n_qubits, version=None, coupling_map=None, basis_gates=None, qubit_t1=None, qubit_t2=None, qubit_frequency=None, qubit_readout_error=None, single_qubit_gates=None, dt=None, std=None, seed=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/utils/configurable_backend.py "view source code")
+
+Bases: [`FakeBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakeBackend "qiskit.providers.fake_provider.fake_backend.FakeBackend")
+
+Configurable backend.
+
+Creates backend based on provided configuration.
+
+
+ The class `qiskit.providers.fake_provider.utils.configurable_backend.ConfigurableFakeBackend` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. Use a suitable FakeBackend instead.
+
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Name of the backend.
+* **n\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of qubits in the backend.
+* **version** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Version of the fake backend.
+* **coupling\_map** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]] | None*) – Coupling map.
+* **basis\_gates** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*] | None*) – Basis gates of the backend.
+* **qubit\_t1** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – Longitudinal coherence times.
+* **qubit\_t2** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – Transverse coherence times.
+* **qubit\_frequency** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – Frequency of qubits.
+* **qubit\_readout\_error** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – Readout error of qubits.
+* **single\_qubit\_gates** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*] | None*) – List of single qubit gates for backend properties.
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – Discretization of the input time sequences.
+* **std** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – Standard deviation of the generated distributions.
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – Random seed.
+
+## Attributes
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.ConfigurableFakeBackend.run "qiskit.providers.fake_provider.ConfigurableFakeBackend.run") method.
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Return backend defaults.
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Return backend properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.Fake1Q.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.Fake1Q.md
new file mode 100644
index 00000000000..9ef881f6829
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.Fake1Q.md
@@ -0,0 +1,136 @@
+---
+title: Fake1Q
+description: API reference for qiskit.providers.fake_provider.Fake1Q
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.Fake1Q
+---
+
+# Fake1Q
+
+
+
+`qiskit.providers.fake_provider.Fake1Q`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/fake_1q.py "view source code")
+
+Bases: [`FakeBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakeBackend "qiskit.providers.fake_provider.fake_backend.FakeBackend")
+
+A fake 1Q backend.
+
+0
+
+## Attributes
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.Fake1Q.run "qiskit.providers.fake_provider.Fake1Q.run") method.
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Return backend properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAlmaden.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAlmaden.md
new file mode 100644
index 00000000000..1385b9c5aab
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAlmaden.md
@@ -0,0 +1,175 @@
+---
+title: FakeAlmaden
+description: API reference for qiskit.providers.fake_provider.FakeAlmaden
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeAlmaden
+---
+
+# FakeAlmaden
+
+
+
+`qiskit.providers.fake_provider.FakeAlmaden`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/almaden/fake_almaden.py "view source code")
+
+Bases: [`FakeQasmBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakeQasmBackend "qiskit.providers.fake_provider.fake_qasm_backend.FakeQasmBackend")
+
+A fake Almaden backend.
+
+```python
+00 ↔ 01 ↔ 02 ↔ 03 ↔ 04
+ ↕ ↕
+05 ↔ 06 ↔ 07 ↔ 08 ↔ 09
+ ↕ ↕ ↕
+10 ↔ 11 ↔ 12 ↔ 13 ↔ 14
+ ↕ ↕
+15 ↔ 16 ↔ 17 ↔ 18 ↔ 19
+```
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_almaden'`
+
+
+
+### conf\_filename
+
+`= 'conf_almaden.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/almaden'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeAlmaden.run "qiskit.providers.fake_provider.FakeAlmaden.run") method.
+
+
+
+### props\_filename
+
+`= 'props_almaden.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAlmadenV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAlmadenV2.md
new file mode 100644
index 00000000000..17f74a5a3f1
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAlmadenV2.md
@@ -0,0 +1,361 @@
+---
+title: FakeAlmadenV2
+description: API reference for qiskit.providers.fake_provider.FakeAlmadenV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeAlmadenV2
+---
+
+# FakeAlmadenV2
+
+
+
+`qiskit.providers.fake_provider.FakeAlmadenV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/almaden/fake_almaden.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake Almaden V2 backend.
+
+```python
+00 ↔ 01 ↔ 02 ↔ 03 ↔ 04
+ ↕ ↕
+05 ↔ 06 ↔ 07 ↔ 08 ↔ 09
+ ↕ ↕ ↕
+10 ↔ 11 ↔ 12 ↔ 13 ↔ 14
+ ↕ ↕
+15 ↔ 16 ↔ 17 ↔ 18 ↔ 19
+```
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_almaden'`
+
+
+
+### conf\_filename
+
+`= 'conf_almaden.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= None`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/almaden'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeAlmadenV2.run "qiskit.providers.fake_provider.FakeAlmadenV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_almaden.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeArmonk.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeArmonk.md
new file mode 100644
index 00000000000..70431733e45
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeArmonk.md
@@ -0,0 +1,183 @@
+---
+title: FakeArmonk
+description: API reference for qiskit.providers.fake_provider.FakeArmonk
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeArmonk
+---
+
+# FakeArmonk
+
+
+
+`qiskit.providers.fake_provider.FakeArmonk`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/armonk/fake_armonk.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake 1 qubit backend.
+
+```python
+0
+```
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_armonk'`
+
+
+
+### conf\_filename
+
+`= 'conf_armonk.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_armonk.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/armonk'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeArmonk.run "qiskit.providers.fake_provider.FakeArmonk.run") method.
+
+
+
+### props\_filename
+
+`= 'props_armonk.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeArmonkV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeArmonkV2.md
new file mode 100644
index 00000000000..1f44ae9d5d9
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeArmonkV2.md
@@ -0,0 +1,355 @@
+---
+title: FakeArmonkV2
+description: API reference for qiskit.providers.fake_provider.FakeArmonkV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeArmonkV2
+---
+
+# FakeArmonkV2
+
+
+
+`qiskit.providers.fake_provider.FakeArmonkV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/armonk/fake_armonk.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 1 qubit backend.
+
+```python
+0
+```
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_armonk'`
+
+
+
+### conf\_filename
+
+`= 'conf_armonk.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_armonk.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/armonk'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeArmonkV2.run "qiskit.providers.fake_provider.FakeArmonkV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_armonk.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAthens.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAthens.md
new file mode 100644
index 00000000000..59d36f40174
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAthens.md
@@ -0,0 +1,179 @@
+---
+title: FakeAthens
+description: API reference for qiskit.providers.fake_provider.FakeAthens
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeAthens
+---
+
+# FakeAthens
+
+
+
+`qiskit.providers.fake_provider.FakeAthens`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/athens/fake_athens.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake 5 qubit backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_athens'`
+
+
+
+### conf\_filename
+
+`= 'conf_athens.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_athens.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/athens'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeAthens.run "qiskit.providers.fake_provider.FakeAthens.run") method.
+
+
+
+### props\_filename
+
+`= 'props_athens.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAthensV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAthensV2.md
new file mode 100644
index 00000000000..964b921ba2f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAthensV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeAthensV2
+description: API reference for qiskit.providers.fake_provider.FakeAthensV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeAthensV2
+---
+
+# FakeAthensV2
+
+
+
+`qiskit.providers.fake_provider.FakeAthensV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/athens/fake_athens.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 5 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_athens'`
+
+
+
+### conf\_filename
+
+`= 'conf_athens.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_athens.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/athens'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeAthensV2.run "qiskit.providers.fake_provider.FakeAthensV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_athens.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAuckland.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAuckland.md
new file mode 100644
index 00000000000..1e13aa93a2b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeAuckland.md
@@ -0,0 +1,351 @@
+---
+title: FakeAuckland
+description: API reference for qiskit.providers.fake_provider.FakeAuckland
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeAuckland
+---
+
+# FakeAuckland
+
+
+
+`qiskit.providers.fake_provider.FakeAuckland`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/auckland/fake_auckland.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 27 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_auckland'`
+
+
+
+### conf\_filename
+
+`= 'conf_auckland.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_auckland.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/auckland'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeAuckland.run "qiskit.providers.fake_provider.FakeAuckland.run") method.
+
+
+
+### props\_filename
+
+`= 'props_auckland.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBackend5QV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBackend5QV2.md
new file mode 100644
index 00000000000..93692e95f3d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBackend5QV2.md
@@ -0,0 +1,331 @@
+---
+title: FakeBackend5QV2
+description: API reference for qiskit.providers.fake_provider.FakeBackend5QV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeBackend5QV2
+---
+
+# FakeBackend5QV2
+
+
+
+`qiskit.providers.fake_provider.FakeBackend5QV2(bidirectional=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/fake_backend_v2.py "view source code")
+
+Bases: [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.backend.BackendV2")
+
+A mock backend that doesn’t implement run() to test compatibility with Terra internals.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend_v2.FakeBackend5QV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. Use the qiskit.providers.basic\_provider.GenericBackendV2 class instead.
+
+
+## Attributes
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the output signal timestep
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeBackend5QV2.run "qiskit.providers.fake_provider.FakeBackend5QV2.run") method.
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the backend.
+
+This method returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object that runs circuits. Depending on the backend this may be either an async or sync call. It is at the discretion of the provider to decide whether running should block until the execution is finished or not: the Job class can handle either situation.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBackendV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBackendV2.md
new file mode 100644
index 00000000000..90dd892bc01
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBackendV2.md
@@ -0,0 +1,331 @@
+---
+title: FakeBackendV2
+description: API reference for qiskit.providers.fake_provider.FakeBackendV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeBackendV2
+---
+
+# FakeBackendV2
+
+
+
+`qiskit.providers.fake_provider.FakeBackendV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/fake_backend_v2.py "view source code")
+
+Bases: [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.backend.BackendV2")
+
+A mock backend that doesn’t implement run() to test compatibility with Terra internals.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend_v2.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. Use the qiskit.providers.basic\_provider.GenericBackendV2 class instead.
+
+
+## Attributes
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the output signal timestep
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeBackendV2.run "qiskit.providers.fake_provider.FakeBackendV2.run") method.
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the backend.
+
+This method returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object that runs circuits. Depending on the backend this may be either an async or sync call. It is at the discretion of the provider to decide whether running should block until the execution is finished or not: the Job class can handle either situation.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBelem.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBelem.md
new file mode 100644
index 00000000000..9e078dab5cd
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBelem.md
@@ -0,0 +1,179 @@
+---
+title: FakeBelem
+description: API reference for qiskit.providers.fake_provider.FakeBelem
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeBelem
+---
+
+# FakeBelem
+
+
+
+`qiskit.providers.fake_provider.FakeBelem`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/belem/fake_belem.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake 5 qubit backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_belem'`
+
+
+
+### conf\_filename
+
+`= 'conf_belem.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_belem.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/belem'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeBelem.run "qiskit.providers.fake_provider.FakeBelem.run") method.
+
+
+
+### props\_filename
+
+`= 'props_belem.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBelemV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBelemV2.md
new file mode 100644
index 00000000000..698ed317683
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBelemV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeBelemV2
+description: API reference for qiskit.providers.fake_provider.FakeBelemV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeBelemV2
+---
+
+# FakeBelemV2
+
+
+
+`qiskit.providers.fake_provider.FakeBelemV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/belem/fake_belem.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 5 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_belem'`
+
+
+
+### conf\_filename
+
+`= 'conf_belem.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_belem.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/belem'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeBelemV2.run "qiskit.providers.fake_provider.FakeBelemV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_belem.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBoeblingen.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBoeblingen.md
new file mode 100644
index 00000000000..cc48009f431
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBoeblingen.md
@@ -0,0 +1,189 @@
+---
+title: FakeBoeblingen
+description: API reference for qiskit.providers.fake_provider.FakeBoeblingen
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeBoeblingen
+---
+
+# FakeBoeblingen
+
+
+
+`qiskit.providers.fake_provider.FakeBoeblingen`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/boeblingen/fake_boeblingen.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake Boeblingen backend.
+
+```python
+00 ↔ 01 ↔ 02 ↔ 03 ↔ 04
+ ↕ ↕
+05 ↔ 06 ↔ 07 ↔ 08 ↔ 09
+ ↕ ↕ ↕
+10 ↔ 11 ↔ 12 ↔ 13 ↔ 14
+ ↕ ↕
+15 ↔ 16 ↔ 17 ↔ 18 ↔ 19
+```
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_boeblingen'`
+
+
+
+### conf\_filename
+
+`= 'conf_boeblingen.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_boeblingen.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/boeblingen'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeBoeblingen.run "qiskit.providers.fake_provider.FakeBoeblingen.run") method.
+
+
+
+### props\_filename
+
+`= 'props_boeblingen.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBoeblingenV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBoeblingenV2.md
new file mode 100644
index 00000000000..a48f4755d12
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBoeblingenV2.md
@@ -0,0 +1,361 @@
+---
+title: FakeBoeblingenV2
+description: API reference for qiskit.providers.fake_provider.FakeBoeblingenV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeBoeblingenV2
+---
+
+# FakeBoeblingenV2
+
+
+
+`qiskit.providers.fake_provider.FakeBoeblingenV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/boeblingen/fake_boeblingen.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake Boeblingen V2 backend.
+
+```python
+00 ↔ 01 ↔ 02 ↔ 03 ↔ 04
+ ↕ ↕
+05 ↔ 06 ↔ 07 ↔ 08 ↔ 09
+ ↕ ↕ ↕
+10 ↔ 11 ↔ 12 ↔ 13 ↔ 14
+ ↕ ↕
+15 ↔ 16 ↔ 17 ↔ 18 ↔ 19
+```
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_boeblingen'`
+
+
+
+### conf\_filename
+
+`= 'conf_boeblingen.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_boeblingen.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/boeblingen'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeBoeblingenV2.run "qiskit.providers.fake_provider.FakeBoeblingenV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_boeblingen.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBogota.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBogota.md
new file mode 100644
index 00000000000..6ff305d3757
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBogota.md
@@ -0,0 +1,179 @@
+---
+title: FakeBogota
+description: API reference for qiskit.providers.fake_provider.FakeBogota
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeBogota
+---
+
+# FakeBogota
+
+
+
+`qiskit.providers.fake_provider.FakeBogota`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/bogota/fake_bogota.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake 5 qubit backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_bogota'`
+
+
+
+### conf\_filename
+
+`= 'conf_bogota.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_bogota.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/bogota'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeBogota.run "qiskit.providers.fake_provider.FakeBogota.run") method.
+
+
+
+### props\_filename
+
+`= 'props_bogota.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBogotaV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBogotaV2.md
new file mode 100644
index 00000000000..4eac6b1bd8a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBogotaV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeBogotaV2
+description: API reference for qiskit.providers.fake_provider.FakeBogotaV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeBogotaV2
+---
+
+# FakeBogotaV2
+
+
+
+`qiskit.providers.fake_provider.FakeBogotaV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/bogota/fake_bogota.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 5 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_bogota'`
+
+
+
+### conf\_filename
+
+`= 'conf_bogota.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_bogota.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/bogota'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeBogotaV2.run "qiskit.providers.fake_provider.FakeBogotaV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_bogota.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBrooklyn.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBrooklyn.md
new file mode 100644
index 00000000000..2daad89ac54
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBrooklyn.md
@@ -0,0 +1,179 @@
+---
+title: FakeBrooklyn
+description: API reference for qiskit.providers.fake_provider.FakeBrooklyn
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeBrooklyn
+---
+
+# FakeBrooklyn
+
+
+
+`qiskit.providers.fake_provider.FakeBrooklyn`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/brooklyn/fake_brooklyn.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake Brooklyn backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_brooklyn'`
+
+
+
+### conf\_filename
+
+`= 'conf_brooklyn.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_brooklyn.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/brooklyn'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeBrooklyn.run "qiskit.providers.fake_provider.FakeBrooklyn.run") method.
+
+
+
+### props\_filename
+
+`= 'props_brooklyn.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBrooklynV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBrooklynV2.md
new file mode 100644
index 00000000000..a1361bfdc70
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBrooklynV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeBrooklynV2
+description: API reference for qiskit.providers.fake_provider.FakeBrooklynV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeBrooklynV2
+---
+
+# FakeBrooklynV2
+
+
+
+`qiskit.providers.fake_provider.FakeBrooklynV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/brooklyn/fake_brooklyn.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake Brooklyn V2 backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_brooklyn'`
+
+
+
+### conf\_filename
+
+`= 'conf_brooklyn.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_brooklyn.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/brooklyn'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeBrooklynV2.run "qiskit.providers.fake_provider.FakeBrooklynV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_brooklyn.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBurlington.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBurlington.md
new file mode 100644
index 00000000000..c25f28d6cff
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBurlington.md
@@ -0,0 +1,171 @@
+---
+title: FakeBurlington
+description: API reference for qiskit.providers.fake_provider.FakeBurlington
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeBurlington
+---
+
+# FakeBurlington
+
+
+
+`qiskit.providers.fake_provider.FakeBurlington`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/burlington/fake_burlington.py "view source code")
+
+Bases: [`FakeQasmBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakeQasmBackend "qiskit.providers.fake_provider.fake_qasm_backend.FakeQasmBackend")
+
+A fake 5 qubit backend.
+
+```python
+0 ↔ 1 ↔ 3 ↔ 4
+ ↕
+ 2
+```
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_burlington'`
+
+
+
+### conf\_filename
+
+`= 'conf_burlington.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/burlington'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeBurlington.run "qiskit.providers.fake_provider.FakeBurlington.run") method.
+
+
+
+### props\_filename
+
+`= 'props_burlington.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBurlingtonV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBurlingtonV2.md
new file mode 100644
index 00000000000..0430794cfdf
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeBurlingtonV2.md
@@ -0,0 +1,357 @@
+---
+title: FakeBurlingtonV2
+description: API reference for qiskit.providers.fake_provider.FakeBurlingtonV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeBurlingtonV2
+---
+
+# FakeBurlingtonV2
+
+
+
+`qiskit.providers.fake_provider.FakeBurlingtonV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/burlington/fake_burlington.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 5 qubit backend.
+
+```python
+0 ↔ 1 ↔ 3 ↔ 4
+ ↕
+ 2
+```
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_burlington'`
+
+
+
+### conf\_filename
+
+`= 'conf_burlington.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= None`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/burlington'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeBurlingtonV2.run "qiskit.providers.fake_provider.FakeBurlingtonV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_burlington.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCairo.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCairo.md
new file mode 100644
index 00000000000..bd142ad5068
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCairo.md
@@ -0,0 +1,179 @@
+---
+title: FakeCairo
+description: API reference for qiskit.providers.fake_provider.FakeCairo
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeCairo
+---
+
+# FakeCairo
+
+
+
+`qiskit.providers.fake_provider.FakeCairo`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/cairo/fake_cairo.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake 27 qubit backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_cairo'`
+
+
+
+### conf\_filename
+
+`= 'conf_cairo.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_cairo.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/cairo'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeCairo.run "qiskit.providers.fake_provider.FakeCairo.run") method.
+
+
+
+### props\_filename
+
+`= 'props_cairo.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCairoV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCairoV2.md
new file mode 100644
index 00000000000..36a4d8d5069
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCairoV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeCairoV2
+description: API reference for qiskit.providers.fake_provider.FakeCairoV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeCairoV2
+---
+
+# FakeCairoV2
+
+
+
+`qiskit.providers.fake_provider.FakeCairoV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/cairo/fake_cairo.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 27 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_cairo'`
+
+
+
+### conf\_filename
+
+`= 'conf_cairo.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_cairo.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/cairo'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeCairoV2.run "qiskit.providers.fake_provider.FakeCairoV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_cairo.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCambridge.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCambridge.md
new file mode 100644
index 00000000000..5640ec9a5f9
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCambridge.md
@@ -0,0 +1,177 @@
+---
+title: FakeCambridge
+description: API reference for qiskit.providers.fake_provider.FakeCambridge
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeCambridge
+---
+
+# FakeCambridge
+
+
+
+`qiskit.providers.fake_provider.FakeCambridge`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/cambridge/fake_cambridge.py "view source code")
+
+Bases: [`FakeQasmBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakeQasmBackend "qiskit.providers.fake_provider.fake_qasm_backend.FakeQasmBackend")
+
+A fake Cambridge backend.
+
+```python
+ 00 ↔ 01 ↔ 02 ↔ 03 ↔ 04
+ ↕ ↕
+ 05 06
+ ↕ ↕
+07 ↔ 08 ↔ 09 ↔ 10 ↔ 11 ↔ 12 ↔ 13 ↔ 14 ↔ 15
+↕ ↕ ↕
+16 17 18
+↕ ↕ ↕
+19 ↔ 20 ↔ 21 ↔ 22 ↔ 23 ↔ 24 ↔ 25 ↔ 26 ↔ 27
+```
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_cambridge'`
+
+
+
+### conf\_filename
+
+`= 'conf_cambridge.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/cambridge'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeCambridge.run "qiskit.providers.fake_provider.FakeCambridge.run") method.
+
+
+
+### props\_filename
+
+`= 'props_cambridge.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCambridgeV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCambridgeV2.md
new file mode 100644
index 00000000000..c0ab5a7d81b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCambridgeV2.md
@@ -0,0 +1,363 @@
+---
+title: FakeCambridgeV2
+description: API reference for qiskit.providers.fake_provider.FakeCambridgeV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeCambridgeV2
+---
+
+# FakeCambridgeV2
+
+
+
+`qiskit.providers.fake_provider.FakeCambridgeV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/cambridge/fake_cambridge.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake Cambridge backend.
+
+```python
+ 00 ↔ 01 ↔ 02 ↔ 03 ↔ 04
+ ↕ ↕
+ 05 06
+ ↕ ↕
+07 ↔ 08 ↔ 09 ↔ 10 ↔ 11 ↔ 12 ↔ 13 ↔ 14 ↔ 15
+↕ ↕ ↕
+16 17 18
+↕ ↕ ↕
+19 ↔ 20 ↔ 21 ↔ 22 ↔ 23 ↔ 24 ↔ 25 ↔ 26 ↔ 27
+```
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_cambridge'`
+
+
+
+### conf\_filename
+
+`= 'conf_cambridge.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= None`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/cambridge'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeCambridgeV2.run "qiskit.providers.fake_provider.FakeCambridgeV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_cambridge.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCasablanca.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCasablanca.md
new file mode 100644
index 00000000000..d80410150a7
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCasablanca.md
@@ -0,0 +1,179 @@
+---
+title: FakeCasablanca
+description: API reference for qiskit.providers.fake_provider.FakeCasablanca
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeCasablanca
+---
+
+# FakeCasablanca
+
+
+
+`qiskit.providers.fake_provider.FakeCasablanca`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/casablanca/fake_casablanca.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake 7 qubit backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_casablanca'`
+
+
+
+### conf\_filename
+
+`= 'conf_casablanca.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_casablanca.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/casablanca'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeCasablanca.run "qiskit.providers.fake_provider.FakeCasablanca.run") method.
+
+
+
+### props\_filename
+
+`= 'props_casablanca.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCasablancaV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCasablancaV2.md
new file mode 100644
index 00000000000..58025f7fd6e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeCasablancaV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeCasablancaV2
+description: API reference for qiskit.providers.fake_provider.FakeCasablancaV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeCasablancaV2
+---
+
+# FakeCasablancaV2
+
+
+
+`qiskit.providers.fake_provider.FakeCasablancaV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/casablanca/fake_casablanca.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 7 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_casablanca'`
+
+
+
+### conf\_filename
+
+`= 'conf_casablanca.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_casablanca.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/casablanca'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeCasablancaV2.run "qiskit.providers.fake_provider.FakeCasablancaV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_casablanca.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeEssex.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeEssex.md
new file mode 100644
index 00000000000..21fa2f931f9
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeEssex.md
@@ -0,0 +1,173 @@
+---
+title: FakeEssex
+description: API reference for qiskit.providers.fake_provider.FakeEssex
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeEssex
+---
+
+# FakeEssex
+
+
+
+`qiskit.providers.fake_provider.FakeEssex`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/essex/fake_essex.py "view source code")
+
+Bases: [`FakeQasmBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakeQasmBackend "qiskit.providers.fake_provider.fake_qasm_backend.FakeQasmBackend")
+
+A fake 5 qubit backend.
+
+```python
+0 ↔ 1 ↔ 2
+ ↕
+ 3
+ ↕
+ 4
+```
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_essex'`
+
+
+
+### conf\_filename
+
+`= 'conf_essex.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/essex'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeEssex.run "qiskit.providers.fake_provider.FakeEssex.run") method.
+
+
+
+### props\_filename
+
+`= 'props_essex.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeEssexV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeEssexV2.md
new file mode 100644
index 00000000000..a9438bad9a8
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeEssexV2.md
@@ -0,0 +1,359 @@
+---
+title: FakeEssexV2
+description: API reference for qiskit.providers.fake_provider.FakeEssexV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeEssexV2
+---
+
+# FakeEssexV2
+
+
+
+`qiskit.providers.fake_provider.FakeEssexV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/essex/fake_essex.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 5 qubit backend.
+
+```python
+0 ↔ 1 ↔ 2
+ ↕
+ 3
+ ↕
+ 4
+```
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_essex'`
+
+
+
+### conf\_filename
+
+`= 'conf_essex.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= None`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/essex'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeEssexV2.run "qiskit.providers.fake_provider.FakeEssexV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_essex.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeGeneva.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeGeneva.md
new file mode 100644
index 00000000000..980ec95e6b4
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeGeneva.md
@@ -0,0 +1,351 @@
+---
+title: FakeGeneva
+description: API reference for qiskit.providers.fake_provider.FakeGeneva
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeGeneva
+---
+
+# FakeGeneva
+
+
+
+`qiskit.providers.fake_provider.FakeGeneva`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/geneva/fake_geneva.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 27 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_geneva'`
+
+
+
+### conf\_filename
+
+`= 'conf_geneva.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_geneva.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/geneva'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeGeneva.run "qiskit.providers.fake_provider.FakeGeneva.run") method.
+
+
+
+### props\_filename
+
+`= 'props_geneva.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeGuadalupe.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeGuadalupe.md
new file mode 100644
index 00000000000..130768b8213
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeGuadalupe.md
@@ -0,0 +1,179 @@
+---
+title: FakeGuadalupe
+description: API reference for qiskit.providers.fake_provider.FakeGuadalupe
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeGuadalupe
+---
+
+# FakeGuadalupe
+
+
+
+`qiskit.providers.fake_provider.FakeGuadalupe`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/guadalupe/fake_guadalupe.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake 16 qubit backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_guadalupe'`
+
+
+
+### conf\_filename
+
+`= 'conf_guadalupe.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_guadalupe.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/guadalupe'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeGuadalupe.run "qiskit.providers.fake_provider.FakeGuadalupe.run") method.
+
+
+
+### props\_filename
+
+`= 'props_guadalupe.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeGuadalupeV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeGuadalupeV2.md
new file mode 100644
index 00000000000..33b4015eb5f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeGuadalupeV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeGuadalupeV2
+description: API reference for qiskit.providers.fake_provider.FakeGuadalupeV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeGuadalupeV2
+---
+
+# FakeGuadalupeV2
+
+
+
+`qiskit.providers.fake_provider.FakeGuadalupeV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/guadalupe/fake_guadalupe.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 16 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_guadalupe'`
+
+
+
+### conf\_filename
+
+`= 'conf_guadalupe.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_guadalupe.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/guadalupe'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeGuadalupeV2.run "qiskit.providers.fake_provider.FakeGuadalupeV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_guadalupe.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeHanoi.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeHanoi.md
new file mode 100644
index 00000000000..9d90f359eb3
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeHanoi.md
@@ -0,0 +1,179 @@
+---
+title: FakeHanoi
+description: API reference for qiskit.providers.fake_provider.FakeHanoi
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeHanoi
+---
+
+# FakeHanoi
+
+
+
+`qiskit.providers.fake_provider.FakeHanoi`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/hanoi/fake_hanoi.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake 27 qubit backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_hanoi'`
+
+
+
+### conf\_filename
+
+`= 'conf_hanoi.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_hanoi.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/hanoi'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeHanoi.run "qiskit.providers.fake_provider.FakeHanoi.run") method.
+
+
+
+### props\_filename
+
+`= 'props_hanoi.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeHanoiV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeHanoiV2.md
new file mode 100644
index 00000000000..539551b2173
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeHanoiV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeHanoiV2
+description: API reference for qiskit.providers.fake_provider.FakeHanoiV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeHanoiV2
+---
+
+# FakeHanoiV2
+
+
+
+`qiskit.providers.fake_provider.FakeHanoiV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/hanoi/fake_hanoi.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 27 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_hanoi'`
+
+
+
+### conf\_filename
+
+`= 'conf_hanoi.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_hanoi.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/hanoi'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeHanoiV2.run "qiskit.providers.fake_provider.FakeHanoiV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_hanoi.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeJakarta.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeJakarta.md
new file mode 100644
index 00000000000..420185985bc
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeJakarta.md
@@ -0,0 +1,179 @@
+---
+title: FakeJakarta
+description: API reference for qiskit.providers.fake_provider.FakeJakarta
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeJakarta
+---
+
+# FakeJakarta
+
+
+
+`qiskit.providers.fake_provider.FakeJakarta`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/jakarta/fake_jakarta.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake 7 qubit backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_jakarta'`
+
+
+
+### conf\_filename
+
+`= 'conf_jakarta.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_jakarta.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/jakarta'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeJakarta.run "qiskit.providers.fake_provider.FakeJakarta.run") method.
+
+
+
+### props\_filename
+
+`= 'props_jakarta.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeJakartaV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeJakartaV2.md
new file mode 100644
index 00000000000..0729c1f5e2d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeJakartaV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeJakartaV2
+description: API reference for qiskit.providers.fake_provider.FakeJakartaV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeJakartaV2
+---
+
+# FakeJakartaV2
+
+
+
+`qiskit.providers.fake_provider.FakeJakartaV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/jakarta/fake_jakarta.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 7 qubit V2 backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_jakarta'`
+
+
+
+### conf\_filename
+
+`= 'conf_jakarta.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_jakarta.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/jakarta'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeJakartaV2.run "qiskit.providers.fake_provider.FakeJakartaV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_jakarta.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeJohannesburg.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeJohannesburg.md
new file mode 100644
index 00000000000..7fb9dc3027a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeJohannesburg.md
@@ -0,0 +1,175 @@
+---
+title: FakeJohannesburg
+description: API reference for qiskit.providers.fake_provider.FakeJohannesburg
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeJohannesburg
+---
+
+# FakeJohannesburg
+
+
+
+`qiskit.providers.fake_provider.FakeJohannesburg`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/johannesburg/fake_johannesburg.py "view source code")
+
+Bases: [`FakeQasmBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakeQasmBackend "qiskit.providers.fake_provider.fake_qasm_backend.FakeQasmBackend")
+
+A fake Johannesburg backend.
+
+```python
+00 ↔ 01 ↔ 02 ↔ 03 ↔ 04
+ ↕ ↕
+05 ↔ 06 ↔ 07 ↔ 08 ↔ 09
+ ↕ ↕ ↕
+10 ↔ 11 ↔ 12 ↔ 13 ↔ 14
+ ↕ ↕
+15 ↔ 16 ↔ 17 ↔ 18 ↔ 19
+```
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_johannesburg'`
+
+
+
+### conf\_filename
+
+`= 'conf_johannesburg.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/johannesburg'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeJohannesburg.run "qiskit.providers.fake_provider.FakeJohannesburg.run") method.
+
+
+
+### props\_filename
+
+`= 'props_johannesburg.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeJohannesburgV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeJohannesburgV2.md
new file mode 100644
index 00000000000..dc7d1d3b773
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeJohannesburgV2.md
@@ -0,0 +1,361 @@
+---
+title: FakeJohannesburgV2
+description: API reference for qiskit.providers.fake_provider.FakeJohannesburgV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeJohannesburgV2
+---
+
+# FakeJohannesburgV2
+
+
+
+`qiskit.providers.fake_provider.FakeJohannesburgV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/johannesburg/fake_johannesburg.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake Johannesburg V2 backend.
+
+```python
+00 ↔ 01 ↔ 02 ↔ 03 ↔ 04
+ ↕ ↕
+05 ↔ 06 ↔ 07 ↔ 08 ↔ 09
+ ↕ ↕ ↕
+10 ↔ 11 ↔ 12 ↔ 13 ↔ 14
+ ↕ ↕
+15 ↔ 16 ↔ 17 ↔ 18 ↔ 19
+```
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_johannesburg'`
+
+
+
+### conf\_filename
+
+`= 'conf_johannesburg.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= None`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/johannesburg'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeJohannesburgV2.run "qiskit.providers.fake_provider.FakeJohannesburgV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_johannesburg.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeKolkata.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeKolkata.md
new file mode 100644
index 00000000000..f3e357bc796
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeKolkata.md
@@ -0,0 +1,179 @@
+---
+title: FakeKolkata
+description: API reference for qiskit.providers.fake_provider.FakeKolkata
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeKolkata
+---
+
+# FakeKolkata
+
+
+
+`qiskit.providers.fake_provider.FakeKolkata`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/kolkata/fake_kolkata.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake 27 qubit backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_kolkata'`
+
+
+
+### conf\_filename
+
+`= 'conf_kolkata.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_kolkata.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/kolkata'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeKolkata.run "qiskit.providers.fake_provider.FakeKolkata.run") method.
+
+
+
+### props\_filename
+
+`= 'props_kolkata.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeKolkataV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeKolkataV2.md
new file mode 100644
index 00000000000..42593e480b5
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeKolkataV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeKolkataV2
+description: API reference for qiskit.providers.fake_provider.FakeKolkataV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeKolkataV2
+---
+
+# FakeKolkataV2
+
+
+
+`qiskit.providers.fake_provider.FakeKolkataV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/kolkata/fake_kolkata.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 27 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_kolkata'`
+
+
+
+### conf\_filename
+
+`= 'conf_kolkata.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_kolkata.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/kolkata'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeKolkataV2.run "qiskit.providers.fake_provider.FakeKolkataV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_kolkata.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLagos.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLagos.md
new file mode 100644
index 00000000000..f729a96ed89
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLagos.md
@@ -0,0 +1,179 @@
+---
+title: FakeLagos
+description: API reference for qiskit.providers.fake_provider.FakeLagos
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeLagos
+---
+
+# FakeLagos
+
+
+
+`qiskit.providers.fake_provider.FakeLagos`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/lagos/fake_lagos.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake 7 qubit backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_lagos'`
+
+
+
+### conf\_filename
+
+`= 'conf_lagos.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_lagos.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/lagos'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeLagos.run "qiskit.providers.fake_provider.FakeLagos.run") method.
+
+
+
+### props\_filename
+
+`= 'props_lagos.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLagosV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLagosV2.md
new file mode 100644
index 00000000000..bdb89acb1be
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLagosV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeLagosV2
+description: API reference for qiskit.providers.fake_provider.FakeLagosV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeLagosV2
+---
+
+# FakeLagosV2
+
+
+
+`qiskit.providers.fake_provider.FakeLagosV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/lagos/fake_lagos.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 7 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_lagos'`
+
+
+
+### conf\_filename
+
+`= 'conf_lagos.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_lagos.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/lagos'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeLagosV2.run "qiskit.providers.fake_provider.FakeLagosV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_lagos.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLima.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLima.md
new file mode 100644
index 00000000000..8aa123e9440
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLima.md
@@ -0,0 +1,179 @@
+---
+title: FakeLima
+description: API reference for qiskit.providers.fake_provider.FakeLima
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeLima
+---
+
+# FakeLima
+
+
+
+`qiskit.providers.fake_provider.FakeLima`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/lima/fake_lima.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake 5 qubit backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_lima'`
+
+
+
+### conf\_filename
+
+`= 'conf_lima.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_lima.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/lima'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeLima.run "qiskit.providers.fake_provider.FakeLima.run") method.
+
+
+
+### props\_filename
+
+`= 'props_lima.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLimaV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLimaV2.md
new file mode 100644
index 00000000000..eea49f07e50
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLimaV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeLimaV2
+description: API reference for qiskit.providers.fake_provider.FakeLimaV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeLimaV2
+---
+
+# FakeLimaV2
+
+
+
+`qiskit.providers.fake_provider.FakeLimaV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/lima/fake_lima.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 5 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_lima'`
+
+
+
+### conf\_filename
+
+`= 'conf_lima.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_lima.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/lima'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeLimaV2.run "qiskit.providers.fake_provider.FakeLimaV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_lima.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLondon.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLondon.md
new file mode 100644
index 00000000000..60a91aedcb2
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLondon.md
@@ -0,0 +1,173 @@
+---
+title: FakeLondon
+description: API reference for qiskit.providers.fake_provider.FakeLondon
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeLondon
+---
+
+# FakeLondon
+
+
+
+`qiskit.providers.fake_provider.FakeLondon`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/london/fake_london.py "view source code")
+
+Bases: [`FakeQasmBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakeQasmBackend "qiskit.providers.fake_provider.fake_qasm_backend.FakeQasmBackend")
+
+A fake 5 qubit backend.
+
+```python
+0 ↔ 1 ↔ 2
+ ↕
+ 3
+ ↕
+ 4
+```
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_london'`
+
+
+
+### conf\_filename
+
+`= 'conf_london.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/london'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeLondon.run "qiskit.providers.fake_provider.FakeLondon.run") method.
+
+
+
+### props\_filename
+
+`= 'props_london.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLondonV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLondonV2.md
new file mode 100644
index 00000000000..fcfc6e7f841
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeLondonV2.md
@@ -0,0 +1,359 @@
+---
+title: FakeLondonV2
+description: API reference for qiskit.providers.fake_provider.FakeLondonV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeLondonV2
+---
+
+# FakeLondonV2
+
+
+
+`qiskit.providers.fake_provider.FakeLondonV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/london/fake_london.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 5 qubit backend.
+
+```python
+0 ↔ 1 ↔ 2
+ ↕
+ 3
+ ↕
+ 4
+```
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_london'`
+
+
+
+### conf\_filename
+
+`= 'conf_london.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= None`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/london'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeLondonV2.run "qiskit.providers.fake_provider.FakeLondonV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_london.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeManhattan.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeManhattan.md
new file mode 100644
index 00000000000..9a32e0955b1
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeManhattan.md
@@ -0,0 +1,179 @@
+---
+title: FakeManhattan
+description: API reference for qiskit.providers.fake_provider.FakeManhattan
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeManhattan
+---
+
+# FakeManhattan
+
+
+
+`qiskit.providers.fake_provider.FakeManhattan`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/manhattan/fake_manhattan.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake Manhattan backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_manhattan'`
+
+
+
+### conf\_filename
+
+`= 'conf_manhattan.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_manhattan.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/manhattan'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeManhattan.run "qiskit.providers.fake_provider.FakeManhattan.run") method.
+
+
+
+### props\_filename
+
+`= 'props_manhattan.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeManhattanV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeManhattanV2.md
new file mode 100644
index 00000000000..134433b9922
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeManhattanV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeManhattanV2
+description: API reference for qiskit.providers.fake_provider.FakeManhattanV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeManhattanV2
+---
+
+# FakeManhattanV2
+
+
+
+`qiskit.providers.fake_provider.FakeManhattanV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/manhattan/fake_manhattan.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake Manhattan backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_manhattan'`
+
+
+
+### conf\_filename
+
+`= 'conf_manhattan.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_manhattan.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/manhattan'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeManhattanV2.run "qiskit.providers.fake_provider.FakeManhattanV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_manhattan.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeManila.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeManila.md
new file mode 100644
index 00000000000..06cb7ea89e5
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeManila.md
@@ -0,0 +1,179 @@
+---
+title: FakeManila
+description: API reference for qiskit.providers.fake_provider.FakeManila
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeManila
+---
+
+# FakeManila
+
+
+
+`qiskit.providers.fake_provider.FakeManila`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/manila/fake_manila.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake 5 qubit backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_manila'`
+
+
+
+### conf\_filename
+
+`= 'conf_manila.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_manila.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/manila'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeManila.run "qiskit.providers.fake_provider.FakeManila.run") method.
+
+
+
+### props\_filename
+
+`= 'props_manila.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeManilaV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeManilaV2.md
new file mode 100644
index 00000000000..9e044312a50
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeManilaV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeManilaV2
+description: API reference for qiskit.providers.fake_provider.FakeManilaV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeManilaV2
+---
+
+# FakeManilaV2
+
+
+
+`qiskit.providers.fake_provider.FakeManilaV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/manila/fake_manila.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 5 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_manila'`
+
+
+
+### conf\_filename
+
+`= 'conf_manila.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_manila.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/manila'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeManilaV2.run "qiskit.providers.fake_provider.FakeManilaV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_manila.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMelbourne.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMelbourne.md
new file mode 100644
index 00000000000..b4d052ae9f9
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMelbourne.md
@@ -0,0 +1,140 @@
+---
+title: FakeMelbourne
+description: API reference for qiskit.providers.fake_provider.FakeMelbourne
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeMelbourne
+---
+
+# FakeMelbourne
+
+
+
+`qiskit.providers.fake_provider.FakeMelbourne`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/melbourne/fake_melbourne.py "view source code")
+
+Bases: [`FakeBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakeBackend "qiskit.providers.fake_provider.fake_backend.FakeBackend")
+
+A fake 14 qubit backend.
+
+```python
+0 ← 1 → 2 → 3 ← 4 ← 5 → 6
+ ↑ ↑ ↑ ↓ ↓ ↓
+ 13 → 12 ← 11 → 10 ← 9 → 8 ← 7
+```
+
+## Attributes
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeMelbourne.run "qiskit.providers.fake_provider.FakeMelbourne.run") method.
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMelbourneV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMelbourneV2.md
new file mode 100644
index 00000000000..11b800978cb
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMelbourneV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeMelbourneV2
+description: API reference for qiskit.providers.fake_provider.FakeMelbourneV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeMelbourneV2
+---
+
+# FakeMelbourneV2
+
+
+
+`qiskit.providers.fake_provider.FakeMelbourneV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/melbourne/fake_melbourne.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 14 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_melbourne'`
+
+
+
+### conf\_filename
+
+`= 'conf_melbourne.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= None`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/melbourne'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeMelbourneV2.run "qiskit.providers.fake_provider.FakeMelbourneV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_melbourne.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMontreal.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMontreal.md
new file mode 100644
index 00000000000..c9bdc9f6fea
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMontreal.md
@@ -0,0 +1,179 @@
+---
+title: FakeMontreal
+description: API reference for qiskit.providers.fake_provider.FakeMontreal
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeMontreal
+---
+
+# FakeMontreal
+
+
+
+`qiskit.providers.fake_provider.FakeMontreal`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/montreal/fake_montreal.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake 27 qubit backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_montreal'`
+
+
+
+### conf\_filename
+
+`= 'conf_montreal.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_montreal.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/montreal'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeMontreal.run "qiskit.providers.fake_provider.FakeMontreal.run") method.
+
+
+
+### props\_filename
+
+`= 'props_montreal.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMontrealV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMontrealV2.md
new file mode 100644
index 00000000000..bdcad22bb37
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMontrealV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeMontrealV2
+description: API reference for qiskit.providers.fake_provider.FakeMontrealV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeMontrealV2
+---
+
+# FakeMontrealV2
+
+
+
+`qiskit.providers.fake_provider.FakeMontrealV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/montreal/fake_montreal.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 27 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_montreal'`
+
+
+
+### conf\_filename
+
+`= 'conf_montreal.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_montreal.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/montreal'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeMontrealV2.run "qiskit.providers.fake_provider.FakeMontrealV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_montreal.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMumbai.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMumbai.md
new file mode 100644
index 00000000000..81126024ae9
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMumbai.md
@@ -0,0 +1,179 @@
+---
+title: FakeMumbai
+description: API reference for qiskit.providers.fake_provider.FakeMumbai
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeMumbai
+---
+
+# FakeMumbai
+
+
+
+`qiskit.providers.fake_provider.FakeMumbai`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/mumbai/fake_mumbai.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake 27 qubit backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_mumbai'`
+
+
+
+### conf\_filename
+
+`= 'conf_mumbai.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_mumbai.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/mumbai'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeMumbai.run "qiskit.providers.fake_provider.FakeMumbai.run") method.
+
+
+
+### props\_filename
+
+`= 'props_mumbai.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMumbaiFractionalCX.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMumbaiFractionalCX.md
new file mode 100644
index 00000000000..cde6caefb53
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMumbaiFractionalCX.md
@@ -0,0 +1,327 @@
+---
+title: FakeMumbaiFractionalCX
+description: API reference for qiskit.providers.fake_provider.FakeMumbaiFractionalCX
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeMumbaiFractionalCX
+---
+
+# FakeMumbaiFractionalCX
+
+
+
+`qiskit.providers.fake_provider.FakeMumbaiFractionalCX`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/fake_mumbai_v2.py "view source code")
+
+Bases: [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.backend.BackendV2")
+
+A fake mumbai backend.
+
+
+ The class `qiskit.providers.fake_provider.fake_mumbai_v2.FakeMumbaiFractionalCX` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. Use the qiskit.providers.basic\_provider.GenericBackendV2 class instead.
+
+
+## Attributes
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the output signal timestep
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeMumbaiFractionalCX.run "qiskit.providers.fake_provider.FakeMumbaiFractionalCX.run") method.
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the backend.
+
+This method returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object that runs circuits. Depending on the backend this may be either an async or sync call. It is at the discretion of the provider to decide whether running should block until the execution is finished or not: the Job class can handle either situation.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMumbaiV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMumbaiV2.md
new file mode 100644
index 00000000000..ea0c4ac6fed
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeMumbaiV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeMumbaiV2
+description: API reference for qiskit.providers.fake_provider.FakeMumbaiV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeMumbaiV2
+---
+
+# FakeMumbaiV2
+
+
+
+`qiskit.providers.fake_provider.FakeMumbaiV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/mumbai/fake_mumbai.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 27 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_mumbai'`
+
+
+
+### conf\_filename
+
+`= 'conf_mumbai.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_mumbai.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/mumbai'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeMumbaiV2.run "qiskit.providers.fake_provider.FakeMumbaiV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_mumbai.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeNairobi.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeNairobi.md
new file mode 100644
index 00000000000..86b26188dd9
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeNairobi.md
@@ -0,0 +1,179 @@
+---
+title: FakeNairobi
+description: API reference for qiskit.providers.fake_provider.FakeNairobi
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeNairobi
+---
+
+# FakeNairobi
+
+
+
+`qiskit.providers.fake_provider.FakeNairobi`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/nairobi/fake_nairobi.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake 7 qubit backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_nairobi'`
+
+
+
+### conf\_filename
+
+`= 'conf_nairobi.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_nairobi.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/nairobi'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeNairobi.run "qiskit.providers.fake_provider.FakeNairobi.run") method.
+
+
+
+### props\_filename
+
+`= 'props_nairobi.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeNairobiV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeNairobiV2.md
new file mode 100644
index 00000000000..03ae5c94179
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeNairobiV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeNairobiV2
+description: API reference for qiskit.providers.fake_provider.FakeNairobiV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeNairobiV2
+---
+
+# FakeNairobiV2
+
+
+
+`qiskit.providers.fake_provider.FakeNairobiV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/nairobi/fake_nairobi.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 7 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_nairobi'`
+
+
+
+### conf\_filename
+
+`= 'conf_nairobi.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_nairobi.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/nairobi'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeNairobiV2.run "qiskit.providers.fake_provider.FakeNairobiV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_nairobi.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOpenPulse2Q.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOpenPulse2Q.md
new file mode 100644
index 00000000000..6ab944e6a7d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOpenPulse2Q.md
@@ -0,0 +1,149 @@
+---
+title: FakeOpenPulse2Q
+description: API reference for qiskit.providers.fake_provider.FakeOpenPulse2Q
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeOpenPulse2Q
+---
+
+# FakeOpenPulse2Q
+
+
+
+`qiskit.providers.fake_provider.FakeOpenPulse2Q`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/fake_openpulse_2q.py "view source code")
+
+Bases: [`FakeBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakeBackend "qiskit.providers.fake_provider.fake_backend.FakeBackend")
+
+A fake 2 qubit backend for pulse test.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeOpenPulse2Q.run "qiskit.providers.fake_provider.FakeOpenPulse2Q.run") method.
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Return the default pulse-related settings provided by the backend (such as gate to Schedule mappings).
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Return the measured characteristics of the backend.
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOpenPulse3Q.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOpenPulse3Q.md
new file mode 100644
index 00000000000..bcc6a63fe3e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOpenPulse3Q.md
@@ -0,0 +1,147 @@
+---
+title: FakeOpenPulse3Q
+description: API reference for qiskit.providers.fake_provider.FakeOpenPulse3Q
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeOpenPulse3Q
+---
+
+# FakeOpenPulse3Q
+
+
+
+`qiskit.providers.fake_provider.FakeOpenPulse3Q`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/fake_openpulse_3q.py "view source code")
+
+Bases: [`FakeBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakeBackend "qiskit.providers.fake_provider.fake_backend.FakeBackend")
+
+Trivial extension of the FakeOpenPulse2Q.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeOpenPulse3Q.run "qiskit.providers.fake_provider.FakeOpenPulse3Q.run") method.
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Return backend properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOslo.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOslo.md
new file mode 100644
index 00000000000..df4b4cde628
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOslo.md
@@ -0,0 +1,351 @@
+---
+title: FakeOslo
+description: API reference for qiskit.providers.fake_provider.FakeOslo
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeOslo
+---
+
+# FakeOslo
+
+
+
+`qiskit.providers.fake_provider.FakeOslo`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/oslo/fake_oslo.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 7 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_oslo'`
+
+
+
+### conf\_filename
+
+`= 'conf_oslo.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_oslo.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/oslo'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeOslo.run "qiskit.providers.fake_provider.FakeOslo.run") method.
+
+
+
+### props\_filename
+
+`= 'props_oslo.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOurense.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOurense.md
new file mode 100644
index 00000000000..f535ff5aeb3
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOurense.md
@@ -0,0 +1,171 @@
+---
+title: FakeOurense
+description: API reference for qiskit.providers.fake_provider.FakeOurense
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeOurense
+---
+
+# FakeOurense
+
+
+
+`qiskit.providers.fake_provider.FakeOurense`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/ourense/fake_ourense.py "view source code")
+
+Bases: [`FakeQasmBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakeQasmBackend "qiskit.providers.fake_provider.fake_qasm_backend.FakeQasmBackend")
+
+A fake 5 qubit backend.
+
+```python
+0 ↔ 1 ↔ 3 ↔ 4
+ ↕
+ 2
+```
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_ourense'`
+
+
+
+### conf\_filename
+
+`= 'conf_ourense.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/ourense'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeOurense.run "qiskit.providers.fake_provider.FakeOurense.run") method.
+
+
+
+### props\_filename
+
+`= 'props_ourense.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOurenseV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOurenseV2.md
new file mode 100644
index 00000000000..6730e7e50e4
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeOurenseV2.md
@@ -0,0 +1,357 @@
+---
+title: FakeOurenseV2
+description: API reference for qiskit.providers.fake_provider.FakeOurenseV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeOurenseV2
+---
+
+# FakeOurenseV2
+
+
+
+`qiskit.providers.fake_provider.FakeOurenseV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/ourense/fake_ourense.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 5 qubit backend.
+
+```python
+0 ↔ 1 ↔ 3 ↔ 4
+ ↕
+ 2
+```
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_ourense'`
+
+
+
+### conf\_filename
+
+`= 'conf_ourense.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= None`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/ourense'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeOurenseV2.run "qiskit.providers.fake_provider.FakeOurenseV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_ourense.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeParis.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeParis.md
new file mode 100644
index 00000000000..20ccdcdc055
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeParis.md
@@ -0,0 +1,191 @@
+---
+title: FakeParis
+description: API reference for qiskit.providers.fake_provider.FakeParis
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeParis
+---
+
+# FakeParis
+
+
+
+`qiskit.providers.fake_provider.FakeParis`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/paris/fake_paris.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake Paris backend.
+
+```python
+ 06 17
+ ↕ ↕
+00 ↔ 01 ↔ 04 ↔ 07 ↔ 10 ↔ 12 ↔ 15 ↔ 18 ↔ 20 ↔ 23
+ ↕ ↕ ↕
+ 02 13 24
+ ↕ ↕ ↕
+ 03 ↔ 05 ↔ 08 ↔ 11 ↔ 14 ↔ 16 ↔ 19 ↔ 22 ↔ 25 ↔ 26
+ ↕ ↕
+ 09 20
+```
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_paris'`
+
+
+
+### conf\_filename
+
+`= 'conf_paris.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_paris.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/paris'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeParis.run "qiskit.providers.fake_provider.FakeParis.run") method.
+
+
+
+### props\_filename
+
+`= 'props_paris.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeParisV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeParisV2.md
new file mode 100644
index 00000000000..8b0eb62da97
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeParisV2.md
@@ -0,0 +1,363 @@
+---
+title: FakeParisV2
+description: API reference for qiskit.providers.fake_provider.FakeParisV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeParisV2
+---
+
+# FakeParisV2
+
+
+
+`qiskit.providers.fake_provider.FakeParisV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/paris/fake_paris.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake Paris backend.
+
+```python
+ 06 17
+ ↕ ↕
+00 ↔ 01 ↔ 04 ↔ 07 ↔ 10 ↔ 12 ↔ 15 ↔ 18 ↔ 20 ↔ 23
+ ↕ ↕ ↕
+ 02 13 24
+ ↕ ↕ ↕
+ 03 ↔ 05 ↔ 08 ↔ 11 ↔ 14 ↔ 16 ↔ 19 ↔ 22 ↔ 25 ↔ 26
+ ↕ ↕
+ 09 20
+```
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_paris'`
+
+
+
+### conf\_filename
+
+`= 'conf_paris.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_paris.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/paris'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeParisV2.run "qiskit.providers.fake_provider.FakeParisV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_paris.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakePerth.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakePerth.md
new file mode 100644
index 00000000000..ca06118ac85
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakePerth.md
@@ -0,0 +1,351 @@
+---
+title: FakePerth
+description: API reference for qiskit.providers.fake_provider.FakePerth
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakePerth
+---
+
+# FakePerth
+
+
+
+`qiskit.providers.fake_provider.FakePerth`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/perth/fake_perth.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 7 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_perth'`
+
+
+
+### conf\_filename
+
+`= 'conf_perth.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_perth.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/perth'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakePerth.run "qiskit.providers.fake_provider.FakePerth.run") method.
+
+
+
+### props\_filename
+
+`= 'props_perth.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakePoughkeepsie.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakePoughkeepsie.md
new file mode 100644
index 00000000000..91befe7582d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakePoughkeepsie.md
@@ -0,0 +1,144 @@
+---
+title: FakePoughkeepsie
+description: API reference for qiskit.providers.fake_provider.FakePoughkeepsie
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakePoughkeepsie
+---
+
+# FakePoughkeepsie
+
+
+
+`qiskit.providers.fake_provider.FakePoughkeepsie`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/poughkeepsie/fake_poughkeepsie.py "view source code")
+
+Bases: [`FakeBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakeBackend "qiskit.providers.fake_provider.fake_backend.FakeBackend")
+
+A fake Poughkeepsie backend.
+
+```python
+00 ↔ 01 ↔ 02 ↔ 03 ↔ 04
+ ↕ ↕
+05 ↔ 06 ↔ 07 ↔ 08 ↔ 09
+ ↕ ↕ ↕
+10 ↔ 11 ↔ 12 ↔ 13 ↔ 14
+ ↕ ↕
+15 ↔ 16 ↔ 17 ↔ 18 ↔ 19
+```
+
+## Attributes
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakePoughkeepsie.run "qiskit.providers.fake_provider.FakePoughkeepsie.run") method.
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakePoughkeepsieV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakePoughkeepsieV2.md
new file mode 100644
index 00000000000..779bf664d49
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakePoughkeepsieV2.md
@@ -0,0 +1,351 @@
+---
+title: FakePoughkeepsieV2
+description: API reference for qiskit.providers.fake_provider.FakePoughkeepsieV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakePoughkeepsieV2
+---
+
+# FakePoughkeepsieV2
+
+
+
+`qiskit.providers.fake_provider.FakePoughkeepsieV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/poughkeepsie/fake_poughkeepsie.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake Poughkeepsie backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_poughkeepsie'`
+
+
+
+### conf\_filename
+
+`= 'conf_poughkeepsie.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_poughkeepsie.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/poughkeepsie'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakePoughkeepsieV2.run "qiskit.providers.fake_provider.FakePoughkeepsieV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_poughkeepsie.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakePrague.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakePrague.md
new file mode 100644
index 00000000000..22450b68075
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakePrague.md
@@ -0,0 +1,351 @@
+---
+title: FakePrague
+description: API reference for qiskit.providers.fake_provider.FakePrague
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakePrague
+---
+
+# FakePrague
+
+
+
+`qiskit.providers.fake_provider.FakePrague`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/prague/fake_prague.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 33 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_prague'`
+
+
+
+### conf\_filename
+
+`= 'conf_prague.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= None`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/prague'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakePrague.run "qiskit.providers.fake_provider.FakePrague.run") method.
+
+
+
+### props\_filename
+
+`= 'props_prague.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeProvider.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeProvider.md
new file mode 100644
index 00000000000..47b41df93e9
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeProvider.md
@@ -0,0 +1,82 @@
+---
+title: FakeProvider
+description: API reference for qiskit.providers.fake_provider.FakeProvider
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeProvider
+---
+
+# FakeProvider
+
+
+
+`qiskit.providers.fake_provider.FakeProvider`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/fake_provider.py "view source code")
+
+Bases: [`ProviderV1`](qiskit.providers.ProviderV1 "qiskit.providers.provider.ProviderV1")
+
+Fake provider containing fake V1 backends.
+
+Only filtering backends by name is implemented. This class contains all fake V1 backends available in the [`qiskit.providers.fake_provider`](providers_fake_provider#module-qiskit.providers.fake_provider "qiskit.providers.fake_provider").
+
+
+ The class `qiskit.providers.fake_provider.fake_provider.FakeProvider` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. This class has been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeProviderExample instead of from qiskit.providers.fake\_provider import FakeProviderExample.
+
+
+## Attributes
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### backends
+
+
+
+`backends(name=None, **kwargs)`
+
+Return a list of backends matching the specified filtering.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name of the backend.
+* **\*\*kwargs** – dict used for filtering.
+
+**Returns**
+
+**a list of Backends that match the filtering**
+
+criteria.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[Backend](qiskit.providers.Backend "qiskit.providers.Backend")]
+
+### get\_backend
+
+
+
+`get_backend(name=None, **kwargs)`
+
+Return a single backend matching the specified filtering.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name of the backend.
+* **\*\*kwargs** – dict used for filtering.
+
+**Returns**
+
+a backend matching the filtering.
+
+**Return type**
+
+[Backend](qiskit.providers.Backend "qiskit.providers.Backend")
+
+**Raises**
+
+[**QiskitBackendNotFoundError**](providers#qiskit.providers.QiskitBackendNotFoundError "qiskit.providers.QiskitBackendNotFoundError") – if no backend could be found or more than one backend matches the filtering criteria.
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeProviderForBackendV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeProviderForBackendV2.md
new file mode 100644
index 00000000000..1bbe6ba104b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeProviderForBackendV2.md
@@ -0,0 +1,82 @@
+---
+title: FakeProviderForBackendV2
+description: API reference for qiskit.providers.fake_provider.FakeProviderForBackendV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeProviderForBackendV2
+---
+
+# FakeProviderForBackendV2
+
+
+
+`qiskit.providers.fake_provider.FakeProviderForBackendV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/fake_provider.py "view source code")
+
+Bases: [`ProviderV1`](qiskit.providers.ProviderV1 "qiskit.providers.provider.ProviderV1")
+
+Fake provider containing fake V2 backends.
+
+Only filtering backends by name is implemented. This class contains all fake V2 backends available in the [`qiskit.providers.fake_provider`](providers_fake_provider#module-qiskit.providers.fake_provider "qiskit.providers.fake_provider").
+
+
+ The class `qiskit.providers.fake_provider.fake_provider.FakeProviderForBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. This class has been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeProviderExample instead of from qiskit.providers.fake\_provider import FakeProviderExample.
+
+
+## Attributes
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### backends
+
+
+
+`backends(name=None, **kwargs)`
+
+Return a list of backends matching the specified filtering.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name of the backend.
+* **\*\*kwargs** – dict used for filtering.
+
+**Returns**
+
+**a list of Backends that match the filtering**
+
+criteria.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[Backend](qiskit.providers.Backend "qiskit.providers.Backend")]
+
+### get\_backend
+
+
+
+`get_backend(name=None, **kwargs)`
+
+Return a single backend matching the specified filtering.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – name of the backend.
+* **\*\*kwargs** – dict used for filtering.
+
+**Returns**
+
+a backend matching the filtering.
+
+**Return type**
+
+[Backend](qiskit.providers.Backend "qiskit.providers.Backend")
+
+**Raises**
+
+[**QiskitBackendNotFoundError**](providers#qiskit.providers.QiskitBackendNotFoundError "qiskit.providers.QiskitBackendNotFoundError") – if no backend could be found or more than one backend matches the filtering criteria.
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeQasmSimulator.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeQasmSimulator.md
new file mode 100644
index 00000000000..511d6fe0daf
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeQasmSimulator.md
@@ -0,0 +1,138 @@
+---
+title: FakeQasmSimulator
+description: API reference for qiskit.providers.fake_provider.FakeQasmSimulator
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeQasmSimulator
+---
+
+# FakeQasmSimulator
+
+
+
+`qiskit.providers.fake_provider.FakeQasmSimulator`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/fake_qasm_simulator.py "view source code")
+
+Bases: [`FakeBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakeBackend "qiskit.providers.fake_provider.fake_backend.FakeBackend")
+
+A fake simulator backend.
+
+
+ The class `qiskit.providers.fake_provider.fake_qasm_simulator.FakeQasmSimulator` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. Use the qiskit.providers.basic\_provider.BasicSimulator class instead.
+
+
+## Attributes
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeQasmSimulator.run "qiskit.providers.fake_provider.FakeQasmSimulator.run") method.
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Return backend properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeQuito.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeQuito.md
new file mode 100644
index 00000000000..e953171ce47
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeQuito.md
@@ -0,0 +1,179 @@
+---
+title: FakeQuito
+description: API reference for qiskit.providers.fake_provider.FakeQuito
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeQuito
+---
+
+# FakeQuito
+
+
+
+`qiskit.providers.fake_provider.FakeQuito`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/quito/fake_quito.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake 5 qubit backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_quito'`
+
+
+
+### conf\_filename
+
+`= 'conf_quito.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_quito.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/quito'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeQuito.run "qiskit.providers.fake_provider.FakeQuito.run") method.
+
+
+
+### props\_filename
+
+`= 'props_quito.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeQuitoV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeQuitoV2.md
new file mode 100644
index 00000000000..85ec0362f1d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeQuitoV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeQuitoV2
+description: API reference for qiskit.providers.fake_provider.FakeQuitoV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeQuitoV2
+---
+
+# FakeQuitoV2
+
+
+
+`qiskit.providers.fake_provider.FakeQuitoV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/quito/fake_quito.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 5 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_quito'`
+
+
+
+### conf\_filename
+
+`= 'conf_quito.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_quito.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/quito'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeQuitoV2.run "qiskit.providers.fake_provider.FakeQuitoV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_quito.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRochester.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRochester.md
new file mode 100644
index 00000000000..684a4621b06
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRochester.md
@@ -0,0 +1,165 @@
+---
+title: FakeRochester
+description: API reference for qiskit.providers.fake_provider.FakeRochester
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeRochester
+---
+
+# FakeRochester
+
+
+
+`qiskit.providers.fake_provider.FakeRochester`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/rochester/fake_rochester.py "view source code")
+
+Bases: [`FakeQasmBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakeQasmBackend "qiskit.providers.fake_provider.fake_qasm_backend.FakeQasmBackend")
+
+A fake Rochester backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_rochester'`
+
+
+
+### conf\_filename
+
+`= 'conf_rochester.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/rochester'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeRochester.run "qiskit.providers.fake_provider.FakeRochester.run") method.
+
+
+
+### props\_filename
+
+`= 'props_rochester.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRochesterV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRochesterV2.md
new file mode 100644
index 00000000000..99310cceab1
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRochesterV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeRochesterV2
+description: API reference for qiskit.providers.fake_provider.FakeRochesterV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeRochesterV2
+---
+
+# FakeRochesterV2
+
+
+
+`qiskit.providers.fake_provider.FakeRochesterV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/rochester/fake_rochester.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake Rochester backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_rochester'`
+
+
+
+### conf\_filename
+
+`= 'conf_rochester.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= None`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/rochester'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeRochesterV2.run "qiskit.providers.fake_provider.FakeRochesterV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_rochester.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRome.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRome.md
new file mode 100644
index 00000000000..e5324286dc8
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRome.md
@@ -0,0 +1,179 @@
+---
+title: FakeRome
+description: API reference for qiskit.providers.fake_provider.FakeRome
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeRome
+---
+
+# FakeRome
+
+
+
+`qiskit.providers.fake_provider.FakeRome`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/rome/fake_rome.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake 5 qubit backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_rome'`
+
+
+
+### conf\_filename
+
+`= 'conf_rome.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_rome.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/rome'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeRome.run "qiskit.providers.fake_provider.FakeRome.run") method.
+
+
+
+### props\_filename
+
+`= 'props_rome.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRomeV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRomeV2.md
new file mode 100644
index 00000000000..62569343ac7
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRomeV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeRomeV2
+description: API reference for qiskit.providers.fake_provider.FakeRomeV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeRomeV2
+---
+
+# FakeRomeV2
+
+
+
+`qiskit.providers.fake_provider.FakeRomeV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/rome/fake_rome.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 5 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_rome'`
+
+
+
+### conf\_filename
+
+`= 'conf_rome.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_rome.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/rome'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeRomeV2.run "qiskit.providers.fake_provider.FakeRomeV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_rome.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRueschlikon.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRueschlikon.md
new file mode 100644
index 00000000000..28d30da9586
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeRueschlikon.md
@@ -0,0 +1,140 @@
+---
+title: FakeRueschlikon
+description: API reference for qiskit.providers.fake_provider.FakeRueschlikon
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeRueschlikon
+---
+
+# FakeRueschlikon
+
+
+
+`qiskit.providers.fake_provider.FakeRueschlikon`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/rueschlikon/fake_rueschlikon.py "view source code")
+
+Bases: [`FakeBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakeBackend "qiskit.providers.fake_provider.fake_backend.FakeBackend")
+
+A fake 16 qubit backend.
+
+```python
+1 → 2 → 3 → 4 ← 5 ← 6 → 7 ← 8
+↓ ↑ ↓ ↓ ↑ ↓ ↓ ↑
+0 ← 15 → 14 ← 13 ← 12 → 11 → 10 ← 9
+```
+
+## Attributes
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeRueschlikon.run "qiskit.providers.fake_provider.FakeRueschlikon.run") method.
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Return backend properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSantiago.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSantiago.md
new file mode 100644
index 00000000000..f373872433c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSantiago.md
@@ -0,0 +1,179 @@
+---
+title: FakeSantiago
+description: API reference for qiskit.providers.fake_provider.FakeSantiago
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeSantiago
+---
+
+# FakeSantiago
+
+
+
+`qiskit.providers.fake_provider.FakeSantiago`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/santiago/fake_santiago.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake Santiago backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_santiago'`
+
+
+
+### conf\_filename
+
+`= 'conf_santiago.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_santiago.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/santiago'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeSantiago.run "qiskit.providers.fake_provider.FakeSantiago.run") method.
+
+
+
+### props\_filename
+
+`= 'props_santiago.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSantiagoV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSantiagoV2.md
new file mode 100644
index 00000000000..c08f0dd9a2d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSantiagoV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeSantiagoV2
+description: API reference for qiskit.providers.fake_provider.FakeSantiagoV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeSantiagoV2
+---
+
+# FakeSantiagoV2
+
+
+
+`qiskit.providers.fake_provider.FakeSantiagoV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/santiago/fake_santiago.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake Santiago backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_santiago'`
+
+
+
+### conf\_filename
+
+`= 'conf_santiago.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_santiago.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/santiago'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeSantiagoV2.run "qiskit.providers.fake_provider.FakeSantiagoV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_santiago.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSherbrooke.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSherbrooke.md
new file mode 100644
index 00000000000..901be28c8fa
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSherbrooke.md
@@ -0,0 +1,351 @@
+---
+title: FakeSherbrooke
+description: API reference for qiskit.providers.fake_provider.FakeSherbrooke
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeSherbrooke
+---
+
+# FakeSherbrooke
+
+
+
+`qiskit.providers.fake_provider.FakeSherbrooke`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/sherbrooke/fake_sherbrooke.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 127 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_sherbrooke'`
+
+
+
+### conf\_filename
+
+`= 'conf_sherbrooke.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_sherbrooke.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/sherbrooke'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeSherbrooke.run "qiskit.providers.fake_provider.FakeSherbrooke.run") method.
+
+
+
+### props\_filename
+
+`= 'props_sherbrooke.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSingapore.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSingapore.md
new file mode 100644
index 00000000000..dfa5cd48049
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSingapore.md
@@ -0,0 +1,175 @@
+---
+title: FakeSingapore
+description: API reference for qiskit.providers.fake_provider.FakeSingapore
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeSingapore
+---
+
+# FakeSingapore
+
+
+
+`qiskit.providers.fake_provider.FakeSingapore`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/singapore/fake_singapore.py "view source code")
+
+Bases: [`FakeQasmBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakeQasmBackend "qiskit.providers.fake_provider.fake_qasm_backend.FakeQasmBackend")
+
+A fake Singapore backend.
+
+```python
+00 ↔ 01 ↔ 02 ↔ 03 ↔ 04
+ ↕ ↕
+05 ↔ 06 ↔ 07 ↔ 08 ↔ 09
+ ↕ ↕ ↕
+10 ↔ 11 ↔ 12 ↔ 13 ↔ 14
+ ↕ ↕
+15 ↔ 16 ↔ 17 ↔ 18 ↔ 19
+```
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_singapore'`
+
+
+
+### conf\_filename
+
+`= 'conf_singapore.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/singapore'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeSingapore.run "qiskit.providers.fake_provider.FakeSingapore.run") method.
+
+
+
+### props\_filename
+
+`= 'props_singapore.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSingaporeV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSingaporeV2.md
new file mode 100644
index 00000000000..4b4aad914fe
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSingaporeV2.md
@@ -0,0 +1,361 @@
+---
+title: FakeSingaporeV2
+description: API reference for qiskit.providers.fake_provider.FakeSingaporeV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeSingaporeV2
+---
+
+# FakeSingaporeV2
+
+
+
+`qiskit.providers.fake_provider.FakeSingaporeV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/singapore/fake_singapore.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake Singapore backend.
+
+```python
+00 ↔ 01 ↔ 02 ↔ 03 ↔ 04
+ ↕ ↕
+05 ↔ 06 ↔ 07 ↔ 08 ↔ 09
+ ↕ ↕ ↕
+10 ↔ 11 ↔ 12 ↔ 13 ↔ 14
+ ↕ ↕
+15 ↔ 16 ↔ 17 ↔ 18 ↔ 19
+```
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_singapore'`
+
+
+
+### conf\_filename
+
+`= 'conf_singapore.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= None`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/singapore'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeSingaporeV2.run "qiskit.providers.fake_provider.FakeSingaporeV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_singapore.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSydney.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSydney.md
new file mode 100644
index 00000000000..2532377b573
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSydney.md
@@ -0,0 +1,179 @@
+---
+title: FakeSydney
+description: API reference for qiskit.providers.fake_provider.FakeSydney
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeSydney
+---
+
+# FakeSydney
+
+
+
+`qiskit.providers.fake_provider.FakeSydney`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/sydney/fake_sydney.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake 27 qubit backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_sydney'`
+
+
+
+### conf\_filename
+
+`= 'conf_sydney.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_sydney.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/sydney'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeSydney.run "qiskit.providers.fake_provider.FakeSydney.run") method.
+
+
+
+### props\_filename
+
+`= 'props_sydney.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSydneyV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSydneyV2.md
new file mode 100644
index 00000000000..0c828f8a2d7
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeSydneyV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeSydneyV2
+description: API reference for qiskit.providers.fake_provider.FakeSydneyV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeSydneyV2
+---
+
+# FakeSydneyV2
+
+
+
+`qiskit.providers.fake_provider.FakeSydneyV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/sydney/fake_sydney.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 27 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_sydney'`
+
+
+
+### conf\_filename
+
+`= 'conf_sydney.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_sydney.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/sydney'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeSydneyV2.run "qiskit.providers.fake_provider.FakeSydneyV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_sydney.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeTenerife.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeTenerife.md
new file mode 100644
index 00000000000..e025630f306
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeTenerife.md
@@ -0,0 +1,142 @@
+---
+title: FakeTenerife
+description: API reference for qiskit.providers.fake_provider.FakeTenerife
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeTenerife
+---
+
+# FakeTenerife
+
+
+
+`qiskit.providers.fake_provider.FakeTenerife`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/tenerife/fake_tenerife.py "view source code")
+
+Bases: [`FakeBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakeBackend "qiskit.providers.fake_provider.fake_backend.FakeBackend")
+
+A fake 5 qubit backend.
+
+```python
+ 1
+ ↙ ↑
+0 ← 2 ← 3
+ ↑ ↙
+ 4
+```
+
+## Attributes
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeTenerife.run "qiskit.providers.fake_provider.FakeTenerife.run") method.
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties as recorded on 8/30/19.
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeTokyo.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeTokyo.md
new file mode 100644
index 00000000000..ee77b3b6054
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeTokyo.md
@@ -0,0 +1,144 @@
+---
+title: FakeTokyo
+description: API reference for qiskit.providers.fake_provider.FakeTokyo
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeTokyo
+---
+
+# FakeTokyo
+
+
+
+`qiskit.providers.fake_provider.FakeTokyo`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/tokyo/fake_tokyo.py "view source code")
+
+Bases: [`FakeBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakeBackend "qiskit.providers.fake_provider.fake_backend.FakeBackend")
+
+A fake 20 qubit backend.
+
+```python
+00 ↔ 01 ↔ 02 ↔ 03 ↔ 04
+ ↕ ↕ ↕ ↕ ⤫ ↕
+05 ↔ 06 ↔ 07 ↔ 08 ↔ 09
+ ↕ ⤫ ↕ ↕ ⤫ ↕
+10 ↔ 11 ↔ 12 ↔ 13 ↔ 14
+ ↕ ↕ ⤫ ↕ ⤫ ↕
+15 ↔ 16 ↔ 17 18 19
+```
+
+## Attributes
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeTokyo.run "qiskit.providers.fake_provider.FakeTokyo.run") method.
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties as recorded on 8/30/19.
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeToronto.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeToronto.md
new file mode 100644
index 00000000000..ae7fdf5a175
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeToronto.md
@@ -0,0 +1,179 @@
+---
+title: FakeToronto
+description: API reference for qiskit.providers.fake_provider.FakeToronto
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeToronto
+---
+
+# FakeToronto
+
+
+
+`qiskit.providers.fake_provider.FakeToronto`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/toronto/fake_toronto.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake 27 qubit backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_toronto'`
+
+
+
+### conf\_filename
+
+`= 'conf_toronto.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_toronto.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/toronto'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeToronto.run "qiskit.providers.fake_provider.FakeToronto.run") method.
+
+
+
+### props\_filename
+
+`= 'props_toronto.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeTorontoV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeTorontoV2.md
new file mode 100644
index 00000000000..67871fc518c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeTorontoV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeTorontoV2
+description: API reference for qiskit.providers.fake_provider.FakeTorontoV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeTorontoV2
+---
+
+# FakeTorontoV2
+
+
+
+`qiskit.providers.fake_provider.FakeTorontoV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/toronto/fake_toronto.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 27 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_toronto'`
+
+
+
+### conf\_filename
+
+`= 'conf_toronto.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_toronto.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/toronto'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeTorontoV2.run "qiskit.providers.fake_provider.FakeTorontoV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_toronto.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeValencia.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeValencia.md
new file mode 100644
index 00000000000..9bf65823108
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeValencia.md
@@ -0,0 +1,179 @@
+---
+title: FakeValencia
+description: API reference for qiskit.providers.fake_provider.FakeValencia
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeValencia
+---
+
+# FakeValencia
+
+
+
+`qiskit.providers.fake_provider.FakeValencia`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/valencia/fake_valencia.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake 5 qubit backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_valencia'`
+
+
+
+### conf\_filename
+
+`= 'conf_valencia.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_valencia.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/valencia'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeValencia.run "qiskit.providers.fake_provider.FakeValencia.run") method.
+
+
+
+### props\_filename
+
+`= 'props_valencia.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeValenciaV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeValenciaV2.md
new file mode 100644
index 00000000000..571138ae955
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeValenciaV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeValenciaV2
+description: API reference for qiskit.providers.fake_provider.FakeValenciaV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeValenciaV2
+---
+
+# FakeValenciaV2
+
+
+
+`qiskit.providers.fake_provider.FakeValenciaV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/valencia/fake_valencia.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 5 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_valencia'`
+
+
+
+### conf\_filename
+
+`= 'conf_valencia.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_valencia.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/valencia'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeValenciaV2.run "qiskit.providers.fake_provider.FakeValenciaV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_valencia.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeVigo.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeVigo.md
new file mode 100644
index 00000000000..08f64890972
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeVigo.md
@@ -0,0 +1,171 @@
+---
+title: FakeVigo
+description: API reference for qiskit.providers.fake_provider.FakeVigo
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeVigo
+---
+
+# FakeVigo
+
+
+
+`qiskit.providers.fake_provider.FakeVigo`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/vigo/fake_vigo.py "view source code")
+
+Bases: [`FakeQasmBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakeQasmBackend "qiskit.providers.fake_provider.fake_qasm_backend.FakeQasmBackend")
+
+A fake 5 qubit backend.
+
+```python
+0 ↔ 1 ↔ 3 ↔ 4
+ ↕
+ 2
+```
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_vigo'`
+
+
+
+### conf\_filename
+
+`= 'conf_vigo.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/vigo'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeVigo.run "qiskit.providers.fake_provider.FakeVigo.run") method.
+
+
+
+### props\_filename
+
+`= 'props_vigo.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeVigoV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeVigoV2.md
new file mode 100644
index 00000000000..e19d42947ad
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeVigoV2.md
@@ -0,0 +1,357 @@
+---
+title: FakeVigoV2
+description: API reference for qiskit.providers.fake_provider.FakeVigoV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeVigoV2
+---
+
+# FakeVigoV2
+
+
+
+`qiskit.providers.fake_provider.FakeVigoV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/vigo/fake_vigo.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 5 qubit backend.
+
+```python
+0 ↔ 1 ↔ 3 ↔ 4
+ ↕
+ 2
+```
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_vigo'`
+
+
+
+### conf\_filename
+
+`= 'conf_vigo.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= None`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/vigo'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeVigoV2.run "qiskit.providers.fake_provider.FakeVigoV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_vigo.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeWashington.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeWashington.md
new file mode 100644
index 00000000000..692a131d72b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeWashington.md
@@ -0,0 +1,179 @@
+---
+title: FakeWashington
+description: API reference for qiskit.providers.fake_provider.FakeWashington
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeWashington
+---
+
+# FakeWashington
+
+
+
+`qiskit.providers.fake_provider.FakeWashington`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/washington/fake_washington.py "view source code")
+
+Bases: [`FakePulseBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakePulseBackend "qiskit.providers.fake_provider.fake_pulse_backend.FakePulseBackend")
+
+A fake 127 qubit backend.
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_washington'`
+
+
+
+### conf\_filename
+
+`= 'conf_washington.json'`
+
+
+
+### defs\_filename
+
+`= 'defs_washington.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/washington'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeWashington.run "qiskit.providers.fake_provider.FakeWashington.run") method.
+
+
+
+### props\_filename
+
+`= 'props_washington.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### defaults
+
+
+
+`defaults()`
+
+Returns a snapshot of device defaults
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeWashingtonV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeWashingtonV2.md
new file mode 100644
index 00000000000..bb1b48fc453
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeWashingtonV2.md
@@ -0,0 +1,351 @@
+---
+title: FakeWashingtonV2
+description: API reference for qiskit.providers.fake_provider.FakeWashingtonV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeWashingtonV2
+---
+
+# FakeWashingtonV2
+
+
+
+`qiskit.providers.fake_provider.FakeWashingtonV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/washington/fake_washington.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 127 qubit backend.
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_washington'`
+
+
+
+### conf\_filename
+
+`= 'conf_washington.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= 'defs_washington.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/washington'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeWashingtonV2.run "qiskit.providers.fake_provider.FakeWashingtonV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_washington.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeYorktown.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeYorktown.md
new file mode 100644
index 00000000000..3806c7e9427
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeYorktown.md
@@ -0,0 +1,173 @@
+---
+title: FakeYorktown
+description: API reference for qiskit.providers.fake_provider.FakeYorktown
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeYorktown
+---
+
+# FakeYorktown
+
+
+
+`qiskit.providers.fake_provider.FakeYorktown`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/yorktown/fake_yorktown.py "view source code")
+
+Bases: [`FakeQasmBackend`](providers_fake_provider#qiskit.providers.fake_provider.FakeQasmBackend "qiskit.providers.fake_provider.fake_qasm_backend.FakeQasmBackend")
+
+A fake 5 qubit backend.
+
+```python
+ 1
+ / |
+0 - 2 - 3
+ | /
+ 4
+```
+
+FakeBackend initializer.
+
+**Parameters**
+
+* **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")) – backend configuration
+* **time\_alive** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – time to wait before returning result
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_yorktown'`
+
+
+
+### conf\_filename
+
+`= 'conf_yorktown.json'`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/yorktown'`
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeYorktown.run "qiskit.providers.fake_provider.FakeYorktown.run") method.
+
+
+
+### props\_filename
+
+`= 'props_yorktown.json'`
+
+
+
+### version
+
+`= 1`
+
+## Methods
+
+### configuration
+
+
+
+`configuration()`
+
+Return the backend configuration.
+
+**Returns**
+
+the configuration for the backend.
+
+**Return type**
+
+[BackendConfiguration](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.BackendConfiguration")
+
+### name
+
+
+
+`name()`
+
+Return the backend name.
+
+**Returns**
+
+the name of the backend.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### properties
+
+
+
+`properties()`
+
+Returns a snapshot of device properties
+
+### provider
+
+
+
+`provider()`
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+### run
+
+
+
+`run(run_input, **kwargs)`
+
+Main job in simulator
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
+### status
+
+
+
+`status()`
+
+Return the backend status.
+
+**Returns**
+
+the status of the backend.
+
+**Return type**
+
+[BackendStatus](qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeYorktownV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeYorktownV2.md
new file mode 100644
index 00000000000..631b917e9df
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.FakeYorktownV2.md
@@ -0,0 +1,359 @@
+---
+title: FakeYorktownV2
+description: API reference for qiskit.providers.fake_provider.FakeYorktownV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.FakeYorktownV2
+---
+
+# FakeYorktownV2
+
+
+
+`qiskit.providers.fake_provider.FakeYorktownV2`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/backends/yorktown/fake_yorktown.py "view source code")
+
+Bases: [`FakeBackendV2`](providers_fake_provider#qiskit.providers.fake_provider.fake_backend.FakeBackendV2 "qiskit.providers.fake_provider.fake_backend.FakeBackendV2")
+
+A fake 5 qubit backend.
+
+```python
+ 1
+ / |
+0 - 2 - 3
+ | /
+ 4
+```
+
+FakeBackendV2 initializer.
+
+
+ The class `qiskit.providers.fake_provider.fake_backend.FakeBackendV2` is deprecated as of qiskit 0.46.0. It will be removed in qiskit 1.0. All fake backend instances based on real device snapshots (FakeVigo,\`FakeSherbrooke\`,…) have been migrated to the qiskit\_ibm\_runtime package. To migrate your code, run pip install qiskit-ibm-runtime and use from qiskit\_ibm\_runtime.fake\_provider import FakeExample instead of from qiskit.providers.fake\_provider import FakeExample.
+
+
+## Attributes
+
+
+
+### backend\_name
+
+`= 'fake_yorktown'`
+
+
+
+### conf\_filename
+
+`= 'conf_yorktown.json'`
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### defs\_filename
+
+`= None`
+
+
+
+### dirname
+
+`= '/home/runner/work/qiskit/qiskit/qiskit/providers/fake_provider/backends/yorktown'`
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+**Returns**
+
+The output signal timestep in seconds.
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+Return the grouping of measurements which are multiplexed This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The grouping of measurements which are multiplexed
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.FakeYorktownV2.run "qiskit.providers.fake_provider.FakeYorktownV2.run") method.
+
+
+
+### props\_filename
+
+`= 'props_yorktown.json'`
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+A [`qiskit.transpiler.Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object for the backend.
+
+**Return type**
+
+[Target](qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the fake backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of QuantumCircuit ) and pulse jobs (an individual or a list of Schedule or ScheduleBlock) using a [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using AerSimulator with noise model of the fake backend. Otherwise, jobs will be run using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") without noise.
+
+Currently noisy simulation of a pulse job is not supported yet in FakeBackendV2.
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit-aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.fake_provider.GenericBackendV2.md b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.GenericBackendV2.md
new file mode 100644
index 00000000000..afa45f5f975
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.fake_provider.GenericBackendV2.md
@@ -0,0 +1,354 @@
+---
+title: GenericBackendV2
+description: API reference for qiskit.providers.fake_provider.GenericBackendV2
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.fake_provider.GenericBackendV2
+---
+
+# GenericBackendV2
+
+
+
+`qiskit.providers.fake_provider.GenericBackendV2(num_qubits, basis_gates=None, *, coupling_map=None, control_flow=False, calibrate_instructions=None, dtm=None, seed=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/fake_provider/generic_backend_v2.py "view source code")
+
+Bases: [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.backend.BackendV2")
+
+Generic [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") implementation with a configurable constructor. This class will return a [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") instance that runs on a local simulator (in the spirit of fake backends) and contains all the necessary information to test backend-interfacing components, such as the transpiler. A [`GenericBackendV2`](#qiskit.providers.fake_provider.GenericBackendV2 "qiskit.providers.fake_provider.GenericBackendV2") instance can be constructed from as little as a specified `num_qubits`, but users can additionally configure the basis gates, coupling map, ability to run dynamic circuits (control flow instructions), instruction calibrations and dtm. The remainder of the backend properties are generated by randomly sampling from default ranges extracted from historical IBM backend data. The seed for this random generation can be fixed to ensure the reproducibility of the backend output. This backend only supports gates in the standard library, if you need a more flexible backend, there is always the option to directly instantiate a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object to use for transpilation.
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of qubits that will be used to construct the backend’s target. Note that, while there is no limit in the size of the target that can be constructed, this backend runs on local noisy simulators, and these might present limitations in the number of qubits that can be simulated.
+
+* **basis\_gates** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*] | None*) – List of basis gate names to be supported by the target. These must be part of the standard qiskit circuit library. The default set of basis gates is `["id", "rz", "sx", "x", "cx"]` The `"reset"`, `"delay"`, and `"measure"` instructions are always supported by default, even if not specified via `basis_gates`.
+
+* **coupling\_map** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]] |* [*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") *| None*) –
+
+ Optional coupling map for the backend. Multiple formats are supported:
+
+ 1. [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") instance
+ 2. List, must be given as an edge list representing the two qubit interactions supported by the backend, for example: `[[0, 1], [0, 3], [1, 2], [1, 5], [2, 5], [4, 1], [5, 3]]`
+
+ If `coupling_map` is specified, it must match the number of qubits specified in `num_qubits`. If `coupling_map` is not specified, a fully connected coupling map will be generated with `num_qubits` qubits.
+
+* **control\_flow** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Flag to enable control flow directives on the target (defaults to False).
+
+* **calibrate\_instructions** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *|*[*InstructionScheduleMap*](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") *| None*) –
+
+ Instruction calibration settings, this argument supports both boolean and [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") as input types, and is `None` by default:
+
+ 1. If `calibrate_instructions==None`, no calibrations will be added to the target.
+
+ 2. **If `calibrate_instructions==True`, all gates will be calibrated for all**
+
+ qubits using the default pulse schedules generated internally.
+
+ 3. **If `calibrate_instructions==False`, all gates will be “calibrated” for**
+
+ all qubits with an empty pulse schedule.
+
+ 4. **If an [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") instance is given, the calibrations**
+
+ in this instruction schedule map will be appended to the target instead of the default pulse schedules (this allows for custom calibrations).
+
+* **dtm** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – System time resolution of output signals in nanoseconds. None by default.
+
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – Optional seed for generation of default values.
+
+## Attributes
+
+
+
+### coupling\_map
+
+Return the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object
+
+
+
+### dt
+
+Return the system time resolution of input signals
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The input signal timestep in seconds. If the backend doesn’t define `dt`, `None` will be returned.
+
+
+
+### dtm
+
+Return the system time resolution of output signals
+
+
+
+### instruction\_durations
+
+Return the [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object.
+
+
+
+### instruction\_schedule\_map
+
+Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target.
+
+
+
+### instructions
+
+A list of Instruction tuples on the backend of the form `(instruction, (qubits)`
+
+
+
+### max\_circuits
+
+
+
+### meas\_map
+
+
+
+### num\_qubits
+
+Return the number of qubits the backend has.
+
+
+
+### operation\_names
+
+A list of instruction names that the backend supports.
+
+
+
+### operations
+
+A list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that the backend supports.
+
+
+
+### options
+
+Return the options for the backend
+
+The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the [`run()`](#qiskit.providers.fake_provider.GenericBackendV2.run "qiskit.providers.fake_provider.GenericBackendV2.run") method.
+
+
+
+### provider
+
+Return the backend Provider.
+
+**Returns**
+
+the Provider responsible for the backend.
+
+**Return type**
+
+[Provider](qiskit.providers.Provider "qiskit.providers.Provider")
+
+
+
+### target
+
+
+
+### version
+
+`= 2`
+
+
+
+### name
+
+Name of the backend.
+
+
+
+### description
+
+Optional human-readable description.
+
+
+
+### online\_date
+
+Date that the backend came online.
+
+
+
+### backend\_version
+
+Version of the backend being provided. This is not the same as [`BackendV2.version`](qiskit.providers.BackendV2#version "qiskit.providers.BackendV2.version"), which is the version of the [`Backend`](qiskit.providers.Backend "qiskit.providers.Backend") abstract interface.
+
+## Methods
+
+### acquire\_channel
+
+
+
+`acquire_channel(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement acquisition line.
+
+**Return type**
+
+[AcquireChannel](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### control\_channel
+
+
+
+`control_channel(qubits)`
+
+Return the secondary drive channel for the given qubit
+
+This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`.
+
+**Returns**
+
+The multi qubit control line.
+
+**Return type**
+
+List\[[ControlChannel](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### drive\_channel
+
+
+
+`drive_channel(qubit)`
+
+Return the drive channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit drive channel
+
+**Return type**
+
+[DriveChannel](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### measure\_channel
+
+
+
+`measure_channel(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+This is required to be implemented if the backend supports Pulse scheduling.
+
+**Returns**
+
+The Qubit measurement stimulus line
+
+**Return type**
+
+[MeasureChannel](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the measurement mapping
+
+### qubit\_properties
+
+
+
+`qubit_properties(qubit)`
+
+Return QubitProperties for a given qubit.
+
+If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubit to get the [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for. This can be a single integer for 1 qubit or a list of qubits and a list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects will be returned in the same order
+
+**Returns**
+
+The [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") object for the specified qubit. If a list of qubits is provided a list will be returned. If properties are missing for a qubit this can be `None`.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – if the backend doesn’t support querying the qubit properties
+
+**Return type**
+
+[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties") | [*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QubitProperties*](qiskit.providers.QubitProperties "qiskit.providers.backend.QubitProperties")]
+
+### run
+
+
+
+`run(run_input, **options)`
+
+Run on the backend using a simulator.
+
+This method runs circuit jobs (an individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") ) and pulse jobs (an individual or a list of [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") or [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock")) using [`BasicSimulator`](qiskit.providers.basic_provider.BasicSimulator "qiskit.providers.basic_provider.BasicSimulator") or Aer simulator and returns a [`Job`](qiskit.providers.Job "qiskit.providers.Job") object.
+
+If qiskit-aer is installed, jobs will be run using the `AerSimulator` with noise model of the backend. Otherwise, jobs will be run using the `BasicSimulator` simulator without noise.
+
+Noisy simulations of pulse jobs are not yet supported in [`GenericBackendV2`](#qiskit.providers.fake_provider.GenericBackendV2 "qiskit.providers.fake_provider.GenericBackendV2").
+
+**Parameters**
+
+* **run\_input** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An individual or a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"), or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") objects to run on the backend.
+* **options** – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object, then the expectation is that the value specified will be used instead of what’s set in the options object.
+
+**Returns**
+
+The job object for the run
+
+**Return type**
+
+[Job](qiskit.providers.Job "qiskit.providers.Job")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a pulse job is supplied and qiskit\_aer is not installed.
+
+### set\_options
+
+
+
+`set_options(**fields)`
+
+Set the options fields for the backend
+
+This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
+
+**Parameters**
+
+**fields** – The fields to update the options
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the field passed in is not part of the options
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.models.BackendConfiguration.md b/docs/api/qiskit/0.46/qiskit.providers.models.BackendConfiguration.md
new file mode 100644
index 00000000000..b63ab408201
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.models.BackendConfiguration.md
@@ -0,0 +1,138 @@
+---
+title: BackendConfiguration
+description: API reference for qiskit.providers.models.BackendConfiguration
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.models.BackendConfiguration
+---
+
+# BackendConfiguration
+
+
+
+`qiskit.providers.models.BackendConfiguration(backend_name, backend_version, n_qubits, basis_gates, gates, local, simulator, conditional, open_pulse, memory, max_shots, coupling_map, supported_instructions=None, dynamic_reprate_enabled=False, rep_delay_range=None, default_rep_delay=None, max_experiments=None, sample_name=None, n_registers=None, register_map=None, configurable=None, credits_required=None, online_date=None, display_name=None, description=None, tags=None, dt=None, dtm=None, processor_type=None, parametric_pulses=None, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/models/backendconfiguration.py "view source code")
+
+Bases: [`QasmBackendConfiguration`](qiskit.providers.models.QasmBackendConfiguration "qiskit.providers.models.backendconfiguration.QasmBackendConfiguration")
+
+Backwards compat shim representing an abstract backend configuration.
+
+Initialize a QasmBackendConfiguration Object
+
+**Parameters**
+
+* **backend\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The backend name
+
+* **backend\_version** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The backend version in the form X.Y.Z
+
+* **n\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of qubits for the backend
+
+* **basis\_gates** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – The list of strings for the basis gates of the backends
+
+* **gates** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – The list of GateConfig objects for the basis gates of the backend
+
+* **local** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – True if the backend is local or False if remote
+
+* **simulator** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – True if the backend is a simulator
+
+* **conditional** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – True if the backend supports conditional operations
+
+* **open\_pulse** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – True if the backend supports OpenPulse
+
+* **memory** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – True if the backend supports memory
+
+* **max\_shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The maximum number of shots allowed on the backend
+
+* **coupling\_map** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – The coupling map for the device
+
+* **supported\_instructions** (*List\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – Instructions supported by the backend.
+
+* **dynamic\_reprate\_enabled** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – whether delay between programs can be set dynamically (ie via `rep_delay`). Defaults to False.
+
+* **rep\_delay\_range** (*List\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – 2d list defining supported range of repetition delays for backend in μs. First entry is lower end of the range, second entry is higher end of the range. Optional, but will be specified when `dynamic_reprate_enabled=True`.
+
+* **default\_rep\_delay** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Value of `rep_delay` if not specified by user and `dynamic_reprate_enabled=True`.
+
+* **max\_experiments** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The maximum number of experiments per job
+
+* **sample\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Sample name for the backend
+
+* **n\_registers** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of register slots available for feedback (if conditional is True)
+
+* **register\_map** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An array of dimension n\_qubits X n\_registers that specifies whether a qubit can store a measurement in a certain register slot.
+
+* **configurable** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – True if the backend is configurable, if the backend is a simulator
+
+* **credits\_required** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – True if backend requires credits to run a job.
+
+* **online\_date** ([*datetime.datetime*](https://docs.python.org/3/library/datetime.html#datetime.datetime "(in Python v3.12)")) – The date that the device went online
+
+* **display\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Alternate name field for the backend
+
+* **description** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – A description for the backend
+
+* **tags** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of string tags to describe the backend
+
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Qubit drive channel timestep in nanoseconds.
+
+* **dtm** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Measurement drive channel timestep in nanoseconds.
+
+* **processor\_type** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) –
+
+ Processor type for this backend. A dictionary of the form `{"family": , "revision": , segment: }` such as `{"family": "Canary", "revision": "1.0", segment: "A"}`.
+
+ * family: Processor family of this backend.
+ * revision: Revision version of this processor.
+ * segment: Segment this processor belongs to within a larger chip.
+
+* **parametric\_pulses** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of pulse shapes which are supported on the backend. For example: `['gaussian', 'constant']`
+
+* **\*\*kwargs** – optional fields
+
+## Attributes
+
+
+
+### num\_qubits
+
+Returns the number of qubits.
+
+In future, n\_qubits should be replaced in favor of num\_qubits for consistent use throughout Qiskit. Until this is properly refactored, this property serves as intermediate solution.
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new GateConfig object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary representing the GateConfig to create. It will be in the same format as output by [`to_dict()`](#qiskit.providers.models.BackendConfiguration.to_dict "qiskit.providers.models.BackendConfiguration.to_dict").
+
+**Returns**
+
+The GateConfig from the input dictionary.
+
+**Return type**
+
+[GateConfig](qiskit.providers.models.GateConfig "qiskit.providers.models.GateConfig")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the GateConfig.
+
+**Returns**
+
+The dictionary form of the GateConfig.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.models.BackendProperties.md b/docs/api/qiskit/0.46/qiskit.providers.models.BackendProperties.md
new file mode 100644
index 00000000000..b29342ef9bd
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.models.BackendProperties.md
@@ -0,0 +1,320 @@
+---
+title: BackendProperties
+description: API reference for qiskit.providers.models.BackendProperties
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.models.BackendProperties
+---
+
+# BackendProperties
+
+
+
+`qiskit.providers.models.BackendProperties(backend_name, backend_version, last_update_date, qubits, gates, general, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/models/backendproperties.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Class representing backend properties
+
+This holds backend properties measured by the provider. All properties which are provided optionally. These properties may describe qubits, gates, or other general properties of the backend.
+
+Initialize a BackendProperties instance.
+
+**Parameters**
+
+* **backend\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Backend name.
+* **backend\_version** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Backend version in the form X.Y.Z.
+* **last\_update\_date** ([*datetime.datetime*](https://docs.python.org/3/library/datetime.html#datetime.datetime "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Last date/time that a property was updated. If specified as a `str`, it must be in ISO format.
+* **qubits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – System qubit parameters as a list of lists of [`Nduv`](qiskit.providers.models.Nduv "qiskit.providers.models.Nduv") objects
+* **gates** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – System gate parameters as a list of [`GateProperties`](qiskit.providers.models.GateProperties "qiskit.providers.models.GateProperties") objects
+* **general** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – General parameters as a list of [`Nduv`](qiskit.providers.models.Nduv "qiskit.providers.models.Nduv") objects
+* **kwargs** – optional additional fields
+
+## Methods
+
+### faulty\_gates
+
+
+
+`faulty_gates()`
+
+Return a list of faulty gates.
+
+### faulty\_qubits
+
+
+
+`faulty_qubits()`
+
+Return a list of faulty qubits.
+
+### frequency
+
+
+
+`frequency(qubit)`
+
+Return the frequency of the given qubit.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Qubit for which to return frequency of.
+
+**Returns**
+
+Frequency of the given qubit.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new BackendProperties object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary representing the BackendProperties to create. It will be in the same format as output by [`to_dict()`](#qiskit.providers.models.BackendProperties.to_dict "qiskit.providers.models.BackendProperties.to_dict").
+
+**Returns**
+
+The BackendProperties from the input dictionary.
+
+**Return type**
+
+[BackendProperties](#qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties")
+
+### gate\_error
+
+
+
+`gate_error(gate, qubits)`
+
+Return gate error estimates from backend properties.
+
+**Parameters**
+
+* **gate** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The gate for which to get the error.
+* **qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The specific qubits for the gate.
+
+**Returns**
+
+Gate error of the given gate and qubit(s).
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+### gate\_length
+
+
+
+`gate_length(gate, qubits)`
+
+Return the duration of the gate in units of seconds.
+
+**Parameters**
+
+* **gate** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The gate for which to get the duration.
+* **qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The specific qubits for the gate.
+
+**Returns**
+
+Gate length of the given gate and qubit(s).
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+### gate\_property
+
+
+
+`gate_property(gate, qubits=None, name=None)`
+
+Return the property of the given gate.
+
+**Parameters**
+
+* **gate** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Name of the gate.
+* **qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – The qubit to find the property for.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Optionally used to specify which gate property to return.
+
+**Returns**
+
+Gate property as a tuple of the value and the time it was measured.
+
+**Raises**
+
+[**BackendPropertyError**](providers#qiskit.providers.BackendPropertyError "qiskit.providers.BackendPropertyError") – If the property is not found or name is specified but qubit is not.
+
+**Return type**
+
+[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [*datetime*](https://docs.python.org/3/library/datetime.html#datetime.datetime "(in Python v3.12)")]
+
+### is\_gate\_operational
+
+
+
+`is_gate_operational(gate, qubits=None)`
+
+Return the operational status of the given gate.
+
+**Parameters**
+
+* **gate** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Name of the gate.
+* **qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – The qubit to find the operational status for.
+
+**Returns**
+
+Operational status of the given gate. True if the gate is operational, False otherwise.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### is\_qubit\_operational
+
+
+
+`is_qubit_operational(qubit)`
+
+Return the operational status of the given qubit.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Qubit for which to return operational status of.
+
+**Returns**
+
+Operational status of the given qubit.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### qubit\_property
+
+
+
+`qubit_property(qubit, name=None)`
+
+Return the property of the given qubit.
+
+**Parameters**
+
+* **qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The property to look for.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Optionally used to specify within the hierarchy which property to return.
+
+**Returns**
+
+Qubit property as a tuple of the value and the time it was measured.
+
+**Raises**
+
+[**BackendPropertyError**](providers#qiskit.providers.BackendPropertyError "qiskit.providers.BackendPropertyError") – If the property is not found.
+
+**Return type**
+
+[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [*datetime*](https://docs.python.org/3/library/datetime.html#datetime.datetime "(in Python v3.12)")]
+
+### readout\_error
+
+
+
+`readout_error(qubit)`
+
+Return the readout error of the given qubit.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Qubit for which to return the readout error of.
+
+**Returns**
+
+Readout error of the given qubit.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+### readout\_length
+
+
+
+`readout_length(qubit)`
+
+Return the readout length \[sec] of the given qubit.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Qubit for which to return the readout length of.
+
+**Returns**
+
+Readout length of the given qubit.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+### t1
+
+
+
+`t1(qubit)`
+
+Return the T1 time of the given qubit.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Qubit for which to return the T1 time of.
+
+**Returns**
+
+T1 time of the given qubit.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+### t2
+
+
+
+`t2(qubit)`
+
+Return the T2 time of the given qubit.
+
+**Parameters**
+
+**qubit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Qubit for which to return the T2 time of.
+
+**Returns**
+
+T2 time of the given qubit.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the BackendProperties.
+
+**Returns**
+
+The dictionary form of the BackendProperties.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.models.BackendStatus.md b/docs/api/qiskit/0.46/qiskit.providers.models.BackendStatus.md
new file mode 100644
index 00000000000..7cbf0fa6907
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.models.BackendStatus.md
@@ -0,0 +1,70 @@
+---
+title: BackendStatus
+description: API reference for qiskit.providers.models.BackendStatus
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.models.BackendStatus
+---
+
+# BackendStatus
+
+
+
+`qiskit.providers.models.BackendStatus(backend_name, backend_version, operational, pending_jobs, status_msg)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/models/backendstatus.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Class representing Backend Status.
+
+Initialize a BackendStatus object
+
+**Parameters**
+
+* **backend\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The backend’s name
+* **backend\_version** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The backend’s version of the form X.Y.Z
+* **operational** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – True if the backend is operational
+* **pending\_jobs** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of pending jobs on the backend
+* **status\_msg** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The status msg for the backend
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If the backend version is in an invalid format
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new BackendStatus object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary representing the BaseBakend to create. It will be in the same format as output by [`to_dict()`](#qiskit.providers.models.BackendStatus.to_dict "qiskit.providers.models.BackendStatus.to_dict").
+
+**Returns**
+
+The BackendStatus from the input dictionary.
+
+**Return type**
+
+[BackendStatus](#qiskit.providers.models.BackendStatus "qiskit.providers.models.BackendStatus")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the BackendStatus.
+
+**Returns**
+
+The dictionary form of the QobjHeader.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.models.Command.md b/docs/api/qiskit/0.46/qiskit.providers.models.Command.md
new file mode 100644
index 00000000000..50a6ba8a580
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.models.Command.md
@@ -0,0 +1,71 @@
+---
+title: Command
+description: API reference for qiskit.providers.models.Command
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.models.Command
+---
+
+# Command
+
+
+
+`qiskit.providers.models.Command(name, qubits=None, sequence=None, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/models/pulsedefaults.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Class representing a Command.
+
+
+
+### name
+
+Pulse command name.
+
+Initialize a Command object
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the command
+* **qubits** – The qubits for the command
+* **sequence** ([*PulseQobjInstruction*](qiskit.qobj.PulseQobjInstruction "qiskit.qobj.PulseQobjInstruction")) – The sequence for the Command
+* **kwargs** – Optional additional fields
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new Command object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary representing the `Command` to create. It will be in the same format as output by [`to_dict()`](#qiskit.providers.models.Command.to_dict "qiskit.providers.models.Command.to_dict").
+
+**Returns**
+
+The `Command` from the input dictionary.
+
+**Return type**
+
+[Command](#qiskit.providers.models.Command "qiskit.providers.models.Command")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the Command.
+
+**Returns**
+
+The dictionary form of the Command.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.models.GateConfig.md b/docs/api/qiskit/0.46/qiskit.providers.models.GateConfig.md
new file mode 100644
index 00000000000..4ddad930d1d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.models.GateConfig.md
@@ -0,0 +1,86 @@
+---
+title: GateConfig
+description: API reference for qiskit.providers.models.GateConfig
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.models.GateConfig
+---
+
+# GateConfig
+
+
+
+`qiskit.providers.models.GateConfig(name, parameters, qasm_def, coupling_map=None, latency_map=None, conditional=None, description=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/models/backendconfiguration.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Class representing a Gate Configuration
+
+
+
+### name
+
+the gate name as it will be referred to in OpenQASM.
+
+
+
+### parameters
+
+variable names for the gate parameters (if any).
+
+
+
+### qasm\_def
+
+definition of this gate in terms of OpenQASM 2 primitives U and CX.
+
+Initialize a GateConfig object
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – the gate name as it will be referred to in OpenQASM.
+* **parameters** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – variable names for the gate parameters (if any) as a list of strings.
+* **qasm\_def** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – definition of this gate in terms of OpenQASM 2 primitives U and CX.
+* **coupling\_map** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An optional coupling map for the gate. In the form of a list of lists of integers representing the qubit groupings which are coupled by this gate.
+* **latency\_map** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An optional map of latency for the gate. In the the form of a list of lists of integers of either 0 or 1 representing an array of dimension len(coupling\_map) X n\_registers that specifies the register latency (1: fast, 0: slow) conditional operations on the gate
+* **conditional** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Optionally specify whether this gate supports conditional operations (true/false). If this is not specified, then the gate inherits the conditional property of the backend.
+* **description** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Description of the gate operation
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new GateConfig object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary representing the GateConfig to create. It will be in the same format as output by [`to_dict()`](#qiskit.providers.models.GateConfig.to_dict "qiskit.providers.models.GateConfig.to_dict").
+
+**Returns**
+
+The GateConfig from the input dictionary.
+
+**Return type**
+
+[GateConfig](#qiskit.providers.models.GateConfig "qiskit.providers.models.GateConfig")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the GateConfig.
+
+**Returns**
+
+The dictionary form of the GateConfig.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.models.GateProperties.md b/docs/api/qiskit/0.46/qiskit.providers.models.GateProperties.md
new file mode 100644
index 00000000000..3fa85cb86c5
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.models.GateProperties.md
@@ -0,0 +1,83 @@
+---
+title: GateProperties
+description: API reference for qiskit.providers.models.GateProperties
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.models.GateProperties
+---
+
+# GateProperties
+
+
+
+`qiskit.providers.models.GateProperties(qubits, gate, parameters, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/models/backendproperties.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Class representing a gate’s properties
+
+
+
+### qubits
+
+qubits.
+
+
+
+### gate
+
+gate.
+
+
+
+### parameters
+
+parameters.
+
+Initialize a new [`GateProperties`](#qiskit.providers.models.GateProperties "qiskit.providers.models.GateProperties") object
+
+**Parameters**
+
+* **qubits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of integers representing qubits
+* **gate** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The gates name
+* **parameters** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – List of [`Nduv`](qiskit.providers.models.Nduv "qiskit.providers.models.Nduv") objects for the name-date-unit-value for the gate
+* **kwargs** – Optional additional fields
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new Gate object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary representing the Gate to create. It will be in the same format as output by [`to_dict()`](#qiskit.providers.models.GateProperties.to_dict "qiskit.providers.models.GateProperties.to_dict").
+
+**Returns**
+
+The Nduv from the input dictionary.
+
+**Return type**
+
+[GateProperties](#qiskit.providers.models.GateProperties "qiskit.providers.models.GateProperties")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the BackendStatus.
+
+**Returns**
+
+The dictionary form of the Gate.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.models.JobStatus.md b/docs/api/qiskit/0.46/qiskit.providers.models.JobStatus.md
new file mode 100644
index 00000000000..55c464b936b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.models.JobStatus.md
@@ -0,0 +1,86 @@
+---
+title: JobStatus
+description: API reference for qiskit.providers.models.JobStatus
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.models.JobStatus
+---
+
+# JobStatus
+
+
+
+`qiskit.providers.models.JobStatus(job_id, status, status_msg, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/models/jobstatus.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Model for JobStatus.
+
+
+
+### job\_id
+
+backend job\_id.
+
+**Type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+
+
+### status
+
+status of the job.
+
+**Type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+
+
+### status\_msg
+
+status message.
+
+**Type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new JobStatus object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary representing the JobStatus to create. It will be in the same format as output by [`to_dict()`](#qiskit.providers.models.JobStatus.to_dict "qiskit.providers.models.JobStatus.to_dict").
+
+**Returns**
+
+The `JobStatus` from the input dictionary.
+
+**Return type**
+
+[JobStatus](#qiskit.providers.models.JobStatus "qiskit.providers.models.JobStatus")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the JobStatus.
+
+**Returns**
+
+The dictionary form of the JobStatus.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.models.Nduv.md b/docs/api/qiskit/0.46/qiskit.providers.models.Nduv.md
new file mode 100644
index 00000000000..2465fedf57e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.models.Nduv.md
@@ -0,0 +1,89 @@
+---
+title: Nduv
+description: API reference for qiskit.providers.models.Nduv
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.models.Nduv
+---
+
+# Nduv
+
+
+
+`qiskit.providers.models.Nduv(date, name, unit, value)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/models/backendproperties.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Class representing name-date-unit-value
+
+
+
+### date
+
+date.
+
+
+
+### name
+
+name.
+
+
+
+### unit
+
+unit.
+
+
+
+### value
+
+value.
+
+Initialize a new name-date-unit-value object
+
+**Parameters**
+
+* **date** ([*datetime.datetime*](https://docs.python.org/3/library/datetime.html#datetime.datetime "(in Python v3.12)")) – Date field
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Name field
+* **unit** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Nduv unit
+* **value** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The value of the Nduv
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new Nduv object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary representing the Nduv to create. It will be in the same format as output by [`to_dict()`](#qiskit.providers.models.Nduv.to_dict "qiskit.providers.models.Nduv.to_dict").
+
+**Returns**
+
+The Nduv from the input dictionary.
+
+**Return type**
+
+[Nduv](#qiskit.providers.models.Nduv "qiskit.providers.models.Nduv")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the object.
+
+**Returns**
+
+The dictionary form of the Nduv.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.models.PulseBackendConfiguration.md b/docs/api/qiskit/0.46/qiskit.providers.models.PulseBackendConfiguration.md
new file mode 100644
index 00000000000..545750b3068
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.models.PulseBackendConfiguration.md
@@ -0,0 +1,284 @@
+---
+title: PulseBackendConfiguration
+description: API reference for qiskit.providers.models.PulseBackendConfiguration
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.models.PulseBackendConfiguration
+---
+
+# PulseBackendConfiguration
+
+
+
+`qiskit.providers.models.PulseBackendConfiguration(backend_name, backend_version, n_qubits, basis_gates, gates, local, simulator, conditional, open_pulse, memory, max_shots, coupling_map, n_uchannels, u_channel_lo, meas_levels, qubit_lo_range, meas_lo_range, dt, dtm, rep_times, meas_kernels, discriminators, hamiltonian=None, channel_bandwidth=None, acquisition_latency=None, conditional_latency=None, meas_map=None, max_experiments=None, sample_name=None, n_registers=None, register_map=None, configurable=None, credits_required=None, online_date=None, display_name=None, description=None, tags=None, channels=None, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/models/backendconfiguration.py "view source code")
+
+Bases: [`QasmBackendConfiguration`](qiskit.providers.models.QasmBackendConfiguration "qiskit.providers.models.backendconfiguration.QasmBackendConfiguration")
+
+Static configuration state for an OpenPulse enabled backend. This contains information about the set up of the device which can be useful for building Pulse programs.
+
+Initialize a backend configuration that contains all the extra configuration that is made available for OpenPulse backends.
+
+**Parameters**
+
+* **backend\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – backend name.
+* **backend\_version** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – backend version in the form X.Y.Z.
+* **n\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of qubits.
+* **basis\_gates** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – list of basis gates names on the backend.
+* **gates** ([*GateConfig*](qiskit.providers.models.GateConfig "qiskit.providers.models.backendconfiguration.GateConfig")) – list of basis gates on the backend.
+* **local** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – backend is local or remote.
+* **simulator** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – backend is a simulator.
+* **conditional** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – backend supports conditional operations.
+* **open\_pulse** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – backend supports open pulse.
+* **memory** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – backend supports memory.
+* **max\_shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – maximum number of shots supported.
+* **coupling\_map** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – The coupling map for the device
+* **n\_uchannels** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of u-channels.
+* **u\_channel\_lo** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*UchannelLO*](qiskit.providers.models.UchannelLO "qiskit.providers.models.backendconfiguration.UchannelLO")*]]*) – U-channel relationship on device los.
+* **meas\_levels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Supported measurement levels.
+* **qubit\_lo\_range** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]]*) – Qubit lo ranges for each qubit with form (min, max) in GHz.
+* **meas\_lo\_range** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]]*) – Measurement lo ranges for each qubit with form (min, max) in GHz.
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Qubit drive channel timestep in nanoseconds.
+* **dtm** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Measurement drive channel timestep in nanoseconds.
+* **rep\_times** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – Supported repetition times (program execution time) for backend in μs.
+* **meas\_kernels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – Supported measurement kernels.
+* **discriminators** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – Supported discriminators.
+* **hamiltonian** ([*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")*]*) – An optional dictionary with fields characterizing the system hamiltonian.
+* **channel\_bandwidth** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – Bandwidth of all channels (qubit, measurement, and U)
+* **acquisition\_latency** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – Array of dimension n\_qubits x n\_registers. Latency (in units of dt) to write a measurement result from qubit n into register slot m.
+* **conditional\_latency** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – Array of dimension n\_channels \[d->u->m] x n\_registers. Latency (in units of dt) to do a conditional operation on channel n from register slot m
+* **meas\_map** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – Grouping of measurement which are multiplexed
+* **max\_experiments** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The maximum number of experiments per job
+* **sample\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Sample name for the backend
+* **n\_registers** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of register slots available for feedback (if conditional is True)
+* **register\_map** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An array of dimension n\_qubits X n\_registers that specifies whether a qubit can store a measurement in a certain register slot.
+* **configurable** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – True if the backend is configurable, if the backend is a simulator
+* **credits\_required** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – True if backend requires credits to run a job.
+* **online\_date** ([*datetime.datetime*](https://docs.python.org/3/library/datetime.html#datetime.datetime "(in Python v3.12)")) – The date that the device went online
+* **display\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Alternate name field for the backend
+* **description** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – A description for the backend
+* **tags** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of string tags to describe the backend
+* **channels** ([*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")*]*) – An optional dictionary containing information of each channel – their purpose, type, and qubits operated on.
+* **\*\*kwargs** – Optional fields.
+
+## Attributes
+
+
+
+### control\_channels
+
+Return the control channels
+
+
+
+### num\_qubits
+
+Returns the number of qubits.
+
+In future, n\_qubits should be replaced in favor of num\_qubits for consistent use throughout Qiskit. Until this is properly refactored, this property serves as intermediate solution.
+
+
+
+### sample\_rate
+
+Sample rate of the signal channels in Hz (1/dt).
+
+## Methods
+
+### acquire
+
+
+
+`acquire(qubit)`
+
+Return the acquisition channel for the given qubit.
+
+**Raises**
+
+[**BackendConfigurationError**](providers#qiskit.providers.BackendConfigurationError "qiskit.providers.BackendConfigurationError") – If the qubit is not a part of the system.
+
+**Returns**
+
+Qubit measurement acquisition line.
+
+**Return type**
+
+[*AcquireChannel*](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+
+### control
+
+
+
+`control(qubits=None)`
+
+Return the secondary drive channel for the given qubit – typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
+
+**Parameters**
+
+**qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – Tuple or list of qubits of the form (control\_qubit, target\_qubit).
+
+**Raises**
+
+[**BackendConfigurationError**](providers#qiskit.providers.BackendConfigurationError "qiskit.providers.BackendConfigurationError") – If the `qubits` is not a part of the system or if the backend does not provide channels information in its configuration.
+
+**Returns**
+
+List of control channels.
+
+**Return type**
+
+[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*ControlChannel*](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")]
+
+### describe
+
+
+
+`describe(channel)`
+
+Return a basic description of the channel dependency. Derived channels are given weights which describe how their frames are linked to other frames. For instance, the backend could be configured with this setting:
+
+```python
+u_channel_lo = [
+ [UchannelLO(q=0, scale=1. + 0.j)],
+ [UchannelLO(q=0, scale=-1. + 0.j), UchannelLO(q=1, scale=1. + 0.j)]
+]
+```
+
+Then, this method can be used as follows:
+
+```python
+backend.configuration().describe(ControlChannel(1))
+>>> {DriveChannel(0): -1, DriveChannel(1): 1}
+```
+
+**Parameters**
+
+**channel** ([*ControlChannel*](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")) – The derived channel to describe.
+
+**Raises**
+
+[**BackendConfigurationError**](providers#qiskit.providers.BackendConfigurationError "qiskit.providers.BackendConfigurationError") – If channel is not a ControlChannel.
+
+**Returns**
+
+Control channel derivations.
+
+**Return type**
+
+[*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")\[[*DriveChannel*](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel"), [complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")]
+
+### drive
+
+
+
+`drive(qubit)`
+
+Return the drive channel for the given qubit.
+
+**Raises**
+
+[**BackendConfigurationError**](providers#qiskit.providers.BackendConfigurationError "qiskit.providers.BackendConfigurationError") – If the qubit is not a part of the system.
+
+**Returns**
+
+Qubit drive channel.
+
+**Return type**
+
+[*DriveChannel*](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new GateConfig object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary representing the GateConfig to create. It will be in the same format as output by [`to_dict()`](#qiskit.providers.models.PulseBackendConfiguration.to_dict "qiskit.providers.models.PulseBackendConfiguration.to_dict").
+
+**Returns**
+
+The GateConfig from the input dictionary.
+
+**Return type**
+
+[GateConfig](qiskit.providers.models.GateConfig "qiskit.providers.models.GateConfig")
+
+### get\_channel\_qubits
+
+
+
+`get_channel_qubits(channel)`
+
+Return a list of indices for qubits which are operated on directly by the given `channel`.
+
+**Raises**
+
+[**BackendConfigurationError**](providers#qiskit.providers.BackendConfigurationError "qiskit.providers.BackendConfigurationError") – If `channel` is not a found or if the backend does not provide channels information in its configuration.
+
+**Returns**
+
+List of qubits operated on my the given `channel`.
+
+**Return type**
+
+[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")]
+
+### get\_qubit\_channels
+
+
+
+`get_qubit_channels(qubit)`
+
+Return a list of channels which operate on the given `qubit`.
+
+**Raises**
+
+[**BackendConfigurationError**](providers#qiskit.providers.BackendConfigurationError "qiskit.providers.BackendConfigurationError") – If `qubit` is not a found or if the backend does not provide channels information in its configuration.
+
+**Returns**
+
+List of `Channel`s operated on my the given `qubit`.
+
+**Return type**
+
+[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")]
+
+### measure
+
+
+
+`measure(qubit)`
+
+Return the measure stimulus channel for the given qubit.
+
+**Raises**
+
+[**BackendConfigurationError**](providers#qiskit.providers.BackendConfigurationError "qiskit.providers.BackendConfigurationError") – If the qubit is not a part of the system.
+
+**Returns**
+
+Qubit measurement stimulus line.
+
+**Return type**
+
+[*MeasureChannel*](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the GateConfig.
+
+**Returns**
+
+The dictionary form of the GateConfig.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.models.PulseDefaults.md b/docs/api/qiskit/0.46/qiskit.providers.models.PulseDefaults.md
new file mode 100644
index 00000000000..f17521e10fa
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.models.PulseDefaults.md
@@ -0,0 +1,64 @@
+---
+title: PulseDefaults
+description: API reference for qiskit.providers.models.PulseDefaults
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.models.PulseDefaults
+---
+
+# PulseDefaults
+
+
+
+`qiskit.providers.models.PulseDefaults(qubit_freq_est, meas_freq_est, buffer, pulse_library, cmd_def, meas_kernel=None, discriminator=None, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/models/pulsedefaults.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Description of default settings for Pulse systems. These are instructions or settings that may be good starting points for the Pulse user. The user may modify these defaults for custom scheduling.
+
+Validate and reformat transport layer inputs to initialize. :param qubit\_freq\_est: Estimated qubit frequencies in GHz. :param meas\_freq\_est: Estimated measurement cavity frequencies in GHz. :param buffer: Default buffer time (in units of dt) between pulses. :param pulse\_library: Pulse name and sample definitions. :param cmd\_def: Operation name and definition in terms of Commands. :param meas\_kernel: The measurement kernels :param discriminator: The discriminators :param \*\*kwargs: Other attributes for the super class.
+
+## Attributes
+
+
+
+### qubit\_freq\_est
+
+Qubit frequencies in Hertz.
+
+
+
+### meas\_freq\_est
+
+Measurement frequencies in Hertz.
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new PulseDefaults object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary representing the PulseDefaults to create. It will be in the same format as output by [`to_dict()`](#qiskit.providers.models.PulseDefaults.to_dict "qiskit.providers.models.PulseDefaults.to_dict").
+
+**Returns**
+
+The PulseDefaults from the input dictionary.
+
+**Return type**
+
+[PulseDefaults](#qiskit.providers.models.PulseDefaults "qiskit.providers.models.PulseDefaults")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the PulseDefaults. :returns: The dictionary form of the PulseDefaults. :rtype: dict
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.models.QasmBackendConfiguration.md b/docs/api/qiskit/0.46/qiskit.providers.models.QasmBackendConfiguration.md
new file mode 100644
index 00000000000..83aa9a1c171
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.models.QasmBackendConfiguration.md
@@ -0,0 +1,204 @@
+---
+title: QasmBackendConfiguration
+description: API reference for qiskit.providers.models.QasmBackendConfiguration
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.models.QasmBackendConfiguration
+---
+
+# QasmBackendConfiguration
+
+
+
+`qiskit.providers.models.QasmBackendConfiguration(backend_name, backend_version, n_qubits, basis_gates, gates, local, simulator, conditional, open_pulse, memory, max_shots, coupling_map, supported_instructions=None, dynamic_reprate_enabled=False, rep_delay_range=None, default_rep_delay=None, max_experiments=None, sample_name=None, n_registers=None, register_map=None, configurable=None, credits_required=None, online_date=None, display_name=None, description=None, tags=None, dt=None, dtm=None, processor_type=None, parametric_pulses=None, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/models/backendconfiguration.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Class representing an OpenQASM 2.0 Backend Configuration.
+
+
+
+### backend\_name
+
+backend name.
+
+
+
+### backend\_version
+
+backend version in the form X.Y.Z.
+
+
+
+### n\_qubits
+
+number of qubits.
+
+
+
+### basis\_gates
+
+list of basis gates names on the backend.
+
+
+
+### gates
+
+list of basis gates on the backend.
+
+
+
+### local
+
+backend is local or remote.
+
+
+
+### simulator
+
+backend is a simulator.
+
+
+
+### conditional
+
+backend supports conditional operations.
+
+
+
+### open\_pulse
+
+backend supports open pulse.
+
+
+
+### memory
+
+backend supports memory.
+
+
+
+### max\_shots
+
+maximum number of shots supported.
+
+Initialize a QasmBackendConfiguration Object
+
+**Parameters**
+
+* **backend\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The backend name
+
+* **backend\_version** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The backend version in the form X.Y.Z
+
+* **n\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of qubits for the backend
+
+* **basis\_gates** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – The list of strings for the basis gates of the backends
+
+* **gates** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – The list of GateConfig objects for the basis gates of the backend
+
+* **local** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – True if the backend is local or False if remote
+
+* **simulator** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – True if the backend is a simulator
+
+* **conditional** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – True if the backend supports conditional operations
+
+* **open\_pulse** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – True if the backend supports OpenPulse
+
+* **memory** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – True if the backend supports memory
+
+* **max\_shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The maximum number of shots allowed on the backend
+
+* **coupling\_map** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – The coupling map for the device
+
+* **supported\_instructions** (*List\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – Instructions supported by the backend.
+
+* **dynamic\_reprate\_enabled** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – whether delay between programs can be set dynamically (ie via `rep_delay`). Defaults to False.
+
+* **rep\_delay\_range** (*List\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – 2d list defining supported range of repetition delays for backend in μs. First entry is lower end of the range, second entry is higher end of the range. Optional, but will be specified when `dynamic_reprate_enabled=True`.
+
+* **default\_rep\_delay** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Value of `rep_delay` if not specified by user and `dynamic_reprate_enabled=True`.
+
+* **max\_experiments** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The maximum number of experiments per job
+
+* **sample\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Sample name for the backend
+
+* **n\_registers** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of register slots available for feedback (if conditional is True)
+
+* **register\_map** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – An array of dimension n\_qubits X n\_registers that specifies whether a qubit can store a measurement in a certain register slot.
+
+* **configurable** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – True if the backend is configurable, if the backend is a simulator
+
+* **credits\_required** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – True if backend requires credits to run a job.
+
+* **online\_date** ([*datetime.datetime*](https://docs.python.org/3/library/datetime.html#datetime.datetime "(in Python v3.12)")) – The date that the device went online
+
+* **display\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Alternate name field for the backend
+
+* **description** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – A description for the backend
+
+* **tags** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of string tags to describe the backend
+
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Qubit drive channel timestep in nanoseconds.
+
+* **dtm** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Measurement drive channel timestep in nanoseconds.
+
+* **processor\_type** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) –
+
+ Processor type for this backend. A dictionary of the form `{"family": , "revision": , segment: }` such as `{"family": "Canary", "revision": "1.0", segment: "A"}`.
+
+ * family: Processor family of this backend.
+ * revision: Revision version of this processor.
+ * segment: Segment this processor belongs to within a larger chip.
+
+* **parametric\_pulses** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of pulse shapes which are supported on the backend. For example: `['gaussian', 'constant']`
+
+* **\*\*kwargs** – optional fields
+
+## Attributes
+
+
+
+### num\_qubits
+
+Returns the number of qubits.
+
+In future, n\_qubits should be replaced in favor of num\_qubits for consistent use throughout Qiskit. Until this is properly refactored, this property serves as intermediate solution.
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new GateConfig object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary representing the GateConfig to create. It will be in the same format as output by [`to_dict()`](#qiskit.providers.models.QasmBackendConfiguration.to_dict "qiskit.providers.models.QasmBackendConfiguration.to_dict").
+
+**Returns**
+
+The GateConfig from the input dictionary.
+
+**Return type**
+
+[GateConfig](qiskit.providers.models.GateConfig "qiskit.providers.models.GateConfig")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the GateConfig.
+
+**Returns**
+
+The dictionary form of the GateConfig.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.providers.models.UchannelLO.md b/docs/api/qiskit/0.46/qiskit.providers.models.UchannelLO.md
new file mode 100644
index 00000000000..a3cca3b3fd0
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.providers.models.UchannelLO.md
@@ -0,0 +1,79 @@
+---
+title: UchannelLO
+description: API reference for qiskit.providers.models.UchannelLO
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.providers.models.UchannelLO
+---
+
+# UchannelLO
+
+
+
+`qiskit.providers.models.UchannelLO(q, scale)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/providers/models/backendconfiguration.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Class representing a U Channel LO
+
+
+
+### q
+
+Qubit that scale corresponds too.
+
+
+
+### scale
+
+Scale factor for qubit frequency.
+
+Initialize a UchannelLOSchema object
+
+**Parameters**
+
+* **q** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Qubit that scale corresponds too. Must be >= 0.
+* **scale** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")) – Scale factor for qubit frequency.
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If q is \< 0
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new UchannelLO object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary representing the UChannelLO to create. It will be in the same format as output by [`to_dict()`](#qiskit.providers.models.UchannelLO.to_dict "qiskit.providers.models.UchannelLO.to_dict").
+
+**Returns**
+
+The UchannelLO from the input dictionary.
+
+**Return type**
+
+[UchannelLO](#qiskit.providers.models.UchannelLO "qiskit.providers.models.UchannelLO")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the UChannelLO.
+
+**Returns**
+
+The dictionary form of the UChannelLO.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.InstructionScheduleMap.md b/docs/api/qiskit/0.46/qiskit.pulse.InstructionScheduleMap.md
new file mode 100644
index 00000000000..3653fa35d41
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.InstructionScheduleMap.md
@@ -0,0 +1,241 @@
+---
+title: InstructionScheduleMap
+description: API reference for qiskit.pulse.InstructionScheduleMap
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.InstructionScheduleMap
+---
+
+# InstructionScheduleMap
+
+
+
+`qiskit.pulse.InstructionScheduleMap`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/instruction_schedule_map.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Mapping from [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") [`qiskit.circuit.Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") names and qubits to [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") s. In particular, the mapping is formatted as type:
+
+```python
+Dict[str, Dict[Tuple[int], Schedule]]
+```
+
+where the first key is the name of a circuit instruction (e.g. `'u1'`, `'measure'`), the second key is a tuple of qubit indices, and the final value is a Schedule implementing the requested instruction.
+
+These can usually be seen as gate calibrations.
+
+Initialize a circuit instruction to schedule mapper instance.
+
+## Attributes
+
+
+
+### instructions
+
+Return all instructions which have definitions.
+
+By default, these are typically the basis gates along with other instructions such as measure and reset.
+
+**Returns**
+
+The names of all the circuit instructions which have Schedule definitions in this.
+
+## Methods
+
+### add
+
+
+
+`add(instruction, qubits, schedule, arguments=None)`
+
+Add a new known instruction for the given qubits and its mapping to a pulse schedule.
+
+**Parameters**
+
+* **instruction** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*Instruction*](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")) – The name of the instruction to add.
+* **qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubits which the instruction applies to.
+* **schedule** ([*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule") *|*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock") *|*[*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")*\[\[...],* [*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule") *|*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock")*]*) – The Schedule that implements the given instruction.
+* **arguments** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*] | None*) – List of parameter names to create a parameter-bound schedule from the associated gate instruction. If [`get()`](#qiskit.pulse.InstructionScheduleMap.get "qiskit.pulse.InstructionScheduleMap.get") is called with arguments rather than keyword arguments, this parameter list is used to map the input arguments to parameter objects stored in the target schedule.
+
+**Raises**
+
+[**PulseError**](pulse#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – If the qubits are provided as an empty iterable.
+
+### assert\_has
+
+
+
+`assert_has(instruction, qubits)`
+
+Error if the given instruction is not defined.
+
+**Parameters**
+
+* **instruction** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*Instruction*](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")) – The instruction for which to look.
+* **qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The specific qubits for the instruction.
+
+**Raises**
+
+[**PulseError**](pulse#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – If the instruction is not defined on the qubits.
+
+### get
+
+
+
+`get(instruction, qubits, *params, **kwparams)`
+
+Return the defined [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") or [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") for the given instruction on the given qubits.
+
+If all keys are not specified this method returns schedule with unbound parameters.
+
+**Parameters**
+
+* **instruction** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*Instruction*](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")) – Name of the instruction or the instruction itself.
+* **qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubits for the instruction.
+* **\*params** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – Command parameters for generating the output schedule.
+* **\*\*kwparams** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – Keyworded command parameters for generating the schedule.
+
+**Returns**
+
+The Schedule defined for the input.
+
+**Return type**
+
+[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule") | [*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock")
+
+### get\_parameters
+
+
+
+`get_parameters(instruction, qubits)`
+
+Return the list of parameters taken by the given instruction on the given qubits.
+
+**Parameters**
+
+* **instruction** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*Instruction*](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")) – Name of the instruction.
+* **qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubits for the instruction.
+
+**Returns**
+
+The names of the parameters required by the instruction.
+
+**Return type**
+
+[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")]
+
+### has
+
+
+
+`has(instruction, qubits)`
+
+Is the instruction defined for the given qubits?
+
+**Parameters**
+
+* **instruction** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*Instruction*](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")) – The instruction for which to look.
+* **qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The specific qubits for the instruction.
+
+**Returns**
+
+True iff the instruction is defined.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### has\_custom\_gate
+
+
+
+`has_custom_gate()`
+
+Return `True` if the map has user provided instruction.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### pop
+
+
+
+`pop(instruction, qubits, *params, **kwparams)`
+
+Remove and return the defined schedule for the given instruction on the given qubits.
+
+**Parameters**
+
+* **instruction** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*Instruction*](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")) – Name of the instruction.
+* **qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubits for the instruction.
+* **\*params** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – Command parameters for generating the output schedule.
+* **\*\*kwparams** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – Keyworded command parameters for generating the schedule.
+
+**Returns**
+
+The Schedule defined for the input.
+
+**Return type**
+
+[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule") | [*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock")
+
+### qubit\_instructions
+
+
+
+`qubit_instructions(qubits)`
+
+Return a list of the instruction names that are defined by the backend for the given qubit or qubits.
+
+**Parameters**
+
+**qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – A qubit index, or a list or tuple of indices.
+
+**Returns**
+
+All the instructions which are defined on the qubits.
+
+For 1 qubit, all the 1Q instructions defined. For multiple qubits, all the instructions which apply to that whole set of qubits (e.g. `qubits=[0, 1]` may return `['cx']`).
+
+**Return type**
+
+[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")]
+
+### qubits\_with\_instruction
+
+
+
+`qubits_with_instruction(instruction)`
+
+Return a list of the qubits for which the given instruction is defined. Single qubit instructions return a flat list, and multiqubit instructions return a list of ordered tuples.
+
+**Parameters**
+
+**instruction** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*Instruction*](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")) – The name of the circuit instruction.
+
+**Returns**
+
+Qubit indices which have the given instruction defined. This is a list of tuples if the instruction has an arity greater than 1, or a flat list of ints otherwise.
+
+**Raises**
+
+[**PulseError**](pulse#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – If the instruction is not found.
+
+**Return type**
+
+[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") | [*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")\[[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")]]
+
+### remove
+
+
+
+`remove(instruction, qubits)`
+
+Remove the given instruction from the listing of instructions defined in self.
+
+**Parameters**
+
+* **instruction** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*Instruction*](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")) – The name of the instruction to add.
+* **qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The qubits which the instruction applies to.
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.Schedule.md b/docs/api/qiskit/0.46/qiskit.pulse.Schedule.md
new file mode 100644
index 00000000000..f7282caf622
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.Schedule.md
@@ -0,0 +1,498 @@
+---
+title: Schedule
+description: API reference for qiskit.pulse.Schedule
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.Schedule
+---
+
+# Schedule
+
+
+
+`qiskit.pulse.Schedule(*schedules, name=None, metadata=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/schedule.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+A quantum program *schedule* with exact time constraints for its instructions, operating over all input signal *channels* and supporting special syntaxes for building.
+
+Pulse program representation for the original Qiskit Pulse model \[1]. Instructions are not allowed to overlap in time on the same channel. This overlap constraint is immediately evaluated when a new instruction is added to the `Schedule` object.
+
+It is necessary to specify the absolute start time and duration for each instruction so as to deterministically fix its execution time.
+
+The `Schedule` program supports some syntax sugar for easier programming.
+
+* Appending an instruction to the end of a channel
+
+ ```python
+ sched = Schedule()
+ sched += Play(Gaussian(160, 0.1, 40), DriveChannel(0))
+ ```
+
+* Appending an instruction shifted in time by a given amount
+
+ ```python
+ sched = Schedule()
+ sched += Play(Gaussian(160, 0.1, 40), DriveChannel(0)) << 30
+ ```
+
+* Merge two schedules
+
+ ```python
+ sched1 = Schedule()
+ sched1 += Play(Gaussian(160, 0.1, 40), DriveChannel(0))
+
+ sched2 = Schedule()
+ sched2 += Play(Gaussian(160, 0.1, 40), DriveChannel(1))
+ sched2 = sched1 | sched2
+ ```
+
+A [`PulseError`](pulse#qiskit.pulse.PulseError "qiskit.pulse.PulseError") is immediately raised when the overlap constraint is violated.
+
+In the schedule representation, we cannot parametrize the duration of instructions. Thus we need to create a new schedule object for each duration. To parametrize an instruction’s duration, the [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") representation may be used instead.
+
+**References**
+
+\[1]: [https://arxiv.org/abs/2004.06755](https://arxiv.org/abs/2004.06755)
+
+Create an empty schedule.
+
+**Parameters**
+
+* **\*schedules** (*ScheduleComponent |* [*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*, ScheduleComponent]*) – Child Schedules of this parent Schedule. May either be passed as the list of schedules, or a list of `(start_time, schedule)` pairs.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of this schedule. Defaults to an autogenerated string if not provided.
+* **metadata** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *| None*) – Arbitrary key value metadata to associate with the schedule. This gets stored as free-form data in a dict in the [`metadata`](#qiskit.pulse.Schedule.metadata "qiskit.pulse.Schedule.metadata") attribute. It will not be directly used in the schedule.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – if metadata is not a dict.
+
+## Attributes
+
+
+
+### channels
+
+Returns channels that this schedule uses.
+
+
+
+### children
+
+Return the child schedule components of this `Schedule` in the order they were added to the schedule.
+
+**Notes**
+
+Nested schedules are returned as-is. If you want to collect only instructions, use py:meth:\~Schedule.instructions instead.
+
+**Returns**
+
+A tuple, where each element is a two-tuple containing the initial scheduled time of each `NamedValue` and the component itself.
+
+
+
+### duration
+
+Duration of this schedule.
+
+
+
+### instances\_counter
+
+`= count(0)`
+
+
+
+### instructions
+
+Get the time-ordered instructions from self.
+
+
+
+### metadata
+
+The user provided metadata associated with the schedule.
+
+User provided `dict` of metadata for the schedule. The metadata contents do not affect the semantics of the program but are used to influence the execution of the schedule. It is expected to be passed between all transforms of the schedule and that providers will associate any schedule metadata with the results it returns from the execution of that schedule.
+
+
+
+### name
+
+Name of this Schedule
+
+
+
+### parameters
+
+Parameters which determine the schedule behavior.
+
+
+
+### prefix
+
+`= 'sched'`
+
+
+
+### start\_time
+
+Starting time of this schedule.
+
+
+
+### stop\_time
+
+Stopping time of this schedule.
+
+
+
+### timeslots
+
+Time keeping attribute.
+
+## Methods
+
+### append
+
+
+
+`append(schedule, name=None, inplace=False)`
+
+Return a new schedule with `schedule` inserted at the maximum time over all channels shared between `self` and `schedule`.
+
+$$
+t = \textrm{max}(\texttt{x.stop_time} |\texttt{x} \in
+ \texttt{self.channels} \cap \texttt{schedule.channels})
+$$
+
+**Parameters**
+
+* **schedule** ([*Schedule*](#qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule") *|*[*Instruction*](pulse#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")) – Schedule to be appended.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new `Schedule`. Defaults to name of `self`.
+* **inplace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Perform operation inplace on this schedule. Otherwise return a new `Schedule`.
+
+**Return type**
+
+[*Schedule*](#qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")
+
+### assign\_parameters
+
+
+
+`assign_parameters(value_dict, inplace=True)`
+
+Assign the parameters in this schedule according to the input.
+
+**Parameters**
+
+* **value\_dict** ([*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*,* [*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – A mapping from Parameters to either numeric values or another Parameter expression.
+* **inplace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Set `True` to override this instance with new parameter.
+
+**Returns**
+
+Schedule with updated parameters.
+
+**Return type**
+
+[*Schedule*](#qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")
+
+### ch\_duration
+
+
+
+`ch_duration(*channels)`
+
+Return the time of the end of the last instruction over the supplied channels.
+
+**Parameters**
+
+**\*channels** ([*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")) – Channels within `self` to include.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_start\_time
+
+
+
+`ch_start_time(*channels)`
+
+Return the time of the start of the first instruction over the supplied channels.
+
+**Parameters**
+
+**\*channels** ([*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")) – Channels within `self` to include.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_stop\_time
+
+
+
+`ch_stop_time(*channels)`
+
+Return maximum start time over supplied channels.
+
+**Parameters**
+
+**\*channels** ([*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")) – Channels within `self` to include.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### draw
+
+
+
+`draw(style=None, backend=None, time_range=None, time_unit='dt', disable_channels=None, show_snapshot=True, show_framechange=True, show_waveform_info=True, show_barrier=True, plotter='mpl2d', axis=None)`
+
+Plot the schedule.
+
+**Parameters**
+
+* **style** ([*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")*] | None*) – Stylesheet options. This can be dictionary or preset stylesheet classes. See `IQXStandard`, `IQXSimple`, and `IQXDebugging` for details of preset stylesheets.
+
+* **backend** (*Optional\[BaseBackend]*) – Backend object to play the input pulse program. If provided, the plotter may use to make the visualization hardware aware.
+
+* **time\_range** ([*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – Set horizontal axis limit. Tuple (tmin, tmax).
+
+* **time\_unit** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The unit of specified time range either dt or ns. The unit of ns is available only when backend object is provided.
+
+* **disable\_channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*] | None*) – A control property to show specific pulse channel. Pulse channel instances provided as a list are not shown in the output image.
+
+* **show\_snapshot** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Show snapshot instructions.
+
+* **show\_framechange** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Show frame change instructions. The frame change represents instructions that modulate phase or frequency of pulse channels.
+
+* **show\_waveform\_info** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Show additional information about waveforms such as their name.
+
+* **show\_barrier** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Show barrier lines.
+
+* **plotter** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) –
+
+ Name of plotter API to generate an output image. One of following APIs should be specified:
+
+ ```python
+ mpl2d: Matplotlib API for 2D image generation.
+ Matplotlib API to generate 2D image. Charts are placed along y axis with
+ vertical offset. This API takes matplotlib.axes.Axes as ``axis`` input.
+ ```
+
+ `axis` and `style` kwargs may depend on the plotter.
+
+* **axis** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)") *| None*) – Arbitrary object passed to the plotter. If this object is provided, the plotters use a given `axis` instead of internally initializing a figure object. This object format depends on the plotter. See plotter argument for details.
+
+**Returns**
+
+Visualization output data. The returned data type depends on the `plotter`. If matplotlib family is specified, this will be a `matplotlib.pyplot.Figure` data.
+
+### exclude
+
+
+
+`exclude(*filter_funcs, channels=None, instruction_types=None, time_ranges=None, intervals=None, check_subroutine=True)`
+
+Return a `Schedule` with only the instructions from this Schedule *failing* at least one of the provided filters. This method is the complement of py:meth:\~self.filter, so that:
+
+```python
+self.filter(args) | self.exclude(args) == self
+```
+
+**Parameters**
+
+* **filter\_funcs** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")) – A list of Callables which take a (int, Union\[‘Schedule’, Instruction]) tuple and return a bool.
+* **channels** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*] | None*) – For example, `[DriveChannel(0), AcquireChannel(0)]`.
+* **instruction\_types** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*ABCMeta*](https://docs.python.org/3/library/abc.html#abc.ABCMeta "(in Python v3.12)")*] |* [*ABCMeta*](https://docs.python.org/3/library/abc.html#abc.ABCMeta "(in Python v3.12)") *| None*) – For example, `[PulseInstruction, AcquireInstruction]`.
+* **time\_ranges** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]] | None*) – For example, `[(0, 5), (6, 10)]`.
+* **intervals** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]] | None*) – For example, `[(0, 5), (6, 10)]`.
+* **check\_subroutine** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Set True to individually filter instructions inside of a subroutine defined by the [`Call`](qiskit.pulse.instructions.Call "qiskit.pulse.instructions.Call") instruction.
+
+**Return type**
+
+[*Schedule*](#qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")
+
+### filter
+
+
+
+`filter(*filter_funcs, channels=None, instruction_types=None, time_ranges=None, intervals=None, check_subroutine=True)`
+
+Return a new `Schedule` with only the instructions from this `Schedule` which pass though the provided filters; i.e. an instruction will be retained iff every function in `filter_funcs` returns `True`, the instruction occurs on a channel type contained in `channels`, the instruction type is contained in `instruction_types`, and the period over which the instruction operates is *fully* contained in one specified in `time_ranges` or `intervals`.
+
+If no arguments are provided, `self` is returned.
+
+**Parameters**
+
+* **filter\_funcs** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")) – A list of Callables which take a (int, Union\[‘Schedule’, Instruction]) tuple and return a bool.
+* **channels** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*] | None*) – For example, `[DriveChannel(0), AcquireChannel(0)]`.
+* **instruction\_types** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*ABCMeta*](https://docs.python.org/3/library/abc.html#abc.ABCMeta "(in Python v3.12)")*] |* [*ABCMeta*](https://docs.python.org/3/library/abc.html#abc.ABCMeta "(in Python v3.12)") *| None*) – For example, `[PulseInstruction, AcquireInstruction]`.
+* **time\_ranges** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]] | None*) – For example, `[(0, 5), (6, 10)]`.
+* **intervals** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]] | None*) – For example, `[(0, 5), (6, 10)]`.
+* **check\_subroutine** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Set True to individually filter instructions inside of a subroutine defined by the [`Call`](qiskit.pulse.instructions.Call "qiskit.pulse.instructions.Call") instruction.
+
+**Return type**
+
+[*Schedule*](#qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")
+
+### get\_parameters
+
+
+
+`get_parameters(parameter_name)`
+
+Get parameter object bound to this schedule by string name.
+
+Because different `Parameter` objects can have the same name, this method returns a list of `Parameter` s for the provided name.
+
+**Parameters**
+
+**parameter\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Name of parameter.
+
+**Returns**
+
+Parameter objects that have corresponding name.
+
+**Return type**
+
+[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.parameter.Parameter")]
+
+### initialize\_from
+
+
+
+`classmethod initialize_from(other_program, name=None)`
+
+Create new schedule object with metadata of another schedule object.
+
+**Parameters**
+
+* **other\_program** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit program that provides metadata to new object.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of new schedule. Name of `schedule` is used by default.
+
+**Returns**
+
+New schedule object with name and metadata.
+
+**Raises**
+
+[**PulseError**](pulse#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – When other\_program does not provide necessary information.
+
+**Return type**
+
+[*Schedule*](#qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")
+
+### insert
+
+
+
+`insert(start_time, schedule, name=None, inplace=False)`
+
+Return a new schedule with `schedule` inserted into `self` at `start_time`.
+
+**Parameters**
+
+* **start\_time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to insert the schedule.
+* **schedule** ([*Schedule*](#qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule") *|*[*Instruction*](pulse#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")) – Schedule to insert.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to the name of self.
+* **inplace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Perform operation inplace on this schedule. Otherwise return a new `Schedule`.
+
+**Return type**
+
+[*Schedule*](#qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True iff the instruction is parameterized.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### replace
+
+
+
+`replace(old, new, inplace=False)`
+
+Return a `Schedule` with the `old` instruction replaced with a `new` instruction.
+
+The replacement matching is based on an instruction equality check.
+
+```python
+from qiskit import pulse
+
+d0 = pulse.DriveChannel(0)
+
+sched = pulse.Schedule()
+
+old = pulse.Play(pulse.Constant(100, 1.0), d0)
+new = pulse.Play(pulse.Constant(100, 0.1), d0)
+
+sched += old
+
+sched = sched.replace(old, new)
+
+assert sched == pulse.Schedule(new)
+```
+
+Only matches at the top-level of the schedule tree. If you wish to perform this replacement over all instructions in the schedule tree. Flatten the schedule prior to running:
+
+```python
+.. code-block::
+```
+
+> sched = pulse.Schedule()
+>
+> sched += pulse.Schedule(old)
+>
+> sched = sched.flatten()
+>
+> sched = sched.replace(old, new)
+>
+> assert sched == pulse.Schedule(new)
+
+**Parameters**
+
+* **old** ([*Schedule*](#qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule") *|*[*Instruction*](pulse#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")) – Instruction to replace.
+* **new** ([*Schedule*](#qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule") *|*[*Instruction*](pulse#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")) – Instruction to replace with.
+* **inplace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Replace instruction by mutably modifying this `Schedule`.
+
+**Returns**
+
+The modified schedule with `old` replaced by `new`.
+
+**Raises**
+
+[**PulseError**](pulse#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – If the `Schedule` after replacements will has a timing overlap.
+
+**Return type**
+
+[*Schedule*](#qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")
+
+### shift
+
+
+
+`shift(time, name=None, inplace=False)`
+
+Return a schedule shifted forward by `time`.
+
+**Parameters**
+
+* **time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to shift by.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to the name of self.
+* **inplace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Perform operation inplace on this schedule. Otherwise return a new `Schedule`.
+
+**Return type**
+
+[*Schedule*](#qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.ScheduleBlock.md b/docs/api/qiskit/0.46/qiskit.pulse.ScheduleBlock.md
new file mode 100644
index 00000000000..4308af5ceb9
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.ScheduleBlock.md
@@ -0,0 +1,662 @@
+---
+title: ScheduleBlock
+description: API reference for qiskit.pulse.ScheduleBlock
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.ScheduleBlock
+---
+
+# ScheduleBlock
+
+
+
+`qiskit.pulse.ScheduleBlock(name=None, metadata=None, alignment_context=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/schedule.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Time-ordered sequence of instructions with alignment context.
+
+[`ScheduleBlock`](#qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") supports lazy scheduling of context instructions, i.e. their timeslots is always generated at runtime. This indicates we can parametrize instruction durations as well as other parameters. In contrast to [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") being somewhat static, [`ScheduleBlock`](#qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") is a dynamic representation of a pulse program.
+
+**Pulse Builder**
+
+The Qiskit pulse builder is a domain specific language that is developed on top of the schedule block. Use of the builder syntax will improve the workflow of pulse programming. See [Pulse Builder](pulse#pulse-builder) for a user guide.
+
+**Alignment contexts**
+
+A schedule block is always relatively scheduled. Instead of taking individual instructions with absolute execution time `t0`, the schedule block defines a context of scheduling and instructions under the same context are scheduled in the same manner (alignment). Several contexts are available in [Alignments](pulse#pulse-alignments). A schedule block is instantiated with one of these alignment contexts. The default context is `AlignLeft`, for which all instructions are left-justified, in other words, meaning they use as-soon-as-possible scheduling.
+
+If you need an absolute-time interval in between instructions, you can explicitly insert [`Delay`](qiskit.pulse.instructions.Delay "qiskit.pulse.instructions.Delay") instructions.
+
+**Nested blocks**
+
+A schedule block can contain other nested blocks with different alignment contexts. This enables advanced scheduling, where a subset of instructions is locally scheduled in a different manner. Note that a [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") instance cannot be directly added to a schedule block. To add a [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") instance, wrap it in a [`Call`](qiskit.pulse.instructions.Call "qiskit.pulse.instructions.Call") instruction. This is implicitly performed when a schedule is added through the [Pulse Builder](pulse#pulse-builder).
+
+**Unsupported operations**
+
+Because the schedule block representation lacks timeslots, it cannot perform particular [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") operations such as `insert()` or `shift()` that require instruction start time `t0`. In addition, [`exclude()`](#qiskit.pulse.ScheduleBlock.exclude "qiskit.pulse.ScheduleBlock.exclude") and [`filter()`](#qiskit.pulse.ScheduleBlock.filter "qiskit.pulse.ScheduleBlock.filter") methods are not supported because these operations may identify the target instruction with `t0`. Except for these operations, [`ScheduleBlock`](#qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") provides full compatibility with [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule").
+
+**Subroutine**
+
+The timeslots-free representation offers much greater flexibility for writing pulse programs. Because [`ScheduleBlock`](#qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") only cares about the ordering of the child blocks we can add an undefined pulse sequence as a subroutine of the main program. If your program contains the same sequence multiple times, this representation may reduce the memory footprint required by the program construction. Such a subroutine is realized by the special compiler directive [`Reference`](qiskit.pulse.instructions.Reference "qiskit.pulse.instructions.Reference") that is defined by a unique set of reference key strings to the subroutine. The (executable) subroutine is separately stored in the main program. Appended reference directives are resolved when the main program is executed. Subroutines must be assigned through [`assign_references()`](#qiskit.pulse.ScheduleBlock.assign_references "qiskit.pulse.ScheduleBlock.assign_references") before execution.
+
+**Program Scoping**
+
+
+ The [`scoped_parameters()`](#qiskit.pulse.ScheduleBlock.scoped_parameters "qiskit.pulse.ScheduleBlock.scoped_parameters") and [`search_parameters()`](#qiskit.pulse.ScheduleBlock.search_parameters "qiskit.pulse.ScheduleBlock.search_parameters") methods described in this section are deprecated.
+
+
+When you call a subroutine from another subroutine, or append a schedule block to another schedule block, the management of references and parameters can be a hard task. Schedule block offers a convenient feature to help with this by automatically scoping the parameters and subroutines.
+
+```python
+from qiskit import pulse
+from qiskit.circuit.parameter import Parameter
+
+amp1 = Parameter("amp")
+
+with pulse.build() as sched1:
+ pulse.play(pulse.Constant(100, amp1), pulse.DriveChannel(0))
+
+print(sched1.scoped_parameters())
+```
+
+```python
+(Parameter(root::amp),)
+```
+
+The [`scoped_parameters()`](#qiskit.pulse.ScheduleBlock.scoped_parameters "qiskit.pulse.ScheduleBlock.scoped_parameters") method returns all [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects defined in the schedule block. The parameter name is updated to reflect its scope information, i.e. where it is defined. The outer scope is called “root”. Since the “amp” parameter is directly used in the current builder context, it is prefixed with “root”. Note that the `Parameter` object returned by [`scoped_parameters()`](#qiskit.pulse.ScheduleBlock.scoped_parameters "qiskit.pulse.ScheduleBlock.scoped_parameters") preserves the hidden [UUID](https://docs.python.org/3/library/uuid.html#module-uuid) key, and thus the scoped name doesn’t break references to the original `Parameter`.
+
+You may want to call this program from another program. In this example, the program is called with the reference key “grand\_child”. You can call a subroutine without specifying a substantial program (like `sched1` above which we will assign later).
+
+```python
+amp2 = Parameter("amp")
+
+with pulse.build() as sched2:
+ with pulse.align_right():
+ pulse.reference("grand_child")
+ pulse.play(pulse.Constant(200, amp2), pulse.DriveChannel(0))
+
+print(sched2.scoped_parameters())
+```
+
+```python
+(Parameter(root::amp),)
+```
+
+This only returns “root::amp” because the “grand\_child” reference is unknown. Now you assign the actual pulse program to this reference.
+
+```python
+sched2.assign_references({("grand_child", ): sched1})
+print(sched2.scoped_parameters())
+```
+
+```python
+(Parameter(root::amp), Parameter(root::grand_child::amp))
+```
+
+Now you get two parameters “root::amp” and “root::grand\_child::amp”. The second parameter name indicates it is defined within the referred program “grand\_child”. The program calling the “grand\_child” has a reference program description which is accessed through [`ScheduleBlock.references`](#qiskit.pulse.ScheduleBlock.references "qiskit.pulse.ScheduleBlock.references").
+
+```python
+print(sched2.references)
+```
+
+```python
+ReferenceManager:
+ - ('grand_child',): ScheduleBlock(Play(Constant(duration=100, amp=amp,...
+```
+
+Finally, you may want to call this program from another program. Here we try a different approach to define subroutine. Namely, we call a subroutine from the root program with the actual program `sched2`.
+
+```python
+amp3 = Parameter("amp")
+
+with pulse.build() as main:
+ pulse.play(pulse.Constant(300, amp3), pulse.DriveChannel(0))
+ pulse.call(sched2, name="child")
+
+print(main.scoped_parameters())
+```
+
+```python
+(Parameter(root::amp), Parameter(root::child::amp), Parameter(root::child::grand_child::amp))
+```
+
+This implicitly creates a reference named “child” within the root program and assigns `sched2` to it. You get three parameters “root::amp”, “root::child::amp”, and “root::child::grand\_child::amp”. As you can see, each parameter name reflects the layer of calls from the root program. If you know the scope of a parameter, you can directly get the parameter object using [`ScheduleBlock.search_parameters()`](#qiskit.pulse.ScheduleBlock.search_parameters "qiskit.pulse.ScheduleBlock.search_parameters") as follows.
+
+```python
+main.search_parameters("root::child::grand_child::amp")
+```
+
+You can use a regular expression to specify the scope. The following returns the parameters defined within the scope of “ground\_child” regardless of its parent scope. This is sometimes convenient if you want to extract parameters from a deeply nested program.
+
+```python
+main.search_parameters("\S::grand_child::amp")
+```
+
+Note that the root program is only aware of its direct references.
+
+```python
+print(main.references)
+```
+
+```python
+ReferenceManager:
+ - ('child',): ScheduleBlock(ScheduleBlock(ScheduleBlock(Play(Con...
+```
+
+As you can see the main program cannot directly assign a subroutine to the “grand\_child” because this subroutine is not called within the root program, i.e. it is indirectly called by “child”. However, the returned `ReferenceManager` is a dict-like object, and you can still reach to “grand\_child” via the “child” program with the following chained dict access.
+
+```python
+main.references[("child", )].references[("grand_child", )]
+```
+
+Note that [`ScheduleBlock.parameters`](#qiskit.pulse.ScheduleBlock.parameters "qiskit.pulse.ScheduleBlock.parameters") and [`ScheduleBlock.scoped_parameters()`](#qiskit.pulse.ScheduleBlock.scoped_parameters "qiskit.pulse.ScheduleBlock.scoped_parameters") still collect all parameters also from the subroutine once it’s assigned.
+
+Create an empty schedule block.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of this schedule. Defaults to an autogenerated string if not provided.
+* **metadata** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *| None*) – Arbitrary key value metadata to associate with the schedule. This gets stored as free-form data in a dict in the [`metadata`](#qiskit.pulse.ScheduleBlock.metadata "qiskit.pulse.ScheduleBlock.metadata") attribute. It will not be directly used in the schedule.
+* **alignment\_context** ([*AlignmentKind*](pulse#qiskit.pulse.transforms.AlignmentKind "qiskit.pulse.transforms.AlignmentKind")) – `AlignmentKind` instance that manages scheduling of instructions in this block.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – if metadata is not a dict.
+
+## Attributes
+
+
+
+### alignment\_context
+
+Return alignment instance that allocates block component to generate schedule.
+
+
+
+### blocks
+
+Get the block elements added to self.
+
+
+ The sequence of elements is returned in order of addition. Because the first element is schedule first, e.g. FIFO, the returned sequence is roughly time-ordered. However, in the parallel alignment context, especially in the as-late-as-possible scheduling, or [`AlignRight`](qiskit.pulse.transforms.AlignRight "qiskit.pulse.transforms.AlignRight") context, the actual timing of when the instructions are issued is unknown until the [`ScheduleBlock`](#qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") is scheduled and converted into a [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule").
+
+
+
+
+### channels
+
+Returns channels that this schedule block uses.
+
+
+
+### duration
+
+Duration of this schedule block.
+
+
+
+### instances\_counter
+
+`= count(0)`
+
+
+
+### instructions
+
+Get the time-ordered instructions from self.
+
+
+
+### metadata
+
+The user provided metadata associated with the schedule.
+
+User provided `dict` of metadata for the schedule. The metadata contents do not affect the semantics of the program but are used to influence the execution of the schedule. It is expected to be passed between all transforms of the schedule and that providers will associate any schedule metadata with the results it returns from the execution of that schedule.
+
+
+
+### name
+
+Return name of this schedule
+
+
+
+### parameters
+
+Return unassigned parameters with raw names.
+
+
+
+### prefix
+
+`= 'block'`
+
+
+
+### references
+
+Return a reference manager of the current scope.
+
+## Methods
+
+### append
+
+
+
+`append(block, name=None, inplace=True)`
+
+Return a new schedule block with `block` appended to the context block. The execution time is automatically assigned when the block is converted into schedule.
+
+**Parameters**
+
+* **block** ([*ScheduleBlock*](#qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock") *|*[*Instruction*](pulse#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")) – ScheduleBlock to be appended.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new `Schedule`. Defaults to name of `self`.
+* **inplace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Perform operation inplace on this schedule. Otherwise, return a new `Schedule`.
+
+**Returns**
+
+Schedule block with appended schedule.
+
+**Raises**
+
+[**PulseError**](pulse#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – When invalid schedule type is specified.
+
+**Return type**
+
+[*ScheduleBlock*](#qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock")
+
+### assign\_parameters
+
+
+
+`assign_parameters(value_dict, inplace=True)`
+
+Assign the parameters in this schedule according to the input.
+
+**Parameters**
+
+* **value\_dict** ([*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*,* [*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – A mapping from Parameters to either numeric values or another Parameter expression.
+* **inplace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Set `True` to override this instance with new parameter.
+
+**Returns**
+
+Schedule with updated parameters.
+
+**Raises**
+
+[**PulseError**](pulse#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – When the block is nested into another block.
+
+**Return type**
+
+[*ScheduleBlock*](#qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock")
+
+### assign\_references
+
+
+
+`assign_references(subroutine_dict, inplace=True)`
+
+Assign schedules to references.
+
+It is only capable of assigning a schedule block to immediate references which are directly referred within the current scope. Let’s see following example:
+
+```python
+from qiskit import pulse
+
+with pulse.build() as subroutine:
+ pulse.delay(10, pulse.DriveChannel(0))
+
+with pulse.build() as sub_prog:
+ pulse.reference("A")
+
+with pulse.build() as main_prog:
+ pulse.reference("B")
+```
+
+In above example, the `main_prog` can refer to the subroutine “root::B” and the reference of “B” to program “A”, i.e., “B::A”, is not defined in the root namespace. This prevents breaking the reference “root::B::A” by the assignment of “root::B”. For example, if a user could indirectly assign “root::B::A” from the root program, one can later assign another program to “root::B” that doesn’t contain “A” within it. In this situation, a reference “root::B::A” would still live in the reference manager of the root. However, the subroutine “root::B::A” would no longer be used in the actual pulse program. To assign subroutine “A” to `nested_prog` as a nested subprogram of `main_prog`, you must first assign “A” of the `sub_prog`, and then assign the `sub_prog` to the `main_prog`.
+
+```python
+sub_prog.assign_references({("A", ): nested_prog}, inplace=True)
+main_prog.assign_references({("B", ): sub_prog}, inplace=True)
+```
+
+Alternatively, you can also write
+
+```python
+main_prog.assign_references({("B", ): sub_prog}, inplace=True)
+main_prog.references[("B", )].assign_references({"A": nested_prog}, inplace=True)
+```
+
+Here [`references`](#qiskit.pulse.ScheduleBlock.references "qiskit.pulse.ScheduleBlock.references") returns a dict-like object, and you can mutably update the nested reference of the particular subroutine.
+
+
+ Assigned programs are deep-copied to prevent an unexpected update.
+
+
+**Parameters**
+
+* **subroutine\_dict** ([*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*, ...],* [*ScheduleBlock*](#qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock")*]*) – A mapping from reference key to schedule block of the subroutine.
+* **inplace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Set `True` to override this instance with new subroutine.
+
+**Returns**
+
+Schedule block with assigned subroutine.
+
+**Raises**
+
+[**PulseError**](pulse#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – When reference key is not defined in the current scope.
+
+**Return type**
+
+[*ScheduleBlock*](#qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock")
+
+### ch\_duration
+
+
+
+`ch_duration(*channels)`
+
+Return the time of the end of the last instruction over the supplied channels.
+
+**Parameters**
+
+**\*channels** ([*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")) – Channels within `self` to include.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### draw
+
+
+
+`draw(style=None, backend=None, time_range=None, time_unit='dt', disable_channels=None, show_snapshot=True, show_framechange=True, show_waveform_info=True, show_barrier=True, plotter='mpl2d', axis=None)`
+
+Plot the schedule.
+
+**Parameters**
+
+* **style** ([*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")*] | None*) – Stylesheet options. This can be dictionary or preset stylesheet classes. See `IQXStandard`, `IQXSimple`, and `IQXDebugging` for details of preset stylesheets.
+
+* **backend** (*Optional\[BaseBackend]*) – Backend object to play the input pulse program. If provided, the plotter may use to make the visualization hardware aware.
+
+* **time\_range** ([*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – Set horizontal axis limit. Tuple (tmin, tmax).
+
+* **time\_unit** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The unit of specified time range either dt or ns. The unit of ns is available only when backend object is provided.
+
+* **disable\_channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*] | None*) – A control property to show specific pulse channel. Pulse channel instances provided as a list are not shown in the output image.
+
+* **show\_snapshot** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Show snapshot instructions.
+
+* **show\_framechange** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Show frame change instructions. The frame change represents instructions that modulate phase or frequency of pulse channels.
+
+* **show\_waveform\_info** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Show additional information about waveforms such as their name.
+
+* **show\_barrier** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Show barrier lines.
+
+* **plotter** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) –
+
+ Name of plotter API to generate an output image. One of following APIs should be specified:
+
+ ```python
+ mpl2d: Matplotlib API for 2D image generation.
+ Matplotlib API to generate 2D image. Charts are placed along y axis with
+ vertical offset. This API takes matplotlib.axes.Axes as ``axis`` input.
+ ```
+
+ `axis` and `style` kwargs may depend on the plotter.
+
+* **axis** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)") *| None*) – Arbitrary object passed to the plotter. If this object is provided, the plotters use a given `axis` instead of internally initializing a figure object. This object format depends on the plotter. See plotter argument for details.
+
+**Returns**
+
+Visualization output data. The returned data type depends on the `plotter`. If matplotlib family is specified, this will be a `matplotlib.pyplot.Figure` data.
+
+### exclude
+
+
+
+`exclude(*filter_funcs, channels=None, instruction_types=None, check_subroutine=True)`
+
+Return a new `ScheduleBlock` with only the instructions from this `ScheduleBlock` *failing* at least one of the provided filters. This method is the complement of py:meth:\~self.filter, so that:
+
+```python
+self.filter(args) + self.exclude(args) == self in terms of instructions included.
+```
+
+
+ Because `ScheduleBlock` is not aware of the execution time of the context instructions, excluding some instructions may change the execution time of the remaining instructions.
+
+
+**Parameters**
+
+* **filter\_funcs** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")*]*) – A list of Callables which take a `Instruction` and return a bool.
+* **channels** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*] | None*) – For example, `[DriveChannel(0), AcquireChannel(0)]`.
+* **instruction\_types** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*ABCMeta*](https://docs.python.org/3/library/abc.html#abc.ABCMeta "(in Python v3.12)")*] |* [*ABCMeta*](https://docs.python.org/3/library/abc.html#abc.ABCMeta "(in Python v3.12)") *| None*) – For example, `[PulseInstruction, AcquireInstruction]`.
+* **check\_subroutine** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Set True to individually filter instructions inside of a subroutine defined by the [`Call`](qiskit.pulse.instructions.Call "qiskit.pulse.instructions.Call") instruction.
+
+**Returns**
+
+`ScheduleBlock` consisting of instructions that do not match with at least one of filtering conditions.
+
+### filter
+
+
+
+`filter(*filter_funcs, channels=None, instruction_types=None, check_subroutine=True)`
+
+Return a new `ScheduleBlock` with only the instructions from this `ScheduleBlock` which pass though the provided filters; i.e. an instruction will be retained if every function in `filter_funcs` returns `True`, the instruction occurs on a channel type contained in `channels`, and the instruction type is contained in `instruction_types`.
+
+
+ Because `ScheduleBlock` is not aware of the execution time of the context instructions, filtering out some instructions may change the execution time of the remaining instructions.
+
+
+If no arguments are provided, `self` is returned.
+
+**Parameters**
+
+* **filter\_funcs** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")*]*) – A list of Callables which take a `Instruction` and return a bool.
+* **channels** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*] | None*) – For example, `[DriveChannel(0), AcquireChannel(0)]`.
+* **instruction\_types** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*ABCMeta*](https://docs.python.org/3/library/abc.html#abc.ABCMeta "(in Python v3.12)")*] |* [*ABCMeta*](https://docs.python.org/3/library/abc.html#abc.ABCMeta "(in Python v3.12)") *| None*) – For example, `[PulseInstruction, AcquireInstruction]`.
+* **check\_subroutine** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Set True to individually filter instructions inside a subroutine defined by the [`Call`](qiskit.pulse.instructions.Call "qiskit.pulse.instructions.Call") instruction.
+
+**Returns**
+
+`ScheduleBlock` consisting of instructions that matches with filtering condition.
+
+### get\_parameters
+
+
+
+`get_parameters(parameter_name)`
+
+Get parameter object bound to this schedule by string name.
+
+Note that we can define different parameter objects with the same name, because these different objects are identified by their unique uuid. For example,
+
+```python
+from qiskit import pulse, circuit
+
+amp1 = circuit.Parameter("amp")
+amp2 = circuit.Parameter("amp")
+
+with pulse.build() as sub_prog:
+ pulse.play(pulse.Constant(100, amp1), pulse.DriveChannel(0))
+
+with pulse.build() as main_prog:
+ pulse.call(sub_prog, name="sub")
+ pulse.play(pulse.Constant(100, amp2), pulse.DriveChannel(0))
+
+main_prog.get_parameters("amp")
+```
+
+This returns a list of two parameters `amp1` and `amp2`.
+
+**Parameters**
+
+**parameter\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Name of parameter.
+
+**Returns**
+
+Parameter objects that have corresponding name.
+
+**Return type**
+
+[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.parameter.Parameter")]
+
+### initialize\_from
+
+
+
+`classmethod initialize_from(other_program, name=None)`
+
+Create new schedule object with metadata of another schedule object.
+
+**Parameters**
+
+* **other\_program** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit program that provides metadata to new object.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of new schedule. Name of `block` is used by default.
+
+**Returns**
+
+New block object with name and metadata.
+
+**Raises**
+
+[**PulseError**](pulse#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – When `other_program` does not provide necessary information.
+
+**Return type**
+
+[*ScheduleBlock*](#qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock")
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True iff the instruction is parameterized.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### is\_referenced
+
+
+
+`is_referenced()`
+
+Return True iff the current schedule block contains reference to subroutine.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### is\_schedulable
+
+
+
+`is_schedulable()`
+
+Return `True` if all durations are assigned.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### replace
+
+
+
+`replace(old, new, inplace=True)`
+
+Return a `ScheduleBlock` with the `old` component replaced with a `new` component.
+
+**Parameters**
+
+* **old** ([*ScheduleBlock*](#qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock") *|*[*Instruction*](pulse#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")) – Schedule block component to replace.
+* **new** ([*ScheduleBlock*](#qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock") *|*[*Instruction*](pulse#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")) – Schedule block component to replace with.
+* **inplace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Replace instruction by mutably modifying this `ScheduleBlock`.
+
+**Returns**
+
+The modified schedule block with `old` replaced by `new`.
+
+**Return type**
+
+[*ScheduleBlock*](#qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock")
+
+### scoped\_parameters
+
+
+
+`scoped_parameters()`
+
+Return unassigned parameters with scoped names.
+
+
+ Scoped parameters do not work correctly with Qiskit’s data model for parameter assignment. This implementation is consequently being removed in Qiskit 1.0.
+
+
+
+ If a parameter is defined within a nested scope, it is prefixed with all parent-scope names with the delimiter string, which is “::”. If a reference key of the scope consists of multiple key strings, it will be represented by a single string joined with “,”. For example, “root::xgate,q0::amp” for the parameter “amp” defined in the reference specified by the key strings (“xgate”, “q0”).
+
+
+
+ The method `qiskit.pulse.schedule.ScheduleBlock.scoped_parameters()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. There is no alternative to this method. Parameters must be mapped to references by checking the reference schedules directly.
+
+
+**Return type**
+
+[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")\[[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.parameter.Parameter")]
+
+### search\_parameters
+
+
+
+`search_parameters(parameter_regex)`
+
+Search parameter with regular expression.
+
+
+ Scoped parameters do not work correctly with Qiskit’s data model for parameter assignment. This implementation is consequently being removed in Qiskit 1.0.
+
+
+This method looks for the scope-aware parameters. For example,
+
+```python
+from qiskit import pulse, circuit
+
+amp1 = circuit.Parameter("amp")
+amp2 = circuit.Parameter("amp")
+
+with pulse.build() as sub_prog:
+ pulse.play(pulse.Constant(100, amp1), pulse.DriveChannel(0))
+
+with pulse.build() as main_prog:
+ pulse.call(sub_prog, name="sub")
+ pulse.play(pulse.Constant(100, amp2), pulse.DriveChannel(0))
+
+main_prog.search_parameters("root::sub::amp")
+```
+
+This finds `amp1` with scoped name “root::sub::amp”.
+
+
+ The method `qiskit.pulse.schedule.ScheduleBlock.search_parameters()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. There is no alternative to this method. Parameters must be mapped to references by checking the reference schedules directly.
+
+
+**Parameters**
+
+**parameter\_regex** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Regular expression for scoped parameter name.
+
+**Returns**
+
+Parameter objects that have corresponding name.
+
+**Return type**
+
+[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.parameter.Parameter")]
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.channels.AcquireChannel.md b/docs/api/qiskit/0.46/qiskit.pulse.channels.AcquireChannel.md
new file mode 100644
index 00000000000..7c91206e3ef
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.channels.AcquireChannel.md
@@ -0,0 +1,68 @@
+---
+title: AcquireChannel
+description: API reference for qiskit.pulse.channels.AcquireChannel
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.channels.AcquireChannel
+---
+
+# AcquireChannel
+
+
+
+`qiskit.pulse.channels.AcquireChannel(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/channels.py "view source code")
+
+Bases: [`Channel`](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")
+
+Acquire channels are used to collect data.
+
+Channel class.
+
+**Parameters**
+
+**index** – Index of channel.
+
+## Attributes
+
+
+
+### index
+
+Return the index of this channel. The index is a label for a control signal line typically mapped trivially to a qubit index. For instance, `DriveChannel(0)` labels the signal line driving the qubit labeled with index 0.
+
+
+
+### name
+
+Return the shorthand alias for this channel, which is based on its type and index.
+
+
+
+### parameters
+
+Parameters which determine the channel index.
+
+
+
+### prefix
+
+`str | None`
+
+`= 'a'`
+
+A shorthand string prefix for characterizing the channel type.
+
+## Methods
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True iff the channel is parameterized.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.channels.ControlChannel.md b/docs/api/qiskit/0.46/qiskit.pulse.channels.ControlChannel.md
new file mode 100644
index 00000000000..ea7d084e183
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.channels.ControlChannel.md
@@ -0,0 +1,68 @@
+---
+title: ControlChannel
+description: API reference for qiskit.pulse.channels.ControlChannel
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.channels.ControlChannel
+---
+
+# ControlChannel
+
+
+
+`qiskit.pulse.channels.ControlChannel(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/channels.py "view source code")
+
+Bases: `PulseChannel`
+
+Control channels provide supplementary control over the qubit to the drive channel. These are often associated with multi-qubit gate operations. They may not map trivially to a particular qubit index.
+
+Channel class.
+
+**Parameters**
+
+**index** – Index of channel.
+
+## Attributes
+
+
+
+### index
+
+Return the index of this channel. The index is a label for a control signal line typically mapped trivially to a qubit index. For instance, `DriveChannel(0)` labels the signal line driving the qubit labeled with index 0.
+
+
+
+### name
+
+Return the shorthand alias for this channel, which is based on its type and index.
+
+
+
+### parameters
+
+Parameters which determine the channel index.
+
+
+
+### prefix
+
+`str | None`
+
+`= 'u'`
+
+A shorthand string prefix for characterizing the channel type.
+
+## Methods
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True iff the channel is parameterized.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.channels.DriveChannel.md b/docs/api/qiskit/0.46/qiskit.pulse.channels.DriveChannel.md
new file mode 100644
index 00000000000..3fc44b1ae8a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.channels.DriveChannel.md
@@ -0,0 +1,68 @@
+---
+title: DriveChannel
+description: API reference for qiskit.pulse.channels.DriveChannel
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.channels.DriveChannel
+---
+
+# DriveChannel
+
+
+
+`qiskit.pulse.channels.DriveChannel(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/channels.py "view source code")
+
+Bases: `PulseChannel`
+
+Drive channels transmit signals to qubits which enact gate operations.
+
+Channel class.
+
+**Parameters**
+
+**index** – Index of channel.
+
+## Attributes
+
+
+
+### index
+
+Return the index of this channel. The index is a label for a control signal line typically mapped trivially to a qubit index. For instance, `DriveChannel(0)` labels the signal line driving the qubit labeled with index 0.
+
+
+
+### name
+
+Return the shorthand alias for this channel, which is based on its type and index.
+
+
+
+### parameters
+
+Parameters which determine the channel index.
+
+
+
+### prefix
+
+`str | None`
+
+`= 'd'`
+
+A shorthand string prefix for characterizing the channel type.
+
+## Methods
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True iff the channel is parameterized.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.channels.MeasureChannel.md b/docs/api/qiskit/0.46/qiskit.pulse.channels.MeasureChannel.md
new file mode 100644
index 00000000000..d8d8b51b3c4
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.channels.MeasureChannel.md
@@ -0,0 +1,68 @@
+---
+title: MeasureChannel
+description: API reference for qiskit.pulse.channels.MeasureChannel
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.channels.MeasureChannel
+---
+
+# MeasureChannel
+
+
+
+`qiskit.pulse.channels.MeasureChannel(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/channels.py "view source code")
+
+Bases: `PulseChannel`
+
+Measure channels transmit measurement stimulus pulses for readout.
+
+Channel class.
+
+**Parameters**
+
+**index** – Index of channel.
+
+## Attributes
+
+
+
+### index
+
+Return the index of this channel. The index is a label for a control signal line typically mapped trivially to a qubit index. For instance, `DriveChannel(0)` labels the signal line driving the qubit labeled with index 0.
+
+
+
+### name
+
+Return the shorthand alias for this channel, which is based on its type and index.
+
+
+
+### parameters
+
+Parameters which determine the channel index.
+
+
+
+### prefix
+
+`str | None`
+
+`= 'm'`
+
+A shorthand string prefix for characterizing the channel type.
+
+## Methods
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True iff the channel is parameterized.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.channels.MemorySlot.md b/docs/api/qiskit/0.46/qiskit.pulse.channels.MemorySlot.md
new file mode 100644
index 00000000000..e2806667cbd
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.channels.MemorySlot.md
@@ -0,0 +1,68 @@
+---
+title: MemorySlot
+description: API reference for qiskit.pulse.channels.MemorySlot
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.channels.MemorySlot
+---
+
+# MemorySlot
+
+
+
+`qiskit.pulse.channels.MemorySlot(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/channels.py "view source code")
+
+Bases: `ClassicalIOChannel`
+
+Memory slot channels represent classical memory storage.
+
+Channel class.
+
+**Parameters**
+
+**index** – Index of channel.
+
+## Attributes
+
+
+
+### index
+
+Return the index of this channel. The index is a label for a control signal line typically mapped trivially to a qubit index. For instance, `DriveChannel(0)` labels the signal line driving the qubit labeled with index 0.
+
+
+
+### name
+
+Return the shorthand alias for this channel, which is based on its type and index.
+
+
+
+### parameters
+
+Parameters which determine the channel index.
+
+
+
+### prefix
+
+`str | None`
+
+`= 'm'`
+
+A shorthand string prefix for characterizing the channel type.
+
+## Methods
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True iff the channel is parameterized.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.channels.RegisterSlot.md b/docs/api/qiskit/0.46/qiskit.pulse.channels.RegisterSlot.md
new file mode 100644
index 00000000000..9ad0c1f3ea9
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.channels.RegisterSlot.md
@@ -0,0 +1,68 @@
+---
+title: RegisterSlot
+description: API reference for qiskit.pulse.channels.RegisterSlot
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.channels.RegisterSlot
+---
+
+# RegisterSlot
+
+
+
+`qiskit.pulse.channels.RegisterSlot(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/channels.py "view source code")
+
+Bases: `ClassicalIOChannel`
+
+Classical resister slot channels represent classical registers (low-latency classical memory).
+
+Channel class.
+
+**Parameters**
+
+**index** – Index of channel.
+
+## Attributes
+
+
+
+### index
+
+Return the index of this channel. The index is a label for a control signal line typically mapped trivially to a qubit index. For instance, `DriveChannel(0)` labels the signal line driving the qubit labeled with index 0.
+
+
+
+### name
+
+Return the shorthand alias for this channel, which is based on its type and index.
+
+
+
+### parameters
+
+Parameters which determine the channel index.
+
+
+
+### prefix
+
+`str | None`
+
+`= 'c'`
+
+A shorthand string prefix for characterizing the channel type.
+
+## Methods
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True iff the channel is parameterized.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.channels.SnapshotChannel.md b/docs/api/qiskit/0.46/qiskit.pulse.channels.SnapshotChannel.md
new file mode 100644
index 00000000000..3f34458c12d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.channels.SnapshotChannel.md
@@ -0,0 +1,64 @@
+---
+title: SnapshotChannel
+description: API reference for qiskit.pulse.channels.SnapshotChannel
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.channels.SnapshotChannel
+---
+
+# SnapshotChannel
+
+
+
+`qiskit.pulse.channels.SnapshotChannel(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/channels.py "view source code")
+
+Bases: `ClassicalIOChannel`
+
+Snapshot channels are used to specify instructions for simulators.
+
+Create new snapshot channel.
+
+## Attributes
+
+
+
+### index
+
+Return the index of this channel. The index is a label for a control signal line typically mapped trivially to a qubit index. For instance, `DriveChannel(0)` labels the signal line driving the qubit labeled with index 0.
+
+
+
+### name
+
+Return the shorthand alias for this channel, which is based on its type and index.
+
+
+
+### parameters
+
+Parameters which determine the channel index.
+
+
+
+### prefix
+
+`str | None`
+
+`= 's'`
+
+A shorthand string prefix for characterizing the channel type.
+
+## Methods
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True iff the channel is parameterized.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.instructions.Acquire.md b/docs/api/qiskit/0.46/qiskit.pulse.instructions.Acquire.md
new file mode 100644
index 00000000000..ab5562f4621
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.instructions.Acquire.md
@@ -0,0 +1,289 @@
+---
+title: Acquire
+description: API reference for qiskit.pulse.instructions.Acquire
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.instructions.Acquire
+---
+
+# Acquire
+
+
+
+`qiskit.pulse.instructions.Acquire(duration, channel, mem_slot=None, reg_slot=None, kernel=None, discriminator=None, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/instructions/acquire.py "view source code")
+
+Bases: [`Instruction`](pulse#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")
+
+The Acquire instruction is used to trigger the ADC associated with a particular qubit; e.g. instantiated with AcquireChannel(0), the Acquire command will trigger data collection for the channel associated with qubit 0 readout. This instruction also provides acquisition metadata:
+
+> * the number of cycles during which to acquire (in terms of dt),
+> * the register slot to store classified, intermediary readout results,
+> * the memory slot to return classified results,
+> * the kernel to integrate raw data for each shot, and
+> * the discriminator to classify kerneled IQ points.
+
+Create a new Acquire instruction.
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – Length of time to acquire data in terms of dt.
+* **channel** ([*AcquireChannel*](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")) – The channel that will acquire data.
+* **mem\_slot** ([*MemorySlot*](qiskit.pulse.channels.MemorySlot "qiskit.pulse.channels.MemorySlot") *| None*) – The classical memory slot in which to store the classified readout result.
+* **reg\_slot** ([*RegisterSlot*](qiskit.pulse.channels.RegisterSlot "qiskit.pulse.channels.RegisterSlot") *| None*) – The fast-access register slot in which to store the classified readout result for fast feedback.
+* **kernel** (*Kernel | None*) – A `Kernel` for integrating raw data.
+* **discriminator** (*Discriminator | None*) – A `Discriminator` for discriminating kerneled IQ data into 0/1 results.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the instruction for display purposes.
+
+## Attributes
+
+
+
+### acquire
+
+Acquire channel to acquire data. The `AcquireChannel` index maps trivially to qubit index.
+
+
+
+### channel
+
+Return the [`Channel`](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel") that this instruction is scheduled on.
+
+
+
+### channels
+
+Returns the channels that this schedule uses.
+
+
+
+### discriminator
+
+Return discrimination settings.
+
+
+
+### duration
+
+Duration of this instruction.
+
+
+
+### id
+
+Unique identifier for this instruction.
+
+
+
+### instructions
+
+Iterable for getting instructions from Schedule tree.
+
+
+
+### kernel
+
+Return kernel settings.
+
+
+
+### mem\_slot
+
+The classical memory slot which will store the classified readout result.
+
+
+
+### name
+
+Name of this instruction.
+
+
+
+### operands
+
+Return instruction operands.
+
+
+
+### parameters
+
+Parameters which determine the instruction behavior.
+
+
+
+### reg\_slot
+
+The fast-access register slot which will store the classified readout result for fast-feedback computation.
+
+
+
+### start\_time
+
+Relative begin time of this instruction.
+
+
+
+### stop\_time
+
+Relative end time of this instruction.
+
+## Methods
+
+### append
+
+
+
+`append(schedule, name=None)`
+
+Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted at the maximum time over all channels shared between `self` and `schedule`.
+
+**Parameters**
+
+* **schedule** (*Union\['Schedule', 'Instruction']*) – Schedule or instruction to be appended
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+A new schedule with `schedule` a this instruction at t=0.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
+### ch\_duration
+
+
+
+`ch_duration(*channels)`
+
+Return duration of the supplied channels in this Instruction.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_start\_time
+
+
+
+`ch_start_time(*channels)`
+
+Return minimum start time for supplied channels.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_stop\_time
+
+
+
+`ch_stop_time(*channels)`
+
+Return maximum start time for supplied channels.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### draw
+
+
+
+`draw(dt=1, style=None, filename=None, interp_method=None, scale=1, plot_all=False, plot_range=None, interactive=False, table=True, label=False, framechange=True, channels=None)`
+
+Plot the instruction.
+
+
+ The method `qiskit.pulse.instructions.instruction.Instruction.draw()` is deprecated as of qiskit-terra 0.23.0. It will be removed in the Qiskit 1.0 release. No direct alternative is being provided to drawing individual pulses. But, instructions can be visualized as part of a complete schedule using `qiskit.visualization.pulse_drawer`.
+
+
+**Parameters**
+
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Time interval of samples
+* **style** (*Optional\[SchedStyle]*) – A style sheet to configure plot appearance
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name required to save pulse image
+* **interp\_method** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *| None*) – A function for interpolation
+* **scale** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Relative visual scaling of waveform amplitudes
+* **plot\_all** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Plot empty channels
+* **plot\_range** ([*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – A tuple of time range to plot
+* **interactive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – When set true show the circuit in a new window (this depends on the matplotlib backend being used supporting this)
+* **table** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Draw event table for supported instructions
+* **label** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Label individual instructions
+* **framechange** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Add framechange indicators
+* **channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*] | None*) – A list of channel names to plot
+
+**Returns**
+
+A matplotlib figure object of the pulse schedule
+
+**Return type**
+
+matplotlib.figure
+
+### insert
+
+
+
+`insert(start_time, schedule, name=None)`
+
+Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`.
+
+**Parameters**
+
+* **start\_time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to insert the schedule schedule
+* **schedule** (*Union\['Schedule', 'Instruction']*) – Schedule or instruction to insert
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+A new schedule with `schedule` inserted with this instruction at t=0.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True iff the instruction is parameterized.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### shift
+
+
+
+`shift(time, name=None)`
+
+Return a new schedule shifted forward by time.
+
+**Parameters**
+
+* **time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to shift by
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+The shifted schedule.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.instructions.Call.md b/docs/api/qiskit/0.46/qiskit.pulse.instructions.Call.md
new file mode 100644
index 00000000000..e0147d1868f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.instructions.Call.md
@@ -0,0 +1,303 @@
+---
+title: Call
+description: API reference for qiskit.pulse.instructions.Call
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.instructions.Call
+---
+
+# Call
+
+
+
+`qiskit.pulse.instructions.Call(subroutine, value_dict=None, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/instructions/call.py "view source code")
+
+Bases: [`Instruction`](pulse#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")
+
+Pulse `Call` instruction.
+
+The `Call` instruction represents the calling of a referenced subroutine (schedule). It enables code reuse both within the pulse representation and hardware (if supported).
+
+Define new subroutine.
+
+
+ Inline subroutine is mutable. This requires special care for modification.
+
+
+
+ The class `qiskit.pulse.instructions.call.Call` is deprecated as of qiskit-terra 0.25.0. It will be removed in the Qiskit 1.0 release. Instead, use the pulse builder function qiskit.pulse.builder.call(subroutine) within an active building context.
+
+
+**Parameters**
+
+* **subroutine** (*Union\[*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule")*,* [*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock")*]*) – A program subroutine to be referred to.
+* **value\_dict** ([*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")*,* [*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – Mapping of parameter object to assigned value.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Unique ID of this subroutine. If not provided, this is generated based on the subroutine name.
+
+**Raises**
+
+[**PulseError**](pulse#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – If subroutine is not valid data format.
+
+## Attributes
+
+
+
+### arguments
+
+Parameters dictionary to be assigned to subroutine.
+
+
+
+### channels
+
+Returns the channels that this schedule uses.
+
+
+
+### duration
+
+Duration of this instruction.
+
+
+
+### id
+
+Unique identifier for this instruction.
+
+
+
+### instructions
+
+Iterable for getting instructions from Schedule tree.
+
+
+
+### name
+
+Name of this instruction.
+
+
+
+### operands
+
+Return instruction operands.
+
+
+
+### parameters
+
+Unassigned parameters which determine the instruction behavior.
+
+
+
+### prefix
+
+`= 'call'`
+
+
+
+### start\_time
+
+Relative begin time of this instruction.
+
+
+
+### stop\_time
+
+Relative end time of this instruction.
+
+
+
+### subroutine
+
+Return attached subroutine.
+
+**Returns**
+
+The program referenced by the call.
+
+**Return type**
+
+program (Union\[[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule"), [ScheduleBlock](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock")])
+
+## Methods
+
+### append
+
+
+
+`append(schedule, name=None)`
+
+Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted at the maximum time over all channels shared between `self` and `schedule`.
+
+**Parameters**
+
+* **schedule** (*Union\['Schedule', 'Instruction']*) – Schedule or instruction to be appended
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+A new schedule with `schedule` a this instruction at t=0.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
+### assigned\_subroutine
+
+
+
+`assigned_subroutine()`
+
+Returns this subroutine with the parameters assigned.
+
+
+ This function may be often called internally for class equality check despite its overhead of parameter assignment. The subroutine with parameter assigned is cached based on `.argument` hash. Once this argument is updated, new assigned instance will be returned. Note that this update is not mutable operation.
+
+
+**Returns**
+
+Attached program.
+
+**Return type**
+
+program (Union\[[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule"), [ScheduleBlock](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock")])
+
+### ch\_duration
+
+
+
+`ch_duration(*channels)`
+
+Return duration of the supplied channels in this Instruction.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_start\_time
+
+
+
+`ch_start_time(*channels)`
+
+Return minimum start time for supplied channels.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_stop\_time
+
+
+
+`ch_stop_time(*channels)`
+
+Return maximum start time for supplied channels.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### draw
+
+
+
+`draw(dt=1, style=None, filename=None, interp_method=None, scale=1, plot_all=False, plot_range=None, interactive=False, table=True, label=False, framechange=True, channels=None)`
+
+Plot the instruction.
+
+
+ The method `qiskit.pulse.instructions.instruction.Instruction.draw()` is deprecated as of qiskit-terra 0.23.0. It will be removed in the Qiskit 1.0 release. No direct alternative is being provided to drawing individual pulses. But, instructions can be visualized as part of a complete schedule using `qiskit.visualization.pulse_drawer`.
+
+
+**Parameters**
+
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Time interval of samples
+* **style** (*Optional\[SchedStyle]*) – A style sheet to configure plot appearance
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name required to save pulse image
+* **interp\_method** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *| None*) – A function for interpolation
+* **scale** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Relative visual scaling of waveform amplitudes
+* **plot\_all** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Plot empty channels
+* **plot\_range** ([*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – A tuple of time range to plot
+* **interactive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – When set true show the circuit in a new window (this depends on the matplotlib backend being used supporting this)
+* **table** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Draw event table for supported instructions
+* **label** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Label individual instructions
+* **framechange** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Add framechange indicators
+* **channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*] | None*) – A list of channel names to plot
+
+**Returns**
+
+A matplotlib figure object of the pulse schedule
+
+**Return type**
+
+matplotlib.figure
+
+### insert
+
+
+
+`insert(start_time, schedule, name=None)`
+
+Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`.
+
+**Parameters**
+
+* **start\_time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to insert the schedule schedule
+* **schedule** (*Union\['Schedule', 'Instruction']*) – Schedule or instruction to insert
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+A new schedule with `schedule` inserted with this instruction at t=0.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True iff the instruction is parameterized.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### shift
+
+
+
+`shift(time, name=None)`
+
+Return a new schedule shifted forward by time.
+
+**Parameters**
+
+* **time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to shift by
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+The shifted schedule.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.instructions.Delay.md b/docs/api/qiskit/0.46/qiskit.pulse.instructions.Delay.md
new file mode 100644
index 00000000000..3b634347219
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.instructions.Delay.md
@@ -0,0 +1,263 @@
+---
+title: Delay
+description: API reference for qiskit.pulse.instructions.Delay
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.instructions.Delay
+---
+
+# Delay
+
+
+
+`qiskit.pulse.instructions.Delay(duration, channel, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/instructions/delay.py "view source code")
+
+Bases: [`Instruction`](pulse#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")
+
+A blocking instruction with no other effect. The delay is used for aligning and scheduling other instructions.
+
+**Example**
+
+To schedule an instruction at time = 10, on a channel assigned to the variable `channel`, the following could be used:
+
+```python
+sched = Schedule(name="Delay instruction example")
+sched += Delay(10, channel)
+sched += Gaussian(duration, amp, sigma, channel)
+```
+
+The `channel` will output no signal from time=0 up until time=10.
+
+Create a new delay instruction.
+
+No other instruction may be scheduled within a `Delay`.
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – Length of time of the delay in terms of dt.
+* **channel** ([*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")) – The channel that will have the delay.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the delay for display purposes.
+
+## Attributes
+
+
+
+### channel
+
+Return the [`Channel`](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel") that this instruction is scheduled on.
+
+
+
+### channels
+
+Returns the channels that this schedule uses.
+
+
+
+### duration
+
+Duration of this instruction.
+
+
+
+### id
+
+Unique identifier for this instruction.
+
+
+
+### instructions
+
+Iterable for getting instructions from Schedule tree.
+
+
+
+### name
+
+Name of this instruction.
+
+
+
+### operands
+
+Return instruction operands.
+
+
+
+### parameters
+
+Parameters which determine the instruction behavior.
+
+
+
+### start\_time
+
+Relative begin time of this instruction.
+
+
+
+### stop\_time
+
+Relative end time of this instruction.
+
+## Methods
+
+### append
+
+
+
+`append(schedule, name=None)`
+
+Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted at the maximum time over all channels shared between `self` and `schedule`.
+
+**Parameters**
+
+* **schedule** (*Union\['Schedule', 'Instruction']*) – Schedule or instruction to be appended
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+A new schedule with `schedule` a this instruction at t=0.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
+### ch\_duration
+
+
+
+`ch_duration(*channels)`
+
+Return duration of the supplied channels in this Instruction.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_start\_time
+
+
+
+`ch_start_time(*channels)`
+
+Return minimum start time for supplied channels.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_stop\_time
+
+
+
+`ch_stop_time(*channels)`
+
+Return maximum start time for supplied channels.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### draw
+
+
+
+`draw(dt=1, style=None, filename=None, interp_method=None, scale=1, plot_all=False, plot_range=None, interactive=False, table=True, label=False, framechange=True, channels=None)`
+
+Plot the instruction.
+
+
+ The method `qiskit.pulse.instructions.instruction.Instruction.draw()` is deprecated as of qiskit-terra 0.23.0. It will be removed in the Qiskit 1.0 release. No direct alternative is being provided to drawing individual pulses. But, instructions can be visualized as part of a complete schedule using `qiskit.visualization.pulse_drawer`.
+
+
+**Parameters**
+
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Time interval of samples
+* **style** (*Optional\[SchedStyle]*) – A style sheet to configure plot appearance
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name required to save pulse image
+* **interp\_method** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *| None*) – A function for interpolation
+* **scale** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Relative visual scaling of waveform amplitudes
+* **plot\_all** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Plot empty channels
+* **plot\_range** ([*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – A tuple of time range to plot
+* **interactive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – When set true show the circuit in a new window (this depends on the matplotlib backend being used supporting this)
+* **table** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Draw event table for supported instructions
+* **label** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Label individual instructions
+* **framechange** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Add framechange indicators
+* **channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*] | None*) – A list of channel names to plot
+
+**Returns**
+
+A matplotlib figure object of the pulse schedule
+
+**Return type**
+
+matplotlib.figure
+
+### insert
+
+
+
+`insert(start_time, schedule, name=None)`
+
+Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`.
+
+**Parameters**
+
+* **start\_time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to insert the schedule schedule
+* **schedule** (*Union\['Schedule', 'Instruction']*) – Schedule or instruction to insert
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+A new schedule with `schedule` inserted with this instruction at t=0.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True iff the instruction is parameterized.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### shift
+
+
+
+`shift(time, name=None)`
+
+Return a new schedule shifted forward by time.
+
+**Parameters**
+
+* **time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to shift by
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+The shifted schedule.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.instructions.Play.md b/docs/api/qiskit/0.46/qiskit.pulse.instructions.Play.md
new file mode 100644
index 00000000000..125e5646447
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.instructions.Play.md
@@ -0,0 +1,257 @@
+---
+title: Play
+description: API reference for qiskit.pulse.instructions.Play
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.instructions.Play
+---
+
+# Play
+
+
+
+`qiskit.pulse.instructions.Play(pulse, channel, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/instructions/play.py "view source code")
+
+Bases: [`Instruction`](pulse#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")
+
+This instruction is responsible for applying a pulse on a channel.
+
+The pulse specifies the exact time dynamics of the output signal envelope for a limited time. The output is modulated by a phase and frequency which are controlled by separate instructions. The pulse duration must be fixed, and is implicitly given in terms of the cycle time, dt, of the backend.
+
+Create a new pulse instruction.
+
+**Parameters**
+
+* **pulse** (*Pulse*) – A pulse waveform description, such as [`Waveform`](qiskit.pulse.library.Waveform "qiskit.pulse.library.Waveform").
+* **channel** (*PulseChannel*) – The channel to which the pulse is applied.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the instruction for display purposes. Defaults to `pulse.name`.
+
+## Attributes
+
+
+
+### channel
+
+Return the [`Channel`](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel") that this instruction is scheduled on.
+
+
+
+### channels
+
+Returns the channels that this schedule uses.
+
+
+
+### duration
+
+Duration of this instruction.
+
+
+
+### id
+
+Unique identifier for this instruction.
+
+
+
+### instructions
+
+Iterable for getting instructions from Schedule tree.
+
+
+
+### name
+
+Name of this instruction.
+
+
+
+### operands
+
+Return instruction operands.
+
+
+
+### parameters
+
+Parameters which determine the instruction behavior.
+
+
+
+### pulse
+
+A description of the samples that will be played.
+
+
+
+### start\_time
+
+Relative begin time of this instruction.
+
+
+
+### stop\_time
+
+Relative end time of this instruction.
+
+## Methods
+
+### append
+
+
+
+`append(schedule, name=None)`
+
+Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted at the maximum time over all channels shared between `self` and `schedule`.
+
+**Parameters**
+
+* **schedule** (*Union\['Schedule', 'Instruction']*) – Schedule or instruction to be appended
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+A new schedule with `schedule` a this instruction at t=0.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
+### ch\_duration
+
+
+
+`ch_duration(*channels)`
+
+Return duration of the supplied channels in this Instruction.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_start\_time
+
+
+
+`ch_start_time(*channels)`
+
+Return minimum start time for supplied channels.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_stop\_time
+
+
+
+`ch_stop_time(*channels)`
+
+Return maximum start time for supplied channels.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### draw
+
+
+
+`draw(dt=1, style=None, filename=None, interp_method=None, scale=1, plot_all=False, plot_range=None, interactive=False, table=True, label=False, framechange=True, channels=None)`
+
+Plot the instruction.
+
+
+ The method `qiskit.pulse.instructions.instruction.Instruction.draw()` is deprecated as of qiskit-terra 0.23.0. It will be removed in the Qiskit 1.0 release. No direct alternative is being provided to drawing individual pulses. But, instructions can be visualized as part of a complete schedule using `qiskit.visualization.pulse_drawer`.
+
+
+**Parameters**
+
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Time interval of samples
+* **style** (*Optional\[SchedStyle]*) – A style sheet to configure plot appearance
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name required to save pulse image
+* **interp\_method** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *| None*) – A function for interpolation
+* **scale** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Relative visual scaling of waveform amplitudes
+* **plot\_all** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Plot empty channels
+* **plot\_range** ([*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – A tuple of time range to plot
+* **interactive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – When set true show the circuit in a new window (this depends on the matplotlib backend being used supporting this)
+* **table** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Draw event table for supported instructions
+* **label** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Label individual instructions
+* **framechange** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Add framechange indicators
+* **channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*] | None*) – A list of channel names to plot
+
+**Returns**
+
+A matplotlib figure object of the pulse schedule
+
+**Return type**
+
+matplotlib.figure
+
+### insert
+
+
+
+`insert(start_time, schedule, name=None)`
+
+Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`.
+
+**Parameters**
+
+* **start\_time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to insert the schedule schedule
+* **schedule** (*Union\['Schedule', 'Instruction']*) – Schedule or instruction to insert
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+A new schedule with `schedule` inserted with this instruction at t=0.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True iff the instruction is parameterized.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### shift
+
+
+
+`shift(time, name=None)`
+
+Return a new schedule shifted forward by time.
+
+**Parameters**
+
+* **time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to shift by
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+The shifted schedule.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.instructions.Reference.md b/docs/api/qiskit/0.46/qiskit.pulse.instructions.Reference.md
new file mode 100644
index 00000000000..495498f1775
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.instructions.Reference.md
@@ -0,0 +1,268 @@
+---
+title: Reference
+description: API reference for qiskit.pulse.instructions.Reference
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.instructions.Reference
+---
+
+# Reference
+
+
+
+`qiskit.pulse.instructions.Reference(name, *extra_keys)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/instructions/reference.py "view source code")
+
+Bases: [`Instruction`](pulse#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")
+
+Pulse compiler directive that refers to a subroutine.
+
+If a pulse program uses the same subset of instructions multiple times, then using the [`Reference`](#qiskit.pulse.instructions.Reference "qiskit.pulse.instructions.Reference") class may significantly reduce the memory footprint of the program. This instruction only stores the set of strings to identify the subroutine.
+
+The actual pulse program can be stored in the `ScheduleBlock.references` of the [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") that this reference instruction belongs to.
+
+You can later assign schedules with the `ScheduleBlock.assign_references()` method. This allows you to build the main program without knowing the actual subroutine, that is supplied at a later time.
+
+Create new reference.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Name of subroutine.
+* **extra\_keys** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Optional. A set of string keys that may be necessary to refer to a particular subroutine. For example, when we use “sx” as a name to refer to the subroutine of an sx pulse, this name might be used among schedules for different qubits. In this example, you may specify “q0” in the extra keys to distinguish the sx schedule for qubit 0 from others. The user can use an arbitrary number of extra string keys to uniquely determine the subroutine.
+
+## Attributes
+
+
+
+### channels
+
+Returns the channels that this schedule uses.
+
+
+
+### duration
+
+Duration of this instruction.
+
+
+
+### id
+
+Unique identifier for this instruction.
+
+
+
+### instructions
+
+Iterable for getting instructions from Schedule tree.
+
+
+
+### key\_delimiter
+
+`= ','`
+
+
+
+### name
+
+Name of this instruction.
+
+
+
+### operands
+
+Return instruction operands.
+
+
+
+### parameters
+
+Parameters which determine the instruction behavior.
+
+
+
+### ref\_keys
+
+Returns unique key of the subroutine.
+
+
+
+### scope\_delimiter = '
+
+`= ':`
+
+`= '::'`
+
+
+
+### start\_time
+
+Relative begin time of this instruction.
+
+
+
+### stop\_time
+
+Relative end time of this instruction.
+
+## Methods
+
+### append
+
+
+
+`append(schedule, name=None)`
+
+Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted at the maximum time over all channels shared between `self` and `schedule`.
+
+**Parameters**
+
+* **schedule** (*Union\['Schedule', 'Instruction']*) – Schedule or instruction to be appended
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+A new schedule with `schedule` a this instruction at t=0.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
+### ch\_duration
+
+
+
+`ch_duration(*channels)`
+
+Return duration of the supplied channels in this Instruction.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_start\_time
+
+
+
+`ch_start_time(*channels)`
+
+Return minimum start time for supplied channels.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_stop\_time
+
+
+
+`ch_stop_time(*channels)`
+
+Return maximum start time for supplied channels.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### draw
+
+
+
+`draw(dt=1, style=None, filename=None, interp_method=None, scale=1, plot_all=False, plot_range=None, interactive=False, table=True, label=False, framechange=True, channels=None)`
+
+Plot the instruction.
+
+
+ The method `qiskit.pulse.instructions.instruction.Instruction.draw()` is deprecated as of qiskit-terra 0.23.0. It will be removed in the Qiskit 1.0 release. No direct alternative is being provided to drawing individual pulses. But, instructions can be visualized as part of a complete schedule using `qiskit.visualization.pulse_drawer`.
+
+
+**Parameters**
+
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Time interval of samples
+* **style** (*Optional\[SchedStyle]*) – A style sheet to configure plot appearance
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name required to save pulse image
+* **interp\_method** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *| None*) – A function for interpolation
+* **scale** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Relative visual scaling of waveform amplitudes
+* **plot\_all** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Plot empty channels
+* **plot\_range** ([*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – A tuple of time range to plot
+* **interactive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – When set true show the circuit in a new window (this depends on the matplotlib backend being used supporting this)
+* **table** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Draw event table for supported instructions
+* **label** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Label individual instructions
+* **framechange** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Add framechange indicators
+* **channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*] | None*) – A list of channel names to plot
+
+**Returns**
+
+A matplotlib figure object of the pulse schedule
+
+**Return type**
+
+matplotlib.figure
+
+### insert
+
+
+
+`insert(start_time, schedule, name=None)`
+
+Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`.
+
+**Parameters**
+
+* **start\_time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to insert the schedule schedule
+* **schedule** (*Union\['Schedule', 'Instruction']*) – Schedule or instruction to insert
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+A new schedule with `schedule` inserted with this instruction at t=0.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True iff the instruction is parameterized.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### shift
+
+
+
+`shift(time, name=None)`
+
+Return a new schedule shifted forward by time.
+
+**Parameters**
+
+* **time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to shift by
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+The shifted schedule.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.instructions.RelativeBarrier.md b/docs/api/qiskit/0.46/qiskit.pulse.instructions.RelativeBarrier.md
new file mode 100644
index 00000000000..23ef2e0c82b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.instructions.RelativeBarrier.md
@@ -0,0 +1,244 @@
+---
+title: RelativeBarrier
+description: API reference for qiskit.pulse.instructions.RelativeBarrier
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.instructions.RelativeBarrier
+---
+
+# RelativeBarrier
+
+
+
+`qiskit.pulse.instructions.RelativeBarrier(*channels, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/instructions/directives.py "view source code")
+
+Bases: `Directive`
+
+Pulse `RelativeBarrier` directive.
+
+Create a relative barrier directive.
+
+The barrier directive blocks instructions within the same schedule as the barrier on channels contained within this barrier from moving through the barrier in time.
+
+**Parameters**
+
+* **channels** ([*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")) – The channel that the barrier applies to.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the directive for display purposes.
+
+## Attributes
+
+
+
+### channels
+
+Returns the channels that this schedule uses.
+
+
+
+### duration
+
+Duration of this instruction.
+
+
+
+### id
+
+Unique identifier for this instruction.
+
+
+
+### instructions
+
+Iterable for getting instructions from Schedule tree.
+
+
+
+### name
+
+Name of this instruction.
+
+
+
+### operands
+
+Return instruction operands.
+
+
+
+### parameters
+
+Parameters which determine the instruction behavior.
+
+
+
+### start\_time
+
+Relative begin time of this instruction.
+
+
+
+### stop\_time
+
+Relative end time of this instruction.
+
+## Methods
+
+### append
+
+
+
+`append(schedule, name=None)`
+
+Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted at the maximum time over all channels shared between `self` and `schedule`.
+
+**Parameters**
+
+* **schedule** (*Union\['Schedule', 'Instruction']*) – Schedule or instruction to be appended
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+A new schedule with `schedule` a this instruction at t=0.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
+### ch\_duration
+
+
+
+`ch_duration(*channels)`
+
+Return duration of the supplied channels in this Instruction.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_start\_time
+
+
+
+`ch_start_time(*channels)`
+
+Return minimum start time for supplied channels.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_stop\_time
+
+
+
+`ch_stop_time(*channels)`
+
+Return maximum start time for supplied channels.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### draw
+
+
+
+`draw(dt=1, style=None, filename=None, interp_method=None, scale=1, plot_all=False, plot_range=None, interactive=False, table=True, label=False, framechange=True, channels=None)`
+
+Plot the instruction.
+
+
+ The method `qiskit.pulse.instructions.instruction.Instruction.draw()` is deprecated as of qiskit-terra 0.23.0. It will be removed in the Qiskit 1.0 release. No direct alternative is being provided to drawing individual pulses. But, instructions can be visualized as part of a complete schedule using `qiskit.visualization.pulse_drawer`.
+
+
+**Parameters**
+
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Time interval of samples
+* **style** (*Optional\[SchedStyle]*) – A style sheet to configure plot appearance
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name required to save pulse image
+* **interp\_method** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *| None*) – A function for interpolation
+* **scale** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Relative visual scaling of waveform amplitudes
+* **plot\_all** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Plot empty channels
+* **plot\_range** ([*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – A tuple of time range to plot
+* **interactive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – When set true show the circuit in a new window (this depends on the matplotlib backend being used supporting this)
+* **table** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Draw event table for supported instructions
+* **label** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Label individual instructions
+* **framechange** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Add framechange indicators
+* **channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*] | None*) – A list of channel names to plot
+
+**Returns**
+
+A matplotlib figure object of the pulse schedule
+
+**Return type**
+
+matplotlib.figure
+
+### insert
+
+
+
+`insert(start_time, schedule, name=None)`
+
+Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`.
+
+**Parameters**
+
+* **start\_time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to insert the schedule schedule
+* **schedule** (*Union\['Schedule', 'Instruction']*) – Schedule or instruction to insert
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+A new schedule with `schedule` inserted with this instruction at t=0.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True iff the instruction is parameterized.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### shift
+
+
+
+`shift(time, name=None)`
+
+Return a new schedule shifted forward by time.
+
+**Parameters**
+
+* **time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to shift by
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+The shifted schedule.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.instructions.SetFrequency.md b/docs/api/qiskit/0.46/qiskit.pulse.instructions.SetFrequency.md
new file mode 100644
index 00000000000..771d723084f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.instructions.SetFrequency.md
@@ -0,0 +1,265 @@
+---
+title: SetFrequency
+description: API reference for qiskit.pulse.instructions.SetFrequency
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.instructions.SetFrequency
+---
+
+# SetFrequency
+
+
+
+`qiskit.pulse.instructions.SetFrequency(frequency, channel, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/instructions/frequency.py "view source code")
+
+Bases: [`Instruction`](pulse#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")
+
+Set the channel frequency. This instruction operates on `PulseChannel` s. A `PulseChannel` creates pulses of the form
+
+$$
+Re[\exp(i 2\pi f jdt + \phi) d_j].
+
+
+$$
+
+Here, $f$ is the frequency of the channel. The instruction `SetFrequency` allows the user to set the value of $f$. All pulses that are played on a channel after SetFrequency has been called will have the corresponding frequency.
+
+The duration of SetFrequency is 0.
+
+Creates a new set channel frequency instruction.
+
+**Parameters**
+
+* **frequency** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – New frequency of the channel in Hz.
+* **channel** (*PulseChannel*) – The channel this instruction operates on.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of this set channel frequency instruction.
+
+## Attributes
+
+
+
+### channel
+
+Return the [`Channel`](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel") that this instruction is scheduled on.
+
+
+
+### channels
+
+Returns the channels that this schedule uses.
+
+
+
+### duration
+
+Duration of this instruction.
+
+
+
+### frequency
+
+New frequency.
+
+
+
+### id
+
+Unique identifier for this instruction.
+
+
+
+### instructions
+
+Iterable for getting instructions from Schedule tree.
+
+
+
+### name
+
+Name of this instruction.
+
+
+
+### operands
+
+Return instruction operands.
+
+
+
+### parameters
+
+Parameters which determine the instruction behavior.
+
+
+
+### start\_time
+
+Relative begin time of this instruction.
+
+
+
+### stop\_time
+
+Relative end time of this instruction.
+
+## Methods
+
+### append
+
+
+
+`append(schedule, name=None)`
+
+Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted at the maximum time over all channels shared between `self` and `schedule`.
+
+**Parameters**
+
+* **schedule** (*Union\['Schedule', 'Instruction']*) – Schedule or instruction to be appended
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+A new schedule with `schedule` a this instruction at t=0.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
+### ch\_duration
+
+
+
+`ch_duration(*channels)`
+
+Return duration of the supplied channels in this Instruction.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_start\_time
+
+
+
+`ch_start_time(*channels)`
+
+Return minimum start time for supplied channels.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_stop\_time
+
+
+
+`ch_stop_time(*channels)`
+
+Return maximum start time for supplied channels.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### draw
+
+
+
+`draw(dt=1, style=None, filename=None, interp_method=None, scale=1, plot_all=False, plot_range=None, interactive=False, table=True, label=False, framechange=True, channels=None)`
+
+Plot the instruction.
+
+
+ The method `qiskit.pulse.instructions.instruction.Instruction.draw()` is deprecated as of qiskit-terra 0.23.0. It will be removed in the Qiskit 1.0 release. No direct alternative is being provided to drawing individual pulses. But, instructions can be visualized as part of a complete schedule using `qiskit.visualization.pulse_drawer`.
+
+
+**Parameters**
+
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Time interval of samples
+* **style** (*Optional\[SchedStyle]*) – A style sheet to configure plot appearance
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name required to save pulse image
+* **interp\_method** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *| None*) – A function for interpolation
+* **scale** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Relative visual scaling of waveform amplitudes
+* **plot\_all** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Plot empty channels
+* **plot\_range** ([*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – A tuple of time range to plot
+* **interactive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – When set true show the circuit in a new window (this depends on the matplotlib backend being used supporting this)
+* **table** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Draw event table for supported instructions
+* **label** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Label individual instructions
+* **framechange** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Add framechange indicators
+* **channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*] | None*) – A list of channel names to plot
+
+**Returns**
+
+A matplotlib figure object of the pulse schedule
+
+**Return type**
+
+matplotlib.figure
+
+### insert
+
+
+
+`insert(start_time, schedule, name=None)`
+
+Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`.
+
+**Parameters**
+
+* **start\_time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to insert the schedule schedule
+* **schedule** (*Union\['Schedule', 'Instruction']*) – Schedule or instruction to insert
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+A new schedule with `schedule` inserted with this instruction at t=0.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True iff the instruction is parameterized.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### shift
+
+
+
+`shift(time, name=None)`
+
+Return a new schedule shifted forward by time.
+
+**Parameters**
+
+* **time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to shift by
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+The shifted schedule.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.instructions.SetPhase.md b/docs/api/qiskit/0.46/qiskit.pulse.instructions.SetPhase.md
new file mode 100644
index 00000000000..20ee6dfade3
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.instructions.SetPhase.md
@@ -0,0 +1,263 @@
+---
+title: SetPhase
+description: API reference for qiskit.pulse.instructions.SetPhase
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.instructions.SetPhase
+---
+
+# SetPhase
+
+
+
+`qiskit.pulse.instructions.SetPhase(phase, channel, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/instructions/phase.py "view source code")
+
+Bases: [`Instruction`](pulse#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")
+
+The set phase instruction sets the phase of the proceeding pulses on that channel to `phase` radians.
+
+In particular, a PulseChannel creates pulses of the form
+
+$$
+Re[\exp(i 2\pi f jdt + \phi) d_j]
+$$
+
+The `SetPhase` instruction sets $\phi$ to the instruction’s `phase` operand.
+
+Instantiate a set phase instruction, setting the output signal phase on `channel` to `phase` \[radians].
+
+**Parameters**
+
+* **phase** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The rotation angle in radians.
+* **channel** (*PulseChannel*) – The channel this instruction operates on.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Display name for this instruction.
+
+## Attributes
+
+
+
+### channel
+
+Return the [`Channel`](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel") that this instruction is scheduled on.
+
+
+
+### channels
+
+Returns the channels that this schedule uses.
+
+
+
+### duration
+
+Duration of this instruction.
+
+
+
+### id
+
+Unique identifier for this instruction.
+
+
+
+### instructions
+
+Iterable for getting instructions from Schedule tree.
+
+
+
+### name
+
+Name of this instruction.
+
+
+
+### operands
+
+Return instruction operands.
+
+
+
+### parameters
+
+Parameters which determine the instruction behavior.
+
+
+
+### phase
+
+Return the rotation angle enacted by this instruction in radians.
+
+
+
+### start\_time
+
+Relative begin time of this instruction.
+
+
+
+### stop\_time
+
+Relative end time of this instruction.
+
+## Methods
+
+### append
+
+
+
+`append(schedule, name=None)`
+
+Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted at the maximum time over all channels shared between `self` and `schedule`.
+
+**Parameters**
+
+* **schedule** (*Union\['Schedule', 'Instruction']*) – Schedule or instruction to be appended
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+A new schedule with `schedule` a this instruction at t=0.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
+### ch\_duration
+
+
+
+`ch_duration(*channels)`
+
+Return duration of the supplied channels in this Instruction.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_start\_time
+
+
+
+`ch_start_time(*channels)`
+
+Return minimum start time for supplied channels.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_stop\_time
+
+
+
+`ch_stop_time(*channels)`
+
+Return maximum start time for supplied channels.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### draw
+
+
+
+`draw(dt=1, style=None, filename=None, interp_method=None, scale=1, plot_all=False, plot_range=None, interactive=False, table=True, label=False, framechange=True, channels=None)`
+
+Plot the instruction.
+
+
+ The method `qiskit.pulse.instructions.instruction.Instruction.draw()` is deprecated as of qiskit-terra 0.23.0. It will be removed in the Qiskit 1.0 release. No direct alternative is being provided to drawing individual pulses. But, instructions can be visualized as part of a complete schedule using `qiskit.visualization.pulse_drawer`.
+
+
+**Parameters**
+
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Time interval of samples
+* **style** (*Optional\[SchedStyle]*) – A style sheet to configure plot appearance
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name required to save pulse image
+* **interp\_method** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *| None*) – A function for interpolation
+* **scale** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Relative visual scaling of waveform amplitudes
+* **plot\_all** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Plot empty channels
+* **plot\_range** ([*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – A tuple of time range to plot
+* **interactive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – When set true show the circuit in a new window (this depends on the matplotlib backend being used supporting this)
+* **table** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Draw event table for supported instructions
+* **label** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Label individual instructions
+* **framechange** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Add framechange indicators
+* **channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*] | None*) – A list of channel names to plot
+
+**Returns**
+
+A matplotlib figure object of the pulse schedule
+
+**Return type**
+
+matplotlib.figure
+
+### insert
+
+
+
+`insert(start_time, schedule, name=None)`
+
+Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`.
+
+**Parameters**
+
+* **start\_time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to insert the schedule schedule
+* **schedule** (*Union\['Schedule', 'Instruction']*) – Schedule or instruction to insert
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+A new schedule with `schedule` inserted with this instruction at t=0.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True iff the instruction is parameterized.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### shift
+
+
+
+`shift(time, name=None)`
+
+Return a new schedule shifted forward by time.
+
+**Parameters**
+
+* **time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to shift by
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+The shifted schedule.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.instructions.ShiftFrequency.md b/docs/api/qiskit/0.46/qiskit.pulse.instructions.ShiftFrequency.md
new file mode 100644
index 00000000000..9e0ca23a4fb
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.instructions.ShiftFrequency.md
@@ -0,0 +1,255 @@
+---
+title: ShiftFrequency
+description: API reference for qiskit.pulse.instructions.ShiftFrequency
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.instructions.ShiftFrequency
+---
+
+# ShiftFrequency
+
+
+
+`qiskit.pulse.instructions.ShiftFrequency(frequency, channel, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/instructions/frequency.py "view source code")
+
+Bases: [`Instruction`](pulse#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")
+
+Shift the channel frequency away from the current frequency.
+
+Creates a new shift frequency instruction.
+
+**Parameters**
+
+* **frequency** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – Frequency shift of the channel in Hz.
+* **channel** (*PulseChannel*) – The channel this instruction operates on.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of this set channel frequency instruction.
+
+## Attributes
+
+
+
+### channel
+
+Return the [`Channel`](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel") that this instruction is scheduled on.
+
+
+
+### channels
+
+Returns the channels that this schedule uses.
+
+
+
+### duration
+
+Duration of this instruction.
+
+
+
+### frequency
+
+Frequency shift from the set frequency.
+
+
+
+### id
+
+Unique identifier for this instruction.
+
+
+
+### instructions
+
+Iterable for getting instructions from Schedule tree.
+
+
+
+### name
+
+Name of this instruction.
+
+
+
+### operands
+
+Return instruction operands.
+
+
+
+### parameters
+
+Parameters which determine the instruction behavior.
+
+
+
+### start\_time
+
+Relative begin time of this instruction.
+
+
+
+### stop\_time
+
+Relative end time of this instruction.
+
+## Methods
+
+### append
+
+
+
+`append(schedule, name=None)`
+
+Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted at the maximum time over all channels shared between `self` and `schedule`.
+
+**Parameters**
+
+* **schedule** (*Union\['Schedule', 'Instruction']*) – Schedule or instruction to be appended
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+A new schedule with `schedule` a this instruction at t=0.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
+### ch\_duration
+
+
+
+`ch_duration(*channels)`
+
+Return duration of the supplied channels in this Instruction.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_start\_time
+
+
+
+`ch_start_time(*channels)`
+
+Return minimum start time for supplied channels.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_stop\_time
+
+
+
+`ch_stop_time(*channels)`
+
+Return maximum start time for supplied channels.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### draw
+
+
+
+`draw(dt=1, style=None, filename=None, interp_method=None, scale=1, plot_all=False, plot_range=None, interactive=False, table=True, label=False, framechange=True, channels=None)`
+
+Plot the instruction.
+
+
+ The method `qiskit.pulse.instructions.instruction.Instruction.draw()` is deprecated as of qiskit-terra 0.23.0. It will be removed in the Qiskit 1.0 release. No direct alternative is being provided to drawing individual pulses. But, instructions can be visualized as part of a complete schedule using `qiskit.visualization.pulse_drawer`.
+
+
+**Parameters**
+
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Time interval of samples
+* **style** (*Optional\[SchedStyle]*) – A style sheet to configure plot appearance
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name required to save pulse image
+* **interp\_method** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *| None*) – A function for interpolation
+* **scale** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Relative visual scaling of waveform amplitudes
+* **plot\_all** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Plot empty channels
+* **plot\_range** ([*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – A tuple of time range to plot
+* **interactive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – When set true show the circuit in a new window (this depends on the matplotlib backend being used supporting this)
+* **table** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Draw event table for supported instructions
+* **label** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Label individual instructions
+* **framechange** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Add framechange indicators
+* **channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*] | None*) – A list of channel names to plot
+
+**Returns**
+
+A matplotlib figure object of the pulse schedule
+
+**Return type**
+
+matplotlib.figure
+
+### insert
+
+
+
+`insert(start_time, schedule, name=None)`
+
+Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`.
+
+**Parameters**
+
+* **start\_time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to insert the schedule schedule
+* **schedule** (*Union\['Schedule', 'Instruction']*) – Schedule or instruction to insert
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+A new schedule with `schedule` inserted with this instruction at t=0.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True iff the instruction is parameterized.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### shift
+
+
+
+`shift(time, name=None)`
+
+Return a new schedule shifted forward by time.
+
+**Parameters**
+
+* **time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to shift by
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+The shifted schedule.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.instructions.ShiftPhase.md b/docs/api/qiskit/0.46/qiskit.pulse.instructions.ShiftPhase.md
new file mode 100644
index 00000000000..e6da3a67285
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.instructions.ShiftPhase.md
@@ -0,0 +1,267 @@
+---
+title: ShiftPhase
+description: API reference for qiskit.pulse.instructions.ShiftPhase
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.instructions.ShiftPhase
+---
+
+# ShiftPhase
+
+
+
+`qiskit.pulse.instructions.ShiftPhase(phase, channel, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/instructions/phase.py "view source code")
+
+Bases: [`Instruction`](pulse#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")
+
+The shift phase instruction updates the modulation phase of proceeding pulses played on the same [`Channel`](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel"). It is a relative increase in phase determined by the `phase` operand.
+
+In particular, a PulseChannel creates pulses of the form
+
+$$
+Re[\exp(i 2\pi f jdt + \phi) d_j].
+
+
+$$
+
+The `ShiftPhase` instruction causes $\phi$ to be increased by the instruction’s `phase` operand. This will affect all pulses following on the same channel.
+
+The qubit phase is tracked in software, enabling instantaneous, nearly error-free Z-rotations by using a ShiftPhase to update the frame tracking the qubit state.
+
+Instantiate a shift phase instruction, increasing the output signal phase on `channel` by `phase` \[radians].
+
+**Parameters**
+
+* **phase** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The rotation angle in radians.
+* **channel** (*PulseChannel*) – The channel this instruction operates on.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Display name for this instruction.
+
+## Attributes
+
+
+
+### channel
+
+Return the [`Channel`](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel") that this instruction is scheduled on.
+
+
+
+### channels
+
+Returns the channels that this schedule uses.
+
+
+
+### duration
+
+Duration of this instruction.
+
+
+
+### id
+
+Unique identifier for this instruction.
+
+
+
+### instructions
+
+Iterable for getting instructions from Schedule tree.
+
+
+
+### name
+
+Name of this instruction.
+
+
+
+### operands
+
+Return instruction operands.
+
+
+
+### parameters
+
+Parameters which determine the instruction behavior.
+
+
+
+### phase
+
+Return the rotation angle enacted by this instruction in radians.
+
+
+
+### start\_time
+
+Relative begin time of this instruction.
+
+
+
+### stop\_time
+
+Relative end time of this instruction.
+
+## Methods
+
+### append
+
+
+
+`append(schedule, name=None)`
+
+Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted at the maximum time over all channels shared between `self` and `schedule`.
+
+**Parameters**
+
+* **schedule** (*Union\['Schedule', 'Instruction']*) – Schedule or instruction to be appended
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+A new schedule with `schedule` a this instruction at t=0.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
+### ch\_duration
+
+
+
+`ch_duration(*channels)`
+
+Return duration of the supplied channels in this Instruction.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_start\_time
+
+
+
+`ch_start_time(*channels)`
+
+Return minimum start time for supplied channels.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_stop\_time
+
+
+
+`ch_stop_time(*channels)`
+
+Return maximum start time for supplied channels.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### draw
+
+
+
+`draw(dt=1, style=None, filename=None, interp_method=None, scale=1, plot_all=False, plot_range=None, interactive=False, table=True, label=False, framechange=True, channels=None)`
+
+Plot the instruction.
+
+
+ The method `qiskit.pulse.instructions.instruction.Instruction.draw()` is deprecated as of qiskit-terra 0.23.0. It will be removed in the Qiskit 1.0 release. No direct alternative is being provided to drawing individual pulses. But, instructions can be visualized as part of a complete schedule using `qiskit.visualization.pulse_drawer`.
+
+
+**Parameters**
+
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Time interval of samples
+* **style** (*Optional\[SchedStyle]*) – A style sheet to configure plot appearance
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name required to save pulse image
+* **interp\_method** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *| None*) – A function for interpolation
+* **scale** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Relative visual scaling of waveform amplitudes
+* **plot\_all** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Plot empty channels
+* **plot\_range** ([*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – A tuple of time range to plot
+* **interactive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – When set true show the circuit in a new window (this depends on the matplotlib backend being used supporting this)
+* **table** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Draw event table for supported instructions
+* **label** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Label individual instructions
+* **framechange** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Add framechange indicators
+* **channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*] | None*) – A list of channel names to plot
+
+**Returns**
+
+A matplotlib figure object of the pulse schedule
+
+**Return type**
+
+matplotlib.figure
+
+### insert
+
+
+
+`insert(start_time, schedule, name=None)`
+
+Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`.
+
+**Parameters**
+
+* **start\_time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to insert the schedule schedule
+* **schedule** (*Union\['Schedule', 'Instruction']*) – Schedule or instruction to insert
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+A new schedule with `schedule` inserted with this instruction at t=0.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True iff the instruction is parameterized.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### shift
+
+
+
+`shift(time, name=None)`
+
+Return a new schedule shifted forward by time.
+
+**Parameters**
+
+* **time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to shift by
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+The shifted schedule.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.instructions.Snapshot.md b/docs/api/qiskit/0.46/qiskit.pulse.instructions.Snapshot.md
new file mode 100644
index 00000000000..5ba7515d7e3
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.instructions.Snapshot.md
@@ -0,0 +1,261 @@
+---
+title: Snapshot
+description: API reference for qiskit.pulse.instructions.Snapshot
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.instructions.Snapshot
+---
+
+# Snapshot
+
+
+
+`qiskit.pulse.instructions.Snapshot(label, snapshot_type='statevector', name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/instructions/snapshot.py "view source code")
+
+Bases: [`Instruction`](pulse#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")
+
+An instruction targeted for simulators, to capture a moment in the simulation.
+
+Create new snapshot.
+
+**Parameters**
+
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Snapshot label which is used to identify the snapshot in the output.
+* **snapshot\_type** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Type of snapshot, e.g., “state” (take a snapshot of the quantum state). The types of snapshots offered are defined by the simulator used.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Snapshot name which defaults to `label`. This parameter is only for display purposes and is not taken into account during comparison.
+
+## Attributes
+
+
+
+### channel
+
+Return the [`Channel`](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel") that this instruction is scheduled on; trivially, a `SnapshotChannel`.
+
+
+
+### channels
+
+Returns the channels that this schedule uses.
+
+
+
+### duration
+
+Duration of this instruction.
+
+
+
+### id
+
+Unique identifier for this instruction.
+
+
+
+### instructions
+
+Iterable for getting instructions from Schedule tree.
+
+
+
+### label
+
+Label of snapshot.
+
+
+
+### name
+
+Name of this instruction.
+
+
+
+### operands
+
+Return instruction operands.
+
+
+
+### parameters
+
+Parameters which determine the instruction behavior.
+
+
+
+### start\_time
+
+Relative begin time of this instruction.
+
+
+
+### stop\_time
+
+Relative end time of this instruction.
+
+
+
+### type
+
+Type of snapshot.
+
+## Methods
+
+### append
+
+
+
+`append(schedule, name=None)`
+
+Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted at the maximum time over all channels shared between `self` and `schedule`.
+
+**Parameters**
+
+* **schedule** (*Union\['Schedule', 'Instruction']*) – Schedule or instruction to be appended
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+A new schedule with `schedule` a this instruction at t=0.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
+### ch\_duration
+
+
+
+`ch_duration(*channels)`
+
+Return duration of the supplied channels in this Instruction.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_start\_time
+
+
+
+`ch_start_time(*channels)`
+
+Return minimum start time for supplied channels.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_stop\_time
+
+
+
+`ch_stop_time(*channels)`
+
+Return maximum start time for supplied channels.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### draw
+
+
+
+`draw(dt=1, style=None, filename=None, interp_method=None, scale=1, plot_all=False, plot_range=None, interactive=False, table=True, label=False, framechange=True, channels=None)`
+
+Plot the instruction.
+
+
+ The method `qiskit.pulse.instructions.instruction.Instruction.draw()` is deprecated as of qiskit-terra 0.23.0. It will be removed in the Qiskit 1.0 release. No direct alternative is being provided to drawing individual pulses. But, instructions can be visualized as part of a complete schedule using `qiskit.visualization.pulse_drawer`.
+
+
+**Parameters**
+
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Time interval of samples
+* **style** (*Optional\[SchedStyle]*) – A style sheet to configure plot appearance
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name required to save pulse image
+* **interp\_method** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *| None*) – A function for interpolation
+* **scale** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Relative visual scaling of waveform amplitudes
+* **plot\_all** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Plot empty channels
+* **plot\_range** ([*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – A tuple of time range to plot
+* **interactive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – When set true show the circuit in a new window (this depends on the matplotlib backend being used supporting this)
+* **table** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Draw event table for supported instructions
+* **label** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Label individual instructions
+* **framechange** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Add framechange indicators
+* **channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*] | None*) – A list of channel names to plot
+
+**Returns**
+
+A matplotlib figure object of the pulse schedule
+
+**Return type**
+
+matplotlib.figure
+
+### insert
+
+
+
+`insert(start_time, schedule, name=None)`
+
+Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`.
+
+**Parameters**
+
+* **start\_time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to insert the schedule schedule
+* **schedule** (*Union\['Schedule', 'Instruction']*) – Schedule or instruction to insert
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+A new schedule with `schedule` inserted with this instruction at t=0.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True iff the instruction is parameterized.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### shift
+
+
+
+`shift(time, name=None)`
+
+Return a new schedule shifted forward by time.
+
+**Parameters**
+
+* **time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to shift by
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+The shifted schedule.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.instructions.TimeBlockade.md b/docs/api/qiskit/0.46/qiskit.pulse.instructions.TimeBlockade.md
new file mode 100644
index 00000000000..f98c6b69bc4
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.instructions.TimeBlockade.md
@@ -0,0 +1,280 @@
+---
+title: TimeBlockade
+description: API reference for qiskit.pulse.instructions.TimeBlockade
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.instructions.TimeBlockade
+---
+
+# TimeBlockade
+
+
+
+`qiskit.pulse.instructions.TimeBlockade(duration, channel, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/instructions/directives.py "view source code")
+
+Bases: `Directive`
+
+Pulse `TimeBlockade` directive.
+
+This instruction is intended to be used internally within the pulse builder, to convert [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") into [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"). Because [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") cannot take an absolute instruction time interval, this directive helps the block representation to find the starting time of an instruction.
+
+**Example**
+
+This schedule plays constant pulse at t0 = 120.
+
+```python
+schedule = Schedule()
+schedule.insert(120, Play(Constant(10, 0.1), DriveChannel(0)))
+```
+
+This schedule block is expected to be identical to above at a time of execution.
+
+```python
+block = ScheduleBlock()
+block.append(TimeBlockade(120, DriveChannel(0)))
+block.append(Play(Constant(10, 0.1), DriveChannel(0)))
+```
+
+Such conversion may be done by
+
+```python
+from qiskit.pulse.transforms import block_to_schedule, remove_directives
+
+schedule = remove_directives(block_to_schedule(block))
+```
+
+
+ The TimeBlockade instruction behaves almost identically to [`Delay`](qiskit.pulse.instructions.Delay "qiskit.pulse.instructions.Delay") instruction. However, the TimeBlockade is just a compiler directive and must be removed before execution. This may be done by [`remove_directives()`](pulse#qiskit.pulse.transforms.remove_directives "qiskit.pulse.transforms.remove_directives") transform. Once these directives are removed, occupied timeslots are released and user can insert another instruction without timing overlap.
+
+
+Create a time blockade directive.
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Length of time of the occupation in terms of dt.
+* **channel** ([*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")) – The channel that will be the occupied.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the time blockade for display purposes.
+
+## Attributes
+
+
+
+### channel
+
+Return the [`Channel`](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel") that this instruction is scheduled on.
+
+
+
+### channels
+
+Returns the channels that this schedule uses.
+
+
+
+### duration
+
+Duration of this instruction.
+
+
+
+### id
+
+Unique identifier for this instruction.
+
+
+
+### instructions
+
+Iterable for getting instructions from Schedule tree.
+
+
+
+### name
+
+Name of this instruction.
+
+
+
+### operands
+
+Return instruction operands.
+
+
+
+### parameters
+
+Parameters which determine the instruction behavior.
+
+
+
+### start\_time
+
+Relative begin time of this instruction.
+
+
+
+### stop\_time
+
+Relative end time of this instruction.
+
+## Methods
+
+### append
+
+
+
+`append(schedule, name=None)`
+
+Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted at the maximum time over all channels shared between `self` and `schedule`.
+
+**Parameters**
+
+* **schedule** (*Union\['Schedule', 'Instruction']*) – Schedule or instruction to be appended
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+A new schedule with `schedule` a this instruction at t=0.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
+### ch\_duration
+
+
+
+`ch_duration(*channels)`
+
+Return duration of the supplied channels in this Instruction.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_start\_time
+
+
+
+`ch_start_time(*channels)`
+
+Return minimum start time for supplied channels.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### ch\_stop\_time
+
+
+
+`ch_stop_time(*channels)`
+
+Return maximum start time for supplied channels.
+
+**Parameters**
+
+**\*channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*]*) – Supplied channels
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### draw
+
+
+
+`draw(dt=1, style=None, filename=None, interp_method=None, scale=1, plot_all=False, plot_range=None, interactive=False, table=True, label=False, framechange=True, channels=None)`
+
+Plot the instruction.
+
+
+ The method `qiskit.pulse.instructions.instruction.Instruction.draw()` is deprecated as of qiskit-terra 0.23.0. It will be removed in the Qiskit 1.0 release. No direct alternative is being provided to drawing individual pulses. But, instructions can be visualized as part of a complete schedule using `qiskit.visualization.pulse_drawer`.
+
+
+**Parameters**
+
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Time interval of samples
+* **style** (*Optional\[SchedStyle]*) – A style sheet to configure plot appearance
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name required to save pulse image
+* **interp\_method** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *| None*) – A function for interpolation
+* **scale** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Relative visual scaling of waveform amplitudes
+* **plot\_all** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Plot empty channels
+* **plot\_range** ([*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – A tuple of time range to plot
+* **interactive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – When set true show the circuit in a new window (this depends on the matplotlib backend being used supporting this)
+* **table** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Draw event table for supported instructions
+* **label** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Label individual instructions
+* **framechange** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Add framechange indicators
+* **channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*] | None*) – A list of channel names to plot
+
+**Returns**
+
+A matplotlib figure object of the pulse schedule
+
+**Return type**
+
+matplotlib.figure
+
+### insert
+
+
+
+`insert(start_time, schedule, name=None)`
+
+Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`.
+
+**Parameters**
+
+* **start\_time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to insert the schedule schedule
+* **schedule** (*Union\['Schedule', 'Instruction']*) – Schedule or instruction to insert
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+A new schedule with `schedule` inserted with this instruction at t=0.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True iff the instruction is parameterized.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### shift
+
+
+
+`shift(time, name=None)`
+
+Return a new schedule shifted forward by time.
+
+**Parameters**
+
+* **time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time to shift by
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Name of the new schedule. Defaults to name of self
+
+**Returns**
+
+The shifted schedule.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.library.Constant_class.rst.md b/docs/api/qiskit/0.46/qiskit.pulse.library.Constant_class.rst.md
new file mode 100644
index 00000000000..c6ca45c4016
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.library.Constant_class.rst.md
@@ -0,0 +1,45 @@
+---
+title: Constant
+description: API reference for qiskit.pulse.library.Constant
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.library.Constant
+---
+
+# Constant
+
+
+
+`qiskit.pulse.library.Constant(duration, amp, angle=None, name=None, limit_amplitude=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/symbolic_pulses.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+A simple constant pulse, with an amplitude value and a duration:
+
+$$
+f(x) = \text{amp}\times\exp\left(i\text{angle}\right) , 0 <= x < duration
+f(x) = 0 , elsewhere
+$$
+
+Create new pulse instance.
+
+**Parameters**
+
+* **duration** – Pulse length in terms of the sampling period dt.
+* **amp** – The magnitude of the amplitude of the square envelope. Complex amp support is deprecated.
+* **angle** – The angle of the complex amplitude of the square envelope. Default value 0.
+* **name** – Display name for this pulse envelope.
+* **limit\_amplitude** – If `True`, then limit the amplitude of the waveform to 1. The default is `True` and the amplitude is constrained to 1.
+
+**Returns**
+
+ScalableSymbolicPulse instance.
+
+## Attributes
+
+
+
+### alias
+
+`= 'Constant'`
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.library.Cos_class.rst.md b/docs/api/qiskit/0.46/qiskit.pulse.library.Cos_class.rst.md
new file mode 100644
index 00000000000..9dcb8eb5e53
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.library.Cos_class.rst.md
@@ -0,0 +1,44 @@
+---
+title: Cos
+description: API reference for qiskit.pulse.library.Cos
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.pulse.library.Cos
+---
+
+
+
+# qiskit.pulse.library.Cos
+
+
+
+`qiskit.pulse.library.Cos(duration, amp, phase, freq=None, angle=0.0, name=None, limit_amplitude=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/symbolic_pulses.py "view source code")
+
+A cosine pulse.
+
+The envelope of the pulse is given by:
+
+$$
+f(x) = \text{A}\cos\left(2\pi\text{freq}x+\text{phase}\right) , 0 <= x < duration
+$$
+
+where $\text{A} = \text{amp} \times\exp\left(i\times\text{angle}\right)$.
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – Pulse length in terms of the sampling period dt.
+* **amp** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The magnitude of the amplitude of the cosine wave. Wave range is \[-amp,\`amp\`].
+* **phase** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The phase of the cosine wave (note that this is not equivalent to the angle of the complex amplitude).
+* **freq** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The frequency of the cosine wave, in terms of 1 over sampling period. If not provided defaults to a single cycle (i.e :math:’frac\{1}\{text\{duration}}’). The frequency is limited to the range $\left(0,0.5\right]$ (the Nyquist frequency).
+* **angle** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The angle in radians of the complex phase factor uniformly scaling the pulse. Default value 0.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Display name for this pulse envelope.
+* **limit\_amplitude** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – If `True`, then limit the amplitude of the waveform to 1. The default is `True` and the amplitude is constrained to 1.
+
+**Returns**
+
+ScalableSymbolicPulse instance.
+
+**Return type**
+
+*ScalableSymbolicPulse*
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.library.Drag_class.rst.md b/docs/api/qiskit/0.46/qiskit.pulse.library.Drag_class.rst.md
new file mode 100644
index 00000000000..7e576b79092
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.library.Drag_class.rst.md
@@ -0,0 +1,61 @@
+---
+title: Drag
+description: API reference for qiskit.pulse.library.Drag
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.library.Drag
+---
+
+# Drag
+
+
+
+`qiskit.pulse.library.Drag(duration, amp, sigma, beta, angle=None, name=None, limit_amplitude=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/symbolic_pulses.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+The Derivative Removal by Adiabatic Gate (DRAG) pulse is a standard Gaussian pulse with an additional Gaussian derivative component and lifting applied.
+
+It can be calibrated either to reduce the phase error due to virtual population of the $|2\rangle$ state during the pulse or to reduce the frequency spectrum of a standard Gaussian pulse near the $|1\rangle\leftrightarrow|2\rangle$ transition, reducing the chance of leakage to the $|2\rangle$ state.
+
+$$
+\begin{aligned}
+g(x) &= \exp\Bigl(-\frac12 \frac{(x - \text{duration}/2)^2}{\text{sigma}^2}\Bigr)\\
+g'(x) &= \text{A}\times\frac{g(x)-g(-1)}{1-g(-1)}\\
+f(x) &= g'(x) \times \Bigl(1 + 1j \times \text{beta} \times \Bigl(-\frac{x - \text{duration}/2}{\text{sigma}^2}\Bigr) \Bigr),
+ \quad 0 \le x < \text{duration}
+\end{aligned}
+$$
+
+where $g(x)$ is a standard unlifted Gaussian waveform, $g'(x)$ is the lifted [`Gaussian`](qiskit.pulse.library.Gaussian_class.rst#qiskit.pulse.library.Gaussian "qiskit.pulse.library.Gaussian") waveform, and $\text{A} = \text{amp} \times \exp\left(i\times\text{angle}\right)$.
+
+**References**
+
+1. [*Gambetta, J. M., Motzoi, F., Merkel, S. T. & Wilhelm, F. K. Analytic control methods for high-fidelity unitary operations in a weakly nonlinear oscillator. Phys. Rev. A 83, 012308 (2011).*](https://link.aps.org/doi/10.1103/PhysRevA.83.012308)
+
+2. [*F. Motzoi, J. M. Gambetta, P. Rebentrost, and F. K. Wilhelm Phys. Rev. Lett. 103, 110501 – Published 8 September 2009.*](https://link.aps.org/doi/10.1103/PhysRevLett.103.110501)
+
+Create new pulse instance.
+
+**Parameters**
+
+* **duration** – Pulse length in terms of the sampling period dt.
+* **amp** – The magnitude of the amplitude of the DRAG envelope. Complex amp support is deprecated.
+* **sigma** – A measure of how wide or narrow the Gaussian peak is; described mathematically in the class docstring.
+* **beta** – The correction amplitude.
+* **angle** – The angle of the complex amplitude of the DRAG envelope. Default value 0.
+* **name** – Display name for this pulse envelope.
+* **limit\_amplitude** – If `True`, then limit the amplitude of the waveform to 1. The default is `True` and the amplitude is constrained to 1.
+
+**Returns**
+
+ScalableSymbolicPulse instance.
+
+## Attributes
+
+
+
+### alias
+
+`= 'Drag'`
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.library.GaussianDeriv.md b/docs/api/qiskit/0.46/qiskit.pulse.library.GaussianDeriv.md
new file mode 100644
index 00000000000..445dabbda96
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.library.GaussianDeriv.md
@@ -0,0 +1,44 @@
+---
+title: GaussianDeriv
+description: API reference for qiskit.pulse.library.GaussianDeriv
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.pulse.library.GaussianDeriv
+---
+
+
+
+# qiskit.pulse.library.GaussianDeriv
+
+
+
+`qiskit.pulse.library.GaussianDeriv(duration, amp, sigma, angle=0.0, name=None, limit_amplitude=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/symbolic_pulses.py "view source code")
+
+An unnormalized Gaussian derivative pulse.
+
+The Gaussian function is centered around the halfway point of the pulse, and the envelope of the pulse is given by:
+
+$$
+f(x) = -\text{A}\frac{x-\mu}{\text{sigma}^{2}}\exp
+ \left[-\left(\frac{x-\mu}{2\text{sigma}}\right)^{2}\right] , 0 <= x < duration
+$$
+
+where $\text{A} = \text{amp} \times\exp\left(i\times\text{angle}\right)$, and $\mu=\text{duration}/2$.
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – Pulse length in terms of the sampling period dt.
+* **amp** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The magnitude of the amplitude of the pulse (the value of the corresponding Gaussian at the midpoint duration/2).
+* **sigma** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – A measure of how wide or narrow the corresponding Gaussian peak is in terms of dt; described mathematically in the class docstring.
+* **angle** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The angle in radians of the complex phase factor uniformly scaling the pulse. Default value 0.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Display name for this pulse envelope.
+* **limit\_amplitude** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – If `True`, then limit the amplitude of the waveform to 1. The default is `True` and the amplitude is constrained to 1.
+
+**Returns**
+
+ScalableSymbolicPulse instance.
+
+**Return type**
+
+*ScalableSymbolicPulse*
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.library.GaussianSquare.md b/docs/api/qiskit/0.46/qiskit.pulse.library.GaussianSquare.md
new file mode 100644
index 00000000000..2f56de68217
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.library.GaussianSquare.md
@@ -0,0 +1,79 @@
+---
+title: GaussianSquare
+description: API reference for qiskit.pulse.library.GaussianSquare
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.library.GaussianSquare
+---
+
+# GaussianSquare
+
+
+
+`qiskit.pulse.library.GaussianSquare(duration, amp, sigma, width=None, angle=None, risefall_sigma_ratio=None, name=None, limit_amplitude=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/symbolic_pulses.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+A square pulse with a Gaussian shaped risefall on both sides lifted such that its first sample is zero.
+
+Exactly one of the `risefall_sigma_ratio` and `width` parameters has to be specified.
+
+If `risefall_sigma_ratio` is not None and `width` is None:
+
+$$
+\begin{aligned}
+\text{risefall} &= \text{risefall\_sigma\_ratio} \times \text{sigma}\\
+\text{width} &= \text{duration} - 2 \times \text{risefall}
+\end{aligned}
+$$
+
+If `width` is not None and `risefall_sigma_ratio` is None:
+
+$$
+\text{risefall} = \frac{\text{duration} - \text{width}}{2}
+
+
+$$
+
+In both cases, the lifted gaussian square pulse $f'(x)$ is defined as:
+
+$$
+\begin{aligned}
+f'(x) &= \begin{cases} \exp\biggl(-\frac12 \frac{(x - \text{risefall})^2}{\text{sigma}^2}\biggr) & x < \text{risefall}\\
+ 1 & \text{risefall} \le x < \text{risefall} + \text{width}\\
+ \exp\biggl(-\frac12 \frac{{\bigl(x - (\text{risefall} + \text{width})\bigr)}^2} {\text{sigma}^2} \biggr) & \text{risefall} + \text{width} \le x \end{cases}\\
+f(x) &= \text{A} \times \frac{f'(x) - f'(-1)}{1-f'(-1)}, \quad 0 \le x < \text{duration}
+\end{aligned}
+$$
+
+where $f'(x)$ is the gaussian square waveform without lifting or amplitude scaling, and $\text{A} = \text{amp} \times \exp\left(i\times\text{angle}\right)$.
+
+Create new pulse instance.
+
+**Parameters**
+
+* **duration** – Pulse length in terms of the sampling period dt.
+* **amp** – The magnitude of the amplitude of the Gaussian and square pulse. Complex amp support is deprecated.
+* **sigma** – A measure of how wide or narrow the Gaussian risefall is; see the class docstring for more details.
+* **width** – The duration of the embedded square pulse.
+* **angle** – The angle of the complex amplitude of the pulse. Default value 0.
+* **risefall\_sigma\_ratio** – The ratio of each risefall duration to sigma.
+* **name** – Display name for this pulse envelope.
+* **limit\_amplitude** – If `True`, then limit the amplitude of the waveform to 1. The default is `True` and the amplitude is constrained to 1.
+
+**Returns**
+
+ScalableSymbolicPulse instance.
+
+**Raises**
+
+[**PulseError**](pulse#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – When width and risefall\_sigma\_ratio are both empty or both non-empty.
+
+## Attributes
+
+
+
+### alias
+
+`= 'GaussianSquare'`
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.library.GaussianSquareDrag.md b/docs/api/qiskit/0.46/qiskit.pulse.library.GaussianSquareDrag.md
new file mode 100644
index 00000000000..54c55a57c26
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.library.GaussianSquareDrag.md
@@ -0,0 +1,90 @@
+---
+title: GaussianSquareDrag
+description: API reference for qiskit.pulse.library.GaussianSquareDrag
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.pulse.library.GaussianSquareDrag
+---
+
+
+
+# qiskit.pulse.library.GaussianSquareDrag
+
+
+
+`qiskit.pulse.library.GaussianSquareDrag(duration, amp, sigma, beta, width=None, angle=0.0, risefall_sigma_ratio=None, name=None, limit_amplitude=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/symbolic_pulses.py "view source code")
+
+A square pulse with a Drag shaped rise and fall
+
+This pulse shape is similar to [`GaussianSquare`](qiskit.pulse.library.GaussianSquare "qiskit.pulse.library.GaussianSquare") but uses [`Drag`](qiskit.pulse.library.Drag_class.rst#qiskit.pulse.library.Drag "qiskit.pulse.library.Drag") for its rise and fall instead of [`Gaussian`](qiskit.pulse.library.Gaussian_class.rst#qiskit.pulse.library.Gaussian "qiskit.pulse.library.Gaussian"). The addition of the DRAG component of the rise and fall is sometimes helpful in suppressing the spectral content of the pulse at frequencies near to, but slightly offset from, the fundamental frequency of the drive. When there is a spectator qubit close in frequency to the fundamental frequency, suppressing the drive at the spectator’s frequency can help avoid unwanted excitation of the spectator.
+
+Exactly one of the `risefall_sigma_ratio` and `width` parameters has to be specified.
+
+If `risefall_sigma_ratio` is not `None` and `width` is `None`:
+
+$$
+\begin{aligned}
+\text{risefall} &= \text{risefall\_sigma\_ratio} \times \text{sigma}\\
+\text{width} &= \text{duration} - 2 \times \text{risefall}
+\end{aligned}
+$$
+
+If `width` is not None and `risefall_sigma_ratio` is None:
+
+$$
+\text{risefall} = \frac{\text{duration} - \text{width}}{2}
+
+
+$$
+
+Gaussian $g(x, c, σ)$ and lifted gaussian $g'(x, c, σ)$ curves can be written as:
+
+$$
+\begin{aligned}
+g(x, c, σ) &= \exp\Bigl(-\frac12 \frac{(x - c)^2}{σ^2}\Bigr)\\
+g'(x, c, σ) &= \frac{g(x, c, σ)-g(-1, c, σ)}{1-g(-1, c, σ)}
+\end{aligned}
+$$
+
+From these, the lifted DRAG curve $d'(x, c, σ, β)$ can be written as
+
+$$
+d'(x, c, σ, β) = g'(x, c, σ) \times \Bigl(1 + 1j \times β \times \Bigl(-\frac{x - c}{σ^2}\Bigr)\Bigr)
+$$
+
+The lifted gaussian square drag pulse $f'(x)$ is defined as:
+
+$$
+\begin{aligned}
+f'(x) &= \begin{cases} \text{A} \times d'(x, \text{risefall}, \text{sigma}, \text{beta}) & x < \text{risefall}\\
+ \text{A} & \text{risefall} \le x < \text{risefall} + \text{width}\\
+ \text{A} \times \times d'( x - (\text{risefall} + \text{width}), \text{risefall}, \text{sigma}, \text{beta} ) & \text{risefall} + \text{width} \le x \end{cases}\\
+\end{aligned}
+$$
+
+where $\text{A} = \text{amp} \times \exp\left(i\times\text{angle}\right)$.
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – Pulse length in terms of the sampling period dt.
+* **amp** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The amplitude of the DRAG rise and fall and of the square pulse.
+* **sigma** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – A measure of how wide or narrow the DRAG risefall is; see the class docstring for more details.
+* **beta** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The DRAG correction amplitude.
+* **width** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The duration of the embedded square pulse.
+* **angle** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The angle in radians of the complex phase factor uniformly scaling the pulse. Default value 0.
+* **risefall\_sigma\_ratio** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The ratio of each risefall duration to sigma.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Display name for this pulse envelope.
+* **limit\_amplitude** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – If `True`, then limit the amplitude of the waveform to 1. The default is `True` and the amplitude is constrained to 1.
+
+**Returns**
+
+ScalableSymbolicPulse instance.
+
+**Raises**
+
+[**PulseError**](pulse#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – When width and risefall\_sigma\_ratio are both empty or both non-empty.
+
+**Return type**
+
+*ScalableSymbolicPulse*
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.library.Gaussian_class.rst.md b/docs/api/qiskit/0.46/qiskit.pulse.library.Gaussian_class.rst.md
new file mode 100644
index 00000000000..1af4a6bbbec
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.library.Gaussian_class.rst.md
@@ -0,0 +1,50 @@
+---
+title: Gaussian
+description: API reference for qiskit.pulse.library.Gaussian
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.library.Gaussian
+---
+
+# Gaussian
+
+
+
+`qiskit.pulse.library.Gaussian(duration, amp, sigma, angle=None, name=None, limit_amplitude=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/symbolic_pulses.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+A lifted and truncated pulse envelope shaped according to the Gaussian function whose mean is centered at the center of the pulse (duration / 2):
+
+$$
+\begin{aligned}
+f'(x) &= \exp\Bigl( -\frac12 \frac{{(x - \text{duration}/2)}^2}{\text{sigma}^2} \Bigr)\\
+f(x) &= \text{A} \times \frac{f'(x) - f'(-1)}{1-f'(-1)}, \quad 0 \le x < \text{duration}
+\end{aligned}
+$$
+
+where $f'(x)$ is the gaussian waveform without lifting or amplitude scaling, and $\text{A} = \text{amp} \times \exp\left(i\times\text{angle}\right)$.
+
+Create new pulse instance.
+
+**Parameters**
+
+* **duration** – Pulse length in terms of the sampling period dt.
+* **amp** – The magnitude of the amplitude of the Gaussian envelope. Complex amp support is deprecated.
+* **sigma** – A measure of how wide or narrow the Gaussian peak is; described mathematically in the class docstring.
+* **angle** – The angle of the complex amplitude of the Gaussian envelope. Default value 0.
+* **name** – Display name for this pulse envelope.
+* **limit\_amplitude** – If `True`, then limit the amplitude of the waveform to 1. The default is `True` and the amplitude is constrained to 1.
+
+**Returns**
+
+ScalableSymbolicPulse instance.
+
+## Attributes
+
+
+
+### alias
+
+`= 'Gaussian'`
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.library.ParametricPulse.md b/docs/api/qiskit/0.46/qiskit.pulse.library.ParametricPulse.md
new file mode 100644
index 00000000000..37043893531
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.library.ParametricPulse.md
@@ -0,0 +1,138 @@
+---
+title: ParametricPulse
+description: API reference for qiskit.pulse.library.ParametricPulse
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.library.ParametricPulse
+---
+
+# ParametricPulse
+
+
+
+`qiskit.pulse.library.ParametricPulse(duration, name=None, limit_amplitude=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/parametric_pulses.py "view source code")
+
+Bases: `Pulse`
+
+The abstract superclass for parametric pulses.
+
+
+ This class was superseded by [`SymbolicPulse`](qiskit.pulse.library.SymbolicPulse "qiskit.pulse.library.SymbolicPulse") and is deprecated. It will be removed in Qiskit 1.0 because of the poor flexibility for defining a new waveform type and serializing it through the [`qiskit.qpy`](qpy#module-qiskit.qpy "qiskit.qpy") framework.
+
+
+Create a parametric pulse and validate the input parameters.
+
+
+ The class `qiskit.pulse.library.parametric_pulses.ParametricPulse` is deprecated as of qiskit-terra 0.46. It will be removed in Qiskit 1.0. Instead, use SymbolicPulse because of QPY serialization support. See qiskit.pulse.library.symbolic\_pulses for details.
+
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – Pulse length in terms of the sampling period dt.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Display name for this pulse envelope.
+* **limit\_amplitude** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – If `True`, then limit the amplitude of the waveform to 1. The default is `True` and the amplitude is constrained to 1.
+
+## Attributes
+
+
+
+### duration
+
+
+
+### name
+
+
+
+### id
+
+Unique identifier for this pulse.
+
+
+
+### limit\_amplitude
+
+`= True`
+
+
+
+### parameters
+
+Return a dictionary containing the pulse’s parameters.
+
+## Methods
+
+### draw
+
+
+
+`draw(style=None, backend=None, time_range=None, time_unit='dt', show_waveform_info=True, plotter='mpl2d', axis=None)`
+
+Plot the interpolated envelope of pulse.
+
+**Parameters**
+
+* **style** ([*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")*] | None*) – Stylesheet options. This can be dictionary or preset stylesheet classes. See `IQXStandard`, `IQXSimple`, and `IQXDebugging` for details of preset stylesheets.
+
+* **backend** (*Optional\[BaseBackend]*) – Backend object to play the input pulse program. If provided, the plotter may use to make the visualization hardware aware.
+
+* **time\_range** ([*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – Set horizontal axis limit. Tuple `(tmin, tmax)`.
+
+* **time\_unit** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The unit of specified time range either `dt` or `ns`. The unit of `ns` is available only when `backend` object is provided.
+
+* **show\_waveform\_info** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Show waveform annotations, i.e. name, of waveforms. Set `True` to show additional information about waveforms.
+
+* **plotter** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) –
+
+ Name of plotter API to generate an output image. One of following APIs should be specified:
+
+ ```python
+ mpl2d: Matplotlib API for 2D image generation.
+ Matplotlib API to generate 2D image. Charts are placed along y axis with
+ vertical offset. This API takes matplotlib.axes.Axes as `axis` input.
+ ```
+
+ axis and style kwargs may depend on the plotter.
+
+* **axis** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)") *| None*) – Arbitrary object passed to the plotter. If this object is provided, the plotters use a given `axis` instead of internally initializing a figure object. This object format depends on the plotter. See plotter argument for details.
+
+**Returns**
+
+Visualization output data. The returned data type depends on the `plotter`. If matplotlib family is specified, this will be a `matplotlib.pyplot.Figure` data.
+
+### get\_waveform
+
+
+
+`abstract get_waveform()`
+
+Return a Waveform with samples filled according to the formula that the pulse represents and the parameter values it contains.
+
+**Return type**
+
+[*Waveform*](qiskit.pulse.library.Waveform "qiskit.pulse.library.waveform.Waveform")
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True iff the instruction is parameterized.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### validate\_parameters
+
+
+
+`abstract validate_parameters()`
+
+Validate parameters.
+
+**Raises**
+
+[**PulseError**](pulse#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – If the parameters passed are not valid.
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.library.Sawtooth_class.rst.md b/docs/api/qiskit/0.46/qiskit.pulse.library.Sawtooth_class.rst.md
new file mode 100644
index 00000000000..f3c3f650ea7
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.library.Sawtooth_class.rst.md
@@ -0,0 +1,45 @@
+---
+title: Sawtooth
+description: API reference for qiskit.pulse.library.Sawtooth
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.pulse.library.Sawtooth
+---
+
+
+
+# qiskit.pulse.library.Sawtooth
+
+
+
+`qiskit.pulse.library.Sawtooth(duration, amp, phase, freq=None, angle=0.0, name=None, limit_amplitude=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/symbolic_pulses.py "view source code")
+
+A sawtooth pulse.
+
+The envelope of the pulse is given by:
+
+$$
+f(x) = 2\text{A}\left[g\left(x\right)-
+ \lfloor g\left(x\right)+\frac{1}{2}\rfloor\right]
+$$
+
+where $\text{A} = \text{amp} \times\exp\left(i\times\text{angle}\right)$, $g\left(x\right)=x\times\text{freq}+\frac{\text{phase}}{2\pi}$, and $\lfloor ...\rfloor$ is the floor operation.
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – Pulse length in terms of the sampling period dt.
+* **amp** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The magnitude of the amplitude of the sawtooth wave. Wave range is \[-amp,\`amp\`].
+* **phase** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The phase of the sawtooth wave (note that this is not equivalent to the angle of the complex amplitude)
+* **freq** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The frequency of the sawtooth wave, in terms of 1 over sampling period. If not provided defaults to a single cycle (i.e :math:’frac\{1}\{text\{duration}}’). The frequency is limited to the range $\left(0,0.5\right]$ (the Nyquist frequency).
+* **angle** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The angle in radians of the complex phase factor uniformly scaling the pulse. Default value 0.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Display name for this pulse envelope.
+* **limit\_amplitude** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – If `True`, then limit the amplitude of the waveform to 1. The default is `True` and the amplitude is constrained to 1.
+
+**Returns**
+
+ScalableSymbolicPulse instance.
+
+**Return type**
+
+*ScalableSymbolicPulse*
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.library.SechDeriv.md b/docs/api/qiskit/0.46/qiskit.pulse.library.SechDeriv.md
new file mode 100644
index 00000000000..7a8151f033f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.library.SechDeriv.md
@@ -0,0 +1,44 @@
+---
+title: SechDeriv
+description: API reference for qiskit.pulse.library.SechDeriv
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.pulse.library.SechDeriv
+---
+
+
+
+# qiskit.pulse.library.SechDeriv
+
+
+
+`qiskit.pulse.library.SechDeriv(duration, amp, sigma, angle=0.0, name=None, limit_amplitude=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/symbolic_pulses.py "view source code")
+
+An unnormalized sech derivative pulse.
+
+The sech function is centered around the halfway point of the pulse, and the envelope of the pulse is given by:
+
+$$
+f(x) = \text{A}\frac{d}{dx}\left[\text{sech}
+ \left(\frac{x-\mu}{\text{sigma}}\right)\right] , 0 <= x < duration
+$$
+
+where $\text{A} = \text{amp} \times\exp\left(i\times\text{angle}\right)$, $\mu=\text{duration}/2$, and $d/dx$ is a derivative with respect to x.
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – Pulse length in terms of the sampling period dt.
+* **amp** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The magnitude of the amplitude of the pulse (the value of the corresponding sech function at the midpoint duration/2).
+* **sigma** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – A measure of how wide or narrow the corresponding sech peak is, in terms of dt; described mathematically in the class docstring.
+* **angle** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The angle in radians of the complex phase factor uniformly scaling the pulse. Default value 0.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Display name for this pulse envelope.
+* **limit\_amplitude** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – If `True`, then limit the amplitude of the waveform to 1. The default is `True` and the amplitude is constrained to 1.
+
+**Returns**
+
+ScalableSymbolicPulse instance.
+
+**Return type**
+
+*ScalableSymbolicPulse*
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.library.Sech_fun.rst.md b/docs/api/qiskit/0.46/qiskit.pulse.library.Sech_fun.rst.md
new file mode 100644
index 00000000000..7ad40da19a5
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.library.Sech_fun.rst.md
@@ -0,0 +1,53 @@
+---
+title: Sech
+description: API reference for qiskit.pulse.library.Sech
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.pulse.library.Sech
+---
+
+
+
+# qiskit.pulse.library.Sech
+
+
+
+`qiskit.pulse.library.Sech(duration, amp, sigma, angle=0.0, name=None, zero_ends=True, limit_amplitude=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/symbolic_pulses.py "view source code")
+
+An unnormalized sech pulse.
+
+The sech function is centered around the halfway point of the pulse, and the envelope of the pulse is given by:
+
+$$
+f(x) = \text{A}\text{sech}\left(
+ \frac{x-\mu}{\text{sigma}}\right) , 0 <= x < duration
+$$
+
+where $\text{A} = \text{amp} \times\exp\left(i\times\text{angle}\right)$, and $\mu=\text{duration}/2$.
+
+If zero\_ends is set to True, the output y is modified: .. math:
+
+```python
+y\left(x\right) \mapsto \text{A}\frac{y-y^{*}}{\text{A}-y^{*}},
+```
+
+where $y^{*}$ is the value of $y$ at the endpoints (at $x=-1 and :math:`x=\text{duration}+1$). This shifts the endpoints value to zero, while also rescaling to preserve the amplitude at :math:text\{duration}/2\`\`.
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – Pulse length in terms of the sampling period dt.
+* **amp** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The magnitude of the amplitude of the pulse (the value at the midpoint duration/2).
+* **sigma** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – A measure of how wide or narrow the sech peak is in terms of dt; described mathematically in the class docstring.
+* **angle** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The angle in radians of the complex phase factor uniformly scaling the pulse. Default value 0.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Display name for this pulse envelope.
+* **zero\_ends** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – If True, zeros the ends at x = -1, x = duration + 1, but rescales to preserve amp. Default value True.
+* **limit\_amplitude** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – If `True`, then limit the amplitude of the waveform to 1. The default is `True` and the amplitude is constrained to 1.
+
+**Returns**
+
+ScalableSymbolicPulse instance.
+
+**Return type**
+
+*ScalableSymbolicPulse*
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.library.Sin_class.rst.md b/docs/api/qiskit/0.46/qiskit.pulse.library.Sin_class.rst.md
new file mode 100644
index 00000000000..770520300bf
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.library.Sin_class.rst.md
@@ -0,0 +1,44 @@
+---
+title: Sin
+description: API reference for qiskit.pulse.library.Sin
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.pulse.library.Sin
+---
+
+
+
+# qiskit.pulse.library.Sin
+
+
+
+`qiskit.pulse.library.Sin(duration, amp, phase, freq=None, angle=0.0, name=None, limit_amplitude=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/symbolic_pulses.py "view source code")
+
+A sinusoidal pulse.
+
+The envelope of the pulse is given by:
+
+$$
+f(x) = \text{A}\sin\left(2\pi\text{freq}x+\text{phase}\right) , 0 <= x < duration
+$$
+
+where $\text{A} = \text{amp} \times\exp\left(i\times\text{angle}\right)$.
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – Pulse length in terms of the sampling period dt.
+* **amp** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The magnitude of the amplitude of the sinusoidal wave. Wave range is \[-amp,\`amp\`].
+* **phase** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The phase of the sinusoidal wave (note that this is not equivalent to the angle of the complex amplitude)
+* **freq** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The frequency of the sinusoidal wave, in terms of 1 over sampling period. If not provided defaults to a single cycle (i.e :math:’frac\{1}\{text\{duration}}’). The frequency is limited to the range $\left(0,0.5\right]$ (the Nyquist frequency).
+* **angle** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The angle in radians of the complex phase factor uniformly scaling the pulse. Default value 0.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Display name for this pulse envelope.
+* **limit\_amplitude** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – If `True`, then limit the amplitude of the waveform to 1. The default is `True` and the amplitude is constrained to 1.
+
+**Returns**
+
+ScalableSymbolicPulse instance.
+
+**Return type**
+
+*ScalableSymbolicPulse*
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.library.Square_fun.rst.md b/docs/api/qiskit/0.46/qiskit.pulse.library.Square_fun.rst.md
new file mode 100644
index 00000000000..3910c9f65d4
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.library.Square_fun.rst.md
@@ -0,0 +1,45 @@
+---
+title: Square
+description: API reference for qiskit.pulse.library.Square
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.pulse.library.Square
+---
+
+
+
+# qiskit.pulse.library.Square
+
+
+
+`qiskit.pulse.library.Square(duration, amp, phase, freq=None, angle=0.0, name=None, limit_amplitude=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/symbolic_pulses.py "view source code")
+
+A square wave pulse.
+
+The envelope of the pulse is given by:
+
+$$
+f(x) = \text{A}\text{sign}\left[\sin
+ \left(2\pi x\times\text{freq}+\text{phase}\right)\right] , 0 <= x < duration
+$$
+
+where $\text{A} = \text{amp} \times\exp\left(i\times\text{angle}\right)$, and $\text{sign}$ is the sign function with the convention $\text{sign}\left(0\right)=1$.
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – Pulse length in terms of the sampling period dt.
+* **amp** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The magnitude of the amplitude of the square wave. Wave range is \[-amp,\`amp\`].
+* **phase** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The phase of the square wave (note that this is not equivalent to the angle of the complex amplitude).
+* **freq** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The frequency of the square wave, in terms of 1 over sampling period. If not provided defaults to a single cycle (i.e :math:’frac\{1}\{text\{duration}}’). The frequency is limited to the range $\left(0,0.5\right]$ (the Nyquist frequency).
+* **angle** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The angle in radians of the complex phase factor uniformly scaling the pulse. Default value 0.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Display name for this pulse envelope.
+* **limit\_amplitude** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – If `True`, then limit the amplitude of the waveform to 1. The default is `True` and the amplitude is constrained to 1.
+
+**Returns**
+
+ScalableSymbolicPulse instance.
+
+**Return type**
+
+*ScalableSymbolicPulse*
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.library.SymbolicPulse.md b/docs/api/qiskit/0.46/qiskit.pulse.library.SymbolicPulse.md
new file mode 100644
index 00000000000..14388e5870c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.library.SymbolicPulse.md
@@ -0,0 +1,258 @@
+---
+title: SymbolicPulse
+description: API reference for qiskit.pulse.library.SymbolicPulse
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.library.SymbolicPulse
+---
+
+# SymbolicPulse
+
+
+
+`qiskit.pulse.library.SymbolicPulse(pulse_type, duration, parameters=None, name=None, limit_amplitude=None, envelope=None, constraints=None, valid_amp_conditions=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/symbolic_pulses.py "view source code")
+
+Bases: `Pulse`
+
+The pulse representation model with parameters and symbolic expressions.
+
+A symbolic pulse instance can be defined with an envelope and parameter constraints. Envelope and parameter constraints should be provided as symbolic expressions. Rather than creating a subclass, different pulse shapes can be distinguished by the instance attributes [`SymbolicPulse.envelope`](#qiskit.pulse.library.SymbolicPulse.envelope "qiskit.pulse.library.SymbolicPulse.envelope") and [`SymbolicPulse.pulse_type`](#qiskit.pulse.library.SymbolicPulse.pulse_type "qiskit.pulse.library.SymbolicPulse.pulse_type").
+
+The symbolic expressions must be defined either with [SymPy](https://www.sympy.org/en/index.html) or [Symengine](https://symengine.org). Usually Symengine-based expression is much more performant for instantiation of the [`SymbolicPulse`](#qiskit.pulse.library.SymbolicPulse "qiskit.pulse.library.SymbolicPulse"), however, it doesn’t support every functions available in SymPy. You may need to choose proper library depending on how you define your pulses. Symengine works in the most envelopes and constraints, and thus it is recommended to use this library especially when your program contains a lot of pulses. Also note that Symengine has the limited platform support and may not be available for your local system. Symengine is a required dependency for Qiskit on platforms that support it will always be installed along with Qiskit on macOS `x86_64` and `arm64`, and Linux `x86_64`, `aarch64`, and `ppc64le`. For 64-bit Windows users they will need to manual install it. For 32-bit platforms such as `i686` and `armv7` Linux, and on Linux `s390x` there are no pre-compiled packages available and to use symengine you’ll need to compile it from source. If Symengine is not available in your environment SymPy will be used.
+
+**Envelope function**
+
+The waveform at time $t$ is generated by the [`get_waveform()`](#qiskit.pulse.library.SymbolicPulse.get_waveform "qiskit.pulse.library.SymbolicPulse.get_waveform") according to
+
+$$
+F(t, \Theta) = \times F(t, {\rm duration}, \overline{\rm params})
+$$
+
+where $\Theta$ is the set of full pulse parameters in the [`SymbolicPulse.parameters`](#qiskit.pulse.library.SymbolicPulse.parameters "qiskit.pulse.library.SymbolicPulse.parameters") dictionary which must include the $\rm duration$. Note that the $F$ is an envelope of the waveform, and a programmer must provide this as a symbolic expression. $\overline{\rm params}$ can be arbitrary complex values as long as they pass [`validate_parameters()`](#qiskit.pulse.library.SymbolicPulse.validate_parameters "qiskit.pulse.library.SymbolicPulse.validate_parameters") and your quantum backend can accept. The time $t$ and $\rm duration$ are in units of dt, i.e. sample time resolution, and this function is sampled with a discrete time vector in $[0, {\rm duration}]$ sampling the pulse envelope at every 0.5 dt (middle sampling strategy) when the [`SymbolicPulse.get_waveform()`](#qiskit.pulse.library.SymbolicPulse.get_waveform "qiskit.pulse.library.SymbolicPulse.get_waveform") method is called. The sample data is not generated until this method is called thus a symbolic pulse instance only stores parameter values and waveform shape, which greatly reduces memory footprint during the program generation.
+
+**Constraint functions**
+
+Constraints on the parameters are defined with an instance attribute [`SymbolicPulse.constraints`](#qiskit.pulse.library.SymbolicPulse.constraints "qiskit.pulse.library.SymbolicPulse.constraints") which can be provided through the constructor. The constraints value must be a symbolic expression, which is a function of parameters to be validated and must return a boolean value being `True` when parameters are valid. If there are multiple conditions to be evaluated, these conditions can be concatenated with logical expressions such as `And` and `Or` in SymPy or Symengine. The symbolic pulse instance can be played only when the constraint function returns `True`. The constraint is evaluated when [`validate_parameters()`](#qiskit.pulse.library.SymbolicPulse.validate_parameters "qiskit.pulse.library.SymbolicPulse.validate_parameters") is called.
+
+**Maximum amplitude validation**
+
+When you play a pulse in a quantum backend, you might face the restriction on the power that your waveform generator can handle. Usually, the pulse amplitude is normalized by this maximum power, namely $\max |F| \leq 1$. This condition is evaluated along with above constraints when you set `limit_amplitude = True` in the constructor. To evaluate maximum amplitude of the waveform, we need to call [`get_waveform()`](#qiskit.pulse.library.SymbolicPulse.get_waveform "qiskit.pulse.library.SymbolicPulse.get_waveform"). However, this introduces a significant overhead in the validation, and this cannot be ignored when you repeatedly instantiate symbolic pulse instances. [`SymbolicPulse.valid_amp_conditions`](#qiskit.pulse.library.SymbolicPulse.valid_amp_conditions "qiskit.pulse.library.SymbolicPulse.valid_amp_conditions") provides a condition to skip this waveform validation, and the waveform is not generated as long as this condition returns `True`, so that healthy symbolic pulses are created very quick. For example, for a simple pulse shape like `amp * cos(f * t)`, we know that pulse amplitude is valid as long as `amp` remains less than magnitude 1.0. So `abs(amp) <= 1` could be passed as [`SymbolicPulse.valid_amp_conditions`](#qiskit.pulse.library.SymbolicPulse.valid_amp_conditions "qiskit.pulse.library.SymbolicPulse.valid_amp_conditions") to skip doing a full waveform evaluation for amplitude validation. This expression is provided through the constructor. If this is not provided, the waveform is generated everytime when [`validate_parameters()`](#qiskit.pulse.library.SymbolicPulse.validate_parameters "qiskit.pulse.library.SymbolicPulse.validate_parameters") is called.
+
+**Examples**
+
+This is how a user can instantiate a symbolic pulse instance. In this example, we instantiate a custom Sawtooth envelope.
+
+```python
+from qiskit.pulse.library import SymbolicPulse
+
+my_pulse = SymbolicPulse(
+ pulse_type="Sawtooth",
+ duration=100,
+ parameters={"amp": 0.1, "freq": 0.05},
+ name="pulse1",
+)
+```
+
+Note that [`SymbolicPulse`](#qiskit.pulse.library.SymbolicPulse "qiskit.pulse.library.SymbolicPulse") can be instantiated without providing the envelope and constraints. However, this instance cannot generate waveforms without knowing the envelope definition. Now you need to provide the envelope.
+
+```python
+import sympy
+from qiskit.pulse.library import SymbolicPulse
+
+t, amp, freq = sympy.symbols("t, amp, freq")
+envelope = 2 * amp * (freq * t - sympy.floor(1 / 2 + freq * t))
+
+my_pulse = SymbolicPulse(
+ pulse_type="Sawtooth",
+ duration=100,
+ parameters={"amp": 0.1, "freq": 0.05},
+ envelope=envelope,
+ name="pulse1",
+)
+
+my_pulse.draw()
+```
+
+
+
+Likewise, you can define [`SymbolicPulse.constraints`](#qiskit.pulse.library.SymbolicPulse.constraints "qiskit.pulse.library.SymbolicPulse.constraints") for `my_pulse`. After providing the envelope definition, you can generate the waveform data. Note that it would be convenient to define a factory function that automatically accomplishes this procedure.
+
+```python
+def Sawtooth(duration, amp, freq, name):
+ t, amp, freq = sympy.symbols("t, amp, freq")
+
+ instance = SymbolicPulse(
+ pulse_type="Sawtooth",
+ duration=duration,
+ parameters={"amp": amp, "freq": freq},
+ envelope=2 * amp * (freq * t - sympy.floor(1 / 2 + freq * t)),
+ name=name,
+ )
+
+ return instance
+```
+
+You can also provide a `Parameter` object in the `parameters` dictionary, or define `duration` with a `Parameter` object when you instantiate the symbolic pulse instance. A waveform cannot be generated until you assign all unbounded parameters. Note that parameters will be assigned through the schedule playing the pulse.
+
+**Serialization**
+
+The [`SymbolicPulse`](#qiskit.pulse.library.SymbolicPulse "qiskit.pulse.library.SymbolicPulse") subclass can be serialized along with the symbolic expressions through [`qiskit.qpy`](qpy#module-qiskit.qpy "qiskit.qpy"). A user can therefore create a custom pulse subclass with a novel envelope and constraints, and then one can instantiate the class with certain parameters to run on a backend. This pulse instance can be saved in the QPY binary, which can be loaded afterwards even within the environment not having original class definition loaded. This mechanism also allows us to easily share a pulse program including custom pulse instructions with collaborators.
+
+Create a parametric pulse.
+
+**Parameters**
+
+* **pulse\_type** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Display name of this pulse shape.
+* **duration** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Duration of pulse.
+* **parameters** ([*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*] | None*) – Dictionary of pulse parameters that defines the pulse envelope.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Display name for this particular pulse envelope.
+* **limit\_amplitude** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – If `True`, then limit the absolute value of the amplitude of the waveform to 1. The default is `True` and the amplitude is constrained to 1.
+* **envelope** (*Expr | None*) – Pulse envelope expression.
+* **constraints** (*Expr | None*) – Pulse parameter constraint expression.
+* **valid\_amp\_conditions** (*Expr | None*) – Extra conditions to skip a full-waveform check for the amplitude limit. If this condition is not met, then the validation routine will investigate the full-waveform and raise an error when the amplitude norm of any data point exceeds 1.0. If not provided, the validation always creates a full-waveform.
+
+**Raises**
+
+[**PulseError**](pulse#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – When not all parameters are listed in the attribute `PARAM_DEF`.
+
+## Attributes
+
+
+
+### constraints
+
+Return symbolic expression for the pulse parameter constraints.
+
+
+
+### duration
+
+
+
+### envelope
+
+Return symbolic expression for the pulse envelope.
+
+
+
+### id
+
+Unique identifier for this pulse.
+
+
+
+### limit\_amplitude
+
+`= True`
+
+
+
+### name
+
+
+
+### parameters
+
+
+
+### pulse\_type
+
+Return display name of the pulse shape.
+
+
+
+### valid\_amp\_conditions
+
+Return symbolic expression for the pulse amplitude constraints.
+
+## Methods
+
+### draw
+
+
+
+`draw(style=None, backend=None, time_range=None, time_unit='dt', show_waveform_info=True, plotter='mpl2d', axis=None)`
+
+Plot the interpolated envelope of pulse.
+
+**Parameters**
+
+* **style** ([*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")*] | None*) – Stylesheet options. This can be dictionary or preset stylesheet classes. See `IQXStandard`, `IQXSimple`, and `IQXDebugging` for details of preset stylesheets.
+
+* **backend** (*Optional\[BaseBackend]*) – Backend object to play the input pulse program. If provided, the plotter may use to make the visualization hardware aware.
+
+* **time\_range** ([*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – Set horizontal axis limit. Tuple `(tmin, tmax)`.
+
+* **time\_unit** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The unit of specified time range either `dt` or `ns`. The unit of `ns` is available only when `backend` object is provided.
+
+* **show\_waveform\_info** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Show waveform annotations, i.e. name, of waveforms. Set `True` to show additional information about waveforms.
+
+* **plotter** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) –
+
+ Name of plotter API to generate an output image. One of following APIs should be specified:
+
+ ```python
+ mpl2d: Matplotlib API for 2D image generation.
+ Matplotlib API to generate 2D image. Charts are placed along y axis with
+ vertical offset. This API takes matplotlib.axes.Axes as `axis` input.
+ ```
+
+ axis and style kwargs may depend on the plotter.
+
+* **axis** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)") *| None*) – Arbitrary object passed to the plotter. If this object is provided, the plotters use a given `axis` instead of internally initializing a figure object. This object format depends on the plotter. See plotter argument for details.
+
+**Returns**
+
+Visualization output data. The returned data type depends on the `plotter`. If matplotlib family is specified, this will be a `matplotlib.pyplot.Figure` data.
+
+### get\_waveform
+
+
+
+`get_waveform()`
+
+Return a Waveform with samples filled according to the formula that the pulse represents and the parameter values it contains.
+
+Since the returned array is a discretized time series of the continuous function, this method uses a midpoint sampler. For `duration`, return:
+
+$$
+\{f(t+0.5) \in \mathbb{C} | t \in \mathbb{Z} \wedge 0<=t<\texttt{duration}\}
+$$
+
+**Returns**
+
+A waveform representation of this pulse.
+
+**Raises**
+
+* [**PulseError**](pulse#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – When parameters are not assigned.
+* [**PulseError**](pulse#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – When expression for pulse envelope is not assigned.
+
+**Return type**
+
+[*Waveform*](qiskit.pulse.library.Waveform "qiskit.pulse.library.waveform.Waveform")
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True iff the instruction is parameterized.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### validate\_parameters
+
+
+
+`validate_parameters()`
+
+Validate parameters.
+
+**Raises**
+
+[**PulseError**](pulse#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – If the parameters passed are not valid.
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.library.Triangle_class.rst.md b/docs/api/qiskit/0.46/qiskit.pulse.library.Triangle_class.rst.md
new file mode 100644
index 00000000000..e2ee9f33ae5
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.library.Triangle_class.rst.md
@@ -0,0 +1,44 @@
+---
+title: Triangle
+description: API reference for qiskit.pulse.library.Triangle
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.pulse.library.Triangle
+---
+
+
+
+# qiskit.pulse.library.Triangle
+
+
+
+`qiskit.pulse.library.Triangle(duration, amp, phase, freq=None, angle=0.0, name=None, limit_amplitude=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/symbolic_pulses.py "view source code")
+
+A triangle wave pulse.
+
+The envelope of the pulse is given by:
+
+$$
+f(x) = \text{A}\left[\text{sawtooth}\left(x\right)\right] , 0 <= x < duration
+$$
+
+where $\text{A} = \text{amp} \times\exp\left(i\times\text{angle}\right)$, and $\text{sawtooth}\left(x\right)$ is a sawtooth wave with the same frequency as the triangle wave, but a phase shifted by $\frac{\pi}{2}$.
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – Pulse length in terms of the sampling period dt.
+* **amp** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The magnitude of the amplitude of the triangle wave. Wave range is \[-amp,\`amp\`].
+* **phase** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The phase of the triangle wave (note that this is not equivalent to the angle of the complex amplitude)
+* **freq** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The frequency of the triangle wave, in terms of 1 over sampling period. If not provided defaults to a single cycle (i.e :math:’frac\{1}\{text\{duration}}’). The frequency is limited to the range $\left(0,0.5\right]$ (the Nyquist frequency).
+* **angle** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The angle in radians of the complex phase factor uniformly scaling the pulse. Default value 0.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Display name for this pulse envelope.
+* **limit\_amplitude** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – If `True`, then limit the amplitude of the waveform to 1. The default is `True` and the amplitude is constrained to 1.
+
+**Returns**
+
+ScalableSymbolicPulse instance.
+
+**Return type**
+
+*ScalableSymbolicPulse*
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.library.Waveform.md b/docs/api/qiskit/0.46/qiskit.pulse.library.Waveform.md
new file mode 100644
index 00000000000..f2b8f6b35f2
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.library.Waveform.md
@@ -0,0 +1,113 @@
+---
+title: Waveform
+description: API reference for qiskit.pulse.library.Waveform
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.library.Waveform
+---
+
+# Waveform
+
+
+
+`qiskit.pulse.library.Waveform(samples, name=None, epsilon=1e-07, limit_amplitude=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/waveform.py "view source code")
+
+Bases: `Pulse`
+
+A pulse specified completely by complex-valued samples; each sample is played for the duration of the backend cycle-time, dt.
+
+Create new sample pulse command.
+
+**Parameters**
+
+* **samples** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*]*) – Complex array of the samples in the pulse envelope.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Unique name to identify the pulse.
+* **epsilon** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Pulse sample norm tolerance for clipping. If any sample’s norm exceeds unity by less than or equal to epsilon it will be clipped to unit norm. If the sample norm is greater than 1+epsilon an error will be raised.
+* **limit\_amplitude** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – Passed to parent Pulse
+
+## Attributes
+
+
+
+### duration
+
+
+
+### name
+
+
+
+### id
+
+Unique identifier for this pulse.
+
+
+
+### limit\_amplitude
+
+`= True`
+
+
+
+### parameters
+
+Return a dictionary containing the pulse’s parameters.
+
+
+
+### samples
+
+Return sample values.
+
+## Methods
+
+### draw
+
+
+
+`draw(style=None, backend=None, time_range=None, time_unit='dt', show_waveform_info=True, plotter='mpl2d', axis=None)`
+
+Plot the interpolated envelope of pulse.
+
+**Parameters**
+
+* **style** ([*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")*] | None*) – Stylesheet options. This can be dictionary or preset stylesheet classes. See `IQXStandard`, `IQXSimple`, and `IQXDebugging` for details of preset stylesheets.
+
+* **backend** (*Optional\[BaseBackend]*) – Backend object to play the input pulse program. If provided, the plotter may use to make the visualization hardware aware.
+
+* **time\_range** ([*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – Set horizontal axis limit. Tuple `(tmin, tmax)`.
+
+* **time\_unit** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The unit of specified time range either `dt` or `ns`. The unit of `ns` is available only when `backend` object is provided.
+
+* **show\_waveform\_info** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Show waveform annotations, i.e. name, of waveforms. Set `True` to show additional information about waveforms.
+
+* **plotter** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) –
+
+ Name of plotter API to generate an output image. One of following APIs should be specified:
+
+ ```python
+ mpl2d: Matplotlib API for 2D image generation.
+ Matplotlib API to generate 2D image. Charts are placed along y axis with
+ vertical offset. This API takes matplotlib.axes.Axes as `axis` input.
+ ```
+
+ axis and style kwargs may depend on the plotter.
+
+* **axis** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)") *| None*) – Arbitrary object passed to the plotter. If this object is provided, the plotters use a given `axis` instead of internally initializing a figure object. This object format depends on the plotter. See plotter argument for details.
+
+**Returns**
+
+Visualization output data. The returned data type depends on the `plotter`. If matplotlib family is specified, this will be a `matplotlib.pyplot.Figure` data.
+
+### is\_parameterized
+
+
+
+`is_parameterized()`
+
+Return True iff the instruction is parameterized.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.library.gaussian_square_echo.md b/docs/api/qiskit/0.46/qiskit.pulse.library.gaussian_square_echo.md
new file mode 100644
index 00000000000..80c17b389ff
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.library.gaussian_square_echo.md
@@ -0,0 +1,77 @@
+---
+title: gaussian_square_echo
+description: API reference for qiskit.pulse.library.gaussian_square_echo
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.pulse.library.gaussian_square_echo
+---
+
+
+
+# qiskit.pulse.library.gaussian\_square\_echo
+
+
+
+`qiskit.pulse.library.gaussian_square_echo(duration, amp, sigma, width=None, angle=0.0, active_amp=0.0, active_angle=0.0, risefall_sigma_ratio=None, name=None, limit_amplitude=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/library/symbolic_pulses.py "view source code")
+
+An echoed Gaussian square pulse with an active tone overlaid on it.
+
+The Gaussian Square Echo pulse is composed of three pulses. First, a Gaussian Square pulse $f_{echo}(x)$ with amplitude `amp` and phase `angle` playing for half duration, followed by a second Gaussian Square pulse $-f_{echo}(x)$ with opposite amplitude and same phase playing for the rest of the duration. Third a Gaussian Square pulse $f_{active}(x)$ with amplitude `active_amp` and phase `active_angle` playing for the entire duration. The Gaussian Square Echo pulse $g_e()$ can be written as:
+
+$$
+\begin{aligned}
+g_e(x) &= \begin{cases} f_{\text{active}} + f_{\text{echo}}(x) & x < \frac{\text{duration}}{2}\\
+ f_{\text{active}} - f_{\text{echo}}(x) & \frac{\text{duration}}{2} < x \end{cases}\\
+\end{aligned}
+$$
+
+One case where this pulse can be used is when implementing a direct CNOT gate with a cross-resonance superconducting qubit architecture. When applying this pulse to the target qubit, the active portion can be used to cancel IX terms from the cross-resonance drive while the echo portion can reduce the impact of a static ZZ coupling.
+
+Exactly one of the `risefall_sigma_ratio` and `width` parameters has to be specified.
+
+If `risefall_sigma_ratio` is not `None` and `width` is `None`:
+
+$$
+\begin{aligned}
+\text{risefall} &= \text{risefall\_sigma\_ratio} \times \text{sigma}\\
+\text{width} &= \text{duration} - 2 \times \text{risefall}
+\end{aligned}
+$$
+
+If `width` is not None and `risefall_sigma_ratio` is None:
+
+$$
+\text{risefall} = \frac{\text{duration} - \text{width}}{2}
+
+
+$$
+
+**References**
+
+1. [*Jurcevic, P., Javadi-Abhari, A., Bishop, L. S., Lauer, I., Bogorin, D. F., Brink, M., Capelluto, L., G\{“u}nl\{“u}k, O., Itoko, T., Kanazawa, N. & others Demonstration of quantum volume 64 on a superconducting quantum computing system. (Section V)*](https://iopscience.iop.org/article/10.1088/2058-9565/abe519)
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – Pulse length in terms of the sampling period dt.
+* **amp** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The amplitude of the rise and fall and of the echoed pulse.
+* **sigma** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – A measure of how wide or narrow the risefall is; see the class docstring for more details.
+* **width** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The duration of the embedded square pulse.
+* **angle** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The angle in radians of the complex phase factor uniformly scaling the echoed pulse. Default value 0.
+* **active\_amp** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The amplitude of the active pulse.
+* **active\_angle** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The angle in radian of the complex phase factor uniformly scaling the active pulse. Default value 0.
+* **risefall\_sigma\_ratio** ([*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The ratio of each risefall duration to sigma.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Display name for this pulse envelope.
+* **limit\_amplitude** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – If `True`, then limit the amplitude of the waveform to 1. The default is `True` and the amplitude is constrained to 1.
+
+**Returns**
+
+ScalableSymbolicPulse instance.
+
+**Raises**
+
+[**PulseError**](pulse#qiskit.pulse.PulseError "qiskit.pulse.PulseError") – When width and risefall\_sigma\_ratio are both empty or both non-empty.
+
+**Return type**
+
+[*SymbolicPulse*](qiskit.pulse.library.SymbolicPulse "qiskit.pulse.library.symbolic_pulses.SymbolicPulse")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.transforms.AlignEquispaced.md b/docs/api/qiskit/0.46/qiskit.pulse.transforms.AlignEquispaced.md
new file mode 100644
index 00000000000..5c220683540
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.transforms.AlignEquispaced.md
@@ -0,0 +1,62 @@
+---
+title: AlignEquispaced
+description: API reference for qiskit.pulse.transforms.AlignEquispaced
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.transforms.AlignEquispaced
+---
+
+# AlignEquispaced
+
+
+
+`qiskit.pulse.transforms.AlignEquispaced(duration)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/transforms/alignments.py "view source code")
+
+Bases: [`AlignmentKind`](pulse#qiskit.pulse.transforms.AlignmentKind "qiskit.pulse.transforms.alignments.AlignmentKind")
+
+Align instructions with equispaced interval within a specified duration.
+
+Instructions played on different channels are also arranged in a sequence. This alignment is convenient to create dynamical decoupling sequences such as PDD.
+
+Create new equispaced context.
+
+**Parameters**
+
+**duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – Duration of this context. This should be larger than the schedule duration. If the specified duration is shorter than the schedule duration, no alignment is performed and the input schedule is just returned. This duration can be parametrized.
+
+## Attributes
+
+
+
+### duration
+
+Return context duration.
+
+
+
+### is\_sequential
+
+## Methods
+
+### align
+
+
+
+`align(schedule)`
+
+Reallocate instructions according to the policy.
+
+Only top-level sub-schedules are aligned. If sub-schedules are nested, nested schedules are not recursively aligned.
+
+**Parameters**
+
+**schedule** ([*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")) – Schedule to align.
+
+**Returns**
+
+Schedule with reallocated instructions.
+
+**Return type**
+
+[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.transforms.AlignFunc.md b/docs/api/qiskit/0.46/qiskit.pulse.transforms.AlignFunc.md
new file mode 100644
index 00000000000..9f1a159ff4b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.transforms.AlignFunc.md
@@ -0,0 +1,82 @@
+---
+title: AlignFunc
+description: API reference for qiskit.pulse.transforms.AlignFunc
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.transforms.AlignFunc
+---
+
+# AlignFunc
+
+
+
+`qiskit.pulse.transforms.AlignFunc(duration, func)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/transforms/alignments.py "view source code")
+
+Bases: [`AlignmentKind`](pulse#qiskit.pulse.transforms.AlignmentKind "qiskit.pulse.transforms.alignments.AlignmentKind")
+
+Allocate instructions at position specified by callback function.
+
+The position is specified for each instruction of index `j` as a fractional coordinate in \[0, 1] within the specified duration.
+
+Instructions played on different channels are also arranged in a sequence. This alignment is convenient to create dynamical decoupling sequences such as UDD.
+
+For example, UDD sequence with 10 pulses can be specified with following function.
+
+```python
+def udd10_pos(j):
+return np.sin(np.pi*j/(2*10 + 2))**2
+```
+
+
+ This context cannot be QPY serialized because of the callable. If you use this context, your program cannot be saved in QPY format.
+
+
+Create new equispaced context.
+
+**Parameters**
+
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – Duration of this context. This should be larger than the schedule duration. If the specified duration is shorter than the schedule duration, no alignment is performed and the input schedule is just returned. This duration can be parametrized.
+* **func** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")) – A function that takes an index of sub-schedule and returns the fractional coordinate of of that sub-schedule. The returned value should be defined within \[0, 1]. The pulse index starts from 1.
+
+## Attributes
+
+
+
+### duration
+
+Return context duration.
+
+
+
+### func
+
+Return context alignment function.
+
+
+
+### is\_sequential
+
+## Methods
+
+### align
+
+
+
+`align(schedule)`
+
+Reallocate instructions according to the policy.
+
+Only top-level sub-schedules are aligned. If sub-schedules are nested, nested schedules are not recursively aligned.
+
+**Parameters**
+
+**schedule** ([*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")) – Schedule to align.
+
+**Returns**
+
+Schedule with reallocated instructions.
+
+**Return type**
+
+[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.transforms.AlignLeft.md b/docs/api/qiskit/0.46/qiskit.pulse.transforms.AlignLeft.md
new file mode 100644
index 00000000000..913fff433db
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.transforms.AlignLeft.md
@@ -0,0 +1,52 @@
+---
+title: AlignLeft
+description: API reference for qiskit.pulse.transforms.AlignLeft
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.transforms.AlignLeft
+---
+
+# AlignLeft
+
+
+
+`qiskit.pulse.transforms.AlignLeft`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/transforms/alignments.py "view source code")
+
+Bases: [`AlignmentKind`](pulse#qiskit.pulse.transforms.AlignmentKind "qiskit.pulse.transforms.alignments.AlignmentKind")
+
+Align instructions in as-soon-as-possible manner.
+
+Instructions are placed at earliest available timeslots.
+
+Create new left-justified context.
+
+## Attributes
+
+
+
+### is\_sequential
+
+## Methods
+
+### align
+
+
+
+`align(schedule)`
+
+Reallocate instructions according to the policy.
+
+Only top-level sub-schedules are aligned. If sub-schedules are nested, nested schedules are not recursively aligned.
+
+**Parameters**
+
+**schedule** ([*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")) – Schedule to align.
+
+**Returns**
+
+Schedule with reallocated instructions.
+
+**Return type**
+
+[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.transforms.AlignRight.md b/docs/api/qiskit/0.46/qiskit.pulse.transforms.AlignRight.md
new file mode 100644
index 00000000000..63beef9db7b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.transforms.AlignRight.md
@@ -0,0 +1,52 @@
+---
+title: AlignRight
+description: API reference for qiskit.pulse.transforms.AlignRight
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.transforms.AlignRight
+---
+
+# AlignRight
+
+
+
+`qiskit.pulse.transforms.AlignRight`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/transforms/alignments.py "view source code")
+
+Bases: [`AlignmentKind`](pulse#qiskit.pulse.transforms.AlignmentKind "qiskit.pulse.transforms.alignments.AlignmentKind")
+
+Align instructions in as-late-as-possible manner.
+
+Instructions are placed at latest available timeslots.
+
+Create new right-justified context.
+
+## Attributes
+
+
+
+### is\_sequential
+
+## Methods
+
+### align
+
+
+
+`align(schedule)`
+
+Reallocate instructions according to the policy.
+
+Only top-level sub-schedules are aligned. If sub-schedules are nested, nested schedules are not recursively aligned.
+
+**Parameters**
+
+**schedule** ([*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")) – Schedule to align.
+
+**Returns**
+
+Schedule with reallocated instructions.
+
+**Return type**
+
+[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")
+
diff --git a/docs/api/qiskit/0.46/qiskit.pulse.transforms.AlignSequential.md b/docs/api/qiskit/0.46/qiskit.pulse.transforms.AlignSequential.md
new file mode 100644
index 00000000000..30e2864a2d6
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.pulse.transforms.AlignSequential.md
@@ -0,0 +1,52 @@
+---
+title: AlignSequential
+description: API reference for qiskit.pulse.transforms.AlignSequential
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.pulse.transforms.AlignSequential
+---
+
+# AlignSequential
+
+
+
+`qiskit.pulse.transforms.AlignSequential`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/pulse/transforms/alignments.py "view source code")
+
+Bases: [`AlignmentKind`](pulse#qiskit.pulse.transforms.AlignmentKind "qiskit.pulse.transforms.alignments.AlignmentKind")
+
+Align instructions sequentially.
+
+Instructions played on different channels are also arranged in a sequence. No buffer time is inserted in between instructions.
+
+Create new sequential context.
+
+## Attributes
+
+
+
+### is\_sequential
+
+## Methods
+
+### align
+
+
+
+`align(schedule)`
+
+Reallocate instructions according to the policy.
+
+Only top-level sub-schedules are aligned. If sub-schedules are nested, nested schedules are not recursively aligned.
+
+**Parameters**
+
+**schedule** ([*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")) – Schedule to align.
+
+**Returns**
+
+Schedule with reallocated instructions.
+
+**Return type**
+
+[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")
+
diff --git a/docs/api/qiskit/0.46/qiskit.qobj.GateCalibration.md b/docs/api/qiskit/0.46/qiskit.qobj.GateCalibration.md
new file mode 100644
index 00000000000..7d83034a566
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.qobj.GateCalibration.md
@@ -0,0 +1,65 @@
+---
+title: GateCalibration
+description: API reference for qiskit.qobj.GateCalibration
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.qobj.GateCalibration
+---
+
+# GateCalibration
+
+
+
+`qiskit.qobj.GateCalibration(name, qubits, params, instructions)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qobj/qasm_qobj.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Each calibration specifies a unique gate by name, qubits and params, and contains the Pulse instructions to implement it.
+
+Initialize a single gate calibration. Instructions may reference waveforms which should be made available in the pulse\_library.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Gate name.
+* **qubits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*(*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*)*) – Qubits the gate applies to.
+* **params** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*(*[*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*)*) – Gate parameter values, if any.
+* **instructions** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*(*[*PulseQobjInstruction*](qiskit.qobj.PulseQobjInstruction "qiskit.qobj.PulseQobjInstruction")*)*) – The gate implementation.
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new GateCalibration object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary representing the GateCalibration to create. It will be in the same format as output by [`to_dict()`](#qiskit.qobj.GateCalibration.to_dict "qiskit.qobj.GateCalibration.to_dict").
+
+**Returns**
+
+The GateCalibration from the input dictionary.
+
+**Return type**
+
+[GateCalibration](#qiskit.qobj.GateCalibration "qiskit.qobj.GateCalibration")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the Gate Calibration.
+
+**Returns**
+
+The dictionary form of the GateCalibration.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.qobj.PulseLibraryItem.md b/docs/api/qiskit/0.46/qiskit.qobj.PulseLibraryItem.md
new file mode 100644
index 00000000000..3d607960751
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.qobj.PulseLibraryItem.md
@@ -0,0 +1,63 @@
+---
+title: PulseLibraryItem
+description: API reference for qiskit.qobj.PulseLibraryItem
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.qobj.PulseLibraryItem
+---
+
+# PulseLibraryItem
+
+
+
+`qiskit.qobj.PulseLibraryItem(name, samples)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qobj/pulse_qobj.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+An item in a pulse library.
+
+Instantiate a pulse library item.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – A name for the pulse.
+* **samples** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*]*) – A list of complex values defining pulse shape.
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new PulseLibraryItem object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary for the experiment config
+
+**Returns**
+
+The object from the input dictionary.
+
+**Return type**
+
+[PulseLibraryItem](#qiskit.qobj.PulseLibraryItem "qiskit.qobj.PulseLibraryItem")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the pulse library item.
+
+**Returns**
+
+The dictionary form of the PulseLibraryItem.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.qobj.PulseQobj.md b/docs/api/qiskit/0.46/qiskit.qobj.PulseQobj.md
new file mode 100644
index 00000000000..decbaddfd3a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.qobj.PulseQobj.md
@@ -0,0 +1,84 @@
+---
+title: PulseQobj
+description: API reference for qiskit.qobj.PulseQobj
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.qobj.PulseQobj
+---
+
+# PulseQobj
+
+
+
+`qiskit.qobj.PulseQobj(qobj_id, config, experiments, header=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qobj/pulse_qobj.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+A Pulse Qobj.
+
+Instantiate a new Pulse Qobj Object.
+
+Each Pulse Qobj object is used to represent a single payload that will be passed to a Qiskit provider. It mirrors the Qobj the published [Qobj specification](https://arxiv.org/abs/1809.03452) for Pulse experiments.
+
+**Parameters**
+
+* **qobj\_id** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – An identifier for the qobj
+* **config** ([*PulseQobjConfig*](qiskit.qobj.PulseQobjConfig "qiskit.qobj.PulseQobjConfig")) – A config for the entire run
+* **header** ([*QobjHeader*](qiskit.qobj.QobjHeader "qiskit.qobj.QobjHeader")) – A header for the entire run
+* **experiments** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of lists of [`PulseQobjExperiment`](qiskit.qobj.PulseQobjExperiment "qiskit.qobj.PulseQobjExperiment") objects representing an experiment
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new PulseQobj object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary representing the PulseQobj to create. It will be in the same format as output by [`to_dict()`](#qiskit.qobj.PulseQobj.to_dict "qiskit.qobj.PulseQobj.to_dict").
+
+**Returns**
+
+The PulseQobj from the input dictionary.
+
+**Return type**
+
+[PulseQobj](#qiskit.qobj.PulseQobj "qiskit.qobj.PulseQobj")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the Pulse Qobj.
+
+Note this dict is not in the json wire format expected by IBMQ and qobj specification because complex numbers are still of type complex. Also this may contain native numpy arrays. When serializing this output for use with IBMQ you can leverage a json encoder that converts these as expected. For example:
+
+```python
+import json
+import numpy
+
+class QobjEncoder(json.JSONEncoder):
+ def default(self, obj):
+ if isinstance(obj, numpy.ndarray):
+ return obj.tolist()
+ if isinstance(obj, complex):
+ return (obj.real, obj.imag)
+ return json.JSONEncoder.default(self, obj)
+
+json.dumps(qobj.to_dict(), cls=QobjEncoder)
+```
+
+**Returns**
+
+A dictionary representation of the PulseQobj object
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.qobj.PulseQobjConfig.md b/docs/api/qiskit/0.46/qiskit.qobj.PulseQobjConfig.md
new file mode 100644
index 00000000000..f0d15776ff7
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.qobj.PulseQobjConfig.md
@@ -0,0 +1,73 @@
+---
+title: PulseQobjConfig
+description: API reference for qiskit.qobj.PulseQobjConfig
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.qobj.PulseQobjConfig
+---
+
+# PulseQobjConfig
+
+
+
+`qiskit.qobj.PulseQobjConfig(meas_level, meas_return, pulse_library, qubit_lo_freq, meas_lo_freq, memory_slot_size=None, rep_time=None, rep_delay=None, shots=None, seed_simulator=None, memory_slots=None, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qobj/pulse_qobj.py "view source code")
+
+Bases: `QobjDictField`
+
+A configuration for a Pulse Qobj.
+
+Instantiate a PulseQobjConfig object.
+
+**Parameters**
+
+* **meas\_level** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The measurement level to use.
+* **meas\_return** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The level of measurement information to return.
+* **pulse\_library** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of [`PulseLibraryItem`](qiskit.qobj.PulseLibraryItem "qiskit.qobj.PulseLibraryItem") objects which define the set of primitive pulses
+* **qubit\_lo\_freq** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – List of frequencies (as floats) for the qubit driver LO’s in GHz.
+* **meas\_lo\_freq** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – List of frequencies (as floats) for the’ measurement driver LO’s in GHz.
+* **memory\_slot\_size** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Size of each memory slot if the output is Level 0.
+* **rep\_time** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time per program execution in sec. Must be from the list provided by the backend (`backend.configuration().rep_times`). Defaults to the first entry in `backend.configuration().rep_times`.
+* **rep\_delay** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Delay between programs in sec. Only supported on certain backends (`backend.configuration().dynamic_reprate_enabled` ). If supported, `rep_delay` will be used instead of `rep_time` and must be from the range supplied by the backend (`backend.configuration().rep_delay_range`). Default is `backend.configuration().default_rep_delay`.
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of shots
+* **seed\_simulator** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the seed to use in the simulator
+* **memory\_slots** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – The number of memory slots on the device
+* **kwargs** – Additional free form key value fields to add to the configuration
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new PulseQobjConfig object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary for the config
+
+**Returns**
+
+The object from the input dictionary.
+
+**Return type**
+
+[PulseQobjConfig](#qiskit.qobj.PulseQobjConfig "qiskit.qobj.PulseQobjConfig")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the Pulse Qobj config.
+
+**Returns**
+
+The dictionary form of the PulseQobjConfig.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.qobj.PulseQobjExperiment.md b/docs/api/qiskit/0.46/qiskit.qobj.PulseQobjExperiment.md
new file mode 100644
index 00000000000..bf4b7534b2a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.qobj.PulseQobjExperiment.md
@@ -0,0 +1,66 @@
+---
+title: PulseQobjExperiment
+description: API reference for qiskit.qobj.PulseQobjExperiment
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.qobj.PulseQobjExperiment
+---
+
+# PulseQobjExperiment
+
+
+
+`qiskit.qobj.PulseQobjExperiment(instructions, config=None, header=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qobj/pulse_qobj.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+A Pulse Qobj Experiment.
+
+Each instance of this class is used to represent an individual Pulse experiment as part of a larger Pulse Qobj.
+
+Instantiate a PulseQobjExperiment.
+
+**Parameters**
+
+* **config** ([*PulseQobjExperimentConfig*](qiskit.qobj.PulseQobjExperimentConfig "qiskit.qobj.PulseQobjExperimentConfig")) – A config object for the experiment
+* **header** (*PulseQobjExperimentHeader*) – A header object for the experiment
+* **instructions** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of [`PulseQobjInstruction`](qiskit.qobj.PulseQobjInstruction "qiskit.qobj.PulseQobjInstruction") objects
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new PulseQobjExperiment object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary for the experiment config
+
+**Returns**
+
+The object from the input dictionary.
+
+**Return type**
+
+[PulseQobjExperiment](#qiskit.qobj.PulseQobjExperiment "qiskit.qobj.PulseQobjExperiment")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the Experiment.
+
+**Returns**
+
+The dictionary form of the PulseQobjExperiment.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.qobj.PulseQobjExperimentConfig.md b/docs/api/qiskit/0.46/qiskit.qobj.PulseQobjExperimentConfig.md
new file mode 100644
index 00000000000..6233282afa2
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.qobj.PulseQobjExperimentConfig.md
@@ -0,0 +1,64 @@
+---
+title: PulseQobjExperimentConfig
+description: API reference for qiskit.qobj.PulseQobjExperimentConfig
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.qobj.PulseQobjExperimentConfig
+---
+
+# PulseQobjExperimentConfig
+
+
+
+`qiskit.qobj.PulseQobjExperimentConfig(qubit_lo_freq=None, meas_lo_freq=None, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qobj/pulse_qobj.py "view source code")
+
+Bases: `QobjDictField`
+
+A config for a single Pulse experiment in the qobj.
+
+Instantiate a PulseQobjExperimentConfig object.
+
+**Parameters**
+
+* **qubit\_lo\_freq** (*List\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – List of qubit LO frequencies in GHz.
+* **meas\_lo\_freq** (*List\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – List of meas readout LO frequencies in GHz.
+* **kwargs** – Additional free form key value fields to add to the configuration
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new QobjHeader object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary representing the QobjHeader to create. It will be in the same format as output by [`to_dict()`](#qiskit.qobj.PulseQobjExperimentConfig.to_dict "qiskit.qobj.PulseQobjExperimentConfig.to_dict").
+
+**Returns**
+
+The QobjDictField from the input dictionary.
+
+**Return type**
+
+QobjDictFieldr
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the OpenQASM 2 Qobj.
+
+**Returns**
+
+The dictionary form of the QobjHeader.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.qobj.PulseQobjInstruction.md b/docs/api/qiskit/0.46/qiskit.qobj.PulseQobjInstruction.md
new file mode 100644
index 00000000000..a10e26aa2e6
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.qobj.PulseQobjInstruction.md
@@ -0,0 +1,78 @@
+---
+title: PulseQobjInstruction
+description: API reference for qiskit.qobj.PulseQobjInstruction
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.qobj.PulseQobjInstruction
+---
+
+# PulseQobjInstruction
+
+
+
+`qiskit.qobj.PulseQobjInstruction(name, t0, ch=None, conditional=None, val=None, phase=None, duration=None, qubits=None, memory_slot=None, register_slot=None, kernels=None, discriminators=None, label=None, type=None, pulse_shape=None, parameters=None, frequency=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qobj/pulse_qobj.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+A class representing a single instruction in an PulseQobj Experiment.
+
+Instantiate a new PulseQobjInstruction object.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the instruction
+* **t0** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Pulse start time in integer **dt** units.
+* **ch** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The channel to apply the pulse instruction.
+* **conditional** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The register to use for a conditional for this instruction
+* **val** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")) – Complex value to apply, bounded by an absolute value of 1.
+* **phase** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – if a `fc` instruction, the frame change phase in radians.
+* **frequency** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – if a `sf` instruction, the frequency in Hz.
+* **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The duration of the pulse in **dt** units.
+* **qubits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of `int` representing the qubits the instruction operates on
+* **memory\_slot** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – If a `measure` instruction this is a list of `int` containing the list of memory slots to store the measurement results in (must be the same length as qubits). If a `bfunc` instruction this is a single `int` of the memory slot to store the boolean function result in.
+* **register\_slot** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – If a `measure` instruction this is a list of `int` containing the list of register slots in which to store the measurement results (must be the same length as qubits). If a `bfunc` instruction this is a single `int` of the register slot in which to store the result.
+* **kernels** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – List of [`QobjMeasurementOption`](qiskit.qobj.QobjMeasurementOption "qiskit.qobj.QobjMeasurementOption") objects defining the measurement kernels and set of parameters if the measurement level is 1 or 2. Only used for `acquire` instructions.
+* **discriminators** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of [`QobjMeasurementOption`](qiskit.qobj.QobjMeasurementOption "qiskit.qobj.QobjMeasurementOption") used to set the discriminators to be used if the measurement level is 2. Only used for `acquire` instructions.
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Label of instruction
+* **type** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Type of instruction
+* **pulse\_shape** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The shape of the parametric pulse
+* **parameters** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – The parameters for a parametric pulse
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new PulseQobjExperimentConfig object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary for the experiment config
+
+**Returns**
+
+The object from the input dictionary.
+
+**Return type**
+
+[PulseQobjInstruction](#qiskit.qobj.PulseQobjInstruction "qiskit.qobj.PulseQobjInstruction")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the Instruction.
+
+**Returns**
+
+The dictionary form of the PulseQobjInstruction.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.qobj.QasmExperimentCalibrations.md b/docs/api/qiskit/0.46/qiskit.qobj.QasmExperimentCalibrations.md
new file mode 100644
index 00000000000..a1bfe465e57
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.qobj.QasmExperimentCalibrations.md
@@ -0,0 +1,62 @@
+---
+title: QasmExperimentCalibrations
+description: API reference for qiskit.qobj.QasmExperimentCalibrations
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.qobj.QasmExperimentCalibrations
+---
+
+# QasmExperimentCalibrations
+
+
+
+`qiskit.qobj.QasmExperimentCalibrations(gates)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qobj/qasm_qobj.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+A container for any calibrations data. The gates attribute contains a list of GateCalibrations.
+
+Initialize a container for calibrations.
+
+**Parameters**
+
+**gates** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*(*[*GateCalibration*](qiskit.qobj.GateCalibration "qiskit.qobj.GateCalibration")*)*) –
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new GateCalibration object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary representing the QasmExperimentCalibrations to create. It will be in the same format as output by [`to_dict()`](#qiskit.qobj.QasmExperimentCalibrations.to_dict "qiskit.qobj.QasmExperimentCalibrations.to_dict").
+
+**Returns**
+
+The QasmExperimentCalibrations from the input dictionary.
+
+**Return type**
+
+[QasmExperimentCalibrations](#qiskit.qobj.QasmExperimentCalibrations "qiskit.qobj.QasmExperimentCalibrations")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the calibrations.
+
+**Returns**
+
+The dictionary form of the GateCalibration.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.qobj.QasmQobj.md b/docs/api/qiskit/0.46/qiskit.qobj.QasmQobj.md
new file mode 100644
index 00000000000..fa3039bb4eb
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.qobj.QasmQobj.md
@@ -0,0 +1,84 @@
+---
+title: QasmQobj
+description: API reference for qiskit.qobj.QasmQobj
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.qobj.QasmQobj
+---
+
+# QasmQobj
+
+
+
+`qiskit.qobj.QasmQobj(qobj_id=None, config=None, experiments=None, header=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qobj/qasm_qobj.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+An OpenQASM 2 Qobj.
+
+Instantiate a new OpenQASM 2 Qobj Object.
+
+Each OpenQASM 2 Qobj object is used to represent a single payload that will be passed to a Qiskit provider. It mirrors the Qobj the published [Qobj specification](https://arxiv.org/abs/1809.03452) for OpenQASM experiments.
+
+**Parameters**
+
+* **qobj\_id** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – An identifier for the qobj
+* **config** (*QasmQobjRunConfig*) – A config for the entire run
+* **header** ([*QobjHeader*](qiskit.qobj.QobjHeader "qiskit.qobj.QobjHeader")) – A header for the entire run
+* **experiments** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of lists of [`QasmQobjExperiment`](qiskit.qobj.QasmQobjExperiment "qiskit.qobj.QasmQobjExperiment") objects representing an experiment
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new QASMQobj object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary representing the QasmQobj to create. It will be in the same format as output by [`to_dict()`](#qiskit.qobj.QasmQobj.to_dict "qiskit.qobj.QasmQobj.to_dict").
+
+**Returns**
+
+The QasmQobj from the input dictionary.
+
+**Return type**
+
+[QasmQobj](#qiskit.qobj.QasmQobj "qiskit.qobj.QasmQobj")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the OpenQASM 2 Qobj.
+
+Note this dict is not in the json wire format expected by IBM and Qobj specification because complex numbers are still of type complex. Also, this may contain native numpy arrays. When serializing this output for use with IBM systems, you can leverage a json encoder that converts these as expected. For example:
+
+```python
+import json
+import numpy
+
+class QobjEncoder(json.JSONEncoder):
+ def default(self, obj):
+ if isinstance(obj, numpy.ndarray):
+ return obj.tolist()
+ if isinstance(obj, complex):
+ return (obj.real, obj.imag)
+ return json.JSONEncoder.default(self, obj)
+
+json.dumps(qobj.to_dict(), cls=QobjEncoder)
+```
+
+**Returns**
+
+A dictionary representation of the QasmQobj object
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.qobj.QasmQobjConfig.md b/docs/api/qiskit/0.46/qiskit.qobj.QasmQobjConfig.md
new file mode 100644
index 00000000000..85d12ad1dd5
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.qobj.QasmQobjConfig.md
@@ -0,0 +1,75 @@
+---
+title: QasmQobjConfig
+description: API reference for qiskit.qobj.QasmQobjConfig
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.qobj.QasmQobjConfig
+---
+
+# QasmQobjConfig
+
+
+
+`qiskit.qobj.QasmQobjConfig(shots=None, seed_simulator=None, memory=None, parameter_binds=None, meas_level=None, meas_return=None, memory_slots=None, n_qubits=None, pulse_library=None, calibrations=None, rep_delay=None, qubit_lo_freq=None, meas_lo_freq=None, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qobj/qasm_qobj.py "view source code")
+
+Bases: [`SimpleNamespace`](https://docs.python.org/3/library/types.html#types.SimpleNamespace "(in Python v3.12)")
+
+A configuration for an OpenQASM 2 Qobj.
+
+Model for RunConfig.
+
+**Parameters**
+
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of shots.
+* **seed\_simulator** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the seed to use in the simulator
+* **memory** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – whether to request memory from backend (per-shot readouts)
+* **parameter\_binds** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*]*) – List of parameter bindings
+* **meas\_level** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Measurement level 0, 1, or 2
+* **meas\_return** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – For measurement level \< 2, whether single or avg shots are returned
+* **memory\_slots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of memory slots on the device
+* **n\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of qubits on the device
+* **pulse\_library** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – List of [`PulseLibraryItem`](qiskit.qobj.PulseLibraryItem "qiskit.qobj.PulseLibraryItem").
+* **calibrations** ([*QasmExperimentCalibrations*](qiskit.qobj.QasmExperimentCalibrations "qiskit.qobj.QasmExperimentCalibrations")) – Information required for Pulse gates.
+* **rep\_delay** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Delay between programs in sec. Only supported on certain backends (`backend.configuration().dynamic_reprate_enabled` ). Must be from the range supplied by the backend (`backend.configuration().rep_delay_range`). Default is `backend.configuration().default_rep_delay`.
+* **qubit\_lo\_freq** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – List of frequencies (as floats) for the qubit driver LO’s in GHz.
+* **meas\_lo\_freq** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – List of frequencies (as floats) for the measurement driver LO’s in GHz.
+* **kwargs** – Additional free form key value fields to add to the configuration.
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new QasmQobjConfig object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary for the config
+
+**Returns**
+
+The object from the input dictionary.
+
+**Return type**
+
+[QasmQobjConfig](#qiskit.qobj.QasmQobjConfig "qiskit.qobj.QasmQobjConfig")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the OpenQASM 2 Qobj config.
+
+**Returns**
+
+The dictionary form of the QasmQobjConfig.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.qobj.QasmQobjExperiment.md b/docs/api/qiskit/0.46/qiskit.qobj.QasmQobjExperiment.md
new file mode 100644
index 00000000000..2f88fa0a5fa
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.qobj.QasmQobjExperiment.md
@@ -0,0 +1,66 @@
+---
+title: QasmQobjExperiment
+description: API reference for qiskit.qobj.QasmQobjExperiment
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.qobj.QasmQobjExperiment
+---
+
+# QasmQobjExperiment
+
+
+
+`qiskit.qobj.QasmQobjExperiment(config=None, header=None, instructions=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qobj/qasm_qobj.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+An OpenQASM 2 Qobj Experiment.
+
+Each instance of this class is used to represent an OpenQASM 2 experiment as part of a larger OpenQASM 2 qobj.
+
+Instantiate a QasmQobjExperiment.
+
+**Parameters**
+
+* **config** ([*QasmQobjExperimentConfig*](qiskit.qobj.QasmQobjExperimentConfig "qiskit.qobj.QasmQobjExperimentConfig")) – A config object for the experiment
+* **header** (*QasmQobjExperimentHeader*) – A header object for the experiment
+* **instructions** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of [`QasmQobjInstruction`](qiskit.qobj.QasmQobjInstruction "qiskit.qobj.QasmQobjInstruction") objects
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new QasmQobjExperiment object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary for the experiment config
+
+**Returns**
+
+The object from the input dictionary.
+
+**Return type**
+
+[QasmQobjExperiment](#qiskit.qobj.QasmQobjExperiment "qiskit.qobj.QasmQobjExperiment")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the Experiment.
+
+**Returns**
+
+The dictionary form of the QasmQObjExperiment.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.qobj.QasmQobjExperimentConfig.md b/docs/api/qiskit/0.46/qiskit.qobj.QasmQobjExperimentConfig.md
new file mode 100644
index 00000000000..1f0b1641370
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.qobj.QasmQobjExperimentConfig.md
@@ -0,0 +1,63 @@
+---
+title: QasmQobjExperimentConfig
+description: API reference for qiskit.qobj.QasmQobjExperimentConfig
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.qobj.QasmQobjExperimentConfig
+---
+
+# QasmQobjExperimentConfig
+
+
+
+`qiskit.qobj.QasmQobjExperimentConfig(calibrations=None, qubit_lo_freq=None, meas_lo_freq=None, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qobj/qasm_qobj.py "view source code")
+
+Bases: `QobjDictField`
+
+Configuration for a single OpenQASM 2 experiment in the qobj.
+
+**Parameters**
+
+* **calibrations** ([*QasmExperimentCalibrations*](qiskit.qobj.QasmExperimentCalibrations "qiskit.qobj.QasmExperimentCalibrations")) – Information required for Pulse gates.
+* **qubit\_lo\_freq** (*List\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – List of qubit LO frequencies in GHz.
+* **meas\_lo\_freq** (*List\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – List of meas readout LO frequencies in GHz.
+* **kwargs** – Additional free form key value fields to add to the configuration
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new QobjHeader object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary representing the QobjHeader to create. It will be in the same format as output by [`to_dict()`](#qiskit.qobj.QasmQobjExperimentConfig.to_dict "qiskit.qobj.QasmQobjExperimentConfig.to_dict").
+
+**Returns**
+
+The QobjDictField from the input dictionary.
+
+**Return type**
+
+QobjDictFieldr
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the OpenQASM 2 Qobj.
+
+**Returns**
+
+The dictionary form of the QobjHeader.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.qobj.QasmQobjInstruction.md b/docs/api/qiskit/0.46/qiskit.qobj.QasmQobjInstruction.md
new file mode 100644
index 00000000000..2bbca305490
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.qobj.QasmQobjInstruction.md
@@ -0,0 +1,73 @@
+---
+title: QasmQobjInstruction
+description: API reference for qiskit.qobj.QasmQobjInstruction
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.qobj.QasmQobjInstruction
+---
+
+# QasmQobjInstruction
+
+
+
+`qiskit.qobj.QasmQobjInstruction(name, params=None, qubits=None, register=None, memory=None, condition=None, conditional=None, label=None, mask=None, relation=None, val=None, snapshot_type=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qobj/qasm_qobj.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+A class representing a single instruction in an QasmQobj Experiment.
+
+Instantiate a new QasmQobjInstruction object.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the instruction
+* **params** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – The list of parameters for the gate
+* **qubits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of `int` representing the qubits the instruction operates on
+* **register** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – If a `measure` instruction this is a list of `int` containing the list of register slots in which to store the measurement results (must be the same length as qubits). If a `bfunc` instruction this is a single `int` of the register slot in which to store the result.
+* **memory** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – If a `measure` instruction this is a list of `int` containing the list of memory slots to store the measurement results in (must be the same length as qubits). If a `bfunc` instruction this is a single `int` of the memory slot to store the boolean function result in.
+* **condition** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – A tuple of the form `(int, int)` where the first `int` is the control register and the second `int` is the control value if the gate has a condition.
+* **conditional** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The register index of the condition
+* **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – An optional label assigned to the instruction
+* **mask** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – For a `bfunc` instruction the hex value which is applied as an `AND` to the register bits.
+* **relation** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Relational operator for comparing the masked register to the `val` kwarg. Can be either `==` (equals) or `!=` (not equals).
+* **val** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Value to which to compare the masked register. In other words, the output of the function is `(register AND mask)`
+* **snapshot\_type** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – For snapshot instructions the type of snapshot to use
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new QasmQobjInstruction object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary for the experiment config
+
+**Returns**
+
+The object from the input dictionary.
+
+**Return type**
+
+[QasmQobjInstruction](#qiskit.qobj.QasmQobjInstruction "qiskit.qobj.QasmQobjInstruction")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the Instruction.
+
+**Returns**
+
+The dictionary form of the QasmQobjInstruction.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.qobj.QobjExperimentHeader.md b/docs/api/qiskit/0.46/qiskit.qobj.QobjExperimentHeader.md
new file mode 100644
index 00000000000..4d39794d8fe
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.qobj.QobjExperimentHeader.md
@@ -0,0 +1,62 @@
+---
+title: QobjExperimentHeader
+description: API reference for qiskit.qobj.QobjExperimentHeader
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.qobj.QobjExperimentHeader
+---
+
+# QobjExperimentHeader
+
+
+
+`qiskit.qobj.QobjExperimentHeader(**kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qobj/common.py "view source code")
+
+Bases: [`QobjHeader`](qiskit.qobj.QobjHeader "qiskit.qobj.common.QobjHeader")
+
+A class representing a header dictionary for a Qobj Experiment.
+
+Instantiate a new Qobj dict field object.
+
+**Parameters**
+
+**kwargs** – arbitrary keyword arguments that can be accessed as attributes of the object.
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new QobjHeader object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary representing the QobjHeader to create. It will be in the same format as output by [`to_dict()`](#qiskit.qobj.QobjExperimentHeader.to_dict "qiskit.qobj.QobjExperimentHeader.to_dict").
+
+**Returns**
+
+The QobjDictField from the input dictionary.
+
+**Return type**
+
+QobjDictFieldr
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the OpenQASM 2 Qobj.
+
+**Returns**
+
+The dictionary form of the QobjHeader.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.qobj.QobjHeader.md b/docs/api/qiskit/0.46/qiskit.qobj.QobjHeader.md
new file mode 100644
index 00000000000..f079518f430
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.qobj.QobjHeader.md
@@ -0,0 +1,62 @@
+---
+title: QobjHeader
+description: API reference for qiskit.qobj.QobjHeader
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.qobj.QobjHeader
+---
+
+# QobjHeader
+
+
+
+`qiskit.qobj.QobjHeader(**kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qobj/common.py "view source code")
+
+Bases: `QobjDictField`
+
+A class used to represent a dictionary header in Qobj objects.
+
+Instantiate a new Qobj dict field object.
+
+**Parameters**
+
+**kwargs** – arbitrary keyword arguments that can be accessed as attributes of the object.
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new QobjHeader object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary representing the QobjHeader to create. It will be in the same format as output by [`to_dict()`](#qiskit.qobj.QobjHeader.to_dict "qiskit.qobj.QobjHeader.to_dict").
+
+**Returns**
+
+The QobjDictField from the input dictionary.
+
+**Return type**
+
+QobjDictFieldr
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the OpenQASM 2 Qobj.
+
+**Returns**
+
+The dictionary form of the QobjHeader.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.qobj.QobjMeasurementOption.md b/docs/api/qiskit/0.46/qiskit.qobj.QobjMeasurementOption.md
new file mode 100644
index 00000000000..63deedcf568
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.qobj.QobjMeasurementOption.md
@@ -0,0 +1,63 @@
+---
+title: QobjMeasurementOption
+description: API reference for qiskit.qobj.QobjMeasurementOption
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.qobj.QobjMeasurementOption
+---
+
+# QobjMeasurementOption
+
+
+
+`qiskit.qobj.QobjMeasurementOption(name, params=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qobj/pulse_qobj.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+An individual measurement option.
+
+Instantiate a new QobjMeasurementOption object.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the measurement option
+* **params** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – The parameters of the measurement option.
+
+## Methods
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new QobjMeasurementOption object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary for the experiment config
+
+**Returns**
+
+The object from the input dictionary.
+
+**Return type**
+
+[QobjMeasurementOption](#qiskit.qobj.QobjMeasurementOption "qiskit.qobj.QobjMeasurementOption")
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dict format representation of the QobjMeasurementOption.
+
+**Returns**
+
+The dictionary form of the QasmMeasurementOption.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.quantum_info.CNOTDihedral.md b/docs/api/qiskit/0.46/qiskit.quantum_info.CNOTDihedral.md
new file mode 100644
index 00000000000..bfbb10a5c39
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.quantum_info.CNOTDihedral.md
@@ -0,0 +1,361 @@
+---
+title: CNOTDihedral
+description: API reference for qiskit.quantum_info.CNOTDihedral
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.quantum_info.CNOTDihedral
+---
+
+# CNOTDihedral
+
+
+
+`qiskit.quantum_info.CNOTDihedral(data=None, num_qubits=None, validate=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/dihedral/dihedral.py "view source code")
+
+Bases: `BaseOperator`, `AdjointMixin`
+
+An N-qubit operator from the CNOT-Dihedral group.
+
+> The CNOT-Dihedral group is generated by the quantum gates, [`CXGate`](qiskit.circuit.library.CXGate "qiskit.circuit.library.CXGate"), [`TGate`](qiskit.circuit.library.TGate "qiskit.circuit.library.TGate"), and [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.library.XGate").
+>
+> **Representation**
+>
+> An $N$-qubit CNOT-Dihedral operator is stored as an affine function and a phase polynomial, based on the convention in references \[1, 2].
+>
+> The affine function consists of an $N \times N$ invertible binary matrix, and an $N$ binary vector.
+>
+> The phase polynomial is a polynomial of degree at most 3, in $N$ variables, whose coefficients are in the ring Z\_8 with 8 elements.
+>
+> ```python
+> from qiskit import QuantumCircuit
+> from qiskit.quantum_info import CNOTDihedral
+>
+> circ = QuantumCircuit(3)
+> circ.cx(0, 1)
+> circ.x(2)
+> circ.t(1)
+> circ.t(1)
+> circ.t(1)
+> elem = CNOTDihedral(circ)
+>
+> # Print the CNOTDihedral element
+> print(elem)
+> ```
+
+```python
+phase polynomial =
+0 + 3*x_0 + 3*x_1 + 2*x_0*x_1
+affine function =
+ (x_0,x_0 + x_1,x_2 + 1)
+```
+
+**Circuit Conversion**
+
+> CNOTDihedral operators can be initialized from circuits containing *only* the following gates: [`IGate`](qiskit.circuit.library.IGate "qiskit.circuit.library.IGate"), [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.library.XGate"), [`YGate`](qiskit.circuit.library.YGate "qiskit.circuit.library.YGate"), [`ZGate`](qiskit.circuit.library.ZGate "qiskit.circuit.library.ZGate"), [`TGate`](qiskit.circuit.library.TGate "qiskit.circuit.library.TGate"), [`TdgGate`](qiskit.circuit.library.TdgGate "qiskit.circuit.library.TdgGate") [`SGate`](qiskit.circuit.library.SGate "qiskit.circuit.library.SGate"), [`SdgGate`](qiskit.circuit.library.SdgGate "qiskit.circuit.library.SdgGate"), [`CXGate`](qiskit.circuit.library.CXGate "qiskit.circuit.library.CXGate"), [`CZGate`](qiskit.circuit.library.CZGate "qiskit.circuit.library.CZGate"), [`CSGate`](qiskit.circuit.library.CSGate "qiskit.circuit.library.CSGate"), [`CSdgGate`](qiskit.circuit.library.CSdgGate "qiskit.circuit.library.CSdgGate"), [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate"), [`CCZGate`](qiskit.circuit.library.CCZGate "qiskit.circuit.library.CCZGate"). They can be converted back into a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), or [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate") object using the [`to_circuit()`](#qiskit.quantum_info.CNOTDihedral.to_circuit "qiskit.quantum_info.CNOTDihedral.to_circuit") or `to_instruction()` methods respectively. Note that this decomposition is not necessarily optimal in terms of number of gates if the number of qubits is more than two.
+>
+> CNOTDihedral operators can also be converted to [`Operator`](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator") objects using the [`to_operator()`](#qiskit.quantum_info.CNOTDihedral.to_operator "qiskit.quantum_info.CNOTDihedral.to_operator") method. This is done via decomposing to a circuit, and then simulating the circuit as a unitary operator.
+>
+> **References:**
+>
+> 1. Shelly Garion and Andrew W. Cross, *Synthesis of CNOT-Dihedral circuits with optimal number of two qubit gates*, [Quantum 4(369), 2020](https://quantum-journal.org/papers/q-2020-12-07-369/)
+> 2. Andrew W. Cross, Easwar Magesan, Lev S. Bishop, John A. Smolin and Jay M. Gambetta, *Scalable randomised benchmarking of non-Clifford gates*, npj Quantum Inf 2, 16012 (2016).
+
+Initialize a CNOTDihedral operator object.
+
+**Parameters**
+
+* **data** ([*CNOTDihedral*](#qiskit.quantum_info.CNOTDihedral "qiskit.quantum_info.CNOTDihedral") *or*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction")) – Optional, operator to initialize.
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Optional, initialize an empty CNOTDihedral operator.
+* **validate** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if True, validates the CNOTDihedral element.
+
+**Raises**
+
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the type is invalid.
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if validate=True and the CNOTDihedral element is invalid.
+
+## Attributes
+
+
+
+### dim
+
+Return tuple (input\_shape, output\_shape).
+
+
+
+### name
+
+Unique string identifier for operation type.
+
+
+
+### num\_clbits
+
+Number of classical bits.
+
+
+
+### num\_qubits
+
+Return the number of qubits if a N-qubit operator or None otherwise.
+
+
+
+### qargs
+
+Return the qargs for the operator.
+
+## Methods
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return the adjoint of the Operator.
+
+### compose
+
+
+
+`compose(other, qargs=None, front=False)`
+
+Return the operator composition with another CNOTDihedral.
+
+**Parameters**
+
+* **other** ([*CNOTDihedral*](#qiskit.quantum_info.CNOTDihedral "qiskit.quantum_info.CNOTDihedral")) – a CNOTDihedral object.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – Optional, a list of subsystem positions to apply other on. If None apply on all subsystems (default: None).
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True compose using right operator multiplication, instead of left multiplication \[default: False].
+
+**Returns**
+
+The composed CNOTDihedral.
+
+**Return type**
+
+[CNOTDihedral](#qiskit.quantum_info.CNOTDihedral "qiskit.quantum_info.CNOTDihedral")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if other cannot be converted to an operator, or has incompatible dimensions for specified subsystems.
+
+
+ Composition (`&`) by default is defined as left matrix multiplication for matrix operators, while `@` (equivalent to [`dot()`](#qiskit.quantum_info.CNOTDihedral.dot "qiskit.quantum_info.CNOTDihedral.dot")) is defined as right matrix multiplication. That is that `A & B == A.compose(B)` is equivalent to `B @ A == B.dot(A)` when `A` and `B` are of the same type.
+
+ Setting the `front=True` kwarg changes this to right matrix multiplication and is equivalent to the [`dot()`](#qiskit.quantum_info.CNOTDihedral.dot "qiskit.quantum_info.CNOTDihedral.dot") method `A.dot(B) == A.compose(B, front=True)`.
+
+
+### conjugate
+
+
+
+`conjugate()`
+
+Return the conjugate of the CNOTDihedral.
+
+### copy
+
+
+
+`copy()`
+
+Make a deep copy of current operator.
+
+### dot
+
+
+
+`dot(other, qargs=None)`
+
+Return the right multiplied operator self \* other.
+
+**Parameters**
+
+* **other** ([*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – an operator object.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – Optional, a list of subsystem positions to apply other on. If None apply on all subsystems (default: None).
+
+**Returns**
+
+The right matrix multiplied Operator.
+
+**Return type**
+
+[Operator](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")
+
+
+ The dot product can be obtained using the `@` binary operator. Hence `a.dot(b)` is equivalent to `a @ b`.
+
+
+### expand
+
+
+
+`expand(other)`
+
+Return the reverse-order tensor product with another CNOTDihedral.
+
+**Parameters**
+
+**other** ([*CNOTDihedral*](#qiskit.quantum_info.CNOTDihedral "qiskit.quantum_info.CNOTDihedral")) – a CNOTDihedral object.
+
+**Returns**
+
+**the tensor product $b \otimes a$, where $a$**
+
+is the current CNOTDihedral, and $b$ is the other CNOTDihedral.
+
+**Return type**
+
+[CNOTDihedral](#qiskit.quantum_info.CNOTDihedral "qiskit.quantum_info.CNOTDihedral")
+
+### input\_dims
+
+
+
+`input_dims(qargs=None)`
+
+Return tuple of input dimension for specified subsystems.
+
+### output\_dims
+
+
+
+`output_dims(qargs=None)`
+
+Return tuple of output dimension for specified subsystems.
+
+### power
+
+
+
+`power(n)`
+
+Return the compose of a operator with itself n times.
+
+**Parameters**
+
+**n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of times to compose with self (n>0).
+
+**Returns**
+
+the n-times composed operator.
+
+**Return type**
+
+[Clifford](qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input and output dimensions of the operator are not equal, or the power is not a positive integer.
+
+### reshape
+
+
+
+`reshape(input_dims=None, output_dims=None, num_qubits=None)`
+
+Return a shallow copy with reshaped input and output subsystem dimensions.
+
+**Parameters**
+
+* **input\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem input dimensions. If None the original input dims will be preserved \[Default: None].
+* **output\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem output dimensions. If None the original output dims will be preserved \[Default: None].
+* **num\_qubits** (*None or* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – reshape to an N-qubit operator \[Default: None].
+
+**Returns**
+
+returns self with reshaped input and output dimensions.
+
+**Return type**
+
+BaseOperator
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if combined size of all subsystem input dimension or subsystem output dimensions is not constant.
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return the tensor product with another CNOTDihedral.
+
+**Parameters**
+
+**other** ([*CNOTDihedral*](#qiskit.quantum_info.CNOTDihedral "qiskit.quantum_info.CNOTDihedral")) – a CNOTDihedral object.
+
+**Returns**
+
+**the tensor product $a \otimes b$, where $a$**
+
+is the current CNOTDihedral, and $b$ is the other CNOTDihedral.
+
+**Return type**
+
+[CNOTDihedral](#qiskit.quantum_info.CNOTDihedral "qiskit.quantum_info.CNOTDihedral")
+
+
+ The tensor product can be obtained using the `^` binary operator. Hence `a.tensor(b)` is equivalent to `a ^ b`.
+
+
+### to\_circuit
+
+
+
+`to_circuit()`
+
+Return a QuantumCircuit implementing the CNOT-Dihedral element.
+
+**Returns**
+
+a circuit implementation of the CNOTDihedral object.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**References**
+
+1. Shelly Garion and Andrew W. Cross, *Synthesis of CNOT-Dihedral circuits with optimal number of two qubit gates*, [Quantum 4(369), 2020](https://quantum-journal.org/papers/q-2020-12-07-369/)
+2. Andrew W. Cross, Easwar Magesan, Lev S. Bishop, John A. Smolin and Jay M. Gambetta, *Scalable randomised benchmarking of non-Clifford gates*, npj Quantum Inf 2, 16012 (2016).
+
+### to\_instruction
+
+
+
+`to_instruction()`
+
+Return a Gate instruction implementing the CNOTDihedral object.
+
+### to\_matrix
+
+
+
+`to_matrix()`
+
+Convert operator to Numpy matrix.
+
+### to\_operator
+
+
+
+`to_operator()`
+
+Convert to an Operator object.
+
+**Return type**
+
+[*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.operators.operator.Operator")
+
+### transpose
+
+
+
+`transpose()`
+
+Return the transpose of the CNOTDihedral.
+
diff --git a/docs/api/qiskit/0.46/qiskit.quantum_info.Chi.md b/docs/api/qiskit/0.46/qiskit.quantum_info.Chi.md
new file mode 100644
index 00000000000..3a4e4f6885c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.quantum_info.Chi.md
@@ -0,0 +1,395 @@
+---
+title: Chi
+description: API reference for qiskit.quantum_info.Chi
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.quantum_info.Chi
+---
+
+# Chi
+
+
+
+`qiskit.quantum_info.Chi(data, input_dims=None, output_dims=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/channel/chi.py "view source code")
+
+Bases: `QuantumChannel`
+
+Pauli basis Chi-matrix representation of a quantum channel.
+
+The Chi-matrix representation of an $n$-qubit quantum channel $\mathcal{E}$ is a matrix $\chi$ such that the evolution of a [`DensityMatrix`](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix") $\rho$ is given by
+
+$$
+\mathcal{E}(ρ) = \frac{1}{2^n} \sum_{i, j} \chi_{i,j} P_i ρ P_j
+$$
+
+where $[P_0, P_1, ..., P_{4^{n}-1}]$ is the $n$-qubit Pauli basis in lexicographic order. It is related to the [`Choi`](qiskit.quantum_info.Choi "qiskit.quantum_info.Choi") representation by a change of basis of the Choi-matrix into the Pauli basis. The $\frac{1}{2^n}$ in the definition above is a normalization factor that arises from scaling the Pauli basis to make it orthonormal.
+
+See reference \[1] for further details.
+
+**References**
+
+1. C.J. Wood, J.D. Biamonte, D.G. Cory, *Tensor networks and graphical calculus for open quantum systems*, Quant. Inf. Comp. 15, 0579-0811 (2015). [arXiv:1111.6950 \[quant-ph\]](https://arxiv.org/abs/1111.6950)
+
+Initialize a quantum channel Chi-matrix operator.
+
+**Parameters**
+
+* **or** (*data (*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – Instruction or BaseOperator or matrix): data to initialize superoperator.
+* **input\_dims** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the input subsystem dimensions. \[Default: None]
+* **output\_dims** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the output subsystem dimensions. \[Default: None]
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if input data is not an N-qubit channel or cannot be initialized as a Chi-matrix.
+
+**Additional Information:**
+
+If the input or output dimensions are None, they will be automatically determined from the input data. The Chi matrix representation is only valid for N-qubit channels.
+
+## Attributes
+
+
+
+### atol
+
+`= 1e-08`
+
+
+
+### data
+
+Return data.
+
+
+
+### dim
+
+Return tuple (input\_shape, output\_shape).
+
+
+
+### num\_qubits
+
+Return the number of qubits if a N-qubit operator or None otherwise.
+
+
+
+### qargs
+
+Return the qargs for the operator.
+
+
+
+### rtol
+
+`= 1e-05`
+
+
+
+### settings
+
+Return settings.
+
+## Methods
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return the adjoint quantum channel.
+
+
+ This is equivalent to the matrix Hermitian conjugate in the [`SuperOp`](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") representation ie. for a channel $\mathcal{E}$, the SuperOp of the adjoint channel $\mathcal{{E}}^\dagger$ is $S_{\mathcal{E}^\dagger} = S_{\mathcal{E}}^\dagger$.
+
+
+### compose
+
+
+
+`compose(other, qargs=None, front=False)`
+
+Return the operator composition with another Chi.
+
+**Parameters**
+
+* **other** ([*Chi*](#qiskit.quantum_info.Chi "qiskit.quantum_info.Chi")) – a Chi object.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – Optional, a list of subsystem positions to apply other on. If None apply on all subsystems (default: None).
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True compose using right operator multiplication, instead of left multiplication \[default: False].
+
+**Returns**
+
+The composed Chi.
+
+**Return type**
+
+[Chi](#qiskit.quantum_info.Chi "qiskit.quantum_info.Chi")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if other cannot be converted to an operator, or has incompatible dimensions for specified subsystems.
+
+
+ Composition (`&`) by default is defined as left matrix multiplication for matrix operators, while `@` (equivalent to [`dot()`](#qiskit.quantum_info.Chi.dot "qiskit.quantum_info.Chi.dot")) is defined as right matrix multiplication. That is that `A & B == A.compose(B)` is equivalent to `B @ A == B.dot(A)` when `A` and `B` are of the same type.
+
+ Setting the `front=True` kwarg changes this to right matrix multiplication and is equivalent to the [`dot()`](#qiskit.quantum_info.Chi.dot "qiskit.quantum_info.Chi.dot") method `A.dot(B) == A.compose(B, front=True)`.
+
+
+### conjugate
+
+
+
+`conjugate()`
+
+Return the conjugate quantum channel.
+
+
+ This is equivalent to the matrix complex conjugate in the [`SuperOp`](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") representation ie. for a channel $\mathcal{E}$, the SuperOp of the conjugate channel $\overline{{\mathcal{{E}}}}$ is $S_{\overline{\mathcal{E}^\dagger}} = \overline{S_{\mathcal{E}}}$.
+
+
+### copy
+
+
+
+`copy()`
+
+Make a deep copy of current operator.
+
+### dot
+
+
+
+`dot(other, qargs=None)`
+
+Return the right multiplied operator self \* other.
+
+**Parameters**
+
+* **other** ([*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – an operator object.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – Optional, a list of subsystem positions to apply other on. If None apply on all subsystems (default: None).
+
+**Returns**
+
+The right matrix multiplied Operator.
+
+**Return type**
+
+[Operator](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")
+
+
+ The dot product can be obtained using the `@` binary operator. Hence `a.dot(b)` is equivalent to `a @ b`.
+
+
+### expand
+
+
+
+`expand(other)`
+
+Return the reverse-order tensor product with another Chi.
+
+**Parameters**
+
+**other** ([*Chi*](#qiskit.quantum_info.Chi "qiskit.quantum_info.Chi")) – a Chi object.
+
+**Returns**
+
+**the tensor product $b \otimes a$, where $a$**
+
+is the current Chi, and $b$ is the other Chi.
+
+**Return type**
+
+[Chi](#qiskit.quantum_info.Chi "qiskit.quantum_info.Chi")
+
+### input\_dims
+
+
+
+`input_dims(qargs=None)`
+
+Return tuple of input dimension for specified subsystems.
+
+### is\_cp
+
+
+
+`is_cp(atol=None, rtol=None)`
+
+Test if Choi-matrix is completely-positive (CP)
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### is\_cptp
+
+
+
+`is_cptp(atol=None, rtol=None)`
+
+Return True if completely-positive trace-preserving (CPTP).
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### is\_tp
+
+
+
+`is_tp(atol=None, rtol=None)`
+
+Test if a channel is trace-preserving (TP)
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### is\_unitary
+
+
+
+`is_unitary(atol=None, rtol=None)`
+
+Return True if QuantumChannel is a unitary channel.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### output\_dims
+
+
+
+`output_dims(qargs=None)`
+
+Return tuple of output dimension for specified subsystems.
+
+### power
+
+
+
+`power(n)`
+
+Return the power of the quantum channel.
+
+**Parameters**
+
+**n** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the power exponent.
+
+**Returns**
+
+the channel $\mathcal{{E}} ^n$.
+
+**Return type**
+
+[SuperOp](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input and output dimensions of the SuperOp are not equal.
+
+
+ For non-positive or non-integer exponents the power is defined as the matrix power of the [`SuperOp`](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") representation ie. for a channel $\mathcal{{E}}$, the SuperOp of the powered channel $\mathcal{{E}}^\n$ is $S_{{\mathcal{{E}}^n}} = S_{{\mathcal{{E}}}}^n$.
+
+
+### reshape
+
+
+
+`reshape(input_dims=None, output_dims=None, num_qubits=None)`
+
+Return a shallow copy with reshaped input and output subsystem dimensions.
+
+**Parameters**
+
+* **input\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem input dimensions. If None the original input dims will be preserved \[Default: None].
+* **output\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem output dimensions. If None the original output dims will be preserved \[Default: None].
+* **num\_qubits** (*None or* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – reshape to an N-qubit operator \[Default: None].
+
+**Returns**
+
+returns self with reshaped input and output dimensions.
+
+**Return type**
+
+BaseOperator
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if combined size of all subsystem input dimension or subsystem output dimensions is not constant.
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return the tensor product with another Chi.
+
+**Parameters**
+
+**other** ([*Chi*](#qiskit.quantum_info.Chi "qiskit.quantum_info.Chi")) – a Chi object.
+
+**Returns**
+
+**the tensor product $a \otimes b$, where $a$**
+
+is the current Chi, and $b$ is the other Chi.
+
+**Return type**
+
+[Chi](#qiskit.quantum_info.Chi "qiskit.quantum_info.Chi")
+
+
+ The tensor product can be obtained using the `^` binary operator. Hence `a.tensor(b)` is equivalent to `a ^ b`.
+
+
+### to\_instruction
+
+
+
+`to_instruction()`
+
+Convert to a Kraus or UnitaryGate circuit instruction.
+
+If the channel is unitary it will be added as a unitary gate, otherwise it will be added as a kraus simulator instruction.
+
+**Returns**
+
+A kraus instruction for the channel.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if input data is not an N-qubit CPTP quantum channel.
+
+### to\_operator
+
+
+
+`to_operator()`
+
+Try to convert channel to a unitary representation Operator.
+
+**Return type**
+
+[*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.operators.operator.Operator")
+
+### transpose
+
+
+
+`transpose()`
+
+Return the transpose quantum channel.
+
+
+ This is equivalent to the matrix transpose in the [`SuperOp`](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") representation, ie. for a channel $\mathcal{E}$, the SuperOp of the transpose channel $\mathcal{{E}}^T$ is $S_{mathcal{E}^T} = S_{\mathcal{E}}^T$.
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.quantum_info.Choi.md b/docs/api/qiskit/0.46/qiskit.quantum_info.Choi.md
new file mode 100644
index 00000000000..4d23ae851bf
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.quantum_info.Choi.md
@@ -0,0 +1,407 @@
+---
+title: Choi
+description: API reference for qiskit.quantum_info.Choi
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.quantum_info.Choi
+---
+
+# Choi
+
+
+
+`qiskit.quantum_info.Choi(data, input_dims=None, output_dims=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/channel/choi.py "view source code")
+
+Bases: `QuantumChannel`
+
+Choi-matrix representation of a Quantum Channel.
+
+The Choi-matrix representation of a quantum channel $\mathcal{E}$ is a matrix
+
+$$
+\Lambda = \sum_{i,j} |i\rangle\!\langle j|\otimes
+ \mathcal{E}\left(|i\rangle\!\langle j|\right)
+$$
+
+Evolution of a [`DensityMatrix`](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix") $\rho$ with respect to the Choi-matrix is given by
+
+$$
+\mathcal{E}(\rho) = \mbox{Tr}_{1}\left[\Lambda
+ (\rho^T \otimes \mathbb{I})\right]
+$$
+
+where $\mbox{Tr}_1$ is the [`partial_trace()`](quantum_info#qiskit.quantum_info.partial_trace "qiskit.quantum_info.partial_trace") over subsystem 1.
+
+See reference \[1] for further details.
+
+**References**
+
+1. C.J. Wood, J.D. Biamonte, D.G. Cory, *Tensor networks and graphical calculus for open quantum systems*, Quant. Inf. Comp. 15, 0579-0811 (2015). [arXiv:1111.6950 \[quant-ph\]](https://arxiv.org/abs/1111.6950)
+
+Initialize a quantum channel Choi matrix operator.
+
+**Parameters**
+
+* **or** (*data (*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – Instruction or BaseOperator or matrix): data to initialize superoperator.
+* **input\_dims** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the input subsystem dimensions. \[Default: None]
+* **output\_dims** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the output subsystem dimensions. \[Default: None]
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if input data cannot be initialized as a Choi matrix.
+
+**Additional Information:**
+
+If the input or output dimensions are None, they will be automatically determined from the input data. If the input data is a Numpy array of shape (4\*\*N, 4\*\*N) qubit systems will be used. If the input operator is not an N-qubit operator, it will assign a single subsystem with dimension specified by the shape of the input.
+
+## Attributes
+
+
+
+### atol
+
+`= 1e-08`
+
+
+
+### data
+
+Return data.
+
+
+
+### dim
+
+Return tuple (input\_shape, output\_shape).
+
+
+
+### num\_qubits
+
+Return the number of qubits if a N-qubit operator or None otherwise.
+
+
+
+### qargs
+
+Return the qargs for the operator.
+
+
+
+### rtol
+
+`= 1e-05`
+
+
+
+### settings
+
+Return settings.
+
+## Methods
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return the adjoint quantum channel.
+
+
+ This is equivalent to the matrix Hermitian conjugate in the [`SuperOp`](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") representation ie. for a channel $\mathcal{E}$, the SuperOp of the adjoint channel $\mathcal{{E}}^\dagger$ is $S_{\mathcal{E}^\dagger} = S_{\mathcal{E}}^\dagger$.
+
+
+**Return type**
+
+*Self*
+
+### compose
+
+
+
+`compose(other, qargs=None, front=False)`
+
+Return the operator composition with another Choi.
+
+**Parameters**
+
+* **other** ([*Choi*](#qiskit.quantum_info.Choi "qiskit.quantum_info.Choi")) – a Choi object.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – Optional, a list of subsystem positions to apply other on. If None apply on all subsystems (default: None).
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True compose using right operator multiplication, instead of left multiplication \[default: False].
+
+**Returns**
+
+The composed Choi.
+
+**Return type**
+
+[Choi](#qiskit.quantum_info.Choi "qiskit.quantum_info.Choi")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if other cannot be converted to an operator, or has incompatible dimensions for specified subsystems.
+
+
+ Composition (`&`) by default is defined as left matrix multiplication for matrix operators, while `@` (equivalent to [`dot()`](#qiskit.quantum_info.Choi.dot "qiskit.quantum_info.Choi.dot")) is defined as right matrix multiplication. That is that `A & B == A.compose(B)` is equivalent to `B @ A == B.dot(A)` when `A` and `B` are of the same type.
+
+ Setting the `front=True` kwarg changes this to right matrix multiplication and is equivalent to the [`dot()`](#qiskit.quantum_info.Choi.dot "qiskit.quantum_info.Choi.dot") method `A.dot(B) == A.compose(B, front=True)`.
+
+
+### conjugate
+
+
+
+`conjugate()`
+
+Return the conjugate quantum channel.
+
+
+ This is equivalent to the matrix complex conjugate in the [`SuperOp`](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") representation ie. for a channel $\mathcal{E}$, the SuperOp of the conjugate channel $\overline{{\mathcal{{E}}}}$ is $S_{\overline{\mathcal{E}^\dagger}} = \overline{S_{\mathcal{E}}}$.
+
+
+### copy
+
+
+
+`copy()`
+
+Make a deep copy of current operator.
+
+### dot
+
+
+
+`dot(other, qargs=None)`
+
+Return the right multiplied operator self \* other.
+
+**Parameters**
+
+* **other** ([*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – an operator object.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – Optional, a list of subsystem positions to apply other on. If None apply on all subsystems (default: None).
+
+**Returns**
+
+The right matrix multiplied Operator.
+
+**Return type**
+
+[Operator](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")
+
+
+ The dot product can be obtained using the `@` binary operator. Hence `a.dot(b)` is equivalent to `a @ b`.
+
+
+### expand
+
+
+
+`expand(other)`
+
+Return the reverse-order tensor product with another Choi.
+
+**Parameters**
+
+**other** ([*Choi*](#qiskit.quantum_info.Choi "qiskit.quantum_info.Choi")) – a Choi object.
+
+**Returns**
+
+**the tensor product $b \otimes a$, where $a$**
+
+is the current Choi, and $b$ is the other Choi.
+
+**Return type**
+
+[Choi](#qiskit.quantum_info.Choi "qiskit.quantum_info.Choi")
+
+### input\_dims
+
+
+
+`input_dims(qargs=None)`
+
+Return tuple of input dimension for specified subsystems.
+
+### is\_cp
+
+
+
+`is_cp(atol=None, rtol=None)`
+
+Test if Choi-matrix is completely-positive (CP)
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### is\_cptp
+
+
+
+`is_cptp(atol=None, rtol=None)`
+
+Return True if completely-positive trace-preserving (CPTP).
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### is\_tp
+
+
+
+`is_tp(atol=None, rtol=None)`
+
+Test if a channel is trace-preserving (TP)
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### is\_unitary
+
+
+
+`is_unitary(atol=None, rtol=None)`
+
+Return True if QuantumChannel is a unitary channel.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### output\_dims
+
+
+
+`output_dims(qargs=None)`
+
+Return tuple of output dimension for specified subsystems.
+
+### power
+
+
+
+`power(n)`
+
+Return the power of the quantum channel.
+
+**Parameters**
+
+**n** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the power exponent.
+
+**Returns**
+
+the channel $\mathcal{{E}} ^n$.
+
+**Return type**
+
+[SuperOp](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input and output dimensions of the SuperOp are not equal.
+
+
+ For non-positive or non-integer exponents the power is defined as the matrix power of the [`SuperOp`](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") representation ie. for a channel $\mathcal{{E}}$, the SuperOp of the powered channel $\mathcal{{E}}^\n$ is $S_{{\mathcal{{E}}^n}} = S_{{\mathcal{{E}}}}^n$.
+
+
+### reshape
+
+
+
+`reshape(input_dims=None, output_dims=None, num_qubits=None)`
+
+Return a shallow copy with reshaped input and output subsystem dimensions.
+
+**Parameters**
+
+* **input\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem input dimensions. If None the original input dims will be preserved \[Default: None].
+* **output\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem output dimensions. If None the original output dims will be preserved \[Default: None].
+* **num\_qubits** (*None or* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – reshape to an N-qubit operator \[Default: None].
+
+**Returns**
+
+returns self with reshaped input and output dimensions.
+
+**Return type**
+
+BaseOperator
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if combined size of all subsystem input dimension or subsystem output dimensions is not constant.
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return the tensor product with another Choi.
+
+**Parameters**
+
+**other** ([*Choi*](#qiskit.quantum_info.Choi "qiskit.quantum_info.Choi")) – a Choi object.
+
+**Returns**
+
+**the tensor product $a \otimes b$, where $a$**
+
+is the current Choi, and $b$ is the other Choi.
+
+**Return type**
+
+[Choi](#qiskit.quantum_info.Choi "qiskit.quantum_info.Choi")
+
+
+ The tensor product can be obtained using the `^` binary operator. Hence `a.tensor(b)` is equivalent to `a ^ b`.
+
+
+### to\_instruction
+
+
+
+`to_instruction()`
+
+Convert to a Kraus or UnitaryGate circuit instruction.
+
+If the channel is unitary it will be added as a unitary gate, otherwise it will be added as a kraus simulator instruction.
+
+**Returns**
+
+A kraus instruction for the channel.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if input data is not an N-qubit CPTP quantum channel.
+
+### to\_operator
+
+
+
+`to_operator()`
+
+Try to convert channel to a unitary representation Operator.
+
+**Return type**
+
+[*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.operators.operator.Operator")
+
+### transpose
+
+
+
+`transpose()`
+
+Return the transpose quantum channel.
+
+
+ This is equivalent to the matrix transpose in the [`SuperOp`](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") representation, ie. for a channel $\mathcal{E}$, the SuperOp of the transpose channel $\mathcal{{E}}^T$ is $S_{mathcal{E}^T} = S_{\mathcal{E}}^T$.
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.quantum_info.Clifford.md b/docs/api/qiskit/0.46/qiskit.quantum_info.Clifford.md
new file mode 100644
index 00000000000..352b6a551b9
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.quantum_info.Clifford.md
@@ -0,0 +1,661 @@
+---
+title: Clifford
+description: API reference for qiskit.quantum_info.Clifford
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.quantum_info.Clifford
+---
+
+# Clifford
+
+
+
+`qiskit.quantum_info.Clifford(data, validate=True, copy=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/symplectic/clifford.py "view source code")
+
+Bases: `BaseOperator`, `AdjointMixin`, [`Operation`](qiskit.circuit.Operation "qiskit.circuit.operation.Operation")
+
+An N-qubit unitary operator from the Clifford group.
+
+**Representation**
+
+An *N*-qubit Clifford operator is stored as a length *2N × (2N+1)* boolean tableau using the convention from reference \[1].
+
+* Rows 0 to *N-1* are the *destabilizer* group generators
+* Rows *N* to *2N-1* are the *stabilizer* group generators.
+
+The internal boolean tableau for the Clifford can be accessed using the `tableau` attribute. The destabilizer or stabilizer rows can each be accessed as a length-N Stabilizer table using [`destab`](#qiskit.quantum_info.Clifford.destab "qiskit.quantum_info.Clifford.destab") and [`stab`](#qiskit.quantum_info.Clifford.stab "qiskit.quantum_info.Clifford.stab") attributes.
+
+A more easily human readable representation of the Clifford operator can be obtained by calling the [`to_dict()`](#qiskit.quantum_info.Clifford.to_dict "qiskit.quantum_info.Clifford.to_dict") method. This representation is also used if a Clifford object is printed as in the following example
+
+```python
+from qiskit import QuantumCircuit
+from qiskit.quantum_info import Clifford
+
+# Bell state generation circuit
+qc = QuantumCircuit(2)
+qc.h(0)
+qc.cx(0, 1)
+cliff = Clifford(qc)
+
+# Print the Clifford
+print(cliff)
+
+# Print the Clifford destabilizer rows
+print(cliff.to_labels(mode="D"))
+
+# Print the Clifford stabilizer rows
+print(cliff.to_labels(mode="S"))
+```
+
+```python
+Clifford: Stabilizer = ['+XX', '+ZZ'], Destabilizer = ['+IZ', '+XI']
+['+IZ', '+XI']
+['+XX', '+ZZ']
+```
+
+**Circuit Conversion**
+
+Clifford operators can be initialized from circuits containing *only* the following Clifford gates: [`IGate`](qiskit.circuit.library.IGate "qiskit.circuit.library.IGate"), [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.library.XGate"), [`YGate`](qiskit.circuit.library.YGate "qiskit.circuit.library.YGate"), [`ZGate`](qiskit.circuit.library.ZGate "qiskit.circuit.library.ZGate"), [`HGate`](qiskit.circuit.library.HGate "qiskit.circuit.library.HGate"), [`SGate`](qiskit.circuit.library.SGate "qiskit.circuit.library.SGate"), [`SdgGate`](qiskit.circuit.library.SdgGate "qiskit.circuit.library.SdgGate"), [`SXGate`](qiskit.circuit.library.SXGate "qiskit.circuit.library.SXGate"), [`SXdgGate`](qiskit.circuit.library.SXdgGate "qiskit.circuit.library.SXdgGate"), [`CXGate`](qiskit.circuit.library.CXGate "qiskit.circuit.library.CXGate"), [`CZGate`](qiskit.circuit.library.CZGate "qiskit.circuit.library.CZGate"), [`CYGate`](qiskit.circuit.library.CYGate "qiskit.circuit.library.CYGate"), `DXGate`, [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate"), [`iSwapGate`](qiskit.circuit.library.iSwapGate "qiskit.circuit.library.iSwapGate"), [`ECRGate`](qiskit.circuit.library.ECRGate "qiskit.circuit.library.ECRGate"), [`LinearFunction`](qiskit.circuit.library.LinearFunction "qiskit.circuit.library.LinearFunction"), [`PermutationGate`](qiskit.circuit.library.PermutationGate "qiskit.circuit.library.PermutationGate"). They can be converted back into a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"), or [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate") object using the [`to_circuit()`](#qiskit.quantum_info.Clifford.to_circuit "qiskit.quantum_info.Clifford.to_circuit") or [`to_instruction()`](#qiskit.quantum_info.Clifford.to_instruction "qiskit.quantum_info.Clifford.to_instruction") methods respectively. Note that this decomposition is not necessarily optimal in terms of number of gates.
+
+
+ A minimally generating set of gates for Clifford circuits is the [`HGate`](qiskit.circuit.library.HGate "qiskit.circuit.library.HGate") and [`SGate`](qiskit.circuit.library.SGate "qiskit.circuit.library.SGate") gate and *either* the [`CXGate`](qiskit.circuit.library.CXGate "qiskit.circuit.library.CXGate") or [`CZGate`](qiskit.circuit.library.CZGate "qiskit.circuit.library.CZGate") two-qubit gate.
+
+
+Clifford operators can also be converted to [`Operator`](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator") objects using the [`to_operator()`](#qiskit.quantum_info.Clifford.to_operator "qiskit.quantum_info.Clifford.to_operator") method. This is done via decomposing to a circuit, and then simulating the circuit as a unitary operator.
+
+**References**
+
+1. S. Aaronson, D. Gottesman, *Improved Simulation of Stabilizer Circuits*, Phys. Rev. A 70, 052328 (2004). [arXiv:quant-ph/0406196](https://arxiv.org/abs/quant-ph/0406196)
+
+Initialize an operator object.
+
+## Attributes
+
+
+
+### destab
+
+The destabilizer array for the symplectic representation.
+
+
+
+### destab\_phase
+
+Return phase of destabilizer with boolean representation.
+
+
+
+### destab\_x
+
+The destabilizer x array for the symplectic representation.
+
+
+
+### destab\_z
+
+The destabilizer z array for the symplectic representation.
+
+
+
+### dim
+
+Return tuple (input\_shape, output\_shape).
+
+
+
+### name
+
+Unique string identifier for operation type.
+
+
+
+### num\_clbits
+
+Number of classical bits.
+
+
+
+### num\_qubits
+
+Return the number of qubits if a N-qubit operator or None otherwise.
+
+
+
+### phase
+
+Return phase with boolean representation.
+
+
+
+### qargs
+
+Return the qargs for the operator.
+
+
+
+### stab
+
+The stabilizer array for the symplectic representation.
+
+
+
+### stab\_phase
+
+Return phase of stabilizer with boolean representation.
+
+
+
+### stab\_x
+
+The stabilizer x array for the symplectic representation.
+
+
+
+### stab\_z
+
+The stabilizer array for the symplectic representation.
+
+
+
+### symplectic\_matrix
+
+Return boolean symplectic matrix.
+
+
+
+### x
+
+The x array for the symplectic representation.
+
+
+
+### z
+
+The z array for the symplectic representation.
+
+## Methods
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return the adjoint of the Operator.
+
+### compose
+
+
+
+`compose(other, qargs=None, front=False)`
+
+Return the operator composition with another Clifford.
+
+**Parameters**
+
+* **other** ([*Clifford*](#qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")) – a Clifford object.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – Optional, a list of subsystem positions to apply other on. If None apply on all subsystems (default: None).
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True compose using right operator multiplication, instead of left multiplication \[default: False].
+
+**Returns**
+
+The composed Clifford.
+
+**Return type**
+
+[Clifford](#qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if other cannot be converted to an operator, or has incompatible dimensions for specified subsystems.
+
+
+ Composition (`&`) by default is defined as left matrix multiplication for matrix operators, while `@` (equivalent to [`dot()`](#qiskit.quantum_info.Clifford.dot "qiskit.quantum_info.Clifford.dot")) is defined as right matrix multiplication. That is that `A & B == A.compose(B)` is equivalent to `B @ A == B.dot(A)` when `A` and `B` are of the same type.
+
+ Setting the `front=True` kwarg changes this to right matrix multiplication and is equivalent to the [`dot()`](#qiskit.quantum_info.Clifford.dot "qiskit.quantum_info.Clifford.dot") method `A.dot(B) == A.compose(B, front=True)`.
+
+
+### conjugate
+
+
+
+`conjugate()`
+
+Return the conjugate of the Clifford.
+
+### copy
+
+
+
+`copy()`
+
+Make a deep copy of current operator.
+
+### dot
+
+
+
+`dot(other, qargs=None)`
+
+Return the right multiplied operator self \* other.
+
+**Parameters**
+
+* **other** ([*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – an operator object.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – Optional, a list of subsystem positions to apply other on. If None apply on all subsystems (default: None).
+
+**Returns**
+
+The right matrix multiplied Operator.
+
+**Return type**
+
+[Operator](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")
+
+
+ The dot product can be obtained using the `@` binary operator. Hence `a.dot(b)` is equivalent to `a @ b`.
+
+
+### expand
+
+
+
+`expand(other)`
+
+Return the reverse-order tensor product with another Clifford.
+
+**Parameters**
+
+**other** ([*Clifford*](#qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")) – a Clifford object.
+
+**Returns**
+
+**the tensor product $b \otimes a$, where $a$**
+
+is the current Clifford, and $b$ is the other Clifford.
+
+**Return type**
+
+[Clifford](#qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")
+
+### from\_circuit
+
+
+
+`static from_circuit(circuit)`
+
+Initialize from a QuantumCircuit or Instruction.
+
+**Parameters**
+
+**circuit** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction")) – instruction to initialize.
+
+**Returns**
+
+the Clifford object for the instruction.
+
+**Return type**
+
+[Clifford](#qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input instruction is non-Clifford or contains classical register instruction.
+
+### from\_dict
+
+
+
+`classmethod from_dict(obj)`
+
+Load a Clifford from a dictionary
+
+### from\_label
+
+
+
+`static from_label(label)`
+
+Return a tensor product of single-qubit Clifford gates.
+
+**Parameters**
+
+**label** (*string*) – single-qubit operator string.
+
+**Returns**
+
+The N-qubit Clifford operator.
+
+**Return type**
+
+[Clifford](#qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the label contains invalid characters.
+
+**Additional Information:**
+
+The labels correspond to the single-qubit Cliffords are
+
+* * Label
+ * Stabilizer
+ * Destabilizer
+* * `"I"`
+ * +Z
+ * +X
+* * `"X"`
+ * -Z
+ * +X
+* * `"Y"`
+ * -Z
+ * -X
+* * `"Z"`
+ * +Z
+ * -X
+* * `"H"`
+ * +X
+ * +Z
+* * `"S"`
+ * +Z
+ * +Y
+
+### from\_linear\_function
+
+
+
+`classmethod from_linear_function(linear_function)`
+
+Create a Clifford from a Linear Function.
+
+If the linear function is represented by a nxn binary invertible matrix A, then the corresponding Clifford has symplectic matrix \[\[A^t, 0], \[0, A^\{-1}]].
+
+**Parameters**
+
+**linear\_function** ([*LinearFunction*](qiskit.circuit.library.LinearFunction "qiskit.circuit.library.LinearFunction")) – A linear function to be converted.
+
+**Returns**
+
+the Clifford object for this linear function.
+
+**Return type**
+
+[Clifford](#qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")
+
+### from\_matrix
+
+
+
+`classmethod from_matrix(matrix)`
+
+Create a Clifford from a unitary matrix.
+
+Note that this function takes exponentially long time w\.r.t. the number of qubits.
+
+**Parameters**
+
+**matrix** (*np.array*) – A unitary matrix representing a Clifford to be converted.
+
+**Returns**
+
+the Clifford object for the unitary matrix.
+
+**Return type**
+
+[Clifford](#qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input is not a Clifford matrix.
+
+### from\_operator
+
+
+
+`classmethod from_operator(operator)`
+
+Create a Clifford from a operator.
+
+Note that this function takes exponentially long time w\.r.t. the number of qubits.
+
+**Parameters**
+
+**operator** ([*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – An operator representing a Clifford to be converted.
+
+**Returns**
+
+the Clifford object for the operator.
+
+**Return type**
+
+[Clifford](#qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input is not a Clifford operator.
+
+### from\_permutation
+
+
+
+`classmethod from_permutation(permutation_gate)`
+
+Create a Clifford from a PermutationGate.
+
+**Parameters**
+
+**permutation\_gate** ([*PermutationGate*](qiskit.circuit.library.PermutationGate "qiskit.circuit.library.PermutationGate")) – A permutation to be converted.
+
+**Returns**
+
+the Clifford object for this permutation.
+
+**Return type**
+
+[Clifford](#qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")
+
+### input\_dims
+
+
+
+`input_dims(qargs=None)`
+
+Return tuple of input dimension for specified subsystems.
+
+### is\_unitary
+
+
+
+`is_unitary()`
+
+Return True if the Clifford table is valid.
+
+### output\_dims
+
+
+
+`output_dims(qargs=None)`
+
+Return tuple of output dimension for specified subsystems.
+
+### power
+
+
+
+`power(n)`
+
+Return the compose of a operator with itself n times.
+
+**Parameters**
+
+**n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of times to compose with self (n>0).
+
+**Returns**
+
+the n-times composed operator.
+
+**Return type**
+
+[Clifford](#qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input and output dimensions of the operator are not equal, or the power is not a positive integer.
+
+### reshape
+
+
+
+`reshape(input_dims=None, output_dims=None, num_qubits=None)`
+
+Return a shallow copy with reshaped input and output subsystem dimensions.
+
+**Parameters**
+
+* **input\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem input dimensions. If None the original input dims will be preserved \[Default: None].
+* **output\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem output dimensions. If None the original output dims will be preserved \[Default: None].
+* **num\_qubits** (*None or* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – reshape to an N-qubit operator \[Default: None].
+
+**Returns**
+
+returns self with reshaped input and output dimensions.
+
+**Return type**
+
+BaseOperator
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if combined size of all subsystem input dimension or subsystem output dimensions is not constant.
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return the tensor product with another Clifford.
+
+**Parameters**
+
+**other** ([*Clifford*](#qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")) – a Clifford object.
+
+**Returns**
+
+**the tensor product $a \otimes b$, where $a$**
+
+is the current Clifford, and $b$ is the other Clifford.
+
+**Return type**
+
+[Clifford](#qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")
+
+
+ The tensor product can be obtained using the `^` binary operator. Hence `a.tensor(b)` is equivalent to `a ^ b`.
+
+
+### to\_circuit
+
+
+
+`to_circuit()`
+
+Return a QuantumCircuit implementing the Clifford.
+
+For N \<= 3 qubits this is based on optimal CX cost decomposition from reference \[1]. For N > 3 qubits this is done using the general non-optimal compilation routine from reference \[2].
+
+**Returns**
+
+a circuit implementation of the Clifford.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**References**
+
+1. S. Bravyi, D. Maslov, *Hadamard-free circuits expose the structure of the Clifford group*, [arXiv:2003.09412 \[quant-ph\]](https://arxiv.org/abs/2003.09412)
+2. S. Aaronson, D. Gottesman, *Improved Simulation of Stabilizer Circuits*, Phys. Rev. A 70, 052328 (2004). [arXiv:quant-ph/0406196](https://arxiv.org/abs/quant-ph/0406196)
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return dictionary representation of Clifford object.
+
+### to\_instruction
+
+
+
+`to_instruction()`
+
+Return a Gate instruction implementing the Clifford.
+
+### to\_labels
+
+
+
+`to_labels(array=False, mode='B')`
+
+Convert a Clifford to a list Pauli (de)stabilizer string labels.
+
+For large Clifford converting using the `array=True` kwarg will be more efficient since it allocates memory for the full Numpy array of labels in advance.
+
+| Label | Phase | Symplectic | Matrix | Pauli |
+| ------ | ----- | ---------- | ------------------------------------------------ | ----- |
+| `"+I"` | 0 | $[0, 0]$ | $\begin{bmatrix} 1 & 0 \\ 0 & 1 \end{bmatrix}$ | $I$ |
+| `"-I"` | 1 | $[0, 0]$ | $\begin{bmatrix} -1 & 0 \\ 0 & -1 \end{bmatrix}$ | $-I$ |
+| `"X"` | 0 | $[1, 0]$ | $\begin{bmatrix} 0 & 1 \\ 1 & 0 \end{bmatrix}$ | $X$ |
+| `"-X"` | 1 | $[1, 0]$ | $\begin{bmatrix} 0 & -1 \\ -1 & 0 \end{bmatrix}$ | $-X$ |
+| `"Y"` | 0 | $[1, 1]$ | $\begin{bmatrix} 0 & 1 \\ -1 & 0 \end{bmatrix}$ | $iY$ |
+| `"-Y"` | 1 | $[1, 1]$ | $\begin{bmatrix} 0 & -1 \\ 1 & 0 \end{bmatrix}$ | $-iY$ |
+| `"Z"` | 0 | $[0, 1]$ | $\begin{bmatrix} 1 & 0 \\ 0 & -1 \end{bmatrix}$ | $Z$ |
+| `"-Z"` | 1 | $[0, 1]$ | $\begin{bmatrix} -1 & 0 \\ 0 & 1 \end{bmatrix}$ | $-Z$ |
+
+**Parameters**
+
+* **array** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – return a Numpy array if True, otherwise return a list (Default: False).
+* **mode** (*Literal\["S", "D", "B"]*) – return both stabilizer and destabilizer if “B”, return only stabilizer if “S” and return only destabilizer if “D”.
+
+**Returns**
+
+The rows of the StabilizerTable in label form.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") or array
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if stabilizer and destabilizer are both False.
+
+### to\_matrix
+
+
+
+`to_matrix()`
+
+Convert operator to Numpy matrix.
+
+### to\_operator
+
+
+
+`to_operator()`
+
+Convert to an Operator object.
+
+**Return type**
+
+[*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.operators.operator.Operator")
+
+### transpose
+
+
+
+`transpose()`
+
+Return the transpose of the Clifford.
+
diff --git a/docs/api/qiskit/0.46/qiskit.quantum_info.DensityMatrix.md b/docs/api/qiskit/0.46/qiskit.quantum_info.DensityMatrix.md
new file mode 100644
index 00000000000..7803a2dea97
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.quantum_info.DensityMatrix.md
@@ -0,0 +1,703 @@
+---
+title: DensityMatrix
+description: API reference for qiskit.quantum_info.DensityMatrix
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.quantum_info.DensityMatrix
+---
+
+# DensityMatrix
+
+
+
+`qiskit.quantum_info.DensityMatrix(data, dims=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/states/densitymatrix.py "view source code")
+
+Bases: `QuantumState`, `TolerancesMixin`
+
+DensityMatrix class
+
+Initialize a density matrix object.
+
+**Parameters**
+
+* **or** (*data (np.ndarray or* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or matrix\_like or*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – qiskit.circuit.Instruction): A statevector, quantum instruction or an object with a `to_operator` or `to_matrix` method from which the density matrix can be constructed. If a vector the density matrix is constructed as the projector of that vector. If a quantum instruction, the density matrix is constructed by assuming all qubits are initialized in the zero state.
+* **dims** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – Optional. The subsystem dimension of the state (See additional information).
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if input data is not valid.
+
+**Additional Information:**
+
+The `dims` kwarg can be None, an integer, or an iterable of integers.
+
+* `Iterable` – the subsystem dimensions are the values in the list with the total number of subsystems given by the length of the list.
+* `Int` or `None` – the leading dimension of the input matrix specifies the total dimension of the density matrix. If it is a power of two the state will be initialized as an N-qubit state. If it is not a power of two the state will have a single d-dimensional subsystem.
+
+## Attributes
+
+
+
+### atol
+
+`= 1e-08`
+
+
+
+### data
+
+Return data.
+
+
+
+### dim
+
+Return total state dimension.
+
+
+
+### num\_qubits
+
+Return the number of qubits if a N-qubit state or None otherwise.
+
+
+
+### rtol
+
+`= 1e-05`
+
+
+
+### settings
+
+Return settings.
+
+## Methods
+
+### conjugate
+
+
+
+`conjugate()`
+
+Return the conjugate of the density matrix.
+
+### copy
+
+
+
+`copy()`
+
+Make a copy of current operator.
+
+### dims
+
+
+
+`dims(qargs=None)`
+
+Return tuple of input dimension for specified subsystems.
+
+### draw
+
+
+
+`draw(output=None, **drawer_args)`
+
+Return a visualization of the Statevector.
+
+**repr**: ASCII TextMatrix of the state’s `__repr__`.
+
+**text**: ASCII TextMatrix that can be printed in the console.
+
+**latex**: An IPython Latex object for displaying in Jupyter Notebooks.
+
+**latex\_source**: Raw, uncompiled ASCII source to generate array using LaTeX.
+
+**qsphere**: Matplotlib figure, rendering of density matrix using plot\_state\_qsphere().
+
+**hinton**: Matplotlib figure, rendering of density matrix using plot\_state\_hinton().
+
+**bloch**: Matplotlib figure, rendering of density matrix using plot\_bloch\_multivector().
+
+**Parameters**
+
+* **output** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Select the output method to use for drawing the state. Valid choices are repr, text, latex, latex\_source, qsphere, hinton, or bloch. Default is repr. Default can be changed by adding the line `state_drawer = ` to `~/.qiskit/settings.conf` under `[default]`.
+* **drawer\_args** – Arguments to be passed directly to the relevant drawing function or constructor (TextMatrix(), array\_to\_latex(), plot\_state\_qsphere(), plot\_state\_hinton() or plot\_bloch\_multivector()). See the relevant function under qiskit.visualization for that function’s documentation.
+
+**Returns**
+
+`matplotlib.Figure` or [`str`](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") or `TextMatrix` or `IPython.display.Latex`: Drawing of the Statevector.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – when an invalid output method is selected.
+
+### evolve
+
+
+
+`evolve(other, qargs=None)`
+
+Evolve a quantum state by an operator.
+
+**Parameters**
+
+* **QuantumChannel** (*other (Operator or*) – or Instruction or Circuit): The operator to evolve by.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – a list of QuantumState subsystem positions to apply the operator on.
+
+**Returns**
+
+the output density matrix.
+
+**Return type**
+
+[DensityMatrix](#qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the operator dimension does not match the specified QuantumState subsystem dimensions.
+
+### expand
+
+
+
+`expand(other)`
+
+Return the tensor product state other ⊗ self.
+
+**Parameters**
+
+**other** ([*DensityMatrix*](#qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")) – a quantum state object.
+
+**Returns**
+
+the tensor product state other ⊗ self.
+
+**Return type**
+
+[DensityMatrix](#qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if other is not a quantum state.
+
+### expectation\_value
+
+
+
+`expectation_value(oper, qargs=None)`
+
+Compute the expectation value of an operator.
+
+**Parameters**
+
+* **oper** ([*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – an operator to evaluate expval.
+* **qargs** (*None or* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – subsystems to apply the operator on.
+
+**Returns**
+
+the expectation value.
+
+**Return type**
+
+[complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")
+
+### from\_instruction
+
+
+
+`classmethod from_instruction(instruction)`
+
+Return the output density matrix of an instruction.
+
+The statevector is initialized in the state $|{0,\ldots,0}\rangle$ of the same number of qubits as the input instruction or circuit, evolved by the input instruction, and the output statevector returned.
+
+**Parameters**
+
+**instruction** ([*qiskit.circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction") *or*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – instruction or circuit
+
+**Returns**
+
+the final density matrix.
+
+**Return type**
+
+[DensityMatrix](#qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the instruction contains invalid instructions for density matrix simulation.
+
+### from\_int
+
+
+
+`static from_int(i, dims)`
+
+Return a computational basis state density matrix.
+
+**Parameters**
+
+* **i** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the basis state element.
+* **dims** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – The subsystem dimensions of the statevector (See additional information).
+
+**Returns**
+
+The computational basis state $|i\rangle\!\langle i|$.
+
+**Return type**
+
+[DensityMatrix](#qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")
+
+**Additional Information:**
+
+The `dims` kwarg can be an integer or an iterable of integers.
+
+* `Iterable` – the subsystem dimensions are the values in the list with the total number of subsystems given by the length of the list.
+* `Int` – the integer specifies the total dimension of the state. If it is a power of two the state will be initialized as an N-qubit state. If it is not a power of two the state will have a single d-dimensional subsystem.
+
+### from\_label
+
+
+
+`classmethod from_label(label)`
+
+Return a tensor product of Pauli X,Y,Z eigenstates.
+
+| Label | Statevector |
+| ----- | ----------------------------------------------------------- |
+| `"0"` | $\begin{pmatrix} 1 & 0 \\ 0 & 0 \end{pmatrix}$ |
+| `"1"` | $\begin{pmatrix} 0 & 0 \\ 0 & 1 \end{pmatrix}$ |
+| `"+"` | $\frac{1}{2}\begin{pmatrix} 1 & 1 \\ 1 & 1 \end{pmatrix}$ |
+| `"-"` | $\frac{1}{2}\begin{pmatrix} 1 & -1 \\ -1 & 1 \end{pmatrix}$ |
+| `"r"` | $\frac{1}{2}\begin{pmatrix} 1 & -i \\ i & 1 \end{pmatrix}$ |
+| `"l"` | $\frac{1}{2}\begin{pmatrix} 1 & i \\ -i & 1 \end{pmatrix}$ |
+
+**Parameters**
+
+**label** (*string*) – a eigenstate string ket label (see table for allowed values).
+
+**Returns**
+
+The N-qubit basis state density matrix.
+
+**Return type**
+
+[DensityMatrix](#qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the label contains invalid characters, or the length of the label is larger than an explicitly specified num\_qubits.
+
+### is\_valid
+
+
+
+`is_valid(atol=None, rtol=None)`
+
+Return True if trace 1 and positive semidefinite.
+
+### measure
+
+
+
+`measure(qargs=None)`
+
+Measure subsystems and return outcome and post-measure state.
+
+Note that this function uses the QuantumStates internal random number generator for sampling the measurement outcome. The RNG seed can be set using the [`seed()`](#qiskit.quantum_info.DensityMatrix.seed "qiskit.quantum_info.DensityMatrix.seed") method.
+
+**Parameters**
+
+**qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – subsystems to sample measurements for, if None sample measurement of all subsystems (Default: None).
+
+**Returns**
+
+**the pair `(outcome, state)` where `outcome` is the**
+
+measurement outcome string label, and `state` is the collapsed post-measurement state for the corresponding outcome.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")
+
+### partial\_transpose
+
+
+
+`partial_transpose(qargs)`
+
+Return partially transposed density matrix.
+
+**Parameters**
+
+**qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – The subsystems to be transposed.
+
+**Returns**
+
+The partially transposed density matrix.
+
+**Return type**
+
+[DensityMatrix](#qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")
+
+### probabilities
+
+
+
+`probabilities(qargs=None, decimals=None)`
+
+Return the subsystem measurement probability vector.
+
+Measurement probabilities are with respect to measurement in the computation (diagonal) basis.
+
+**Parameters**
+
+* **qargs** (*None or* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – subsystems to return probabilities for, if None return for all subsystems (Default: None).
+* **decimals** (*None or* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of decimal places to round values. If None no rounding is done (Default: None).
+
+**Returns**
+
+The Numpy vector array of probabilities.
+
+**Return type**
+
+np.array
+
+**Examples**
+
+Consider a 2-qubit product state $\rho=\rho_1\otimes\rho_0$ with $\rho_1=|+\rangle\!\langle+|$, $\rho_0=|0\rangle\!\langle0|$.
+
+```python
+from qiskit.quantum_info import DensityMatrix
+
+rho = DensityMatrix.from_label('+0')
+
+# Probabilities for measuring both qubits
+probs = rho.probabilities()
+print('probs: {}'.format(probs))
+
+# Probabilities for measuring only qubit-0
+probs_qubit_0 = rho.probabilities([0])
+print('Qubit-0 probs: {}'.format(probs_qubit_0))
+
+# Probabilities for measuring only qubit-1
+probs_qubit_1 = rho.probabilities([1])
+print('Qubit-1 probs: {}'.format(probs_qubit_1))
+```
+
+```python
+probs: [0.5 0. 0.5 0. ]
+Qubit-0 probs: [1. 0.]
+Qubit-1 probs: [0.5 0.5]
+```
+
+We can also permute the order of qubits in the `qargs` list to change the qubit position in the probabilities output
+
+```python
+from qiskit.quantum_info import DensityMatrix
+
+rho = DensityMatrix.from_label('+0')
+
+# Probabilities for measuring both qubits
+probs = rho.probabilities([0, 1])
+print('probs: {}'.format(probs))
+
+# Probabilities for measuring both qubits
+# but swapping qubits 0 and 1 in output
+probs_swapped = rho.probabilities([1, 0])
+print('Swapped probs: {}'.format(probs_swapped))
+```
+
+```python
+probs: [0.5 0. 0.5 0. ]
+Swapped probs: [0.5 0.5 0. 0. ]
+```
+
+### probabilities\_dict
+
+
+
+`probabilities_dict(qargs=None, decimals=None)`
+
+Return the subsystem measurement probability dictionary.
+
+Measurement probabilities are with respect to measurement in the computation (diagonal) basis.
+
+This dictionary representation uses a Ket-like notation where the dictionary keys are qudit strings for the subsystem basis vectors. If any subsystem has a dimension greater than 10 comma delimiters are inserted between integers so that subsystems can be distinguished.
+
+**Parameters**
+
+* **qargs** (*None or* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – subsystems to return probabilities for, if None return for all subsystems (Default: None).
+* **decimals** (*None or* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of decimal places to round values. If None no rounding is done (Default: None).
+
+**Returns**
+
+The measurement probabilities in dict (ket) form.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+### purity
+
+
+
+`purity()`
+
+Return the purity of the quantum state.
+
+### reset
+
+
+
+`reset(qargs=None)`
+
+Reset state or subsystems to the 0-state.
+
+**Parameters**
+
+**qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – subsystems to reset, if None all subsystems will be reset to their 0-state (Default: None).
+
+**Returns**
+
+the reset state.
+
+**Return type**
+
+[DensityMatrix](#qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")
+
+**Additional Information:**
+
+If all subsystems are reset this will return the ground state on all subsystems. If only a some subsystems are reset this function will perform evolution by the reset [`SuperOp`](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") of the reset subsystems.
+
+### reverse\_qargs
+
+
+
+`reverse_qargs()`
+
+Return a DensityMatrix with reversed subsystem ordering.
+
+For a tensor product state this is equivalent to reversing the order of tensor product subsystems. For a density matrix $\rho = \rho_{n-1} \otimes ... \otimes \rho_0$ the returned state will be $\rho_0 \otimes ... \otimes \rho_{n-1}$.
+
+**Returns**
+
+the state with reversed subsystem order.
+
+**Return type**
+
+[DensityMatrix](#qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")
+
+### sample\_counts
+
+
+
+`sample_counts(shots, qargs=None)`
+
+Sample a dict of qubit measurement outcomes in the computational basis.
+
+**Parameters**
+
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of samples to generate.
+* **qargs** (*None or* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – subsystems to sample measurements for, if None sample measurement of all subsystems (Default: None).
+
+**Returns**
+
+sampled counts dictionary.
+
+**Return type**
+
+[Counts](qiskit.result.Counts "qiskit.result.Counts")
+
+Additional Information:
+
+> This function *samples* measurement outcomes using the measure [`probabilities()`](#qiskit.quantum_info.DensityMatrix.probabilities "qiskit.quantum_info.DensityMatrix.probabilities") for the current state and qargs. It does not actually implement the measurement so the current state is not modified.
+>
+> The seed for random number generator used for sampling can be set to a fixed value by using the stats [`seed()`](#qiskit.quantum_info.DensityMatrix.seed "qiskit.quantum_info.DensityMatrix.seed") method.
+
+### sample\_memory
+
+
+
+`sample_memory(shots, qargs=None)`
+
+Sample a list of qubit measurement outcomes in the computational basis.
+
+**Parameters**
+
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of samples to generate.
+* **qargs** (*None or* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – subsystems to sample measurements for, if None sample measurement of all subsystems (Default: None).
+
+**Returns**
+
+list of sampled counts if the order sampled.
+
+**Return type**
+
+np.array
+
+Additional Information:
+
+> This function *samples* measurement outcomes using the measure [`probabilities()`](#qiskit.quantum_info.DensityMatrix.probabilities "qiskit.quantum_info.DensityMatrix.probabilities") for the current state and qargs. It does not actually implement the measurement so the current state is not modified.
+>
+> The seed for random number generator used for sampling can be set to a fixed value by using the stats [`seed()`](#qiskit.quantum_info.DensityMatrix.seed "qiskit.quantum_info.DensityMatrix.seed") method.
+
+### seed
+
+
+
+`seed(value=None)`
+
+Set the seed for the quantum state RNG.
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return the tensor product state self ⊗ other.
+
+**Parameters**
+
+**other** ([*DensityMatrix*](#qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")) – a quantum state object.
+
+**Returns**
+
+the tensor product operator self ⊗ other.
+
+**Return type**
+
+[DensityMatrix](#qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if other is not a quantum state.
+
+### to\_dict
+
+
+
+`to_dict(decimals=None)`
+
+Convert the density matrix to dictionary form.
+
+This dictionary representation uses a Ket-like notation where the dictionary keys are qudit strings for the subsystem basis vectors. If any subsystem has a dimension greater than 10 comma delimiters are inserted between integers so that subsystems can be distinguished.
+
+**Parameters**
+
+**decimals** (*None or* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of decimal places to round values. If None no rounding is done (Default: None).
+
+**Returns**
+
+the dictionary form of the DensityMatrix.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+**Examples**
+
+The ket-form of a 2-qubit density matrix $rho = |-\rangle\!\langle -|\otimes |0\rangle\!\langle 0|$
+
+```python
+from qiskit.quantum_info import DensityMatrix
+
+rho = DensityMatrix.from_label('-0')
+print(rho.to_dict())
+```
+
+```python
+{
+ '00|00': (0.4999999999999999+0j),
+ '10|00': (-0.4999999999999999-0j),
+ '00|10': (-0.4999999999999999+0j),
+ '10|10': (0.4999999999999999+0j)
+}
+```
+
+For non-qubit subsystems the integer range can go from 0 to 9. For example in a qutrit system
+
+```python
+import numpy as np
+from qiskit.quantum_info import DensityMatrix
+
+mat = np.zeros((9, 9))
+mat[0, 0] = 0.25
+mat[3, 3] = 0.25
+mat[6, 6] = 0.25
+mat[-1, -1] = 0.25
+rho = DensityMatrix(mat, dims=(3, 3))
+print(rho.to_dict())
+```
+
+```python
+{'00|00': (0.25+0j), '10|10': (0.25+0j), '20|20': (0.25+0j), '22|22': (0.25+0j)}
+```
+
+For large subsystem dimensions delimiters are required. The following example is for a 20-dimensional system consisting of a qubit and 10-dimensional qudit.
+
+```python
+import numpy as np
+from qiskit.quantum_info import DensityMatrix
+
+mat = np.zeros((2 * 10, 2 * 10))
+mat[0, 0] = 0.5
+mat[-1, -1] = 0.5
+rho = DensityMatrix(mat, dims=(2, 10))
+print(rho.to_dict())
+```
+
+```python
+{'00|00': (0.5+0j), '91|91': (0.5+0j)}
+```
+
+### to\_operator
+
+
+
+`to_operator()`
+
+Convert to Operator
+
+**Return type**
+
+[*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.operators.operator.Operator")
+
+### to\_statevector
+
+
+
+`to_statevector(atol=None, rtol=None)`
+
+Return a statevector from a pure density matrix.
+
+**Parameters**
+
+* **atol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Absolute tolerance for checking operation validity.
+* **rtol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Relative tolerance for checking operation validity.
+
+**Returns**
+
+**The pure density matrix’s corresponding statevector.**
+
+Corresponds to the eigenvector of the only non-zero eigenvalue.
+
+**Return type**
+
+[Statevector](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the state is not pure.
+
+### trace
+
+
+
+`trace()`
+
+Return the trace of the density matrix.
+
diff --git a/docs/api/qiskit/0.46/qiskit.quantum_info.Kraus.md b/docs/api/qiskit/0.46/qiskit.quantum_info.Kraus.md
new file mode 100644
index 00000000000..3d9a6349de7
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.quantum_info.Kraus.md
@@ -0,0 +1,395 @@
+---
+title: Kraus
+description: API reference for qiskit.quantum_info.Kraus
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.quantum_info.Kraus
+---
+
+# Kraus
+
+
+
+`qiskit.quantum_info.Kraus(data, input_dims=None, output_dims=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/channel/kraus.py "view source code")
+
+Bases: `QuantumChannel`
+
+Kraus representation of a quantum channel.
+
+For a quantum channel $\mathcal{E}$, the Kraus representation is given by a set of matrices $[A_0,...,A_{K-1}]$ such that the evolution of a [`DensityMatrix`](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix") $\rho$ is given by
+
+$$
+\mathcal{E}(\rho) = \sum_{i=0}^{K-1} A_i \rho A_i^\dagger
+$$
+
+A general operator map $\mathcal{G}$ can also be written using the generalized Kraus representation which is given by two sets of matrices $[A_0,...,A_{K-1}]$, $[B_0,...,A_{B-1}]$ such that
+
+$$
+\mathcal{G}(\rho) = \sum_{i=0}^{K-1} A_i \rho B_i^\dagger
+$$
+
+See reference \[1] for further details.
+
+**References**
+
+1. C.J. Wood, J.D. Biamonte, D.G. Cory, *Tensor networks and graphical calculus for open quantum systems*, Quant. Inf. Comp. 15, 0579-0811 (2015). [arXiv:1111.6950 \[quant-ph\]](https://arxiv.org/abs/1111.6950)
+
+Initialize a quantum channel Kraus operator.
+
+**Parameters**
+
+* **data** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *|*[*circuit.instruction.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction") *| BaseOperator | np.ndarray*) – data to initialize superoperator.
+* **input\_dims** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)") *| None*) – the input subsystem dimensions.
+* **output\_dims** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)") *| None*) – the output subsystem dimensions.
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if input data cannot be initialized as a list of Kraus matrices.
+
+**Additional Information:**
+
+If the input or output dimensions are None, they will be automatically determined from the input data. If the input data is a list of Numpy arrays of shape $(2^N,\,2^N)$ qubit systems will be used. If the input does not correspond to an N-qubit channel, it will assign a single subsystem with dimension specified by the shape of the input.
+
+## Attributes
+
+
+
+### atol
+
+`= 1e-08`
+
+
+
+### data
+
+Return list of Kraus matrices for channel.
+
+
+
+### dim
+
+Return tuple (input\_shape, output\_shape).
+
+
+
+### num\_qubits
+
+Return the number of qubits if a N-qubit operator or None otherwise.
+
+
+
+### qargs
+
+Return the qargs for the operator.
+
+
+
+### rtol
+
+`= 1e-05`
+
+
+
+### settings
+
+Return settings.
+
+## Methods
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return the adjoint quantum channel.
+
+
+ This is equivalent to the matrix Hermitian conjugate in the [`SuperOp`](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") representation ie. for a channel $\mathcal{E}$, the SuperOp of the adjoint channel $\mathcal{{E}}^\dagger$ is $S_{\mathcal{E}^\dagger} = S_{\mathcal{E}}^\dagger$.
+
+
+### compose
+
+
+
+`compose(other, qargs=None, front=False)`
+
+Return the operator composition with another Kraus.
+
+**Parameters**
+
+* **other** ([*Kraus*](#qiskit.quantum_info.Kraus "qiskit.quantum_info.Kraus")) – a Kraus object.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – Optional, a list of subsystem positions to apply other on. If None apply on all subsystems (default: None).
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True compose using right operator multiplication, instead of left multiplication \[default: False].
+
+**Returns**
+
+The composed Kraus.
+
+**Return type**
+
+[Kraus](#qiskit.quantum_info.Kraus "qiskit.quantum_info.Kraus")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if other cannot be converted to an operator, or has incompatible dimensions for specified subsystems.
+
+
+ Composition (`&`) by default is defined as left matrix multiplication for matrix operators, while `@` (equivalent to [`dot()`](#qiskit.quantum_info.Kraus.dot "qiskit.quantum_info.Kraus.dot")) is defined as right matrix multiplication. That is that `A & B == A.compose(B)` is equivalent to `B @ A == B.dot(A)` when `A` and `B` are of the same type.
+
+ Setting the `front=True` kwarg changes this to right matrix multiplication and is equivalent to the [`dot()`](#qiskit.quantum_info.Kraus.dot "qiskit.quantum_info.Kraus.dot") method `A.dot(B) == A.compose(B, front=True)`.
+
+
+### conjugate
+
+
+
+`conjugate()`
+
+Return the conjugate quantum channel.
+
+
+ This is equivalent to the matrix complex conjugate in the [`SuperOp`](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") representation ie. for a channel $\mathcal{E}$, the SuperOp of the conjugate channel $\overline{{\mathcal{{E}}}}$ is $S_{\overline{\mathcal{E}^\dagger}} = \overline{S_{\mathcal{E}}}$.
+
+
+### copy
+
+
+
+`copy()`
+
+Make a deep copy of current operator.
+
+### dot
+
+
+
+`dot(other, qargs=None)`
+
+Return the right multiplied operator self \* other.
+
+**Parameters**
+
+* **other** ([*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – an operator object.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – Optional, a list of subsystem positions to apply other on. If None apply on all subsystems (default: None).
+
+**Returns**
+
+The right matrix multiplied Operator.
+
+**Return type**
+
+[Operator](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")
+
+
+ The dot product can be obtained using the `@` binary operator. Hence `a.dot(b)` is equivalent to `a @ b`.
+
+
+### expand
+
+
+
+`expand(other)`
+
+Return the reverse-order tensor product with another Kraus.
+
+**Parameters**
+
+**other** ([*Kraus*](#qiskit.quantum_info.Kraus "qiskit.quantum_info.Kraus")) – a Kraus object.
+
+**Returns**
+
+**the tensor product $b \otimes a$, where $a$**
+
+is the current Kraus, and $b$ is the other Kraus.
+
+**Return type**
+
+[Kraus](#qiskit.quantum_info.Kraus "qiskit.quantum_info.Kraus")
+
+### input\_dims
+
+
+
+`input_dims(qargs=None)`
+
+Return tuple of input dimension for specified subsystems.
+
+### is\_cp
+
+
+
+`is_cp(atol=None, rtol=None)`
+
+Test if Choi-matrix is completely-positive (CP)
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### is\_cptp
+
+
+
+`is_cptp(atol=None, rtol=None)`
+
+Return True if completely-positive trace-preserving.
+
+### is\_tp
+
+
+
+`is_tp(atol=None, rtol=None)`
+
+Test if a channel is trace-preserving (TP)
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### is\_unitary
+
+
+
+`is_unitary(atol=None, rtol=None)`
+
+Return True if QuantumChannel is a unitary channel.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### output\_dims
+
+
+
+`output_dims(qargs=None)`
+
+Return tuple of output dimension for specified subsystems.
+
+### power
+
+
+
+`power(n)`
+
+Return the power of the quantum channel.
+
+**Parameters**
+
+**n** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the power exponent.
+
+**Returns**
+
+the channel $\mathcal{{E}} ^n$.
+
+**Return type**
+
+[SuperOp](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input and output dimensions of the SuperOp are not equal.
+
+
+ For non-positive or non-integer exponents the power is defined as the matrix power of the [`SuperOp`](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") representation ie. for a channel $\mathcal{{E}}$, the SuperOp of the powered channel $\mathcal{{E}}^\n$ is $S_{{\mathcal{{E}}^n}} = S_{{\mathcal{{E}}}}^n$.
+
+
+### reshape
+
+
+
+`reshape(input_dims=None, output_dims=None, num_qubits=None)`
+
+Return a shallow copy with reshaped input and output subsystem dimensions.
+
+**Parameters**
+
+* **input\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem input dimensions. If None the original input dims will be preserved \[Default: None].
+* **output\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem output dimensions. If None the original output dims will be preserved \[Default: None].
+* **num\_qubits** (*None or* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – reshape to an N-qubit operator \[Default: None].
+
+**Returns**
+
+returns self with reshaped input and output dimensions.
+
+**Return type**
+
+BaseOperator
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if combined size of all subsystem input dimension or subsystem output dimensions is not constant.
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return the tensor product with another Kraus.
+
+**Parameters**
+
+**other** ([*Kraus*](#qiskit.quantum_info.Kraus "qiskit.quantum_info.Kraus")) – a Kraus object.
+
+**Returns**
+
+**the tensor product $a \otimes b$, where $a$**
+
+is the current Kraus, and $b$ is the other Kraus.
+
+**Return type**
+
+[Kraus](#qiskit.quantum_info.Kraus "qiskit.quantum_info.Kraus")
+
+
+ The tensor product can be obtained using the `^` binary operator. Hence `a.tensor(b)` is equivalent to `a ^ b`.
+
+
+### to\_instruction
+
+
+
+`to_instruction()`
+
+Convert to a Kraus or UnitaryGate circuit instruction.
+
+If the channel is unitary it will be added as a unitary gate, otherwise it will be added as a kraus simulator instruction.
+
+**Returns**
+
+A kraus instruction for the channel.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if input data is not an N-qubit CPTP quantum channel.
+
+### to\_operator
+
+
+
+`to_operator()`
+
+Try to convert channel to a unitary representation Operator.
+
+**Return type**
+
+[*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.operators.operator.Operator")
+
+### transpose
+
+
+
+`transpose()`
+
+Return the transpose quantum channel.
+
+
+ This is equivalent to the matrix transpose in the [`SuperOp`](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") representation, ie. for a channel $\mathcal{E}$, the SuperOp of the transpose channel $\mathcal{{E}}^T$ is $S_{mathcal{E}^T} = S_{\mathcal{E}}^T$.
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.quantum_info.Operator.md b/docs/api/qiskit/0.46/qiskit.quantum_info.Operator.md
new file mode 100644
index 00000000000..fe2ac5fcdff
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.quantum_info.Operator.md
@@ -0,0 +1,488 @@
+---
+title: Operator
+description: API reference for qiskit.quantum_info.Operator
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.quantum_info.Operator
+---
+
+# Operator
+
+
+
+`qiskit.quantum_info.Operator(data, input_dims=None, output_dims=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/operator.py "view source code")
+
+Bases: `LinearOp`
+
+Matrix operator class
+
+This represents a matrix operator $M$ that will [`evolve()`](qiskit.quantum_info.Statevector#evolve "qiskit.quantum_info.Statevector.evolve") a [`Statevector`](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") $|\psi\rangle$ by matrix-vector multiplication
+
+$$
+|\psi\rangle \mapsto M|\psi\rangle,
+$$
+
+and will [`evolve()`](qiskit.quantum_info.DensityMatrix#evolve "qiskit.quantum_info.DensityMatrix.evolve") a [`DensityMatrix`](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix") $\rho$ by left and right multiplication
+
+$$
+\rho \mapsto M \rho M^\dagger.
+$$
+
+Initialize an operator object.
+
+**Parameters**
+
+* **data** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Operation*](qiskit.circuit.Operation "qiskit.circuit.Operation") *or BaseOperator or matrix*) – data to initialize operator.
+* **input\_dims** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the input subsystem dimensions. \[Default: None]
+* **output\_dims** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the output subsystem dimensions. \[Default: None]
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if input data cannot be initialized as an operator.
+
+**Additional Information:**
+
+If the input or output dimensions are None, they will be automatically determined from the input data. If the input data is a Numpy array of shape (2\*\*N, 2\*\*N) qubit systems will be used. If the input operator is not an N-qubit operator, it will assign a single subsystem with dimension specified by the shape of the input.
+
+## Attributes
+
+
+
+### atol
+
+`= 1e-08`
+
+
+
+### data
+
+The underlying Numpy array.
+
+
+
+### dim
+
+Return tuple (input\_shape, output\_shape).
+
+
+
+### num\_qubits
+
+Return the number of qubits if a N-qubit operator or None otherwise.
+
+
+
+### qargs
+
+Return the qargs for the operator.
+
+
+
+### rtol
+
+`= 1e-05`
+
+
+
+### settings
+
+Return operator settings.
+
+## Methods
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return the adjoint of the Operator.
+
+**Return type**
+
+*Self*
+
+### apply\_permutation
+
+
+
+`apply_permutation(perm, front=False)`
+
+Modifies operator’s data by composing it with a permutation.
+
+**Parameters**
+
+* **perm** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – permutation pattern, describing which qubits occupy the positions 0, 1, 2, etc. after applying the permutation.
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – When set to `True` the permutation is applied before the operator, when set to `False` the permutation is applied after the operator.
+
+**Returns**
+
+The modified operator.
+
+**Return type**
+
+[Operator](#qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the size of the permutation pattern does not match the dimensions of the operator.
+
+### compose
+
+
+
+`compose(other, qargs=None, front=False)`
+
+Return the operator composition with another Operator.
+
+**Parameters**
+
+* **other** ([*Operator*](#qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – a Operator object.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – Optional, a list of subsystem positions to apply other on. If None apply on all subsystems (default: None).
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True compose using right operator multiplication, instead of left multiplication \[default: False].
+
+**Returns**
+
+The composed Operator.
+
+**Return type**
+
+[Operator](#qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if other cannot be converted to an operator, or has incompatible dimensions for specified subsystems.
+
+
+ Composition (`&`) by default is defined as left matrix multiplication for matrix operators, while `@` (equivalent to [`dot()`](#qiskit.quantum_info.Operator.dot "qiskit.quantum_info.Operator.dot")) is defined as right matrix multiplication. That is that `A & B == A.compose(B)` is equivalent to `B @ A == B.dot(A)` when `A` and `B` are of the same type.
+
+ Setting the `front=True` kwarg changes this to right matrix multiplication and is equivalent to the [`dot()`](#qiskit.quantum_info.Operator.dot "qiskit.quantum_info.Operator.dot") method `A.dot(B) == A.compose(B, front=True)`.
+
+
+### conjugate
+
+
+
+`conjugate()`
+
+Return the conjugate of the Operator.
+
+### copy
+
+
+
+`copy()`
+
+Make a deep copy of current operator.
+
+### dot
+
+
+
+`dot(other, qargs=None)`
+
+Return the right multiplied operator self \* other.
+
+**Parameters**
+
+* **other** ([*Operator*](#qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – an operator object.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – Optional, a list of subsystem positions to apply other on. If None apply on all subsystems (default: None).
+
+**Returns**
+
+The right matrix multiplied Operator.
+
+**Return type**
+
+[Operator](#qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")
+
+
+ The dot product can be obtained using the `@` binary operator. Hence `a.dot(b)` is equivalent to `a @ b`.
+
+
+### draw
+
+
+
+`draw(output=None, **drawer_args)`
+
+Return a visualization of the Operator.
+
+**repr**: String of the state’s `__repr__`.
+
+**text**: ASCII TextMatrix that can be printed in the console.
+
+**latex**: An IPython Latex object for displaying in Jupyter Notebooks.
+
+**latex\_source**: Raw, uncompiled ASCII source to generate array using LaTeX.
+
+**Parameters**
+
+* **output** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Select the output method to use for drawing the state. Valid choices are repr, text, latex, latex\_source, Default is repr.
+* **drawer\_args** – Arguments to be passed directly to the relevant drawing function or constructor (TextMatrix(), array\_to\_latex()). See the relevant function under qiskit.visualization for that function’s documentation.
+
+**Returns**
+
+Drawing of the Operator.
+
+**Return type**
+
+[`str`](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") or `TextMatrix` or `IPython.display.Latex`
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – when an invalid output method is selected.
+
+### equiv
+
+
+
+`equiv(other, rtol=None, atol=None)`
+
+Return True if operators are equivalent up to global phase.
+
+**Parameters**
+
+* **other** ([*Operator*](#qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – an operator object.
+* **rtol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – relative tolerance value for comparison.
+* **atol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – absolute tolerance value for comparison.
+
+**Returns**
+
+True if operators are equivalent up to global phase.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### expand
+
+
+
+`expand(other)`
+
+Return the reverse-order tensor product with another Operator.
+
+**Parameters**
+
+**other** ([*Operator*](#qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – a Operator object.
+
+**Returns**
+
+**the tensor product $b \otimes a$, where $a$**
+
+is the current Operator, and $b$ is the other Operator.
+
+**Return type**
+
+[Operator](#qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")
+
+### from\_circuit
+
+
+
+`classmethod from_circuit(circuit, ignore_set_layout=False, layout=None, final_layout=None)`
+
+Create a new Operator object from a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+While a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") object can passed directly as `data` to the class constructor this provides no options on how the circuit is used to create an [`Operator`](#qiskit.quantum_info.Operator "qiskit.quantum_info.Operator"). This constructor method lets you control how the [`Operator`](#qiskit.quantum_info.Operator "qiskit.quantum_info.Operator") is created so it can be adjusted for a particular use case.
+
+By default this constructor method will permute the qubits based on a configured initial layout (i.e. after it was transpiled). It also provides an option to manually provide a [`Layout`](qiskit.transpiler.Layout "qiskit.transpiler.Layout") object directly.
+
+**Parameters**
+
+* **circuit** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – The [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") to create an Operator object from.
+* **ignore\_set\_layout** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – When set to `True` if the input `circuit` has a layout set it will be ignored
+* **layout** ([*Layout*](qiskit.transpiler.Layout "qiskit.transpiler.Layout")) – If specified this kwarg can be used to specify a particular layout to use to permute the qubits in the created [`Operator`](#qiskit.quantum_info.Operator "qiskit.quantum_info.Operator"). If this is specified it will be used instead of a layout contained in the `circuit` input. If specified the virtual bits in the [`Layout`](qiskit.transpiler.Layout "qiskit.transpiler.Layout") must be present in the `circuit` input.
+* **final\_layout** ([*Layout*](qiskit.transpiler.Layout "qiskit.transpiler.Layout")) – If specified this kwarg can be used to represent the output permutation caused by swap insertions during the routing stage of the transpiler.
+
+**Returns**
+
+An operator representing the input circuit
+
+**Return type**
+
+[Operator](#qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")
+
+### from\_label
+
+
+
+`classmethod from_label(label)`
+
+Return a tensor product of single-qubit operators.
+
+**Parameters**
+
+**label** (*string*) – single-qubit operator string.
+
+**Returns**
+
+The N-qubit operator.
+
+**Return type**
+
+[Operator](#qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the label contains invalid characters, or the length of the label is larger than an explicitly specified num\_qubits.
+
+**Additional Information:**
+
+The labels correspond to the single-qubit matrices: ‘I’: \[\[1, 0], \[0, 1]] ‘X’: \[\[0, 1], \[1, 0]] ‘Y’: \[\[0, -1j], \[1j, 0]] ‘Z’: \[\[1, 0], \[0, -1]] ‘H’: \[\[1, 1], \[1, -1]] / sqrt(2) ‘S’: \[\[1, 0], \[0 , 1j]] ‘T’: \[\[1, 0], \[0, (1+1j) / sqrt(2)]] ‘0’: \[\[1, 0], \[0, 0]] ‘1’: \[\[0, 0], \[0, 1]] ‘+’: \[\[0.5, 0.5], \[0.5 , 0.5]] ‘-’: \[\[0.5, -0.5], \[-0.5 , 0.5]] ‘r’: \[\[0.5, -0.5j], \[0.5j , 0.5]] ‘l’: \[\[0.5, 0.5j], \[-0.5j , 0.5]]
+
+### input\_dims
+
+
+
+`input_dims(qargs=None)`
+
+Return tuple of input dimension for specified subsystems.
+
+### is\_unitary
+
+
+
+`is_unitary(atol=None, rtol=None)`
+
+Return True if operator is a unitary matrix.
+
+### output\_dims
+
+
+
+`output_dims(qargs=None)`
+
+Return tuple of output dimension for specified subsystems.
+
+### power
+
+
+
+`power(n)`
+
+Return the matrix power of the operator.
+
+**Parameters**
+
+**n** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the power to raise the matrix to.
+
+**Returns**
+
+the resulting operator `O ** n`.
+
+**Return type**
+
+[Operator](#qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input and output dimensions of the operator are not equal.
+
+### reshape
+
+
+
+`reshape(input_dims=None, output_dims=None, num_qubits=None)`
+
+Return a shallow copy with reshaped input and output subsystem dimensions.
+
+**Parameters**
+
+* **input\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem input dimensions. If None the original input dims will be preserved \[Default: None].
+* **output\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem output dimensions. If None the original output dims will be preserved \[Default: None].
+* **num\_qubits** (*None or* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – reshape to an N-qubit operator \[Default: None].
+
+**Returns**
+
+returns self with reshaped input and output dimensions.
+
+**Return type**
+
+BaseOperator
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if combined size of all subsystem input dimension or subsystem output dimensions is not constant.
+
+### reverse\_qargs
+
+
+
+`reverse_qargs()`
+
+Return an Operator with reversed subsystem ordering.
+
+For a tensor product operator this is equivalent to reversing the order of tensor product subsystems. For an operator $A = A_{n-1} \otimes ... \otimes A_0$ the returned operator will be $A_0 \otimes ... \otimes A_{n-1}$.
+
+**Returns**
+
+the operator with reversed subsystem order.
+
+**Return type**
+
+[Operator](#qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return the tensor product with another Operator.
+
+**Parameters**
+
+**other** ([*Operator*](#qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – a Operator object.
+
+**Returns**
+
+**the tensor product $a \otimes b$, where $a$**
+
+is the current Operator, and $b$ is the other Operator.
+
+**Return type**
+
+[Operator](#qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")
+
+
+ The tensor product can be obtained using the `^` binary operator. Hence `a.tensor(b)` is equivalent to `a ^ b`.
+
+
+### to\_instruction
+
+
+
+`to_instruction()`
+
+Convert to a UnitaryGate instruction.
+
+### to\_matrix
+
+
+
+`to_matrix()`
+
+Convert operator to NumPy matrix.
+
+### to\_operator
+
+
+
+`to_operator()`
+
+Convert operator to matrix operator class
+
+**Return type**
+
+[*Operator*](#qiskit.quantum_info.Operator "qiskit.quantum_info.operators.operator.Operator")
+
+### transpose
+
+
+
+`transpose()`
+
+Return the transpose of the Operator.
+
diff --git a/docs/api/qiskit/0.46/qiskit.quantum_info.PTM.md b/docs/api/qiskit/0.46/qiskit.quantum_info.PTM.md
new file mode 100644
index 00000000000..4731d769bb8
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.quantum_info.PTM.md
@@ -0,0 +1,403 @@
+---
+title: PTM
+description: API reference for qiskit.quantum_info.PTM
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.quantum_info.PTM
+---
+
+# PTM
+
+
+
+`qiskit.quantum_info.PTM(data, input_dims=None, output_dims=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/channel/ptm.py "view source code")
+
+Bases: `QuantumChannel`
+
+Pauli Transfer Matrix (PTM) representation of a Quantum Channel.
+
+The PTM representation of an $n$-qubit quantum channel $\mathcal{E}$ is an $n$-qubit [`SuperOp`](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") $R$ defined with respect to vectorization in the Pauli basis instead of column-vectorization. The elements of the PTM $R$ are given by
+
+$$
+R_{i,j} = \frac{1}{2^n} \mbox{Tr}\left[P_i \mathcal{E}(P_j) \right]
+$$
+
+where $[P_0, P_1, ..., P_{4^{n}-1}]$ is the $n$-qubit Pauli basis in lexicographic order.
+
+Evolution of a [`DensityMatrix`](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix") $\rho$ with respect to the PTM is given by
+
+$$
+|\mathcal{E}(\rho)\rangle\!\rangle_P = S_P |\rho\rangle\!\rangle_P
+$$
+
+where $|A\rangle\!\rangle_P$ denotes vectorization in the Pauli basis $\langle i | A\rangle\!\rangle_P = \sqrt{\frac{1}{2^n}} \mbox{Tr}[P_i A]$.
+
+See reference \[1] for further details.
+
+**References**
+
+1. C.J. Wood, J.D. Biamonte, D.G. Cory, *Tensor networks and graphical calculus for open quantum systems*, Quant. Inf. Comp. 15, 0579-0811 (2015). [arXiv:1111.6950 \[quant-ph\]](https://arxiv.org/abs/1111.6950)
+
+Initialize a PTM quantum channel operator.
+
+**Parameters**
+
+* **or** (*data (*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – Instruction or BaseOperator or matrix): data to initialize superoperator.
+* **input\_dims** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the input subsystem dimensions. \[Default: None]
+* **output\_dims** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the output subsystem dimensions. \[Default: None]
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if input data is not an N-qubit channel or cannot be initialized as a PTM.
+
+**Additional Information:**
+
+If the input or output dimensions are None, they will be automatically determined from the input data. The PTM representation is only valid for N-qubit channels.
+
+## Attributes
+
+
+
+### atol
+
+`= 1e-08`
+
+
+
+### data
+
+Return data.
+
+
+
+### dim
+
+Return tuple (input\_shape, output\_shape).
+
+
+
+### num\_qubits
+
+Return the number of qubits if a N-qubit operator or None otherwise.
+
+
+
+### qargs
+
+Return the qargs for the operator.
+
+
+
+### rtol
+
+`= 1e-05`
+
+
+
+### settings
+
+Return settings.
+
+## Methods
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return the adjoint quantum channel.
+
+
+ This is equivalent to the matrix Hermitian conjugate in the [`SuperOp`](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") representation ie. for a channel $\mathcal{E}$, the SuperOp of the adjoint channel $\mathcal{{E}}^\dagger$ is $S_{\mathcal{E}^\dagger} = S_{\mathcal{E}}^\dagger$.
+
+
+### compose
+
+
+
+`compose(other, qargs=None, front=False)`
+
+Return the operator composition with another PTM.
+
+**Parameters**
+
+* **other** ([*PTM*](#qiskit.quantum_info.PTM "qiskit.quantum_info.PTM")) – a PTM object.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – Optional, a list of subsystem positions to apply other on. If None apply on all subsystems (default: None).
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True compose using right operator multiplication, instead of left multiplication \[default: False].
+
+**Returns**
+
+The composed PTM.
+
+**Return type**
+
+[PTM](#qiskit.quantum_info.PTM "qiskit.quantum_info.PTM")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if other cannot be converted to an operator, or has incompatible dimensions for specified subsystems.
+
+
+ Composition (`&`) by default is defined as left matrix multiplication for matrix operators, while `@` (equivalent to [`dot()`](#qiskit.quantum_info.PTM.dot "qiskit.quantum_info.PTM.dot")) is defined as right matrix multiplication. That is that `A & B == A.compose(B)` is equivalent to `B @ A == B.dot(A)` when `A` and `B` are of the same type.
+
+ Setting the `front=True` kwarg changes this to right matrix multiplication and is equivalent to the [`dot()`](#qiskit.quantum_info.PTM.dot "qiskit.quantum_info.PTM.dot") method `A.dot(B) == A.compose(B, front=True)`.
+
+
+### conjugate
+
+
+
+`conjugate()`
+
+Return the conjugate quantum channel.
+
+
+ This is equivalent to the matrix complex conjugate in the [`SuperOp`](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") representation ie. for a channel $\mathcal{E}$, the SuperOp of the conjugate channel $\overline{{\mathcal{{E}}}}$ is $S_{\overline{\mathcal{E}^\dagger}} = \overline{S_{\mathcal{E}}}$.
+
+
+### copy
+
+
+
+`copy()`
+
+Make a deep copy of current operator.
+
+### dot
+
+
+
+`dot(other, qargs=None)`
+
+Return the right multiplied operator self \* other.
+
+**Parameters**
+
+* **other** ([*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – an operator object.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – Optional, a list of subsystem positions to apply other on. If None apply on all subsystems (default: None).
+
+**Returns**
+
+The right matrix multiplied Operator.
+
+**Return type**
+
+[Operator](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")
+
+
+ The dot product can be obtained using the `@` binary operator. Hence `a.dot(b)` is equivalent to `a @ b`.
+
+
+### expand
+
+
+
+`expand(other)`
+
+Return the reverse-order tensor product with another PTM.
+
+**Parameters**
+
+**other** ([*PTM*](#qiskit.quantum_info.PTM "qiskit.quantum_info.PTM")) – a PTM object.
+
+**Returns**
+
+**the tensor product $b \otimes a$, where $a$**
+
+is the current PTM, and $b$ is the other PTM.
+
+**Return type**
+
+[PTM](#qiskit.quantum_info.PTM "qiskit.quantum_info.PTM")
+
+### input\_dims
+
+
+
+`input_dims(qargs=None)`
+
+Return tuple of input dimension for specified subsystems.
+
+### is\_cp
+
+
+
+`is_cp(atol=None, rtol=None)`
+
+Test if Choi-matrix is completely-positive (CP)
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### is\_cptp
+
+
+
+`is_cptp(atol=None, rtol=None)`
+
+Return True if completely-positive trace-preserving (CPTP).
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### is\_tp
+
+
+
+`is_tp(atol=None, rtol=None)`
+
+Test if a channel is trace-preserving (TP)
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### is\_unitary
+
+
+
+`is_unitary(atol=None, rtol=None)`
+
+Return True if QuantumChannel is a unitary channel.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### output\_dims
+
+
+
+`output_dims(qargs=None)`
+
+Return tuple of output dimension for specified subsystems.
+
+### power
+
+
+
+`power(n)`
+
+Return the power of the quantum channel.
+
+**Parameters**
+
+**n** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the power exponent.
+
+**Returns**
+
+the channel $\mathcal{{E}} ^n$.
+
+**Return type**
+
+[SuperOp](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input and output dimensions of the SuperOp are not equal.
+
+
+ For non-positive or non-integer exponents the power is defined as the matrix power of the [`SuperOp`](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") representation ie. for a channel $\mathcal{{E}}$, the SuperOp of the powered channel $\mathcal{{E}}^\n$ is $S_{{\mathcal{{E}}^n}} = S_{{\mathcal{{E}}}}^n$.
+
+
+### reshape
+
+
+
+`reshape(input_dims=None, output_dims=None, num_qubits=None)`
+
+Return a shallow copy with reshaped input and output subsystem dimensions.
+
+**Parameters**
+
+* **input\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem input dimensions. If None the original input dims will be preserved \[Default: None].
+* **output\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem output dimensions. If None the original output dims will be preserved \[Default: None].
+* **num\_qubits** (*None or* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – reshape to an N-qubit operator \[Default: None].
+
+**Returns**
+
+returns self with reshaped input and output dimensions.
+
+**Return type**
+
+BaseOperator
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if combined size of all subsystem input dimension or subsystem output dimensions is not constant.
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return the tensor product with another PTM.
+
+**Parameters**
+
+**other** ([*PTM*](#qiskit.quantum_info.PTM "qiskit.quantum_info.PTM")) – a PTM object.
+
+**Returns**
+
+**the tensor product $a \otimes b$, where $a$**
+
+is the current PTM, and $b$ is the other PTM.
+
+**Return type**
+
+[PTM](#qiskit.quantum_info.PTM "qiskit.quantum_info.PTM")
+
+
+ The tensor product can be obtained using the `^` binary operator. Hence `a.tensor(b)` is equivalent to `a ^ b`.
+
+
+### to\_instruction
+
+
+
+`to_instruction()`
+
+Convert to a Kraus or UnitaryGate circuit instruction.
+
+If the channel is unitary it will be added as a unitary gate, otherwise it will be added as a kraus simulator instruction.
+
+**Returns**
+
+A kraus instruction for the channel.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if input data is not an N-qubit CPTP quantum channel.
+
+### to\_operator
+
+
+
+`to_operator()`
+
+Try to convert channel to a unitary representation Operator.
+
+**Return type**
+
+[*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.operators.operator.Operator")
+
+### transpose
+
+
+
+`transpose()`
+
+Return the transpose quantum channel.
+
+
+ This is equivalent to the matrix transpose in the [`SuperOp`](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") representation, ie. for a channel $\mathcal{E}$, the SuperOp of the transpose channel $\mathcal{{E}}^T$ is $S_{mathcal{E}^T} = S_{\mathcal{E}}^T$.
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.quantum_info.Pauli.md b/docs/api/qiskit/0.46/qiskit.quantum_info.Pauli.md
new file mode 100644
index 00000000000..7200a492d18
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.quantum_info.Pauli.md
@@ -0,0 +1,589 @@
+---
+title: Pauli
+description: API reference for qiskit.quantum_info.Pauli
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.quantum_info.Pauli
+---
+
+# Pauli
+
+
+
+`qiskit.quantum_info.Pauli(data=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/symplectic/pauli.py "view source code")
+
+Bases: `BasePauli`
+
+N-qubit Pauli operator.
+
+This class represents an operator $P$ from the full $n$-qubit *Pauli* group
+
+$$
+P = (-i)^{q} P_{n-1} \otimes ... \otimes P_{0}
+$$
+
+where $q\in \mathbb{Z}_4$ and $P_i \in \{I, X, Y, Z\}$ are single-qubit Pauli matrices:
+
+$$
+I = \begin{pmatrix} 1 & 0 \\ 0 & 1 \end{pmatrix},
+X = \begin{pmatrix} 0 & 1 \\ 1 & 0 \end{pmatrix},
+Y = \begin{pmatrix} 0 & -i \\ i & 0 \end{pmatrix},
+Z = \begin{pmatrix} 1 & 0 \\ 0 & -1 \end{pmatrix}.
+$$
+
+**Initialization**
+
+A Pauli object can be initialized in several ways:
+
+> **`Pauli(obj)`**
+>
+> where `obj` is a Pauli string, `Pauli` or [`ScalarOp`](qiskit.quantum_info.ScalarOp "qiskit.quantum_info.ScalarOp") operator, or a Pauli gate or `QuantumCircuit` containing only Pauli gates.
+>
+> **`Pauli((z, x, phase))`**
+>
+> where `z` and `x` are boolean `numpy.ndarrays` and `phase` is an integer in `[0, 1, 2, 3]`.
+>
+> **`Pauli((z, x))`**
+>
+> equivalent to `Pauli((z, x, 0))` with trivial phase.
+
+**String representation**
+
+An $n$-qubit Pauli may be represented by a string consisting of $n$ characters from `['I', 'X', 'Y', 'Z']`, and optionally phase coefficient in $['', '-i', '-', 'i']$. For example: `XYZ` or `'-iZIZ'`.
+
+In the string representation qubit-0 corresponds to the right-most Pauli character, and qubit-$(n-1)$ to the left-most Pauli character. For example `'XYZ'` represents $X\otimes Y \otimes Z$ with `'Z'` on qubit-0, `'Y'` on qubit-1, and `'X'` on qubit-2.
+
+The string representation can be converted to a `Pauli` using the class initialization (`Pauli('-iXYZ')`). A `Pauli` object can be converted back to the string representation using the [`to_label()`](#qiskit.quantum_info.Pauli.to_label "qiskit.quantum_info.Pauli.to_label") method or `str(pauli)`.
+
+
+ Using `str` to convert a `Pauli` to a string will truncate the returned string for large numbers of qubits while [`to_label()`](#qiskit.quantum_info.Pauli.to_label "qiskit.quantum_info.Pauli.to_label") will return the full string with no truncation. The default truncation length is 50 characters. The default value can be changed by setting the class `__truncate__` attribute to an integer value. If set to `0` no truncation will be performed.
+
+
+**Array Representation**
+
+The internal data structure of an $n$-qubit Pauli is two length-$n$ boolean vectors $z \in \mathbb{Z}_2^N$, $x \in \mathbb{Z}_2^N$, and an integer $q \in \mathbb{Z}_4$ defining the Pauli operator
+
+$$
+P = (-i)^{q + z\cdot x} Z^z \cdot X^x.
+$$
+
+The $k$-th qubit corresponds to the $k$-th entry in the $z$ and $x$ arrays
+
+$$
+\begin{aligned}
+P &= P_{n-1} \otimes ... \otimes P_{0} \\
+P_k &= (-i)^{z[k] * x[k]} Z^{z[k]}\cdot X^{x[k]}
+\end{aligned}
+$$
+
+where `z[k] = P.z[k]`, `x[k] = P.x[k]` respectively.
+
+The $z$ and $x$ arrays can be accessed and updated using the [`z`](#qiskit.quantum_info.Pauli.z "qiskit.quantum_info.Pauli.z") and [`x`](#qiskit.quantum_info.Pauli.x "qiskit.quantum_info.Pauli.x") properties respectively. The phase integer $q$ can be accessed and updated using the [`phase`](#qiskit.quantum_info.Pauli.phase "qiskit.quantum_info.Pauli.phase") property.
+
+**Matrix Operator Representation**
+
+Pauli’s can be converted to $(2^n, 2^n)$ [`Operator`](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator") using the `to_operator()` method, or to a dense or sparse complex matrix using the [`to_matrix()`](#qiskit.quantum_info.Pauli.to_matrix "qiskit.quantum_info.Pauli.to_matrix") method.
+
+**Data Access**
+
+The individual qubit Paulis can be accessed and updated using the `[]` operator which accepts integer, lists, or slices for selecting subsets of Paulis. Note that selecting subsets of Pauli’s will discard the phase of the current Pauli.
+
+For example
+
+```python
+p = Pauli('-iXYZ')
+
+print('P[0] =', repr(P[0]))
+print('P[1] =', repr(P[1]))
+print('P[2] =', repr(P[2]))
+print('P[:] =', repr(P[:]))
+print('P[::-1] =, repr(P[::-1]))
+```
+
+Initialize the Pauli.
+
+When using the symplectic array input data both z and x arguments must be provided, however the first (z) argument can be used alone for string label, Pauli operator, or ScalarOp input data.
+
+**Parameters**
+
+**data** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)") *or*[*Pauli*](#qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli") *or*[*ScalarOp*](qiskit.quantum_info.ScalarOp "qiskit.quantum_info.ScalarOp")) – input data for Pauli. If input is a tuple it must be of the form `(z, x)` or (z, x, phase)\`\` where `z` and `x` are boolean Numpy arrays, and phase is an integer from Z\_4. If input is a string, it must be a concatenation of a phase and a Pauli string (e.g. ‘XYZ’, ‘-iZIZ’) where a phase string is a combination of at most three characters from \[‘+’, ‘-’, ‘’], \[‘1’, ‘’], and \[‘i’, ‘j’, ‘’] in this order, e.g. ‘’, ‘-1j’ while a Pauli string is 1 or more characters of ‘I’, ‘X’, ‘Y’ or ‘Z’, e.g. ‘Z’, ‘XIYY’.
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if input array is invalid shape.
+
+## Attributes
+
+
+
+### dim
+
+Return tuple (input\_shape, output\_shape).
+
+
+
+### name
+
+Unique string identifier for operation type.
+
+
+
+### num\_clbits
+
+Number of classical bits.
+
+
+
+### num\_qubits
+
+Return the number of qubits if a N-qubit operator or None otherwise.
+
+
+
+### phase
+
+Return the group phase exponent for the Pauli.
+
+
+
+### qargs
+
+Return the qargs for the operator.
+
+
+
+### settings
+
+Return settings.
+
+
+
+### x
+
+The x vector for the Pauli.
+
+
+
+### z
+
+The z vector for the Pauli.
+
+## Methods
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return the adjoint of the Operator.
+
+### anticommutes
+
+
+
+`anticommutes(other, qargs=None)`
+
+Return True if other Pauli anticommutes with self.
+
+**Parameters**
+
+* **other** ([*Pauli*](#qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli")) – another Pauli operator.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – qubits to apply dot product on (default: None).
+
+**Returns**
+
+True if Pauli’s anticommute, False if they commute.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### commutes
+
+
+
+`commutes(other, qargs=None)`
+
+Return True if the Pauli commutes with other.
+
+**Parameters**
+
+* **other** ([*Pauli*](#qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli") *or*[*PauliList*](qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")) – another Pauli operator.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – qubits to apply dot product on (default: None).
+
+**Returns**
+
+True if Pauli’s commute, False if they anti-commute.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### compose
+
+
+
+`compose(other, qargs=None, front=False, inplace=False)`
+
+Return the operator composition with another Pauli.
+
+**Parameters**
+
+* **other** ([*Pauli*](#qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli")) – a Pauli object.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – Optional, qubits to apply dot product on (default: None).
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True compose using right operator multiplication, instead of left multiplication \[default: False].
+* **inplace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True update in-place (default: False).
+
+**Returns**
+
+The composed Pauli.
+
+**Return type**
+
+[Pauli](#qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if other cannot be converted to an operator, or has incompatible dimensions for specified subsystems.
+
+
+ Composition (`&`) by default is defined as left matrix multiplication for matrix operators, while [`dot()`](#qiskit.quantum_info.Pauli.dot "qiskit.quantum_info.Pauli.dot") is defined as right matrix multiplication. That is that `A & B == A.compose(B)` is equivalent to `B.dot(A)` when `A` and `B` are of the same type.
+
+ Setting the `front=True` kwarg changes this to right matrix multiplication and is equivalent to the [`dot()`](#qiskit.quantum_info.Pauli.dot "qiskit.quantum_info.Pauli.dot") method `A.dot(B) == A.compose(B, front=True)`.
+
+
+### conjugate
+
+
+
+`conjugate()`
+
+Return the conjugate of each Pauli in the list.
+
+### copy
+
+
+
+`copy()`
+
+Make a deep copy of current operator.
+
+### delete
+
+
+
+`delete(qubits)`
+
+Return a Pauli with qubits deleted.
+
+**Parameters**
+
+**qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – qubits to delete from Pauli.
+
+**Returns**
+
+the resulting Pauli with the specified qubits removed.
+
+**Return type**
+
+[Pauli](#qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if ind is out of bounds for the array size or number of qubits.
+
+### dot
+
+
+
+`dot(other, qargs=None, inplace=False)`
+
+Return the right multiplied operator self \* other.
+
+**Parameters**
+
+* **other** ([*Pauli*](#qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli")) – an operator object.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – Optional, qubits to apply dot product on (default: None).
+* **inplace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True update in-place (default: False).
+
+**Returns**
+
+The operator self \* other.
+
+**Return type**
+
+[Pauli](#qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli")
+
+### equiv
+
+
+
+`equiv(other)`
+
+Return True if Pauli’s are equivalent up to group phase.
+
+**Parameters**
+
+**other** ([*Pauli*](#qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli")) – an operator object.
+
+**Returns**
+
+True if the Pauli’s are equivalent up to group phase.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### evolve
+
+
+
+`evolve(other, qargs=None, frame='h')`
+
+Performs either Heisenberg (default) or Schrödinger picture evolution of the Pauli by a Clifford and returns the evolved Pauli.
+
+Schrödinger picture evolution can be chosen by passing parameter `frame='s'`. This option yields a faster calculation.
+
+Heisenberg picture evolves the Pauli as $P^\prime = C^\dagger.P.C$.
+
+Schrödinger picture evolves the Pauli as $P^\prime = C.P.C^\dagger$.
+
+**Parameters**
+
+* **other** ([*Pauli*](#qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli") *or*[*Clifford*](qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford") *or*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – The Clifford operator to evolve by.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – a list of qubits to apply the Clifford to.
+* **frame** (*string*) – `'h'` for Heisenberg (default) or `'s'` for
+* **framework.** (*Schrödinger*) –
+
+**Returns**
+
+the Pauli $C^\dagger.P.C$ (Heisenberg picture) or the Pauli $C.P.C^\dagger$ (Schrödinger picture).
+
+**Return type**
+
+[Pauli](#qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the Clifford number of qubits and qargs don’t match.
+
+### expand
+
+
+
+`expand(other)`
+
+Return the reverse-order tensor product with another Pauli.
+
+**Parameters**
+
+**other** ([*Pauli*](#qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli")) – a Pauli object.
+
+**Returns**
+
+**the tensor product $b \otimes a$, where $a$**
+
+is the current Pauli, and $b$ is the other Pauli.
+
+**Return type**
+
+[Pauli](#qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli")
+
+### input\_dims
+
+
+
+`input_dims(qargs=None)`
+
+Return tuple of input dimension for specified subsystems.
+
+### insert
+
+
+
+`insert(qubits, value)`
+
+Insert a Pauli at specific qubit value.
+
+**Parameters**
+
+* **qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – qubits index to insert at.
+* **value** ([*Pauli*](#qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli")) – value to insert.
+
+**Returns**
+
+the resulting Pauli with the entries inserted.
+
+**Return type**
+
+[Pauli](#qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the insertion qubits are invalid.
+
+### inverse
+
+
+
+`inverse()`
+
+Return the inverse of the Pauli.
+
+### output\_dims
+
+
+
+`output_dims(qargs=None)`
+
+Return tuple of output dimension for specified subsystems.
+
+### power
+
+
+
+`power(n)`
+
+Return the compose of a operator with itself n times.
+
+**Parameters**
+
+**n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of times to compose with self (n>0).
+
+**Returns**
+
+the n-times composed operator.
+
+**Return type**
+
+[Clifford](qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input and output dimensions of the operator are not equal, or the power is not a positive integer.
+
+### reshape
+
+
+
+`reshape(input_dims=None, output_dims=None, num_qubits=None)`
+
+Return a shallow copy with reshaped input and output subsystem dimensions.
+
+**Parameters**
+
+* **input\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem input dimensions. If None the original input dims will be preserved \[Default: None].
+* **output\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem output dimensions. If None the original output dims will be preserved \[Default: None].
+* **num\_qubits** (*None or* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – reshape to an N-qubit operator \[Default: None].
+
+**Returns**
+
+returns self with reshaped input and output dimensions.
+
+**Return type**
+
+BaseOperator
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if combined size of all subsystem input dimension or subsystem output dimensions is not constant.
+
+### set\_truncation
+
+
+
+`classmethod set_truncation(val)`
+
+Set the max number of Pauli characters to display before truncation/
+
+**Parameters**
+
+**val** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of characters.
+
+
+ Truncation will be disabled if the truncation value is set to 0.
+
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return the tensor product with another Pauli.
+
+**Parameters**
+
+**other** ([*Pauli*](#qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli")) – a Pauli object.
+
+**Returns**
+
+**the tensor product $a \otimes b$, where $a$**
+
+is the current Pauli, and $b$ is the other Pauli.
+
+**Return type**
+
+[Pauli](#qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli")
+
+
+ The tensor product can be obtained using the `^` binary operator. Hence `a.tensor(b)` is equivalent to `a ^ b`.
+
+
+### to\_instruction
+
+
+
+`to_instruction()`
+
+Convert to Pauli circuit instruction.
+
+### to\_label
+
+
+
+`to_label()`
+
+Convert a Pauli to a string label.
+
+
+ The difference between to\_label and `__str__()` is that the later will truncate the output for large numbers of qubits.
+
+
+**Returns**
+
+the Pauli string label.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### to\_matrix
+
+
+
+`to_matrix(sparse=False)`
+
+Convert to a Numpy array or sparse CSR matrix.
+
+**Parameters**
+
+**sparse** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if True return sparse CSR matrices, otherwise return dense Numpy arrays (default: False).
+
+**Returns**
+
+The Pauli matrix.
+
+**Return type**
+
+array
+
+### transpose
+
+
+
+`transpose()`
+
+Return the transpose of each Pauli in the list.
+
diff --git a/docs/api/qiskit/0.46/qiskit.quantum_info.PauliList.md b/docs/api/qiskit/0.46/qiskit.quantum_info.PauliList.md
new file mode 100644
index 00000000000..7c5519e0e3f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.quantum_info.PauliList.md
@@ -0,0 +1,865 @@
+---
+title: PauliList
+description: API reference for qiskit.quantum_info.PauliList
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.quantum_info.PauliList
+---
+
+# PauliList
+
+
+
+`qiskit.quantum_info.PauliList(data)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/symplectic/pauli_list.py "view source code")
+
+Bases: `BasePauli`, `LinearMixin`, `GroupMixin`
+
+List of N-qubit Pauli operators.
+
+This class is an efficient representation of a list of [`Pauli`](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli") operators. It supports 1D numpy array indexing returning a [`Pauli`](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli") for integer indexes or a [`PauliList`](#qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList") for slice or list indices.
+
+**Initialization**
+
+A PauliList object can be initialized in several ways.
+
+> **`PauliList(list[str])`**
+>
+> where strings are same representation with [`Pauli`](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli").
+>
+> **`PauliList(Pauli) and PauliList(list[Pauli])`**
+>
+> where Pauli is [`Pauli`](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli").
+>
+> **`PauliList.from_symplectic(z, x, phase)`**
+>
+> where `z` and `x` are 2 dimensional boolean `numpy.ndarrays` and `phase` is an integer in `[0, 1, 2, 3]`.
+
+For example,
+
+```python
+import numpy as np
+
+from qiskit.quantum_info import Pauli, PauliList
+
+# 1. init from list[str]
+pauli_list = PauliList(["II", "+ZI", "-iYY"])
+print("1. ", pauli_list)
+
+pauli1 = Pauli("iXI")
+pauli2 = Pauli("iZZ")
+
+# 2. init from Pauli
+print("2. ", PauliList(pauli1))
+
+# 3. init from list[Pauli]
+print("3. ", PauliList([pauli1, pauli2]))
+
+# 4. init from np.ndarray
+z = np.array([[True, True], [False, False]])
+x = np.array([[False, True], [True, False]])
+phase = np.array([0, 1])
+pauli_list = PauliList.from_symplectic(z, x, phase)
+print("4. ", pauli_list)
+```
+
+```python
+1. ['II', 'ZI', '-iYY']
+2. ['iXI']
+3. ['iXI', 'iZZ']
+4. ['YZ', '-iIX']
+```
+
+**Data Access**
+
+The individual Paulis can be accessed and updated using the `[]` operator which accepts integer, lists, or slices for selecting subsets of PauliList. If integer is given, it returns Pauli not PauliList.
+
+```python
+pauli_list = PauliList(["XX", "ZZ", "IZ"])
+print("Integer: ", repr(pauli_list[1]))
+print("List: ", repr(pauli_list[[0, 2]]))
+print("Slice: ", repr(pauli_list[0:2]))
+```
+
+```python
+Integer: Pauli('ZZ')
+List: PauliList(['XX', 'IZ'])
+Slice: PauliList(['XX', 'ZZ'])
+```
+
+**Iteration**
+
+Rows in the Pauli table can be iterated over like a list. Iteration can also be done using the label or matrix representation of each row using the [`label_iter()`](#qiskit.quantum_info.PauliList.label_iter "qiskit.quantum_info.PauliList.label_iter") and [`matrix_iter()`](#qiskit.quantum_info.PauliList.matrix_iter "qiskit.quantum_info.PauliList.matrix_iter") methods.
+
+Initialize the PauliList.
+
+**Parameters**
+
+**data** ([*Pauli*](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – input data for Paulis. If input is a list each item in the list must be a Pauli object or Pauli str.
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if input array is invalid shape.
+
+**Additional Information:**
+
+The input array is not copied so multiple Pauli tables can share the same underlying array.
+
+## Attributes
+
+
+
+### dim
+
+Return tuple (input\_shape, output\_shape).
+
+
+
+### num\_qubits
+
+Return the number of qubits if a N-qubit operator or None otherwise.
+
+
+
+### phase
+
+Return the phase exponent of the PauliList.
+
+
+
+### qargs
+
+Return the qargs for the operator.
+
+
+
+### settings
+
+Return settings.
+
+
+
+### shape
+
+The full shape of the `array()`
+
+
+
+### size
+
+The number of Pauli rows in the table.
+
+
+
+### x
+
+The x array for the symplectic representation.
+
+
+
+### z
+
+The z array for the symplectic representation.
+
+## Methods
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return the adjoint of each Pauli in the list.
+
+### anticommutes
+
+
+
+`anticommutes(other, qargs=None)`
+
+Return `True` if other Pauli that anticommutes with other.
+
+**Parameters**
+
+* **other** ([*PauliList*](#qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")) – another PauliList operator.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – qubits to apply dot product on (default: `None`).
+
+**Returns**
+
+`True` if Paulis anticommute, `False` if they commute.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### anticommutes\_with\_all
+
+
+
+`anticommutes_with_all(other)`
+
+Return indexes of rows that commute other.
+
+If `other` is a multi-row Pauli list the returned vector indexes rows of the current PauliList that anti-commute with *all* Paulis in other. If no rows satisfy the condition the returned array will be empty.
+
+**Parameters**
+
+**other** ([*PauliList*](#qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")) – a single Pauli or multi-row PauliList.
+
+**Returns**
+
+index array of the anti-commuting rows.
+
+**Return type**
+
+array
+
+### argsort
+
+
+
+`argsort(weight=False, phase=False)`
+
+Return indices for sorting the rows of the table.
+
+The default sort method is lexicographic sorting by qubit number. By using the weight kwarg the output can additionally be sorted by the number of non-identity terms in the Pauli, where the set of all Paulis of a given weight are still ordered lexicographically.
+
+**Parameters**
+
+* **weight** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Optionally sort by weight if `True` (Default: `False`).
+* **phase** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Optionally sort by phase before weight or order (Default: `False`).
+
+**Returns**
+
+the indices for sorting the table.
+
+**Return type**
+
+array
+
+### commutes
+
+
+
+`commutes(other, qargs=None)`
+
+Return True for each Pauli that commutes with other.
+
+**Parameters**
+
+* **other** ([*PauliList*](#qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")) – another PauliList operator.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – qubits to apply dot product on (default: `None`).
+
+**Returns**
+
+`True` if Paulis commute, `False` if they anti-commute.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### commutes\_with\_all
+
+
+
+`commutes_with_all(other)`
+
+Return indexes of rows that commute `other`.
+
+If `other` is a multi-row Pauli list the returned vector indexes rows of the current PauliList that commute with *all* Paulis in other. If no rows satisfy the condition the returned array will be empty.
+
+**Parameters**
+
+**other** ([*PauliList*](#qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")) – a single Pauli or multi-row PauliList.
+
+**Returns**
+
+index array of the commuting rows.
+
+**Return type**
+
+array
+
+### compose
+
+
+
+`compose(other, qargs=None, front=False, inplace=False)`
+
+Return the composition self∘other for each Pauli in the list.
+
+**Parameters**
+
+* **other** ([*PauliList*](#qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")) – another PauliList.
+* **qargs** (*None or* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – qubits to apply dot product on (Default: `None`).
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True use dot composition method \[default: `False`].
+* **inplace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If `True` update in-place (default: `False`).
+
+**Returns**
+
+the list of composed Paulis.
+
+**Return type**
+
+[PauliList](#qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if other cannot be converted to a PauliList, does not have either 1 or the same number of Paulis as the current list, or has the wrong number of qubits for the specified `qargs`.
+
+### conjugate
+
+
+
+`conjugate()`
+
+Return the conjugate of each Pauli in the list.
+
+### copy
+
+
+
+`copy()`
+
+Make a deep copy of current operator.
+
+### delete
+
+
+
+`delete(ind, qubit=False)`
+
+Return a copy with Pauli rows deleted from table.
+
+When deleting qubits the qubit index is the same as the column index of the underlying `X` and `Z` arrays.
+
+**Parameters**
+
+* **ind** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – index(es) to delete.
+* **qubit** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if `True` delete qubit columns, otherwise delete Pauli rows (Default: `False`).
+
+**Returns**
+
+the resulting table with the entries removed.
+
+**Return type**
+
+[PauliList](#qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if `ind` is out of bounds for the array size or number of qubits.
+
+### dot
+
+
+
+`dot(other, qargs=None, inplace=False)`
+
+Return the composition other∘self for each Pauli in the list.
+
+**Parameters**
+
+* **other** ([*PauliList*](#qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")) – another PauliList.
+* **qargs** (*None or* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – qubits to apply dot product on (Default: `None`).
+* **inplace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True update in-place (default: `False`).
+
+**Returns**
+
+the list of composed Paulis.
+
+**Return type**
+
+[PauliList](#qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if other cannot be converted to a PauliList, does not have either 1 or the same number of Paulis as the current list, or has the wrong number of qubits for the specified `qargs`.
+
+### equiv
+
+
+
+`equiv(other)`
+
+Entrywise comparison of Pauli equivalence up to global phase.
+
+**Parameters**
+
+**other** ([*PauliList*](#qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList") *or*[*Pauli*](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli")) – a comparison object.
+
+**Returns**
+
+**An array of `True` or `False` for entrywise equivalence**
+
+of the current table.
+
+**Return type**
+
+np.ndarray
+
+### evolve
+
+
+
+`evolve(other, qargs=None, frame='h')`
+
+Performs either Heisenberg (default) or Schrödinger picture evolution of the Pauli by a Clifford and returns the evolved Pauli.
+
+Schrödinger picture evolution can be chosen by passing parameter `frame='s'`. This option yields a faster calculation.
+
+Heisenberg picture evolves the Pauli as $P^\prime = C^\dagger.P.C$.
+
+Schrödinger picture evolves the Pauli as $P^\prime = C.P.C^\dagger$.
+
+**Parameters**
+
+* **other** ([*Pauli*](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli") *or*[*Clifford*](qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford") *or*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – The Clifford operator to evolve by.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – a list of qubits to apply the Clifford to.
+* **frame** (*string*) – `'h'` for Heisenberg (default) or `'s'` for Schrödinger framework.
+
+**Returns**
+
+the Pauli $C^\dagger.P.C$ (Heisenberg picture) or the Pauli $C.P.C^\dagger$ (Schrödinger picture).
+
+**Return type**
+
+[PauliList](#qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the Clifford number of qubits and qargs don’t match.
+
+### expand
+
+
+
+`expand(other)`
+
+Return the expand product of each Pauli in the list.
+
+**Parameters**
+
+**other** ([*PauliList*](#qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")) – another PauliList.
+
+**Returns**
+
+the list of tensor product Paulis.
+
+**Return type**
+
+[PauliList](#qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if other cannot be converted to a PauliList, does not have either 1 or the same number of Paulis as the current list.
+
+### from\_symplectic
+
+
+
+`classmethod from_symplectic(z, x, phase=0)`
+
+Construct a PauliList from a symplectic data.
+
+**Parameters**
+
+* **z** (*np.ndarray*) – 2D boolean Numpy array.
+* **x** (*np.ndarray*) – 2D boolean Numpy array.
+* **phase** (*np.ndarray or None*) – Optional, 1D integer array from Z\_4.
+
+**Returns**
+
+the constructed PauliList.
+
+**Return type**
+
+[PauliList](#qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")
+
+### group\_commuting
+
+
+
+`group_commuting(qubit_wise=False)`
+
+Partition a PauliList into sets of commuting Pauli strings.
+
+**Parameters**
+
+**qubit\_wise** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) –
+
+whether the commutation rule is applied to the whole operator, or on a per-qubit basis. For example:
+
+```python
+>>> from qiskit.quantum_info import PauliList
+>>> op = PauliList(["XX", "YY", "IZ", "ZZ"])
+>>> op.group_commuting()
+[PauliList(['XX', 'YY']), PauliList(['IZ', 'ZZ'])]
+>>> op.group_commuting(qubit_wise=True)
+[PauliList(['XX']), PauliList(['YY']), PauliList(['IZ', 'ZZ'])]
+```
+
+**Returns**
+
+List of PauliLists where each PauliList contains commuting Pauli operators.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[PauliList](#qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")]
+
+### group\_qubit\_wise\_commuting
+
+
+
+`group_qubit_wise_commuting()`
+
+Partition a PauliList into sets of mutually qubit-wise commuting Pauli strings.
+
+**Returns**
+
+List of PauliLists where each PauliList contains commutable Pauli operators.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[PauliList](#qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")]
+
+### input\_dims
+
+
+
+`input_dims(qargs=None)`
+
+Return tuple of input dimension for specified subsystems.
+
+### insert
+
+
+
+`insert(ind, value, qubit=False)`
+
+Insert Paulis into the table.
+
+When inserting qubits the qubit index is the same as the column index of the underlying `X` and `Z` arrays.
+
+**Parameters**
+
+* **ind** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – index to insert at.
+* **value** ([*PauliList*](#qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")) – values to insert.
+* **qubit** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if `True` insert qubit columns, otherwise insert Pauli rows (Default: `False`).
+
+**Returns**
+
+the resulting table with the entries inserted.
+
+**Return type**
+
+[PauliList](#qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the insertion index is invalid.
+
+### inverse
+
+
+
+`inverse()`
+
+Return the inverse of each Pauli in the list.
+
+### label\_iter
+
+
+
+`label_iter()`
+
+Return a label representation iterator.
+
+This is a lazy iterator that converts each row into the string label only as it is used. To convert the entire table to labels use the [`to_labels()`](#qiskit.quantum_info.PauliList.to_labels "qiskit.quantum_info.PauliList.to_labels") method.
+
+**Returns**
+
+label iterator object for the PauliList.
+
+**Return type**
+
+LabelIterator
+
+### matrix\_iter
+
+
+
+`matrix_iter(sparse=False)`
+
+Return a matrix representation iterator.
+
+This is a lazy iterator that converts each row into the Pauli matrix representation only as it is used. To convert the entire table to matrices use the [`to_matrix()`](#qiskit.quantum_info.PauliList.to_matrix "qiskit.quantum_info.PauliList.to_matrix") method.
+
+**Parameters**
+
+**sparse** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – optionally return sparse CSR matrices if `True`, otherwise return Numpy array matrices (Default: `False`)
+
+**Returns**
+
+matrix iterator object for the PauliList.
+
+**Return type**
+
+MatrixIterator
+
+### output\_dims
+
+
+
+`output_dims(qargs=None)`
+
+Return tuple of output dimension for specified subsystems.
+
+### power
+
+
+
+`power(n)`
+
+Return the compose of a operator with itself n times.
+
+**Parameters**
+
+**n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of times to compose with self (n>0).
+
+**Returns**
+
+the n-times composed operator.
+
+**Return type**
+
+[Clifford](qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input and output dimensions of the operator are not equal, or the power is not a positive integer.
+
+### reshape
+
+
+
+`reshape(input_dims=None, output_dims=None, num_qubits=None)`
+
+Return a shallow copy with reshaped input and output subsystem dimensions.
+
+**Parameters**
+
+* **input\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem input dimensions. If None the original input dims will be preserved \[Default: None].
+* **output\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem output dimensions. If None the original output dims will be preserved \[Default: None].
+* **num\_qubits** (*None or* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – reshape to an N-qubit operator \[Default: None].
+
+**Returns**
+
+returns self with reshaped input and output dimensions.
+
+**Return type**
+
+BaseOperator
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if combined size of all subsystem input dimension or subsystem output dimensions is not constant.
+
+### sort
+
+
+
+`sort(weight=False, phase=False)`
+
+Sort the rows of the table.
+
+The default sort method is lexicographic sorting by qubit number. By using the weight kwarg the output can additionally be sorted by the number of non-identity terms in the Pauli, where the set of all Paulis of a given weight are still ordered lexicographically.
+
+**Example**
+
+Consider sorting all a random ordering of all 2-qubit Paulis
+
+```python
+from numpy.random import shuffle
+from qiskit.quantum_info.operators import PauliList
+
+# 2-qubit labels
+labels = ['II', 'IX', 'IY', 'IZ', 'XI', 'XX', 'XY', 'XZ',
+ 'YI', 'YX', 'YY', 'YZ', 'ZI', 'ZX', 'ZY', 'ZZ']
+# Shuffle Labels
+shuffle(labels)
+pt = PauliList(labels)
+print('Initial Ordering')
+print(pt)
+
+# Lexicographic Ordering
+srt = pt.sort()
+print('Lexicographically sorted')
+print(srt)
+
+# Weight Ordering
+srt = pt.sort(weight=True)
+print('Weight sorted')
+print(srt)
+```
+
+```python
+Initial Ordering
+['YX', 'ZZ', 'XZ', 'YI', 'YZ', 'II', 'XX', 'XI', 'XY', 'YY', 'IX', 'IZ',
+ 'ZY', 'ZI', 'ZX', 'IY']
+Lexicographically sorted
+['II', 'IX', 'IY', 'IZ', 'XI', 'XX', 'XY', 'XZ', 'YI', 'YX', 'YY', 'YZ',
+ 'ZI', 'ZX', 'ZY', 'ZZ']
+Weight sorted
+['II', 'IX', 'IY', 'IZ', 'XI', 'YI', 'ZI', 'XX', 'XY', 'XZ', 'YX', 'YY',
+ 'YZ', 'ZX', 'ZY', 'ZZ']
+```
+
+**Parameters**
+
+* **weight** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – optionally sort by weight if `True` (Default: `False`).
+* **phase** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Optionally sort by phase before weight or order (Default: `False`).
+
+**Returns**
+
+a sorted copy of the original table.
+
+**Return type**
+
+[PauliList](#qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return the tensor product with each Pauli in the list.
+
+**Parameters**
+
+**other** ([*PauliList*](#qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")) – another PauliList.
+
+**Returns**
+
+the list of tensor product Paulis.
+
+**Return type**
+
+[PauliList](#qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if other cannot be converted to a PauliList, does not have either 1 or the same number of Paulis as the current list.
+
+### to\_labels
+
+
+
+`to_labels(array=False)`
+
+Convert a PauliList to a list Pauli string labels.
+
+For large PauliLists converting using the `array=True` kwarg will be more efficient since it allocates memory for the full Numpy array of labels in advance.
+
+| Label | Symplectic | Matrix |
+| ----- | ---------- | ----------------------------------------------- |
+| `"I"` | $[0, 0]$ | $\begin{bmatrix} 1 & 0 \\ 0 & 1 \end{bmatrix}$ |
+| `"X"` | $[1, 0]$ | $\begin{bmatrix} 0 & 1 \\ 1 & 0 \end{bmatrix}$ |
+| `"Y"` | $[1, 1]$ | $\begin{bmatrix} 0 & -i \\ i & 0 \end{bmatrix}$ |
+| `"Z"` | $[0, 1]$ | $\begin{bmatrix} 1 & 0 \\ 0 & -1 \end{bmatrix}$ |
+
+**Parameters**
+
+**array** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – return a Numpy array if `True`, otherwise return a list (Default: `False`).
+
+**Returns**
+
+The rows of the PauliList in label form.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") or array
+
+### to\_matrix
+
+
+
+`to_matrix(sparse=False, array=False)`
+
+Convert to a list or array of Pauli matrices.
+
+For large PauliLists converting using the `array=True` kwarg will be more efficient since it allocates memory a full rank-3 Numpy array of matrices in advance.
+
+| Label | Symplectic | Matrix |
+| ----- | ---------- | ----------------------------------------------- |
+| `"I"` | $[0, 0]$ | $\begin{bmatrix} 1 & 0 \\ 0 & 1 \end{bmatrix}$ |
+| `"X"` | $[1, 0]$ | $\begin{bmatrix} 0 & 1 \\ 1 & 0 \end{bmatrix}$ |
+| `"Y"` | $[1, 1]$ | $\begin{bmatrix} 0 & -i \\ i & 0 \end{bmatrix}$ |
+| `"Z"` | $[0, 1]$ | $\begin{bmatrix} 1 & 0 \\ 0 & -1 \end{bmatrix}$ |
+
+**Parameters**
+
+* **sparse** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if `True` return sparse CSR matrices, otherwise return dense Numpy arrays (Default: `False`).
+* **array** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – return as rank-3 numpy array if `True`, otherwise return a list of Numpy arrays (Default: `False`).
+
+**Returns**
+
+A list of dense Pauli matrices if ```array=False` and ``sparse=False`. list: A list of sparse Pauli matrices if ``array=False``` and `sparse=True`. array: A dense rank-3 array of Pauli matrices if `array=True`.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+### transpose
+
+
+
+`transpose()`
+
+Return the transpose of each Pauli in the list.
+
+### unique
+
+
+
+`unique(return_index=False, return_counts=False)`
+
+Return unique Paulis from the table.
+
+**Example**
+
+```python
+from qiskit.quantum_info.operators import PauliList
+
+pt = PauliList(['X', 'Y', '-X', 'I', 'I', 'Z', 'X', 'iZ'])
+unique = pt.unique()
+print(unique)
+```
+
+```python
+['X', 'Y', '-X', 'I', 'Z', 'iZ']
+```
+
+**Parameters**
+
+* **return\_index** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If `True`, also return the indices that result in the unique array. (Default: `False`)
+* **return\_counts** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If `True`, also return the number of times each unique item appears in the table.
+
+**Returns**
+
+**unique**
+
+the table of the unique rows.
+
+**unique\_indices: np.ndarray, optional**
+
+The indices of the first occurrences of the unique values in the original array. Only provided if `return_index` is `True`.
+
+**unique\_counts: np.array, optional**
+
+The number of times each of the unique values comes up in the original array. Only provided if `return_counts` is `True`.
+
+**Return type**
+
+[PauliList](#qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")
+
diff --git a/docs/api/qiskit/0.46/qiskit.quantum_info.Quaternion.md b/docs/api/qiskit/0.46/qiskit.quantum_info.Quaternion.md
new file mode 100644
index 00000000000..2612186176d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.quantum_info.Quaternion.md
@@ -0,0 +1,126 @@
+---
+title: Quaternion
+description: API reference for qiskit.quantum_info.Quaternion
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.quantum_info.Quaternion
+---
+
+# Quaternion
+
+
+
+`qiskit.quantum_info.Quaternion(data)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/quaternion.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+A class representing a Quaternion.
+
+## Methods
+
+### from\_axis\_rotation
+
+
+
+`classmethod from_axis_rotation(angle, axis)`
+
+Return quaternion for rotation about given axis.
+
+**Parameters**
+
+* **angle** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Angle in radians.
+* **axis** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Axis for rotation
+
+**Returns**
+
+Quaternion for axis rotation.
+
+**Return type**
+
+[Quaternion](#qiskit.quantum_info.Quaternion "qiskit.quantum_info.Quaternion")
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – Invalid input axis.
+
+### from\_euler
+
+
+
+`classmethod from_euler(angles, order='yzy')`
+
+Generate a quaternion from a set of Euler angles.
+
+**Parameters**
+
+* **angles** (*array\_like*) – Array of Euler angles.
+* **order** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Order of Euler rotations. ‘yzy’ is default.
+
+**Returns**
+
+Quaternion representation of Euler rotation.
+
+**Return type**
+
+[Quaternion](#qiskit.quantum_info.Quaternion "qiskit.quantum_info.Quaternion")
+
+### norm
+
+
+
+`norm()`
+
+Norm of quaternion.
+
+### normalize
+
+
+
+`normalize(inplace=False)`
+
+Normalizes a Quaternion to unit length so that it represents a valid rotation.
+
+**Parameters**
+
+**inplace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Do an inplace normalization.
+
+**Returns**
+
+Normalized quaternion.
+
+**Return type**
+
+[Quaternion](#qiskit.quantum_info.Quaternion "qiskit.quantum_info.Quaternion")
+
+### to\_matrix
+
+
+
+`to_matrix()`
+
+Converts a unit-length quaternion to a rotation matrix.
+
+**Returns**
+
+Rotation matrix.
+
+**Return type**
+
+ndarray
+
+### to\_zyz
+
+
+
+`to_zyz()`
+
+Converts a unit-length quaternion to a sequence of ZYZ Euler angles.
+
+**Returns**
+
+Array of Euler angles.
+
+**Return type**
+
+ndarray
+
diff --git a/docs/api/qiskit/0.46/qiskit.quantum_info.ScalarOp.md b/docs/api/qiskit/0.46/qiskit.quantum_info.ScalarOp.md
new file mode 100644
index 00000000000..a6cd5c7fc66
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.quantum_info.ScalarOp.md
@@ -0,0 +1,302 @@
+---
+title: ScalarOp
+description: API reference for qiskit.quantum_info.ScalarOp
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.quantum_info.ScalarOp
+---
+
+# ScalarOp
+
+
+
+`qiskit.quantum_info.ScalarOp(dims=None, coeff=1)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/scalar_op.py "view source code")
+
+Bases: `LinearOp`
+
+Scalar identity operator class.
+
+This is a symbolic representation of an scalar identity operator on multiple subsystems. It may be used to initialize a symbolic scalar multiplication of an identity and then be implicitly converted to other kinds of operator subclasses by using the [`compose()`](#qiskit.quantum_info.ScalarOp.compose "qiskit.quantum_info.ScalarOp.compose"), [`dot()`](#qiskit.quantum_info.ScalarOp.dot "qiskit.quantum_info.ScalarOp.dot"), [`tensor()`](#qiskit.quantum_info.ScalarOp.tensor "qiskit.quantum_info.ScalarOp.tensor"), [`expand()`](#qiskit.quantum_info.ScalarOp.expand "qiskit.quantum_info.ScalarOp.expand") methods.
+
+Initialize an operator object.
+
+**Parameters**
+
+* **dims** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – subsystem dimensions.
+* **coeff** (*Number*) – scalar coefficient for the identity operator (Default: 1).
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If the optional coefficient is invalid.
+
+## Attributes
+
+
+
+### atol
+
+`= 1e-08`
+
+
+
+### coeff
+
+Return the coefficient
+
+
+
+### dim
+
+Return tuple (input\_shape, output\_shape).
+
+
+
+### num\_qubits
+
+Return the number of qubits if a N-qubit operator or None otherwise.
+
+
+
+### qargs
+
+Return the qargs for the operator.
+
+
+
+### rtol
+
+`= 1e-05`
+
+## Methods
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return the adjoint of the Operator.
+
+**Return type**
+
+*Self*
+
+### compose
+
+
+
+`compose(other, qargs=None, front=False)`
+
+Return the operator composition with another ScalarOp.
+
+**Parameters**
+
+* **other** ([*ScalarOp*](#qiskit.quantum_info.ScalarOp "qiskit.quantum_info.ScalarOp")) – a ScalarOp object.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – Optional, a list of subsystem positions to apply other on. If None apply on all subsystems (default: None).
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True compose using right operator multiplication, instead of left multiplication \[default: False].
+
+**Returns**
+
+The composed ScalarOp.
+
+**Return type**
+
+[ScalarOp](#qiskit.quantum_info.ScalarOp "qiskit.quantum_info.ScalarOp")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if other cannot be converted to an operator, or has incompatible dimensions for specified subsystems.
+
+
+ Composition (`&`) by default is defined as left matrix multiplication for matrix operators, while `@` (equivalent to [`dot()`](#qiskit.quantum_info.ScalarOp.dot "qiskit.quantum_info.ScalarOp.dot")) is defined as right matrix multiplication. That is that `A & B == A.compose(B)` is equivalent to `B @ A == B.dot(A)` when `A` and `B` are of the same type.
+
+ Setting the `front=True` kwarg changes this to right matrix multiplication and is equivalent to the [`dot()`](#qiskit.quantum_info.ScalarOp.dot "qiskit.quantum_info.ScalarOp.dot") method `A.dot(B) == A.compose(B, front=True)`.
+
+
+### conjugate
+
+
+
+`conjugate()`
+
+Return the conjugate of the ScalarOp.
+
+### copy
+
+
+
+`copy()`
+
+Make a deep copy of current operator.
+
+### dot
+
+
+
+`dot(other, qargs=None)`
+
+Return the right multiplied operator self \* other.
+
+**Parameters**
+
+* **other** ([*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – an operator object.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – Optional, a list of subsystem positions to apply other on. If None apply on all subsystems (default: None).
+
+**Returns**
+
+The right matrix multiplied Operator.
+
+**Return type**
+
+[Operator](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")
+
+
+ The dot product can be obtained using the `@` binary operator. Hence `a.dot(b)` is equivalent to `a @ b`.
+
+
+### expand
+
+
+
+`expand(other)`
+
+Return the reverse-order tensor product with another ScalarOp.
+
+**Parameters**
+
+**other** ([*ScalarOp*](#qiskit.quantum_info.ScalarOp "qiskit.quantum_info.ScalarOp")) – a ScalarOp object.
+
+**Returns**
+
+**the tensor product $b \otimes a$, where $a$**
+
+is the current ScalarOp, and $b$ is the other ScalarOp.
+
+**Return type**
+
+[ScalarOp](#qiskit.quantum_info.ScalarOp "qiskit.quantum_info.ScalarOp")
+
+### input\_dims
+
+
+
+`input_dims(qargs=None)`
+
+Return tuple of input dimension for specified subsystems.
+
+### is\_unitary
+
+
+
+`is_unitary(atol=None, rtol=None)`
+
+Return True if operator is a unitary matrix.
+
+### output\_dims
+
+
+
+`output_dims(qargs=None)`
+
+Return tuple of output dimension for specified subsystems.
+
+### power
+
+
+
+`power(n)`
+
+Return the power of the ScalarOp.
+
+**Parameters**
+
+**n** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the exponent for the scalar op.
+
+**Returns**
+
+the `coeff ** n` ScalarOp.
+
+**Return type**
+
+[ScalarOp](#qiskit.quantum_info.ScalarOp "qiskit.quantum_info.ScalarOp")
+
+### reshape
+
+
+
+`reshape(input_dims=None, output_dims=None, num_qubits=None)`
+
+Return a shallow copy with reshaped input and output subsystem dimensions.
+
+**Parameters**
+
+* **input\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem input dimensions. If None the original input dims will be preserved \[Default: None].
+* **output\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem output dimensions. If None the original output dims will be preserved \[Default: None].
+* **num\_qubits** (*None or* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – reshape to an N-qubit operator \[Default: None].
+
+**Returns**
+
+returns self with reshaped input and output dimensions.
+
+**Return type**
+
+BaseOperator
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if combined size of all subsystem input dimension or subsystem output dimensions is not constant.
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return the tensor product with another ScalarOp.
+
+**Parameters**
+
+**other** ([*ScalarOp*](#qiskit.quantum_info.ScalarOp "qiskit.quantum_info.ScalarOp")) – a ScalarOp object.
+
+**Returns**
+
+**the tensor product $a \otimes b$, where $a$**
+
+is the current ScalarOp, and $b$ is the other ScalarOp.
+
+**Return type**
+
+[ScalarOp](#qiskit.quantum_info.ScalarOp "qiskit.quantum_info.ScalarOp")
+
+
+ The tensor product can be obtained using the `^` binary operator. Hence `a.tensor(b)` is equivalent to `a ^ b`.
+
+
+### to\_matrix
+
+
+
+`to_matrix()`
+
+Convert to a Numpy matrix.
+
+### to\_operator
+
+
+
+`to_operator()`
+
+Convert to an Operator object.
+
+**Return type**
+
+[*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.operators.operator.Operator")
+
+### transpose
+
+
+
+`transpose()`
+
+Return the transpose of the ScalarOp.
+
diff --git a/docs/api/qiskit/0.46/qiskit.quantum_info.SparsePauliOp.md b/docs/api/qiskit/0.46/qiskit.quantum_info.SparsePauliOp.md
new file mode 100644
index 00000000000..951973fa0e1
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.quantum_info.SparsePauliOp.md
@@ -0,0 +1,881 @@
+---
+title: SparsePauliOp
+description: API reference for qiskit.quantum_info.SparsePauliOp
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.quantum_info.SparsePauliOp
+---
+
+# SparsePauliOp
+
+
+
+`qiskit.quantum_info.SparsePauliOp(data, coeffs=None, *, ignore_pauli_phase=False, copy=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/symplectic/sparse_pauli_op.py "view source code")
+
+Bases: `LinearOp`
+
+Sparse N-qubit operator in a Pauli basis representation.
+
+This is a sparse representation of an N-qubit matrix [`Operator`](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator") in terms of N-qubit [`PauliList`](qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList") and complex coefficients.
+
+It can be used for performing operator arithmetic for hundred of qubits if the number of non-zero Pauli basis terms is sufficiently small.
+
+The Pauli basis components are stored as a [`PauliList`](qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList") object and can be accessed using the [`paulis`](#qiskit.quantum_info.SparsePauliOp.paulis "qiskit.quantum_info.SparsePauliOp.paulis") attribute. The coefficients are stored as a complex Numpy array vector and can be accessed using the [`coeffs`](#qiskit.quantum_info.SparsePauliOp.coeffs "qiskit.quantum_info.SparsePauliOp.coeffs") attribute.
+
+**Data type of coefficients**
+
+The default `dtype` of the internal `coeffs` Numpy array is `complex128`. Users can configure this by passing `np.ndarray` with a different dtype. For example, a parameterized [`SparsePauliOp`](#qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp") can be made as follows:
+
+```python
+>>> import numpy as np
+>>> from qiskit.circuit import ParameterVector
+>>> from qiskit.quantum_info import SparsePauliOp
+
+>>> SparsePauliOp(["II", "XZ"], np.array(ParameterVector("a", 2)))
+SparsePauliOp(['II', 'XZ'],
+ coeffs=[ParameterExpression(1.0*a[0]), ParameterExpression(1.0*a[1])])
+```
+
+
+ Parameterized [`SparsePauliOp`](#qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp") does not support the following methods:
+
+ * `to_matrix(sparse=True)` since `scipy.sparse` cannot have objects as elements.
+ * `to_operator()` since [`Operator`](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator") does not support objects.
+ * `sort`, `argsort` since [`ParameterExpression`](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression") does not support comparison.
+ * `equiv` since [`ParameterExpression`](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression") cannot be converted into complex.
+ * `chop` since [`ParameterExpression`](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression") does not support absolute value.
+
+
+Initialize an operator object.
+
+**Parameters**
+
+* **data** ([*PauliList*](qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList") *or*[*SparsePauliOp*](#qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp") *or*[*Pauli*](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Pauli list of terms. A list of Pauli strings or a Pauli string is also allowed.
+
+* **coeffs** (*np.ndarray*) –
+
+ complex coefficients for Pauli terms.
+
+
+ If `data` is a [`SparsePauliOp`](#qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp") and `coeffs` is not `None`, the value of the `SparsePauliOp.coeffs` will be ignored, and only the passed keyword argument `coeffs` will be used.
+
+
+* **ignore\_pauli\_phase** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if true, any `phase` component of a given [`PauliList`](qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList") will be assumed to be zero. This is more efficient in cases where a [`PauliList`](qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList") has been constructed purely for this object, and it is already known that the phases in the ZX-convention are zero. It only makes sense to pass this option when giving [`PauliList`](qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList") data. (Default: False)
+
+* **copy** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – copy the input data if True, otherwise assign it directly, if possible. (Default: True)
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If the input data or coeffs are invalid.
+
+## Attributes
+
+
+
+### atol
+
+`= 1e-08`
+
+
+
+### coeffs
+
+Return the Pauli coefficients.
+
+
+
+### dim
+
+Return tuple (input\_shape, output\_shape).
+
+
+
+### num\_qubits
+
+Return the number of qubits if a N-qubit operator or None otherwise.
+
+
+
+### parameters
+
+Return the free `Parameter`s in the coefficients.
+
+
+
+### paulis
+
+Return the PauliList.
+
+
+
+### qargs
+
+Return the qargs for the operator.
+
+
+
+### rtol
+
+`= 1e-05`
+
+
+
+### settings
+
+Return settings.
+
+
+
+### size
+
+The number of Pauli of Pauli terms in the operator.
+
+## Methods
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return the adjoint of the Operator.
+
+### apply\_layout
+
+
+
+`apply_layout(layout, num_qubits=None)`
+
+Apply a transpiler layout to this [`SparsePauliOp`](#qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp")
+
+**Parameters**
+
+* **layout** ([*TranspileLayout*](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") *| List\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Either a [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") or a list of integers.
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of qubits to expand the operator to. If not provided then if `layout` is a [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") the number of the transpiler output circuit qubits will be used by default. If `layout` is a list of integers the permutation specified will be applied without any expansion.
+
+**Returns**
+
+A new [`SparsePauliOp`](#qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp") with the provided layout applied
+
+**Return type**
+
+[SparsePauliOp](#qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp")
+
+### argsort
+
+
+
+`argsort(weight=False)`
+
+Return indices for sorting the rows of the table.
+
+Returns the composition of permutations in the order of sorting by coefficient and sorting by Pauli. By using the weight kwarg the output can additionally be sorted by the number of non-identity terms in the Pauli, where the set of all Pauli’s of a given weight are still ordered lexicographically.
+
+**Example**
+
+Here is an example of how to use SparsePauliOp argsort.
+
+```python
+import numpy as np
+from qiskit.quantum_info import SparsePauliOp
+
+# 2-qubit labels
+labels = ["XX", "XX", "XX", "YI", "II", "XZ", "XY", "XI"]
+# coeffs
+coeffs = [2.+1.j, 2.+2.j, 3.+0.j, 3.+0.j, 4.+0.j, 5.+0.j, 6.+0.j, 7.+0.j]
+
+# init
+spo = SparsePauliOp(labels, coeffs)
+print('Initial Ordering')
+print(spo)
+
+# Lexicographic Ordering
+srt = spo.argsort()
+print('Lexicographically sorted')
+print(srt)
+
+# Lexicographic Ordering
+srt = spo.argsort(weight=False)
+print('Lexicographically sorted')
+print(srt)
+
+# Weight Ordering
+srt = spo.argsort(weight=True)
+print('Weight sorted')
+print(srt)
+```
+
+```python
+Initial Ordering
+SparsePauliOp(['XX', 'XX', 'XX', 'YI', 'II', 'XZ', 'XY', 'XI'],
+ coeffs=[2.+1.j, 2.+2.j, 3.+0.j, 3.+0.j, 4.+0.j, 5.+0.j, 6.+0.j, 7.+0.j])
+Lexicographically sorted
+[4 7 0 1 2 6 5 3]
+Lexicographically sorted
+[4 7 0 1 2 6 5 3]
+Weight sorted
+[4 7 3 0 1 2 6 5]
+```
+
+**Parameters**
+
+* **weight** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – optionally sort by weight if True (Default: False).
+* **sorted** (*By using the weight kwarg the output can additionally be*) –
+* **Pauli.** (*by the number of non-identity terms in the*) –
+
+**Returns**
+
+the indices for sorting the table.
+
+**Return type**
+
+array
+
+### assign\_parameters
+
+
+
+`assign_parameters(parameters, inplace=False)`
+
+Bind the free `Parameter`s in the coefficients to provided values.
+
+**Parameters**
+
+* **parameters** (*Mapping\[*[*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*,* [*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")*] | Sequence\[*[*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")*]*) – The values to bind the parameters to.
+* **inplace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If `False`, a copy of the operator with the bound parameters is returned. If `True` the operator itself is modified.
+
+**Returns**
+
+A copy of the operator with bound parameters, if `inplace` is `False`, otherwise `None`.
+
+**Return type**
+
+[SparsePauliOp](#qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp") | None
+
+### chop
+
+
+
+`chop(tol=1e-14)`
+
+Set real and imaginary parts of the coefficients to 0 if `< tol` in magnitude.
+
+For example, the operator representing `1+1e-17j X + 1e-17 Y` with a tolerance larger than `1e-17` will be reduced to `1 X` whereas [`SparsePauliOp.simplify()`](#qiskit.quantum_info.SparsePauliOp.simplify "qiskit.quantum_info.SparsePauliOp.simplify") would return `1+1e-17j X`.
+
+If a both the real and imaginary part of a coefficient is 0 after chopping, the corresponding Pauli is removed from the operator.
+
+**Parameters**
+
+**tol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The absolute tolerance to check whether a real or imaginary part should be set to 0.
+
+**Returns**
+
+This operator with chopped coefficients.
+
+**Return type**
+
+[SparsePauliOp](#qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp")
+
+### compose
+
+
+
+`compose(other, qargs=None, front=False)`
+
+Return the operator composition with another SparsePauliOp.
+
+**Parameters**
+
+* **other** ([*SparsePauliOp*](#qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp")) – a SparsePauliOp object.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – Optional, a list of subsystem positions to apply other on. If None apply on all subsystems (default: None).
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True compose using right operator multiplication, instead of left multiplication \[default: False].
+
+**Returns**
+
+The composed SparsePauliOp.
+
+**Return type**
+
+[SparsePauliOp](#qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if other cannot be converted to an operator, or has incompatible dimensions for specified subsystems.
+
+
+ Composition (`&`) by default is defined as left matrix multiplication for matrix operators, while `@` (equivalent to [`dot()`](#qiskit.quantum_info.SparsePauliOp.dot "qiskit.quantum_info.SparsePauliOp.dot")) is defined as right matrix multiplication. That is that `A & B == A.compose(B)` is equivalent to `B @ A == B.dot(A)` when `A` and `B` are of the same type.
+
+ Setting the `front=True` kwarg changes this to right matrix multiplication and is equivalent to the [`dot()`](#qiskit.quantum_info.SparsePauliOp.dot "qiskit.quantum_info.SparsePauliOp.dot") method `A.dot(B) == A.compose(B, front=True)`.
+
+
+### conjugate
+
+
+
+`conjugate()`
+
+Return the conjugate of the SparsePauliOp.
+
+### copy
+
+
+
+`copy()`
+
+Make a deep copy of current operator.
+
+### dot
+
+
+
+`dot(other, qargs=None)`
+
+Return the right multiplied operator self \* other.
+
+**Parameters**
+
+* **other** ([*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – an operator object.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – Optional, a list of subsystem positions to apply other on. If None apply on all subsystems (default: None).
+
+**Returns**
+
+The right matrix multiplied Operator.
+
+**Return type**
+
+[Operator](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")
+
+
+ The dot product can be obtained using the `@` binary operator. Hence `a.dot(b)` is equivalent to `a @ b`.
+
+
+### equiv
+
+
+
+`equiv(other, atol=None)`
+
+Check if two SparsePauliOp operators are equivalent.
+
+**Parameters**
+
+* **other** ([*SparsePauliOp*](#qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp")) – an operator object.
+* **atol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – Absolute numerical tolerance for checking equivalence.
+
+**Returns**
+
+True if the operator is equivalent to `self`.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### expand
+
+
+
+`expand(other)`
+
+Return the reverse-order tensor product with another SparsePauliOp.
+
+**Parameters**
+
+**other** ([*SparsePauliOp*](#qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp")) – a SparsePauliOp object.
+
+**Returns**
+
+**the tensor product $b \otimes a$, where $a$**
+
+is the current SparsePauliOp, and $b$ is the other SparsePauliOp.
+
+**Return type**
+
+[SparsePauliOp](#qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp")
+
+### from\_list
+
+
+
+`static from_list(obj, dtype=, *, num_qubits=None)`
+
+Construct from a list of Pauli strings and coefficients.
+
+For example, the 5-qubit Hamiltonian
+
+$$
+H = Z_1 X_4 + 2 Y_0 Y_3
+$$
+
+can be constructed as
+
+```python
+# via tuples and the full Pauli string
+op = SparsePauliOp.from_list([("XIIZI", 1), ("IYIIY", 2)])
+```
+
+**Parameters**
+
+* **obj** (*Iterable\[Tuple\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*]]*) – The list of 2-tuples specifying the Pauli terms.
+* **dtype** ([*type*](https://docs.python.org/3/library/functions.html#type "(in Python v3.12)")) – The dtype of coeffs (Default: complex).
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of qubits of the operator (Default: None).
+
+**Returns**
+
+The SparsePauliOp representation of the Pauli terms.
+
+**Return type**
+
+[SparsePauliOp](#qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp")
+
+**Raises**
+
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If an empty list is passed and num\_qubits is None.
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If num\_qubits and the objects in the input list do not match.
+
+### from\_operator
+
+
+
+`static from_operator(obj, atol=None, rtol=None)`
+
+Construct from an Operator objector.
+
+Note that the cost of this construction is exponential as it involves taking inner products with every element of the N-qubit Pauli basis.
+
+**Parameters**
+
+* **obj** ([*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – an N-qubit operator.
+* **atol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Optional. Absolute tolerance for checking if coefficients are zero (Default: 1e-8).
+* **rtol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Optional. relative tolerance for checking if coefficients are zero (Default: 1e-5).
+
+**Returns**
+
+the SparsePauliOp representation of the operator.
+
+**Return type**
+
+[SparsePauliOp](#qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input operator is not an N-qubit operator.
+
+### from\_sparse\_list
+
+
+
+`static from_sparse_list(obj, num_qubits, do_checks=True, dtype=)`
+
+Construct from a list of local Pauli strings and coefficients.
+
+Each list element is a 3-tuple of a local Pauli string, indices where to apply it, and a coefficient.
+
+For example, the 5-qubit Hamiltonian
+
+$$
+H = Z_1 X_4 + 2 Y_0 Y_3
+$$
+
+can be constructed as
+
+```python
+# via triples and local Paulis with indices
+op = SparsePauliOp.from_sparse_list([("ZX", [1, 4], 1), ("YY", [0, 3], 2)], num_qubits=5)
+
+# equals the following construction from "dense" Paulis
+op = SparsePauliOp.from_list([("XIIZI", 1), ("IYIIY", 2)])
+```
+
+**Parameters**
+
+* **obj** (*Iterable\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*],* [*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")*]]*) – The list 3-tuples specifying the Paulis.
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of qubits of the operator.
+* **do\_checks** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – The flag of checking if the input indices are not duplicated
+* \*\*(\*\***Default** – True).
+* **dtype** ([*type*](https://docs.python.org/3/library/functions.html#type "(in Python v3.12)")) – The dtype of coeffs (Default: complex).
+
+**Returns**
+
+The SparsePauliOp representation of the Pauli terms.
+
+**Return type**
+
+[SparsePauliOp](#qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp")
+
+**Raises**
+
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If the number of qubits is incompatible with the indices of the Pauli terms.
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If the designated qubit is already assigned.
+
+### group\_commuting
+
+
+
+`group_commuting(qubit_wise=False)`
+
+Partition a SparsePauliOp into sets of commuting Pauli strings.
+
+**Parameters**
+
+**qubit\_wise** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) –
+
+whether the commutation rule is applied to the whole operator, or on a per-qubit basis. For example:
+
+```python
+>>> op = SparsePauliOp.from_list([("XX", 2), ("YY", 1), ("IZ",2j), ("ZZ",1j)])
+>>> op.group_commuting()
+[SparsePauliOp(["IZ", "ZZ"], coeffs=[0.+2.j, 0.+1j]),
+ SparsePauliOp(["XX", "YY"], coeffs=[2.+0.j, 1.+0.j])]
+>>> op.group_commuting(qubit_wise=True)
+[SparsePauliOp(['XX'], coeffs=[2.+0.j]),
+ SparsePauliOp(['YY'], coeffs=[1.+0.j]),
+ SparsePauliOp(['IZ', 'ZZ'], coeffs=[0.+2.j, 0.+1.j])]
+```
+
+**Returns**
+
+**List of SparsePauliOp where each SparsePauliOp contains**
+
+commuting Pauli operators.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[SparsePauliOp](#qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp")]
+
+### input\_dims
+
+
+
+`input_dims(qargs=None)`
+
+Return tuple of input dimension for specified subsystems.
+
+### is\_unitary
+
+
+
+`is_unitary(atol=None, rtol=None)`
+
+Return True if operator is a unitary matrix.
+
+**Parameters**
+
+* **atol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Optional. Absolute tolerance for checking if coefficients are zero (Default: 1e-8).
+* **rtol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Optional. relative tolerance for checking if coefficients are zero (Default: 1e-5).
+
+**Returns**
+
+True if the operator is unitary, False otherwise.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### label\_iter
+
+
+
+`label_iter()`
+
+Return a label representation iterator.
+
+This is a lazy iterator that converts each term in the SparsePauliOp into a tuple (label, coeff). To convert the entire table to labels use the `to_labels()` method.
+
+**Returns**
+
+label iterator object for the SparsePauliOp.
+
+**Return type**
+
+LabelIterator
+
+### matrix\_iter
+
+
+
+`matrix_iter(sparse=False)`
+
+Return a matrix representation iterator.
+
+This is a lazy iterator that converts each term in the SparsePauliOp into a matrix as it is used. To convert to a single matrix use the [`to_matrix()`](#qiskit.quantum_info.SparsePauliOp.to_matrix "qiskit.quantum_info.SparsePauliOp.to_matrix") method.
+
+**Parameters**
+
+**sparse** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – optionally return sparse CSR matrices if True, otherwise return Numpy array matrices (Default: False)
+
+**Returns**
+
+matrix iterator object for the PauliList.
+
+**Return type**
+
+MatrixIterator
+
+### output\_dims
+
+
+
+`output_dims(qargs=None)`
+
+Return tuple of output dimension for specified subsystems.
+
+### power
+
+
+
+`power(n)`
+
+Return the compose of a operator with itself n times.
+
+**Parameters**
+
+**n** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of times to compose with self (n>0).
+
+**Returns**
+
+the n-times composed operator.
+
+**Return type**
+
+[Clifford](qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input and output dimensions of the operator are not equal, or the power is not a positive integer.
+
+### reshape
+
+
+
+`reshape(input_dims=None, output_dims=None, num_qubits=None)`
+
+Return a shallow copy with reshaped input and output subsystem dimensions.
+
+**Parameters**
+
+* **input\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem input dimensions. If None the original input dims will be preserved \[Default: None].
+* **output\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem output dimensions. If None the original output dims will be preserved \[Default: None].
+* **num\_qubits** (*None or* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – reshape to an N-qubit operator \[Default: None].
+
+**Returns**
+
+returns self with reshaped input and output dimensions.
+
+**Return type**
+
+BaseOperator
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if combined size of all subsystem input dimension or subsystem output dimensions is not constant.
+
+### simplify
+
+
+
+`simplify(atol=None, rtol=None)`
+
+Simplify PauliList by combining duplicates and removing zeros.
+
+**Parameters**
+
+* **atol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Optional. Absolute tolerance for checking if coefficients are zero (Default: 1e-8).
+* **rtol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Optional. relative tolerance for checking if coefficients are zero (Default: 1e-5).
+
+**Returns**
+
+the simplified SparsePauliOp operator.
+
+**Return type**
+
+[SparsePauliOp](#qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp")
+
+### sort
+
+
+
+`sort(weight=False)`
+
+Sort the rows of the table.
+
+After sorting the coefficients using numpy’s argsort, sort by Pauli. Pauli sort takes precedence. If Pauli is the same, it will be sorted by coefficient. By using the weight kwarg the output can additionally be sorted by the number of non-identity terms in the Pauli, where the set of all Pauli’s of a given weight are still ordered lexicographically.
+
+**Example**
+
+Here is an example of how to use SparsePauliOp sort.
+
+```python
+import numpy as np
+from qiskit.quantum_info import SparsePauliOp
+
+# 2-qubit labels
+labels = ["XX", "XX", "XX", "YI", "II", "XZ", "XY", "XI"]
+# coeffs
+coeffs = [2.+1.j, 2.+2.j, 3.+0.j, 3.+0.j, 4.+0.j, 5.+0.j, 6.+0.j, 7.+0.j]
+
+# init
+spo = SparsePauliOp(labels, coeffs)
+print('Initial Ordering')
+print(spo)
+
+# Lexicographic Ordering
+srt = spo.sort()
+print('Lexicographically sorted')
+print(srt)
+
+# Lexicographic Ordering
+srt = spo.sort(weight=False)
+print('Lexicographically sorted')
+print(srt)
+
+# Weight Ordering
+srt = spo.sort(weight=True)
+print('Weight sorted')
+print(srt)
+```
+
+```python
+Initial Ordering
+SparsePauliOp(['XX', 'XX', 'XX', 'YI', 'II', 'XZ', 'XY', 'XI'],
+ coeffs=[2.+1.j, 2.+2.j, 3.+0.j, 3.+0.j, 4.+0.j, 5.+0.j, 6.+0.j, 7.+0.j])
+Lexicographically sorted
+SparsePauliOp(['II', 'XI', 'XX', 'XX', 'XX', 'XY', 'XZ', 'YI'],
+ coeffs=[4.+0.j, 7.+0.j, 2.+1.j, 2.+2.j, 3.+0.j, 6.+0.j, 5.+0.j, 3.+0.j])
+Lexicographically sorted
+SparsePauliOp(['II', 'XI', 'XX', 'XX', 'XX', 'XY', 'XZ', 'YI'],
+ coeffs=[4.+0.j, 7.+0.j, 2.+1.j, 2.+2.j, 3.+0.j, 6.+0.j, 5.+0.j, 3.+0.j])
+Weight sorted
+SparsePauliOp(['II', 'XI', 'YI', 'XX', 'XX', 'XX', 'XY', 'XZ'],
+ coeffs=[4.+0.j, 7.+0.j, 3.+0.j, 2.+1.j, 2.+2.j, 3.+0.j, 6.+0.j, 5.+0.j])
+```
+
+**Parameters**
+
+* **weight** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – optionally sort by weight if True (Default: False).
+* **sorted** (*By using the weight kwarg the output can additionally be*) –
+* **Pauli.** (*by the number of non-identity terms in the*) –
+
+**Returns**
+
+a sorted copy of the original table.
+
+**Return type**
+
+[SparsePauliOp](#qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp")
+
+### sum
+
+
+
+`static sum(ops)`
+
+Sum of SparsePauliOps.
+
+This is a specialized version of the builtin `sum` function for SparsePauliOp with smaller overhead.
+
+**Parameters**
+
+**ops** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*SparsePauliOp*](#qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp")*]*) – a list of SparsePauliOps.
+
+**Returns**
+
+the SparsePauliOp representing the sum of the input list.
+
+**Return type**
+
+[SparsePauliOp](#qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp")
+
+**Raises**
+
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input list is empty.
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input list includes an object that is not SparsePauliOp.
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the numbers of qubits of the objects in the input list do not match.
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return the tensor product with another SparsePauliOp.
+
+**Parameters**
+
+**other** ([*SparsePauliOp*](#qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp")) – a SparsePauliOp object.
+
+**Returns**
+
+**the tensor product $a \otimes b$, where $a$**
+
+is the current SparsePauliOp, and $b$ is the other SparsePauliOp.
+
+**Return type**
+
+[SparsePauliOp](#qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp")
+
+
+ The tensor product can be obtained using the `^` binary operator. Hence `a.tensor(b)` is equivalent to `a ^ b`.
+
+
+### to\_list
+
+
+
+`to_list(array=False)`
+
+Convert to a list Pauli string labels and coefficients.
+
+For operators with a lot of terms converting using the `array=True` kwarg will be more efficient since it allocates memory for the full Numpy array of labels in advance.
+
+**Parameters**
+
+**array** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – return a Numpy array if True, otherwise return a list (Default: False).
+
+**Returns**
+
+List of pairs (label, coeff) for rows of the PauliList.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") or array
+
+### to\_matrix
+
+
+
+`to_matrix(sparse=False)`
+
+Convert to a dense or sparse matrix.
+
+**Parameters**
+
+**sparse** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if True return a sparse CSR matrix, otherwise return dense Numpy array (Default: False).
+
+**Returns**
+
+A dense matrix if sparse=False. csr\_matrix: A sparse matrix in CSR format if sparse=True.
+
+**Return type**
+
+array
+
+### to\_operator
+
+
+
+`to_operator()`
+
+Convert to a matrix Operator object
+
+**Return type**
+
+[*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.operators.operator.Operator")
+
+### transpose
+
+
+
+`transpose()`
+
+Return the transpose of the SparsePauliOp.
+
diff --git a/docs/api/qiskit/0.46/qiskit.quantum_info.StabilizerState.md b/docs/api/qiskit/0.46/qiskit.quantum_info.StabilizerState.md
new file mode 100644
index 00000000000..1acb7f476c0
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.quantum_info.StabilizerState.md
@@ -0,0 +1,438 @@
+---
+title: StabilizerState
+description: API reference for qiskit.quantum_info.StabilizerState
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.quantum_info.StabilizerState
+---
+
+# StabilizerState
+
+
+
+`qiskit.quantum_info.StabilizerState(data, validate=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/states/stabilizerstate.py "view source code")
+
+Bases: `QuantumState`
+
+StabilizerState class. Stabilizer simulator using the convention from reference \[1]. Based on the internal class [`Clifford`](qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford").
+
+```python
+from qiskit import QuantumCircuit
+from qiskit.quantum_info import StabilizerState, Pauli
+
+# Bell state generation circuit
+qc = QuantumCircuit(2)
+qc.h(0)
+qc.cx(0, 1)
+stab = StabilizerState(qc)
+
+# Print the StabilizerState
+print(stab)
+
+# Calculate the StabilizerState measurement probabilities dictionary
+print (stab.probabilities_dict())
+
+# Calculate expectation value of the StabilizerState
+print (stab.expectation_value(Pauli('ZZ')))
+```
+
+```python
+StabilizerState(StabilizerTable: ['+XX', '+ZZ'])
+{'00': 0.5, '11': 0.5}
+1
+```
+
+**References**
+
+1. S. Aaronson, D. Gottesman, *Improved Simulation of Stabilizer Circuits*, Phys. Rev. A 70, 052328 (2004). [arXiv:quant-ph/0406196](https://arxiv.org/abs/quant-ph/0406196)
+
+Initialize a StabilizerState object.
+
+**Parameters**
+
+* **or** (*data (*[*StabilizerState*](#qiskit.quantum_info.StabilizerState "qiskit.quantum_info.StabilizerState") *or*[*Clifford*](qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford") *or*[*Pauli*](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli") *or*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – qiskit.circuit.Instruction): Data from which the stabilizer state can be constructed.
+* **validate** (*boolean*) – validate that the stabilizer state data is a valid Clifford.
+
+## Attributes
+
+
+
+### clifford
+
+Return StabilizerState Clifford data
+
+
+
+### dim
+
+Return total state dimension.
+
+
+
+### num\_qubits
+
+Return the number of qubits if a N-qubit state or None otherwise.
+
+## Methods
+
+### conjugate
+
+
+
+`conjugate()`
+
+Return the conjugate of the operator.
+
+### copy
+
+
+
+`copy()`
+
+Make a copy of current operator.
+
+### dims
+
+
+
+`dims(qargs=None)`
+
+Return tuple of input dimension for specified subsystems.
+
+### equiv
+
+
+
+`equiv(other)`
+
+Return True if the two generating sets generate the same stabilizer group.
+
+**Parameters**
+
+**other** ([*StabilizerState*](#qiskit.quantum_info.StabilizerState "qiskit.quantum_info.StabilizerState")) – another StabilizerState.
+
+**Returns**
+
+True if other has a generating set that generates the same StabilizerState.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### evolve
+
+
+
+`evolve(other, qargs=None)`
+
+Evolve a stabilizer state by a Clifford operator.
+
+**Parameters**
+
+* **other** ([*Clifford*](qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford") *or*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*qiskit.circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction")) – The Clifford operator to evolve by.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – a list of stabilizer subsystem positions to apply the operator on.
+
+**Returns**
+
+the output stabilizer state.
+
+**Return type**
+
+[StabilizerState](#qiskit.quantum_info.StabilizerState "qiskit.quantum_info.StabilizerState")
+
+**Raises**
+
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if other is not a StabilizerState.
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the operator dimension does not match the specified StabilizerState subsystem dimensions.
+
+### expand
+
+
+
+`expand(other)`
+
+Return the tensor product stabilizer state other ⊗ self.
+
+**Parameters**
+
+**other** ([*StabilizerState*](#qiskit.quantum_info.StabilizerState "qiskit.quantum_info.StabilizerState")) – a stabilizer state object.
+
+**Returns**
+
+the tensor product operator other ⊗ self.
+
+**Return type**
+
+[StabilizerState](#qiskit.quantum_info.StabilizerState "qiskit.quantum_info.StabilizerState")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if other is not a StabilizerState.
+
+### expectation\_value
+
+
+
+`expectation_value(oper, qargs=None)`
+
+Compute the expectation value of a Pauli operator.
+
+**Parameters**
+
+* **oper** ([*Pauli*](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli")) – a Pauli operator to evaluate expval.
+* **qargs** (*None or* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – subsystems to apply the operator on.
+
+**Returns**
+
+the expectation value (only 0 or 1 or -1 or i or -i).
+
+**Return type**
+
+[complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if oper is not a Pauli operator.
+
+### is\_valid
+
+
+
+`is_valid(atol=None, rtol=None)`
+
+Return True if a valid StabilizerState.
+
+### measure
+
+
+
+`measure(qargs=None)`
+
+Measure subsystems and return outcome and post-measure state.
+
+Note that this function uses the QuantumStates internal random number generator for sampling the measurement outcome. The RNG seed can be set using the [`seed()`](#qiskit.quantum_info.StabilizerState.seed "qiskit.quantum_info.StabilizerState.seed") method.
+
+**Parameters**
+
+**qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – subsystems to sample measurements for, if None sample measurement of all subsystems (Default: None).
+
+**Returns**
+
+**the pair `(outcome, state)` where `outcome` is the**
+
+measurement outcome string label, and `state` is the collapsed post-measurement stabilizer state for the corresponding outcome.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")
+
+### probabilities
+
+
+
+`probabilities(qargs=None, decimals=None)`
+
+Return the subsystem measurement probability vector.
+
+Measurement probabilities are with respect to measurement in the computation (diagonal) basis.
+
+**Parameters**
+
+* **qargs** (*None or* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – subsystems to return probabilities for, if None return for all subsystems (Default: None).
+* **decimals** (*None or* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of decimal places to round values. If None no rounding is done (Default: None).
+
+**Returns**
+
+The Numpy vector array of probabilities.
+
+**Return type**
+
+np.array
+
+### probabilities\_dict
+
+
+
+`probabilities_dict(qargs=None, decimals=None)`
+
+Return the subsystem measurement probability dictionary.
+
+Measurement probabilities are with respect to measurement in the computation (diagonal) basis.
+
+This dictionary representation uses a Ket-like notation where the dictionary keys are qudit strings for the subsystem basis vectors. If any subsystem has a dimension greater than 10 comma delimiters are inserted between integers so that subsystems can be distinguished.
+
+**Parameters**
+
+* **qargs** (*None or* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – subsystems to return probabilities for, if None return for all subsystems (Default: None).
+* **decimals** (*None or* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of decimal places to round values. If None no rounding is done (Default: None).
+
+**Returns**
+
+The measurement probabilities in dict (ket) form.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+### purity
+
+
+
+`purity()`
+
+Return the purity of the quantum state, which equals to 1, since it is always a pure state.
+
+**Returns**
+
+the purity (should equal 1).
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if input is not a StabilizerState.
+
+### reset
+
+
+
+`reset(qargs=None)`
+
+Reset state or subsystems to the 0-state.
+
+**Parameters**
+
+**qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – subsystems to reset, if None all subsystems will be reset to their 0-state (Default: None).
+
+**Returns**
+
+the reset state.
+
+**Return type**
+
+[StabilizerState](#qiskit.quantum_info.StabilizerState "qiskit.quantum_info.StabilizerState")
+
+**Additional Information:**
+
+If all subsystems are reset this will return the ground state on all subsystems. If only some subsystems are reset this function will perform a measurement on those subsystems and evolve the subsystems so that the collapsed post-measurement states are rotated to the 0-state. The RNG seed for this sampling can be set using the [`seed()`](#qiskit.quantum_info.StabilizerState.seed "qiskit.quantum_info.StabilizerState.seed") method.
+
+### sample\_counts
+
+
+
+`sample_counts(shots, qargs=None)`
+
+Sample a dict of qubit measurement outcomes in the computational basis.
+
+**Parameters**
+
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of samples to generate.
+* **qargs** (*None or* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – subsystems to sample measurements for, if None sample measurement of all subsystems (Default: None).
+
+**Returns**
+
+sampled counts dictionary.
+
+**Return type**
+
+[Counts](qiskit.result.Counts "qiskit.result.Counts")
+
+Additional Information:
+
+> This function *samples* measurement outcomes using the measure [`probabilities()`](#qiskit.quantum_info.StabilizerState.probabilities "qiskit.quantum_info.StabilizerState.probabilities") for the current state and qargs. It does not actually implement the measurement so the current state is not modified.
+>
+> The seed for random number generator used for sampling can be set to a fixed value by using the stats [`seed()`](#qiskit.quantum_info.StabilizerState.seed "qiskit.quantum_info.StabilizerState.seed") method.
+
+### sample\_memory
+
+
+
+`sample_memory(shots, qargs=None)`
+
+Sample a list of qubit measurement outcomes in the computational basis.
+
+**Parameters**
+
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of samples to generate.
+* **qargs** (*None or* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – subsystems to sample measurements for, if None sample measurement of all subsystems (Default: None).
+
+**Returns**
+
+list of sampled counts if the order sampled.
+
+**Return type**
+
+np.array
+
+Additional Information:
+
+> This function implements the measurement [`measure()`](#qiskit.quantum_info.StabilizerState.measure "qiskit.quantum_info.StabilizerState.measure") method.
+>
+> The seed for random number generator used for sampling can be set to a fixed value by using the stats [`seed()`](#qiskit.quantum_info.StabilizerState.seed "qiskit.quantum_info.StabilizerState.seed") method.
+
+### seed
+
+
+
+`seed(value=None)`
+
+Set the seed for the quantum state RNG.
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return the tensor product stabilizer state self ⊗ other.
+
+**Parameters**
+
+**other** ([*StabilizerState*](#qiskit.quantum_info.StabilizerState "qiskit.quantum_info.StabilizerState")) – a stabilizer state object.
+
+**Returns**
+
+the tensor product operator self ⊗ other.
+
+**Return type**
+
+[StabilizerState](#qiskit.quantum_info.StabilizerState "qiskit.quantum_info.StabilizerState")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if other is not a StabilizerState.
+
+### to\_operator
+
+
+
+`to_operator()`
+
+Convert state to matrix operator class
+
+**Return type**
+
+[*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.operators.operator.Operator")
+
+### trace
+
+
+
+`trace()`
+
+Return the trace of the stabilizer state as a density matrix, which equals to 1, since it is always a pure state.
+
+**Returns**
+
+the trace (should equal 1).
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if input is not a StabilizerState.
+
diff --git a/docs/api/qiskit/0.46/qiskit.quantum_info.Statevector.md b/docs/api/qiskit/0.46/qiskit.quantum_info.Statevector.md
new file mode 100644
index 00000000000..d2fbdbb6bc8
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.quantum_info.Statevector.md
@@ -0,0 +1,732 @@
+---
+title: Statevector
+description: API reference for qiskit.quantum_info.Statevector
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.quantum_info.Statevector
+---
+
+# Statevector
+
+
+
+`qiskit.quantum_info.Statevector(data, dims=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/states/statevector.py "view source code")
+
+Bases: `QuantumState`, `TolerancesMixin`
+
+Statevector class
+
+Initialize a statevector object.
+
+**Parameters**
+
+* **or** (*data (np.array or* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or*[*Statevector*](#qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") *or*[*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator") *or*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – qiskit.circuit.Instruction): Data from which the statevector can be constructed. This can be either a complex vector, another statevector, a `Operator` with only one column or a `QuantumCircuit` or `Instruction`. If the data is a circuit or instruction, the statevector is constructed by assuming that all qubits are initialized to the zero state.
+* **dims** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – Optional. The subsystem dimension of the state (See additional information).
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if input data is not valid.
+
+**Additional Information:**
+
+The `dims` kwarg can be None, an integer, or an iterable of integers.
+
+* `Iterable` – the subsystem dimensions are the values in the list with the total number of subsystems given by the length of the list.
+* `Int` or `None` – the length of the input vector specifies the total dimension of the density matrix. If it is a power of two the state will be initialized as an N-qubit state. If it is not a power of two the state will have a single d-dimensional subsystem.
+
+## Attributes
+
+
+
+### atol
+
+`= 1e-08`
+
+
+
+### data
+
+Return data.
+
+
+
+### dim
+
+Return total state dimension.
+
+
+
+### num\_qubits
+
+Return the number of qubits if a N-qubit state or None otherwise.
+
+
+
+### rtol
+
+`= 1e-05`
+
+
+
+### settings
+
+Return settings.
+
+## Methods
+
+### conjugate
+
+
+
+`conjugate()`
+
+Return the conjugate of the operator.
+
+**Return type**
+
+[*Statevector*](#qiskit.quantum_info.Statevector "qiskit.quantum_info.states.statevector.Statevector")
+
+### copy
+
+
+
+`copy()`
+
+Make a copy of current operator.
+
+### dims
+
+
+
+`dims(qargs=None)`
+
+Return tuple of input dimension for specified subsystems.
+
+### draw
+
+
+
+`draw(output=None, **drawer_args)`
+
+Return a visualization of the Statevector.
+
+**repr**: ASCII TextMatrix of the state’s `__repr__`.
+
+**text**: ASCII TextMatrix that can be printed in the console.
+
+**latex**: An IPython Latex object for displaying in Jupyter Notebooks.
+
+**latex\_source**: Raw, uncompiled ASCII source to generate array using LaTeX.
+
+**qsphere**: Matplotlib figure, rendering of statevector using plot\_state\_qsphere().
+
+**hinton**: Matplotlib figure, rendering of statevector using plot\_state\_hinton().
+
+**bloch**: Matplotlib figure, rendering of statevector using plot\_bloch\_multivector().
+
+**city**: Matplotlib figure, rendering of statevector using plot\_state\_city().
+
+**paulivec**: Matplotlib figure, rendering of statevector using plot\_state\_paulivec().
+
+**Parameters**
+
+* **output** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Select the output method to use for drawing the state. Valid choices are repr, text, latex, latex\_source, qsphere, hinton, bloch, city, or paulivec. Default is repr. Default can be changed by adding the line `state_drawer = ` to `~/.qiskit/settings.conf` under `[default]`.
+* **drawer\_args** – Arguments to be passed directly to the relevant drawing function or constructor (TextMatrix(), array\_to\_latex(), plot\_state\_qsphere(), plot\_state\_hinton() or plot\_bloch\_multivector()). See the relevant function under qiskit.visualization for that function’s documentation.
+
+**Returns**
+
+`matplotlib.Figure` or [`str`](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") or `TextMatrix` or `IPython.display.Latex`: Drawing of the Statevector.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – when an invalid output method is selected.
+
+**Examples**
+
+Plot one of the Bell states
+
+```python
+from numpy import sqrt
+from qiskit.quantum_info import Statevector
+sv=Statevector([1/sqrt(2), 0, 0, -1/sqrt(2)])
+sv.draw(output='hinton')
+```
+
+
+
+### equiv
+
+
+
+`equiv(other, rtol=None, atol=None)`
+
+Return True if other is equivalent as a statevector up to global phase.
+
+
+ If other is not a Statevector, but can be used to initialize a statevector object, this will check that Statevector(other) is equivalent to the current statevector up to global phase.
+
+
+**Parameters**
+
+* **other** ([*Statevector*](#qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector")) – an object from which a `Statevector` can be constructed.
+* **rtol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – relative tolerance value for comparison.
+* **atol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – absolute tolerance value for comparison.
+
+**Returns**
+
+True if statevectors are equivalent up to global phase.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### evolve
+
+
+
+`evolve(other, qargs=None)`
+
+Evolve a quantum state by the operator.
+
+**Parameters**
+
+* **other** ([*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator") *|*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *|*[*circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction")) – The operator to evolve by.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – a list of Statevector subsystem positions to apply the operator on.
+
+**Returns**
+
+the output quantum state.
+
+**Return type**
+
+[Statevector](#qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the operator dimension does not match the specified Statevector subsystem dimensions.
+
+### expand
+
+
+
+`expand(other)`
+
+Return the tensor product state other ⊗ self.
+
+**Parameters**
+
+**other** ([*Statevector*](#qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector")) – a quantum state object.
+
+**Returns**
+
+the tensor product state other ⊗ self.
+
+**Return type**
+
+[Statevector](#qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if other is not a quantum state.
+
+### expectation\_value
+
+
+
+`expectation_value(oper, qargs=None)`
+
+Compute the expectation value of an operator.
+
+**Parameters**
+
+* **oper** ([*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – an operator to evaluate expval of.
+* **qargs** (*None or* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – subsystems to apply operator on.
+
+**Returns**
+
+the expectation value.
+
+**Return type**
+
+[complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")
+
+### from\_instruction
+
+
+
+`classmethod from_instruction(instruction)`
+
+Return the output statevector of an instruction.
+
+The statevector is initialized in the state $|{0,\ldots,0}\rangle$ of the same number of qubits as the input instruction or circuit, evolved by the input instruction, and the output statevector returned.
+
+**Parameters**
+
+**instruction** ([*qiskit.circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction") *or*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – instruction or circuit
+
+**Returns**
+
+The final statevector.
+
+**Return type**
+
+[Statevector](#qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the instruction contains invalid instructions for the statevector simulation.
+
+### from\_int
+
+
+
+`static from_int(i, dims)`
+
+Return a computational basis statevector.
+
+**Parameters**
+
+* **i** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the basis state element.
+* **dims** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – The subsystem dimensions of the statevector (See additional information).
+
+**Returns**
+
+The computational basis state $|i\rangle$.
+
+**Return type**
+
+[Statevector](#qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector")
+
+**Additional Information:**
+
+The `dims` kwarg can be an integer or an iterable of integers.
+
+* `Iterable` – the subsystem dimensions are the values in the list with the total number of subsystems given by the length of the list.
+* `Int` – the integer specifies the total dimension of the state. If it is a power of two the state will be initialized as an N-qubit state. If it is not a power of two the state will have a single d-dimensional subsystem.
+
+### from\_label
+
+
+
+`classmethod from_label(label)`
+
+Return a tensor product of Pauli X,Y,Z eigenstates.
+
+| Label | Statevector |
+| ----- | ------------------------------- |
+| `"0"` | $[1, 0]$ |
+| `"1"` | $[0, 1]$ |
+| `"+"` | $[1 / \sqrt{2}, 1 / \sqrt{2}]$ |
+| `"-"` | $[1 / \sqrt{2}, -1 / \sqrt{2}]$ |
+| `"r"` | $[1 / \sqrt{2}, i / \sqrt{2}]$ |
+| `"l"` | $[1 / \sqrt{2}, -i / \sqrt{2}]$ |
+
+**Parameters**
+
+**label** (*string*) – a eigenstate string ket label (see table for allowed values).
+
+**Returns**
+
+The N-qubit basis state density matrix.
+
+**Return type**
+
+[Statevector](#qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the label contains invalid characters, or the length of the label is larger than an explicitly specified num\_qubits.
+
+### inner
+
+
+
+`inner(other)`
+
+Return the inner product of self and other as $\langle self| other \rangle$.
+
+**Parameters**
+
+**other** ([*Statevector*](#qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector")) – a quantum state object.
+
+**Returns**
+
+the inner product of self and other, $\langle self| other \rangle$.
+
+**Return type**
+
+np.complex128
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if other is not a quantum state or has different dimension.
+
+### is\_valid
+
+
+
+`is_valid(atol=None, rtol=None)`
+
+Return True if a Statevector has norm 1.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### measure
+
+
+
+`measure(qargs=None)`
+
+Measure subsystems and return outcome and post-measure state.
+
+Note that this function uses the QuantumStates internal random number generator for sampling the measurement outcome. The RNG seed can be set using the [`seed()`](#qiskit.quantum_info.Statevector.seed "qiskit.quantum_info.Statevector.seed") method.
+
+**Parameters**
+
+**qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – subsystems to sample measurements for, if None sample measurement of all subsystems (Default: None).
+
+**Returns**
+
+**the pair `(outcome, state)` where `outcome` is the**
+
+measurement outcome string label, and `state` is the collapsed post-measurement state for the corresponding outcome.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")
+
+### probabilities
+
+
+
+`probabilities(qargs=None, decimals=None)`
+
+Return the subsystem measurement probability vector.
+
+Measurement probabilities are with respect to measurement in the computation (diagonal) basis.
+
+**Parameters**
+
+* **qargs** (*None or* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – subsystems to return probabilities for, if None return for all subsystems (Default: None).
+* **decimals** (*None or* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of decimal places to round values. If None no rounding is done (Default: None).
+
+**Returns**
+
+The Numpy vector array of probabilities.
+
+**Return type**
+
+np.array
+
+**Examples**
+
+Consider a 2-qubit product state $|\psi\rangle=|+\rangle\otimes|0\rangle$.
+
+```python
+from qiskit.quantum_info import Statevector
+
+psi = Statevector.from_label('+0')
+
+# Probabilities for measuring both qubits
+probs = psi.probabilities()
+print('probs: {}'.format(probs))
+
+# Probabilities for measuring only qubit-0
+probs_qubit_0 = psi.probabilities([0])
+print('Qubit-0 probs: {}'.format(probs_qubit_0))
+
+# Probabilities for measuring only qubit-1
+probs_qubit_1 = psi.probabilities([1])
+print('Qubit-1 probs: {}'.format(probs_qubit_1))
+```
+
+```python
+probs: [0.5 0. 0.5 0. ]
+Qubit-0 probs: [1. 0.]
+Qubit-1 probs: [0.5 0.5]
+```
+
+We can also permute the order of qubits in the `qargs` list to change the qubit position in the probabilities output
+
+```python
+from qiskit.quantum_info import Statevector
+
+psi = Statevector.from_label('+0')
+
+# Probabilities for measuring both qubits
+probs = psi.probabilities([0, 1])
+print('probs: {}'.format(probs))
+
+# Probabilities for measuring both qubits
+# but swapping qubits 0 and 1 in output
+probs_swapped = psi.probabilities([1, 0])
+print('Swapped probs: {}'.format(probs_swapped))
+```
+
+```python
+probs: [0.5 0. 0.5 0. ]
+Swapped probs: [0.5 0.5 0. 0. ]
+```
+
+### probabilities\_dict
+
+
+
+`probabilities_dict(qargs=None, decimals=None)`
+
+Return the subsystem measurement probability dictionary.
+
+Measurement probabilities are with respect to measurement in the computation (diagonal) basis.
+
+This dictionary representation uses a Ket-like notation where the dictionary keys are qudit strings for the subsystem basis vectors. If any subsystem has a dimension greater than 10 comma delimiters are inserted between integers so that subsystems can be distinguished.
+
+**Parameters**
+
+* **qargs** (*None or* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – subsystems to return probabilities for, if None return for all subsystems (Default: None).
+* **decimals** (*None or* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of decimal places to round values. If None no rounding is done (Default: None).
+
+**Returns**
+
+The measurement probabilities in dict (ket) form.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+### purity
+
+
+
+`purity()`
+
+Return the purity of the quantum state.
+
+**Return type**
+
+*float64*
+
+### reset
+
+
+
+`reset(qargs=None)`
+
+Reset state or subsystems to the 0-state.
+
+**Parameters**
+
+**qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – subsystems to reset, if None all subsystems will be reset to their 0-state (Default: None).
+
+**Returns**
+
+the reset state.
+
+**Return type**
+
+[Statevector](#qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector")
+
+**Additional Information:**
+
+If all subsystems are reset this will return the ground state on all subsystems. If only a some subsystems are reset this function will perform a measurement on those subsystems and evolve the subsystems so that the collapsed post-measurement states are rotated to the 0-state. The RNG seed for this sampling can be set using the [`seed()`](#qiskit.quantum_info.Statevector.seed "qiskit.quantum_info.Statevector.seed") method.
+
+### reverse\_qargs
+
+
+
+`reverse_qargs()`
+
+Return a Statevector with reversed subsystem ordering.
+
+For a tensor product state this is equivalent to reversing the order of tensor product subsystems. For a statevector $|\psi \rangle = |\psi_{n-1} \rangle \otimes ... \otimes |\psi_0 \rangle$ the returned statevector will be $|\psi_{0} \rangle \otimes ... \otimes |\psi_{n-1} \rangle$.
+
+**Returns**
+
+the Statevector with reversed subsystem order.
+
+**Return type**
+
+[Statevector](#qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector")
+
+### sample\_counts
+
+
+
+`sample_counts(shots, qargs=None)`
+
+Sample a dict of qubit measurement outcomes in the computational basis.
+
+**Parameters**
+
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of samples to generate.
+* **qargs** (*None or* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – subsystems to sample measurements for, if None sample measurement of all subsystems (Default: None).
+
+**Returns**
+
+sampled counts dictionary.
+
+**Return type**
+
+[Counts](qiskit.result.Counts "qiskit.result.Counts")
+
+Additional Information:
+
+> This function *samples* measurement outcomes using the measure [`probabilities()`](#qiskit.quantum_info.Statevector.probabilities "qiskit.quantum_info.Statevector.probabilities") for the current state and qargs. It does not actually implement the measurement so the current state is not modified.
+>
+> The seed for random number generator used for sampling can be set to a fixed value by using the stats [`seed()`](#qiskit.quantum_info.Statevector.seed "qiskit.quantum_info.Statevector.seed") method.
+
+### sample\_memory
+
+
+
+`sample_memory(shots, qargs=None)`
+
+Sample a list of qubit measurement outcomes in the computational basis.
+
+**Parameters**
+
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of samples to generate.
+* **qargs** (*None or* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – subsystems to sample measurements for, if None sample measurement of all subsystems (Default: None).
+
+**Returns**
+
+list of sampled counts if the order sampled.
+
+**Return type**
+
+np.array
+
+Additional Information:
+
+> This function *samples* measurement outcomes using the measure [`probabilities()`](#qiskit.quantum_info.Statevector.probabilities "qiskit.quantum_info.Statevector.probabilities") for the current state and qargs. It does not actually implement the measurement so the current state is not modified.
+>
+> The seed for random number generator used for sampling can be set to a fixed value by using the stats [`seed()`](#qiskit.quantum_info.Statevector.seed "qiskit.quantum_info.Statevector.seed") method.
+
+### seed
+
+
+
+`seed(value=None)`
+
+Set the seed for the quantum state RNG.
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return the tensor product state self ⊗ other.
+
+**Parameters**
+
+**other** ([*Statevector*](#qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector")) – a quantum state object.
+
+**Returns**
+
+the tensor product operator self ⊗ other.
+
+**Return type**
+
+[Statevector](#qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if other is not a quantum state.
+
+### to\_dict
+
+
+
+`to_dict(decimals=None)`
+
+Convert the statevector to dictionary form.
+
+This dictionary representation uses a Ket-like notation where the dictionary keys are qudit strings for the subsystem basis vectors. If any subsystem has a dimension greater than 10 comma delimiters are inserted between integers so that subsystems can be distinguished.
+
+**Parameters**
+
+**decimals** (*None or* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of decimal places to round values. If None no rounding is done (Default: None).
+
+**Returns**
+
+the dictionary form of the Statevector.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+**Example**
+
+The ket-form of a 2-qubit statevector $|\psi\rangle = |-\rangle\otimes |0\rangle$
+
+```python
+from qiskit.quantum_info import Statevector
+
+psi = Statevector.from_label('-0')
+print(psi.to_dict())
+```
+
+```python
+{'00': (0.7071067811865475+0j), '10': (-0.7071067811865475+0j)}
+```
+
+For non-qubit subsystems the integer range can go from 0 to 9. For example in a qutrit system
+
+```python
+import numpy as np
+from qiskit.quantum_info import Statevector
+
+vec = np.zeros(9)
+vec[0] = 1 / np.sqrt(2)
+vec[-1] = 1 / np.sqrt(2)
+psi = Statevector(vec, dims=(3, 3))
+print(psi.to_dict())
+```
+
+```python
+{'00': (0.7071067811865475+0j), '22': (0.7071067811865475+0j)}
+```
+
+For large subsystem dimensions delimiters are required. The following example is for a 20-dimensional system consisting of a qubit and 10-dimensional qudit.
+
+```python
+import numpy as np
+from qiskit.quantum_info import Statevector
+
+vec = np.zeros(2 * 10)
+vec[0] = 1 / np.sqrt(2)
+vec[-1] = 1 / np.sqrt(2)
+psi = Statevector(vec, dims=(2, 10))
+print(psi.to_dict())
+```
+
+```python
+{'00': (0.7071067811865475+0j), '91': (0.7071067811865475+0j)}
+```
+
+### to\_operator
+
+
+
+`to_operator()`
+
+Convert state to a rank-1 projector operator
+
+**Return type**
+
+[*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.operators.operator.Operator")
+
+### trace
+
+
+
+`trace()`
+
+Return the trace of the quantum state as a density matrix.
+
+**Return type**
+
+*float64*
+
diff --git a/docs/api/qiskit/0.46/qiskit.quantum_info.Stinespring.md b/docs/api/qiskit/0.46/qiskit.quantum_info.Stinespring.md
new file mode 100644
index 00000000000..b4f3bdcff37
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.quantum_info.Stinespring.md
@@ -0,0 +1,399 @@
+---
+title: Stinespring
+description: API reference for qiskit.quantum_info.Stinespring
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.quantum_info.Stinespring
+---
+
+# Stinespring
+
+
+
+`qiskit.quantum_info.Stinespring(data, input_dims=None, output_dims=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/channel/stinespring.py "view source code")
+
+Bases: `QuantumChannel`
+
+Stinespring representation of a quantum channel.
+
+The Stinespring representation of a quantum channel $\mathcal{E}$ is a rectangular matrix $A$ such that the evolution of a [`DensityMatrix`](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix") $\rho$ is given by
+
+$$
+\mathcal{E}(ρ) = \mbox{Tr}_2\left[A ρ A^\dagger\right]
+$$
+
+where $\mbox{Tr}_2$ is the [`partial_trace()`](quantum_info#qiskit.quantum_info.partial_trace "qiskit.quantum_info.partial_trace") over subsystem 2.
+
+A general operator map $\mathcal{G}$ can also be written using the generalized Stinespring representation which is given by two matrices $A$, $B$ such that
+
+$$
+\mathcal{G}(ρ) = \mbox{Tr}_2\left[A ρ B^\dagger\right]
+$$
+
+See reference \[1] for further details.
+
+**References**
+
+1. C.J. Wood, J.D. Biamonte, D.G. Cory, *Tensor networks and graphical calculus for open quantum systems*, Quant. Inf. Comp. 15, 0579-0811 (2015). [arXiv:1111.6950 \[quant-ph\]](https://arxiv.org/abs/1111.6950)
+
+Initialize a quantum channel Stinespring operator.
+
+**Parameters**
+
+* **or** (*data (*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – Instruction or BaseOperator or matrix): data to initialize superoperator.
+* **input\_dims** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the input subsystem dimensions. \[Default: None]
+* **output\_dims** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the output subsystem dimensions. \[Default: None]
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if input data cannot be initialized as a a list of Kraus matrices.
+
+**Additional Information:**
+
+If the input or output dimensions are None, they will be automatically determined from the input data. This can fail for the Stinespring operator if the output dimension cannot be automatically determined.
+
+## Attributes
+
+
+
+### atol
+
+`= 1e-08`
+
+
+
+### data
+
+
+
+### dim
+
+Return tuple (input\_shape, output\_shape).
+
+
+
+### num\_qubits
+
+Return the number of qubits if a N-qubit operator or None otherwise.
+
+
+
+### qargs
+
+Return the qargs for the operator.
+
+
+
+### rtol
+
+`= 1e-05`
+
+
+
+### settings
+
+Return settings.
+
+## Methods
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return the adjoint quantum channel.
+
+
+ This is equivalent to the matrix Hermitian conjugate in the [`SuperOp`](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") representation ie. for a channel $\mathcal{E}$, the SuperOp of the adjoint channel $\mathcal{{E}}^\dagger$ is $S_{\mathcal{E}^\dagger} = S_{\mathcal{E}}^\dagger$.
+
+
+**Return type**
+
+*Self*
+
+### compose
+
+
+
+`compose(other, qargs=None, front=False)`
+
+Return the operator composition with another Stinespring.
+
+**Parameters**
+
+* **other** ([*Stinespring*](#qiskit.quantum_info.Stinespring "qiskit.quantum_info.Stinespring")) – a Stinespring object.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – Optional, a list of subsystem positions to apply other on. If None apply on all subsystems (default: None).
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True compose using right operator multiplication, instead of left multiplication \[default: False].
+
+**Returns**
+
+The composed Stinespring.
+
+**Return type**
+
+[Stinespring](#qiskit.quantum_info.Stinespring "qiskit.quantum_info.Stinespring")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if other cannot be converted to an operator, or has incompatible dimensions for specified subsystems.
+
+
+ Composition (`&`) by default is defined as left matrix multiplication for matrix operators, while `@` (equivalent to [`dot()`](#qiskit.quantum_info.Stinespring.dot "qiskit.quantum_info.Stinespring.dot")) is defined as right matrix multiplication. That is that `A & B == A.compose(B)` is equivalent to `B @ A == B.dot(A)` when `A` and `B` are of the same type.
+
+ Setting the `front=True` kwarg changes this to right matrix multiplication and is equivalent to the [`dot()`](#qiskit.quantum_info.Stinespring.dot "qiskit.quantum_info.Stinespring.dot") method `A.dot(B) == A.compose(B, front=True)`.
+
+
+### conjugate
+
+
+
+`conjugate()`
+
+Return the conjugate quantum channel.
+
+
+ This is equivalent to the matrix complex conjugate in the [`SuperOp`](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") representation ie. for a channel $\mathcal{E}$, the SuperOp of the conjugate channel $\overline{{\mathcal{{E}}}}$ is $S_{\overline{\mathcal{E}^\dagger}} = \overline{S_{\mathcal{E}}}$.
+
+
+### copy
+
+
+
+`copy()`
+
+Make a deep copy of current operator.
+
+### dot
+
+
+
+`dot(other, qargs=None)`
+
+Return the right multiplied operator self \* other.
+
+**Parameters**
+
+* **other** ([*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – an operator object.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – Optional, a list of subsystem positions to apply other on. If None apply on all subsystems (default: None).
+
+**Returns**
+
+The right matrix multiplied Operator.
+
+**Return type**
+
+[Operator](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")
+
+
+ The dot product can be obtained using the `@` binary operator. Hence `a.dot(b)` is equivalent to `a @ b`.
+
+
+### expand
+
+
+
+`expand(other)`
+
+Return the reverse-order tensor product with another Stinespring.
+
+**Parameters**
+
+**other** ([*Stinespring*](#qiskit.quantum_info.Stinespring "qiskit.quantum_info.Stinespring")) – a Stinespring object.
+
+**Returns**
+
+**the tensor product $b \otimes a$, where $a$**
+
+is the current Stinespring, and $b$ is the other Stinespring.
+
+**Return type**
+
+[Stinespring](#qiskit.quantum_info.Stinespring "qiskit.quantum_info.Stinespring")
+
+### input\_dims
+
+
+
+`input_dims(qargs=None)`
+
+Return tuple of input dimension for specified subsystems.
+
+### is\_cp
+
+
+
+`is_cp(atol=None, rtol=None)`
+
+Test if Choi-matrix is completely-positive (CP)
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### is\_cptp
+
+
+
+`is_cptp(atol=None, rtol=None)`
+
+Return True if completely-positive trace-preserving.
+
+### is\_tp
+
+
+
+`is_tp(atol=None, rtol=None)`
+
+Test if a channel is trace-preserving (TP)
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### is\_unitary
+
+
+
+`is_unitary(atol=None, rtol=None)`
+
+Return True if QuantumChannel is a unitary channel.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### output\_dims
+
+
+
+`output_dims(qargs=None)`
+
+Return tuple of output dimension for specified subsystems.
+
+### power
+
+
+
+`power(n)`
+
+Return the power of the quantum channel.
+
+**Parameters**
+
+**n** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the power exponent.
+
+**Returns**
+
+the channel $\mathcal{{E}} ^n$.
+
+**Return type**
+
+[SuperOp](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input and output dimensions of the SuperOp are not equal.
+
+
+ For non-positive or non-integer exponents the power is defined as the matrix power of the [`SuperOp`](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") representation ie. for a channel $\mathcal{{E}}$, the SuperOp of the powered channel $\mathcal{{E}}^\n$ is $S_{{\mathcal{{E}}^n}} = S_{{\mathcal{{E}}}}^n$.
+
+
+### reshape
+
+
+
+`reshape(input_dims=None, output_dims=None, num_qubits=None)`
+
+Return a shallow copy with reshaped input and output subsystem dimensions.
+
+**Parameters**
+
+* **input\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem input dimensions. If None the original input dims will be preserved \[Default: None].
+* **output\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem output dimensions. If None the original output dims will be preserved \[Default: None].
+* **num\_qubits** (*None or* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – reshape to an N-qubit operator \[Default: None].
+
+**Returns**
+
+returns self with reshaped input and output dimensions.
+
+**Return type**
+
+BaseOperator
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if combined size of all subsystem input dimension or subsystem output dimensions is not constant.
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return the tensor product with another Stinespring.
+
+**Parameters**
+
+**other** ([*Stinespring*](#qiskit.quantum_info.Stinespring "qiskit.quantum_info.Stinespring")) – a Stinespring object.
+
+**Returns**
+
+**the tensor product $a \otimes b$, where $a$**
+
+is the current Stinespring, and $b$ is the other Stinespring.
+
+**Return type**
+
+[Stinespring](#qiskit.quantum_info.Stinespring "qiskit.quantum_info.Stinespring")
+
+
+ The tensor product can be obtained using the `^` binary operator. Hence `a.tensor(b)` is equivalent to `a ^ b`.
+
+
+### to\_instruction
+
+
+
+`to_instruction()`
+
+Convert to a Kraus or UnitaryGate circuit instruction.
+
+If the channel is unitary it will be added as a unitary gate, otherwise it will be added as a kraus simulator instruction.
+
+**Returns**
+
+A kraus instruction for the channel.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if input data is not an N-qubit CPTP quantum channel.
+
+### to\_operator
+
+
+
+`to_operator()`
+
+Try to convert channel to a unitary representation Operator.
+
+**Return type**
+
+[*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.operators.operator.Operator")
+
+### transpose
+
+
+
+`transpose()`
+
+Return the transpose quantum channel.
+
+
+ This is equivalent to the matrix transpose in the [`SuperOp`](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") representation, ie. for a channel $\mathcal{E}$, the SuperOp of the transpose channel $\mathcal{{E}}^T$ is $S_{mathcal{E}^T} = S_{\mathcal{E}}^T$.
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.quantum_info.SuperOp.md b/docs/api/qiskit/0.46/qiskit.quantum_info.SuperOp.md
new file mode 100644
index 00000000000..f52c92569a8
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.quantum_info.SuperOp.md
@@ -0,0 +1,395 @@
+---
+title: SuperOp
+description: API reference for qiskit.quantum_info.SuperOp
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.quantum_info.SuperOp
+---
+
+# SuperOp
+
+
+
+`qiskit.quantum_info.SuperOp(data, input_dims=None, output_dims=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/channel/superop.py "view source code")
+
+Bases: `QuantumChannel`
+
+Superoperator representation of a quantum channel.
+
+The Superoperator representation of a quantum channel $\mathcal{E}$ is a matrix $S$ such that the evolution of a [`DensityMatrix`](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix") $\rho$ is given by
+
+$$
+|\mathcal{E}(\rho)\rangle\!\rangle = S |\rho\rangle\!\rangle
+$$
+
+where the double-ket notation $|A\rangle\!\rangle$ denotes a vector formed by stacking the columns of the matrix $A$ *(column-vectorization)*.
+
+See reference \[1] for further details.
+
+**References**
+
+1. C.J. Wood, J.D. Biamonte, D.G. Cory, *Tensor networks and graphical calculus for open quantum systems*, Quant. Inf. Comp. 15, 0579-0811 (2015). [arXiv:1111.6950 \[quant-ph\]](https://arxiv.org/abs/1111.6950)
+
+Initialize a quantum channel Superoperator operator.
+
+**Parameters**
+
+* **or** (*data (*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – Instruction or BaseOperator or matrix): data to initialize superoperator.
+* **input\_dims** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the input subsystem dimensions. \[Default: None]
+* **output\_dims** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the output subsystem dimensions. \[Default: None]
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if input data cannot be initialized as a superoperator.
+
+**Additional Information:**
+
+If the input or output dimensions are None, they will be automatically determined from the input data. If the input data is a Numpy array of shape (4\*\*N, 4\*\*N) qubit systems will be used. If the input operator is not an N-qubit operator, it will assign a single subsystem with dimension specified by the shape of the input.
+
+## Attributes
+
+
+
+### atol
+
+`= 1e-08`
+
+
+
+### data
+
+Return data.
+
+
+
+### dim
+
+Return tuple (input\_shape, output\_shape).
+
+
+
+### num\_qubits
+
+Return the number of qubits if a N-qubit operator or None otherwise.
+
+
+
+### qargs
+
+Return the qargs for the operator.
+
+
+
+### rtol
+
+`= 1e-05`
+
+
+
+### settings
+
+Return settings.
+
+## Methods
+
+### adjoint
+
+
+
+`adjoint()`
+
+Return the adjoint quantum channel.
+
+
+ This is equivalent to the matrix Hermitian conjugate in the [`SuperOp`](#qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") representation ie. for a channel $\mathcal{E}$, the SuperOp of the adjoint channel $\mathcal{{E}}^\dagger$ is $S_{\mathcal{E}^\dagger} = S_{\mathcal{E}}^\dagger$.
+
+
+### compose
+
+
+
+`compose(other, qargs=None, front=False)`
+
+Return the operator composition with another SuperOp.
+
+**Parameters**
+
+* **other** ([*SuperOp*](#qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp")) – a SuperOp object.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – Optional, a list of subsystem positions to apply other on. If None apply on all subsystems (default: None).
+* **front** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True compose using right operator multiplication, instead of left multiplication \[default: False].
+
+**Returns**
+
+The composed SuperOp.
+
+**Return type**
+
+[SuperOp](#qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if other cannot be converted to an operator, or has incompatible dimensions for specified subsystems.
+
+
+ Composition (`&`) by default is defined as left matrix multiplication for matrix operators, while `@` (equivalent to [`dot()`](#qiskit.quantum_info.SuperOp.dot "qiskit.quantum_info.SuperOp.dot")) is defined as right matrix multiplication. That is that `A & B == A.compose(B)` is equivalent to `B @ A == B.dot(A)` when `A` and `B` are of the same type.
+
+ Setting the `front=True` kwarg changes this to right matrix multiplication and is equivalent to the [`dot()`](#qiskit.quantum_info.SuperOp.dot "qiskit.quantum_info.SuperOp.dot") method `A.dot(B) == A.compose(B, front=True)`.
+
+
+### conjugate
+
+
+
+`conjugate()`
+
+Return the conjugate quantum channel.
+
+
+ This is equivalent to the matrix complex conjugate in the [`SuperOp`](#qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") representation ie. for a channel $\mathcal{E}$, the SuperOp of the conjugate channel $\overline{{\mathcal{{E}}}}$ is $S_{\overline{\mathcal{E}^\dagger}} = \overline{S_{\mathcal{E}}}$.
+
+
+### copy
+
+
+
+`copy()`
+
+Make a deep copy of current operator.
+
+### dot
+
+
+
+`dot(other, qargs=None)`
+
+Return the right multiplied operator self \* other.
+
+**Parameters**
+
+* **other** ([*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – an operator object.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – Optional, a list of subsystem positions to apply other on. If None apply on all subsystems (default: None).
+
+**Returns**
+
+The right matrix multiplied Operator.
+
+**Return type**
+
+[Operator](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")
+
+
+ The dot product can be obtained using the `@` binary operator. Hence `a.dot(b)` is equivalent to `a @ b`.
+
+
+### expand
+
+
+
+`expand(other)`
+
+Return the reverse-order tensor product with another SuperOp.
+
+**Parameters**
+
+**other** ([*SuperOp*](#qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp")) – a SuperOp object.
+
+**Returns**
+
+**the tensor product $b \otimes a$, where $a$**
+
+is the current SuperOp, and $b$ is the other SuperOp.
+
+**Return type**
+
+[SuperOp](#qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp")
+
+### input\_dims
+
+
+
+`input_dims(qargs=None)`
+
+Return tuple of input dimension for specified subsystems.
+
+### is\_cp
+
+
+
+`is_cp(atol=None, rtol=None)`
+
+Test if Choi-matrix is completely-positive (CP)
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### is\_cptp
+
+
+
+`is_cptp(atol=None, rtol=None)`
+
+Return True if completely-positive trace-preserving (CPTP).
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### is\_tp
+
+
+
+`is_tp(atol=None, rtol=None)`
+
+Test if a channel is trace-preserving (TP)
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### is\_unitary
+
+
+
+`is_unitary(atol=None, rtol=None)`
+
+Return True if QuantumChannel is a unitary channel.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### output\_dims
+
+
+
+`output_dims(qargs=None)`
+
+Return tuple of output dimension for specified subsystems.
+
+### power
+
+
+
+`power(n)`
+
+Return the power of the quantum channel.
+
+**Parameters**
+
+**n** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – the power exponent.
+
+**Returns**
+
+the channel $\mathcal{{E}} ^n$.
+
+**Return type**
+
+[SuperOp](#qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input and output dimensions of the SuperOp are not equal.
+
+
+ For non-positive or non-integer exponents the power is defined as the matrix power of the [`SuperOp`](#qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") representation ie. for a channel $\mathcal{{E}}$, the SuperOp of the powered channel $\mathcal{{E}}^\n$ is $S_{{\mathcal{{E}}^n}} = S_{{\mathcal{{E}}}}^n$.
+
+
+### reshape
+
+
+
+`reshape(input_dims=None, output_dims=None, num_qubits=None)`
+
+Return a shallow copy with reshaped input and output subsystem dimensions.
+
+**Parameters**
+
+* **input\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem input dimensions. If None the original input dims will be preserved \[Default: None].
+* **output\_dims** (*None or* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – new subsystem output dimensions. If None the original output dims will be preserved \[Default: None].
+* **num\_qubits** (*None or* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – reshape to an N-qubit operator \[Default: None].
+
+**Returns**
+
+returns self with reshaped input and output dimensions.
+
+**Return type**
+
+BaseOperator
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if combined size of all subsystem input dimension or subsystem output dimensions is not constant.
+
+### tensor
+
+
+
+`tensor(other)`
+
+Return the tensor product with another SuperOp.
+
+**Parameters**
+
+**other** ([*SuperOp*](#qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp")) – a SuperOp object.
+
+**Returns**
+
+**the tensor product $a \otimes b$, where $a$**
+
+is the current SuperOp, and $b$ is the other SuperOp.
+
+**Return type**
+
+[SuperOp](#qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp")
+
+
+ The tensor product can be obtained using the `^` binary operator. Hence `a.tensor(b)` is equivalent to `a ^ b`.
+
+
+### to\_instruction
+
+
+
+`to_instruction()`
+
+Convert to a Kraus or UnitaryGate circuit instruction.
+
+If the channel is unitary it will be added as a unitary gate, otherwise it will be added as a kraus simulator instruction.
+
+**Returns**
+
+A kraus instruction for the channel.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if input data is not an N-qubit CPTP quantum channel.
+
+### to\_operator
+
+
+
+`to_operator()`
+
+Try to convert channel to a unitary representation Operator.
+
+**Return type**
+
+[*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.operators.operator.Operator")
+
+### transpose
+
+
+
+`transpose()`
+
+Return the transpose quantum channel.
+
+
+ This is equivalent to the matrix transpose in the [`SuperOp`](#qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") representation, ie. for a channel $\mathcal{E}$, the SuperOp of the transpose channel $\mathcal{{E}}^T$ is $S_{mathcal{E}^T} = S_{\mathcal{E}}^T$.
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.quantum_info.Z2Symmetries.md b/docs/api/qiskit/0.46/qiskit.quantum_info.Z2Symmetries.md
new file mode 100644
index 00000000000..c409ad4063e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.quantum_info.Z2Symmetries.md
@@ -0,0 +1,192 @@
+---
+title: Z2Symmetries
+description: API reference for qiskit.quantum_info.Z2Symmetries
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.quantum_info.Z2Symmetries
+---
+
+# Z2Symmetries
+
+
+
+`qiskit.quantum_info.Z2Symmetries(symmetries, sq_paulis, sq_list, tapering_values=None, *, tol=1e-14)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/analysis/z2_symmetries.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+The \$Z\_2\$ symmetry converter identifies symmetries from the problem hamiltonian and uses them to provide a tapered - more efficient - representation of operators as Paulis for this problem. For each identified symmetry, one qubit can be eliminated in the Pauli representation at the cost of having to test two symmetry sectors (for the two possible eigenvalues - tapering values - of the symmetry). In certain problems such as the finding of the main operator’s ground state, one can a priori identify the symmetry sector of the solution and thus effectively reduce the computational overhead.
+
+The following attributes can be read and updated once the `Z2Symmetries` object has been constructed.
+
+
+
+### tapering\_values
+
+Values determining the sector.
+
+**Type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")] or None
+
+
+
+### tol
+
+The tolerance threshold for ignoring real and complex parts of a coefficient.
+
+**Type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+**References**
+
+**\[1]: Bravyi, S., et al, “Tapering off qubits to simulate fermionic Hamiltonians”**
+
+[arXiv:1701.08213](https://arxiv.org/abs/1701.08213)
+
+**Parameters**
+
+* **symmetries** (*Iterable\[*[*Pauli*](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli")*]*) – Object representing the list of \$Z\_2\$ symmetries. These correspond to the generators of the symmetry group \$langle tau\_1, tau\_2dots rangle>\$.
+* **sq\_paulis** (*Iterable\[*[*Pauli*](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli")*]*) – Object representing the list of single-qubit Pauli \$sigma^x\_\{q(i)}\$ anti-commuting with the symmetry \$tau\_i\$ and commuting with all the other symmetries \$tau\_\{jneq i}\$. These operators are used to construct the unitary Clifford operators.
+* **sq\_list** (*Iterable\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – The list of indices \$q(i)\$ of the single-qubit Pauli operators used to build the Clifford operators.
+* **tapering\_values** (*Iterable\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – List of eigenvalues determining the symmetry sector for each symmetry.
+* **tol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Tolerance threshold for ignoring real and complex parts of a coefficient.
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – Invalid paulis. The lists of symmetries, single-qubit paulis support paulis and tapering values must be of equal length. This length is the number of applied symmetries and translates directly to the number of eliminated qubits.
+
+## Attributes
+
+
+
+### cliffords
+
+Get clifford operators, built based on symmetries and single-qubit X.
+
+**Returns**
+
+A list of unitaries used to diagonalize the Hamiltonian.
+
+
+
+### settings
+
+Return operator settings.
+
+
+
+### sq\_list
+
+Return sq list.
+
+
+
+### sq\_paulis
+
+Return sq paulis.
+
+
+
+### symmetries
+
+Return symmetries.
+
+## Methods
+
+### convert\_clifford
+
+
+
+`convert_clifford(operator)`
+
+This method operates the first part of the tapering. It converts the operator by composing it with the clifford unitaries defined in the current symmetry.
+
+**Parameters**
+
+**operator** ([*SparsePauliOp*](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.operators.symplectic.sparse_pauli_op.SparsePauliOp")) – The to-be-tapered operator.
+
+**Returns**
+
+`SparsePauliOp` corresponding to the converted operator.
+
+**Return type**
+
+[*SparsePauliOp*](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.operators.symplectic.sparse_pauli_op.SparsePauliOp")
+
+### find\_z2\_symmetries
+
+
+
+`classmethod find_z2_symmetries(operator)`
+
+Finds Z2 Pauli-type symmetries of a [`SparsePauliOp`](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp").
+
+**Returns**
+
+A `Z2Symmetries` instance.
+
+**Return type**
+
+[*Z2Symmetries*](#qiskit.quantum_info.Z2Symmetries "qiskit.quantum_info.analysis.z2_symmetries.Z2Symmetries")
+
+### is\_empty
+
+
+
+`is_empty()`
+
+Check the z2\_symmetries is empty or not.
+
+**Returns**
+
+Empty or not.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### taper
+
+
+
+`taper(operator)`
+
+Taper an operator based on the z2\_symmetries info and sector defined by tapering\_values. Returns operator if the symmetry object is empty.
+
+The tapering is a two-step algorithm which first converts the operator into a [`SparsePauliOp`](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp") with same eigenvalues but where some qubits are only acted upon with the Pauli operators I or X. The number M of these redundant qubits is equal to the number M of identified symmetries.
+
+The second step of the reduction consists in replacing these qubits with the possible eigenvalues of the corresponding Pauli X, giving 2^M new operators with M less qubits. If an eigenvalue sector was previously identified for the solution, then this reduces to 1 new operator with M less qubits.
+
+**Parameters**
+
+**operator** ([*SparsePauliOp*](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.operators.symplectic.sparse_pauli_op.SparsePauliOp")) – The to-be-tapered operator.
+
+**Returns**
+
+\[[`SparsePauliOp`](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp")]; otherwise, [`SparsePauliOp`](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp").
+
+**Return type**
+
+If tapering\_values is None
+
+### taper\_clifford
+
+
+
+`taper_clifford(operator)`
+
+Operate the second part of the tapering. This function assumes that the input operators have already been transformed using [`convert_clifford()`](#qiskit.quantum_info.Z2Symmetries.convert_clifford "qiskit.quantum_info.Z2Symmetries.convert_clifford"). The redundant qubits due to the symmetries are dropped and replaced by their two possible eigenvalues.
+
+**Parameters**
+
+**operator** ([*SparsePauliOp*](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.operators.symplectic.sparse_pauli_op.SparsePauliOp")) – Partially tapered operator resulting from a call to [`convert_clifford()`](#qiskit.quantum_info.Z2Symmetries.convert_clifford "qiskit.quantum_info.Z2Symmetries.convert_clifford").
+
+**Returns**
+
+\[[`SparsePauliOp`](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp")]; otherwise, [`SparsePauliOp`](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp").
+
+**Return type**
+
+If tapering\_values is None
+
diff --git a/docs/api/qiskit/0.46/qiskit.quantum_info.pauli_basis.md b/docs/api/qiskit/0.46/qiskit.quantum_info.pauli_basis.md
new file mode 100644
index 00000000000..7f4330f3aea
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.quantum_info.pauli_basis.md
@@ -0,0 +1,31 @@
+---
+title: pauli_basis
+description: API reference for qiskit.quantum_info.pauli_basis
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.quantum_info.pauli_basis
+---
+
+
+
+# qiskit.quantum\_info.pauli\_basis
+
+
+
+`qiskit.quantum_info.pauli_basis(num_qubits, weight=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/symplectic/pauli_utils.py "view source code")
+
+Return the ordered PauliList for the n-qubit Pauli basis.
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of qubits
+* **weight** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if True optionally return the basis sorted by Pauli weight rather than lexicographic order (Default: False)
+
+**Returns**
+
+the Paulis for the basis
+
+**Return type**
+
+[PauliList](qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")
+
diff --git a/docs/api/qiskit/0.46/qiskit.result.BaseReadoutMitigator.md b/docs/api/qiskit/0.46/qiskit.result.BaseReadoutMitigator.md
new file mode 100644
index 00000000000..e10e4871916
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.result.BaseReadoutMitigator.md
@@ -0,0 +1,69 @@
+---
+title: BaseReadoutMitigator
+description: API reference for qiskit.result.BaseReadoutMitigator
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.result.BaseReadoutMitigator
+---
+
+# BaseReadoutMitigator
+
+
+
+`qiskit.result.BaseReadoutMitigator`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/result/mitigation/base_readout_mitigator.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Base readout error mitigator class.
+
+## Methods
+
+### expectation\_value
+
+
+
+`abstract expectation_value(data, diagonal, qubits=None, clbits=None, shots=None)`
+
+Calculate the expectation value of a diagonal Hermitian operator.
+
+**Parameters**
+
+* **data** ([*Counts*](qiskit.result.Counts "qiskit.result.counts.Counts")) – Counts object to be mitigated.
+* **diagonal** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *|*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *|*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – the diagonal operator. This may either be specified as a string containing I,Z,0,1 characters, or as a real valued 1D array\_like object supplying the full diagonal, or as a dictionary, or as Callable.
+* **qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – the physical qubits measured to obtain the counts clbits. If None these are assumed to be qubits \[0, …, N-1] for N-bit counts.
+* **clbits** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – Optional, marginalize counts to just these bits.
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – Optional, the total number of shots, if None shots will be calculated as the sum of all counts.
+
+**Returns**
+
+The mean and an upper bound of the standard deviation of operator expectation value calculated from the current counts.
+
+**Return type**
+
+[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")\[[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)"), [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")]
+
+### quasi\_probabilities
+
+
+
+`abstract quasi_probabilities(data, qubits=None, clbits=None, shots=None)`
+
+Convert counts to a dictionary of quasi-probabilities
+
+**Parameters**
+
+* **data** ([*Counts*](qiskit.result.Counts "qiskit.result.counts.Counts")) – Counts to be mitigated.
+* **qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – the physical qubits measured to obtain the counts clbits. If None these are assumed to be qubits \[0, …, N-1] for N-bit counts.
+* **clbits** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – Optional, marginalize counts to just these bits.
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – Optional, the total number of shots, if None shots will be calculated as the sum of all counts.
+
+**Returns**
+
+**A dictionary containing pairs of \[output, mean] where “output”**
+
+is the key in the dictionaries, which is the length-N bitstring of a measured standard basis state, and “mean” is the mean of non-zero quasi-probability estimates.
+
+**Return type**
+
+[QuasiDistribution](qiskit.result.QuasiDistribution "qiskit.result.QuasiDistribution")
+
diff --git a/docs/api/qiskit/0.46/qiskit.result.CorrelatedReadoutMitigator.md b/docs/api/qiskit/0.46/qiskit.result.CorrelatedReadoutMitigator.md
new file mode 100644
index 00000000000..9f9c36d2f35
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.result.CorrelatedReadoutMitigator.md
@@ -0,0 +1,166 @@
+---
+title: CorrelatedReadoutMitigator
+description: API reference for qiskit.result.CorrelatedReadoutMitigator
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.result.CorrelatedReadoutMitigator
+---
+
+# CorrelatedReadoutMitigator
+
+
+
+`qiskit.result.CorrelatedReadoutMitigator(assignment_matrix, qubits=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/result/mitigation/correlated_readout_mitigator.py "view source code")
+
+Bases: [`BaseReadoutMitigator`](qiskit.result.BaseReadoutMitigator "qiskit.result.mitigation.base_readout_mitigator.BaseReadoutMitigator")
+
+N-qubit readout error mitigator.
+
+Mitigates [`expectation_value()`](#qiskit.result.CorrelatedReadoutMitigator.expectation_value "qiskit.result.CorrelatedReadoutMitigator.expectation_value") and [`quasi_probabilities()`](#qiskit.result.CorrelatedReadoutMitigator.quasi_probabilities "qiskit.result.CorrelatedReadoutMitigator.quasi_probabilities"). The mitigation\_matrix should be calibrated using qiskit experiments. This mitigation method should be used in case the readout errors of the qubits are assumed to be correlated. The mitigation\_matrix of *N* qubits is of size $2^N x 2^N$ so the mitigation complexity is $O(4^N)$.
+
+Initialize a CorrelatedReadoutMitigator
+
+**Parameters**
+
+* **assignment\_matrix** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – readout error assignment matrix.
+* **qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – Optional, the measured physical qubits for mitigation.
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – matrix size does not agree with number of qubits
+
+## Attributes
+
+
+
+### qubits
+
+The device qubits for this mitigator
+
+
+
+### settings
+
+Return settings.
+
+## Methods
+
+### assignment\_matrix
+
+
+
+`assignment_matrix(qubits=None)`
+
+Return the readout assignment matrix for specified qubits.
+
+The assignment matrix is the stochastic matrix $A$ which assigns a noisy readout probability distribution to an ideal input readout distribution: $P(i|j) = \langle i | A | j \rangle$.
+
+**Parameters**
+
+**qubits** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – Optional, qubits being measured.
+
+**Returns**
+
+the assignment matrix A.
+
+**Return type**
+
+np.ndarray
+
+### expectation\_value
+
+
+
+`expectation_value(data, diagonal=None, qubits=None, clbits=None, shots=None)`
+
+Compute the mitigated expectation value of a diagonal observable.
+
+This computes the mitigated estimator of $\langle O \rangle = \mbox{Tr}[\rho. O]$ of a diagonal observable $O = \sum_{x\in\{0, 1\}^n} O(x)|x\rangle\!\langle x|$.
+
+**Parameters**
+
+* **data** ([*Counts*](qiskit.result.Counts "qiskit.result.counts.Counts")) – Counts object
+* **diagonal** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *|*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *|*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *| None*) – Optional, the vector of diagonal values for summing the expectation value. If `None` the default value is $[1, -1]^\otimes n$.
+* **qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – Optional, the measured physical qubits the count bitstrings correspond to. If None qubits are assumed to be $[0, ..., n-1]$.
+* **clbits** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – Optional, if not None marginalize counts to the specified bits.
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – the number of shots.
+
+**Returns**
+
+the expectation value and an upper bound of the standard deviation.
+
+**Return type**
+
+([float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)"), [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)"))
+
+**Additional Information:**
+
+The diagonal observable $O$ is input using the `diagonal` kwarg as a list or Numpy array $[O(0), ..., O(2^n -1)]$. If no diagonal is specified the diagonal of the Pauli operator :math\`O = mbox\{diag}(Z^\{otimes n}) = \[1, -1]^\{otimes n}\` is used. The `clbits` kwarg is used to marginalize the input counts dictionary over the specified bit-values, and the `qubits` kwarg is used to specify which physical qubits these bit-values correspond to as `circuit.measure(qubits, clbits)`.
+
+### mitigation\_matrix
+
+
+
+`mitigation_matrix(qubits=None)`
+
+Return the readout mitigation matrix for the specified qubits.
+
+The mitigation matrix $A^{-1}$ is defined as the inverse of the [`assignment_matrix()`](#qiskit.result.CorrelatedReadoutMitigator.assignment_matrix "qiskit.result.CorrelatedReadoutMitigator.assignment_matrix") $A$.
+
+**Parameters**
+
+**qubits** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – Optional, qubits being measured.
+
+**Returns**
+
+the measurement error mitigation matrix $A^{-1}$.
+
+**Return type**
+
+np.ndarray
+
+### quasi\_probabilities
+
+
+
+`quasi_probabilities(data, qubits=None, clbits=None, shots=None)`
+
+Compute mitigated quasi probabilities value.
+
+**Parameters**
+
+* **data** ([*Counts*](qiskit.result.Counts "qiskit.result.counts.Counts")) – counts object
+* **qubits** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – qubits the count bitstrings correspond to.
+* **clbits** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – Optional, marginalize counts to just these bits.
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – Optional, the total number of shots, if None shots will be calculated as the sum of all counts.
+
+**Returns**
+
+**A dictionary containing pairs of \[output, mean] where “output”**
+
+is the key in the dictionaries, which is the length-N bitstring of a measured standard basis state, and “mean” is the mean of non-zero quasi-probability estimates.
+
+**Return type**
+
+[QuasiDistribution](qiskit.result.QuasiDistribution "qiskit.result.QuasiDistribution")
+
+### stddev\_upper\_bound
+
+
+
+`stddev_upper_bound(shots)`
+
+Return an upper bound on standard deviation of expval estimator.
+
+**Parameters**
+
+**shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of shots used for expectation value measurement.
+
+**Returns**
+
+the standard deviation upper bound.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.result.Counts.md b/docs/api/qiskit/0.46/qiskit.result.Counts.md
new file mode 100644
index 00000000000..2463622a5b4
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.result.Counts.md
@@ -0,0 +1,204 @@
+---
+title: Counts
+description: API reference for qiskit.result.Counts
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.result.Counts
+---
+
+# Counts
+
+
+
+`qiskit.result.Counts(data, time_taken=None, creg_sizes=None, memory_slots=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/result/counts.py "view source code")
+
+Bases: [`dict`](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+A class to store a counts result from a circuit execution.
+
+Build a counts object
+
+**Parameters**
+
+* **data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) –
+
+ The dictionary input for the counts. Where the keys represent a measured classical value and the value is an integer the number of shots with that result. The keys can be one of several formats:
+
+ > * A hexadecimal string of the form `'0x4a'`
+ > * A bit string prefixed with `0b` for example `'0b1011'`
+ > * A bit string formatted across register and memory slots. For example, `'00 10'`.
+ > * A dit string, for example `'02'`. Note for objects created with dit strings the `creg_sizes` and `memory_slots` kwargs don’t work and [`hex_outcomes()`](#qiskit.result.Counts.hex_outcomes "qiskit.result.Counts.hex_outcomes") and [`int_outcomes()`](#qiskit.result.Counts.int_outcomes "qiskit.result.Counts.int_outcomes") also do not work.
+
+* **time\_taken** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The duration of the experiment that generated the counts in seconds.
+
+* **creg\_sizes** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – a nested list where the inner element is a list of tuples containing both the classical register name and classical register size. For example, `[('c_reg', 2), ('my_creg', 4)]`.
+
+* **memory\_slots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of total `memory_slots` in the experiment.
+
+**Raises**
+
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – If the input key type is not an `int` or `str`.
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a dit string key is input with `creg_sizes` and/or `memory_slots`.
+
+## Attributes
+
+
+
+### bitstring\_regex
+
+`= re.compile('^[01\\s]+$')`
+
+## Methods
+
+### clear
+
+
+
+`clear() → None. Remove all items from D.`
+
+### copy
+
+
+
+`copy() → a shallow copy of D`
+
+### fromkeys
+
+
+
+`fromkeys(value=None, /)`
+
+Create a new dictionary with keys from iterable and values set to value.
+
+### get
+
+
+
+`get(key, default=None, /)`
+
+Return the value for key if key is in the dictionary, else default.
+
+### hex\_outcomes
+
+
+
+`hex_outcomes()`
+
+Return a counts dictionary with hexadecimal string keys
+
+**Returns**
+
+**A dictionary with the keys as hexadecimal strings instead of**
+
+bitstrings
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If the Counts object contains counts for dit strings
+
+### int\_outcomes
+
+
+
+`int_outcomes()`
+
+Build a counts dictionary with integer keys instead of count strings
+
+**Returns**
+
+A dictionary with the keys as integers instead of bitstrings
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If the Counts object contains counts for dit strings
+
+### items
+
+
+
+`items() → a set-like object providing a view on D's items`
+
+### keys
+
+
+
+`keys() → a set-like object providing a view on D's keys`
+
+### most\_frequent
+
+
+
+`most_frequent()`
+
+Return the most frequent count
+
+**Returns**
+
+The bit string for the most frequent result
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – when there is >1 count with the same max counts, or an empty object.
+
+### pop
+
+
+
+`pop(k[, d]) → v, remove specified key and return the corresponding value.`
+
+If key is not found, default is returned if given, otherwise KeyError is raised
+
+### popitem
+
+
+
+`popitem()`
+
+Remove and return a (key, value) pair as a 2-tuple.
+
+Pairs are returned in LIFO (last-in, first-out) order. Raises KeyError if the dict is empty.
+
+### setdefault
+
+
+
+`setdefault(key, default=None, /)`
+
+Insert key with a value of default if key is not in the dictionary.
+
+Return the value for key if key is in the dictionary, else default.
+
+### shots
+
+
+
+`shots()`
+
+Return the number of shots
+
+### update
+
+
+
+`update([E, ]**F) → None. Update D from dict/iterable E and F.`
+
+If E is present and has a .keys() method, then does: for k in E: D\[k] = E\[k] If E is present and lacks a .keys() method, then does: for k, v in E: D\[k] = v In either case, this is followed by: for k in F: D\[k] = F\[k]
+
+### values
+
+
+
+`values() → an object providing a view on D's values`
+
diff --git a/docs/api/qiskit/0.46/qiskit.result.LocalReadoutMitigator.md b/docs/api/qiskit/0.46/qiskit.result.LocalReadoutMitigator.md
new file mode 100644
index 00000000000..8889015fe0e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.result.LocalReadoutMitigator.md
@@ -0,0 +1,172 @@
+---
+title: LocalReadoutMitigator
+description: API reference for qiskit.result.LocalReadoutMitigator
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.result.LocalReadoutMitigator
+---
+
+# LocalReadoutMitigator
+
+
+
+`qiskit.result.LocalReadoutMitigator(assignment_matrices=None, qubits=None, backend=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/result/mitigation/local_readout_mitigator.py "view source code")
+
+Bases: [`BaseReadoutMitigator`](qiskit.result.BaseReadoutMitigator "qiskit.result.mitigation.base_readout_mitigator.BaseReadoutMitigator")
+
+1-qubit tensor product readout error mitigator.
+
+Mitigates [`expectation_value()`](#qiskit.result.LocalReadoutMitigator.expectation_value "qiskit.result.LocalReadoutMitigator.expectation_value") and [`quasi_probabilities()`](#qiskit.result.LocalReadoutMitigator.quasi_probabilities "qiskit.result.LocalReadoutMitigator.quasi_probabilities"). The mitigator should either be calibrated using qiskit experiments, or calculated directly from the backend properties. This mitigation method should be used in case the readout errors of the qubits are assumed to be uncorrelated. For *N* qubits there are *N* mitigation matrices, each of size $2 x 2$ and the mitigation complexity is $O(2^N)$, so it is more efficient than the [`CorrelatedReadoutMitigator`](qiskit.result.CorrelatedReadoutMitigator "qiskit.result.CorrelatedReadoutMitigator") class.
+
+Initialize a LocalReadoutMitigator
+
+**Parameters**
+
+* **assignment\_matrices** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")*] | None*) – Optional, list of single-qubit readout error assignment matrices.
+* **qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – Optional, the measured physical qubits for mitigation.
+* **backend** – Optional, backend name.
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – matrices sizes do not agree with number of qubits
+
+## Attributes
+
+
+
+### qubits
+
+The device qubits for this mitigator
+
+
+
+### settings
+
+Return settings.
+
+## Methods
+
+### assignment\_matrix
+
+
+
+`assignment_matrix(qubits=None)`
+
+Return the measurement assignment matrix for specified qubits.
+
+The assignment matrix is the stochastic matrix $A$ which assigns a noisy measurement probability distribution to an ideal input measurement distribution: $P(i|j) = \langle i | A | j \rangle$.
+
+**Parameters**
+
+**qubits** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – Optional, qubits being measured for operator expval.
+
+**Returns**
+
+the assignment matrix A.
+
+**Return type**
+
+np.ndarray
+
+### expectation\_value
+
+
+
+`expectation_value(data, diagonal=None, qubits=None, clbits=None, shots=None)`
+
+Compute the mitigated expectation value of a diagonal observable.
+
+This computes the mitigated estimator of $\langle O \rangle = \mbox{Tr}[\rho. O]$ of a diagonal observable $O = \sum_{x\in\{0, 1\}^n} O(x)|x\rangle\!\langle x|$.
+
+**Parameters**
+
+* **data** ([*Counts*](qiskit.result.Counts "qiskit.result.counts.Counts")) – Counts object
+* **diagonal** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *|*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *|*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)") *| None*) – Optional, the vector of diagonal values for summing the expectation value. If `None` the default value is $[1, -1]^\otimes n$.
+* **qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – Optional, the measured physical qubits the count bitstrings correspond to. If None qubits are assumed to be $[0, ..., n-1]$.
+* **clbits** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – Optional, if not None marginalize counts to the specified bits.
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – the number of shots.
+
+**Returns**
+
+the expectation value and an upper bound of the standard deviation.
+
+**Return type**
+
+([float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)"), [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)"))
+
+**Additional Information:**
+
+The diagonal observable $O$ is input using the `diagonal` kwarg as a list or Numpy array $[O(0), ..., O(2^n -1)]$. If no diagonal is specified the diagonal of the Pauli operator :math\`O = mbox\{diag}(Z^\{otimes n}) = \[1, -1]^\{otimes n}\` is used. The `clbits` kwarg is used to marginalize the input counts dictionary over the specified bit-values, and the `qubits` kwarg is used to specify which physical qubits these bit-values correspond to as `circuit.measure(qubits, clbits)`.
+
+### mitigation\_matrix
+
+
+
+`mitigation_matrix(qubits=None)`
+
+Return the measurement mitigation matrix for the specified qubits.
+
+The mitigation matrix $A^{-1}$ is defined as the inverse of the [`assignment_matrix()`](#qiskit.result.LocalReadoutMitigator.assignment_matrix "qiskit.result.LocalReadoutMitigator.assignment_matrix") $A$.
+
+**Parameters**
+
+**qubits** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] |* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – Optional, qubits being measured for operator expval. if a single int is given, it is assumed to be the index of the qubit in self.\_qubits
+
+**Returns**
+
+the measurement error mitigation matrix $A^{-1}$.
+
+**Return type**
+
+np.ndarray
+
+### quasi\_probabilities
+
+
+
+`quasi_probabilities(data, qubits=None, clbits=None, shots=None)`
+
+Compute mitigated quasi probabilities value.
+
+**Parameters**
+
+* **data** ([*Counts*](qiskit.result.Counts "qiskit.result.counts.Counts")) – counts object
+* **qubits** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – qubits the count bitstrings correspond to.
+* **clbits** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – Optional, marginalize counts to just these bits.
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – Optional, the total number of shots, if None shots will be calculated as the sum of all counts.
+
+**Returns**
+
+**A dictionary containing pairs of \[output, mean] where “output”**
+
+is the key in the dictionaries, which is the length-N bitstring of a measured standard basis state, and “mean” is the mean of non-zero quasi-probability estimates.
+
+**Return type**
+
+[QuasiDistribution](qiskit.result.QuasiDistribution "qiskit.result.QuasiDistribution")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if qubit and clbit kwargs are not valid.
+
+### stddev\_upper\_bound
+
+
+
+`stddev_upper_bound(shots, qubits=None)`
+
+Return an upper bound on standard deviation of expval estimator.
+
+**Parameters**
+
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of shots used for expectation value measurement.
+* **qubits** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – qubits being measured for operator expval.
+
+**Returns**
+
+the standard deviation upper bound.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.result.ProbDistribution.md b/docs/api/qiskit/0.46/qiskit.result.ProbDistribution.md
new file mode 100644
index 00000000000..6147752712f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.result.ProbDistribution.md
@@ -0,0 +1,161 @@
+---
+title: ProbDistribution
+description: API reference for qiskit.result.ProbDistribution
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.result.ProbDistribution
+---
+
+# ProbDistribution
+
+
+
+`qiskit.result.ProbDistribution(data, shots=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/result/distributions/probability.py "view source code")
+
+Bases: [`dict`](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+A generic dict-like class for probability distributions.
+
+Builds a probability distribution object.
+
+**Parameters**
+
+* **data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) –
+
+ Input probability data. Where the keys represent a measured classical value and the value is a float for the probability of that result. The keys can be one of several formats:
+
+ > * A hexadecimal string of the form `"0x4a"`
+ > * A bit string e.g. `'0b1011'` or `"01011"`
+ > * An integer
+
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of shots the distribution was derived from.
+
+**Raises**
+
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – If the input keys are not a string or int
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If the string format of the keys is incorrect
+
+## Methods
+
+### binary\_probabilities
+
+
+
+`binary_probabilities(num_bits=None)`
+
+Build a probabilities dictionary with binary string keys
+
+**Parameters**
+
+**num\_bits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of bits in the binary bitstrings (leading zeros will be padded). If None, a default value will be used. If keys are given as integers or strings with binary or hex prefix, the default value will be derived from the largest key present. If keys are given as bitstrings without prefix, the default value will be derived from the largest key length.
+
+**Returns**
+
+**A dictionary where the keys are binary strings in the format**
+
+`"0110"`
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+### clear
+
+
+
+`clear() → None. Remove all items from D.`
+
+### copy
+
+
+
+`copy() → a shallow copy of D`
+
+### fromkeys
+
+
+
+`fromkeys(value=None, /)`
+
+Create a new dictionary with keys from iterable and values set to value.
+
+### get
+
+
+
+`get(key, default=None, /)`
+
+Return the value for key if key is in the dictionary, else default.
+
+### hex\_probabilities
+
+
+
+`hex_probabilities()`
+
+Build a probabilities dictionary with hexadecimal string keys
+
+**Returns**
+
+**A dictionary where the keys are hexadecimal strings in the**
+
+format `"0x1a"`
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+### items
+
+
+
+`items() → a set-like object providing a view on D's items`
+
+### keys
+
+
+
+`keys() → a set-like object providing a view on D's keys`
+
+### pop
+
+
+
+`pop(k[, d]) → v, remove specified key and return the corresponding value.`
+
+If key is not found, default is returned if given, otherwise KeyError is raised
+
+### popitem
+
+
+
+`popitem()`
+
+Remove and return a (key, value) pair as a 2-tuple.
+
+Pairs are returned in LIFO (last-in, first-out) order. Raises KeyError if the dict is empty.
+
+### setdefault
+
+
+
+`setdefault(key, default=None, /)`
+
+Insert key with a value of default if key is not in the dictionary.
+
+Return the value for key if key is in the dictionary, else default.
+
+### update
+
+
+
+`update([E, ]**F) → None. Update D from dict/iterable E and F.`
+
+If E is present and has a .keys() method, then does: for k in E: D\[k] = E\[k] If E is present and lacks a .keys() method, then does: for k, v in E: D\[k] = v In either case, this is followed by: for k in F: D\[k] = F\[k]
+
+### values
+
+
+
+`values() → an object providing a view on D's values`
+
diff --git a/docs/api/qiskit/0.46/qiskit.result.QuasiDistribution.md b/docs/api/qiskit/0.46/qiskit.result.QuasiDistribution.md
new file mode 100644
index 00000000000..8dfd0625c64
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.result.QuasiDistribution.md
@@ -0,0 +1,199 @@
+---
+title: QuasiDistribution
+description: API reference for qiskit.result.QuasiDistribution
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.result.QuasiDistribution
+---
+
+# QuasiDistribution
+
+
+
+`qiskit.result.QuasiDistribution(data, shots=None, stddev_upper_bound=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/result/distributions/quasi.py "view source code")
+
+Bases: [`dict`](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+A dict-like class for representing quasi-probabilities.
+
+Builds a quasiprobability distribution object.
+
+
+ The quasiprobability values might include floating-point errors. `QuasiDistribution.__repr__` rounds using `numpy.round()` and the parameter `ndigits` can be manipulated with the class attribute `__ndigits__`. The default is `15`.
+
+
+**Parameters**
+
+* **data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) –
+
+ Input quasiprobability data. Where the keys represent a measured classical value and the value is a float for the quasiprobability of that result. The keys can be one of several formats:
+
+ > * A hexadecimal string of the form `"0x4a"`
+ > * A bit string e.g. `'0b1011'` or `"01011"`
+ > * An integer
+
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of shots the distribution was derived from.
+
+* **stddev\_upper\_bound** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – An upper bound for the standard deviation
+
+**Raises**
+
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – If the input keys are not a string or int
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If the string format of the keys is incorrect
+
+## Attributes
+
+
+
+### stddev\_upper\_bound
+
+Return an upper bound on standard deviation of expval estimator.
+
+## Methods
+
+### binary\_probabilities
+
+
+
+`binary_probabilities(num_bits=None)`
+
+Build a quasi-probabilities dictionary with binary string keys
+
+**Parameters**
+
+**num\_bits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of bits in the binary bitstrings (leading zeros will be padded). If None, a default value will be used. If keys are given as integers or strings with binary or hex prefix, the default value will be derived from the largest key present. If keys are given as bitstrings without prefix, the default value will be derived from the largest key length.
+
+**Returns**
+
+**A dictionary where the keys are binary strings in the format**
+
+`"0110"`
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+### clear
+
+
+
+`clear() → None. Remove all items from D.`
+
+### copy
+
+
+
+`copy() → a shallow copy of D`
+
+### fromkeys
+
+
+
+`fromkeys(value=None, /)`
+
+Create a new dictionary with keys from iterable and values set to value.
+
+### get
+
+
+
+`get(key, default=None, /)`
+
+Return the value for key if key is in the dictionary, else default.
+
+### hex\_probabilities
+
+
+
+`hex_probabilities()`
+
+Build a quasi-probabilities dictionary with hexadecimal string keys
+
+**Returns**
+
+**A dictionary where the keys are hexadecimal strings in the**
+
+format `"0x1a"`
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+### items
+
+
+
+`items() → a set-like object providing a view on D's items`
+
+### keys
+
+
+
+`keys() → a set-like object providing a view on D's keys`
+
+### nearest\_probability\_distribution
+
+
+
+`nearest_probability_distribution(return_distance=False)`
+
+Takes a quasiprobability distribution and maps it to the closest probability distribution as defined by the L2-norm.
+
+**Parameters**
+
+**return\_distance** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Return the L2 distance between distributions.
+
+**Returns**
+
+Nearest probability distribution. float: Euclidean (L2) distance of distributions.
+
+**Return type**
+
+[ProbDistribution](qiskit.result.ProbDistribution "qiskit.result.ProbDistribution")
+
+**Notes**
+
+Method from Smolin et al., Phys. Rev. Lett. 108, 070502 (2012).
+
+### pop
+
+
+
+`pop(k[, d]) → v, remove specified key and return the corresponding value.`
+
+If key is not found, default is returned if given, otherwise KeyError is raised
+
+### popitem
+
+
+
+`popitem()`
+
+Remove and return a (key, value) pair as a 2-tuple.
+
+Pairs are returned in LIFO (last-in, first-out) order. Raises KeyError if the dict is empty.
+
+### setdefault
+
+
+
+`setdefault(key, default=None, /)`
+
+Insert key with a value of default if key is not in the dictionary.
+
+Return the value for key if key is in the dictionary, else default.
+
+### update
+
+
+
+`update([E, ]**F) → None. Update D from dict/iterable E and F.`
+
+If E is present and has a .keys() method, then does: for k in E: D\[k] = E\[k] If E is present and lacks a .keys() method, then does: for k, v in E: D\[k] = v In either case, this is followed by: for k in F: D\[k] = F\[k]
+
+### values
+
+
+
+`values() → an object providing a view on D's values`
+
diff --git a/docs/api/qiskit/0.46/qiskit.result.Result.md b/docs/api/qiskit/0.46/qiskit.result.Result.md
new file mode 100644
index 00000000000..4f6ea159e19
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.result.Result.md
@@ -0,0 +1,258 @@
+---
+title: Result
+description: API reference for qiskit.result.Result
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.result.Result
+---
+
+# Result
+
+
+
+`qiskit.result.Result(backend_name, backend_version, qobj_id, job_id, success, results, date=None, status=None, header=None, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/result/result.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Model for Results.
+
+
+
+### backend\_name
+
+backend name.
+
+**Type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+
+
+### backend\_version
+
+backend version, in the form X.Y.Z.
+
+**Type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+
+
+### qobj\_id
+
+user-generated Qobj id.
+
+**Type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+
+
+### job\_id
+
+unique execution id from the backend.
+
+**Type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+
+
+### success
+
+True if complete input qobj executed correctly. (Implies each experiment success)
+
+**Type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+
+
+### results
+
+corresponding results for array of experiments of the input qobj
+
+**Type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[ExperimentResult]
+
+## Methods
+
+### data
+
+
+
+`data(experiment=None)`
+
+Get the raw data for an experiment.
+
+Note this data will be a single classical and quantum register and in a format required by the results schema. We recommend that most users use the get\_xxx method, and the data will be post-processed for the data type.
+
+**Parameters**
+
+**experiment** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or None*) – the index of the experiment. Several types are accepted for convenience:: \* str: the name of the experiment. \* QuantumCircuit: the name of the circuit instance will be used. \* Schedule: the name of the schedule instance will be used. \* int: the position of the experiment. \* None: if there is only one experiment, returns it.
+
+**Returns**
+
+A dictionary of results data for an experiment. The data depends on the backend it ran on and the settings of meas\_level, meas\_return and memory.
+
+OpenQASM backends return a dictionary of dictionary with the key ‘counts’ and with the counts, with the second dictionary keys containing a string in hex format (`0x123`) and values equal to the number of times this outcome was measured.
+
+Statevector backends return a dictionary with key ‘statevector’ and values being a list\[list\[complex components]] list of 2^num\_qubits complex amplitudes. Where each complex number is represented as a 2 entry list for each component. For example, a list of \[0.5+1j, 0-1j] would be represented as \[\[0.5, 1], \[0, -1]].
+
+Unitary backends return a dictionary with key ‘unitary’ and values being a list\[list\[list\[complex components]]] list of 2^num\_qubits x 2^num\_qubits complex amplitudes in a two entry list for each component. For example if the amplitude is \[\[0.5+0j, 0-1j], …] the value returned will be \[\[\[0.5, 0], \[0, -1]], …].
+
+The simulator backends also have an optional key ‘snapshots’ which returns a dict of snapshots specified by the simulator backend. The value is of the form dict\[slot: dict\[str: array]] where the keys are the requested snapshot slots, and the values are a dictionary of the snapshots.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if data for the experiment could not be retrieved.
+
+### from\_dict
+
+
+
+`classmethod from_dict(data)`
+
+Create a new ExperimentResultData object from a dictionary.
+
+**Parameters**
+
+**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary representing the Result to create. It will be in the same format as output by [`to_dict()`](#qiskit.result.Result.to_dict "qiskit.result.Result.to_dict").
+
+**Returns**
+
+The `Result` object from the input dictionary.
+
+**Return type**
+
+[Result](#qiskit.result.Result "qiskit.result.Result")
+
+### get\_counts
+
+
+
+`get_counts(experiment=None)`
+
+Get the histogram data of an experiment.
+
+**Parameters**
+
+**experiment** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or None*) – the index of the experiment, as specified by `data([experiment])`.
+
+**Returns**
+
+a dictionary or a list of dictionaries. A dictionary has the counts for each qubit with the keys containing a string in binary format and separated according to the registers in circuit (e.g. `0100 1110`). The string is little-endian (cr\[0] on the right hand side).
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)"), [int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")] or [list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)"), [int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")]]
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if there are no counts for the experiment.
+
+### get\_memory
+
+
+
+`get_memory(experiment=None)`
+
+Get the sequence of memory states (readouts) for each shot The data from the experiment is a list of format \[‘00000’, ‘01000’, ‘10100’, ‘10100’, ‘11101’, ‘11100’, ‘00101’, …, ‘01010’]
+
+**Parameters**
+
+**experiment** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or None*) – the index of the experiment, as specified by `data()`.
+
+**Returns**
+
+Either the list of each outcome, formatted according to registers in circuit or a complex numpy np.ndarray with shape:
+
+> | meas\_level | meas\_return | shape |
+> | ----------- | ------------ | ----------------------------------------------------- |
+> | 0 | single | np.ndarray\[shots, memory\_slots, memory\_slot\_size] |
+> | 0 | avg | np.ndarray\[memory\_slots, memory\_slot\_size] |
+> | 1 | single | np.ndarray\[shots, memory\_slots] |
+> | 1 | avg | np.ndarray\[memory\_slots] |
+> | 2 | memory=True | list |
+
+**Return type**
+
+List\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")] or np.ndarray
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if there is no memory data for the circuit.
+
+### get\_statevector
+
+
+
+`get_statevector(experiment=None, decimals=None)`
+
+Get the final statevector of an experiment.
+
+**Parameters**
+
+* **experiment** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or None*) – the index of the experiment, as specified by `data()`.
+* **decimals** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of decimals in the statevector. If None, does not round.
+
+**Returns**
+
+list of 2^num\_qubits complex amplitudes.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")]
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if there is no statevector for the experiment.
+
+### get\_unitary
+
+
+
+`get_unitary(experiment=None, decimals=None)`
+
+Get the final unitary of an experiment.
+
+**Parameters**
+
+* **experiment** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *or*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or None*) – the index of the experiment, as specified by `data()`.
+* **decimals** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of decimals in the unitary. If None, does not round.
+
+**Returns**
+
+**list of 2^num\_qubits x 2^num\_qubits complex**
+
+amplitudes.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[complex](https://docs.python.org/3/library/functions.html#complex "(in Python v3.12)")]]
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if there is no unitary for the experiment.
+
+### to\_dict
+
+
+
+`to_dict()`
+
+Return a dictionary format representation of the Result
+
+**Returns**
+
+The dictionary form of the Result
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.result.ResultError.md b/docs/api/qiskit/0.46/qiskit.result.ResultError.md
new file mode 100644
index 00000000000..0b85c4263fa
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.result.ResultError.md
@@ -0,0 +1,34 @@
+---
+title: ResultError
+description: API reference for qiskit.result.ResultError
+in_page_toc_min_heading_level: 1
+python_api_type: exception
+python_api_name: qiskit.result.ResultError
+---
+
+
+
+# qiskit.result.ResultError
+
+
+
+`qiskit.result.ResultError(error)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/result/exceptions.py "view source code")
+
+Exceptions raised due to errors in result output.
+
+It may be better for the Qiskit API to raise this exception.
+
+**Parameters**
+
+**error** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) –
+
+This is the error record as it comes back from the API. The format is like:
+
+```python
+error = {'status': 403,
+ 'message': 'Your credits are not enough.',
+ 'code': 'MAX_CREDITS_EXCEEDED'}
+```
+
+Set the error message.
+
diff --git a/docs/api/qiskit/0.46/qiskit.synthesis.EvolutionSynthesis.md b/docs/api/qiskit/0.46/qiskit.synthesis.EvolutionSynthesis.md
new file mode 100644
index 00000000000..38f188708e5
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.synthesis.EvolutionSynthesis.md
@@ -0,0 +1,56 @@
+---
+title: EvolutionSynthesis
+description: API reference for qiskit.synthesis.EvolutionSynthesis
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.synthesis.EvolutionSynthesis
+---
+
+# EvolutionSynthesis
+
+
+
+`qiskit.synthesis.EvolutionSynthesis`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/evolution/evolution_synthesis.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Interface for evolution synthesis algorithms.
+
+## Attributes
+
+
+
+### settings
+
+Return the settings in a dictionary, which can be used to reconstruct the object.
+
+**Returns**
+
+A dictionary containing the settings of this product formula.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – The interface does not implement this method.
+
+## Methods
+
+### synthesize
+
+
+
+`abstract synthesize(evolution)`
+
+Synthesize an `qiskit.circuit.library.PauliEvolutionGate`.
+
+**Parameters**
+
+**evolution** ([*PauliEvolutionGate*](qiskit.circuit.library.PauliEvolutionGate "qiskit.circuit.library.PauliEvolutionGate")) – The evolution gate to synthesize.
+
+**Returns**
+
+A circuit implementing the evolution.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
diff --git a/docs/api/qiskit/0.46/qiskit.synthesis.LieTrotter.md b/docs/api/qiskit/0.46/qiskit.synthesis.LieTrotter.md
new file mode 100644
index 00000000000..c2a67d99289
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.synthesis.LieTrotter.md
@@ -0,0 +1,79 @@
+---
+title: LieTrotter
+description: API reference for qiskit.synthesis.LieTrotter
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.synthesis.LieTrotter
+---
+
+# LieTrotter
+
+
+
+`qiskit.synthesis.LieTrotter(reps=1, insert_barriers=False, cx_structure='chain', atomic_evolution=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/evolution/lie_trotter.py "view source code")
+
+Bases: [`ProductFormula`](qiskit.synthesis.ProductFormula "qiskit.synthesis.evolution.product_formula.ProductFormula")
+
+The Lie-Trotter product formula.
+
+The Lie-Trotter formula approximates the exponential of two non-commuting operators with products of their exponentials up to a second order error:
+
+$$
+e^{A + B} \approx e^{A}e^{B}.
+$$
+
+In this implementation, the operators are provided as sum terms of a Pauli operator. For example, we approximate
+
+$$
+e^{-it(XX + ZZ)} = e^{-it XX}e^{-it ZZ} + \mathcal{O}(t^2).
+$$
+
+**References**
+
+\[1]: D. Berry, G. Ahokas, R. Cleve and B. Sanders, “Efficient quantum algorithms for simulating sparse Hamiltonians” (2006). [arXiv:quant-ph/0508139](https://arxiv.org/abs/quant-ph/0508139) \[2]: N. Hatano and M. Suzuki, “Finding Exponential Product Formulas of Higher Orders” (2005). [arXiv:math-ph/0506007](https://arxiv.org/pdf/math-ph/0506007.pdf)
+
+**Parameters**
+
+* **reps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of time steps.
+* **insert\_barriers** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to insert barriers between the atomic evolutions.
+* **cx\_structure** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – How to arrange the CX gates for the Pauli evolutions, can be “chain”, where next neighbor connections are used, or “fountain”, where all qubits are connected to one.
+* **atomic\_evolution** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")*\[\[*[*Pauli*](qiskit.quantum_info.Pauli "qiskit.quantum_info.operators.symplectic.pauli.Pauli") *|*[*SparsePauliOp*](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.operators.symplectic.sparse_pauli_op.SparsePauliOp")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*],* [*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")*] | None*) – A function to construct the circuit for the evolution of single Pauli string. Per default, a single Pauli evolution is decomposed in a CX chain and a single qubit Z rotation.
+
+## Attributes
+
+
+
+### settings
+
+Return the settings in a dictionary, which can be used to reconstruct the object.
+
+**Returns**
+
+A dictionary containing the settings of this product formula.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – If a custom atomic evolution is set, which cannot be serialized.
+
+## Methods
+
+### synthesize
+
+
+
+`synthesize(evolution)`
+
+Synthesize an `qiskit.circuit.library.PauliEvolutionGate`.
+
+**Parameters**
+
+**evolution** ([*PauliEvolutionGate*](qiskit.circuit.library.PauliEvolutionGate "qiskit.circuit.library.PauliEvolutionGate")) – The evolution gate to synthesize.
+
+**Returns**
+
+A circuit implementing the evolution.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
diff --git a/docs/api/qiskit/0.46/qiskit.synthesis.MatrixExponential.md b/docs/api/qiskit/0.46/qiskit.synthesis.MatrixExponential.md
new file mode 100644
index 00000000000..176cc0dc69c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.synthesis.MatrixExponential.md
@@ -0,0 +1,58 @@
+---
+title: MatrixExponential
+description: API reference for qiskit.synthesis.MatrixExponential
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.synthesis.MatrixExponential
+---
+
+# MatrixExponential
+
+
+
+`qiskit.synthesis.MatrixExponential`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/evolution/matrix_synthesis.py "view source code")
+
+Bases: [`EvolutionSynthesis`](qiskit.synthesis.EvolutionSynthesis "qiskit.synthesis.evolution.evolution_synthesis.EvolutionSynthesis")
+
+Exact operator evolution via matrix exponentiation and unitary synthesis.
+
+This class synthesis the exponential of operators by calculating their exponentially-sized matrix representation and using exact matrix exponentiation followed by unitary synthesis to obtain a circuit. This process is not scalable and serves as comparison or benchmark for small systems.
+
+## Attributes
+
+
+
+### settings
+
+Return the settings in a dictionary, which can be used to reconstruct the object.
+
+**Returns**
+
+A dictionary containing the settings of this product formula.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – The interface does not implement this method.
+
+## Methods
+
+### synthesize
+
+
+
+`synthesize(evolution)`
+
+Synthesize an `qiskit.circuit.library.PauliEvolutionGate`.
+
+**Parameters**
+
+**evolution** ([*PauliEvolutionGate*](qiskit.circuit.library.PauliEvolutionGate "qiskit.circuit.library.PauliEvolutionGate")) – The evolution gate to synthesize.
+
+**Returns**
+
+A circuit implementing the evolution.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
diff --git a/docs/api/qiskit/0.46/qiskit.synthesis.OneQubitEulerDecomposer.md b/docs/api/qiskit/0.46/qiskit.synthesis.OneQubitEulerDecomposer.md
new file mode 100644
index 00000000000..60fcee0838a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.synthesis.OneQubitEulerDecomposer.md
@@ -0,0 +1,106 @@
+---
+title: OneQubitEulerDecomposer
+description: API reference for qiskit.synthesis.OneQubitEulerDecomposer
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.synthesis.OneQubitEulerDecomposer
+---
+
+# OneQubitEulerDecomposer
+
+
+
+`qiskit.synthesis.OneQubitEulerDecomposer(basis='U3', use_dag=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/one_qubit/one_qubit_decompose.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+A class for decomposing 1-qubit unitaries into Euler angle rotations.
+
+The resulting decomposition is parameterized by 3 Euler rotation angle parameters $(\theta, \phi, \lambda)$, and a phase parameter $\gamma$. The value of the parameters for an input unitary depends on the decomposition basis. Allowed bases and the resulting circuits are shown in the following table. Note that for the non-Euler bases (U3, U1X, RR), the ZYZ Euler parameters are used.
+
+| Basis | Euler Angle Basis | Decomposition Circuit |
+| ------ | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
+| ‘ZYZ’ | $Z(\phi) Y(\theta) Z(\lambda)$ | $e^{i\gamma} R_Z(\phi).R_Y(\theta).R_Z(\lambda)$ |
+| ‘ZXZ’ | $Z(\phi) X(\theta) Z(\lambda)$ | $e^{i\gamma} R_Z(\phi).R_X(\theta).R_Z(\lambda)$ |
+| ‘XYX’ | $X(\phi) Y(\theta) X(\lambda)$ | $e^{i\gamma} R_X(\phi).R_Y(\theta).R_X(\lambda)$ |
+| ‘XZX’ | $X(\phi) Z(\theta) X(\lambda)$ | $e^{i\gamma} R_X(\phi).R_Z(\theta).R_X(\lambda)$ |
+| ‘U3’ | $Z(\phi) Y(\theta) Z(\lambda)$ | $e^{i\gamma} U_3(\theta,\phi,\lambda)$ |
+| ‘U321’ | $Z(\phi) Y(\theta) Z(\lambda)$ | $e^{i\gamma} U_3(\theta,\phi,\lambda)$ |
+| ‘U’ | $Z(\phi) Y(\theta) Z(\lambda)$ | $e^{i\gamma} U_3(\theta,\phi,\lambda)$ |
+| ‘PSX’ | $Z(\phi) Y(\theta) Z(\lambda)$ | $e^{i\gamma} U_1(\phi+\pi).R_X\left(\frac{\pi}{2}\right).$ $U_1(\theta+\pi).R_X\left(\frac{\pi}{2}\right).U_1(\lambda)$ |
+| ‘ZSX’ | $Z(\phi) Y(\theta) Z(\lambda)$ | $e^{i\gamma} R_Z(\phi+\pi).\sqrt{X}.$ $R_Z(\theta+\pi).\sqrt{X}.R_Z(\lambda)$ |
+| ‘ZSXX’ | $Z(\phi) Y(\theta) Z(\lambda)$ | $e^{i\gamma} R_Z(\phi+\pi).\sqrt{X}.R_Z(\theta+\pi).\sqrt{X}.R_Z(\lambda)$ or $e^{i\gamma} R_Z(\phi+\pi).X.R_Z(\lambda)$ |
+| ‘U1X’ | $Z(\phi) Y(\theta) Z(\lambda)$ | $e^{i\gamma} U_1(\phi+\pi).R_X\left(\frac{\pi}{2}\right).$ $U_1(\theta+\pi).R_X\left(\frac{\pi}{2}\right).U_1(\lambda)$ |
+| ‘RR’ | $Z(\phi) Y(\theta) Z(\lambda)$ | $e^{i\gamma} R\left(-\pi,\frac{\phi-\lambda+\pi}{2}\right).$ $R\left(\theta+\pi,\frac{\pi}{2}-\lambda\right)$ |
+
+Initialize decomposer
+
+Supported bases are: ‘U’, ‘PSX’, ‘ZSXX’, ‘ZSX’, ‘U321’, ‘U3’, ‘U1X’, ‘RR’, ‘ZYZ’, ‘ZXZ’, ‘XYX’, ‘XZX’.
+
+**Parameters**
+
+* **basis** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – the decomposition basis \[Default: ‘U3’]
+* **use\_dag** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If true the output from calls to the decomposer will be a [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") object instead of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit").
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If input basis is not recognized.
+
+## Attributes
+
+
+
+### basis
+
+The decomposition basis.
+
+## Methods
+
+### angles
+
+
+
+`angles(unitary)`
+
+Return the Euler angles for input array.
+
+**Parameters**
+
+**unitary** (*np.ndarray*) – 2x2 unitary matrix.
+
+**Returns**
+
+(theta, phi, lambda).
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")
+
+### angles\_and\_phase
+
+
+
+`angles_and_phase(unitary)`
+
+Return the Euler angles and phase for input array.
+
+**Parameters**
+
+**unitary** (*np.ndarray*) – 2x2 unitary matrix.
+
+**Returns**
+
+(theta, phi, lambda, phase).
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")
+
+### build\_circuit
+
+
+
+`build_circuit(gates, global_phase)`
+
+Return the circuit or dag object from a list of gates.
+
diff --git a/docs/api/qiskit/0.46/qiskit.synthesis.ProductFormula.md b/docs/api/qiskit/0.46/qiskit.synthesis.ProductFormula.md
new file mode 100644
index 00000000000..6f394b17856
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.synthesis.ProductFormula.md
@@ -0,0 +1,66 @@
+---
+title: ProductFormula
+description: API reference for qiskit.synthesis.ProductFormula
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.synthesis.ProductFormula
+---
+
+# ProductFormula
+
+
+
+`qiskit.synthesis.ProductFormula(order, reps=1, insert_barriers=False, cx_structure='chain', atomic_evolution=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/evolution/product_formula.py "view source code")
+
+Bases: [`EvolutionSynthesis`](qiskit.synthesis.EvolutionSynthesis "qiskit.synthesis.evolution.evolution_synthesis.EvolutionSynthesis")
+
+Product formula base class for the decomposition of non-commuting operator exponentials.
+
+[`LieTrotter`](qiskit.synthesis.LieTrotter "qiskit.synthesis.LieTrotter") and [`SuzukiTrotter`](qiskit.synthesis.SuzukiTrotter "qiskit.synthesis.SuzukiTrotter") inherit from this class.
+
+**Parameters**
+
+* **order** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The order of the product formula.
+* **reps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of time steps.
+* **insert\_barriers** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to insert barriers between the atomic evolutions.
+* **cx\_structure** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – How to arrange the CX gates for the Pauli evolutions, can be “chain”, where next neighbor connections are used, or “fountain”, where all qubits are connected to one.
+* **atomic\_evolution** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")*\[\[*[*Pauli*](qiskit.quantum_info.Pauli "qiskit.quantum_info.operators.symplectic.pauli.Pauli") *|*[*SparsePauliOp*](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.operators.symplectic.sparse_pauli_op.SparsePauliOp")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*],* [*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")*] | None*) – A function to construct the circuit for the evolution of single Pauli string. Per default, a single Pauli evolution is decomposed in a CX chain and a single qubit Z rotation.
+
+## Attributes
+
+
+
+### settings
+
+Return the settings in a dictionary, which can be used to reconstruct the object.
+
+**Returns**
+
+A dictionary containing the settings of this product formula.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – If a custom atomic evolution is set, which cannot be serialized.
+
+## Methods
+
+### synthesize
+
+
+
+`abstract synthesize(evolution)`
+
+Synthesize an `qiskit.circuit.library.PauliEvolutionGate`.
+
+**Parameters**
+
+**evolution** ([*PauliEvolutionGate*](qiskit.circuit.library.PauliEvolutionGate "qiskit.circuit.library.PauliEvolutionGate")) – The evolution gate to synthesize.
+
+**Returns**
+
+A circuit implementing the evolution.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
diff --git a/docs/api/qiskit/0.46/qiskit.synthesis.QDrift.md b/docs/api/qiskit/0.46/qiskit.synthesis.QDrift.md
new file mode 100644
index 00000000000..4d721a710ec
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.synthesis.QDrift.md
@@ -0,0 +1,68 @@
+---
+title: QDrift
+description: API reference for qiskit.synthesis.QDrift
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.synthesis.QDrift
+---
+
+# QDrift
+
+
+
+`qiskit.synthesis.QDrift(reps=1, insert_barriers=False, cx_structure='chain', atomic_evolution=None, seed=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/evolution/qdrift.py "view source code")
+
+Bases: [`ProductFormula`](qiskit.synthesis.ProductFormula "qiskit.synthesis.evolution.product_formula.ProductFormula")
+
+The QDrift Trotterization method, which selects each each term in the Trotterization randomly, with a probability proportional to its weight. Based on the work of Earl Campbell in Ref. \[1].
+
+**References**
+
+\[1]: E. Campbell, “A random compiler for fast Hamiltonian simulation” (2018). [arXiv:quant-ph/1811.08017](https://arxiv.org/abs/1811.08017)
+
+**Parameters**
+
+* **reps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of times to repeat the Trotterization circuit.
+* **insert\_barriers** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to insert barriers between the atomic evolutions.
+* **cx\_structure** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – How to arrange the CX gates for the Pauli evolutions, can be “chain”, where next neighbor connections are used, or “fountain”, where all qubits are connected to one.
+* **atomic\_evolution** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")*\[\[*[*Pauli*](qiskit.quantum_info.Pauli "qiskit.quantum_info.operators.symplectic.pauli.Pauli") *|*[*SparsePauliOp*](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.operators.symplectic.sparse_pauli_op.SparsePauliOp")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*],* [*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")*] | None*) – A function to construct the circuit for the evolution of single Pauli string. Per default, a single Pauli evolution is decomposed in a CX chain and a single qubit Z rotation.
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – An optional seed for reproducibility of the random sampling process.
+
+## Attributes
+
+
+
+### settings
+
+Return the settings in a dictionary, which can be used to reconstruct the object.
+
+**Returns**
+
+A dictionary containing the settings of this product formula.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – If a custom atomic evolution is set, which cannot be serialized.
+
+## Methods
+
+### synthesize
+
+
+
+`synthesize(evolution)`
+
+Synthesize an `qiskit.circuit.library.PauliEvolutionGate`.
+
+**Parameters**
+
+**evolution** ([*PauliEvolutionGate*](qiskit.circuit.library.PauliEvolutionGate "qiskit.circuit.library.PauliEvolutionGate")) – The evolution gate to synthesize.
+
+**Returns**
+
+A circuit implementing the evolution.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
diff --git a/docs/api/qiskit/0.46/qiskit.synthesis.SolovayKitaevDecomposition.md b/docs/api/qiskit/0.46/qiskit.synthesis.SolovayKitaevDecomposition.md
new file mode 100644
index 00000000000..1fd4a0c057e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.synthesis.SolovayKitaevDecomposition.md
@@ -0,0 +1,93 @@
+---
+title: SolovayKitaevDecomposition
+description: API reference for qiskit.synthesis.SolovayKitaevDecomposition
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.synthesis.SolovayKitaevDecomposition
+---
+
+# SolovayKitaevDecomposition
+
+
+
+`qiskit.synthesis.SolovayKitaevDecomposition(basic_approximations=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/discrete_basis/solovay_kitaev.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+The Solovay Kitaev discrete decomposition algorithm.
+
+This class is called recursively by the transpiler pass, which is why it is separeted. See [`qiskit.transpiler.passes.SolovayKitaev`](qiskit.transpiler.passes.SolovayKitaev "qiskit.transpiler.passes.SolovayKitaev") for more information.
+
+**Parameters**
+
+**basic\_approximations** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*, np.ndarray] |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[GateSequence] | None*) – A specification of the basic SU(2) approximations in terms of discrete gates. At each iteration this algorithm, the remaining error is approximated with the closest sequence of gates in this set. If a `str`, this specifies a `.npy` filename from which to load the approximation. If a `dict`, then this contains `{gates: effective_SO3_matrix}` pairs, e.g. `{"h t": np.array([[0, 0.7071, -0.7071], [0, -0.7071, -0.7071], [-1, 0, 0]]}`. If a list, this contains the same information as the dict, but already converted to `GateSequence` objects, which contain the SO(3) matrix and gates.
+
+## Methods
+
+### find\_basic\_approximation
+
+
+
+`find_basic_approximation(sequence)`
+
+Finds gate in `self._basic_approximations` that best represents `sequence`.
+
+**Parameters**
+
+**sequence** (*GateSequence*) – The gate to find the approximation to.
+
+**Returns**
+
+Gate in basic approximations that is closest to `sequence`.
+
+**Return type**
+
+[*Gate*](qiskit.circuit.Gate "qiskit.circuit.gate.Gate")
+
+### load\_basic\_approximations
+
+
+
+`load_basic_approximations(data)`
+
+Load basic approximations.
+
+**Parameters**
+
+**data** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *|*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – If a string, specifies the path to the file from where to load the data. If a dictionary, directly specifies the decompositions as `{gates: matrix}`. There `gates` are the names of the gates producing the SO(3) matrix `matrix`, e.g. `{"h t": np.array([[0, 0.7071, -0.7071], [0, -0.7071, -0.7071], [-1, 0, 0]]}`.
+
+**Returns**
+
+A list of basic approximations as type `GateSequence`.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If the number of gate combinations and associated matrices does not match.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[GateSequence]
+
+### run
+
+
+
+`run(gate_matrix, recursion_degree, return_dag=False, check_input=True)`
+
+Run the algorithm.
+
+**Parameters**
+
+* **gate\_matrix** (*np.ndarray*) – The 2x2 matrix representing the gate. This matrix has to be SU(2) up to global phase.
+* **recursion\_degree** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The recursion degree, called $n$ in the paper.
+* **return\_dag** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If `True` return a [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit"), else a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit").
+* **check\_input** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If `True` check that the input matrix is valid for the decomposition.
+
+**Returns**
+
+A one-qubit circuit approximating the `gate_matrix` in the specified discrete basis.
+
+**Return type**
+
+QuantumCircuit’ | ‘DAGCircuit
+
diff --git a/docs/api/qiskit/0.46/qiskit.synthesis.SuzukiTrotter.md b/docs/api/qiskit/0.46/qiskit.synthesis.SuzukiTrotter.md
new file mode 100644
index 00000000000..46fc16e05ae
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.synthesis.SuzukiTrotter.md
@@ -0,0 +1,86 @@
+---
+title: SuzukiTrotter
+description: API reference for qiskit.synthesis.SuzukiTrotter
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.synthesis.SuzukiTrotter
+---
+
+# SuzukiTrotter
+
+
+
+`qiskit.synthesis.SuzukiTrotter(order=2, reps=1, insert_barriers=False, cx_structure='chain', atomic_evolution=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/evolution/suzuki_trotter.py "view source code")
+
+Bases: [`ProductFormula`](qiskit.synthesis.ProductFormula "qiskit.synthesis.evolution.product_formula.ProductFormula")
+
+The (higher order) Suzuki-Trotter product formula.
+
+The Suzuki-Trotter formulas improve the error of the Lie-Trotter approximation. For example, the second order decomposition is
+
+$$
+e^{A + B} \approx e^{B/2} e^{A} e^{B/2}.
+$$
+
+Higher order decompositions are based on recursions, see Ref. \[1] for more details.
+
+In this implementation, the operators are provided as sum terms of a Pauli operator. For example, in the second order Suzuki-Trotter decomposition we approximate
+
+$$
+e^{-it(XX + ZZ)} = e^{-it/2 ZZ}e^{-it XX}e^{-it/2 ZZ} + \mathcal{O}(t^3).
+$$
+
+**References**
+
+\[1]: D. Berry, G. Ahokas, R. Cleve and B. Sanders, “Efficient quantum algorithms for simulating sparse Hamiltonians” (2006). [arXiv:quant-ph/0508139](https://arxiv.org/abs/quant-ph/0508139) \[2]: N. Hatano and M. Suzuki, “Finding Exponential Product Formulas of Higher Orders” (2005). [arXiv:math-ph/0506007](https://arxiv.org/pdf/math-ph/0506007.pdf)
+
+**Parameters**
+
+* **order** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The order of the product formula.
+* **reps** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of time steps.
+* **insert\_barriers** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to insert barriers between the atomic evolutions.
+* **cx\_structure** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – How to arrange the CX gates for the Pauli evolutions, can be “chain”, where next neighbor connections are used, or “fountain”, where all qubits are connected to one.
+* **atomic\_evolution** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)")*\[\[*[*Pauli*](qiskit.quantum_info.Pauli "qiskit.quantum_info.operators.symplectic.pauli.Pauli") *|*[*SparsePauliOp*](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.operators.symplectic.sparse_pauli_op.SparsePauliOp")*,* [*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*],* [*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")*] | None*) – A function to construct the circuit for the evolution of single Pauli string. Per default, a single Pauli evolution is decomposed in a CX chain and a single qubit Z rotation.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If order is not even
+
+## Attributes
+
+
+
+### settings
+
+Return the settings in a dictionary, which can be used to reconstruct the object.
+
+**Returns**
+
+A dictionary containing the settings of this product formula.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – If a custom atomic evolution is set, which cannot be serialized.
+
+## Methods
+
+### synthesize
+
+
+
+`synthesize(evolution)`
+
+Synthesize an `qiskit.circuit.library.PauliEvolutionGate`.
+
+**Parameters**
+
+**evolution** ([*PauliEvolutionGate*](qiskit.circuit.library.PauliEvolutionGate "qiskit.circuit.library.PauliEvolutionGate")) – The evolution gate to synthesize.
+
+**Returns**
+
+A circuit implementing the evolution.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
diff --git a/docs/api/qiskit/0.46/qiskit.synthesis.TwoQubitBasisDecomposer.md b/docs/api/qiskit/0.46/qiskit.synthesis.TwoQubitBasisDecomposer.md
new file mode 100644
index 00000000000..d1ee81b4345
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.synthesis.TwoQubitBasisDecomposer.md
@@ -0,0 +1,89 @@
+---
+title: TwoQubitBasisDecomposer
+description: API reference for qiskit.synthesis.TwoQubitBasisDecomposer
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.synthesis.TwoQubitBasisDecomposer
+---
+
+# TwoQubitBasisDecomposer
+
+
+
+`qiskit.synthesis.TwoQubitBasisDecomposer(gate, basis_fidelity=1.0, euler_basis='U', pulse_optimize=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/two_qubit/two_qubit_decompose.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+A class for decomposing 2-qubit unitaries into minimal number of uses of a 2-qubit basis gate.
+
+**Parameters**
+
+* **gate** ([*Gate*](qiskit.circuit.Gate "qiskit.circuit.Gate")) – Two-qubit gate to be used in the KAK decomposition.
+* **basis\_fidelity** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Fidelity to be assumed for applications of KAK Gate. Default 1.0.
+* **euler\_basis** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Basis string to be provided to OneQubitEulerDecomposer for 1Q synthesis. Valid options are \[‘ZYZ’, ‘ZXZ’, ‘XYX’, ‘U’, ‘U3’, ‘U1X’, ‘PSX’, ‘ZSX’, ‘RR’].
+* **pulse\_optimize** (*None or* [*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, try to do decomposition which minimizes local unitaries in between entangling gates. This will raise an exception if an optimal decomposition is not implemented. Currently, only \[\{CX, SX, RZ}] is known. If False, don’t attempt optimization. If None, attempt optimization but don’t raise if unknown.
+
+## Methods
+
+### decomp0
+
+
+
+`static decomp0(target)`
+
+Decompose target \~Ud(x, y, z) with 0 uses of the basis gate. Result Ur has trace: $|Tr(Ur.Utarget^dag)| = 4|(cos(x)cos(y)cos(z)+ j sin(x)sin(y)sin(z)|$, which is optimal for all targets and bases
+
+### decomp1
+
+
+
+`decomp1(target)`
+
+Decompose target \~Ud(x, y, z) with 1 uses of the basis gate \~Ud(a, b, c). Result Ur has trace: .. math:
+
+```python
+|Tr(Ur.Utarget^dag)| = 4|cos(x-a)cos(y-b)cos(z-c) + j sin(x-a)sin(y-b)sin(z-c)|
+```
+
+which is optimal for all targets and bases with z==0 or c==0
+
+### decomp2\_supercontrolled
+
+
+
+`decomp2_supercontrolled(target)`
+
+Decompose target \~Ud(x, y, z) with 2 uses of the basis gate.
+
+For supercontrolled basis \~Ud(pi/4, b, 0), all b, result Ur has trace .. math:
+
+```python
+|Tr(Ur.Utarget^dag)| = 4cos(z)
+```
+
+which is the optimal approximation for basis of CNOT-class `~Ud(pi/4, 0, 0)` or DCNOT-class `~Ud(pi/4, pi/4, 0)` and any target. May be sub-optimal for b!=0 (e.g. there exists exact decomposition for any target using B `B~Ud(pi/4, pi/8, 0)`, but not this decomposition.) This is an exact decomposition for supercontrolled basis and target `~Ud(x, y, 0)`. No guarantees for non-supercontrolled basis.
+
+### decomp3\_supercontrolled
+
+
+
+`decomp3_supercontrolled(target)`
+
+Decompose target with 3 uses of the basis. This is an exact decomposition for supercontrolled basis \~Ud(pi/4, b, 0), all b, and any target. No guarantees for non-supercontrolled basis.
+
+### num\_basis\_gates
+
+
+
+`num_basis_gates(unitary)`
+
+Computes the number of basis gates needed in a decomposition of input unitary
+
+### traces
+
+
+
+`traces(target)`
+
+Give the expected traces $|Tr(U \cdot Utarget^dag)|$ for different number of basis gates.
+
diff --git a/docs/api/qiskit/0.46/qiskit.synthesis.XXDecomposer.md b/docs/api/qiskit/0.46/qiskit.synthesis.XXDecomposer.md
new file mode 100644
index 00000000000..1e5bfa6e0f8
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.synthesis.XXDecomposer.md
@@ -0,0 +1,41 @@
+---
+title: XXDecomposer
+description: API reference for qiskit.synthesis.XXDecomposer
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.synthesis.XXDecomposer
+---
+
+# XXDecomposer
+
+
+
+`qiskit.synthesis.XXDecomposer(basis_fidelity=1.0, euler_basis='U', embodiments=None, backup_optimizer=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/two_qubit/xx_decompose/decomposer.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+A class for optimal decomposition of 2-qubit unitaries into 2-qubit basis gates of XX type (i.e., each locally equivalent to CAN(alpha, 0, 0) for a possibly varying alpha).
+
+**Parameters**
+
+* **basis\_fidelity** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – available strengths and fidelity of each. Can be either (1) a dictionary mapping XX angle values to fidelity at that angle; or (2) a single float f, interpreted as \{pi: f, pi/2: f/2, pi/3: f/3}.
+* **euler\_basis** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Basis string provided to OneQubitEulerDecomposer for 1Q synthesis. Defaults to “U”.
+* **embodiments** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*] | None*) – A dictionary mapping interaction strengths alpha to native circuits which embody the gate CAN(alpha, 0, 0). Strengths are taken so that pi/2 represents the class of a full CX.
+* **backup\_optimizer** (*Callable\[...,* [*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*] | None*) – If supplied, defers synthesis to this callable when XXDecomposer has no efficient decomposition of its own. Useful for special cases involving 2 or 3 applications of XX(pi/2), in which case standard synthesis methods provide lower 1Q gate count.
+
+
+ If `embodiments` is not passed, or if an entry is missing, it will be populated as needed using the method `_default_embodiment`.
+
+
+## Methods
+
+### num\_basis\_gates
+
+
+
+`num_basis_gates(unitary)`
+
+Counts the number of gates that would be emitted during re-synthesis.
+
+NOTE: Used by ConsolidateBlocks.
+
diff --git a/docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.AQC.md b/docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.AQC.md
new file mode 100644
index 00000000000..bb201f84f14
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.AQC.md
@@ -0,0 +1,49 @@
+---
+title: AQC
+description: API reference for qiskit.synthesis.unitary.aqc.AQC
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.synthesis.unitary.aqc.AQC
+---
+
+# AQC
+
+
+
+`qiskit.synthesis.unitary.aqc.AQC(optimizer=None, seed=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/unitary/aqc/aqc.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+A generic implementation of the Approximate Quantum Compiler. This implementation is agnostic of the underlying implementation of the approximate circuit, objective, and optimizer. Users may pass corresponding implementations of the abstract classes:
+
+* The *optimizer* is an implementation of the [`Minimizer`](qiskit.algorithms.optimizers.Minimizer "qiskit.algorithms.optimizers.Minimizer") protocol, a callable used to run the optimization process. The choice of optimizer may affect overall convergence, required time for the optimization process and achieved objective value.
+* The *approximate circuit* represents a template which parameters we want to optimize. Currently, there’s only one implementation based on 4-rotations CNOT unit blocks: [`CNOTUnitCircuit`](qiskit.synthesis.unitary.aqc.CNOTUnitCircuit "qiskit.synthesis.unitary.aqc.CNOTUnitCircuit"). See the paper for more details.
+* The *approximate objective* is tightly coupled with the approximate circuit implementation and provides two methods for computing objective function and gradient with respect to approximate circuit parameters. This objective is passed to the optimizer. Currently, there are two implementations based on 4-rotations CNOT unit blocks: [`DefaultCNOTUnitObjective`](qiskit.synthesis.unitary.aqc.DefaultCNOTUnitObjective "qiskit.synthesis.unitary.aqc.DefaultCNOTUnitObjective") and its accelerated version [`FastCNOTUnitObjective`](qiskit.synthesis.unitary.aqc.FastCNOTUnitObjective "qiskit.synthesis.unitary.aqc.FastCNOTUnitObjective"). Both implementations share the same idea of maximization the Hilbert-Schmidt product between the target matrix and its approximation. The former implementation approach should be considered as a baseline one. It may suffer from performance issues, and is mostly suitable for a small number of qubits (up to 5 or 6), whereas the latter, accelerated one, can be applied to larger problems.
+* One should take into consideration the exponential growth of matrix size with the number of qubits because the implementation not only creates a potentially large target matrix, but also allocates a number of temporary memory buffers comparable in size to the target matrix.
+
+
+ Setting the optimizer argument to an instance of qiskit.algorithms.optimizers.Optimizer is deprecated as of qiskit 0.45.0. It will be removed in the Qiskit 1.0 release. Please, submit a callable that follows the Minimizer protocol instead.
+
+
+**Parameters**
+
+* **optimizer** ([*Minimizer*](qiskit.algorithms.optimizers.Minimizer "qiskit.algorithms.optimizers.Minimizer") *|*[*Optimizer*](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer") *| None*) – an optimizer to be used in the optimization procedure of the search for the best approximate circuit. By default, the scipy minimizer with the `L-BFGS-B` method is used with max iterations set to 1000.
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – a seed value to be used by a random number generator.
+
+## Methods
+
+### compile\_unitary
+
+
+
+`compile_unitary(target_matrix, approximate_circuit, approximating_objective, initial_point=None)`
+
+Approximately compiles a circuit represented as a unitary matrix by solving an optimization problem defined by `approximating_objective` and using `approximate_circuit` as a template for the approximate circuit.
+
+**Parameters**
+
+* **target\_matrix** (*np.ndarray*) – a unitary matrix to approximate.
+* **approximate\_circuit** ([*ApproximateCircuit*](qiskit.synthesis.unitary.aqc.ApproximateCircuit "qiskit.synthesis.unitary.aqc.ApproximateCircuit")) – a template circuit that will be filled with the parameter values obtained in the optimization procedure.
+* **approximating\_objective** ([*ApproximatingObjective*](qiskit.synthesis.unitary.aqc.ApproximatingObjective "qiskit.synthesis.unitary.aqc.ApproximatingObjective")) – a definition of the optimization problem.
+* **initial\_point** (*np.ndarray | None*) – initial values of angles/parameters to start optimization from.
+
diff --git a/docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.ApproximateCircuit.md b/docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.ApproximateCircuit.md
new file mode 100644
index 00000000000..926e2370bfe
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.ApproximateCircuit.md
@@ -0,0 +1,240 @@
+---
+title: ApproximateCircuit
+description: API reference for qiskit.synthesis.unitary.aqc.ApproximateCircuit
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.synthesis.unitary.aqc.ApproximateCircuit
+---
+
+# ApproximateCircuit
+
+
+
+`qiskit.synthesis.unitary.aqc.ApproximateCircuit(num_qubits, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/unitary/aqc/approximate.py "view source code")
+
+Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit"), [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+A base class that represents an approximate circuit.
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of qubit this circuit will span.
+* **name** (*Optional\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – a name of the circuit.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 159`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+
+
+### thetas
+
+The property is not implemented and raises a `NotImplementedException` exception.
+
+**Returns**
+
+a vector of parameters of this circuit.
+
+## Methods
+
+### build
+
+
+
+`abstract build(thetas)`
+
+**Constructs this circuit out of the parameters(thetas). Parameter values must be set before**
+
+constructing the circuit.
+
+**Parameters**
+
+**thetas** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – a vector of parameters to be set in this circuit.
+
diff --git a/docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.ApproximatingObjective.md b/docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.ApproximatingObjective.md
new file mode 100644
index 00000000000..6fb56ec00a0
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.ApproximatingObjective.md
@@ -0,0 +1,74 @@
+---
+title: ApproximatingObjective
+description: API reference for qiskit.synthesis.unitary.aqc.ApproximatingObjective
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.synthesis.unitary.aqc.ApproximatingObjective
+---
+
+# ApproximatingObjective
+
+
+
+`qiskit.synthesis.unitary.aqc.ApproximatingObjective`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/unitary/aqc/approximate.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+A base class for an optimization problem definition. An implementing class must provide at least an implementation of the `objective` method. In such case only gradient free optimizers can be used. Both method, `objective` and `gradient`, preferable to have in an implementation.
+
+## Attributes
+
+
+
+### num\_thetas
+
+Returns: the number of parameters in this optimization problem.
+
+
+
+### target\_matrix
+
+Returns: a matrix being approximated
+
+## Methods
+
+### gradient
+
+
+
+`abstract gradient(param_values)`
+
+Computes a gradient with respect to parameters given a vector of parameter values.
+
+**Parameters**
+
+**param\_values** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – a vector of parameter values for the optimization problem.
+
+**Returns**
+
+an array of gradient values.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+### objective
+
+
+
+`abstract objective(param_values)`
+
+Computes a value of the objective function given a vector of parameter values.
+
+**Parameters**
+
+**param\_values** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – a vector of parameter values for the optimization problem.
+
+**Returns**
+
+a float value of the objective function.
+
+**Return type**
+
+[*SupportsFloat*](https://docs.python.org/3/library/typing.html#typing.SupportsFloat "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.CNOTUnitCircuit.md b/docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.CNOTUnitCircuit.md
new file mode 100644
index 00000000000..86133578291
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.CNOTUnitCircuit.md
@@ -0,0 +1,242 @@
+---
+title: CNOTUnitCircuit
+description: API reference for qiskit.synthesis.unitary.aqc.CNOTUnitCircuit
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.synthesis.unitary.aqc.CNOTUnitCircuit
+---
+
+# CNOTUnitCircuit
+
+
+
+`qiskit.synthesis.unitary.aqc.CNOTUnitCircuit(num_qubits, cnots, tol=0.0, name=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/unitary/aqc/cnot_unit_circuit.py "view source code")
+
+Bases: [`ApproximateCircuit`](qiskit.synthesis.unitary.aqc.ApproximateCircuit "qiskit.synthesis.unitary.aqc.approximate.ApproximateCircuit")
+
+A class that represents an approximate circuit based on CNOT unit blocks.
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of qubits in this circuit.
+* **cnots** (*np.ndarray*) – an array of dimensions `(2, L)` indicating where the CNOT units will be placed.
+* **tol** (*Optional\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – angle parameter less or equal this (small) value is considered equal zero and corresponding gate is not inserted into the output circuit (because it becomes identity one in this case).
+* **name** (*Optional\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – name of this circuit
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – if an unsupported parameter is passed.
+
+## Attributes
+
+
+
+### ancillas
+
+Returns a list of ancilla bits in the order that the registers were added.
+
+
+
+### calibrations
+
+Return calibration dictionary.
+
+The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`
+
+
+
+### clbits
+
+Returns a list of classical bits in the order that the registers were added.
+
+
+
+### data
+
+Return the circuit data (instructions and context).
+
+**Returns**
+
+a list-like object containing the [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s for each instruction.
+
+**Return type**
+
+QuantumCircuitData
+
+
+
+### extension\_lib
+
+`= 'include "qelib1.inc";'`
+
+
+
+### global\_phase
+
+Return the global phase of the current circuit scope in radians.
+
+
+
+### header
+
+`= 'OPENQASM 2.0;'`
+
+
+
+### instances
+
+`= 159`
+
+
+
+### layout
+
+Return any associated layout information about the circuit
+
+This attribute contains an optional [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object. This is typically set on the output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`PassManager.run()`](qiskit.transpiler.PassManager#run "qiskit.transpiler.PassManager.run") to retain information about the permutations caused on the input circuit by transpilation.
+
+There are two types of permutations caused by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function, an initial layout which permutes the qubits based on the selected physical qubits on the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"), and a final layout which is an output permutation caused by [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted during routing.
+
+
+
+### metadata
+
+The user provided metadata associated with the circuit.
+
+The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
+
+
+
+### num\_ancillas
+
+Return the number of ancilla qubits.
+
+
+
+### num\_clbits
+
+Return number of classical bits.
+
+
+
+### num\_parameters
+
+The number of parameter objects in the circuit.
+
+
+
+### num\_qubits
+
+Return number of qubits.
+
+
+
+### op\_start\_times
+
+Return a list of operation start times.
+
+This attribute is enabled once one of scheduling analysis passes runs on the quantum circuit.
+
+**Returns**
+
+List of integers representing instruction start times. The index corresponds to the index of instruction in `QuantumCircuit.data`.
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – When circuit is not scheduled.
+
+
+
+### parameters
+
+The parameters defined in the circuit.
+
+This attribute returns the [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit sorted alphabetically. Note that parameters instantiated with a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") are still sorted numerically.
+
+**Examples**
+
+The snippet below shows that insertion order of parameters does not matter.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
+>>> circuit = QuantumCircuit(1)
+>>> circuit.rx(b, 0)
+>>> circuit.rz(elephant, 0)
+>>> circuit.ry(a, 0)
+>>> circuit.parameters # sorted alphabetically!
+ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])
+```
+
+Bear in mind that alphabetical sorting might be unintuitive when it comes to numbers. The literal “10” comes before “2” in strict alphabetical sorting.
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter
+>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
+>>> circuit = QuantumCircuit(1)
+>>> circuit.u(*angles, 0)
+>>> circuit.draw()
+ ┌─────────────────────────────┐
+q: ┤ U(angle_1,angle_2,angle_10) ├
+ └─────────────────────────────┘
+>>> circuit.parameters
+ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])
+```
+
+To respect numerical sorting, a [`ParameterVector`](qiskit.circuit.ParameterVector "qiskit.circuit.ParameterVector") can be used.
+
+```python
+```
+
+```python
+>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
+>>> x = ParameterVector("x", 12)
+>>> circuit = QuantumCircuit(1)
+>>> for x_i in x:
+... circuit.rx(x_i, 0)
+>>> circuit.parameters
+ParameterView([
+ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
+ ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
+ ..., ParameterVectorElement(x[11])
+])
+```
+
+**Returns**
+
+The sorted [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the circuit.
+
+
+
+### prefix
+
+`= 'circuit'`
+
+
+
+### qubits
+
+Returns a list of quantum bits in the order that the registers were added.
+
+
+
+### thetas
+
+Returns a vector of rotation angles used by CNOT units in this circuit.
+
+**Returns**
+
+Parameters of the rotation gates in this circuit.
+
+## Methods
+
+### build
+
+
+
+`build(thetas)`
+
+**Constructs a Qiskit quantum circuit out of the parameters (angles) of this circuit. If a**
+
+parameter value is less in absolute value than the specified tolerance then the corresponding rotation gate will be skipped in the circuit.
+
diff --git a/docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.CNOTUnitObjective.md b/docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.CNOTUnitObjective.md
new file mode 100644
index 00000000000..c9aa658137f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.CNOTUnitObjective.md
@@ -0,0 +1,43 @@
+---
+title: CNOTUnitObjective
+description: API reference for qiskit.synthesis.unitary.aqc.CNOTUnitObjective
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.synthesis.unitary.aqc.CNOTUnitObjective
+---
+
+# CNOTUnitObjective
+
+
+
+`qiskit.synthesis.unitary.aqc.CNOTUnitObjective(num_qubits, cnots)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/unitary/aqc/cnot_unit_objective.py "view source code")
+
+Bases: [`ApproximatingObjective`](qiskit.synthesis.unitary.aqc.ApproximatingObjective "qiskit.synthesis.unitary.aqc.approximate.ApproximatingObjective"), [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+A base class for a problem definition based on CNOT unit. This class may have different subclasses for objective and gradient computations.
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of qubits.
+* **cnots** (*np.ndarray*) – a CNOT structure to be used in the optimization procedure.
+
+## Attributes
+
+
+
+### num\_cnots
+
+Returns: A number of CNOT units to be used by the approximate circuit.
+
+
+
+### num\_thetas
+
+Returns: Number of parameters (angles) of rotation gates in this circuit.
+
+
+
+### target\_matrix
+
+Returns: a matrix being approximated
+
diff --git a/docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.DefaultCNOTUnitObjective.md b/docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.DefaultCNOTUnitObjective.md
new file mode 100644
index 00000000000..6065f3509f5
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.DefaultCNOTUnitObjective.md
@@ -0,0 +1,85 @@
+---
+title: DefaultCNOTUnitObjective
+description: API reference for qiskit.synthesis.unitary.aqc.DefaultCNOTUnitObjective
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.synthesis.unitary.aqc.DefaultCNOTUnitObjective
+---
+
+# DefaultCNOTUnitObjective
+
+
+
+`qiskit.synthesis.unitary.aqc.DefaultCNOTUnitObjective(num_qubits, cnots)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/unitary/aqc/cnot_unit_objective.py "view source code")
+
+Bases: [`CNOTUnitObjective`](qiskit.synthesis.unitary.aqc.CNOTUnitObjective "qiskit.synthesis.unitary.aqc.cnot_unit_objective.CNOTUnitObjective")
+
+A naive implementation of the objective function based on CNOT units.
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of qubits.
+* **cnots** (*np.ndarray*) – a CNOT structure to be used in the optimization procedure.
+
+## Attributes
+
+
+
+### num\_cnots
+
+Returns: A number of CNOT units to be used by the approximate circuit.
+
+
+
+### num\_thetas
+
+Returns: Number of parameters (angles) of rotation gates in this circuit.
+
+
+
+### target\_matrix
+
+Returns: a matrix being approximated
+
+## Methods
+
+### gradient
+
+
+
+`gradient(param_values)`
+
+Computes a gradient with respect to parameters given a vector of parameter values.
+
+**Parameters**
+
+**param\_values** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – a vector of parameter values for the optimization problem.
+
+**Returns**
+
+an array of gradient values.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+### objective
+
+
+
+`objective(param_values)`
+
+Computes a value of the objective function given a vector of parameter values.
+
+**Parameters**
+
+**param\_values** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – a vector of parameter values for the optimization problem.
+
+**Returns**
+
+a float value of the objective function.
+
+**Return type**
+
+[*SupportsFloat*](https://docs.python.org/3/library/typing.html#typing.SupportsFloat "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.FastCNOTUnitObjective.md b/docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.FastCNOTUnitObjective.md
new file mode 100644
index 00000000000..54c624849c8
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.synthesis.unitary.aqc.FastCNOTUnitObjective.md
@@ -0,0 +1,69 @@
+---
+title: FastCNOTUnitObjective
+description: API reference for qiskit.synthesis.unitary.aqc.FastCNOTUnitObjective
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.synthesis.unitary.aqc.FastCNOTUnitObjective
+---
+
+# FastCNOTUnitObjective
+
+
+
+`qiskit.synthesis.unitary.aqc.FastCNOTUnitObjective(num_qubits, cnots)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/unitary/aqc/fast_gradient/fast_gradient.py "view source code")
+
+Bases: [`CNOTUnitObjective`](qiskit.synthesis.unitary.aqc.CNOTUnitObjective "qiskit.synthesis.unitary.aqc.cnot_unit_objective.CNOTUnitObjective")
+
+Implementation of objective function and gradient calculator, which is similar to `DefaultCNOTUnitObjective` but several times faster.
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of qubits.
+* **cnots** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – a CNOT structure to be used in the optimization procedure.
+
+## Attributes
+
+
+
+### num\_cnots
+
+Returns: A number of CNOT units to be used by the approximate circuit.
+
+
+
+### num\_thetas
+
+Returns: Number of parameters (angles) of rotation gates in this circuit.
+
+
+
+### target\_matrix
+
+Returns: a matrix being approximated
+
+## Methods
+
+### gradient
+
+
+
+`gradient(param_values)`
+
+Computes the gradient of objective function. See description of the base class method.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+### objective
+
+
+
+`objective(param_values)`
+
+Computes the objective function and some intermediate data for the subsequent gradient computation. See description of the base class method.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.AnalysisPass.md b/docs/api/qiskit/0.46/qiskit.transpiler.AnalysisPass.md
new file mode 100644
index 00000000000..326e3ef21ed
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.AnalysisPass.md
@@ -0,0 +1,109 @@
+---
+title: AnalysisPass
+description: API reference for qiskit.transpiler.AnalysisPass
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.AnalysisPass
+---
+
+# AnalysisPass
+
+
+
+`qiskit.transpiler.AnalysisPass(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/basepasses.py "view source code")
+
+Bases: `BasePass`
+
+An analysis pass: change property set, not DAG.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`abstract run(dag)`
+
+Run a pass on the DAGCircuit. This is implemented by the pass developer.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")) – the dag on which the pass is run.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – when this is left unimplemented for a pass.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.CouplingMap.md b/docs/api/qiskit/0.46/qiskit.transpiler.CouplingMap.md
new file mode 100644
index 00000000000..b17f0563e20
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.CouplingMap.md
@@ -0,0 +1,426 @@
+---
+title: CouplingMap
+description: API reference for qiskit.transpiler.CouplingMap
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.CouplingMap
+---
+
+# CouplingMap
+
+
+
+`qiskit.transpiler.CouplingMap(couplinglist=None, description=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/coupling.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Directed graph specifying fixed coupling.
+
+Nodes correspond to physical qubits (integers) and directed edges correspond to permitted CNOT gates, with source and destination corresponding to control and target qubits, respectively.
+
+Create coupling graph. By default, the generated coupling has no nodes.
+
+**Parameters**
+
+* **couplinglist** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or None*) – An initial coupling graph, specified as an adjacency list containing couplings, e.g. \[\[0,1], \[0,2], \[1,2]]. It is required that nodes are contiguously indexed starting at 0. Missed nodes will be added as isolated nodes in the coupling map.
+* **description** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – A string to describe the coupling map.
+
+## Attributes
+
+
+
+### description
+
+
+
+### graph
+
+
+
+### distance\_matrix
+
+Return the distance matrix for the coupling map.
+
+For any qubits where there isn’t a path available between them the value in this position of the distance matrix will be `math.inf`.
+
+
+
+### is\_symmetric
+
+Test if the graph is symmetric.
+
+Return True if symmetric, False otherwise
+
+
+
+### physical\_qubits
+
+Returns a sorted list of physical\_qubits
+
+## Methods
+
+### add\_edge
+
+
+
+`add_edge(src, dst)`
+
+Add directed edge to coupling graph.
+
+src (int): source physical qubit dst (int): destination physical qubit
+
+### add\_physical\_qubit
+
+
+
+`add_physical_qubit(physical_qubit)`
+
+Add a physical qubit to the coupling graph as a node.
+
+physical\_qubit (int): An integer representing a physical qubit.
+
+**Raises**
+
+[**CouplingError**](transpiler#qiskit.transpiler.CouplingError "qiskit.transpiler.CouplingError") – if trying to add duplicate qubit
+
+### compute\_distance\_matrix
+
+
+
+`compute_distance_matrix()`
+
+Compute the full distance matrix on pairs of nodes.
+
+The distance map self.\_dist\_matrix is computed from the graph using all\_pairs\_shortest\_path\_length. This is normally handled internally by the [`distance_matrix`](#qiskit.transpiler.CouplingMap.distance_matrix "qiskit.transpiler.CouplingMap.distance_matrix") attribute or the [`distance()`](#qiskit.transpiler.CouplingMap.distance "qiskit.transpiler.CouplingMap.distance") method but can be called if you’re accessing the distance matrix outside of those or want to pre-generate it.
+
+### connected\_components
+
+
+
+`connected_components()`
+
+Separate a [`CouplingMap`](#qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") into subgraph [`CouplingMap`](#qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") for each connected component.
+
+The connected components of a [`CouplingMap`](#qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") are the subgraphs that are not part of any larger subgraph. For example, if you had a coupling map that looked like:
+
+```python
+0 --> 1 4 --> 5 ---> 6 --> 7
+| |
+| |
+V V
+2 --> 3
+```
+
+then the connected components of that graph are the subgraphs:
+
+```python
+0 --> 1
+| |
+| |
+V V
+2 --> 3
+```
+
+and:
+
+```python
+4 --> 5 ---> 6 --> 7
+```
+
+For a connected [`CouplingMap`](#qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object there is only a single connected component, the entire [`CouplingMap`](#qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap").
+
+This method will return a list of [`CouplingMap`](#qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") objects, one for each connected component in this [`CouplingMap`](#qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap"). The data payload of each node in the [`graph`](#qiskit.transpiler.CouplingMap.graph "qiskit.transpiler.CouplingMap.graph") attribute will contain the qubit number in the original graph. This will enables mapping the qubit index in a component subgraph to the original qubit in the combined [`CouplingMap`](#qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap"). For example:
+
+```python
+from qiskit.transpiler import CouplingMap
+
+cmap = CouplingMap([[0, 1], [1, 2], [2, 0], [3, 4], [4, 5], [5, 3]])
+component_cmaps = cmap.connected_components()
+print(component_cmaps[1].graph[0])
+```
+
+will print `3` as index `0` in the second component is qubit 3 in the original cmap.
+
+**Returns**
+
+**A list of [`CouplingMap`](#qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") objects for each connected**
+
+components. The order of this list is deterministic but implementation specific and shouldn’t be relied upon as part of the API.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+### distance
+
+
+
+`distance(physical_qubit1, physical_qubit2)`
+
+Returns the undirected distance between physical\_qubit1 and physical\_qubit2.
+
+**Parameters**
+
+* **physical\_qubit1** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – A physical qubit
+* **physical\_qubit2** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Another physical qubit
+
+**Returns**
+
+The undirected distance
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+**Raises**
+
+[**CouplingError**](transpiler#qiskit.transpiler.CouplingError "qiskit.transpiler.CouplingError") – if the qubits do not exist in the CouplingMap
+
+### draw
+
+
+
+`draw()`
+
+Draws the coupling map.
+
+This function calls the [`graphviz_draw()`](https://www.rustworkx.org/apiref/rustworkx.visualization.graphviz_draw.html#rustworkx.visualization.graphviz_draw "(in rustworkx v0.14.0)") function from the `rustworkx` package to draw the [`CouplingMap`](#qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object.
+
+**Returns**
+
+Drawn coupling map.
+
+**Return type**
+
+PIL.Image
+
+### from\_full
+
+
+
+`classmethod from_full(num_qubits, bidirectional=True)`
+
+Return a fully connected coupling map on n qubits.
+
+**Return type**
+
+[*CouplingMap*](#qiskit.transpiler.CouplingMap "qiskit.transpiler.coupling.CouplingMap")
+
+### from\_grid
+
+
+
+`classmethod from_grid(num_rows, num_columns, bidirectional=True)`
+
+Return a coupling map of qubits connected on a grid of num\_rows x num\_columns.
+
+**Return type**
+
+[*CouplingMap*](#qiskit.transpiler.CouplingMap "qiskit.transpiler.coupling.CouplingMap")
+
+### from\_heavy\_hex
+
+
+
+`classmethod from_heavy_hex(distance, bidirectional=True)`
+
+Return a heavy hexagon graph coupling map.
+
+A heavy hexagon graph is described in:
+
+[https://journals.aps.org/prx/abstract/10.1103/PhysRevX.10.011022](https://journals.aps.org/prx/abstract/10.1103/PhysRevX.10.011022)
+
+**Parameters**
+
+* **distance** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The code distance for the generated heavy hex graph. The value for distance can be any odd positive integer. The distance relates to the number of qubits by: $n = \frac{5d^2 - 2d - 1}{2}$ where $n$ is the number of qubits and $d$ is the `distance` parameter.
+* **bidirectional** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether the edges in the output coupling graph are bidirectional or not. By default this is set to `True`
+
+**Returns**
+
+A heavy hex coupling graph
+
+**Return type**
+
+[CouplingMap](#qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")
+
+### from\_heavy\_square
+
+
+
+`classmethod from_heavy_square(distance, bidirectional=True)`
+
+Return a heavy square graph coupling map.
+
+A heavy square graph is described in:
+
+[https://journals.aps.org/prx/abstract/10.1103/PhysRevX.10.011022](https://journals.aps.org/prx/abstract/10.1103/PhysRevX.10.011022)
+
+**Parameters**
+
+* **distance** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The code distance for the generated heavy square graph. The value for distance can be any odd positive integer. The distance relates to the number of qubits by: $n = 3d^2 - 2d$ where $n$ is the number of qubits and $d$ is the `distance` parameter.
+* **bidirectional** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether the edges in the output coupling graph are bidirectional or not. By default this is set to `True`
+
+**Returns**
+
+A heavy square coupling graph
+
+**Return type**
+
+[CouplingMap](#qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")
+
+### from\_hexagonal\_lattice
+
+
+
+`classmethod from_hexagonal_lattice(rows, cols, bidirectional=True)`
+
+Return a hexagonal lattice graph coupling map.
+
+**Parameters**
+
+* **rows** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of rows to generate the graph with.
+* **cols** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of columns to generate the graph with.
+* **bidirectional** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether the edges in the output coupling graph are bidirectional or not. By default this is set to `True`
+
+**Returns**
+
+A hexagonal lattice coupling graph
+
+**Return type**
+
+[CouplingMap](#qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")
+
+### from\_line
+
+
+
+`classmethod from_line(num_qubits, bidirectional=True)`
+
+Return a coupling map of n qubits connected in a line.
+
+**Return type**
+
+[*CouplingMap*](#qiskit.transpiler.CouplingMap "qiskit.transpiler.coupling.CouplingMap")
+
+### from\_ring
+
+
+
+`classmethod from_ring(num_qubits, bidirectional=True)`
+
+Return a coupling map of n qubits connected to each of their neighbors in a ring.
+
+**Return type**
+
+[*CouplingMap*](#qiskit.transpiler.CouplingMap "qiskit.transpiler.coupling.CouplingMap")
+
+### get\_edges
+
+
+
+`get_edges()`
+
+Gets the list of edges in the coupling graph.
+
+**Returns**
+
+Each edge is a pair of physical qubits.
+
+**Return type**
+
+Tuple([int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)"),[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)"))
+
+### is\_connected
+
+
+
+`is_connected()`
+
+Test if the graph is connected.
+
+Return True if connected, False otherwise
+
+### largest\_connected\_component
+
+
+
+`largest_connected_component()`
+
+Return a set of qubits in the largest connected component.
+
+### make\_symmetric
+
+
+
+`make_symmetric()`
+
+Convert uni-directional edges into bi-directional.
+
+### neighbors
+
+
+
+`neighbors(physical_qubit)`
+
+Return the nearest neighbors of a physical qubit.
+
+Directionality matters, i.e. a neighbor must be reachable by going one hop in the direction of an edge.
+
+### reduce
+
+
+
+`reduce(mapping, check_if_connected=True)`
+
+Returns a reduced coupling map that corresponds to the subgraph of qubits selected in the mapping.
+
+**Parameters**
+
+* **mapping** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A mapping of reduced qubits to device qubits.
+* **check\_if\_connected** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if True, checks that the reduced coupling map is connected.
+
+**Returns**
+
+A reduced coupling\_map for the selected qubits.
+
+**Return type**
+
+[CouplingMap](#qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")
+
+**Raises**
+
+[**CouplingError**](transpiler#qiskit.transpiler.CouplingError "qiskit.transpiler.CouplingError") – Reduced coupling map must be connected.
+
+### shortest\_undirected\_path
+
+
+
+`shortest_undirected_path(physical_qubit1, physical_qubit2)`
+
+Returns the shortest undirected path between physical\_qubit1 and physical\_qubit2.
+
+**Parameters**
+
+* **physical\_qubit1** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – A physical qubit
+* **physical\_qubit2** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Another physical qubit
+
+**Returns**
+
+The shortest undirected path
+
+**Return type**
+
+List
+
+**Raises**
+
+[**CouplingError**](transpiler#qiskit.transpiler.CouplingError "qiskit.transpiler.CouplingError") – When there is no path between physical\_qubit1, physical\_qubit2.
+
+### size
+
+
+
+`size()`
+
+Return the number of physical qubits in this graph.
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.FencedDAGCircuit.md b/docs/api/qiskit/0.46/qiskit.transpiler.FencedDAGCircuit.md
new file mode 100644
index 00000000000..bc4cff65e23
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.FencedDAGCircuit.md
@@ -0,0 +1,22 @@
+---
+title: FencedDAGCircuit
+description: API reference for qiskit.transpiler.FencedDAGCircuit
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.FencedDAGCircuit
+---
+
+# FencedDAGCircuit
+
+
+
+`qiskit.transpiler.FencedDAGCircuit(dag_circuit_instance)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/fencedobjs.py "view source code")
+
+Bases: `FencedObject`
+
+A dag circuit that cannot be modified (via remove\_op\_node)
+
+
+ The class `qiskit.transpiler.fencedobjs.FencedDAGCircuit` is deprecated as of qiskit 0.46.0. It will be removed in the 1.0 release. Internal use of FencedObject is already removed from pass manager. Implementation of a task subclass with protection for input object modification is now responsibility of the developer.
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.FencedPropertySet.md b/docs/api/qiskit/0.46/qiskit.transpiler.FencedPropertySet.md
new file mode 100644
index 00000000000..d83dd5e8f66
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.FencedPropertySet.md
@@ -0,0 +1,22 @@
+---
+title: FencedPropertySet
+description: API reference for qiskit.transpiler.FencedPropertySet
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.FencedPropertySet
+---
+
+# FencedPropertySet
+
+
+
+`qiskit.transpiler.FencedPropertySet(property_set_instance)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/fencedobjs.py "view source code")
+
+Bases: `FencedObject`
+
+A property set that cannot be written (via \_\_setitem\_\_)
+
+
+ The class `qiskit.transpiler.fencedobjs.FencedPropertySet` is deprecated as of qiskit 0.46.0. It will be removed in the 1.0 release. Internal use of FencedObject is already removed from pass manager. Implementation of a task subclass with protection for input object modification is now responsibility of the developer.
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.InstructionDurations.md b/docs/api/qiskit/0.46/qiskit.transpiler.InstructionDurations.md
new file mode 100644
index 00000000000..e97bb79a815
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.InstructionDurations.md
@@ -0,0 +1,116 @@
+---
+title: InstructionDurations
+description: API reference for qiskit.transpiler.InstructionDurations
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.InstructionDurations
+---
+
+# InstructionDurations
+
+
+
+`qiskit.transpiler.InstructionDurations(instruction_durations=None, dt=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/instruction_durations.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Helper class to provide durations of instructions for scheduling.
+
+It stores durations (gate lengths) and dt to be used at the scheduling stage of transpiling. It can be constructed from `backend` or `instruction_durations`, which is an argument of `transpile()`. The duration of an instruction depends on the instruction (given by name), the qubits, and optionally the parameters of the instruction. Note that these fields are used as keys in dictionaries that are used to retrieve the instruction durations. Therefore, users must use the exact same parameter value to retrieve an instruction duration as the value with which it was added.
+
+## Methods
+
+### from\_backend
+
+
+
+`classmethod from_backend(backend)`
+
+Construct an [`InstructionDurations`](#qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") object from the backend.
+
+**Parameters**
+
+**backend** ([*Backend*](qiskit.providers.Backend "qiskit.providers.backend.Backend")) – backend from which durations (gate lengths) and dt are extracted.
+
+**Returns**
+
+The InstructionDurations constructed from backend.
+
+**Return type**
+
+[InstructionDurations](#qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations")
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – If dt and dtm is different in the backend.
+
+### get
+
+
+
+`get(inst, qubits, unit='dt', parameters=None)`
+
+Get the duration of the instruction with the name, qubits, and parameters.
+
+Some instructions may have a parameter dependent duration.
+
+**Parameters**
+
+* **inst** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*qiskit.circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction")) – An instruction or its name to be queried.
+* **qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – Qubit indices that the instruction acts on.
+* **unit** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The unit of duration to be returned. It must be ‘s’ or ‘dt’.
+* **parameters** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*] | None*) – The value of the parameters of the desired instruction.
+
+**Returns**
+
+The duration of the instruction on the qubits.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")|[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – No duration is defined for the instruction.
+
+### units\_used
+
+
+
+`units_used()`
+
+Get the set of all units used in this instruction durations.
+
+**Returns**
+
+Set of units used in this instruction durations.
+
+**Return type**
+
+[set](https://docs.python.org/3/library/stdtypes.html#set "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")]
+
+### update
+
+
+
+`update(inst_durations, dt=None)`
+
+Update self with inst\_durations (inst\_durations overwrite self).
+
+**Parameters**
+
+* **inst\_durations** (*'InstructionDurationsType' | None*) – Instruction durations to be merged into self (overwriting self).
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Sampling duration in seconds of the target backend.
+
+**Returns**
+
+The updated InstructionDurations.
+
+**Return type**
+
+[InstructionDurations](#qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations")
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – If the format of instruction\_durations is invalid.
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.InstructionProperties.md b/docs/api/qiskit/0.46/qiskit.transpiler.InstructionProperties.md
new file mode 100644
index 00000000000..cc076285d7e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.InstructionProperties.md
@@ -0,0 +1,52 @@
+---
+title: InstructionProperties
+description: API reference for qiskit.transpiler.InstructionProperties
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.InstructionProperties
+---
+
+# InstructionProperties
+
+
+
+`qiskit.transpiler.InstructionProperties(duration=None, error=None, calibration=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/target.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+A representation of the properties of a gate implementation.
+
+This class provides the optional properties that a backend can provide about an instruction. These represent the set that the transpiler can currently work with if present. However, if your backend provides additional properties for instructions you should subclass this to add additional custom attributes for those custom/additional properties by the backend.
+
+Create a new `InstructionProperties` object
+
+**Parameters**
+
+* **duration** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The duration, in seconds, of the instruction on the specified set of qubits
+* **error** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The average error rate for the instruction on the specified set of qubits.
+* **calibration** ([*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule") *|*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") *| CalibrationEntry | None*) – The pulse representation of the instruction.
+
+## Attributes
+
+
+
+### duration
+
+
+
+### error
+
+
+
+### calibration
+
+The pulse representation of the instruction.
+
+
+ This attribute always returns a Qiskit pulse program, but it is internally wrapped by the `CalibrationEntry` to manage unbound parameters and to uniformly handle different data representation, for example, un-parsed Pulse Qobj JSON that a backend provider may provide.
+
+ This value can be overridden through the property setter in following manner. When you set either [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") or [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") this is always treated as a user-defined (custom) calibration and the transpiler may automatically attach the calibration data to the output circuit. This calibration data may appear in the wire format as an inline calibration, which may further update the backend standard instruction set architecture.
+
+ If you are a backend provider who provides a default calibration data that is not needed to be attached to the transpiled quantum circuit, you can directly set `CalibrationEntry` instance to this attribute, in which you should set `user_provided=False` when you define calibration data for the entry. End users can still intentionally utilize the calibration data, for example, to run pulse-level simulation of the circuit. However, such entry doesn’t appear in the wire format, and backend must use own definition to compile the circuit down to the execution format.
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.Layout.md b/docs/api/qiskit/0.46/qiskit.transpiler.Layout.md
new file mode 100644
index 00000000000..964fb521c22
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.Layout.md
@@ -0,0 +1,267 @@
+---
+title: Layout
+description: API reference for qiskit.transpiler.Layout
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.Layout
+---
+
+# Layout
+
+
+
+`qiskit.transpiler.Layout(input_dict=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/layout.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Two-ways dict to represent a Layout.
+
+construct a Layout from a bijective dictionary, mapping virtual qubits to physical qubits
+
+## Methods
+
+### add
+
+
+
+`add(virtual_bit, physical_bit=None)`
+
+Adds a map element between bit and physical\_bit. If physical\_bit is not defined, bit will be mapped to a new physical bit.
+
+**Parameters**
+
+* **virtual\_bit** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – A (qu)bit. For example, (QuantumRegister(3, ‘qr’), 2).
+* **physical\_bit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – A physical bit. For example, 3.
+
+### add\_register
+
+
+
+`add_register(reg)`
+
+Adds at the end physical\_qubits that map each bit in reg.
+
+**Parameters**
+
+**reg** ([*Register*](qiskit.circuit.Register "qiskit.circuit.Register")) – A (qu)bit Register. For example, QuantumRegister(3, ‘qr’).
+
+### combine\_into\_edge\_map
+
+
+
+`combine_into_edge_map(another_layout)`
+
+Combines self and another\_layout into an “edge map”.
+
+For example:
+
+```python
+ self another_layout resulting edge map
+qr_1 -> 0 0 <- q_2 qr_1 -> q_2
+qr_2 -> 2 2 <- q_1 qr_2 -> q_1
+qr_3 -> 3 3 <- q_0 qr_3 -> q_0
+```
+
+The edge map is used to compose dags via, for example, compose.
+
+**Parameters**
+
+**another\_layout** ([*Layout*](#qiskit.transpiler.Layout "qiskit.transpiler.Layout")) – The other layout to combine.
+
+**Returns**
+
+A “edge map”.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+**Raises**
+
+[**LayoutError**](transpiler#qiskit.transpiler.LayoutError "qiskit.transpiler.LayoutError") – another\_layout can be bigger than self, but not smaller. Otherwise, raises.
+
+### copy
+
+
+
+`copy()`
+
+Returns a copy of a Layout instance.
+
+### from\_dict
+
+
+
+`from_dict(input_dict)`
+
+Populates a Layout from a dictionary.
+
+The dictionary must be a bijective mapping between virtual qubits (tuple) and physical qubits (int).
+
+**Parameters**
+
+**input\_dict** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) –
+
+e.g.:
+
+```python
+{(QuantumRegister(3, 'qr'), 0): 0,
+ (QuantumRegister(3, 'qr'), 1): 1,
+ (QuantumRegister(3, 'qr'), 2): 2}
+
+Can be written more concisely as follows:
+
+* virtual to physical::
+
+ {qr[0]: 0,
+ qr[1]: 1,
+ qr[2]: 2}
+
+* physical to virtual::
+
+ {0: qr[0],
+ 1: qr[1],
+ 2: qr[2]}
+```
+
+### from\_intlist
+
+
+
+`static from_intlist(int_list, *qregs)`
+
+Converts a list of integers to a Layout mapping virtual qubits (index of the list) to physical qubits (the list values).
+
+**Parameters**
+
+* **int\_list** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of integers.
+* **\*qregs** (*QuantumRegisters*) – The quantum registers to apply the layout to.
+
+**Returns**
+
+The corresponding Layout object.
+
+**Return type**
+
+[Layout](#qiskit.transpiler.Layout "qiskit.transpiler.Layout")
+
+**Raises**
+
+[**LayoutError**](transpiler#qiskit.transpiler.LayoutError "qiskit.transpiler.LayoutError") – Invalid input layout.
+
+### from\_qubit\_list
+
+
+
+`static from_qubit_list(qubit_list, *qregs)`
+
+Populates a Layout from a list containing virtual qubits, Qubit or None.
+
+**Parameters**
+
+* **qubit\_list** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – e.g.: \[qr\[0], None, qr\[2], qr\[3]]
+* **\*qregs** (*QuantumRegisters*) – The quantum registers to apply the layout to.
+
+**Returns**
+
+the corresponding Layout object
+
+**Return type**
+
+[Layout](#qiskit.transpiler.Layout "qiskit.transpiler.Layout")
+
+**Raises**
+
+[**LayoutError**](transpiler#qiskit.transpiler.LayoutError "qiskit.transpiler.LayoutError") – If the elements are not Qubit or None
+
+### generate\_trivial\_layout
+
+
+
+`static generate_trivial_layout(*regs)`
+
+Creates a trivial (“one-to-one”) Layout with the registers and qubits in regs.
+
+**Parameters**
+
+**\*regs** (*Registers, Qubits*) – registers and qubits to include in the layout.
+
+**Returns**
+
+A layout with all the regs in the given order.
+
+**Return type**
+
+[Layout](#qiskit.transpiler.Layout "qiskit.transpiler.Layout")
+
+### get\_physical\_bits
+
+
+
+`get_physical_bits()`
+
+Returns the dictionary where the keys are physical (qu)bits and the values are virtual (qu)bits.
+
+### get\_registers
+
+
+
+`get_registers()`
+
+Returns the registers in the layout \[QuantumRegister(2, ‘qr0’), QuantumRegister(3, ‘qr1’)] :returns: A set of Registers in the layout :rtype: Set
+
+### get\_virtual\_bits
+
+
+
+`get_virtual_bits()`
+
+Returns the dictionary where the keys are virtual (qu)bits and the values are physical (qu)bits.
+
+### order\_based\_on\_type
+
+
+
+`static order_based_on_type(value1, value2)`
+
+decides which one is physical/virtual based on the type. Returns (virtual, physical)
+
+### reorder\_bits
+
+
+
+`reorder_bits(bits)`
+
+Given an ordered list of bits, reorder them according to this layout.
+
+The list of bits must exactly match the virtual bits in this layout.
+
+**Parameters**
+
+**bits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Bit*](qiskit.circuit.Bit "qiskit.circuit.Bit")*]*) – the bits to reorder.
+
+**Returns**
+
+ordered bits.
+
+**Return type**
+
+List
+
+### swap
+
+
+
+`swap(left, right)`
+
+Swaps the map between left and right.
+
+**Parameters**
+
+* **left** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)") *or*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Item to swap with right.
+* **right** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)") *or*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Item to swap with left.
+
+**Raises**
+
+[**LayoutError**](transpiler#qiskit.transpiler.LayoutError "qiskit.transpiler.LayoutError") – If left and right have not the same type.
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.PassManager.md b/docs/api/qiskit/0.46/qiskit.transpiler.PassManager.md
new file mode 100644
index 00000000000..e9f1ca16c72
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.PassManager.md
@@ -0,0 +1,217 @@
+---
+title: PassManager
+description: API reference for qiskit.transpiler.PassManager
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.PassManager
+---
+
+# PassManager
+
+
+
+`qiskit.transpiler.PassManager(passes=(), max_iteration=1000)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passmanager.py "view source code")
+
+Bases: [`BasePassManager`](qiskit.passmanager.BasePassManager "qiskit.passmanager.passmanager.BasePassManager")
+
+Manager for a set of Passes and their scheduling during transpilation.
+
+Initialize an empty pass manager object.
+
+**Parameters**
+
+* **passes** (*Task |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[Task]*) – A pass set to be added to the pass manager schedule.
+* **max\_iteration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The maximum number of iterations the schedule will be looped if the condition is not met.
+
+## Methods
+
+### append
+
+
+
+`append(passes, max_iteration=None, **flow_controller_conditions)`
+
+Append a Pass Set to the schedule of passes.
+
+
+ Creating flow controllers with `flow_controller_conditions` keyword arguments was deprecated. Instead, you must explicitly instantiate a controller and set the controller to `passes` argument.
+
+
+
+ `qiskit.transpiler.passmanager.PassManager.append()`’s argument `max_iteration` is deprecated as of qiskit 0.46. It will be removed in the 1.0 release. ‘max\_iteration’ can be set in the constructor.
+
+
+**Parameters**
+
+* **passes** (*Task |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[Task]*) – A set of passes (a pass set) to be added to schedule. A pass set is a list of passes that are controlled by the same flow controller. If a single pass is provided, the pass set will only have that pass a single element. It is also possible to append a `BaseFlowController` instance and the rest of the parameter will be ignored.
+
+* **max\_iteration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max number of iterations of passes.
+
+* **flow\_controller\_conditions** (*Any*) –
+
+ Dictionary of control flow plugins. Following built-in controllers are available by default:
+
+ * do\_while: The passes repeat until the callable returns False. Corresponds to [`DoWhileController`](qiskit.passmanager.DoWhileController "qiskit.passmanager.DoWhileController").
+ * condition: The passes run only if the callable returns True. Corresponds to [`ConditionalController`](qiskit.passmanager.ConditionalController "qiskit.passmanager.ConditionalController").
+
+ In general, you have more control simply by creating the controller you want and passing it to [`append()`](#qiskit.transpiler.PassManager.append "qiskit.transpiler.PassManager.append").
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if a pass in passes is not a proper pass.
+
+### draw
+
+
+
+`draw(filename=None, style=None, raw=False)`
+
+Draw the pass manager.
+
+This function needs [pydot](https://github.com/erocarrera/pydot), which in turn needs [Graphviz](https://www.graphviz.org/) to be installed.
+
+**Parameters**
+
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – file path to save image to.
+* **style** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – keys are the pass classes and the values are the colors to make them. An example can be seen in the DEFAULT\_STYLE. An ordered dict can be used to ensure a priority coloring when pass falls into multiple categories. Any values not included in the provided dict will be filled in from the default dict.
+* **raw** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If `True`, save the raw Dot output instead of the image.
+
+**Returns**
+
+an in-memory representation of the pass manager, or `None` if no image was generated or [Pillow](https://pypi.org/project/Pillow/) is not installed.
+
+**Return type**
+
+Optional\[[PassManager](#qiskit.transpiler.PassManager "qiskit.transpiler.PassManager")]
+
+**Raises**
+
+[**ImportError**](https://docs.python.org/3/library/exceptions.html#ImportError "(in Python v3.12)") – when nxpd or pydot not installed.
+
+### passes
+
+
+
+`passes()`
+
+Return a list structure of the appended passes and its options.
+
+
+ The method `qiskit.transpiler.passmanager.PassManager.passes()` is deprecated as of qiskit 0.46. It will be removed in the 1.0 release. Use .to\_flow\_controller().tasks instead. This returns a sequence of linearized base task instances in tuple format.
+
+
+**Returns**
+
+A list of pass sets, as defined in `append()`.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)"), qiskit.transpiler.basepasses.BasePass]]
+
+### remove
+
+
+
+`remove(index)`
+
+Removes a particular pass in the scheduler.
+
+**Parameters**
+
+**index** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Pass index to remove, based on the position in [`passes()`](transpiler_passes#module-qiskit.transpiler.passes "qiskit.transpiler.passes").
+
+**Raises**
+
+[**PassManagerError**](passmanager#qiskit.passmanager.PassManagerError "qiskit.passmanager.PassManagerError") – If the index is not found.
+
+### replace
+
+
+
+`replace(index, passes, max_iteration=None, **flow_controller_conditions)`
+
+Replace a particular pass in the scheduler.
+
+
+ Creating flow controllers with `flow_controller_conditions` keyword arguments was deprecated. Instead, you must explicitly instantiate a controller and set the controller to `passes` argument.
+
+
+
+ `qiskit.transpiler.passmanager.PassManager.replace()`’s argument `max_iteration` is deprecated as of qiskit 0.46. It will be removed in the 1.0 release. ‘max\_iteration’ can be set in the constructor.
+
+
+**Parameters**
+
+* **index** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Pass index to replace, based on the position in passes().
+* **passes** (*Task |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[Task]*) – A pass set to be added to the pass manager schedule.
+* **max\_iteration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max number of iterations of passes.
+* **flow\_controller\_conditions** (*Any*) – Dictionary of control flow plugins. See [`qiskit.transpiler.PassManager.append()`](#qiskit.transpiler.PassManager.append "qiskit.transpiler.PassManager.append") for details.
+
+### run
+
+
+
+`run(circuits, output_name=None, callback=None)`
+
+Run all the passes on the specified `circuits`.
+
+**Parameters**
+
+* **circuits** (*\_CircuitsT*) – Circuit(s) to transform via all the registered passes.
+
+* **output\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The output circuit name. If `None`, it will be set to the same as the input circuit name.
+
+* **callback** (*Callable*) –
+
+ A callback function that will be called after each pass execution. The function will be called with 5 keyword arguments:
+
+ ```python
+ pass_ (Pass): the pass being run
+ dag (DAGCircuit): the dag output of the pass
+ time (float): the time to execute the pass
+ property_set (PropertySet): the property set
+ count (int): the index for the pass execution
+ ```
+
+
+ Beware that the keyword arguments here are different to those used by the generic [`BasePassManager`](qiskit.passmanager.BasePassManager "qiskit.passmanager.BasePassManager"). This pass manager will translate those arguments into the form described above.
+
+
+ The exact arguments pass expose the internals of the pass manager and are subject to change as the pass manager internals change. If you intend to reuse a callback function over multiple releases be sure to check that the arguments being passed are the same.
+
+ To use the callback feature you define a function that will take in kwargs dict and access the variables. For example:
+
+ ```python
+ def callback_func(**kwargs):
+ pass_ = kwargs['pass_']
+ dag = kwargs['dag']
+ time = kwargs['time']
+ property_set = kwargs['property_set']
+ count = kwargs['count']
+ ...
+ ```
+
+**Returns**
+
+The transformed circuit(s).
+
+**Return type**
+
+\_CircuitsT
+
+### to\_flow\_controller
+
+
+
+`to_flow_controller()`
+
+Linearize this manager into a single [`FlowControllerLinear`](qiskit.passmanager.FlowControllerLinear "qiskit.passmanager.FlowControllerLinear"), so that it can be nested inside another pass manager.
+
+**Returns**
+
+A linearized pass manager.
+
+**Return type**
+
+*RunningPassManager*
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.PassManagerConfig.md b/docs/api/qiskit/0.46/qiskit.transpiler.PassManagerConfig.md
new file mode 100644
index 00000000000..92dc8eebf0a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.PassManagerConfig.md
@@ -0,0 +1,70 @@
+---
+title: PassManagerConfig
+description: API reference for qiskit.transpiler.PassManagerConfig
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.PassManagerConfig
+---
+
+# PassManagerConfig
+
+
+
+`qiskit.transpiler.PassManagerConfig(initial_layout=None, basis_gates=None, inst_map=None, coupling_map=None, layout_method=None, routing_method=None, translation_method=None, scheduling_method=None, instruction_durations=None, backend_properties=None, approximation_degree=None, seed_transpiler=None, timing_constraints=None, unitary_synthesis_method='default', unitary_synthesis_plugin_config=None, target=None, hls_config=None, init_method=None, optimization_method=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passmanager_config.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Pass Manager Configuration.
+
+Initialize a PassManagerConfig object
+
+**Parameters**
+
+* **initial\_layout** ([*Layout*](qiskit.transpiler.Layout "qiskit.transpiler.Layout")) – Initial position of virtual qubits on physical qubits.
+* **basis\_gates** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – List of basis gate names to unroll to.
+* **inst\_map** ([*InstructionScheduleMap*](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap")) – Mapping object that maps gate to schedule.
+* **coupling\_map** ([*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")) – Directed graph represented a coupling map.
+* **layout\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – the pass to use for choosing initial qubit placement. This will be the plugin name if an external layout stage plugin is being used.
+* **routing\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – the pass to use for routing qubits on the architecture. This will be a plugin name if an external routing stage plugin is being used.
+* **translation\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – the pass to use for translating gates to basis\_gates. This will be a plugin name if an external translation stage plugin is being used.
+* **scheduling\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – the pass to use for scheduling instructions. This will be a plugin name if an external scheduling stage plugin is being used.
+* **instruction\_durations** ([*InstructionDurations*](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations")) – Dictionary of duration (in dt) for each instruction.
+* **backend\_properties** ([*BackendProperties*](qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties")) – Properties returned by a backend, including information on gate errors, readout errors, qubit coherence times, etc.
+* **approximation\_degree** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – heuristic dial used for circuit approximation (1.0=no approximation, 0.0=maximal approximation)
+* **seed\_transpiler** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Sets random seed for the stochastic parts of the transpiler.
+* **timing\_constraints** (*TimingConstraints*) – Hardware time alignment restrictions.
+* **unitary\_synthesis\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The string method to use for the [`UnitarySynthesis`](qiskit.transpiler.passes.UnitarySynthesis "qiskit.transpiler.passes.UnitarySynthesis") pass. Will search installed plugins for a valid method. You can see a list of installed plugins with [`unitary_synthesis_plugin_names()`](qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names "qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names").
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – The backend target
+* **hls\_config** (*HLSConfig*) – An optional configuration class to use for [`HighLevelSynthesis`](qiskit.transpiler.passes.HighLevelSynthesis "qiskit.transpiler.passes.HighLevelSynthesis") pass. Specifies how to synthesize various high-level objects.
+* **init\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The plugin name for the init stage plugin to use
+* **optimization\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The plugin name for the optimization stage plugin to use.
+
+## Methods
+
+### from\_backend
+
+
+
+`classmethod from_backend(backend, _skip_target=False, **pass_manager_options)`
+
+Construct a configuration based on a backend and user input.
+
+This method automatically gererates a PassManagerConfig object based on the backend’s features. User options can be used to overwrite the configuration.
+
+**Parameters**
+
+* **backend** ([*BackendV1*](qiskit.providers.BackendV1 "qiskit.providers.BackendV1")) – The backend that provides the configuration.
+* **pass\_manager\_options** – User-defined option-value pairs.
+
+**Returns**
+
+The configuration generated based on the arguments.
+
+**Return type**
+
+[PassManagerConfig](#qiskit.transpiler.PassManagerConfig "qiskit.transpiler.PassManagerConfig")
+
+**Raises**
+
+[**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If the backend does not support a configuration() method.
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.StagedPassManager.md b/docs/api/qiskit/0.46/qiskit.transpiler.StagedPassManager.md
new file mode 100644
index 00000000000..298d0cd655f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.StagedPassManager.md
@@ -0,0 +1,241 @@
+---
+title: StagedPassManager
+description: API reference for qiskit.transpiler.StagedPassManager
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.StagedPassManager
+---
+
+# StagedPassManager
+
+
+
+`qiskit.transpiler.StagedPassManager(stages=None, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passmanager.py "view source code")
+
+Bases: [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.passmanager.PassManager")
+
+A pass manager pipeline built from individual stages.
+
+This class enables building a compilation pipeline out of fixed stages. Each `StagedPassManager` defines a list of stages which are executed in a fixed order, and each stage is defined as a standalone [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager") instance. There are also `pre_` and `post_` stages for each defined stage. This enables easily composing and replacing different stages and also adding hook points to enable programmatic modifications to a pipeline. When using a staged pass manager you are not able to modify the individual passes and are only able to modify stages.
+
+By default, instances of `StagedPassManager` define a typical full compilation pipeline from an abstract virtual circuit to one that is optimized and capable of running on the specified backend. The default pre-defined stages are:
+
+1. `init` - Initial passes to run before embedding the circuit to the backend.
+2. `layout` - Maps the virtual qubits in the circuit to the physical qubits on the backend.
+3. `routing` - Inserts gates as needed to move the qubit states around until the circuit can be run with the chosen layout on the backend’s coupling map.
+4. `translation` - Translates the gates in the circuit to the target backend’s basis gate set.
+5. `optimization` - Optimizes the circuit to reduce the cost of executing it. These passes will typically run in a loop until a convergence criteria is met. For example, the convergence criteria might be that the circuit depth does not decrease in successive iterations.
+6. `scheduling` - Hardware-aware passes that schedule the operations in the circuit.
+
+
+ For backwards compatibility the relative positioning of these default stages will remain stable moving forward. However, new stages may be added to the default stage list in between current stages. For example, in a future release a new phase, something like `logical_optimization`, could be added immediately after the existing `init` stage in the default stage list. This would preserve compatibility for pre-existing `StagedPassManager` users as the relative positions of the stage are preserved so the behavior will not change between releases.
+
+
+These stages will be executed in order and any stage set to `None` will be skipped. If a stage is provided multiple times (i.e. at diferent relative positions), the associated passes, including pre and post, will run once per declaration. If a [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager") input is being used for more than 1 stage here (for example in the case of a `Pass` that covers both Layout and Routing) you will want to set that to the earliest stage in sequence that it covers.
+
+Initialize a new StagedPassManager object
+
+**Parameters**
+
+* **stages** (*Iterable\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – An optional list of stages to use for this instance. If this is not specified the default stages list `['init', 'layout', 'routing', 'translation', 'optimization', 'scheduling']` is used. After instantiation, the final list will be immutable and stored as tuple. If a stage is provided multiple times (i.e. at diferent relative positions), the associated passes, including pre and post, will run once per declaration.
+* **kwargs** – The initial [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager") values for any stages defined in `stages`. If a argument is not defined the stages will default to `None` indicating an empty/undefined stage.
+
+**Raises**
+
+* [**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If a stage in the input keyword arguments is not defined.
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If an invalid stage name is specified.
+
+## Attributes
+
+
+
+### expanded\_stages
+
+Expanded Pass manager stages including `pre_` and `post_` phases.
+
+
+
+### invalid\_stage\_regex = re.compile('\\\s|\\\\+|\\\\-|\\\\\*|\\\\/|\\\\\\\\|\\\\%|\\\\\<|\\\\>|\\\\@|\\\\!|\\\\\~|\\\\^|\\\\&|\\\\
+
+`= re.compile('\\s|\\+|\\-|\\*|\\/|\\\\|\\%|\\<|\\>|\\@|\\!|\\~|\\^|\\&|\\:`
+
+`= re.compile('\\s|\\+|\\-|\\*|\\/|\\\\|\\%|\\<|\\>|\\@|\\!|\\~|\\^|\\&|\\:|\\[|\\]|\\{|\\}|\\(|\\)')`
+
+
+
+### stages
+
+Pass manager stages
+
+## Methods
+
+### append
+
+
+
+`append(passes, max_iteration=None, **flow_controller_conditions)`
+
+Append a Pass Set to the schedule of passes.
+
+
+ Creating flow controllers with `flow_controller_conditions` keyword arguments was deprecated. Instead, you must explicitly instantiate a controller and set the controller to `passes` argument.
+
+
+
+ `qiskit.transpiler.passmanager.PassManager.append()`’s argument `max_iteration` is deprecated as of qiskit 0.46. It will be removed in the 1.0 release. ‘max\_iteration’ can be set in the constructor.
+
+
+**Parameters**
+
+* **passes** (*Task |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[Task]*) – A set of passes (a pass set) to be added to schedule. A pass set is a list of passes that are controlled by the same flow controller. If a single pass is provided, the pass set will only have that pass a single element. It is also possible to append a `BaseFlowController` instance and the rest of the parameter will be ignored.
+
+* **max\_iteration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max number of iterations of passes.
+
+* **flow\_controller\_conditions** (*Any*) –
+
+ Dictionary of control flow plugins. Following built-in controllers are available by default:
+
+ * do\_while: The passes repeat until the callable returns False. Corresponds to [`DoWhileController`](qiskit.passmanager.DoWhileController "qiskit.passmanager.DoWhileController").
+ * condition: The passes run only if the callable returns True. Corresponds to [`ConditionalController`](qiskit.passmanager.ConditionalController "qiskit.passmanager.ConditionalController").
+
+ In general, you have more control simply by creating the controller you want and passing it to [`append()`](#qiskit.transpiler.StagedPassManager.append "qiskit.transpiler.StagedPassManager.append").
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if a pass in passes is not a proper pass.
+
+### draw
+
+
+
+`draw(filename=None, style=None, raw=False)`
+
+Draw the staged pass manager.
+
+### passes
+
+
+
+`passes()`
+
+Return a list structure of the appended passes and its options.
+
+
+ The method `qiskit.transpiler.passmanager.PassManager.passes()` is deprecated as of qiskit 0.46. It will be removed in the 1.0 release. Use .to\_flow\_controller().tasks instead. This returns a sequence of linearized base task instances in tuple format.
+
+
+**Returns**
+
+A list of pass sets, as defined in `append()`.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)"), qiskit.transpiler.basepasses.BasePass]]
+
+### remove
+
+
+
+`remove(index)`
+
+Removes a particular pass in the scheduler.
+
+**Parameters**
+
+**index** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Pass index to remove, based on the position in [`passes()`](transpiler_passes#module-qiskit.transpiler.passes "qiskit.transpiler.passes").
+
+**Raises**
+
+[**PassManagerError**](passmanager#qiskit.passmanager.PassManagerError "qiskit.passmanager.PassManagerError") – If the index is not found.
+
+### replace
+
+
+
+`replace(index, passes, max_iteration=None, **flow_controller_conditions)`
+
+Replace a particular pass in the scheduler.
+
+
+ Creating flow controllers with `flow_controller_conditions` keyword arguments was deprecated. Instead, you must explicitly instantiate a controller and set the controller to `passes` argument.
+
+
+
+ `qiskit.transpiler.passmanager.PassManager.replace()`’s argument `max_iteration` is deprecated as of qiskit 0.46. It will be removed in the 1.0 release. ‘max\_iteration’ can be set in the constructor.
+
+
+**Parameters**
+
+* **index** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Pass index to replace, based on the position in passes().
+* **passes** (*BasePass |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[BasePass]*) – A pass set to be added to the pass manager schedule.
+* **max\_iteration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – max number of iterations of passes.
+* **flow\_controller\_conditions** (*Any*) – Dictionary of control flow plugins. See [`qiskit.transpiler.PassManager.append()`](qiskit.transpiler.PassManager#append "qiskit.transpiler.PassManager.append") for details.
+
+### run
+
+
+
+`run(circuits, output_name=None, callback=None)`
+
+Run all the passes on the specified `circuits`.
+
+**Parameters**
+
+* **circuits** (*\_CircuitsT*) – Circuit(s) to transform via all the registered passes.
+
+* **output\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The output circuit name. If `None`, it will be set to the same as the input circuit name.
+
+* **callback** (*Callable | None*) –
+
+ A callback function that will be called after each pass execution. The function will be called with 5 keyword arguments:
+
+ ```python
+ pass_ (Pass): the pass being run
+ dag (DAGCircuit): the dag output of the pass
+ time (float): the time to execute the pass
+ property_set (PropertySet): the property set
+ count (int): the index for the pass execution
+ ```
+
+
+ Beware that the keyword arguments here are different to those used by the generic [`BasePassManager`](qiskit.passmanager.BasePassManager "qiskit.passmanager.BasePassManager"). This pass manager will translate those arguments into the form described above.
+
+
+ The exact arguments pass expose the internals of the pass manager and are subject to change as the pass manager internals change. If you intend to reuse a callback function over multiple releases be sure to check that the arguments being passed are the same.
+
+ To use the callback feature you define a function that will take in kwargs dict and access the variables. For example:
+
+ ```python
+ def callback_func(**kwargs):
+ pass_ = kwargs['pass_']
+ dag = kwargs['dag']
+ time = kwargs['time']
+ property_set = kwargs['property_set']
+ count = kwargs['count']
+ ...
+ ```
+
+**Returns**
+
+The transformed circuit(s).
+
+**Return type**
+
+\_CircuitsT
+
+### to\_flow\_controller
+
+
+
+`to_flow_controller()`
+
+Linearize this manager into a single [`FlowControllerLinear`](qiskit.passmanager.FlowControllerLinear "qiskit.passmanager.FlowControllerLinear"), so that it can be nested inside another pass manager.
+
+**Returns**
+
+A linearized pass manager.
+
+**Return type**
+
+*RunningPassManager*
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.Target.md b/docs/api/qiskit/0.46/qiskit.transpiler.Target.md
new file mode 100644
index 00000000000..445a2c3af39
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.Target.md
@@ -0,0 +1,649 @@
+---
+title: Target
+description: API reference for qiskit.transpiler.Target
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.Target
+---
+
+# Target
+
+
+
+`qiskit.transpiler.Target(description=None, num_qubits=0, dt=None, granularity=1, min_length=1, pulse_alignment=1, acquire_alignment=1, qubit_properties=None, concurrent_measurements=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/target.py "view source code")
+
+Bases: [`Mapping`](https://docs.python.org/3/library/collections.abc.html#collections.abc.Mapping "(in Python v3.12)")
+
+The intent of the `Target` object is to inform Qiskit’s compiler about the constraints of a particular backend so the compiler can compile an input circuit to something that works and is optimized for a device. It currently contains a description of instructions on a backend and their properties as well as some timing information. However, this exact interface may evolve over time as the needs of the compiler change. These changes will be done in a backwards compatible and controlled manner when they are made (either through versioning, subclassing, or mixins) to add on to the set of information exposed by a target.
+
+As a basic example, let’s assume backend has two qubits, supports [`UGate`](qiskit.circuit.library.UGate "qiskit.circuit.library.UGate") on both qubits and [`CXGate`](qiskit.circuit.library.CXGate "qiskit.circuit.library.CXGate") in both directions. To model this you would create the target like:
+
+```python
+from qiskit.transpiler import Target, InstructionProperties
+from qiskit.circuit.library import UGate, CXGate
+from qiskit.circuit import Parameter
+
+gmap = Target()
+theta = Parameter('theta')
+phi = Parameter('phi')
+lam = Parameter('lambda')
+u_props = {
+ (0,): InstructionProperties(duration=5.23e-8, error=0.00038115),
+ (1,): InstructionProperties(duration=4.52e-8, error=0.00032115),
+}
+gmap.add_instruction(UGate(theta, phi, lam), u_props)
+cx_props = {
+ (0,1): InstructionProperties(duration=5.23e-7, error=0.00098115),
+ (1,0): InstructionProperties(duration=4.52e-7, error=0.00132115),
+}
+gmap.add_instruction(CXGate(), cx_props)
+```
+
+Each instruction in the `Target` is indexed by a unique string name that uniquely identifies that instance of an [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") object in the Target. There is a 1:1 mapping between a name and an [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instance in the target and each name must be unique. By default, the name is the [`name`](qiskit.circuit.Instruction#name "qiskit.circuit.Instruction.name") attribute of the instruction, but can be set to anything. This lets a single target have multiple instances of the same instruction class with different parameters. For example, if a backend target has two instances of an [`RXGate`](qiskit.circuit.library.RXGate "qiskit.circuit.library.RXGate") one is parameterized over any theta while the other is tuned up for a theta of pi/6 you can add these by doing something like:
+
+```python
+import math
+
+from qiskit.transpiler import Target, InstructionProperties
+from qiskit.circuit.library import RXGate
+from qiskit.circuit import Parameter
+
+target = Target()
+theta = Parameter('theta')
+rx_props = {
+ (0,): InstructionProperties(duration=5.23e-8, error=0.00038115),
+}
+target.add_instruction(RXGate(theta), rx_props)
+rx_30_props = {
+ (0,): InstructionProperties(duration=1.74e-6, error=.00012)
+}
+target.add_instruction(RXGate(math.pi / 6), rx_30_props, name='rx_30')
+```
+
+Then in the `target` object accessing by `rx_30` will get the fixed angle [`RXGate`](qiskit.circuit.library.RXGate "qiskit.circuit.library.RXGate") while `rx` will get the parameterized [`RXGate`](qiskit.circuit.library.RXGate "qiskit.circuit.library.RXGate").
+
+
+ This class assumes that qubit indices start at 0 and are a contiguous set if you want a submapping the bits will need to be reindexed in a new\`\`Target\`\` object.
+
+
+
+ This class only supports additions of gates, qargs, and qubits. If you need to remove one of these the best option is to iterate over an existing object and create a new subset (or use one of the methods to do this). The object internally caches different views and these would potentially be invalidated by removals.
+
+
+Create a new `Target` object
+
+
+ `qiskit.transpiler.target.Target.__init__()`’s argument `aquire_alignment` is deprecated as of qiskit-terra 0.23.0. It will be removed in the Qiskit 1.0 release. Instead, use the argument `acquire_alignment`, which behaves identically.
+
+
+**Parameters**
+
+* **description** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – An optional string to describe the Target.
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – An optional int to specify the number of qubits the backend target has. If not set it will be implicitly set based on the qargs when `add_instruction()` is called. Note this must be set if the backend target is for a noiseless simulator that doesn’t have constraints on the instructions so the transpiler knows how many qubits are available.
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The system time resolution of input signals in seconds
+* **granularity** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – An integer value representing minimum pulse gate resolution in units of `dt`. A user-defined pulse gate should have duration of a multiple of this granularity value.
+* **min\_length** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – An integer value representing minimum pulse gate length in units of `dt`. A user-defined pulse gate should be longer than this length.
+* **pulse\_alignment** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – An integer value representing a time resolution of gate instruction starting time. Gate instruction should start at time which is a multiple of the alignment value.
+* **acquire\_alignment** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – An integer value representing a time resolution of measure instruction starting time. Measure instruction should start at time which is a multiple of the alignment value.
+* **qubit\_properties** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of [`QubitProperties`](qiskit.providers.QubitProperties "qiskit.providers.QubitProperties") objects defining the characteristics of each qubit on the target device. If specified the length of this list must match the number of qubits in the target, where the index in the list matches the qubit number the properties are defined for. If some qubits don’t have properties available you can set that entry to `None`
+* **concurrent\_measurements** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of sets of qubits that must be measured together. This must be provided as a nested list like `[[0, 1], [2, 3, 4]]`.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If both `num_qubits` and `qubit_properties` are both defined and the value of `num_qubits` differs from the length of `qubit_properties`.
+
+## Attributes
+
+
+
+### num\_qubits
+
+
+
+### description
+
+
+
+### dt
+
+
+
+### granularity
+
+
+
+### min\_length
+
+
+
+### pulse\_alignment
+
+
+
+### acquire\_alignment
+
+
+
+### qubit\_properties
+
+
+
+### concurrent\_measurements
+
+
+
+### aquire\_alignment
+
+Alias of deprecated name. This will be removed.
+
+
+ The property `qiskit.transpiler.target.Target.aquire_alignment` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. Use the property `acquire_alignment` instead.
+
+
+
+
+### instructions
+
+Get the list of tuples ``(:class:`~qiskit.circuit.Instruction`, (qargs))`` for the target
+
+For globally defined variable width operations the tuple will be of the form `(class, None)` where class is the actual operation class that is globally defined.
+
+
+
+### operation\_names
+
+Get the operation names in the target.
+
+
+
+### operations
+
+Get the operation class objects in the target.
+
+
+
+### physical\_qubits
+
+Returns a sorted list of physical\_qubits
+
+
+
+### qargs
+
+The set of qargs in the target.
+
+## Methods
+
+### add\_instruction
+
+
+
+`add_instruction(instruction, properties=None, name=None)`
+
+Add a new instruction to the [`Target`](#qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+As `Target` objects are strictly additive this is the primary method for modifying a `Target`. Typically, you will use this to fully populate a `Target` before using it in [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2"). For example:
+
+```python
+from qiskit.circuit.library import CXGate
+from qiskit.transpiler import Target, InstructionProperties
+
+target = Target()
+cx_properties = {
+ (0, 1): None,
+ (1, 0): None,
+ (0, 2): None,
+ (2, 0): None,
+ (0, 3): None,
+ (2, 3): None,
+ (3, 0): None,
+ (3, 2): None
+}
+target.add_instruction(CXGate(), cx_properties)
+```
+
+Will add a [`CXGate`](qiskit.circuit.library.CXGate "qiskit.circuit.library.CXGate") to the target with no properties (duration, error, etc) with the coupling edge list: `(0, 1), (1, 0), (0, 2), (2, 0), (0, 3), (2, 3), (3, 0), (3, 2)`. If there are properties available for the instruction you can replace the `None` value in the properties dictionary with an [`InstructionProperties`](qiskit.transpiler.InstructionProperties "qiskit.transpiler.InstructionProperties") object. This pattern is repeated for each [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") the target supports.
+
+**Parameters**
+
+* **instruction** ([*qiskit.circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction")) – The operation object to add to the map. If it’s parameterized any value of the parameter can be set. Optionally for variable width instructions (such as control flow operations such as `ForLoop` or `MCXGate`) you can specify the class. If the class is specified than the `name` argument must be specified. When a class is used the gate is treated as global and not having any properties set.
+* **properties** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – A dictionary of qarg entries to an [`InstructionProperties`](qiskit.transpiler.InstructionProperties "qiskit.transpiler.InstructionProperties") object for that instruction implementation on the backend. Properties are optional for any instruction implementation, if there are no [`InstructionProperties`](qiskit.transpiler.InstructionProperties "qiskit.transpiler.InstructionProperties") available for the backend the value can be None. If there are no constraints on the instruction (as in a noiseless/ideal simulation) this can be set to `{None, None}` which will indicate it runs on all qubits (or all available permutations of qubits for multi-qubit gates). The first `None` indicates it applies to all qubits and the second `None` indicates there are no [`InstructionProperties`](qiskit.transpiler.InstructionProperties "qiskit.transpiler.InstructionProperties") for the instruction. By default, if properties is not set it is equivalent to passing `{None: None}`.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – An optional name to use for identifying the instruction. If not specified the [`name`](qiskit.circuit.Instruction#name "qiskit.circuit.Instruction.name") attribute of `gate` will be used. All gates in the `Target` need unique names. Backends can differentiate between different parameterization of a single gate by providing a unique name for each (e.g. “rx30”, “rx60”, \`”rx90”\`\` similar to the example in the documentation for the [`Target`](#qiskit.transpiler.Target "qiskit.transpiler.Target") class).
+
+**Raises**
+
+* [**AttributeError**](https://docs.python.org/3/library/exceptions.html#AttributeError "(in Python v3.12)") – If gate is already in map
+* [**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – If an operation class is passed in for `instruction` and no name is specified or `properties` is set.
+
+### build\_coupling\_map
+
+
+
+`build_coupling_map(two_q_gate=None, filter_idle_qubits=False)`
+
+Get a [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") from this target.
+
+If there is a mix of two qubit operations that have a connectivity constraint and those that are globally defined this will also return `None` because the globally connectivity means there is no constraint on the target. If you wish to see the constraints of the two qubit operations that have constraints you should use the `two_q_gate` argument to limit the output to the gates which have a constraint.
+
+**Parameters**
+
+* **two\_q\_gate** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – An optional gate name for a two qubit gate in the `Target` to generate the coupling map for. If specified the output coupling map will only have edges between qubits where this gate is present.
+* **filter\_idle\_qubits** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If set to `True` the output [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") will remove any qubits that don’t have any operations defined in the target. Note that using this argument will result in an output [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object which has holes in its indices which might differ from the assumptions of the class. The typical use case of this argument is to be paired with [`CouplingMap.connected_components()`](qiskit.transpiler.CouplingMap#connected_components "qiskit.transpiler.CouplingMap.connected_components") which will handle the holes as expected.
+
+**Returns**
+
+**The [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object**
+
+for this target. If there are no connectivity constraints in the target this will return `None`.
+
+**Return type**
+
+[CouplingMap](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")
+
+**Raises**
+
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If a non-two qubit gate is passed in for `two_q_gate`.
+* [**IndexError**](https://docs.python.org/3/library/exceptions.html#IndexError "(in Python v3.12)") – If an Instruction not in the `Target` is passed in for `two_q_gate`.
+
+### durations
+
+
+
+`durations()`
+
+Get an InstructionDurations object from the target
+
+**Returns**
+
+**The instruction duration represented in the**
+
+target
+
+**Return type**
+
+[InstructionDurations](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations")
+
+### from\_configuration
+
+
+
+`classmethod from_configuration(basis_gates, num_qubits=None, coupling_map=None, inst_map=None, backend_properties=None, instruction_durations=None, concurrent_measurements=None, dt=None, timing_constraints=None, custom_name_mapping=None)`
+
+Create a target object from the individual global configuration
+
+Prior to the creation of the [`Target`](#qiskit.transpiler.Target "qiskit.transpiler.Target") class, the constraints of a backend were represented by a collection of different objects which combined represent a subset of the information contained in the [`Target`](#qiskit.transpiler.Target "qiskit.transpiler.Target"). This function provides a simple interface to convert those separate objects to a [`Target`](#qiskit.transpiler.Target "qiskit.transpiler.Target").
+
+This constructor will use the input from `basis_gates`, `num_qubits`, and `coupling_map` to build a base model of the backend and the `instruction_durations`, `backend_properties`, and `inst_map` inputs are then queried (in that order) based on that model to look up the properties of each instruction and qubit. If there is an inconsistency between the inputs any extra or conflicting information present in `instruction_durations`, `backend_properties`, or `inst_map` will be ignored.
+
+**Parameters**
+
+* **basis\_gates** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – The list of basis gate names for the backend. For the target to be created these names must either be in the output from `get_standard_gate_name_mapping()` or present in the specified `custom_name_mapping` argument.
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of qubits supported on the backend.
+* **coupling\_map** ([*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") *| None*) – The coupling map representing connectivity constraints on the backend. If specified all gates from `basis_gates` will be supported on all qubits (or pairs of qubits).
+* **inst\_map** ([*InstructionScheduleMap*](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") *| None*) – The instruction schedule map representing the pulse [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") definitions for each instruction. If this is specified `coupling_map` must be specified. The `coupling_map` is used as the source of truth for connectivity and if `inst_map` is used the schedule is looked up based on the instructions from the pair of `basis_gates` and `coupling_map`. If you want to define a custom gate for a particular qubit or qubit pair, you can manually build [`Target`](#qiskit.transpiler.Target "qiskit.transpiler.Target").
+* **backend\_properties** ([*BackendProperties*](qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties") *| None*) – The [`BackendProperties`](qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties") object which is used for instruction properties and qubit properties. If specified and instruction properties are intended to be used then the `coupling_map` argument must be specified. This is only used to lookup error rates and durations (unless `instruction_durations` is specified which would take precedence) for instructions specified via `coupling_map` and `basis_gates`.
+* **instruction\_durations** ([*InstructionDurations*](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") *| None*) – Optional instruction durations for instructions. If specified it will take priority for setting the `duration` field in the [`InstructionProperties`](qiskit.transpiler.InstructionProperties "qiskit.transpiler.InstructionProperties") objects for the instructions in the target.
+* **concurrent\_measurements** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of sets of qubits that must be measured together. This must be provided as a nested list like `[[0, 1], [2, 3, 4]]`.
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – The system time resolution of input signals in seconds
+* **timing\_constraints** (*TimingConstraints | None*) – Optional timing constraints to include in the [`Target`](#qiskit.transpiler.Target "qiskit.transpiler.Target")
+* **custom\_name\_mapping** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*, Any] | None*) – An optional dictionary that maps custom gate/operation names in `basis_gates` to an [`Operation`](qiskit.circuit.Operation "qiskit.circuit.Operation") object representing that gate/operation. By default, most standard gates names are mapped to the standard gate object from [`qiskit.circuit.library`](circuit_library#module-qiskit.circuit.library "qiskit.circuit.library") this only needs to be specified if the input `basis_gates` defines gates in names outside that set.
+
+**Returns**
+
+the target built from the input configuration
+
+**Return type**
+
+[Target](#qiskit.transpiler.Target "qiskit.transpiler.Target")
+
+**Raises**
+
+* [**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – If the input basis gates contain > 2 qubits and `coupling_map` is
+* **specified.** –
+* [**KeyError**](https://docs.python.org/3/library/exceptions.html#KeyError "(in Python v3.12)") – If no mapping is available for a specified `basis_gate`.
+
+### get
+
+
+
+`get(k[, d]) → D[k] if k in D, else d. d defaults to None.`
+
+### get\_calibration
+
+
+
+`get_calibration(operation_name, qargs, *args, **kwargs)`
+
+Get calibrated pulse schedule for the instruction.
+
+If calibration is templated with parameters, one can also provide those values to build a schedule with assigned parameters.
+
+**Parameters**
+
+* **operation\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the operation for the instruction.
+* **qargs** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*, ...]*) – The tuple of qubit indices for the instruction.
+* **args** (*ParameterValueType*) – Parameter values to build schedule if any.
+* **kwargs** (*ParameterValueType*) – Parameter values with name to build schedule if any.
+
+**Returns**
+
+Calibrated pulse schedule of corresponding instruction.
+
+**Return type**
+
+[Schedule](qiskit.pulse.Schedule "qiskit.pulse.Schedule") | [ScheduleBlock](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock")
+
+### get\_non\_global\_operation\_names
+
+
+
+`get_non_global_operation_names(strict_direction=False)`
+
+Return the non-global operation names for the target
+
+The non-global operations are those in the target which don’t apply on all qubits (for single qubit operations) or all multi-qubit qargs (for multi-qubit operations).
+
+**Parameters**
+
+**strict\_direction** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If set to `True` the multi-qubit operations considered as non-global respect the strict direction (or order of qubits in the qargs is significant). For example, if `cx` is defined on `(0, 1)` and `ecr` is defined over `(1, 0)` by default neither would be considered non-global, but if `strict_direction` is set `True` both `cx` and `ecr` would be returned.
+
+**Returns**
+
+A list of operation names for operations that aren’t global in this target
+
+**Return type**
+
+List\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")]
+
+### has\_calibration
+
+
+
+`has_calibration(operation_name, qargs)`
+
+Return whether the instruction (operation + qubits) defines a calibration.
+
+**Parameters**
+
+* **operation\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the operation for the instruction.
+* **qargs** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*, ...]*) – The tuple of qubit indices for the instruction.
+
+**Returns**
+
+Returns `True` if the calibration is supported and `False` if it isn’t.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### instruction\_properties
+
+
+
+`instruction_properties(index)`
+
+Get the instruction properties for a specific instruction tuple
+
+This method is to be used in conjunction with the [`instructions`](#qiskit.transpiler.Target.instructions "qiskit.transpiler.Target.instructions") attribute of a [`Target`](#qiskit.transpiler.Target "qiskit.transpiler.Target") object. You can use this method to quickly get the instruction properties for an element of [`instructions`](#qiskit.transpiler.Target.instructions "qiskit.transpiler.Target.instructions") by using the index in that list. However, if you’re not working with [`instructions`](#qiskit.transpiler.Target.instructions "qiskit.transpiler.Target.instructions") directly it is likely more efficient to access the target directly via the name and qubits to get the instruction properties. For example, if [`instructions`](#qiskit.transpiler.Target.instructions "qiskit.transpiler.Target.instructions") returned:
+
+```python
+[(XGate(), (0,)), (XGate(), (1,))]
+```
+
+you could get the properties of the `XGate` on qubit 1 with:
+
+```python
+props = target.instruction_properties(1)
+```
+
+but just accessing it directly via the name would be more efficient:
+
+```python
+props = target['x'][(1,)]
+```
+
+(assuming the `XGate`’s canonical name in the target is `'x'`) This is especially true for larger targets as this will scale worse with the number of instruction tuples in a target.
+
+**Parameters**
+
+**index** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The index of the instruction tuple from the [`instructions`](#qiskit.transpiler.Target.instructions "qiskit.transpiler.Target.instructions") attribute. For, example if you want the properties from the third element in [`instructions`](#qiskit.transpiler.Target.instructions "qiskit.transpiler.Target.instructions") you would set this to be `2`.
+
+**Returns**
+
+The instruction properties for the specified instruction tuple
+
+**Return type**
+
+[InstructionProperties](qiskit.transpiler.InstructionProperties "qiskit.transpiler.InstructionProperties")
+
+### instruction\_schedule\_map
+
+
+
+`instruction_schedule_map()`
+
+Return an [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions in the target with a pulse schedule defined.
+
+**Returns**
+
+The instruction schedule map for the instructions in this target with a pulse schedule defined.
+
+**Return type**
+
+[InstructionScheduleMap](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap")
+
+### instruction\_supported
+
+
+
+`instruction_supported(operation_name=None, qargs=None, operation_class=None, parameters=None)`
+
+Return whether the instruction (operation + qubits) is supported by the target
+
+**Parameters**
+
+* **operation\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the operation for the instruction. Either this or `operation_class` must be specified, if both are specified `operation_class` will take priority and this argument will be ignored.
+
+* **qargs** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – The tuple of qubit indices for the instruction. If this is not specified then this method will return `True` if the specified operation is supported on any qubits. The typical application will always have this set (otherwise it’s the same as just checking if the target contains the operation). Normally you would not set this argument if you wanted to check more generally that the target supports an operation with the `parameters` on any qubits.
+
+* **operation\_class** ([*Type*](circuit_classical#qiskit.circuit.classical.types.Type "qiskit.circuit.classical.types.Type")*\[*[*qiskit.circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction")*]*) – The operation class to check whether the target supports a particular operation by class rather than by name. This lookup is more expensive as it needs to iterate over all operations in the target instead of just a single lookup. If this is specified it will supersede the `operation_name` argument. The typical use case for this operation is to check whether a specific variant of an operation is supported on the backend. For example, if you wanted to check whether a [`RXGate`](qiskit.circuit.library.RXGate "qiskit.circuit.library.RXGate") was supported on a specific qubit with a fixed angle. That fixed angle variant will typically have a name different from the object’s [`name`](qiskit.circuit.Instruction#name "qiskit.circuit.Instruction.name") attribute (`"rx"`) in the target. This can be used to check if any instances of the class are available in such a case.
+
+* **parameters** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) –
+
+ A list of parameters to check if the target supports them on the specified qubits. If the instruction supports the parameter values specified in the list on the operation and qargs specified this will return `True` but if the parameters are not supported on the specified instruction it will return `False`. If this argument is not specified this method will return `True` if the instruction is supported independent of the instruction parameters. If specified with any [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") objects in the list, that entry will be treated as supporting any value, however parameter names will not be checked (for example if an operation in the target is listed as parameterized with `"theta"` and `"phi"` is passed into this function that will return `True`). For example, if called with:
+
+ ```python
+ parameters = [Parameter("theta")]
+ target.instruction_supported("rx", (0,), parameters=parameters)
+ ```
+
+ will return `True` if an [`RXGate`](qiskit.circuit.library.RXGate "qiskit.circuit.library.RXGate") is supported on qubit 0 that will accept any parameter. If you need to check for a fixed numeric value parameter this argument is typically paired with the `operation_class` argument. For example:
+
+ ```python
+ target.instruction_supported("rx", (0,), RXGate, parameters=[pi / 4])
+ ```
+
+ will return `True` if an RXGate(pi/4) exists on qubit 0.
+
+**Returns**
+
+Returns `True` if the instruction is supported and `False` if it isn’t.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### items
+
+
+
+`items() → a set-like object providing a view on D's items`
+
+### keys
+
+
+
+`keys() → a set-like object providing a view on D's keys`
+
+### operation\_from\_name
+
+
+
+`operation_from_name(instruction)`
+
+Get the operation class object for a given name
+
+**Parameters**
+
+**instruction** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The instruction name to get the [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instance for
+
+**Returns**
+
+The Instruction instance corresponding to the name. This also can also be the class for globally defined variable with operations.
+
+**Return type**
+
+[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
+
+### operation\_names\_for\_qargs
+
+
+
+`operation_names_for_qargs(qargs)`
+
+Get the operation names for a specified qargs tuple
+
+**Parameters**
+
+**qargs** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – A `qargs` tuple of the qubits to get the gates that apply to it. For example, `(0,)` will return the set of all instructions that apply to qubit 0. If set to `None` this will return the names for any globally defined operations in the target.
+
+**Returns**
+
+The set of operation names that apply to the specified `qargs`.
+
+**Return type**
+
+[set](https://docs.python.org/3/library/stdtypes.html#set "(in Python v3.12)")
+
+**Raises**
+
+[**KeyError**](https://docs.python.org/3/library/exceptions.html#KeyError "(in Python v3.12)") – If `qargs` is not in target
+
+### operations\_for\_qargs
+
+
+
+`operations_for_qargs(qargs)`
+
+Get the operation class object for a specified qargs tuple
+
+**Parameters**
+
+**qargs** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – A qargs tuple of the qubits to get the gates that apply to it. For example, `(0,)` will return the set of all instructions that apply to qubit 0. If set to `None` this will return any globally defined operations in the target.
+
+**Returns**
+
+The list of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") instances that apply to the specified qarg. This may also be a class if a variable width operation is globally defined.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**KeyError**](https://docs.python.org/3/library/exceptions.html#KeyError "(in Python v3.12)") – If qargs is not in target
+
+### qargs\_for\_operation\_name
+
+
+
+`qargs_for_operation_name(operation)`
+
+Get the qargs for a given operation name
+
+**Parameters**
+
+**operation** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The operation name to get qargs for
+
+**Returns**
+
+The set of qargs the gate instance applies to.
+
+**Return type**
+
+[set](https://docs.python.org/3/library/stdtypes.html#set "(in Python v3.12)")
+
+### timing\_constraints
+
+
+
+`timing_constraints()`
+
+Get an `TimingConstraints` object from the target
+
+**Returns**
+
+The timing constraints represented in the `Target`
+
+**Return type**
+
+TimingConstraints
+
+### update\_from\_instruction\_schedule\_map
+
+
+
+`update_from_instruction_schedule_map(inst_map, inst_name_map=None, error_dict=None)`
+
+Update the target from an instruction schedule map.
+
+If the input instruction schedule map contains new instructions not in the target they will be added. However, if it contains additional qargs for an existing instruction in the target it will error.
+
+**Parameters**
+
+* **inst\_map** ([*InstructionScheduleMap*](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap")) – The instruction
+
+* **inst\_name\_map** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – An optional dictionary that maps any instruction name in `inst_map` to an instruction object. If not provided, instruction is pulled from the standard Qiskit gates, and finally custom gate instance is created with schedule name.
+
+* **error\_dict** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) –
+
+ A dictionary of errors of the form:
+
+ ```python
+ {gate_name: {qarg: error}}
+ ```
+
+* **example::** (*for*) – \{‘rx’: \{(0, ): 1.4e-4, (1, ): 1.2e-4}}
+
+* **defined** (*For each entry in the inst\_map if error\_dict is*) –
+
+* **from** (*a when updating the Target the error value will be pulled*) –
+
+* **then** (*this dictionary. If one is not found in error\_dict*) –
+
+* **used.** (*None will be*) –
+
+### update\_instruction\_properties
+
+
+
+`update_instruction_properties(instruction, qargs, properties)`
+
+Update the property object for an instruction qarg pair already in the Target
+
+**Parameters**
+
+* **instruction** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The instruction name to update
+* **qargs** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – The qargs to update the properties of
+* **properties** ([*InstructionProperties*](qiskit.transpiler.InstructionProperties "qiskit.transpiler.InstructionProperties")) – The properties to set for this instruction
+
+**Raises**
+
+[**KeyError**](https://docs.python.org/3/library/exceptions.html#KeyError "(in Python v3.12)") – If `instruction` or `qarg` are not in the target
+
+### values
+
+
+
+`values() → an object providing a view on D's values`
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.TransformationPass.md b/docs/api/qiskit/0.46/qiskit.transpiler.TransformationPass.md
new file mode 100644
index 00000000000..82de6e3781b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.TransformationPass.md
@@ -0,0 +1,109 @@
+---
+title: TransformationPass
+description: API reference for qiskit.transpiler.TransformationPass
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.TransformationPass
+---
+
+# TransformationPass
+
+
+
+`qiskit.transpiler.TransformationPass(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/basepasses.py "view source code")
+
+Bases: `BasePass`
+
+A transformation pass: change DAG, not property set.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`abstract run(dag)`
+
+Run a pass on the DAGCircuit. This is implemented by the pass developer.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")) – the dag on which the pass is run.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – when this is left unimplemented for a pass.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.TranspileLayout.md b/docs/api/qiskit/0.46/qiskit.transpiler.TranspileLayout.md
new file mode 100644
index 00000000000..0415799654a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.TranspileLayout.md
@@ -0,0 +1,234 @@
+---
+title: TranspileLayout
+description: API reference for qiskit.transpiler.TranspileLayout
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.TranspileLayout
+---
+
+# TranspileLayout
+
+
+
+`qiskit.transpiler.TranspileLayout(initial_layout, input_qubit_mapping, final_layout=None, _input_qubit_count=None, _output_qubit_list=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/layout.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Layout attributes from output circuit from transpiler.
+
+The transpiler in general is unitary-perserving up to permutations caused by setting and applying initial layout during the [Layout Stage](transpiler#layout-stage) and [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate") insertion during the [Routing Stage](transpiler#routing-stage). To provide an interface to reason about these permutations caused by the [`transpiler`](transpiler#module-qiskit.transpiler "qiskit.transpiler"). In general the normal interface to access and reason about the layout transformations made by the transpiler is to use the helper methods defined on this class.
+
+For example, looking at the initial layout, the transpiler can potentially remap the order of the qubits in your circuit as it fits the circuit to the target backend. If the input circuit was:
+
+Then during the layout stage the transpiler reorders the qubits to be:
+
+then the output of the [`initial_virtual_layout()`](#qiskit.transpiler.TranspileLayout.initial_virtual_layout "qiskit.transpiler.TranspileLayout.initial_virtual_layout") would be equivalent to:
+
+```python
+Layout({
+ qr[0]: 2,
+ qr[1]: 1,
+ qr[2]: 0,
+})
+```
+
+(it is also this attribute in the [`QuantumCircuit.draw()`](qiskit.circuit.QuantumCircuit#draw "qiskit.circuit.QuantumCircuit.draw") and [`circuit_drawer()`](qiskit.visualization.circuit_drawer "qiskit.visualization.circuit_drawer") which is used to display the mapping of qubits to positions in circuit visualizations post-transpilation)
+
+Building on this above example for final layout, if the transpiler needed to insert swap gates during routing so the output circuit became:
+
+then the output of the [`routing_permutation()`](#qiskit.transpiler.TranspileLayout.routing_permutation "qiskit.transpiler.TranspileLayout.routing_permutation") method would be:
+
+```python
+[1, 0, 2]
+```
+
+which maps the qubits at each position to their final position after any swap insertions caused by routing.
+
+There are three public attributes associated with the class, however these are mostly provided for backwards compatibility and represent the internal state from the transpiler. They are defined as:
+
+> * [`initial_layout`](#qiskit.transpiler.TranspileLayout.initial_layout "qiskit.transpiler.TranspileLayout.initial_layout") - This attribute is used to model the permutation caused by the [Layout Stage](transpiler#layout-stage) it contains a [`Layout`](qiskit.transpiler.Layout "qiskit.transpiler.Layout") object that maps the input [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")s [`Qubit`](qiskit.circuit.Qubit "qiskit.circuit.Qubit") objects to the position in the output `QuantumCircuit.qubits` list.
+> * [`input_qubit_mapping`](#qiskit.transpiler.TranspileLayout.input_qubit_mapping "qiskit.transpiler.TranspileLayout.input_qubit_mapping") - This attribute is used to retain input ordering of the original [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") object. It maps the virtual [`Qubit`](qiskit.circuit.Qubit "qiskit.circuit.Qubit") object from the original circuit (and [`initial_layout`](#qiskit.transpiler.TranspileLayout.initial_layout "qiskit.transpiler.TranspileLayout.initial_layout")) to its corresponding position in [`QuantumCircuit.qubits`](qiskit.circuit.QuantumCircuit#qubits "qiskit.circuit.QuantumCircuit.qubits") in the original circuit. This is needed when computing the permutation of the `Operator` of the circuit (and used by [`Operator.from_circuit()`](qiskit.quantum_info.Operator#from_circuit "qiskit.quantum_info.Operator.from_circuit")).
+> * [`final_layout`](#qiskit.transpiler.TranspileLayout.final_layout "qiskit.transpiler.TranspileLayout.final_layout") - This is a [`Layout`](qiskit.transpiler.Layout "qiskit.transpiler.Layout") object used to model the output permutation caused ny any [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate")s inserted into the [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") during the [Routing Stage](transpiler#routing-stage). It maps the output circuit’s qubits from `QuantumCircuit.qubits` in the output circuit to the final position after routing. It is **not** a mapping from the original input circuit’s position to the final position at the end of the transpiled circuit. If you need this you can use the [`final_index_layout()`](#qiskit.transpiler.TranspileLayout.final_index_layout "qiskit.transpiler.TranspileLayout.final_index_layout") to generate this. If this is set to `None` this indicates that routing was not run and it can be considered equivalent to a trivial layout with the qubits from the output circuit’s [`qubits`](qiskit.circuit.QuantumCircuit#qubits "qiskit.circuit.QuantumCircuit.qubits") list.
+
+## Attributes
+
+
+
+### final\_layout
+
+`Layout | None`
+
+`= None`
+
+
+
+### initial\_layout
+
+`Layout`
+
+
+
+### input\_qubit\_mapping
+
+`dict[Qubit, int]`
+
+## Methods
+
+### final\_index\_layout
+
+
+
+`final_index_layout(filter_ancillas=True)`
+
+Generate the final layout as an array of integers
+
+This method will generate an array of final positions for each qubit in the output circuit. For example, if you had an input circuit like:
+
+```python
+qc = QuantumCircuit(3)
+qc.h(0)
+qc.cx(0, 1)
+qc.cx(0, 2)
+```
+
+and the output from the transpiler was:
+
+```python
+tqc = QuantumCircuit(3)
+qc.h(2)
+qc.cx(2, 1)
+qc.swap(0, 1)
+qc.cx(2, 1)
+```
+
+then the return from this function would be a list of:
+
+```python
+[2, 0, 1]
+```
+
+because qubit 0 in the original circuit’s final state is on qubit 3 in the output circuit, qubit 1 in the original circuit’s final state is on qubit 0, and qubit 2’s final state is on qubit. The output list length will be as wide as the input circuit’s number of qubits, as the output list from this method is for tracking the permutation of qubits in the original circuit caused by the transpiler.
+
+**Parameters**
+
+**filter\_ancillas** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If set to `False` any ancillas allocated in the output circuit will be included in the layout.
+
+**Returns**
+
+A list of final positions for each input circuit qubit
+
+**Return type**
+
+[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")]
+
+### final\_virtual\_layout
+
+
+
+`final_virtual_layout(filter_ancillas=True)`
+
+Generate the final layout as a [`Layout`](qiskit.transpiler.Layout "qiskit.transpiler.Layout") object
+
+This method will generate an array of final positions for each qubit in the output circuit. For example, if you had an input circuit like:
+
+```python
+qc = QuantumCircuit(3)
+qc.h(0)
+qc.cx(0, 1)
+qc.cx(0, 2)
+```
+
+and the output from the transpiler was:
+
+```python
+tqc = QuantumCircuit(3)
+qc.h(2)
+qc.cx(2, 1)
+qc.swap(0, 1)
+qc.cx(2, 1)
+```
+
+then the return from this function would be a layout object:
+
+```python
+Layout({
+ qc.qubits[0]: 2,
+ qc.qubits[1]: 0,
+ qc.qubits[2]: 1,
+})
+```
+
+because qubit 0 in the original circuit’s final state is on qubit 3 in the output circuit, qubit 1 in the original circuit’s final state is on qubit 0, and qubit 2’s final state is on qubit. The output list length will be as wide as the input circuit’s number of qubits, as the output list from this method is for tracking the permutation of qubits in the original circuit caused by the transpiler.
+
+**Parameters**
+
+**filter\_ancillas** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If set to `False` any ancillas allocated in the output circuit will be included in the layout.
+
+**Returns**
+
+A layout object mapping to the final positions for each qubit
+
+**Return type**
+
+[*Layout*](qiskit.transpiler.Layout "qiskit.transpiler.layout.Layout")
+
+### initial\_index\_layout
+
+
+
+`initial_index_layout(filter_ancillas=False)`
+
+Generate an initial layout as an array of integers
+
+**Parameters**
+
+**filter\_ancillas** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If set to `True` any ancilla qubits added to the transpiler will not be included in the output.
+
+**Returns**
+
+A layout array that maps a position in the array to its new position in the output circuit.
+
+**Return type**
+
+[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")]
+
+### initial\_virtual\_layout
+
+
+
+`initial_virtual_layout(filter_ancillas=False)`
+
+Return a [`Layout`](qiskit.transpiler.Layout "qiskit.transpiler.Layout") object for the initial layout.
+
+This returns a mapping of virtual [`Qubit`](qiskit.circuit.Qubit "qiskit.circuit.Qubit") objects in the input circuit to the physical qubit selected during layout. This is analogous to the [`initial_layout`](#qiskit.transpiler.TranspileLayout.initial_layout "qiskit.transpiler.TranspileLayout.initial_layout") attribute.
+
+**Parameters**
+
+**filter\_ancillas** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If set to `True` only qubits in the input circuit will be in the returned layout. Any ancilla qubits added to the output circuit will be filtered from the returned object.
+
+**Returns**
+
+A layout object mapping the input circuit’s [`Qubit`](qiskit.circuit.Qubit "qiskit.circuit.Qubit") objects to the selected physical qubits.
+
+**Return type**
+
+[*Layout*](qiskit.transpiler.Layout "qiskit.transpiler.layout.Layout")
+
+### routing\_permutation
+
+
+
+`routing_permutation()`
+
+Generate a final layout as an array of integers
+
+If there is no [`final_layout`](#qiskit.transpiler.TranspileLayout.final_layout "qiskit.transpiler.TranspileLayout.final_layout") attribute present then that indicates there was no output permutation caused by routing or other transpiler transforms. In this case the function will return a list of `[0, 1, 2, .., n]` to indicate this
+
+**Returns**
+
+A layout array that maps a position in the array to its new position in the output circuit
+
+**Return type**
+
+[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")]
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.ALAPSchedule.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.ALAPSchedule.md
new file mode 100644
index 00000000000..dea752a400c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.ALAPSchedule.md
@@ -0,0 +1,130 @@
+---
+title: ALAPSchedule
+description: API reference for qiskit.transpiler.passes.ALAPSchedule
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.ALAPSchedule
+---
+
+# ALAPSchedule
+
+
+
+`qiskit.transpiler.passes.ALAPSchedule(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/scheduling/alap.py "view source code")
+
+Bases: `BaseSchedulerTransform`
+
+ALAP Scheduling pass, which schedules the **stop** time of instructions as late as possible.
+
+See `BaseSchedulerTransform` for the detailed behavior of the control flow operation, i.e. `c_if`.
+
+
+ The class `qiskit.transpiler.passes.scheduling.alap.ALAPSchedule` is pending deprecation as of qiskit 0.21.0. It will be marked deprecated in a future release, and then removed no earlier than 3 months after the release date. Instead, use [`ALAPScheduleAnalysis`](qiskit.transpiler.passes.ALAPScheduleAnalysis "qiskit.transpiler.passes.ALAPScheduleAnalysis"), which is an analysis pass that requires a padding pass to later modify the circuit.
+
+
+## Attributes
+
+
+
+### CONDITIONAL\_SUPPORTED
+
+`= (, )`
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the ALAPSchedule pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – DAG to schedule.
+
+**Returns**
+
+A scheduled DAG.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+* [**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if the circuit is not mapped on physical qubits.
+* [**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if conditional bit is added to non-supported instruction.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.ALAPScheduleAnalysis.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.ALAPScheduleAnalysis.md
new file mode 100644
index 00000000000..d743b2093d3
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.ALAPScheduleAnalysis.md
@@ -0,0 +1,133 @@
+---
+title: ALAPScheduleAnalysis
+description: API reference for qiskit.transpiler.passes.ALAPScheduleAnalysis
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.ALAPScheduleAnalysis
+---
+
+# ALAPScheduleAnalysis
+
+
+
+`qiskit.transpiler.passes.ALAPScheduleAnalysis(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/scheduling/scheduling/alap.py "view source code")
+
+Bases: `BaseScheduler`
+
+ALAP Scheduling pass, which schedules the **stop** time of instructions as late as possible.
+
+See the [Scheduling Stage](transpiler#scheduling-stage) section in the [`qiskit.transpiler`](transpiler#module-qiskit.transpiler "qiskit.transpiler") module documentation for the detailed behavior of the control flow operation, i.e. `c_if`.
+
+Scheduler initializer.
+
+**Parameters**
+
+* **durations** – Durations of instructions to be used in scheduling
+* **target** – The [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") representing the target backend, if both `durations` and this are specified then this argument will take precedence and `durations` will be ignored.
+
+## Attributes
+
+
+
+### CONDITIONAL\_SUPPORTED
+
+`= (, )`
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the ALAPSchedule pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – DAG to schedule.
+
+**Returns**
+
+A scheduled DAG.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+* [**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if the circuit is not mapped on physical qubits.
+* [**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if conditional bit is added to non-supported instruction.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.AQCSynthesisPlugin.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.AQCSynthesisPlugin.md
new file mode 100644
index 00000000000..f3e4b6e696a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.AQCSynthesisPlugin.md
@@ -0,0 +1,181 @@
+---
+title: AQCSynthesisPlugin
+description: API reference for qiskit.transpiler.passes.AQCSynthesisPlugin
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.AQCSynthesisPlugin
+---
+
+# AQCSynthesisPlugin
+
+
+
+`qiskit.transpiler.passes.AQCSynthesisPlugin`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/synthesis/aqc_plugin.py "view source code")
+
+Bases: [`UnitarySynthesisPlugin`](qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin "qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin")
+
+An AQC-based Qiskit unitary synthesis plugin.
+
+This plugin is invoked by [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") when the `unitary_synthesis_method` parameter is set to `"aqc"`.
+
+This plugin supports customization and additional parameters can be passed to the plugin by passing a dictionary as the `unitary_synthesis_plugin_config` parameter of the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function.
+
+Supported parameters in the dictionary:
+
+**network\_layout (str)**
+
+Type of network geometry, one of \{`"sequ"`, `"spin"`, `"cart"`, `"cyclic_spin"`, `"cyclic_line"`}. Default value is `"spin"`.
+
+**connectivity\_type (str)**
+
+type of inter-qubit connectivity, \{`"full"`, `"line"`, `"star"`}. Default value is `"full"`.
+
+**depth (int)**
+
+depth of the CNOT-network, i.e. the number of layers, where each layer consists of a single CNOT-block.
+
+**optimizer ([`Optimizer`](qiskit.algorithms.optimizers.Optimizer "qiskit.algorithms.optimizers.Optimizer"))**
+
+An instance of optimizer to be used in the optimization process.
+
+**seed (int)**
+
+A random seed.
+
+**initial\_point ([`ndarray`](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)"))**
+
+Initial values of angles/parameters to start the optimization process from.
+
+## Attributes
+
+
+
+### max\_qubits
+
+Maximum number of supported qubits is `14`.
+
+
+
+### min\_qubits
+
+Minimum number of supported qubits is `3`.
+
+
+
+### supported\_bases
+
+The plugin does not support bases for synthesis.
+
+
+
+### supports\_basis\_gates
+
+The plugin does not support basis gates and by default it synthesizes a circuit using `["rx", "ry", "rz", "cx"]` gate basis.
+
+
+
+### supports\_coupling\_map
+
+The plugin does not support coupling maps.
+
+
+
+### supports\_gate\_errors
+
+The plugin does not support gate errors.
+
+
+
+### supports\_gate\_errors\_by\_qubit
+
+Return whether the plugin supports taking `gate_errors_by_qubit`
+
+This differs from `supports_gate_errors`/`gate_errors` by using a different view of the same data. Instead of being keyed by gate name this is keyed by qubit and uses [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate") instances to represent gates (instead of gate names).
+
+`gate_errors_by_qubit` will be a dictionary in the form of `{(qubits,): [Gate, error]}`. For example:
+
+```python
+{
+(0,): [SXGate(): 0.0006149355812506126, RZGate(): 0.0],
+(0, 1): [CXGate(): 0.012012477900732316]
+}
+```
+
+Do note that this dictionary might not be complete or could be empty as it depends on the target backend reporting gate errors on every gate for each qubit. The gate error rates reported in `gate_errors` are provided by the target device `Backend` object and the exact meaning might be different depending on the backend.
+
+This defaults to False
+
+
+
+### supports\_gate\_lengths
+
+The plugin does not support gate lengths.
+
+
+
+### supports\_gate\_lengths\_by\_qubit
+
+Return whether the plugin supports taking `gate_lengths_by_qubit`
+
+This differs from `supports_gate_lengths`/`gate_lengths` by using a different view of the same data. Instead of being keyed by gate name this is keyed by qubit and uses [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate") instances to represent gates (instead of gate names)
+
+`gate_lengths_by_qubit` will be a dictionary in the form of `{(qubits,): [Gate, length]}`. For example:
+
+```python
+{
+(0,): [SXGate(): 0.0006149355812506126, RZGate(): 0.0],
+(0, 1): [CXGate(): 0.012012477900732316]
+}
+```
+
+where the `length` value is in units of seconds.
+
+Do note that this dictionary might not be complete or could be empty as it depends on the target backend reporting gate lengths on every gate for each qubit.
+
+This defaults to False
+
+
+
+### supports\_natural\_direction
+
+The plugin does not support natural direction, it assumes bidirectional two qubit gates.
+
+
+
+### supports\_pulse\_optimize
+
+The plugin does not support optimization of pulses.
+
+
+
+### supports\_target
+
+Whether the plugin supports taking `target` as an option
+
+`target` will be a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object representing the target device for the output of the synthesis pass.
+
+By default this will be `False` since the plugin interface predates the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") class. If a plugin returns `True` for this attribute, it is expected that the plugin will use the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") instead of the values passed if any of `supports_gate_lengths`, `supports_gate_errors`, `supports_coupling_map`, and `supports_basis_gates` are set (although ideally all those parameters should contain duplicate information).
+
+## Methods
+
+### run
+
+
+
+`run(unitary, **options)`
+
+Run synthesis for the given unitary matrix
+
+**Parameters**
+
+* **unitary** ([*numpy.ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – The unitary matrix to synthesize to a [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") object
+* **options** – The optional kwargs that are passed based on the output the `support_*` methods on the class. Refer to the documentation for these methods on [`UnitarySynthesisPlugin`](qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin "qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin") to see what the keys and values are.
+
+**Returns**
+
+The dag circuit representation of the unitary. Alternatively, you can return a tuple of the form `(dag, wires)` where `dag` is the dag circuit representation of the circuit representation of the unitary and `wires` is the mapping wires to use for [`qiskit.dagcircuit.DAGCircuit.substitute_node_with_dag()`](qiskit.dagcircuit.DAGCircuit#substitute_node_with_dag "qiskit.dagcircuit.DAGCircuit.substitute_node_with_dag"). If you return a tuple and `wires` is `None` this will behave just as if only a [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") was returned. Additionally if this returns `None` no substitution will be made.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.ASAPSchedule.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.ASAPSchedule.md
new file mode 100644
index 00000000000..803befb9bba
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.ASAPSchedule.md
@@ -0,0 +1,134 @@
+---
+title: ASAPSchedule
+description: API reference for qiskit.transpiler.passes.ASAPSchedule
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.ASAPSchedule
+---
+
+# ASAPSchedule
+
+
+
+`qiskit.transpiler.passes.ASAPSchedule(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/scheduling/asap.py "view source code")
+
+Bases: `BaseSchedulerTransform`
+
+ASAP Scheduling pass, which schedules the start time of instructions as early as possible..
+
+See `BaseSchedulerTransform` for the detailed behavior of the control flow operation, i.e. `c_if`.
+
+
+ This base class has been superseded by [`ASAPScheduleAnalysis`](qiskit.transpiler.passes.ASAPScheduleAnalysis "qiskit.transpiler.passes.ASAPScheduleAnalysis") and the new scheduling workflow. It will be deprecated and subsequently removed in a future release.
+
+
+
+ The class `qiskit.transpiler.passes.scheduling.asap.ASAPSchedule` is pending deprecation as of qiskit 0.21.0. It will be marked deprecated in a future release, and then removed no earlier than 3 months after the release date. Instead, use [`ASAPScheduleAnalysis`](qiskit.transpiler.passes.ASAPScheduleAnalysis "qiskit.transpiler.passes.ASAPScheduleAnalysis"), which is an analysis pass that requires a padding pass to later modify the circuit.
+
+
+## Attributes
+
+
+
+### CONDITIONAL\_SUPPORTED
+
+`= (, )`
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the ASAPSchedule pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – DAG to schedule.
+
+**Returns**
+
+A scheduled DAG.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+* [**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if the circuit is not mapped on physical qubits.
+* [**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if conditional bit is added to non-supported instruction.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.ASAPScheduleAnalysis.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.ASAPScheduleAnalysis.md
new file mode 100644
index 00000000000..e18b8a604d8
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.ASAPScheduleAnalysis.md
@@ -0,0 +1,133 @@
+---
+title: ASAPScheduleAnalysis
+description: API reference for qiskit.transpiler.passes.ASAPScheduleAnalysis
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.ASAPScheduleAnalysis
+---
+
+# ASAPScheduleAnalysis
+
+
+
+`qiskit.transpiler.passes.ASAPScheduleAnalysis(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/scheduling/scheduling/asap.py "view source code")
+
+Bases: `BaseScheduler`
+
+ASAP Scheduling pass, which schedules the start time of instructions as early as possible.
+
+See the [Scheduling Stage](transpiler#scheduling-stage) section in the [`qiskit.transpiler`](transpiler#module-qiskit.transpiler "qiskit.transpiler") module documentation for the detailed behavior of the control flow operation, i.e. `c_if`.
+
+Scheduler initializer.
+
+**Parameters**
+
+* **durations** – Durations of instructions to be used in scheduling
+* **target** – The [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") representing the target backend, if both `durations` and this are specified then this argument will take precedence and `durations` will be ignored.
+
+## Attributes
+
+
+
+### CONDITIONAL\_SUPPORTED
+
+`= (, )`
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the ASAPSchedule pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – DAG to schedule.
+
+**Returns**
+
+A scheduled DAG.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+* [**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if the circuit is not mapped on physical qubits.
+* [**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if conditional bit is added to non-supported instruction.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.AlignMeasures.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.AlignMeasures.md
new file mode 100644
index 00000000000..3087553a531
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.AlignMeasures.md
@@ -0,0 +1,165 @@
+---
+title: AlignMeasures
+description: API reference for qiskit.transpiler.passes.AlignMeasures
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.AlignMeasures
+---
+
+# AlignMeasures
+
+
+
+`qiskit.transpiler.passes.AlignMeasures(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/scheduling/alignments/align_measures.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Measurement alignment.
+
+This is a control electronics aware optimization pass.
+
+In many quantum computing architectures gates (instructions) are implemented with shaped analog stimulus signals. These signals are digitally stored in the waveform memory of the control electronics and converted into analog voltage signals by electronic components called digital to analog converters (DAC).
+
+In a typical hardware implementation of superconducting quantum processors, a single qubit instruction is implemented by a microwave signal with the duration of around several tens of ns with a per-sample time resolution of \~0.1-10ns, as reported by `backend.configuration().dt`. In such systems requiring higher DAC bandwidth, control electronics often defines a pulse granularity, in other words a data chunk, to allow the DAC to perform the signal conversion in parallel to gain the bandwidth.
+
+Measurement alignment is required if a backend only allows triggering `measure` instructions at a certain multiple value of this pulse granularity. This value is usually provided by `backend.configuration().timing_constraints`.
+
+In Qiskit SDK, the duration of delay can take arbitrary value in units of `dt`, thus circuits involving delays may violate the above alignment constraint (i.e. misalignment). This pass shifts measurement instructions to a new time position to fix the misalignment, by inserting extra delay right before the measure instructions. The input of this pass should be scheduled [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit"), thus one should select one of the scheduling passes ([`ALAPSchedule`](qiskit.transpiler.passes.ALAPSchedule "qiskit.transpiler.passes.ALAPSchedule") or `ASAPSchedule`) before calling this.
+
+**Examples**
+
+We assume executing the following circuit on a backend with `alignment=16`.
+
+```python
+ ┌───┐┌────────────────┐┌─┐
+q_0: ┤ X ├┤ Delay(100[dt]) ├┤M├
+ └───┘└────────────────┘└╥┘
+c: 1/════════════════════════╩═
+ 0
+```
+
+Note that delay of 100 dt induces a misalignment of 4 dt at the measurement. This pass appends an extra 12 dt time shift to the input circuit.
+
+```python
+ ┌───┐┌────────────────┐┌─┐
+q_0: ┤ X ├┤ Delay(112[dt]) ├┤M├
+ └───┘└────────────────┘└╥┘
+c: 1/════════════════════════╩═
+ 0
+```
+
+This pass always inserts a positive delay before measurements rather than reducing other delays.
+
+**Notes**
+
+The Backend may allow users to execute circuits violating the alignment constraint. However, it may return meaningless measurement data mainly due to the phase error.
+
+Create new pass.
+
+
+ The class `qiskit.transpiler.passes.scheduling.alignments.align_measures.AlignMeasures` is pending deprecation as of qiskit 0.21.0. It will be marked deprecated in a future release, and then removed no earlier than 3 months after the release date. Instead, use [`ConstrainedReschedule`](qiskit.transpiler.passes.ConstrainedReschedule "qiskit.transpiler.passes.ConstrainedReschedule"), which performs the same function but also supports aligning to additional timing constraints.
+
+
+**Parameters**
+
+**alignment** – Integer number representing the minimum time resolution to trigger measure instruction in units of `dt`. This value depends on the control electronics of your quantum processor.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the measurement alignment pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – DAG to be checked.
+
+**Returns**
+
+DAG with consistent timing and op nodes annotated with duration.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – If circuit is not scheduled.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.ApplyLayout.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.ApplyLayout.md
new file mode 100644
index 00000000000..2b9c0b75e3e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.ApplyLayout.md
@@ -0,0 +1,121 @@
+---
+title: ApplyLayout
+description: API reference for qiskit.transpiler.passes.ApplyLayout
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.ApplyLayout
+---
+
+# ApplyLayout
+
+
+
+`qiskit.transpiler.passes.ApplyLayout(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/layout/apply_layout.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Transform a circuit with virtual qubits into a circuit with physical qubits.
+
+Transforms a DAGCircuit with virtual qubits into a DAGCircuit with physical qubits by applying the Layout given in property\_set. Requires either of passes to set/select Layout, e.g. SetLayout, TrivialLayout. Assumes the Layout has full physical qubits.
+
+If a post layout pass is run and sets the `post_layout` property set field with a new layout to use after `ApplyLayout` has already run once this pass will compact the layouts so that we apply `original_virtual` -> `existing_layout` -> `new_layout` -> `new_physical` so that the output circuit and layout combination become: `original_virtual` -> `new_physical`
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the ApplyLayout pass on `dag`.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – DAG to map.
+
+**Returns**
+
+A mapped DAG (with physical qubits).
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if no layout is found in `property_set` or no full physical qubits.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.BarrierBeforeFinalMeasurements.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.BarrierBeforeFinalMeasurements.md
new file mode 100644
index 00000000000..c9f0f84a8f6
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.BarrierBeforeFinalMeasurements.md
@@ -0,0 +1,103 @@
+---
+title: BarrierBeforeFinalMeasurements
+description: API reference for qiskit.transpiler.passes.BarrierBeforeFinalMeasurements
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.BarrierBeforeFinalMeasurements
+---
+
+# BarrierBeforeFinalMeasurements
+
+
+
+`qiskit.transpiler.passes.BarrierBeforeFinalMeasurements(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/utils/barrier_before_final_measurements.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Add a barrier before final measurements.
+
+This pass adds a barrier before the set of final measurements. Measurements are considered final if they are followed by no other operations (aside from other measurements or barriers.)
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the BarrierBeforeFinalMeasurements pass on dag.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.BasicSwap.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.BasicSwap.md
new file mode 100644
index 00000000000..52229033d68
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.BasicSwap.md
@@ -0,0 +1,127 @@
+---
+title: BasicSwap
+description: API reference for qiskit.transpiler.passes.BasicSwap
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.BasicSwap
+---
+
+# BasicSwap
+
+
+
+`qiskit.transpiler.passes.BasicSwap(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/routing/basic_swap.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Map (with minimum effort) a DAGCircuit onto a `coupling_map` adding swap gates.
+
+The basic mapper is a minimum effort to insert swap gates to map the DAG onto a coupling map. When a cx is not in the coupling map possibilities, it inserts one or more swaps in front to make it compatible.
+
+BasicSwap initializer.
+
+**Parameters**
+
+* **coupling\_map** (*Union\[*[*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")*,* [*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")*]*) – Directed graph represented a coupling map.
+* **fake\_run** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if true, it will only pretend to do routing, i.e., no swap is effectively added.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the BasicSwap pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – DAG to map.
+
+**Returns**
+
+A mapped DAG.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+* [**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if the coupling map or the layout are not
+* **compatible with the DAG**\*\*, or \*\***if the coupling\_map=None.** –
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.BasisTranslator.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.BasisTranslator.md
new file mode 100644
index 00000000000..6177675f1f6
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.BasisTranslator.md
@@ -0,0 +1,172 @@
+---
+title: BasisTranslator
+description: API reference for qiskit.transpiler.passes.BasisTranslator
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.BasisTranslator
+---
+
+# BasisTranslator
+
+
+
+`qiskit.transpiler.passes.BasisTranslator(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/basis/basis_translator.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Translates gates to a target basis by searching for a set of translations from a given EquivalenceLibrary.
+
+This pass operates in several steps:
+
+* Determine the source basis from the input circuit.
+* Perform a Dijkstra search over basis sets, starting from the device’s target\_basis new gates are being generated using the rules from the provided EquivalenceLibrary and the search stops if all gates in the source basis have been generated.
+* The found path, as a set of rules from the EquivalenceLibrary, is composed into a set of gate replacement rules.
+* The composed replacement rules are applied in-place to each op node which is not already in the target\_basis.
+
+If the target keyword argument is specified and that [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") objects contains operations which are non-global (i.e. they are defined only for a subset of qubits), as calculated by [`get_non_global_operation_names()`](qiskit.transpiler.Target#get_non_global_operation_names "qiskit.transpiler.Target.get_non_global_operation_names"), this pass will attempt to match the output translation to those constraints. For 1 qubit operations this is straightforward, the pass will perform a search using the union of the set of global operations with the set of operations defined solely on that qubit. For multi-qubit gates this is a bit more involved, while the behavior is initially similar to the single qubit case, just using all the qubits the operation is run on (where order is not significant) isn’t sufficient. We also need to consider any potential local qubits defined on subsets of the quantum arguments for the multi-qubit operation. This means the target used for the search of a non-global multi-qubit gate is the union of global operations, non-global multi-qubit gates sharing the same qubits, and any non-global gates defined on any subset of the qubits used.
+
+
+ In the case of non-global operations it is possible for a single execution of this pass to output an incomplete translation if any non-global gates are defined on qubits that are a subset of a larger multi-qubit gate. For example, if you have a `u` gate only defined on qubit 0 and an `x` gate only on qubit 1 it is possible when translating a 2 qubit operation on qubit 0 and 1 that the output might have `u` on qubit 1 and `x` on qubit 0. Typically running this pass a second time will correct these issues.
+
+
+
+
+## Translation Errors
+
+This pass will error if there is no path to translate an input gate to the specified basis. However, during a typical/default preset passmanager this pass gets run multiple times at different stages of the compilation pipeline. This means that potentially the input gates that are getting translated were not in the input circuit to [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") as they were generated by an intermediate transform in the circuit.
+
+When this error occurs it typically means that either the target basis is not universal or there are additional equivalence rules needed in the :clas:\~.EquivalenceLibrary\` instance being used by the :class:\~.BasisTranslator\` pass. You can refer to [Custom Basis Gates](providers#custom-basis-gates) for details on adding custom equivalence rules.
+
+Initialize a BasisTranslator instance.
+
+**param equivalence\_library**
+
+The equivalence library which will be used by the BasisTranslator pass. (Instructions in this library will not be unrolled by this pass.)
+
+**type equivalence\_library**
+
+EquivalenceLibrary
+
+**param target\_basis**
+
+Target basis names to unroll to, e.g. \[‘u3’, ‘cx’].
+
+**type target\_basis**
+
+list\[str]
+
+**param target**
+
+The backend compilation target
+
+**type target**
+
+Target
+
+**param min\_qubits**
+
+The minimum number of qubits for operations in the input dag to translate.
+
+**type min\_qubits**
+
+int
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Translate an input DAGCircuit to the target basis.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – input dag
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if the target basis cannot be reached
+
+**Returns**
+
+translated circuit.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.CSPLayout.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CSPLayout.md
new file mode 100644
index 00000000000..1d90d862ef5
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CSPLayout.md
@@ -0,0 +1,118 @@
+---
+title: CSPLayout
+description: API reference for qiskit.transpiler.passes.CSPLayout
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.CSPLayout
+---
+
+# CSPLayout
+
+
+
+`qiskit.transpiler.passes.CSPLayout(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/layout/csp_layout.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+If possible, chooses a Layout as a CSP, using backtracking.
+
+If possible, chooses a Layout as a CSP, using backtracking.
+
+If not possible, does not set the layout property. In all the cases, the property CSPLayout\_stop\_reason will be added with one of the following values:
+
+* solution found: If a perfect layout was found.
+* nonexistent solution: If no perfect layout was found and every combination was checked.
+* call limit reached: If no perfect layout was found and the call limit was reached.
+* time limit reached: If no perfect layout was found and the time limit was reached.
+
+**Parameters**
+
+* **coupling\_map** (*Union\[*[*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")*,* [*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")*]*) – Directed graph representing a coupling map.
+* **strict\_direction** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, considers the direction of the coupling map. Default is False.
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Sets the seed of the PRNG.
+* **call\_limit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Amount of times that `constraint.RecursiveBacktrackingSolver.recursiveBacktracking` will be called. None means no call limit. Default: 1000.
+* **time\_limit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Amount of seconds that the pass will try to find a solution. None means no time limit. Default: 10 seconds.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+run the layout method
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.CXCancellation.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CXCancellation.md
new file mode 100644
index 00000000000..4e20f47fe1e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CXCancellation.md
@@ -0,0 +1,113 @@
+---
+title: CXCancellation
+description: API reference for qiskit.transpiler.passes.CXCancellation
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.CXCancellation
+---
+
+# CXCancellation
+
+
+
+`qiskit.transpiler.passes.CXCancellation(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/optimization/cx_cancellation.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Cancel back-to-back `cx` gates in dag.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the CXCancellation pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – the directed acyclic graph to run on.
+
+**Returns**
+
+Transformed DAG.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.CheckGateDirection.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CheckGateDirection.md
new file mode 100644
index 00000000000..725054bb616
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CheckGateDirection.md
@@ -0,0 +1,114 @@
+---
+title: CheckGateDirection
+description: API reference for qiskit.transpiler.passes.CheckGateDirection
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.CheckGateDirection
+---
+
+# CheckGateDirection
+
+
+
+`qiskit.transpiler.passes.CheckGateDirection(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/utils/check_gate_direction.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Check if the two-qubit gates follow the right direction with respect to the coupling map.
+
+CheckGateDirection initializer.
+
+**Parameters**
+
+* **coupling\_map** ([*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")) – Directed graph representing a coupling map.
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – The backend target to use for this pass. If this is specified it will be used instead of the coupling map
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the CheckGateDirection pass on dag.
+
+If dag is mapped and the direction is correct the property is\_direction\_mapped is set to True (or to False otherwise).
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – DAG to check.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.CheckMap.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CheckMap.md
new file mode 100644
index 00000000000..a119b90de02
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CheckMap.md
@@ -0,0 +1,116 @@
+---
+title: CheckMap
+description: API reference for qiskit.transpiler.passes.CheckMap
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.CheckMap
+---
+
+# CheckMap
+
+
+
+`qiskit.transpiler.passes.CheckMap(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/utils/check_map.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Check if a DAG circuit is already mapped to a coupling map.
+
+Check if a DAGCircuit is mapped to `coupling_map` by checking that all 2-qubit interactions are laid out to be on adjacent qubits in the global coupling map of the device, setting the property set field (either specified with `property_set_field` or the default `is_swap_mapped`) to `True` or `False` accordingly. Note this does not validate directionality of the connectivity between qubits. If you need to check gates are implemented in a native direction for a target use the [`CheckGateDirection`](qiskit.transpiler.passes.CheckGateDirection "qiskit.transpiler.passes.CheckGateDirection") pass instead.
+
+CheckMap initializer.
+
+**Parameters**
+
+* **coupling\_map** (*Union\[*[*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")*,* [*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")*]*) – Directed graph representing a coupling map.
+* **property\_set\_field** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – An optional string to specify the property set field to store the result of the check. If not default the result is stored in `"is_swap_mapped"`.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the CheckMap pass on dag.
+
+If dag is mapped to coupling\_map, the property is\_swap\_mapped is set to True (or to False otherwise).
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – DAG to map.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.Collect1qRuns.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Collect1qRuns.md
new file mode 100644
index 00000000000..6d0e5dda78b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Collect1qRuns.md
@@ -0,0 +1,105 @@
+---
+title: Collect1qRuns
+description: API reference for qiskit.transpiler.passes.Collect1qRuns
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.Collect1qRuns
+---
+
+# Collect1qRuns
+
+
+
+`qiskit.transpiler.passes.Collect1qRuns(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/optimization/collect_1q_runs.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Collect one-qubit subcircuits.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the Collect1qBlocks pass on dag.
+
+The blocks contain “op” nodes in topological order such that all gates in a block act on the same qubits and are adjacent in the circuit.
+
+After the execution, `property_set['run_list']` is set to a list of tuples of “op” node.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.Collect2qBlocks.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Collect2qBlocks.md
new file mode 100644
index 00000000000..8f4f6f698b9
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Collect2qBlocks.md
@@ -0,0 +1,105 @@
+---
+title: Collect2qBlocks
+description: API reference for qiskit.transpiler.passes.Collect2qBlocks
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.Collect2qBlocks
+---
+
+# Collect2qBlocks
+
+
+
+`qiskit.transpiler.passes.Collect2qBlocks(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/optimization/collect_2q_blocks.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Collect two-qubit subcircuits.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the Collect2qBlocks pass on dag.
+
+The blocks contain “op” nodes in topological order such that all gates in a block act on the same qubits and are adjacent in the circuit.
+
+After the execution, `property_set['block_list']` is set to a list of tuples of “op” node.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.CollectCliffords.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CollectCliffords.md
new file mode 100644
index 00000000000..776560a4f0e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CollectCliffords.md
@@ -0,0 +1,119 @@
+---
+title: CollectCliffords
+description: API reference for qiskit.transpiler.passes.CollectCliffords
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.CollectCliffords
+---
+
+# CollectCliffords
+
+
+
+`qiskit.transpiler.passes.CollectCliffords(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/optimization/collect_cliffords.py "view source code")
+
+Bases: `CollectAndCollapse`
+
+Collects blocks of Clifford gates and replaces them by a [`Clifford`](qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford") object.
+
+CollectCliffords initializer.
+
+**Parameters**
+
+* **do\_commutative\_analysis** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if True, exploits commutativity relations between nodes.
+* **split\_blocks** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if True, splits collected blocks into sub-blocks over disjoint qubit subsets.
+* **min\_block\_size** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – specifies the minimum number of gates in the block for the block to be collected.
+* **split\_layers** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if True, splits collected blocks into sub-blocks over disjoint qubit subsets.
+* **collect\_from\_back** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – specifies if blocks should be collected started from the end of the circuit.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the CollectLinearFunctions pass on dag. :param dag: the DAG to be optimized. :type dag: DAGCircuit
+
+**Returns**
+
+the optimized DAG.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.CollectLinearFunctions.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CollectLinearFunctions.md
new file mode 100644
index 00000000000..e1cd3282961
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CollectLinearFunctions.md
@@ -0,0 +1,119 @@
+---
+title: CollectLinearFunctions
+description: API reference for qiskit.transpiler.passes.CollectLinearFunctions
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.CollectLinearFunctions
+---
+
+# CollectLinearFunctions
+
+
+
+`qiskit.transpiler.passes.CollectLinearFunctions(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/optimization/collect_linear_functions.py "view source code")
+
+Bases: `CollectAndCollapse`
+
+Collect blocks of linear gates ([`CXGate`](qiskit.circuit.library.CXGate "qiskit.circuit.library.CXGate") and [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate") gates) and replaces them by linear functions ([`LinearFunction`](qiskit.circuit.library.LinearFunction "qiskit.circuit.library.LinearFunction")).
+
+CollectLinearFunctions initializer.
+
+**Parameters**
+
+* **do\_commutative\_analysis** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if True, exploits commutativity relations between nodes.
+* **split\_blocks** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if True, splits collected blocks into sub-blocks over disjoint qubit subsets.
+* **min\_block\_size** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – specifies the minimum number of gates in the block for the block to be collected.
+* **split\_layers** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if True, splits collected blocks into sub-blocks over disjoint qubit subsets.
+* **collect\_from\_back** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – specifies if blocks should be collected started from the end of the circuit.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the CollectLinearFunctions pass on dag. :param dag: the DAG to be optimized. :type dag: DAGCircuit
+
+**Returns**
+
+the optimized DAG.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.CollectMultiQBlocks.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CollectMultiQBlocks.md
new file mode 100644
index 00000000000..19d1ff2c242
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CollectMultiQBlocks.md
@@ -0,0 +1,133 @@
+---
+title: CollectMultiQBlocks
+description: API reference for qiskit.transpiler.passes.CollectMultiQBlocks
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.CollectMultiQBlocks
+---
+
+# CollectMultiQBlocks
+
+
+
+`qiskit.transpiler.passes.CollectMultiQBlocks(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/optimization/collect_multiqubit_blocks.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Collect sequences of uninterrupted gates acting on groups of qubits. `max_block_size` specifies the maximum number of qubits that can be acted upon by any single group of gates
+
+Traverse the DAG and find blocks of gates that act consecutively on groups of qubits. Write the blocks to `property_set` as a list of blocks of the form:
+
+```python
+[[g0, g1, g2], [g4, g5]]
+```
+
+Blocks are reported in a valid topological order. Further, the gates within each block are also reported in topological order Some gates may not be present in any block (e.g. if the number of operands is greater than `max_block_size`)
+
+A Disjoint Set Union data structure (DSU) is used to maintain blocks as gates are processed. This data structure points each qubit to a set at all times and the sets correspond to current blocks. These change over time and the data structure allows these changes to be done quickly.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### find\_set
+
+
+
+`find_set(index)`
+
+DSU function for finding root of set of items If my parent is myself, I am the root. Otherwise we recursively find the root for my parent. After that, we assign my parent to be my root, saving recursion in the future.
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the CollectMultiQBlocks pass on dag.
+
+The blocks contain “op” nodes in topological sort order such that all gates in a block act on the same set of qubits and are adjacent in the circuit.
+
+The blocks are built by examining predecessors and successors of “cx” gates in the circuit. u1, u2, u3, cx, id gates will be included.
+
+After the execution, `property_set['block_list']` is set to a list of tuples of `DAGNode` objects
+
+### union\_set
+
+
+
+`union_set(set1, set2)`
+
+DSU function for unioning two sets together Find the roots of each set. Then assign one to have the other as its parent, thus liking the sets. Merges smaller set into larger set in order to have better runtime
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.CommutationAnalysis.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CommutationAnalysis.md
new file mode 100644
index 00000000000..9eec3185624
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CommutationAnalysis.md
@@ -0,0 +1,105 @@
+---
+title: CommutationAnalysis
+description: API reference for qiskit.transpiler.passes.CommutationAnalysis
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.CommutationAnalysis
+---
+
+# CommutationAnalysis
+
+
+
+`qiskit.transpiler.passes.CommutationAnalysis(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/optimization/commutation_analysis.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Analysis pass to find commutation relations between DAG nodes.
+
+`property_set['commutation_set']` is a dictionary that describes the commutation relations on a given wire, all the gates on a wire are grouped into a set of gates that commute.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the CommutationAnalysis pass on dag.
+
+Run the pass on the DAG, and write the discovered commutation relations into the `property_set`.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.CommutativeCancellation.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CommutativeCancellation.md
new file mode 100644
index 00000000000..c1fec588a1e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CommutativeCancellation.md
@@ -0,0 +1,130 @@
+---
+title: CommutativeCancellation
+description: API reference for qiskit.transpiler.passes.CommutativeCancellation
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.CommutativeCancellation
+---
+
+# CommutativeCancellation
+
+
+
+`qiskit.transpiler.passes.CommutativeCancellation(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/optimization/commutative_cancellation.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Cancel the redundant (self-adjoint) gates through commutation relations.
+
+Pass for cancelling self-inverse gates/rotations. The cancellation utilizes the commutation relations in the circuit. Gates considered include:
+
+```python
+H, X, Y, Z, CX, CY, CZ
+```
+
+CommutativeCancellation initializer.
+
+**Parameters**
+
+* **basis\_gates** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – Basis gates to consider, e.g. `['u3', 'cx']`. For the effects of this pass, the basis is the set intersection between the `basis_gates` parameter and the gates in the dag.
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – The [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") representing the target backend, if both `basis_gates` and `target` are specified then this argument will take precedence and `basis_gates` will be ignored.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the CommutativeCancellation pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – the DAG to be optimized.
+
+**Returns**
+
+the optimized DAG.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – when the 1-qubit rotation gates are not found
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.CommutativeInverseCancellation.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CommutativeInverseCancellation.md
new file mode 100644
index 00000000000..5531da9815b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CommutativeInverseCancellation.md
@@ -0,0 +1,113 @@
+---
+title: CommutativeInverseCancellation
+description: API reference for qiskit.transpiler.passes.CommutativeInverseCancellation
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.CommutativeInverseCancellation
+---
+
+# CommutativeInverseCancellation
+
+
+
+`qiskit.transpiler.passes.CommutativeInverseCancellation(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/optimization/commutative_inverse_cancellation.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Cancel pairs of inverse gates exploiting commutation relations.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the CommutativeInverseCancellation pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")) – the directed acyclic graph to run on.
+
+**Returns**
+
+Transformed DAG.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.Commuting2qGateRouter.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Commuting2qGateRouter.md
new file mode 100644
index 00000000000..f8ae6d582e5
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Commuting2qGateRouter.md
@@ -0,0 +1,206 @@
+---
+title: Commuting2qGateRouter
+description: API reference for qiskit.transpiler.passes.Commuting2qGateRouter
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.Commuting2qGateRouter
+---
+
+# Commuting2qGateRouter
+
+
+
+`qiskit.transpiler.passes.Commuting2qGateRouter(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/routing/commuting_2q_gate_routing/commuting_2q_gate_router.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+A class to swap route one or more commuting gates to the coupling map.
+
+This pass routes blocks of commuting two-qubit gates encapsulated as `Commuting2qBlock` instructions. This pass will not apply to other instructions. The mapping to the coupling map is done using swap strategies, see `SwapStrategy`. The swap strategy should suit the problem and the coupling map. This transpiler pass should ideally be executed before the quantum circuit is enlarged with any idle ancilla qubits. Otherwise, we may swap qubits outside the portion of the chip we want to use. Therefore, the swap strategy and its associated coupling map do not represent physical qubits. Instead, they represent an intermediate mapping that corresponds to the physical qubits once the initial layout is applied. The example below shows how to map a four qubit [`PauliEvolutionGate`](qiskit.circuit.library.PauliEvolutionGate "qiskit.circuit.library.PauliEvolutionGate") to qubits 0, 1, 3, and 4 of the five qubit device with the coupling map
+
+```python
+0 -- 1 -- 2
+ |
+ 3
+ |
+ 4
+```
+
+To do this we use a line swap strategy for qubits 0, 1, 3, and 4 defined it in terms of virtual qubits 0, 1, 2, and 3.
+
+```python
+from qiskit import QuantumCircuit
+from qiskit.opflow import PauliSumOp
+from qiskit.circuit.library import PauliEvolutionGate
+from qiskit.transpiler import Layout, CouplingMap, PassManager
+from qiskit.transpiler.passes import FullAncillaAllocation
+from qiskit.transpiler.passes import EnlargeWithAncilla
+from qiskit.transpiler.passes import ApplyLayout
+from qiskit.transpiler.passes import SetLayout
+
+from qiskit.transpiler.passes.routing.commuting_2q_gate_routing import (
+ SwapStrategy,
+ FindCommutingPauliEvolutions,
+ Commuting2qGateRouter,
+)
+
+# Define the circuit on virtual qubits
+op = PauliSumOp.from_list([("IZZI", 1), ("ZIIZ", 2), ("ZIZI", 3)])
+circ = QuantumCircuit(4)
+circ.append(PauliEvolutionGate(op, 1), range(4))
+
+# Define the swap strategy on qubits before the initial_layout is applied.
+swap_strat = SwapStrategy.from_line([0, 1, 2, 3])
+
+# Chose qubits 0, 1, 3, and 4 from the backend coupling map shown above.
+backend_cmap = CouplingMap(couplinglist=[(0, 1), (1, 2), (1, 3), (3, 4)])
+initial_layout = Layout.from_intlist([0, 1, 3, 4], *circ.qregs)
+
+pm_pre = PassManager(
+ [
+ FindCommutingPauliEvolutions(),
+ Commuting2qGateRouter(swap_strat),
+ SetLayout(initial_layout),
+ FullAncillaAllocation(backend_cmap),
+ EnlargeWithAncilla(),
+ ApplyLayout(),
+ ]
+)
+
+# Insert swap gates, map to initial_layout and finally enlarge with ancilla.
+pm_pre.run(circ).draw("mpl")
+```
+
+This pass manager relies on the `current_layout` which corresponds to the qubit layout as swap gates are applied. The pass will traverse all nodes in the dag. If a node should be routed using a swap strategy then it will be decomposed into sub-instructions with swap layers in between and the `current_layout` will be modified. Nodes that should not be routed using swap strategies will be added back to the dag taking the `current_layout` into account.
+
+**Parameters**
+
+* **swap\_strategy** – An instance of a `SwapStrategy` that holds the swap layers that are used, and the order in which to apply them, to map the instruction to the hardware. If this field is not given, it should be contained in the property set of the pass. This allows other passes to determine the most appropriate swap strategy at run-time.
+* **edge\_coloring** – An optional edge coloring of the coupling map (I.e. no two edges that share a node have the same color). If the edge coloring is given then the commuting gates that can be simultaneously applied given the current qubit permutation are grouped according to the edge coloring and applied according to this edge coloring. Here, a color is an int which is used as the index to define and access the groups of commuting gates that can be applied simultaneously. If the edge coloring is not given then the sets will be built-up using a greedy algorithm. The edge coloring is useful to position gates such as `RZZGate`s next to swap gates to exploit CX cancellations.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the pass by decomposing the nodes it applies on.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")) – The dag to which we will add swaps.
+
+**Returns**
+
+A dag where swaps have been added for the intended gate type.
+
+**Raises**
+
+* [**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – If the swap strategy was not given at init time and there is no swap strategy in the property set.
+* [**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – If the quantum circuit contains more than one qubit register.
+* [**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – If there are qubits that are not contained in the quantum register.
+
+**Return type**
+
+[*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")
+
+### swap\_decompose
+
+
+
+`swap_decompose(dag, node, current_layout, swap_strategy)`
+
+Take an instance of `Commuting2qBlock` and map it to the coupling map.
+
+The mapping is done with the swap strategy.
+
+**Parameters**
+
+* **dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")) – The dag which contains the `Commuting2qBlock` we route.
+* **node** ([*DAGOpNode*](qiskit.dagcircuit.DAGOpNode "qiskit.dagcircuit.dagnode.DAGOpNode")) – A node whose operation is a `Commuting2qBlock`.
+* **current\_layout** ([*Layout*](qiskit.transpiler.Layout "qiskit.transpiler.layout.Layout")) – The layout before the swaps are applied. This function will modify the layout so that subsequent gates can be properly composed on the dag.
+* **swap\_strategy** (*SwapStrategy*) – The swap strategy used to decompose the node.
+
+**Returns**
+
+A dag that is compatible with the coupling map where swap gates have been added to map the gates in the `Commuting2qBlock` to the hardware.
+
+**Return type**
+
+[*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.ConsolidateBlocks.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.ConsolidateBlocks.md
new file mode 100644
index 00000000000..39886219d29
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.ConsolidateBlocks.md
@@ -0,0 +1,121 @@
+---
+title: ConsolidateBlocks
+description: API reference for qiskit.transpiler.passes.ConsolidateBlocks
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.ConsolidateBlocks
+---
+
+# ConsolidateBlocks
+
+
+
+`qiskit.transpiler.passes.ConsolidateBlocks(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/optimization/consolidate_blocks.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Replace each block of consecutive gates by a single Unitary node.
+
+Pass to consolidate sequences of uninterrupted gates acting on the same qubits into a Unitary node, to be resynthesized later, to a potentially more optimal subcircuit.
+
+**Notes**
+
+This pass assumes that the ‘blocks\_list’ property that it reads is given such that blocks are in topological order. The blocks are collected by a previous pass, such as Collect2qBlocks.
+
+ConsolidateBlocks initializer.
+
+If `kak_basis_gate` is not `None` it will be used as the basis gate for KAK decomposition. Otherwise, if `basis_gates` is not `None` a basis gate will be chosen from this list. Otherwise, the basis gate will be [`CXGate`](qiskit.circuit.library.CXGate "qiskit.circuit.library.CXGate").
+
+**Parameters**
+
+* **kak\_basis\_gate** ([*Gate*](qiskit.circuit.Gate "qiskit.circuit.Gate")) – Basis gate for KAK decomposition.
+* **force\_consolidate** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Force block consolidation.
+* **basis\_gates** (*List(*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*)*) – Basis gates from which to choose a KAK gate.
+* **approximation\_degree** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – a float between $[0.0, 1.0]$. Lower approximates more.
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – The target object for the compilation target backend.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the ConsolidateBlocks pass on dag.
+
+Iterate over each block and replace it with an equivalent Unitary on the same wires.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.ConstrainedReschedule.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.ConstrainedReschedule.md
new file mode 100644
index 00000000000..5e6a0cf3181
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.ConstrainedReschedule.md
@@ -0,0 +1,175 @@
+---
+title: ConstrainedReschedule
+description: API reference for qiskit.transpiler.passes.ConstrainedReschedule
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.ConstrainedReschedule
+---
+
+# ConstrainedReschedule
+
+
+
+`qiskit.transpiler.passes.ConstrainedReschedule(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/scheduling/alignments/reschedule.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Rescheduler pass that updates node start times to conform to the hardware alignments.
+
+This pass shifts DAG node start times previously scheduled with one of the scheduling passes, e.g. [`ASAPScheduleAnalysis`](qiskit.transpiler.passes.ASAPScheduleAnalysis "qiskit.transpiler.passes.ASAPScheduleAnalysis") or [`ALAPScheduleAnalysis`](qiskit.transpiler.passes.ALAPScheduleAnalysis "qiskit.transpiler.passes.ALAPScheduleAnalysis"), so that every instruction start time satisfies alignment constraints.
+
+**Examples**
+
+We assume executing the following circuit on a backend with 16 dt of acquire alignment.
+
+```python
+ ┌───┐┌────────────────┐┌─┐
+q_0: ┤ X ├┤ Delay(100[dt]) ├┤M├
+ └───┘└────────────────┘└╥┘
+c: 1/════════════════════════╩═
+ 0
+```
+
+Note that delay of 100 dt induces a misalignment of 4 dt at the measurement. This pass appends an extra 12 dt time shift to the input circuit.
+
+```python
+ ┌───┐┌────────────────┐┌─┐
+q_0: ┤ X ├┤ Delay(112[dt]) ├┤M├
+ └───┘└────────────────┘└╥┘
+c: 1/════════════════════════╩═
+ 0
+```
+
+**Notes**
+
+Your backend may execute circuits violating these alignment constraints. However, you may obtain erroneous measurement result because of the untracked phase originating in the instruction misalignment.
+
+Create new rescheduler pass.
+
+The alignment values depend on the control electronics of your quantum processor.
+
+**Parameters**
+
+* **acquire\_alignment** – Integer number representing the minimum time resolution to trigger acquisition instruction in units of `dt`.
+* **pulse\_alignment** – Integer number representing the minimum time resolution to trigger gate instruction in units of `dt`.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run rescheduler.
+
+This pass should perform rescheduling to satisfy:
+
+> * All DAGOpNode nodes (except for compiler directives) are placed at start time satisfying hardware alignment constraints.
+> * The end time of a node does not overlap with the start time of successor nodes.
+
+Assumptions:
+
+> * Topological order and absolute time order of DAGOpNode are consistent.
+> * All bits in either qargs or cargs associated with node synchronously start.
+> * Start time of qargs and cargs may different due to I/O latency.
+
+Based on the configurations above, the rescheduler pass takes the following strategy:
+
+1. **The nodes are processed in the topological order, from the beginning of**
+
+ the circuit (i.e. from left to right). For every node (including compiler directives), the function `_push_node_back` performs steps 2 and 3.
+
+2. **If the start time of the node violates the alignment constraint,**
+
+ the start time is increased to satisfy the constraint.
+
+3. **Each immediate successor whose start\_time overlaps the node’s end\_time is**
+
+ pushed backwards (towards the end of the wire). Note that at this point the shifted successor does not need to satisfy the constraints, but this will be taken care of when that successor node itself is processed.
+
+4. **After every node is processed, all misalignment constraints will be resolved,**
+
+ and there will be no overlap between the nodes.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")) – DAG circuit to be rescheduled with constraints.
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – If circuit is not scheduled.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.ContainsInstruction.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.ContainsInstruction.md
new file mode 100644
index 00000000000..c5a830ac52b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.ContainsInstruction.md
@@ -0,0 +1,110 @@
+---
+title: ContainsInstruction
+description: API reference for qiskit.transpiler.passes.ContainsInstruction
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.ContainsInstruction
+---
+
+# ContainsInstruction
+
+
+
+`qiskit.transpiler.passes.ContainsInstruction(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/utils/contains_instruction.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+An analysis pass to detect if the DAG contains a specific instruction.
+
+This pass takes in a single instruction name for example `'delay'` and will set the property set `contains_delay` to `True` if the DAG contains that instruction and `False` if it does not.
+
+ContainsInstruction initializer.
+
+**Parameters**
+
+* **instruction\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| Iterable\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – The instruction or instructions to check are in the DAG. The output in the property set is set to `contains_` prefixed on each value for this parameter.
+* **recurse** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if `True` (default), then recurse into control-flow operations.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the ContainsInstruction pass on dag.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.ConvertConditionsToIfOps.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.ConvertConditionsToIfOps.md
new file mode 100644
index 00000000000..4ba3d869898
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.ConvertConditionsToIfOps.md
@@ -0,0 +1,111 @@
+---
+title: ConvertConditionsToIfOps
+description: API reference for qiskit.transpiler.passes.ConvertConditionsToIfOps
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.ConvertConditionsToIfOps
+---
+
+# ConvertConditionsToIfOps
+
+
+
+`qiskit.transpiler.passes.ConvertConditionsToIfOps(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/utils/convert_conditions_to_if_ops.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Convert instructions whose `condition` attribute is set to a non-`None` value into the equivalent single-statement `IfElseBlock`.
+
+This is a simple pass aimed at easing the conversion from the old style of using [`InstructionSet.c_if()`](qiskit.circuit.InstructionSet#c_if "qiskit.circuit.InstructionSet.c_if") into the new style of using more complex conditional logic.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run a pass on the DAGCircuit. This is implemented by the pass developer.
+
+**Parameters**
+
+**dag** – the dag on which the pass is run.
+
+**Raises**
+
+[**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.12)") – when this is left unimplemented for a pass.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.CountOps.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CountOps.md
new file mode 100644
index 00000000000..54e27a4304a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CountOps.md
@@ -0,0 +1,103 @@
+---
+title: CountOps
+description: API reference for qiskit.transpiler.passes.CountOps
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.CountOps
+---
+
+# CountOps
+
+
+
+`qiskit.transpiler.passes.CountOps(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/analysis/count_ops.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Count the operations in a DAG circuit.
+
+The result is saved in `property_set['count_ops']` as an integer.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the CountOps pass on dag.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.CountOpsLongestPath.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CountOpsLongestPath.md
new file mode 100644
index 00000000000..b304a4a53bb
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CountOpsLongestPath.md
@@ -0,0 +1,103 @@
+---
+title: CountOpsLongestPath
+description: API reference for qiskit.transpiler.passes.CountOpsLongestPath
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.CountOpsLongestPath
+---
+
+# CountOpsLongestPath
+
+
+
+`qiskit.transpiler.passes.CountOpsLongestPath(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/analysis/count_ops_longest_path.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Count the operations on the longest path in a [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit").
+
+The result is saved in `property_set['count_ops_longest_path']` as an integer.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the CountOpsLongestPath pass on dag.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.CrosstalkAdaptiveSchedule.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CrosstalkAdaptiveSchedule.md
new file mode 100644
index 00000000000..cfa0a9505d4
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.CrosstalkAdaptiveSchedule.md
@@ -0,0 +1,343 @@
+---
+title: CrosstalkAdaptiveSchedule
+description: API reference for qiskit.transpiler.passes.CrosstalkAdaptiveSchedule
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.CrosstalkAdaptiveSchedule
+---
+
+# CrosstalkAdaptiveSchedule
+
+
+
+`qiskit.transpiler.passes.CrosstalkAdaptiveSchedule(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/optimization/crosstalk_adaptive_schedule.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Crosstalk mitigation through adaptive instruction scheduling.
+
+CrosstalkAdaptiveSchedule initializer.
+
+
+ The class `qiskit.transpiler.passes.optimization.crosstalk_adaptive_schedule.CrosstalkAdaptiveSchedule` is deprecated as of qiskit 0.46. It will be removed in the 1.0.0 release.
+
+
+**Parameters**
+
+* **backend\_prop** ([*BackendProperties*](qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties")) – backend properties object
+
+* **crosstalk\_prop** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) –
+
+ crosstalk properties object crosstalk\_prop\[g1]\[g2] specifies the conditional error rate of g1 when g1 and g2 are executed simultaneously. g1 should be a two-qubit tuple of the form (x,y) where x and y are physical qubit ids. g2 can be either two-qubit tuple (x,y) or single-qubit tuple (x). We currently ignore crosstalk between pairs of single-qubit gates. Gate pairs which are not specified are assumed to be crosstalk free.
+
+ Example:
+
+ ```python
+ crosstalk_prop = {(0, 1) : {(2, 3) : 0.2, (2) : 0.15},
+ (4, 5) : {(2, 3) : 0.1},
+ (2, 3) : {(0, 1) : 0.05, (4, 5): 0.05}}
+ ```
+
+ The keys of the crosstalk\_prop are tuples for ordered tuples for CX gates e.g., (0, 1) corresponding to CX 0, 1 in the hardware. Each key has an associated value dict which specifies the conditional error rates with nearby gates e.g., `(0, 1) : {(2, 3) : 0.2, (2) : 0.15}` means that CNOT 0, 1 has an error rate of 0.2 when it is executed in parallel with CNOT 2,3 and an error rate of 0.15 when it is executed in parallel with a single qubit gate on qubit 2.
+
+* **weight\_factor** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – weight of gate error/crosstalk terms in the objective $weight_factor*fidelities + (1-weight_factor)*decoherence errors$. Weight can be varied from 0 to 1, with 0 meaning that only decoherence errors are optimized and 1 meaning that only crosstalk errors are optimized. weight\_factor should be tuned per application to get the best results.
+
+* **measured\_qubits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – a list of qubits that will be measured in a particular circuit. This arg need not be specified for circuits which already include measure gates. The arg is useful when a subsequent module such as state\_tomography\_circuits inserts the measure gates. If CrosstalkAdaptiveSchedule is made aware of those measurements, it is included in the optimization.
+
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – A target representing the target backend, if both `backend_prop` and `target` are specified then this argument will take precedence and `coupling_map` will be ignored.
+
+**Raises**
+
+[**ImportError**](https://docs.python.org/3/library/exceptions.html#ImportError "(in Python v3.12)") – if unable to import z3 solver
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### assign\_gate\_id
+
+
+
+`assign_gate_id(dag)`
+
+ID for each gate
+
+### basic\_bounds
+
+
+
+`basic_bounds()`
+
+Basic variable bounds for optimization
+
+### check\_dag\_dependency
+
+
+
+`check_dag_dependency(gate1, gate2)`
+
+gate2 is a DAG dependent of gate1 if it is a descendant of gate1
+
+### check\_xtalk\_dependency
+
+
+
+`check_xtalk_dependency(t_1, t_2)`
+
+Check if two gates have a crosstalk dependency. We do not consider crosstalk between pairs of single qubit gates.
+
+### coherence\_constraints
+
+
+
+`coherence_constraints()`
+
+Set decoherence errors based on qubit lifetimes
+
+### create\_updated\_dag
+
+
+
+`create_updated_dag(layers, barriers)`
+
+Given a set of layers and barriers, construct a new dag
+
+### create\_z3\_vars
+
+
+
+`create_z3_vars()`
+
+Setup the variables required for Z3 optimization
+
+### cx\_tuple
+
+
+
+`cx_tuple(gate)`
+
+Representation for two-qubit gate Note: current implementation assumes that the CX error rates and crosstalk behavior are independent of gate direction
+
+### enforce\_schedule\_on\_dag
+
+
+
+`enforce_schedule_on_dag(input_gate_times)`
+
+Z3 outputs start times for each gate. Some gates need to be serialized to implement the Z3 schedule. This function inserts barriers to implement those serializations
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### extract\_crosstalk\_relevant\_sets
+
+
+
+`extract_crosstalk_relevant_sets()`
+
+Extract the set of program gates which potentially have crosstalk noise
+
+### extract\_dag\_overlap\_sets
+
+
+
+`extract_dag_overlap_sets(dag)`
+
+Gate A, B are overlapping if A is neither a descendant nor an ancestor of B. Currently overlaps (A,B) are considered when A is a 2q gate and B is either 2q or 1q gate.
+
+### extract\_solution
+
+
+
+`extract_solution()`
+
+Extract gate start and finish times from Z3 solution
+
+### fidelity\_constraints
+
+
+
+`fidelity_constraints()`
+
+Set gate fidelity based on gate overlap conditions
+
+### filter\_candidates
+
+
+
+`filter_candidates(candidates, layer, layer_id, triplet)`
+
+For a gate G and layer L, L is a candidate layer for G if no gate in L has a DAG dependency with G, and if Z3 allows gates in L and G to overlap.
+
+### find\_layer
+
+
+
+`find_layer(layers, triplet)`
+
+Find the appropriate layer for a gate
+
+### gate\_tuple
+
+
+
+`gate_tuple(gate)`
+
+Representation for gate
+
+### generate\_barriers
+
+
+
+`generate_barriers(layers)`
+
+For each gate g, see if a barrier is required to serialize it with some previously processed gate
+
+### is\_significant\_xtalk
+
+
+
+`is_significant_xtalk(gate1, gate2)`
+
+Given two conditional gate error rates check if there is high crosstalk by comparing with independent error rates.
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### objective\_function
+
+
+
+`objective_function()`
+
+Objective function is a weighted combination of gate errors and decoherence errors
+
+### parse\_backend\_properties
+
+
+
+`parse_backend_properties()`
+
+This function assumes that gate durations and coherence times are in seconds in backend.properties() This function converts gate durations and coherence times to nanoseconds.
+
+### powerset
+
+
+
+`powerset(iterable)`
+
+Finds the set of all subsets of the given iterable This function is used to generate constraints for the Z3 optimization
+
+### r2f
+
+
+
+`r2f(val)`
+
+Convert Z3 Real to Python float
+
+### reset
+
+
+
+`reset()`
+
+Reset variables
+
+### run
+
+
+
+`run(dag)`
+
+Main scheduling function
+
+### scheduling\_constraints
+
+
+
+`scheduling_constraints()`
+
+DAG scheduling constraints optimization Sets overlap indicator variables
+
+### singleq\_tuple
+
+
+
+`singleq_tuple(gate)`
+
+Representation for single-qubit gate
+
+### solve\_optimization
+
+
+
+`solve_optimization()`
+
+Setup and solve a Z3 optimization for finding the best schedule
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.DAGFixedPoint.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.DAGFixedPoint.md
new file mode 100644
index 00000000000..12c18cf9320
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.DAGFixedPoint.md
@@ -0,0 +1,103 @@
+---
+title: DAGFixedPoint
+description: API reference for qiskit.transpiler.passes.DAGFixedPoint
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.DAGFixedPoint
+---
+
+# DAGFixedPoint
+
+
+
+`qiskit.transpiler.passes.DAGFixedPoint(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/utils/dag_fixed_point.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Check if the DAG has reached a fixed point.
+
+A dummy analysis pass that checks if the DAG a fixed point (the DAG is not modified anymore). The result is saved in `property_set['dag_fixed_point']` as a boolean.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the DAGFixedPoint pass on dag.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.DAGLongestPath.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.DAGLongestPath.md
new file mode 100644
index 00000000000..1328258ffe0
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.DAGLongestPath.md
@@ -0,0 +1,101 @@
+---
+title: DAGLongestPath
+description: API reference for qiskit.transpiler.passes.DAGLongestPath
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.DAGLongestPath
+---
+
+# DAGLongestPath
+
+
+
+`qiskit.transpiler.passes.DAGLongestPath(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/analysis/dag_longest_path.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Return the longest path in a [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") as a list of [`DAGOpNode`](qiskit.dagcircuit.DAGOpNode "qiskit.dagcircuit.DAGOpNode")s, [`DAGInNode`](qiskit.dagcircuit.DAGInNode "qiskit.dagcircuit.DAGInNode")s, and [`DAGOutNode`](qiskit.dagcircuit.DAGOutNode "qiskit.dagcircuit.DAGOutNode")s.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the DAGLongestPath pass on dag.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.Decompose.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Decompose.md
new file mode 100644
index 00000000000..30426cc1e85
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Decompose.md
@@ -0,0 +1,119 @@
+---
+title: Decompose
+description: API reference for qiskit.transpiler.passes.Decompose
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.Decompose
+---
+
+# Decompose
+
+
+
+`qiskit.transpiler.passes.Decompose(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/basis/decompose.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Expand a gate in a circuit using its decomposition rules.
+
+Decompose initializer.
+
+**Parameters**
+
+**gates\_to\_decompose** – optional subset of gates to be decomposed, identified by gate label, name or type. Defaults to all gates.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the Decompose pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")) – input dag.
+
+**Returns**
+
+output dag where `gate` was expanded.
+
+**Return type**
+
+[*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.DenseLayout.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.DenseLayout.md
new file mode 100644
index 00000000000..14e6b58238f
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.DenseLayout.md
@@ -0,0 +1,125 @@
+---
+title: DenseLayout
+description: API reference for qiskit.transpiler.passes.DenseLayout
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.DenseLayout
+---
+
+# DenseLayout
+
+
+
+`qiskit.transpiler.passes.DenseLayout(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/layout/dense_layout.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Choose a Layout by finding the most connected subset of qubits.
+
+This pass associates a physical qubit (int) to each virtual qubit of the circuit (Qubit).
+
+
+ Even though a `'layout'` is not strictly a property of the DAG, in the transpiler architecture it is best passed around between passes by being set in `property_set`.
+
+
+DenseLayout initializer.
+
+**Parameters**
+
+* **coupling\_map** (*Coupling*) – directed graph representing a coupling map.
+* **backend\_prop** ([*BackendProperties*](qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties")) – backend properties object
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – A target representing the target backend.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the DenseLayout pass on dag.
+
+Pick a convenient layout depending on the best matching qubit connectivity, and set the property layout.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – DAG to find layout for.
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if dag wider than self.coupling\_map
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.Depth.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Depth.md
new file mode 100644
index 00000000000..70fd1d5d825
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Depth.md
@@ -0,0 +1,105 @@
+---
+title: Depth
+description: API reference for qiskit.transpiler.passes.Depth
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.Depth
+---
+
+# Depth
+
+
+
+`qiskit.transpiler.passes.Depth(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/analysis/depth.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Calculate the depth of a DAG circuit.
+
+**Parameters**
+
+**recurse** – whether to allow recursion into control flow. If this is `False` (default), the pass will throw an error when control flow is present, to avoid returning a number with little meaning.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the Depth pass on dag.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.DynamicalDecoupling.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.DynamicalDecoupling.md
new file mode 100644
index 00000000000..2b3be281520
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.DynamicalDecoupling.md
@@ -0,0 +1,202 @@
+---
+title: DynamicalDecoupling
+description: API reference for qiskit.transpiler.passes.DynamicalDecoupling
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.DynamicalDecoupling
+---
+
+# DynamicalDecoupling
+
+
+
+`qiskit.transpiler.passes.DynamicalDecoupling(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/scheduling/dynamical_decoupling.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Dynamical decoupling insertion pass.
+
+This pass works on a scheduled, physical circuit. It scans the circuit for idle periods of time (i.e. those containing delay instructions) and inserts a DD sequence of gates in those spots. These gates amount to the identity, so do not alter the logical action of the circuit, but have the effect of mitigating decoherence in those idle periods.
+
+As a special case, the pass allows a length-1 sequence (e.g. \[XGate()]). In this case the DD insertion happens only when the gate inverse can be absorbed into a neighboring gate in the circuit (so we would still be replacing Delay with something that is equivalent to the identity). This can be used, for instance, as a Hahn echo.
+
+This pass ensures that the inserted sequence preserves the circuit exactly (including global phase).
+
+```python
+import numpy as np
+from qiskit.circuit import QuantumCircuit
+from qiskit.circuit.library import XGate
+from qiskit.transpiler import PassManager, InstructionDurations
+from qiskit.transpiler.passes import ALAPSchedule, DynamicalDecoupling
+from qiskit.visualization import timeline_drawer
+
+# Because the legacy passes do not propagate the scheduling information correctly, it is
+# necessary to run a no-op "re-schedule" before the output circuits can be drawn.
+def draw(circuit):
+ from qiskit import transpile
+
+ scheduled = transpile(
+ circuit,
+ optimization_level=0,
+ instruction_durations=InstructionDurations(),
+ scheduling_method="alap",
+ )
+ return timeline_drawer(scheduled)
+
+circ = QuantumCircuit(4)
+circ.h(0)
+circ.cx(0, 1)
+circ.cx(1, 2)
+circ.cx(2, 3)
+circ.measure_all()
+durations = InstructionDurations(
+ [("h", 0, 50), ("cx", [0, 1], 700), ("reset", None, 10),
+ ("cx", [1, 2], 200), ("cx", [2, 3], 300),
+ ("x", None, 50), ("measure", None, 1000)]
+)
+# balanced X-X sequence on all qubits
+dd_sequence = [XGate(), XGate()]
+pm = PassManager([ALAPSchedule(durations),
+ DynamicalDecoupling(durations, dd_sequence)])
+circ_dd = pm.run(circ)
+draw(circ_dd)
+
+# Uhrig sequence on qubit 0
+n = 8
+dd_sequence = [XGate()] * n
+def uhrig_pulse_location(k):
+ return np.sin(np.pi * (k + 1) / (2 * n + 2)) ** 2
+spacing = []
+for k in range(n):
+ spacing.append(uhrig_pulse_location(k) - sum(spacing))
+spacing.append(1 - sum(spacing))
+pm = PassManager(
+ [
+ ALAPSchedule(durations),
+ DynamicalDecoupling(durations, dd_sequence, qubits=[0], spacing=spacing),
+ ]
+)
+circ_dd = pm.run(circ)
+draw(circ_dd)
+```
+
+
+
+
+
+Dynamical decoupling initializer.
+
+
+ The class `qiskit.transpiler.passes.scheduling.dynamical_decoupling.DynamicalDecoupling` is pending deprecation as of qiskit 0.21.0. It will be marked deprecated in a future release, and then removed no earlier than 3 months after the release date. Instead, use [`PadDynamicalDecoupling`](qiskit.transpiler.passes.PadDynamicalDecoupling "qiskit.transpiler.passes.PadDynamicalDecoupling"), which performs the same function but requires scheduling and alignment analysis passes to run prior to it.
+
+
+**Parameters**
+
+* **durations** ([*InstructionDurations*](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations")) – Durations of instructions to be used in scheduling.
+* **dd\_sequence** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*Gate*](qiskit.circuit.Gate "qiskit.circuit.Gate")*]*) – sequence of gates to apply in idle spots.
+* **qubits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – physical qubits on which to apply DD. If None, all qubits will undergo DD (when possible).
+* **spacing** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – a list of spacings between the DD gates. The available slack will be divided according to this. The list length must be one more than the length of dd\_sequence, and the elements must sum to 1. If None, a balanced spacing will be used \[d/2, d, d, …, d, d, d/2].
+* **skip\_reset\_qubits** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if True, does not insert DD on idle periods that immediately follow initialized/reset qubits (as qubits in the ground state are less susceptile to decoherence).
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – The [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") representing the target backend, if both `durations` and this are specified then this argument will take precedence and `durations` will be ignored.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the DynamicalDecoupling pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – a scheduled DAG.
+
+**Returns**
+
+**equivalent circuit with delays interrupted by DD,**
+
+where possible.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if the circuit is not mapped on physical qubits.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.EchoRZXWeylDecomposition.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.EchoRZXWeylDecomposition.md
new file mode 100644
index 00000000000..c6b75b9e147
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.EchoRZXWeylDecomposition.md
@@ -0,0 +1,128 @@
+---
+title: EchoRZXWeylDecomposition
+description: API reference for qiskit.transpiler.passes.EchoRZXWeylDecomposition
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.EchoRZXWeylDecomposition
+---
+
+# EchoRZXWeylDecomposition
+
+
+
+`qiskit.transpiler.passes.EchoRZXWeylDecomposition(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/optimization/echo_rzx_weyl_decomposition.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Rewrite two-qubit gates using the Weyl decomposition.
+
+This transpiler pass rewrites two-qubit gates in terms of echoed cross-resonance gates according to the Weyl decomposition. A two-qubit gate will be replaced with at most six non-echoed RZXGates. Each pair of RZXGates forms an echoed RZXGate.
+
+EchoRZXWeylDecomposition pass.
+
+**Parameters**
+
+* **instruction\_schedule\_map** ([*InstructionScheduleMap*](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap")) – the mapping from circuit [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") names and arguments to [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule")s.
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – The [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") representing the target backend, if both `instruction_schedule_map` and `target` are specified then this argument will take precedence and `instruction_schedule_map` will be ignored.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the EchoRZXWeylDecomposition pass on dag.
+
+Rewrites two-qubit gates in an arbitrary circuit in terms of echoed cross-resonance gates by computing the Weyl decomposition of the corresponding unitary. Modifies the input dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – DAG to rewrite.
+
+**Returns**
+
+The modified dag.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – If the circuit cannot be rewritten.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.EnlargeWithAncilla.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.EnlargeWithAncilla.md
new file mode 100644
index 00000000000..45ee5cfc614
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.EnlargeWithAncilla.md
@@ -0,0 +1,119 @@
+---
+title: EnlargeWithAncilla
+description: API reference for qiskit.transpiler.passes.EnlargeWithAncilla
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.EnlargeWithAncilla
+---
+
+# EnlargeWithAncilla
+
+
+
+`qiskit.transpiler.passes.EnlargeWithAncilla(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/layout/enlarge_with_ancilla.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Extend the dag with virtual qubits that are in layout but not in the circuit yet.
+
+Extend the DAG circuit with new virtual qubits (ancilla) that are specified in the layout, but not present in the circuit. Which qubits to add are previously allocated in the `layout` property, by a previous pass.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the EnlargeWithAncilla pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – DAG to extend.
+
+**Returns**
+
+An extended DAG.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – If there is no layout in the property set or not set at init time.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.FixedPoint.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.FixedPoint.md
new file mode 100644
index 00000000000..782f1854b39
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.FixedPoint.md
@@ -0,0 +1,109 @@
+---
+title: FixedPoint
+description: API reference for qiskit.transpiler.passes.FixedPoint
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.FixedPoint
+---
+
+# FixedPoint
+
+
+
+`qiskit.transpiler.passes.FixedPoint(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/utils/fixed_point.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Check if a property reached a fixed point.
+
+A dummy analysis pass that checks if a property reached a fixed point. The result is saved in `property_set['_fixed_point']` as a boolean.
+
+FixedPoint initializer.
+
+**Parameters**
+
+**property\_to\_check** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The property to check if a fixed point was reached.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the FixedPoint pass on dag.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.FullAncillaAllocation.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.FullAncillaAllocation.md
new file mode 100644
index 00000000000..03ad511ef7a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.FullAncillaAllocation.md
@@ -0,0 +1,141 @@
+---
+title: FullAncillaAllocation
+description: API reference for qiskit.transpiler.passes.FullAncillaAllocation
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.FullAncillaAllocation
+---
+
+# FullAncillaAllocation
+
+
+
+`qiskit.transpiler.passes.FullAncillaAllocation(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/layout/full_ancilla_allocation.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Allocate all idle nodes from the coupling map or target as ancilla on the layout.
+
+A pass for allocating all idle physical qubits (those that exist in coupling map or target but not the dag circuit) as ancilla. It will also choose new virtual qubits to correspond to those physical ancilla.
+
+
+ This is an analysis pass, and only responsible for choosing physical ancilla locations and their corresponding virtual qubits. A separate transformation pass must add those virtual qubits to the circuit.
+
+
+FullAncillaAllocation initializer.
+
+**Parameters**
+
+**coupling\_map** (*Union\[*[*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")*,* [*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")*]*) – directed graph representing a coupling map.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the FullAncillaAllocation pass on dag.
+
+Extend the layout with new (physical qubit, virtual qubit) pairs. The dag signals which virtual qubits are already in the circuit. This pass will allocate new virtual qubits such that no collision occurs (i.e. Layout bijectivity is preserved)
+
+The coupling\_map and layout together determine which physical qubits are free.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – circuit to analyze
+
+**Returns**
+
+returns the same dag circuit, unmodified
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – If there is not layout in the property set or not set at init time.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
+### validate\_layout
+
+
+
+`static validate_layout(layout_qubits, dag_qubits)`
+
+Checks if all the qregs in `layout_qregs` already exist in `dag_qregs`. Otherwise, raise.
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.GateDirection.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.GateDirection.md
new file mode 100644
index 00000000000..429eb001421
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.GateDirection.md
@@ -0,0 +1,153 @@
+---
+title: GateDirection
+description: API reference for qiskit.transpiler.passes.GateDirection
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.GateDirection
+---
+
+# GateDirection
+
+
+
+`qiskit.transpiler.passes.GateDirection(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/utils/gate_direction.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Modify asymmetric gates to match the hardware coupling direction.
+
+This pass makes use of the following identities:
+
+```python
+ ┌───┐┌───┐┌───┐
+q_0: ──■── q_0: ┤ H ├┤ X ├┤ H ├
+ ┌─┴─┐ = ├───┤└─┬─┘├───┤
+q_1: ┤ X ├ q_1: ┤ H ├──■──┤ H ├
+ └───┘ └───┘ └───┘
+
+
+ global phase: 3π/2
+ ┌──────┐ ┌───┐ ┌────┐┌─────┐┌──────┐┌───┐
+q_0: ┤0 ├ q_0: ─┤ S ├─┤ √X ├┤ Sdg ├┤1 ├┤ H ├
+ │ ECR │ = ┌┴───┴┐├────┤└┬───┬┘│ Ecr │├───┤
+q_1: ┤1 ├ q_1: ┤ Sdg ├┤ √X ├─┤ S ├─┤0 ├┤ H ├
+ └──────┘ └─────┘└────┘ └───┘ └──────┘└───┘
+
+
+ ┌──────┐ ┌───┐┌──────┐┌───┐
+q_0: ┤0 ├ q_0: ┤ H ├┤1 ├┤ H ├
+ │ RZX │ = ├───┤│ RZX │├───┤
+q_1: ┤1 ├ q_1: ┤ H ├┤0 ├┤ H ├
+ └──────┘ └───┘└──────┘└───┘
+```
+
+This pass assumes that the positions of the qubits in the `DAGCircuit.qubits` attribute are the physical qubit indicies. For example if `dag.qubits[0]` is qubit 0 in the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") or [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target").
+
+GateDirection pass.
+
+**Parameters**
+
+* **coupling\_map** ([*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")) – Directed graph represented a coupling map.
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – The backend target to use for this pass. If this is specified it will be used instead of the coupling map
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the GateDirection pass on dag.
+
+Flips the cx nodes to match the directed coupling map. Modifies the input dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – DAG to map.
+
+**Returns**
+
+The rearranged dag for the coupling map
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – If the circuit cannot be mapped just by flipping the cx nodes.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.GatesInBasis.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.GatesInBasis.md
new file mode 100644
index 00000000000..7010627786c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.GatesInBasis.md
@@ -0,0 +1,108 @@
+---
+title: GatesInBasis
+description: API reference for qiskit.transpiler.passes.GatesInBasis
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.GatesInBasis
+---
+
+# GatesInBasis
+
+
+
+`qiskit.transpiler.passes.GatesInBasis(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/utils/gates_basis.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Check if all gates in a DAG are in a given set of gates
+
+Initialize the GatesInBasis pass.
+
+**Parameters**
+
+* **basis\_gates** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – The list of strings representing the set of basis gates.
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – The target representing the backend. If specified this will be used instead of the `basis_gates` parameter
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the GatesInBasis pass on dag.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.HighLevelSynthesis.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.HighLevelSynthesis.md
new file mode 100644
index 00000000000..7fa71572ee4
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.HighLevelSynthesis.md
@@ -0,0 +1,152 @@
+---
+title: HighLevelSynthesis
+description: API reference for qiskit.transpiler.passes.HighLevelSynthesis
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.HighLevelSynthesis
+---
+
+# HighLevelSynthesis
+
+
+
+`qiskit.transpiler.passes.HighLevelSynthesis(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/synthesis/high_level_synthesis.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Synthesize higher-level objects and unroll custom definitions.
+
+The input to this pass is a DAG that may contain higher-level objects, including abstract mathematical objects (e.g., objects of type [`LinearFunction`](qiskit.circuit.library.LinearFunction "qiskit.circuit.library.LinearFunction")), annotated operations (objects of type [`AnnotatedOperation`](qiskit.circuit.AnnotatedOperation "qiskit.circuit.AnnotatedOperation")), and custom gates.
+
+In the most common use-case when either `basis_gates` or `target` is specified, all higher-level objects are synthesized, so the output is a [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") without such objects. More precisely, every gate in the output DAG is either directly supported by the target, or is in `equivalence_library`.
+
+The abstract mathematical objects are synthesized using synthesis plugins, applying synthesis methods specified in the high-level-synthesis config (refer to the documentation for `HLSConfig`).
+
+As an example, let us assume that `op_a` and `op_b` are names of two higher-level objects, that `op_a`-objects have two synthesis methods `default` which does require any additional parameters and `other` with two optional integer parameters `option_1` and `option_2`, that `op_b`-objects have a single synthesis method `default`, and `qc` is a quantum circuit containing `op_a` and `op_b` objects. The following code snippet:
+
+```python
+hls_config = HLSConfig(op_b=[("other", {"option_1": 7, "option_2": 4})])
+pm = PassManager([HighLevelSynthesis(hls_config=hls_config)])
+transpiled_qc = pm.run(qc)
+```
+
+shows how to run the alternative synthesis method `other` for `op_b`-objects, while using the `default` methods for all other high-level objects, including `op_a`-objects.
+
+The annotated operations (consisting of a base operation and a list of inverse, control and power modifiers) are synthesizing recursively, first synthesizing the base operation, and then applying synthesis methods for creating inverted, controlled, or powered versions of that).
+
+The custom gates are synthesized by recursively unrolling their definitions, until every gate is either supported by the target or is in the equivalence library.
+
+When neither `basis_gates` nor `target` is specified, the pass synthesizes only the top-level abstract mathematical objects and annotated operations, without descending into the gate `definitions`. This is consistent with the older behavior of the pass, allowing to synthesize some higher-level objects using plugins and leaving the other gates untouched.
+
+HighLevelSynthesis initializer.
+
+**Parameters**
+
+* **hls\_config** – Optional, the high-level-synthesis config that specifies synthesis methods and parameters for various high-level-objects in the circuit. If it is not specified, the default synthesis methods and parameters will be used.
+* **coupling\_map** – Optional, directed graph represented as a coupling map.
+* **target** – Optional, the backend target to use for this pass. If it is specified, it will be used instead of the coupling map.
+* **use\_qubit\_indices** – a flag indicating whether this synthesis pass is running before or after the layout is set, that is, whether the qubit indices of higher-level-objects correspond to qubit indices on the target backend.
+* **equivalence\_library** – The equivalence library used (instructions in this library will not be unrolled by this pass).
+* **basis\_gates** – Optional, target basis names to unroll to, e.g. \[‘u3’, ‘cx’]. Ignored if `target` is also specified.
+* **min\_qubits** – The minimum number of qubits for operations in the input dag to translate.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the HighLevelSynthesis pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")) – input dag.
+
+**Returns**
+
+Output dag with higher-level operations synthesized.
+
+**Raises**
+
+* [**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – when the transpiler is unable to synthesize the given DAG
+* **(****for instance****, ****when the specified synthesis method is not available****)\*\*\*\*.** –
+
+**Return type**
+
+[*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.HoareOptimizer.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.HoareOptimizer.md
new file mode 100644
index 00000000000..82995d4f8ac
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.HoareOptimizer.md
@@ -0,0 +1,119 @@
+---
+title: HoareOptimizer
+description: API reference for qiskit.transpiler.passes.HoareOptimizer
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.HoareOptimizer
+---
+
+# HoareOptimizer
+
+
+
+`qiskit.transpiler.passes.HoareOptimizer(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/optimization/hoare_opt.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+This is a transpiler pass using Hoare logic circuit optimization. The inner workings of this are detailed in: [https://arxiv.org/abs/1810.00375](https://arxiv.org/abs/1810.00375)
+
+**Parameters**
+
+**size** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – size of gate cache, in number of gates
+
+**Raises**
+
+[**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – if unable to import z3 solver
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – the directed acyclic graph to run on.
+
+**Returns**
+
+Transformed DAG.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.InstructionDurationCheck.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.InstructionDurationCheck.md
new file mode 100644
index 00000000000..3c2e3f6023d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.InstructionDurationCheck.md
@@ -0,0 +1,118 @@
+---
+title: InstructionDurationCheck
+description: API reference for qiskit.transpiler.passes.InstructionDurationCheck
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.InstructionDurationCheck
+---
+
+# InstructionDurationCheck
+
+
+
+`qiskit.transpiler.passes.InstructionDurationCheck(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/scheduling/alignments/check_durations.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Duration validation pass for reschedule.
+
+This pass investigates the input quantum circuit and checks if the circuit requires rescheduling for execution. Note that this pass can be triggered without scheduling. This pass only checks the duration of delay instructions and user defined pulse gates, which report duration values without pre-scheduling.
+
+This pass assumes backend supported instructions, i.e. basis gates, have no violation of the hardware alignment constraints, which is true in general.
+
+Create new duration validation pass.
+
+The alignment values depend on the control electronics of your quantum processor.
+
+**Parameters**
+
+* **acquire\_alignment** – Integer number representing the minimum time resolution to trigger acquisition instruction in units of `dt`.
+* **pulse\_alignment** – Integer number representing the minimum time resolution to trigger gate instruction in units of `dt`.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run duration validation passes.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")) – DAG circuit to check instruction durations.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.InverseCancellation.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.InverseCancellation.md
new file mode 100644
index 00000000000..d0cbeb09d2d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.InverseCancellation.md
@@ -0,0 +1,123 @@
+---
+title: InverseCancellation
+description: API reference for qiskit.transpiler.passes.InverseCancellation
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.InverseCancellation
+---
+
+# InverseCancellation
+
+
+
+`qiskit.transpiler.passes.InverseCancellation(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/optimization/inverse_cancellation.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Cancel specific Gates which are inverses of each other when they occur back-to- back.
+
+Initialize InverseCancellation pass.
+
+**Parameters**
+
+**gates\_to\_cancel** – List describing the gates to cancel. Each element of the list is either a single gate or a pair of gates. If a single gate, then it should be self-inverse. If a pair of gates, then the gates in the pair should be inverses of each other.
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – Input is not a self-inverse gate or a pair of inverse gates.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the InverseCancellation pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")) – the directed acyclic graph to run on.
+
+**Returns**
+
+Transformed DAG.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.Layout2qDistance.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Layout2qDistance.md
new file mode 100644
index 00000000000..5880eb4f043
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Layout2qDistance.md
@@ -0,0 +1,110 @@
+---
+title: Layout2qDistance
+description: API reference for qiskit.transpiler.passes.Layout2qDistance
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.Layout2qDistance
+---
+
+# Layout2qDistance
+
+
+
+`qiskit.transpiler.passes.Layout2qDistance(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/layout/layout_2q_distance.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Evaluate how good the layout selection was.
+
+Saves in `property_set['layout_score']` (or the property name in property\_name) the sum of distances for each circuit CX. The lower the number, the better the selection. Therefore, 0 is a perfect layout selection. No CX direction is considered.
+
+Layout2qDistance initializer.
+
+**Parameters**
+
+* **coupling\_map** (*Union\[*[*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")*,* [*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")*]*) – Directed graph represented a coupling map.
+* **property\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The property name to save the score. Default: layout\_score
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the Layout2qDistance pass on dag. :param dag: DAG to evaluate. :type dag: DAGCircuit
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.LinearFunctionsSynthesis.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.LinearFunctionsSynthesis.md
new file mode 100644
index 00000000000..6d2fe0f55ab
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.LinearFunctionsSynthesis.md
@@ -0,0 +1,124 @@
+---
+title: LinearFunctionsSynthesis
+description: API reference for qiskit.transpiler.passes.LinearFunctionsSynthesis
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.LinearFunctionsSynthesis
+---
+
+# LinearFunctionsSynthesis
+
+
+
+`qiskit.transpiler.passes.LinearFunctionsSynthesis(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/synthesis/linear_functions_synthesis.py "view source code")
+
+Bases: [`HighLevelSynthesis`](qiskit.transpiler.passes.HighLevelSynthesis "qiskit.transpiler.passes.synthesis.high_level_synthesis.HighLevelSynthesis")
+
+DEPRECATED: Synthesize linear functions.
+
+Under the hood, this runs the default high-level synthesis plugin for linear functions.
+
+
+ The class `qiskit.transpiler.passes.synthesis.linear_functions_synthesis.LinearFunctionsSynthesis` is deprecated as of qiskit-terra 0.23.0. It will be removed in the Qiskit 1.0 release. Instead, use [`HighLevelSynthesis`](qiskit.transpiler.passes.HighLevelSynthesis "qiskit.transpiler.passes.HighLevelSynthesis").
+
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the HighLevelSynthesis pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")) – input dag.
+
+**Returns**
+
+Output dag with higher-level operations synthesized.
+
+**Raises**
+
+* [**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – when the transpiler is unable to synthesize the given DAG
+* **(****for instance****, ****when the specified synthesis method is not available****)\*\*\*\*.** –
+
+**Return type**
+
+[*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.LinearFunctionsToPermutations.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.LinearFunctionsToPermutations.md
new file mode 100644
index 00000000000..70d12e8ae93
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.LinearFunctionsToPermutations.md
@@ -0,0 +1,109 @@
+---
+title: LinearFunctionsToPermutations
+description: API reference for qiskit.transpiler.passes.LinearFunctionsToPermutations
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.LinearFunctionsToPermutations
+---
+
+# LinearFunctionsToPermutations
+
+
+
+`qiskit.transpiler.passes.LinearFunctionsToPermutations(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/synthesis/linear_functions_synthesis.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Promotes linear functions to permutations when possible.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the LinearFunctionsToPermutations pass on dag. :param dag: input dag.
+
+**Returns**
+
+Output dag with LinearFunctions synthesized.
+
+**Return type**
+
+[*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.LookaheadSwap.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.LookaheadSwap.md
new file mode 100644
index 00000000000..609a0ef0a70
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.LookaheadSwap.md
@@ -0,0 +1,145 @@
+---
+title: LookaheadSwap
+description: API reference for qiskit.transpiler.passes.LookaheadSwap
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.LookaheadSwap
+---
+
+# LookaheadSwap
+
+
+
+`qiskit.transpiler.passes.LookaheadSwap(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/routing/lookahead_swap.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Map input circuit onto a backend topology via insertion of SWAPs.
+
+Implementation of Sven Jandura’s swap mapper submission for the 2018 Qiskit Developer Challenge, adapted to integrate into the transpiler architecture.
+
+The role of the swapper pass is to modify the starting circuit to be compatible with the target device’s topology (the set of two-qubit gates available on the hardware.) To do this, the pass will insert SWAP gates to relocate the virtual qubits for each upcoming gate onto a set of coupled physical qubits. However, as SWAP gates are particularly lossy, the goal is to accomplish this remapping while introducing the fewest possible additional SWAPs.
+
+This algorithm searches through the available combinations of SWAP gates by means of a narrowed best first/beam search, described as follows:
+
+* Start with a layout of virtual qubits onto physical qubits.
+* Find any gates in the input circuit which can be performed with the current layout and mark them as mapped.
+* For all possible SWAP gates, calculate the layout that would result from their application and rank them according to the distance of the resulting layout over upcoming gates (see \_calc\_layout\_distance.)
+* For the four (search\_width) highest-ranking SWAPs, repeat the above process on the layout that would be generated if they were applied.
+* Repeat this process down to a depth of four (search\_depth) SWAPs away from the initial layout, for a total of 256 (search\_width^search\_depth) prospective layouts.
+* Choose the layout which maximizes the number of two-qubit which could be performed. Add its mapped gates, including the SWAPs generated, to the output circuit.
+* Repeat the above until all gates from the initial circuit are mapped.
+
+For more details on the algorithm, see Sven’s blog post: [https://medium.com/qiskit/improving-a-quantum-compiler-48410d7a7084](https://medium.com/qiskit/improving-a-quantum-compiler-48410d7a7084)
+
+LookaheadSwap initializer.
+
+**Parameters**
+
+* **coupling\_map** (*Union\[*[*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")*,* [*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")*]*) – CouplingMap of the target backend.
+* **search\_depth** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – lookahead tree depth when ranking best SWAP options.
+* **search\_width** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – lookahead tree width when ranking best SWAP options.
+* **fake\_run** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if true, it will only pretend to do routing, i.e., no swap is effectively added.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the LookaheadSwap pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – the directed acyclic graph to be mapped
+
+**Returns**
+
+**A dag mapped to be compatible with the coupling\_map in**
+
+the property\_set.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+* [**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if the coupling map or the layout are not
+* **compatible with the DAG**\*\*, or \*\***if the coupling\_map=None** –
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.MergeAdjacentBarriers.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.MergeAdjacentBarriers.md
new file mode 100644
index 00000000000..c48fac3fce6
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.MergeAdjacentBarriers.md
@@ -0,0 +1,138 @@
+---
+title: MergeAdjacentBarriers
+description: API reference for qiskit.transpiler.passes.MergeAdjacentBarriers
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.MergeAdjacentBarriers
+---
+
+# MergeAdjacentBarriers
+
+
+
+`qiskit.transpiler.passes.MergeAdjacentBarriers(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/utils/merge_adjacent_barriers.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Return a circuit with any adjacent barriers merged together.
+
+Only barriers which can be merged without affecting the barrier structure of the DAG will be merged.
+
+Not all redundant barriers will necessarily be merged, only adjacent barriers are merged.
+
+For example, the circuit:
+
+```python
+qr = QuantumRegister(3, 'q')
+circuit = QuantumCircuit(qr)
+circuit.barrier(qr[0])
+circuit.barrier(qr[1])
+circuit.barrier(qr)
+```
+
+Will be transformed into a circuit corresponding to:
+
+```python
+circuit.barrier(qr[0])
+circuit.barrier(qr)
+```
+
+i.e,
+
+```python
+ ░ ░ ░ ░
+q_0: ─░──░─ q_0: ─░──░─
+ ░ ░ ░ ░
+q_1: ─░──░─ => q_1: ────░─
+ ░ ░ ░
+q_2: ────░─ q_2: ────░─
+ ░
+```
+
+after one iteration of the pass. These two barriers were not merged by the first pass as they are not adjacent in the initial circuit.
+
+The pass then can be reapplied to merge the newly adjacent barriers.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the MergeAdjacentBarriers pass on dag.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.MinimumPoint.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.MinimumPoint.md
new file mode 100644
index 00000000000..d7ca0f3f6fc
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.MinimumPoint.md
@@ -0,0 +1,121 @@
+---
+title: MinimumPoint
+description: API reference for qiskit.transpiler.passes.MinimumPoint
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.MinimumPoint
+---
+
+# MinimumPoint
+
+
+
+`qiskit.transpiler.passes.MinimumPoint(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/utils/minimum_point.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Check if the DAG has reached a relative semi-stable point over previous runs
+
+This pass is similar to the [`FixedPoint`](qiskit.transpiler.passes.FixedPoint "qiskit.transpiler.passes.FixedPoint") transpiler pass and is intended primarily to be used to set a loop break condition in the property set. However, unlike the [`FixedPoint`](qiskit.transpiler.passes.FixedPoint "qiskit.transpiler.passes.FixedPoint") class which only sets the condition if 2 consecutive runs have the same value property set value this pass is designed to find a local minimum and use that instead. This pass is designed for an optimization loop where a fixed point may never get reached (for example if synthesis is used and there are multiple equivalent outputs for some cases).
+
+This pass will track the state of fields in the property set over its past executions and set a boolean field when either a fixed point is reached over the backtracking depth or selecting the minimum value found if the backtracking depth is reached. To do this it stores a deep copy of the current minimum DAG in the property set and when `backtrack_depth` number of executions is reached since the last minimum the output dag is set to that copy of the earlier minimum.
+
+Fields used by this pass in the property set are (all relative to the `prefix` argument):
+
+* `{prefix}_minimum_point_state` - Used to track the state of the minimum point search
+
+* **`{prefix}_minimum_point` - This value gets set to `True` when either a fixed point**
+
+ is reached over the `backtrack_depth` executions, or `backtrack_depth` was exceeded and an earlier minimum is restored.
+
+Initialize an instance of this pass
+
+**Parameters**
+
+* **property\_set\_list** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of property set keys that will be used to evaluate the local minimum. The values of these property set keys will be used as a tuple for comparison
+* **prefix** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The prefix to use for the property set key that is used for tracking previous evaluations
+* **backtrack\_depth** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The maximum number of entries to store. If this number is reached and the next iteration doesn’t have a decrease in the number of values the minimum of the previous n will be set as the output dag and `minimum_point` will be set to `True` in the property set
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the MinimumPoint pass on dag.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.NoiseAdaptiveLayout.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.NoiseAdaptiveLayout.md
new file mode 100644
index 00000000000..5fcde96fdca
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.NoiseAdaptiveLayout.md
@@ -0,0 +1,156 @@
+---
+title: NoiseAdaptiveLayout
+description: API reference for qiskit.transpiler.passes.NoiseAdaptiveLayout
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.NoiseAdaptiveLayout
+---
+
+# NoiseAdaptiveLayout
+
+
+
+`qiskit.transpiler.passes.NoiseAdaptiveLayout(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/layout/noise_adaptive_layout.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Choose a noise-adaptive Layout based on current calibration data for the backend.
+
+> This pass associates a physical qubit (int) to each virtual qubit of the circuit (Qubit), using calibration data.
+>
+> The pass implements the qubit mapping method from: Noise-Adaptive Compiler Mappings for Noisy Intermediate-Scale Quantum Computers Prakash Murali, Jonathan M. Baker, Ali Javadi-Abhari, Frederic T. Chong, Margaret R. Martonosi ASPLOS 2019 (arXiv:1901.11054).
+
+`Ordering of edges`
+
+`Map qubits edge-by-edge in the order of decreasing frequency of occurrence in the program dag.`
+
+### Initialization
+
+
+
+`Initialization()`
+
+`If an edge exists with both endpoints unmapped,`
+
+`pick the best available hardware cx to execute this edge.`
+
+`Iterative step`
+
+`When an edge exists with one endpoint unmapped,`
+
+`map that endpoint to a location which allows`
+
+`maximum reliability for CNOTs with previously mapped qubits.`
+
+`In the end if there are unmapped qubits (which don't`
+
+`participate in any CNOT), map them to any available`
+
+`hardware qubit.`
+
+### Notes
+
+
+
+`Notes()`
+
+even though a layout is not strictly a property of the DAG, in the transpiler architecture it is best passed around between passes by being set in property\_set.
+
+NoiseAdaptiveLayout initializer.
+
+
+ The class `qiskit.transpiler.passes.layout.noise_adaptive_layout.NoiseAdaptiveLayout` is deprecated as of qiskit 0.46. It will be removed in the 1.0.0 release.
+
+
+**Parameters**
+
+* **backend\_prop** (*Union\[*[*BackendProperties*](qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties")*,* [*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")*]*) – backend properties object
+* **coupling\_map** ([*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")) – Optional. To filter the backend\_prop qubits/gates. This parameter is ignored if [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") is provided in `backend_prop`. That method is preferred.
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if invalid options
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the NoiseAdaptiveLayout pass on dag.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.NormalizeRXAngle.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.NormalizeRXAngle.md
new file mode 100644
index 00000000000..e895cfae9d2
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.NormalizeRXAngle.md
@@ -0,0 +1,156 @@
+---
+title: NormalizeRXAngle
+description: API reference for qiskit.transpiler.passes.NormalizeRXAngle
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.NormalizeRXAngle
+---
+
+# NormalizeRXAngle
+
+
+
+`qiskit.transpiler.passes.NormalizeRXAngle(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/optimization/normalize_rx_angle.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Normalize theta parameter of RXGate instruction.
+
+The parameter normalization is performed with following steps.
+
+1\) Wrap RX Gate theta into \[0, pi]. When theta is negative value, the gate is decomposed into the following sequence.
+
+```python
+ ┌───────┐┌─────────┐┌────────┐
+q: ┤ Rz(π) ├┤ Rx(|θ|) ├┤ Rz(-π) ├
+ └───────┘└─────────┘└────────┘
+```
+
+2. If the operation is supported by target, convert RX(pi/2) to SX, and RX(pi) to X.
+3. Quantize theta value according to the user-specified resolution.
+
+This will help reduce the size of calibration data sent over the wire, and allow us to exploit the more accurate, hardware-calibrated pulses. Note that pulse calibration might be attached per each rotation angle.
+
+NormalizeRXAngle initializer.
+
+**Parameters**
+
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – The [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") representing the target backend. If the target contains SX and X calibrations, this pass will replace the corresponding RX gates with SX and X gates.
+* **resolution\_in\_radian** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Resolution for RX rotation angle quantization. If set to zero, this pass won’t modify the rotation angles in the given DAG. (=Provides arbitrary-angle RX)
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### quantize\_angles
+
+
+
+`quantize_angles(qubit, original_angle)`
+
+Quantize the RX rotation angles by assigning the same value for the angles that differ within a resolution provided by the user.
+
+**Parameters**
+
+* **qubit** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")) – This will be the dict key to access the list of quantized rotation angles.
+* **original\_angle** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Original rotation angle, before quantization.
+
+**Returns**
+
+Quantized angle.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the NormalizeRXAngle pass on `dag`.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – The DAG to be optimized.
+
+**Returns**
+
+A DAG with RX gate calibration.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.NumTensorFactors.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.NumTensorFactors.md
new file mode 100644
index 00000000000..ea2d6c817a0
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.NumTensorFactors.md
@@ -0,0 +1,103 @@
+---
+title: NumTensorFactors
+description: API reference for qiskit.transpiler.passes.NumTensorFactors
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.NumTensorFactors
+---
+
+# NumTensorFactors
+
+
+
+`qiskit.transpiler.passes.NumTensorFactors(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/analysis/num_tensor_factors.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Calculate the number of tensor factors of a DAG circuit.
+
+The result is saved in `property_set['num_tensor_factors']` as an integer.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the NumTensorFactors pass on dag.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.Optimize1qGates.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Optimize1qGates.md
new file mode 100644
index 00000000000..b961c97c5d1
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Optimize1qGates.md
@@ -0,0 +1,158 @@
+---
+title: Optimize1qGates
+description: API reference for qiskit.transpiler.passes.Optimize1qGates
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.Optimize1qGates
+---
+
+# Optimize1qGates
+
+
+
+`qiskit.transpiler.passes.Optimize1qGates(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/optimization/optimize_1q_gates.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Optimize chains of single-qubit u1, u2, u3 gates by combining them into a single gate.
+
+Optimize1qGates initializer.
+
+**Parameters**
+
+* **basis** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – Basis gates to consider, e.g. \[‘u3’, ‘cx’]. For the effects of this pass, the basis is the set intersection between the basis parameter and the set \{‘u1’,’u2’,’u3’, ‘u’, ‘p’}.
+* **eps** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – EPS to check against
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – The [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") representing the target backend, if both `basis` and `target` are specified then this argument will take precedence and `basis` will be ignored.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### compose\_u3
+
+
+
+`static compose_u3(theta1, phi1, lambda1, theta2, phi2, lambda2)`
+
+Return a triple theta, phi, lambda for the product.
+
+**u3(theta, phi, lambda)**
+
+\= u3(theta1, phi1, lambda1).u3(theta2, phi2, lambda2) = Rz(phi1).Ry(theta1).Rz(lambda1+phi2).Ry(theta2).Rz(lambda2) = Rz(phi1).Rz(phi’).Ry(theta’).Rz(lambda’).Rz(lambda2) = u3(theta’, phi1 + phi’, lambda2 + lambda’)
+
+Return theta, phi, lambda.
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the Optimize1qGates pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – the DAG to be optimized.
+
+**Returns**
+
+the optimized DAG.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if `YZY` and `ZYZ` angles do not give same rotation matrix.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
+### yzy\_to\_zyz
+
+
+
+`static yzy_to_zyz(xi, theta1, theta2, eps=1e-09)`
+
+Express a Y.Z.Y single qubit gate as a Z.Y.Z gate.
+
+Solve the equation
+
+$$
+$$
+
+Ry(theta1).Rz(xi).Ry(theta2) = Rz(phi).Ry(theta).Rz(lambda)
+
+for theta, phi, and lambda.
+
+Return a solution theta, phi, and lambda.
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.Optimize1qGatesDecomposition.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Optimize1qGatesDecomposition.md
new file mode 100644
index 00000000000..82534b0eef4
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Optimize1qGatesDecomposition.md
@@ -0,0 +1,129 @@
+---
+title: Optimize1qGatesDecomposition
+description: API reference for qiskit.transpiler.passes.Optimize1qGatesDecomposition
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.Optimize1qGatesDecomposition
+---
+
+# Optimize1qGatesDecomposition
+
+
+
+`qiskit.transpiler.passes.Optimize1qGatesDecomposition(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/optimization/optimize_1q_decomposition.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Optimize chains of single-qubit gates by combining them into a single gate.
+
+**The decision to replace the original chain with a new re-synthesis depends on:**
+
+* whether the original chain was out of basis: replace
+* whether the original chain was in basis but re-synthesis is lower error: replace
+* whether the original chain contains a pulse gate: do not replace
+* whether the original chain amounts to identity: replace with null
+
+Error is computed as a multiplication of the errors of individual gates on that qubit.
+
+Optimize1qGatesDecomposition initializer.
+
+**Parameters**
+
+* **basis** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – Basis gates to consider, e.g. \[‘u3’, ‘cx’]. For the effects of this pass, the basis is the set intersection between the basis parameter and the Euler basis. Ignored if `target` is also specified.
+* **target** (*Optional\[*[*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")*]*) – The [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object corresponding to the compilation target. When specified, any argument specified for `basis_gates` is ignored.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the Optimize1qGatesDecomposition pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – the DAG to be optimized.
+
+**Returns**
+
+the optimized DAG.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.Optimize1qGatesSimpleCommutation.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Optimize1qGatesSimpleCommutation.md
new file mode 100644
index 00000000000..90dd55fbec6
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Optimize1qGatesSimpleCommutation.md
@@ -0,0 +1,123 @@
+---
+title: Optimize1qGatesSimpleCommutation
+description: API reference for qiskit.transpiler.passes.Optimize1qGatesSimpleCommutation
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.Optimize1qGatesSimpleCommutation
+---
+
+# Optimize1qGatesSimpleCommutation
+
+
+
+`qiskit.transpiler.passes.Optimize1qGatesSimpleCommutation(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/optimization/optimize_1q_commutation.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Optimizes 1Q gate strings interrupted by 2Q gates by commuting the components and resynthesizing the results. The commutation rules are stored in `commutation_table`.
+
+**NOTE: In addition to those mentioned in `commutation_table`, this pass has some limitations:**
+
+* Does not handle multiple commutations in a row without intermediate progress.
+* Can only commute into positions where there are pre-existing runs.
+* Does not exhaustively test all the different ways commuting gates can be assigned to either side of a barrier to try to find low-depth configurations. (This is particularly evident if all the gates in a run commute with both the predecessor and the successor barriers.)
+
+**Parameters**
+
+* **basis** (*List\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – See also Optimize1qGatesDecomposition.
+* **run\_to\_completion** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, this pass retries until it is unable to do any more work. If False, it finds and performs one optimization, and for full optimization the user is obligated to re-call the pass until the output stabilizes.
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – The [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") representing the target backend, if both `basis` and this are specified then this argument will take precedence and `basis` will be ignored.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – the DAG to be optimized.
+
+**Returns**
+
+the optimized DAG.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.OptimizeCliffords.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.OptimizeCliffords.md
new file mode 100644
index 00000000000..5adada50bae
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.OptimizeCliffords.md
@@ -0,0 +1,113 @@
+---
+title: OptimizeCliffords
+description: API reference for qiskit.transpiler.passes.OptimizeCliffords
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.OptimizeCliffords
+---
+
+# OptimizeCliffords
+
+
+
+`qiskit.transpiler.passes.OptimizeCliffords(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/optimization/optimize_cliffords.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Combine consecutive Cliffords over the same qubits. This serves as an example of extra capabilities enabled by storing Cliffords natively on the circuit.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the OptimizeCliffords pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – the DAG to be optimized.
+
+**Returns**
+
+the optimized DAG.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.PadDelay.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.PadDelay.md
new file mode 100644
index 00000000000..8367f23d71a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.PadDelay.md
@@ -0,0 +1,149 @@
+---
+title: PadDelay
+description: API reference for qiskit.transpiler.passes.PadDelay
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.PadDelay
+---
+
+# PadDelay
+
+
+
+`qiskit.transpiler.passes.PadDelay(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/scheduling/padding/pad_delay.py "view source code")
+
+Bases: `BasePadding`
+
+Padding idle time with Delay instructions.
+
+Consecutive delays will be merged in the output of this pass.
+
+```python
+durations = InstructionDurations([("x", None, 160), ("cx", None, 800)])
+
+qc = QuantumCircuit(2)
+qc.delay(100, 0)
+qc.x(1)
+qc.cx(0, 1)
+```
+
+The ASAP-scheduled circuit output may become
+
+```python
+ ┌────────────────┐
+q_0: ┤ Delay(160[dt]) ├──■──
+ └─────┬───┬──────┘┌─┴─┐
+q_1: ──────┤ X ├───────┤ X ├
+ └───┘ └───┘
+```
+
+Note that the additional idle time of 60dt on the `q_0` wire coming from the duration difference between `Delay` of 100dt (`q_0`) and `XGate` of 160 dt (`q_1`) is absorbed in the delay instruction on the `q_0` wire, i.e. in total 160 dt.
+
+See `BasePadding` pass for details.
+
+Create new padding delay pass.
+
+**Parameters**
+
+* **fill\_very\_end** – Set `True` to fill the end of circuit with delay.
+* **target** – The [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") representing the target backend. If it is supplied and does not support delay instruction on a qubit, padding passes do not pad any idle time of the qubit.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the padding pass on `dag`.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")) – DAG to be checked.
+
+**Returns**
+
+DAG with idle time filled with instructions.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – When a particular node is not scheduled, likely some transform pass is inserted before this node is called.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.PadDynamicalDecoupling.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.PadDynamicalDecoupling.md
new file mode 100644
index 00000000000..43f549986c8
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.PadDynamicalDecoupling.md
@@ -0,0 +1,207 @@
+---
+title: PadDynamicalDecoupling
+description: API reference for qiskit.transpiler.passes.PadDynamicalDecoupling
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.PadDynamicalDecoupling
+---
+
+# PadDynamicalDecoupling
+
+
+
+`qiskit.transpiler.passes.PadDynamicalDecoupling(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/scheduling/padding/dynamical_decoupling.py "view source code")
+
+Bases: `BasePadding`
+
+Dynamical decoupling insertion pass.
+
+This pass works on a scheduled, physical circuit. It scans the circuit for idle periods of time (i.e. those containing delay instructions) and inserts a DD sequence of gates in those spots. These gates amount to the identity, so do not alter the logical action of the circuit, but have the effect of mitigating decoherence in those idle periods.
+
+As a special case, the pass allows a length-1 sequence (e.g. `[XGate()]`). In this case the DD insertion happens only when the gate inverse can be absorbed into a neighboring gate in the circuit (so we would still be replacing Delay with something that is equivalent to the identity). This can be used, for instance, as a Hahn echo.
+
+This pass ensures that the inserted sequence preserves the circuit exactly (including global phase).
+
+```python
+import numpy as np
+from qiskit.circuit import QuantumCircuit
+from qiskit.circuit.library import XGate
+from qiskit.transpiler import PassManager, InstructionDurations
+from qiskit.transpiler.passes import ALAPScheduleAnalysis, PadDynamicalDecoupling
+from qiskit.visualization import timeline_drawer
+circ = QuantumCircuit(4)
+circ.h(0)
+circ.cx(0, 1)
+circ.cx(1, 2)
+circ.cx(2, 3)
+circ.measure_all()
+durations = InstructionDurations(
+ [("h", 0, 50), ("cx", [0, 1], 700), ("reset", None, 10),
+ ("cx", [1, 2], 200), ("cx", [2, 3], 300),
+ ("x", None, 50), ("measure", None, 1000)]
+)
+
+# balanced X-X sequence on all qubits
+dd_sequence = [XGate(), XGate()]
+pm = PassManager([ALAPScheduleAnalysis(durations),
+ PadDynamicalDecoupling(durations, dd_sequence)])
+circ_dd = pm.run(circ)
+timeline_drawer(circ_dd)
+
+# Uhrig sequence on qubit 0
+n = 8
+dd_sequence = [XGate()] * n
+def uhrig_pulse_location(k):
+ return np.sin(np.pi * (k + 1) / (2 * n + 2)) ** 2
+spacing = []
+for k in range(n):
+ spacing.append(uhrig_pulse_location(k) - sum(spacing))
+spacing.append(1 - sum(spacing))
+pm = PassManager(
+ [
+ ALAPScheduleAnalysis(durations),
+ PadDynamicalDecoupling(durations, dd_sequence, qubits=[0], spacing=spacing),
+ ]
+)
+circ_dd = pm.run(circ)
+timeline_drawer(circ_dd)
+```
+
+
+
+
+
+
+ You may need to call alignment pass before running dynamical decoupling to guarantee your circuit satisfies acquisition alignment constraints.
+
+
+Dynamical decoupling initializer.
+
+**Parameters**
+
+* **durations** – Durations of instructions to be used in scheduling.
+
+* **dd\_sequence** – Sequence of gates to apply in idle spots.
+
+* **qubits** – Physical qubits on which to apply DD. If None, all qubits will undergo DD (when possible).
+
+* **spacing** – A list of spacings between the DD gates. The available slack will be divided according to this. The list length must be one more than the length of dd\_sequence, and the elements must sum to 1. If None, a balanced spacing will be used \[d/2, d, d, …, d, d, d/2].
+
+* **skip\_reset\_qubits** – If True, does not insert DD on idle periods that immediately follow initialized/reset qubits (as qubits in the ground state are less susceptile to decoherence).
+
+* **pulse\_alignment** – The hardware constraints for gate timing allocation. This is usually provided from `backend.configuration().timing_constraints`. If provided, the delay length, i.e. `spacing`, is implicitly adjusted to satisfy this constraint.
+
+* **extra\_slack\_distribution** –
+
+ The option to control the behavior of DD sequence generation. The duration of the DD sequence should be identical to an idle time in the scheduled quantum circuit, however, the delay in between gates comprising the sequence should be integer number in units of dt, and it might be further truncated when `pulse_alignment` is specified. This sometimes results in the duration of the created sequence being shorter than the idle time that you want to fill with the sequence, i.e. extra slack. This option takes following values.
+
+ > * ”middle”: Put the extra slack to the interval at the middle of the sequence.
+ > * ”edges”: Divide the extra slack as evenly as possible into intervals at beginning and end of the sequence.
+
+* **target** – The [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") representing the target backend, if both `durations` and this are specified then this argument will take precedence and `durations` will be ignored.
+
+**Raises**
+
+* [**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – When invalid DD sequence is specified.
+* [**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – When pulse gate with the duration which is non-multiple of the alignment constraint value is found.
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – If `dd_sequence` is not specified
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the padding pass on `dag`.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")) – DAG to be checked.
+
+**Returns**
+
+DAG with idle time filled with instructions.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – When a particular node is not scheduled, likely some transform pass is inserted before this node is called.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.PulseGates.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.PulseGates.md
new file mode 100644
index 00000000000..4ca7833a085
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.PulseGates.md
@@ -0,0 +1,178 @@
+---
+title: PulseGates
+description: API reference for qiskit.transpiler.passes.PulseGates
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.PulseGates
+---
+
+# PulseGates
+
+
+
+`qiskit.transpiler.passes.PulseGates(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/calibration/pulse_gate.py "view source code")
+
+Bases: `CalibrationBuilder`
+
+Pulse gate adding pass.
+
+This pass adds gate calibrations from the supplied `InstructionScheduleMap` to a quantum circuit.
+
+This pass checks each DAG circuit node and acquires a corresponding schedule from the instruction schedule map object that may be provided by the target backend. Because this map is a mutable object, the end-user can provide a configured backend to execute the circuit with customized gate implementations.
+
+This mapping object returns a schedule with “publisher” metadata which is an integer Enum value representing who created the gate schedule. If the gate schedule is provided by end-users, this pass attaches the schedule to the DAG circuit as a calibration.
+
+This pass allows users to easily override quantum circuit with custom gate definitions without directly dealing with those schedules.
+
+**References**
+
+* \[1] OpenQASM 3: A broader and deeper quantum assembly language [https://arxiv.org/abs/2104.14722](https://arxiv.org/abs/2104.14722)
+
+Create new pass.
+
+**Parameters**
+
+* **inst\_map** – Instruction schedule map that user may override.
+* **target** – The [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") representing the target backend, if both `inst_map` and `target` are specified then it updates instructions in the `target` with `inst_map`.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### get\_calibration
+
+
+
+`get_calibration(node_op, qubits)`
+
+Gets the calibrated schedule for the given instruction and qubits.
+
+**Parameters**
+
+* **node\_op** ([*Instruction*](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")) – Target instruction object.
+* **qubits** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")) – Integer qubit indices to check.
+
+**Returns**
+
+Return Schedule of target gate instruction.
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – When node is parameterized and calibration is raw schedule object.
+
+**Return type**
+
+[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule") | [*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock")
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the calibration adder pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")) – DAG to schedule.
+
+**Returns**
+
+A DAG with calibrations added to it.
+
+**Return type**
+
+[*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")
+
+### supported
+
+
+
+`supported(node_op, qubits)`
+
+Determine if a given node supports the calibration.
+
+**Parameters**
+
+* **node\_op** ([*Instruction*](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")) – Target instruction object.
+* **qubits** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")) – Integer qubit indices to check.
+
+**Returns**
+
+Return `True` is calibration can be provided.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.RXCalibrationBuilder.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.RXCalibrationBuilder.md
new file mode 100644
index 00000000000..6f724095bd2
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.RXCalibrationBuilder.md
@@ -0,0 +1,187 @@
+---
+title: RXCalibrationBuilder
+description: API reference for qiskit.transpiler.passes.RXCalibrationBuilder
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.RXCalibrationBuilder
+---
+
+# RXCalibrationBuilder
+
+
+
+`qiskit.transpiler.passes.RXCalibrationBuilder(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/calibration/rx_builder.py "view source code")
+
+Bases: `CalibrationBuilder`
+
+Add single-pulse RX calibrations that are bootstrapped from the SX calibration.
+
+
+ Requirement: NormalizeRXAngles pass (one of the optimization passes).
+
+
+It is recommended to place this pass in the post-optimization stage of a passmanager. A simple demo:
+
+```python
+from qiskit.providers.fake_provider import FakeBelemV2
+from qiskit.transpiler import PassManager, PassManagerConfig
+from qiskit.transpiler.preset_passmanagers import level_1_pass_manager
+from qiskit.circuit import Parameter
+from qiskit.circuit.library import QuantumVolume
+from qiskit.circuit.library.standard_gates import RXGate
+
+from calibration.rx_builder import RXCalibrationBuilder
+
+qv = QuantumVolume(4, 4, seed=1004)
+
+# Transpiling with single pulse RX gates enabled
+backend_with_single_pulse_rx = FakeBelemV2()
+rx_inst_props = {}
+for i in range(backend_with_single_pulse_rx.num_qubits):
+ rx_inst_props[(i,)] = None
+backend_with_single_pulse_rx.target.add_instruction(RXGate(Parameter("theta")), rx_inst_props)
+config_with_rx = PassManagerConfig.from_backend(backend=backend_with_single_pulse_rx)
+pm_with_rx = level_1_pass_manager(pass_manager_config=config_with_rx)
+rx_builder = RXCalibrationBuilder(target=backend_with_single_pulse_rx.target)
+pm_with_rx.post_optimization = PassManager([rx_builder])
+transpiled_circ_with_single_pulse_rx = pm_with_rx.run(qv)
+transpiled_circ_with_single_pulse_rx.count_ops()
+
+# Conventional transpilation: each RX gate is decomposed into a sequence with two SX gates
+original_backend = FakeBelemV2()
+original_config = PassManagerConfig.from_backend(backend=original_backend)
+original_pm = level_1_pass_manager(pass_manager_config=original_config)
+original_transpiled_circ = original_pm.run(qv)
+original_transpiled_circ.count_ops()
+```
+
+**References**
+
+* \[1]: Gokhale et al. (2020), Optimized Quantum Compilation for Near-Term Algorithms with OpenPulse. arXiv:2004.11205 \<[https://arxiv.org/abs/2004.11205](https://arxiv.org/abs/2004.11205)>
+
+Bootstrap single-pulse RX gate calibrations from the (hardware-calibrated) SX gate calibration.
+
+**Parameters**
+
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – Should contain a SX calibration that will be
+* **calibrations.** (*used for bootstrapping RX*) –
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### get\_calibration
+
+
+
+`get_calibration(node_op, qubits)`
+
+Generate RX calibration for the rotation angle specified in node\_op.
+
+**Return type**
+
+[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule") | [*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock")
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the calibration adder pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")) – DAG to schedule.
+
+**Returns**
+
+A DAG with calibrations added to it.
+
+**Return type**
+
+[*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")
+
+### supported
+
+
+
+`supported(node_op, qubits)`
+
+Check if the calibration for SX gate exists and it’s a single DRAG pulse.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.RZXCalibrationBuilder.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.RZXCalibrationBuilder.md
new file mode 100644
index 00000000000..6077af8f5fc
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.RZXCalibrationBuilder.md
@@ -0,0 +1,199 @@
+---
+title: RZXCalibrationBuilder
+description: API reference for qiskit.transpiler.passes.RZXCalibrationBuilder
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.RZXCalibrationBuilder
+---
+
+# RZXCalibrationBuilder
+
+
+
+`qiskit.transpiler.passes.RZXCalibrationBuilder(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/calibration/rzx_builder.py "view source code")
+
+Bases: `CalibrationBuilder`
+
+Creates calibrations for RZXGate(theta) by stretching and compressing Gaussian square pulses in the CX gate. This is done by retrieving (for a given pair of qubits) the CX schedule in the instruction schedule map of the backend defaults. The CX schedule must be an echoed cross-resonance gate optionally with rotary tones. The cross-resonance drive tones and rotary pulses must be Gaussian square pulses. The width of the Gaussian square pulse is adjusted so as to match the desired rotation angle. If the rotation angle is small such that the width disappears then the amplitude of the zero width Gaussian square pulse (i.e. a Gaussian) is reduced to reach the target rotation angle. Additional details can be found in [https://arxiv.org/abs/2012.11660](https://arxiv.org/abs/2012.11660).
+
+Initializes a RZXGate calibration builder.
+
+**Parameters**
+
+* **instruction\_schedule\_map** – The `InstructionScheduleMap` object representing the default pulse calibrations for the target backend
+* **verbose** – Set True to raise a user warning when RZX schedule cannot be built.
+* **target** – The [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") representing the target backend, if both `instruction_schedule_map` and this are specified then this argument will take precedence and `instruction_schedule_map` will be ignored.
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – Instruction schedule map is not provided.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### get\_calibration
+
+
+
+`get_calibration(node_op, qubits)`
+
+Builds the calibration schedule for the RZXGate(theta) with echos.
+
+**Parameters**
+
+* **node\_op** (*CircuitInst*) – Instruction of the RZXGate(theta). I.e. params\[0] is theta.
+* **qubits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – List of qubits for which to get the schedules. The first qubit is the control and the second is the target.
+
+**Returns**
+
+The calibration schedule for the RZXGate(theta).
+
+**Return type**
+
+schedule
+
+**Raises**
+
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if rotation angle is not assigned.
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If the control and target qubits cannot be identified.
+* **CalibrationNotAvailable** – RZX schedule cannot be built for input node.
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### rescale\_cr\_inst
+
+
+
+`static rescale_cr_inst(instruction, theta, sample_mult=16)`
+
+A builder macro to play stretched pulse.
+
+**Parameters**
+
+* **instruction** ([*Play*](qiskit.pulse.instructions.Play "qiskit.pulse.instructions.play.Play")) – The instruction from which to create a new shortened or lengthened pulse.
+* **theta** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – desired angle, pi/2 is assumed to be the angle that the pulse in the given play instruction implements.
+* **sample\_mult** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – All pulses must be a multiple of sample\_mult.
+
+**Returns**
+
+Duration of stretched pulse.
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if rotation angle is not assigned.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the calibration adder pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")) – DAG to schedule.
+
+**Returns**
+
+A DAG with calibrations added to it.
+
+**Return type**
+
+[*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")
+
+### supported
+
+
+
+`supported(node_op, qubits)`
+
+Determine if a given node supports the calibration.
+
+**Parameters**
+
+* **node\_op** ([*Instruction*](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")) – Target instruction object.
+* **qubits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – Integer qubit indices to check.
+
+**Returns**
+
+Return `True` is calibration can be provided.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.RZXCalibrationBuilderNoEcho.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.RZXCalibrationBuilderNoEcho.md
new file mode 100644
index 00000000000..fe8213e1c4e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.RZXCalibrationBuilderNoEcho.md
@@ -0,0 +1,201 @@
+---
+title: RZXCalibrationBuilderNoEcho
+description: API reference for qiskit.transpiler.passes.RZXCalibrationBuilderNoEcho
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.RZXCalibrationBuilderNoEcho
+---
+
+# RZXCalibrationBuilderNoEcho
+
+
+
+`qiskit.transpiler.passes.RZXCalibrationBuilderNoEcho(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/calibration/rzx_builder.py "view source code")
+
+Bases: [`RZXCalibrationBuilder`](qiskit.transpiler.passes.RZXCalibrationBuilder "qiskit.transpiler.passes.calibration.rzx_builder.RZXCalibrationBuilder")
+
+Creates calibrations for RZXGate(theta) by stretching and compressing Gaussian square pulses in the CX gate.
+
+The `RZXCalibrationBuilderNoEcho` is a variation of the [`RZXCalibrationBuilder`](qiskit.transpiler.passes.RZXCalibrationBuilder "qiskit.transpiler.passes.RZXCalibrationBuilder") pass that creates calibrations for the cross-resonance pulses without inserting the echo pulses in the pulse schedule. This enables exposing the echo in the cross-resonance sequence as gates so that the transpiler can simplify them. The `RZXCalibrationBuilderNoEcho` only supports the hardware-native direction of the CX gate.
+
+Initializes a RZXGate calibration builder.
+
+**Parameters**
+
+* **instruction\_schedule\_map** – The `InstructionScheduleMap` object representing the default pulse calibrations for the target backend
+* **verbose** – Set True to raise a user warning when RZX schedule cannot be built.
+* **target** – The [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") representing the target backend, if both `instruction_schedule_map` and this are specified then this argument will take precedence and `instruction_schedule_map` will be ignored.
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – Instruction schedule map is not provided.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### get\_calibration
+
+
+
+`get_calibration(node_op, qubits)`
+
+Builds the calibration schedule for the RZXGate(theta) without echos.
+
+**Parameters**
+
+* **node\_op** (*CircuitInst*) – Instruction of the RZXGate(theta). I.e. params\[0] is theta.
+* **qubits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – List of qubits for which to get the schedules. The first qubit is the control and the second is the target.
+
+**Returns**
+
+The calibration schedule for the RZXGate(theta).
+
+**Return type**
+
+schedule
+
+**Raises**
+
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if rotation angle is not assigned.
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If the control and target qubits cannot be identified, or the backend does not natively support the specified direction of the cx.
+* **CalibrationNotAvailable** – RZX schedule cannot be built for input node.
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### rescale\_cr\_inst
+
+
+
+`static rescale_cr_inst(instruction, theta, sample_mult=16)`
+
+A builder macro to play stretched pulse.
+
+**Parameters**
+
+* **instruction** ([*Play*](qiskit.pulse.instructions.Play "qiskit.pulse.instructions.play.Play")) – The instruction from which to create a new shortened or lengthened pulse.
+* **theta** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – desired angle, pi/2 is assumed to be the angle that the pulse in the given play instruction implements.
+* **sample\_mult** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – All pulses must be a multiple of sample\_mult.
+
+**Returns**
+
+Duration of stretched pulse.
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if rotation angle is not assigned.
+
+**Return type**
+
+[int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the calibration adder pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")) – DAG to schedule.
+
+**Returns**
+
+A DAG with calibrations added to it.
+
+**Return type**
+
+[*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")
+
+### supported
+
+
+
+`supported(node_op, qubits)`
+
+Determine if a given node supports the calibration.
+
+**Parameters**
+
+* **node\_op** ([*Instruction*](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction")) – Target instruction object.
+* **qubits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – Integer qubit indices to check.
+
+**Returns**
+
+Return `True` is calibration can be provided.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.RemoveBarriers.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.RemoveBarriers.md
new file mode 100644
index 00000000000..a4249a78175
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.RemoveBarriers.md
@@ -0,0 +1,124 @@
+---
+title: RemoveBarriers
+description: API reference for qiskit.transpiler.passes.RemoveBarriers
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.RemoveBarriers
+---
+
+# RemoveBarriers
+
+
+
+`qiskit.transpiler.passes.RemoveBarriers(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/utils/remove_barriers.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Return a circuit with any barrier removed.
+
+This transformation is not semantics preserving.
+
+**Example**
+
+```python
+from qiskit import QuantumCircuit
+from qiskit.transpiler.passes import RemoveBarriers
+
+circuit = QuantumCircuit(1)
+circuit.x(0)
+circuit.barrier()
+circuit.h(0)
+
+circuit = RemoveBarriers()(circuit)
+circuit.draw('mpl')
+```
+
+
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the RemoveBarriers pass on dag.
+
+**Return type**
+
+[*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.RemoveDiagonalGatesBeforeMeasure.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.RemoveDiagonalGatesBeforeMeasure.md
new file mode 100644
index 00000000000..dbff6dac4d6
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.RemoveDiagonalGatesBeforeMeasure.md
@@ -0,0 +1,115 @@
+---
+title: RemoveDiagonalGatesBeforeMeasure
+description: API reference for qiskit.transpiler.passes.RemoveDiagonalGatesBeforeMeasure
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.RemoveDiagonalGatesBeforeMeasure
+---
+
+# RemoveDiagonalGatesBeforeMeasure
+
+
+
+`qiskit.transpiler.passes.RemoveDiagonalGatesBeforeMeasure(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/optimization/remove_diagonal_gates_before_measure.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Remove diagonal gates (including diagonal 2Q gates) before a measurement.
+
+Transpiler pass to remove diagonal gates (like RZ, T, Z, etc) before a measurement. Including diagonal 2Q gates.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the RemoveDiagonalGatesBeforeMeasure pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – the DAG to be optimized.
+
+**Returns**
+
+the optimized DAG.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.RemoveFinalMeasurements.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.RemoveFinalMeasurements.md
new file mode 100644
index 00000000000..1290c6effa1
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.RemoveFinalMeasurements.md
@@ -0,0 +1,117 @@
+---
+title: RemoveFinalMeasurements
+description: API reference for qiskit.transpiler.passes.RemoveFinalMeasurements
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.RemoveFinalMeasurements
+---
+
+# RemoveFinalMeasurements
+
+
+
+`qiskit.transpiler.passes.RemoveFinalMeasurements(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/utils/remove_final_measurements.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Remove final measurements and barriers at the end of a circuit.
+
+This pass removes final barriers and final measurements, as well as all unused classical registers and bits they are connected to. Measurements and barriers are considered final if they are followed by no other operations (aside from other measurements or barriers.)
+
+Classical registers are removed iff they reference at least one bit that has become unused by the circuit as a result of the operation, and all of their other bits are also unused. Separately, classical bits are removed iff they have become unused by the circuit as a result of the operation, or they appear in a removed classical register, but do not appear in a classical register that will remain.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the RemoveFinalMeasurements pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – the DAG to be optimized.
+
+**Returns**
+
+the optimized DAG.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.RemoveResetInZeroState.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.RemoveResetInZeroState.md
new file mode 100644
index 00000000000..bc6e9e5e98d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.RemoveResetInZeroState.md
@@ -0,0 +1,113 @@
+---
+title: RemoveResetInZeroState
+description: API reference for qiskit.transpiler.passes.RemoveResetInZeroState
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.RemoveResetInZeroState
+---
+
+# RemoveResetInZeroState
+
+
+
+`qiskit.transpiler.passes.RemoveResetInZeroState(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/optimization/remove_reset_in_zero_state.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Remove reset gate when the qubit is in zero state.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the RemoveResetInZeroState pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – the DAG to be optimized.
+
+**Returns**
+
+the optimized DAG.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.ResetAfterMeasureSimplification.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.ResetAfterMeasureSimplification.md
new file mode 100644
index 00000000000..97c2ebc6fe9
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.ResetAfterMeasureSimplification.md
@@ -0,0 +1,103 @@
+---
+title: ResetAfterMeasureSimplification
+description: API reference for qiskit.transpiler.passes.ResetAfterMeasureSimplification
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.ResetAfterMeasureSimplification
+---
+
+# ResetAfterMeasureSimplification
+
+
+
+`qiskit.transpiler.passes.ResetAfterMeasureSimplification(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/optimization/reset_after_measure_simplification.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+This pass replaces reset after measure with a conditional X gate.
+
+This optimization is suitable for use on IBM Quantum systems where the reset operation is performed by a measurement followed by a conditional x-gate. It might not be desirable on other backends if reset is implemented differently.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the pass on a dag.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.SabreLayout.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.SabreLayout.md
new file mode 100644
index 00000000000..eae67a11425
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.SabreLayout.md
@@ -0,0 +1,213 @@
+---
+title: SabreLayout
+description: API reference for qiskit.transpiler.passes.SabreLayout
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.SabreLayout
+---
+
+# SabreLayout
+
+
+
+`qiskit.transpiler.passes.SabreLayout(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/layout/sabre_layout.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Choose a Layout via iterative bidirectional routing of the input circuit.
+
+Starting with a random initial Layout, the algorithm does a full routing of the circuit (via the routing\_pass method) to end up with a final\_layout. This final\_layout is then used as the initial\_layout for routing the reverse circuit. The algorithm iterates a number of times until it finds an initial\_layout that reduces full routing cost.
+
+This method exploits the reversibility of quantum circuits, and tries to include global circuit information in the choice of initial\_layout.
+
+By default, this pass will run both layout and routing and will transform the circuit so that the layout is applied to the input dag (meaning that the output circuit will have ancilla qubits allocated for unused qubits on the coupling map and the qubits will be reordered to match the mapped physical qubits) and then routing will be applied (inserting `AnalysisPass` objects and just find an initial layout and set that on the property set. This is done because by default the pass will run parallel seed trials with different random seeds for selecting the random initial layout and then selecting the routed output which results in the least number of swap gates needed.
+
+You can use the `routing_pass` argument to have this pass operate as a typical layout pass. When specified this will use the specified routing pass to select an initial layout only and will not run multiple seed trials.
+
+In addition to starting with a random initial Layout the pass can also take in an additional list of starting layouts which will be used for additional trials. If the `sabre_starting_layouts` is present in the property set when this pass is run, that will be used for additional trials. There will still be `layout_trials` of full random starting layouts run and the contents of `sabre_starting_layouts` will be run in addition to those. The output which results in the lowest amount of swap gates (whether from the random trials or the property set starting point) will be used. The value for this property set field should be a list of [`Layout`](qiskit.transpiler.Layout "qiskit.transpiler.Layout") objects representing the starting layouts to use. If a virtual qubit is missing from an [`Layout`](qiskit.transpiler.Layout "qiskit.transpiler.Layout") object in the list a random qubit will be selected.
+
+## Property Set Fields Read
+
+**`sabre_starting_layouts` (`list[Layout]`)**
+
+An optional list of [`Layout`](qiskit.transpiler.Layout "qiskit.transpiler.Layout") objects to use for additional layout trials. This is in addition to the full random trials specified with the `layout_trials` argument.
+
+## Property Set Values Written
+
+**`layout` ([`Layout`](qiskit.transpiler.Layout "qiskit.transpiler.Layout"))**
+
+The chosen initial mapping of virtual to physical qubits, including the ancilla allocation.
+
+**`final_layout` ([`Layout`](qiskit.transpiler.Layout "qiskit.transpiler.Layout"))**
+
+A permutation of how swaps have been applied to the input qubits at the end of the circuit.
+
+**References:**
+
+\[1] Li, Gushu, Yufei Ding, and Yuan Xie. “Tackling the qubit mapping problem for NISQ-era quantum devices.” ASPLOS 2019. [arXiv:1809.02573](https://arxiv.org/pdf/1809.02573.pdf)
+
+SabreLayout initializer.
+
+**param coupling\_map**
+
+directed graph representing a coupling map.
+
+**type coupling\_map**
+
+Union\[CouplingMap, Target]
+
+**param routing\_pass**
+
+the routing pass to use while iterating. If specified this pass operates as an [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.AnalysisPass") and will only populate the `layout` field in the property set and the input dag is returned unmodified. This argument is mutually exclusive with the `swap_trials` and the `layout_trials` arguments and if this is specified at the same time as either argument an error will be raised.
+
+**type routing\_pass**
+
+BasePass
+
+**param seed**
+
+seed for setting a random first trial layout.
+
+**type seed**
+
+int
+
+**param max\_iterations**
+
+number of forward-backward iterations.
+
+**type max\_iterations**
+
+int
+
+**param swap\_trials**
+
+The number of trials to run of [`SabreSwap`](qiskit.transpiler.passes.SabreSwap "qiskit.transpiler.passes.SabreSwap") for each iteration. This is equivalent to the `trials` argument on [`SabreSwap`](qiskit.transpiler.passes.SabreSwap "qiskit.transpiler.passes.SabreSwap"). If this is not specified (and `routing_pass` isn’t set) by default the number of physical CPUs on your local system will be used. For reproducibility between environments it is best to set this to an explicit number because the output will potentially depend on the number of trials run. This option is mutually exclusive with the `routing_pass` argument and an error will be raised if both are used.
+
+**type swap\_trials**
+
+int
+
+**param layout\_trials**
+
+The number of random seed trials to run layout with. When > 1 the trial that resuls in the output with the fewest swap gates will be selected. If this is not specified (and `routing_pass` is not set) then the number of local physical CPUs will be used as the default value. This option is mutually exclusive with the `routing_pass` argument and an error will be raised if both are used.
+
+**type layout\_trials**
+
+int
+
+**param skip\_routing**
+
+If this is set `True` and `routing_pass` is not used then routing will not be applied to the output circuit. Only the layout will be set in the property set. This is a tradeoff to run custom routing with multiple layout trials, as using this option will cause SabreLayout to run the routing stage internally but not use that result.
+
+**type skip\_routing**
+
+bool
+
+**raises TranspilerError**
+
+If both `routing_pass` and `swap_trials` or
+
+**raises both `routing_pass` and `layout_trials` are specified**
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the SabreLayout pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – DAG to find layout for.
+
+**Returns**
+
+**The output dag if swap mapping was run**
+
+(otherwise the input dag is returned unmodified).
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if dag wider than self.coupling\_map
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.SabrePreLayout.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.SabrePreLayout.md
new file mode 100644
index 00000000000..9bd5a6555b6
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.SabrePreLayout.md
@@ -0,0 +1,171 @@
+---
+title: SabrePreLayout
+description: API reference for qiskit.transpiler.passes.SabrePreLayout
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.SabrePreLayout
+---
+
+# SabrePreLayout
+
+
+
+`qiskit.transpiler.passes.SabrePreLayout(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/layout/sabre_pre_layout.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Choose a starting layout to use for additional Sabre layout trials.
+
+## Property Set Values Written
+
+**`sabre_starting_layouts` (`list[Layout]`)**
+
+An optional list of [`Layout`](qiskit.transpiler.Layout "qiskit.transpiler.Layout") objects to use for additional Sabre layout trials.
+
+SabrePreLayout initializer.
+
+The pass works by augmenting the coupling map with more and more “extra” edges until VF2 succeeds to find a perfect graph isomorphism. More precisely, the augmented coupling map contains edges between nodes that are within a given distance `d` in the original coupling map, and the value of `d` is increased until an isomorphism is found.
+
+Intuitively, a better layout involves fewer extra edges. The pass also optionally minimizes the number of extra edges involved in the layout until a local minimum is found. This involves removing extra edges and running VF2 to see if an isomorphism still exists.
+
+**param coupling\_map**
+
+directed graph representing the original coupling map or a target modelling the backend (including its connectivity).
+
+**type coupling\_map**
+
+Union\[CouplingMap, Target]
+
+**param max\_distance**
+
+the maximum distance to consider for augmented coupling maps.
+
+**type max\_distance**
+
+int
+
+**param error\_rate**
+
+the error rate to assign to the “extra” edges. A non-zero error rate prioritizes VF2 to choose original edges over extra edges.
+
+**type error\_rate**
+
+float
+
+**param max\_trials\_vf2**
+
+specifies the maximum number of VF2 trials. A larger number allows VF2 to explore more layouts, eventually choosing the one with the smallest error rate.
+
+**type max\_trials\_vf2**
+
+int
+
+**param call\_limit\_vf2**
+
+limits each call to VF2 by bounding the number of VF2 state visits.
+
+**type call\_limit\_vf2**
+
+int
+
+**param improve\_layout**
+
+whether to improve the layout by minimizing the number of extra edges involved. This might be time-consuming as this requires additional VF2 calls.
+
+**type improve\_layout**
+
+bool
+
+**raises TranspilerError**
+
+At runtime, if neither `coupling_map` or `target` are provided.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the SabrePreLayout pass on dag.
+
+The discovered starting layout is written to the property set value `sabre_starting_layouts`.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – DAG to create starting layout for.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.SabreSwap.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.SabreSwap.md
new file mode 100644
index 00000000000..5ae0a1a749d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.SabreSwap.md
@@ -0,0 +1,178 @@
+---
+title: SabreSwap
+description: API reference for qiskit.transpiler.passes.SabreSwap
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.SabreSwap
+---
+
+# SabreSwap
+
+
+
+`qiskit.transpiler.passes.SabreSwap(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/routing/sabre_swap.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Map input circuit onto a backend topology via insertion of SWAPs.
+
+Implementation of the SWAP-based heuristic search from the SABRE qubit mapping paper \[1] (Algorithm 1). The heuristic aims to minimize the number of lossy SWAPs inserted and the depth of the circuit.
+
+This algorithm starts from an initial layout of virtual qubits onto physical qubits, and iterates over the circuit DAG until all gates are exhausted, inserting SWAPs along the way. It only considers 2-qubit gates as only those are germane for the mapping problem (it is assumed that 3+ qubit gates are already decomposed).
+
+In each iteration, it will first check if there are any gates in the `front_layer` that can be directly applied. If so, it will apply them and remove them from `front_layer`, and replenish that layer with new gates if possible. Otherwise, it will try to search for SWAPs, insert the SWAPs, and update the mapping.
+
+The search for SWAPs is restricted, in the sense that we only consider physical qubits in the neighborhood of those qubits involved in `front_layer`. These give rise to a `swap_candidate_list` which is scored according to some heuristic cost function. The best SWAP is implemented and `current_layout` updated.
+
+This transpiler pass adds onto the SABRE algorithm in that it will run multiple trials of the algorithm with different seeds. The best output, determined by the trial with the least amount of SWAPed inserted, will be selected from the random trials.
+
+**References:**
+
+\[1] Li, Gushu, Yufei Ding, and Yuan Xie. “Tackling the qubit mapping problem for NISQ-era quantum devices.” ASPLOS 2019. [arXiv:1809.02573](https://arxiv.org/pdf/1809.02573.pdf)
+
+SabreSwap initializer.
+
+**Parameters**
+
+* **coupling\_map** (*Union\[*[*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")*,* [*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")*]*) – CouplingMap of the target backend.
+* **heuristic** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The type of heuristic to use when deciding best swap strategy (‘basic’ or ‘lookahead’ or ‘decay’).
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – random seed used to tie-break among candidate swaps.
+* **fake\_run** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if true, it only pretend to do routing, i.e., no swap is effectively added.
+* **trials** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of seed trials to run sabre with. These will be run in parallel (unless the PassManager is already running in parallel). If not specified this defaults to the number of physical CPUs on the local system. For reproducible results it is recommended that you set this explicitly, as the output will be deterministic for a fixed number of trials.
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – If the specified heuristic is not valid.
+
+Additional Information:
+
+> The search space of possible SWAPs on physical qubits is explored by assigning a score to the layout that would result from each SWAP. The goodness of a layout is evaluated based on how viable it makes the remaining virtual gates that must be applied. A few heuristic cost functions are supported
+>
+> * ‘basic’:
+>
+> The sum of distances for corresponding physical qubits of interacting virtual qubits in the front\_layer.
+>
+> $$
+> H_{basic} = \sum_{gate \in F} D[\pi(gate.q_1)][\pi(gate.q2)]
+> $$
+>
+> * ‘lookahead’:
+>
+> This is the sum of two costs: first is the same as the basic cost. Second is the basic cost but now evaluated for the extended set as well (i.e. $|E|$ number of upcoming successors to gates in front\_layer F). This is weighted by some amount EXTENDED\_SET\_WEIGHT (W) to signify that upcoming gates are less important that the front\_layer.
+>
+> $$
+> H_{decay}=\frac{1}{\left|{F}\right|}\sum_{gate \in F} D[\pi(gate.q_1)][\pi(gate.q2)]
+> + W*\frac{1}{\left|{E}\right|} \sum_{gate \in E} D[\pi(gate.q_1)][\pi(gate.q2)]
+> $$
+>
+> * ‘decay’:
+>
+> This is the same as ‘lookahead’, but the whole cost is multiplied by a decay factor. This increases the cost if the SWAP that generated the trial layout was recently used (i.e. it penalizes increase in depth).
+>
+> $$
+> H_{decay} = max(decay(SWAP.q_1), decay(SWAP.q_2)) {
+> \frac{1}{\left|{F}\right|} \sum_{gate \in F} D[\pi(gate.q_1)][\pi(gate.q2)]\\
+> + W *\frac{1}{\left|{E}\right|} \sum_{gate \in E} D[\pi(gate.q_1)][\pi(gate.q2)]
+> }
+> $$
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the SabreSwap pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – the directed acyclic graph to be mapped.
+
+**Returns**
+
+A dag mapped to be compatible with the coupling\_map.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+* [**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if the coupling map or the layout are not
+* **compatible with the DAG**\*\*, or \*\***if the coupling\_map=None** –
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.SetIOLatency.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.SetIOLatency.md
new file mode 100644
index 00000000000..e72663345e8
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.SetIOLatency.md
@@ -0,0 +1,116 @@
+---
+title: SetIOLatency
+description: API reference for qiskit.transpiler.passes.SetIOLatency
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.SetIOLatency
+---
+
+# SetIOLatency
+
+
+
+`qiskit.transpiler.passes.SetIOLatency(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/scheduling/scheduling/set_io_latency.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Set IOLatency information to the input circuit.
+
+The `clbit_write_latency` and `conditional_latency` are added to the property set of pass manager. This information can be shared among the passes that perform scheduling on instructions acting on classical registers.
+
+Once these latencies are added to the property set, this information is also copied to the output circuit object as protected attributes, so that it can be utilized outside the transpilation, for example, the timeline visualization can use latency to accurately show time occupation by instructions on the classical registers.
+
+Create pass with latency information.
+
+**Parameters**
+
+* **clbit\_write\_latency** – A control flow constraints. Because standard superconducting quantum processor implement dispersive QND readout, the actual data transfer to the clbit happens after the round-trip stimulus signal is buffered and discriminated into quantum state. The interval `[t0, t0 + clbit_write_latency]` is regarded as idle time for clbits associated with the measure instruction. This defaults to 0 dt which is identical to Qiskit Pulse scheduler.
+* **conditional\_latency** – A control flow constraints. This value represents a latency of reading a classical register for the conditional operation. The gate operation occurs after this latency. This appears as a delay in front of the DAGOpNode of the gate. This defaults to 0 dt.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Add IO latency information.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")) – Input DAG circuit.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.SetLayout.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.SetLayout.md
new file mode 100644
index 00000000000..424bc58d081
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.SetLayout.md
@@ -0,0 +1,126 @@
+---
+title: SetLayout
+description: API reference for qiskit.transpiler.passes.SetLayout
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.SetLayout
+---
+
+# SetLayout
+
+
+
+`qiskit.transpiler.passes.SetLayout(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/layout/set_layout.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Set the `layout` property to the given layout.
+
+This pass associates a physical qubit (int) to each virtual qubit of the circuit (Qubit) in increasing order.
+
+SetLayout initializer.
+
+**Parameters**
+
+**layout** ([*Layout*](qiskit.transpiler.Layout "qiskit.transpiler.Layout") *or List\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) –
+
+the layout to set. It can be:
+
+* a `Layout` instance: sets that layout.
+* a list of integers: takes the index in the list as the physical position in which the virtual qubit is going to be mapped.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the SetLayout pass on `dag`.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – DAG to map.
+
+**Returns**
+
+the original DAG.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.Size.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Size.md
new file mode 100644
index 00000000000..7af39522547
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Size.md
@@ -0,0 +1,107 @@
+---
+title: Size
+description: API reference for qiskit.transpiler.passes.Size
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.Size
+---
+
+# Size
+
+
+
+`qiskit.transpiler.passes.Size(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/analysis/size.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Calculate the size of a DAG circuit.
+
+The result is saved in `property_set['size']` as an integer.
+
+**Parameters**
+
+**recurse** – whether to allow recursion into control flow. If this is `False` (default), the pass will throw an error when control flow is present, to avoid returning a number with little meaning.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the Size pass on dag.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.SolovayKitaev.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.SolovayKitaev.md
new file mode 100644
index 00000000000..41956f4a5a2
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.SolovayKitaev.md
@@ -0,0 +1,206 @@
+---
+title: SolovayKitaev
+description: API reference for qiskit.transpiler.passes.SolovayKitaev
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.SolovayKitaev
+---
+
+# SolovayKitaev
+
+
+
+`qiskit.transpiler.passes.SolovayKitaev(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/synthesis/solovay_kitaev_synthesis.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Approximately decompose 1q gates to a discrete basis using the Solovay-Kitaev algorithm.
+
+The Solovay-Kitaev theorem \[1] states that any single qubit gate can be approximated to arbitrary precision by a set of fixed single-qubit gates, if the set generates a dense subset in $SU(2)$. This is an important result, since it means that any single-qubit gate can be expressed in terms of a discrete, universal gate set that we know how to implement fault-tolerantly. Therefore, the Solovay-Kitaev algorithm allows us to take any non-fault tolerant circuit and rephrase it in a fault-tolerant manner.
+
+This implementation of the Solovay-Kitaev algorithm is based on \[2].
+
+For example, the following circuit
+
+```python
+ ┌─────────┐
+q_0: ┤ RX(0.8) ├
+ └─────────┘
+```
+
+can be decomposed into
+
+```python
+global phase: 7π/8
+ ┌───┐┌───┐┌───┐
+q_0: ┤ H ├┤ T ├┤ H ├
+ └───┘└───┘└───┘
+```
+
+with an L2-error of approximately 0.01.
+
+**Examples**
+
+Per default, the basis gate set is `["t", "tdg", "h"]`:
+
+```python
+import numpy as np
+from qiskit.circuit import QuantumCircuit
+from qiskit.transpiler.passes.synthesis import SolovayKitaev
+from qiskit.quantum_info import Operator
+
+circuit = QuantumCircuit(1)
+circuit.rx(0.8, 0)
+
+print("Original circuit:")
+print(circuit.draw())
+
+skd = SolovayKitaev(recursion_degree=2)
+
+discretized = skd(circuit)
+
+print("Discretized circuit:")
+print(discretized.draw())
+
+print("Error:", np.linalg.norm(Operator(circuit).data - Operator(discretized).data))
+```
+
+```python
+Original circuit:
+ ┌─────────┐
+q: ┤ Rx(0.8) ├
+ └─────────┘
+Discretized circuit:
+global phase: 7π/8
+ ┌───┐┌───┐┌───┐
+q: ┤ H ├┤ T ├┤ H ├
+ └───┘└───┘└───┘
+Error: 2.828408279166474
+```
+
+For individual basis gate sets, the `generate_basic_approximations` function can be used:
+
+```python
+from qiskit.synthesis import generate_basic_approximations
+from qiskit.transpiler.passes import SolovayKitaev
+
+basis = ["s", "sdg", "t", "tdg", "z", "h"]
+approx = generate_basic_approximations(basis, depth=3)
+
+skd = SolovayKitaev(recursion_degree=2, basic_approximations=approx)
+```
+
+**References**
+
+**\[1]: Kitaev, A Yu (1997). Quantum computations: algorithms and error correction.**
+
+Russian Mathematical Surveys. 52 (6): 1191–1249. [Online](https://iopscience.iop.org/article/10.1070/RM1997v052n06ABEH002155).
+
+**\[2]: Dawson, Christopher M.; Nielsen, Michael A. (2005) The Solovay-Kitaev Algorithm.**
+
+[arXiv:quant-ph/0505030](https://arxiv.org/abs/quant-ph/0505030).
+
+**Parameters**
+
+* **recursion\_degree** – The recursion depth for the Solovay-Kitaev algorithm. A larger recursion depth increases the accuracy and length of the decomposition.
+* **basic\_approximations** – The basic approximations for the finding the best discrete decomposition at the root of the recursion. If a string, it specifies the `.npy` file to load the approximations from. If a dictionary, it contains `{label: SO(3)-matrix}` pairs. If None, a default based on the H, T and Tdg gates up to combinations of depth 10 is generated.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the `SolovayKitaev` pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")) – The input dag.
+
+**Returns**
+
+Output dag with 1q gates synthesized in the discrete target basis.
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if a gates does not have to\_matrix
+
+**Return type**
+
+[*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.SolovayKitaevSynthesis.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.SolovayKitaevSynthesis.md
new file mode 100644
index 00000000000..662da059c88
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.SolovayKitaevSynthesis.md
@@ -0,0 +1,173 @@
+---
+title: SolovayKitaevSynthesis
+description: API reference for qiskit.transpiler.passes.SolovayKitaevSynthesis
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.SolovayKitaevSynthesis
+---
+
+# SolovayKitaevSynthesis
+
+
+
+`qiskit.transpiler.passes.SolovayKitaevSynthesis`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/synthesis/solovay_kitaev_synthesis.py "view source code")
+
+Bases: [`UnitarySynthesisPlugin`](qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin "qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin")
+
+A Solovay-Kitaev Qiskit unitary synthesis plugin.
+
+This plugin is invoked by [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") when the `unitary_synthesis_method` parameter is set to `"sk"`.
+
+This plugin supports customization and additional parameters can be passed to the plugin by passing a dictionary as the `unitary_synthesis_plugin_config` parameter of the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function.
+
+Supported parameters in the dictionary:
+
+**basis\_approximations (str | dict):**
+
+The basic approximations for the finding the best discrete decomposition at the root of the recursion. If a string, it specifies the `.npy` file to load the approximations from. If a dictionary, it contains `{label: SO(3)-matrix}` pairs. If None, a default based on the specified `basis_gates` and `depth` is generated.
+
+**basis\_gates (list):**
+
+A list of strings specifying the discrete basis gates to decompose to. If None, defaults to `["h", "t", "tdg"]`.
+
+**depth (int):**
+
+The gate-depth of the basic approximations. All possible, unique combinations of the basis gates up to length `depth` are considered. If None, defaults to 10.
+
+**recursion\_degree (int):**
+
+The number of times the decomposition is recursively improved. If None, defaults to 3.
+
+## Attributes
+
+
+
+### max\_qubits
+
+Maximum number of supported qubits is `1`.
+
+
+
+### min\_qubits
+
+Minimum number of supported qubits is `1`.
+
+
+
+### supported\_bases
+
+The plugin does not support bases for synthesis.
+
+
+
+### supports\_basis\_gates
+
+The plugin does not support basis gates. By default it synthesis to the `["h", "t", "tdg"]` gate basis.
+
+
+
+### supports\_coupling\_map
+
+The plugin does not support coupling maps.
+
+
+
+### supports\_gate\_errors
+
+The plugin does not support gate errors.
+
+
+
+### supports\_gate\_errors\_by\_qubit
+
+Return whether the plugin supports taking `gate_errors_by_qubit`
+
+This differs from `supports_gate_errors`/`gate_errors` by using a different view of the same data. Instead of being keyed by gate name this is keyed by qubit and uses [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate") instances to represent gates (instead of gate names).
+
+`gate_errors_by_qubit` will be a dictionary in the form of `{(qubits,): [Gate, error]}`. For example:
+
+```python
+{
+(0,): [SXGate(): 0.0006149355812506126, RZGate(): 0.0],
+(0, 1): [CXGate(): 0.012012477900732316]
+}
+```
+
+Do note that this dictionary might not be complete or could be empty as it depends on the target backend reporting gate errors on every gate for each qubit. The gate error rates reported in `gate_errors` are provided by the target device `Backend` object and the exact meaning might be different depending on the backend.
+
+This defaults to False
+
+
+
+### supports\_gate\_lengths
+
+The plugin does not support gate lengths.
+
+
+
+### supports\_gate\_lengths\_by\_qubit
+
+Return whether the plugin supports taking `gate_lengths_by_qubit`
+
+This differs from `supports_gate_lengths`/`gate_lengths` by using a different view of the same data. Instead of being keyed by gate name this is keyed by qubit and uses [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate") instances to represent gates (instead of gate names)
+
+`gate_lengths_by_qubit` will be a dictionary in the form of `{(qubits,): [Gate, length]}`. For example:
+
+```python
+{
+(0,): [SXGate(): 0.0006149355812506126, RZGate(): 0.0],
+(0, 1): [CXGate(): 0.012012477900732316]
+}
+```
+
+where the `length` value is in units of seconds.
+
+Do note that this dictionary might not be complete or could be empty as it depends on the target backend reporting gate lengths on every gate for each qubit.
+
+This defaults to False
+
+
+
+### supports\_natural\_direction
+
+The plugin does not support natural direction, it does not assume bidirectional two qubit gates.
+
+
+
+### supports\_pulse\_optimize
+
+The plugin does not support optimization of pulses.
+
+
+
+### supports\_target
+
+Whether the plugin supports taking `target` as an option
+
+`target` will be a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object representing the target device for the output of the synthesis pass.
+
+By default this will be `False` since the plugin interface predates the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") class. If a plugin returns `True` for this attribute, it is expected that the plugin will use the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") instead of the values passed if any of `supports_gate_lengths`, `supports_gate_errors`, `supports_coupling_map`, and `supports_basis_gates` are set (although ideally all those parameters should contain duplicate information).
+
+## Methods
+
+### run
+
+
+
+`run(unitary, **options)`
+
+Run synthesis for the given unitary matrix
+
+**Parameters**
+
+* **unitary** ([*numpy.ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – The unitary matrix to synthesize to a [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") object
+* **options** – The optional kwargs that are passed based on the output the `support_*` methods on the class. Refer to the documentation for these methods on [`UnitarySynthesisPlugin`](qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin "qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin") to see what the keys and values are.
+
+**Returns**
+
+The dag circuit representation of the unitary. Alternatively, you can return a tuple of the form `(dag, wires)` where `dag` is the dag circuit representation of the circuit representation of the unitary and `wires` is the mapping wires to use for [`qiskit.dagcircuit.DAGCircuit.substitute_node_with_dag()`](qiskit.dagcircuit.DAGCircuit#substitute_node_with_dag "qiskit.dagcircuit.DAGCircuit.substitute_node_with_dag"). If you return a tuple and `wires` is `None` this will behave just as if only a [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") was returned. Additionally if this returns `None` no substitution will be made.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.StochasticSwap.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.StochasticSwap.md
new file mode 100644
index 00000000000..ae71492710b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.StochasticSwap.md
@@ -0,0 +1,139 @@
+---
+title: StochasticSwap
+description: API reference for qiskit.transpiler.passes.StochasticSwap
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.StochasticSwap
+---
+
+# StochasticSwap
+
+
+
+`qiskit.transpiler.passes.StochasticSwap(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/routing/stochastic_swap.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Map a DAGCircuit onto a coupling\_map adding swap gates.
+
+Uses a randomized algorithm.
+
+**Notes**
+
+1. Measurements may occur and be followed by swaps that result in repeated measurement of the same qubit. Near-term experiments cannot implement these circuits, so some care is required when using this mapper with experimental backend targets.
+2. We do not use the fact that the input state is zero to simplify the circuit.
+
+StochasticSwap initializer.
+
+The coupling map is a connected graph
+
+If these are not satisfied, the behavior is undefined.
+
+**Parameters**
+
+* **coupling\_map** (*Union\[*[*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")*,* [*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")*]*) – Directed graph representing a coupling map.
+* **trials** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – maximum number of iterations to attempt
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – seed for random number generator
+* **fake\_run** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – if true, it will only pretend to do routing, i.e., no swap is effectively added.
+* **initial\_layout** ([*Layout*](qiskit.transpiler.Layout "qiskit.transpiler.Layout")) – starting layout at beginning of pass.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the StochasticSwap pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – DAG to map.
+
+**Returns**
+
+A mapped DAG.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+* [**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if the coupling map or the layout are not
+* **compatible with the DAG**\*\*, or \*\***if the coupling\_map=None** –
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.TemplateOptimization.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.TemplateOptimization.md
new file mode 100644
index 00000000000..df83c02c1b3
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.TemplateOptimization.md
@@ -0,0 +1,122 @@
+---
+title: TemplateOptimization
+description: API reference for qiskit.transpiler.passes.TemplateOptimization
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.TemplateOptimization
+---
+
+# TemplateOptimization
+
+
+
+`qiskit.transpiler.passes.TemplateOptimization(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/optimization/template_optimization.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Class for the template optimization pass.
+
+**Parameters**
+
+* **template\_list** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*()]*) – list of the different template circuit to apply.
+* **heuristics\_backward\_param** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – \[length, survivor] Those are the parameters for applying heuristics on the backward part of the algorithm. This part of the algorithm creates a tree of matching scenario. This tree grows exponentially. The heuristics evaluate which scenarios have the longest match and keep only those. The length is the interval in the tree for cutting it and survivor is the number of scenarios that are kept. We advise to use l=3 and s=1 to have serious time advantage. We remind that the heuristics implies losing a part of the maximal matches. Check reference for more details.
+* **heuristics\_qubits\_param** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – \[length] The heuristics for the qubit choice make guesses from the dag dependency of the circuit in order to limit the number of qubit configurations to explore. The length is the number of successors or not predecessors that will be explored in the dag dependency of the circuit, each qubits of the nodes are added to the set of authorized qubits. We advise to use length=1. Check reference for more details.
+* **user\_cost\_dict** (*Dict\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – quantum cost dictionary passed to TemplateSubstitution to configure its behavior. This will override any default values if None is not given. The key is the name of the gate and the value its quantum cost.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – DAG circuit.
+
+**Returns**
+
+optimized DAG circuit.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – If the template has not the right form or if the output circuit acts differently as the input circuit.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.TimeUnitConversion.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.TimeUnitConversion.md
new file mode 100644
index 00000000000..c8fb808f87e
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.TimeUnitConversion.md
@@ -0,0 +1,132 @@
+---
+title: TimeUnitConversion
+description: API reference for qiskit.transpiler.passes.TimeUnitConversion
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.TimeUnitConversion
+---
+
+# TimeUnitConversion
+
+
+
+`qiskit.transpiler.passes.TimeUnitConversion(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/scheduling/time_unit_conversion.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Choose a time unit to be used in the following time-aware passes, and make all circuit time units consistent with that.
+
+This pass will add a [`Instruction.duration`](qiskit.circuit.Instruction#duration "qiskit.circuit.Instruction.duration") metadata to each op whose duration is known which will be used by subsequent scheduling passes for scheduling.
+
+If `dt` (in seconds) is known to transpiler, the unit `'dt'` is chosen. Otherwise, the unit to be selected depends on what units are used in delays and instruction durations:
+
+* `'s'`: if they are all in SI units.
+* `'dt'`: if they are all in the unit `'dt'`.
+* raise error: if they are a mix of SI units and `'dt'`.
+
+TimeUnitAnalysis initializer.
+
+**Parameters**
+
+* **inst\_durations** ([*InstructionDurations*](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations")) – A dictionary of durations of instructions.
+* **target** – The [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") representing the target backend, if both `inst_durations` and `target` are specified then this argument will take precedence and `inst_durations` will be ignored.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the TimeUnitAnalysis pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – DAG to be checked.
+
+**Returns**
+
+DAG with consistent timing and op nodes annotated with duration.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if the units are not unifiable
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.TranslateParameterizedGates.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.TranslateParameterizedGates.md
new file mode 100644
index 00000000000..222de73e818
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.TranslateParameterizedGates.md
@@ -0,0 +1,174 @@
+---
+title: TranslateParameterizedGates
+description: API reference for qiskit.transpiler.passes.TranslateParameterizedGates
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.TranslateParameterizedGates
+---
+
+# TranslateParameterizedGates
+
+
+
+`qiskit.transpiler.passes.TranslateParameterizedGates(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/basis/translate_parameterized.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Translate parameterized gates to a supported basis set.
+
+Once a parameterized instruction is found that is not in the `supported_gates` list, the instruction is decomposed one level and the parameterized sub-blocks are recursively decomposed. The recursion is stopped once all parameterized gates are in `supported_gates`, or if a gate has no definition and a translation to the basis is attempted (this might happen e.g. for the `UGate` if it’s not in the specified gate list).
+
+**Example**
+
+The following, multiply nested circuit:
+
+```python
+from qiskit.circuit import QuantumCircuit, ParameterVector
+from qiskit.transpiler.passes import TranslateParameterizedGates
+
+x = ParameterVector("x", 4)
+block1 = QuantumCircuit(1)
+block1.rx(x[0], 0)
+
+sub_block = QuantumCircuit(2)
+sub_block.cx(0, 1)
+sub_block.rz(x[2], 0)
+
+block2 = QuantumCircuit(2)
+block2.ry(x[1], 0)
+block2.append(sub_block.to_gate(), [0, 1])
+
+block3 = QuantumCircuit(3)
+block3.ccx(0, 1, 2)
+
+circuit = QuantumCircuit(3)
+circuit.append(block1.to_gate(), [1])
+circuit.append(block2.to_gate(), [0, 1])
+circuit.append(block3.to_gate(), [0, 1, 2])
+circuit.cry(x[3], 0, 2)
+
+supported_gates = ["rx", "ry", "rz", "cp", "crx", "cry", "crz"]
+unrolled = TranslateParameterizedGates(supported_gates)(circuit)
+```
+
+is decomposed to:
+
+```python
+ ┌──────────┐ ┌──────────┐┌─────────────┐
+q_0: ┤ Ry(x[1]) ├──■──┤ Rz(x[2]) ├┤0 ├─────■──────
+ ├──────────┤┌─┴─┐└──────────┘│ │ │
+q_1: ┤ Rx(x[0]) ├┤ X ├────────────┤1 circuit-92 ├─────┼──────
+ └──────────┘└───┘ │ │┌────┴─────┐
+q_2: ─────────────────────────────┤2 ├┤ Ry(x[3]) ├
+ └─────────────┘└──────────┘
+```
+
+**Parameters**
+
+* **supported\_gates** – A list of suppported basis gates specified as string. If `None`, a `target` must be provided.
+* **equivalence\_library** – The equivalence library to translate the gates. Defaults to the equivalence library of all Qiskit standard gates.
+* **target** – A [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") containing the supported operations. If `None`, `supported_gates` must be set. Note that this argument takes precedence over `supported_gates`, if both are set.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If neither of `supported_gates` and `target` are passed.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the transpiler pass.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")) – The DAG circuit in which the parameterized gates should be unrolled.
+
+**Returns**
+
+A DAG where the parameterized gates have been unrolled.
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If the circuit cannot be unrolled.
+
+**Return type**
+
+[*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.TrivialLayout.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.TrivialLayout.md
new file mode 100644
index 00000000000..c6410fbf812
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.TrivialLayout.md
@@ -0,0 +1,125 @@
+---
+title: TrivialLayout
+description: API reference for qiskit.transpiler.passes.TrivialLayout
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.TrivialLayout
+---
+
+# TrivialLayout
+
+
+
+`qiskit.transpiler.passes.TrivialLayout(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/layout/trivial_layout.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Choose a Layout by assigning `n` circuit qubits to device qubits `0, .., n-1`.
+
+A pass for choosing a Layout of a circuit onto a Coupling graph, using a simple round-robin order.
+
+This pass associates a physical qubit (int) to each virtual qubit of the circuit (Qubit) in increasing order.
+
+Does not assume any ancilla.
+
+TrivialLayout initializer.
+
+**Parameters**
+
+**coupling\_map** (*Union\[*[*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")*,* [*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")*]*) – directed graph representing a coupling map.
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if invalid options
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the TrivialLayout pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – DAG to find layout for.
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if dag wider than the target backend
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.UnitarySynthesis.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.UnitarySynthesis.md
new file mode 100644
index 00000000000..22a53c908bc
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.UnitarySynthesis.md
@@ -0,0 +1,135 @@
+---
+title: UnitarySynthesis
+description: API reference for qiskit.transpiler.passes.UnitarySynthesis
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.UnitarySynthesis
+---
+
+# UnitarySynthesis
+
+
+
+`qiskit.transpiler.passes.UnitarySynthesis(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/synthesis/unitary_synthesis.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Synthesize gates according to their basis gates.
+
+Synthesize unitaries over some basis gates.
+
+This pass can approximate 2-qubit unitaries given some gate fidelities (either via `backend_props` or `target`). More approximation can be forced by setting a heuristic dial `approximation_degree`.
+
+**Parameters**
+
+* **basis\_gates** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – List of gate names to target. If this is not specified the `target` argument must be used. If both this and the `target` are specified the value of `target` will be used and this will be ignored.
+* **approximation\_degree** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – heuristic dial used for circuit approximation (1.0=no approximation, 0.0=maximal approximation). Approximation can make the synthesized circuit cheaper at the cost of straying from the original unitary. If None, approximation is done based on gate fidelities.
+* **coupling\_map** ([*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")) – the coupling map of the backend in case synthesis is done on a physical circuit. The directionality of the coupling\_map will be taken into account if `pulse_optimize` is `True`/`None` and `natural_direction` is `True`/`None`.
+* **backend\_props** ([*BackendProperties*](qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties")) – Properties of a backend to synthesize for (e.g. gate fidelities).
+* **pulse\_optimize** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to optimize pulses during synthesis. A value of `None` will attempt it but fall back if it does not succeed. A value of `True` will raise an error if pulse-optimized synthesis does not succeed.
+* **natural\_direction** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether to apply synthesis considering directionality of 2-qubit gates. Only applies when `pulse_optimize` is `True` or `None`. The natural direction is determined by first checking to see whether the coupling map is unidirectional. If there is no coupling map or the coupling map is bidirectional, the gate direction with the shorter duration from the backend properties will be used. If set to True, and a natural direction can not be determined, raises [`TranspilerError`](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError"). If set to None, no exception will be raised if a natural direction can not be determined.
+* **synth\_gates** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – List of gates to synthesize. If None and `pulse_optimize` is False or None, default to `['unitary']`. If `None` and `pulse_optimize == True`, default to `['unitary', 'swap']`
+* **method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The unitary synthesis method plugin to use.
+* **min\_qubits** – The minimum number of qubits in the unitary to synthesize. If this is set and the unitary is less than the specified number of qubits it will not be synthesized.
+* **plugin\_config** – Optional extra configuration arguments (as a `dict`) which are passed directly to the specified unitary synthesis plugin. By default, this will have no effect as the default plugin has no extra arguments. Refer to the documentation of your unitary synthesis plugin on how to use this.
+* **target** – The optional [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") for the target device the pass is compiling for. If specified this will supersede the values set for `basis_gates`, `coupling_map`, and `backend_props`.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the UnitarySynthesis pass on `dag`.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")) – input dag.
+
+**Returns**
+
+Output dag with UnitaryGates synthesized to target basis.
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if `method` was specified for the class and is not found in the installed plugins list. The list of installed plugins can be queried with [`unitary_synthesis_plugin_names()`](qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names "qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names")
+
+**Return type**
+
+[*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.Unroll3qOrMore.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Unroll3qOrMore.md
new file mode 100644
index 00000000000..fe75b978b50
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Unroll3qOrMore.md
@@ -0,0 +1,124 @@
+---
+title: Unroll3qOrMore
+description: API reference for qiskit.transpiler.passes.Unroll3qOrMore
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.Unroll3qOrMore
+---
+
+# Unroll3qOrMore
+
+
+
+`qiskit.transpiler.passes.Unroll3qOrMore(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/basis/unroll_3q_or_more.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Recursively expands 3q+ gates until the circuit only contains 2q or 1q gates.
+
+Initialize the Unroll3qOrMore pass
+
+**Parameters**
+
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – The target object representing the compilation target. If specified any multi-qubit instructions in the circuit when the pass is run that are supported by the target device will be left in place. If both this and `basis_gates` are specified only the target will be checked.
+* **basis\_gates** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of basis gate names that the target device supports. If specified any gate names in the circuit which are present in this list will not be unrolled. If both this and `target` are specified only the target will be used for checking which gates are supported.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the Unroll3qOrMore pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – input dag
+
+**Returns**
+
+output dag with maximum node degrees of 2
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if a 3q+ gate is not decomposable
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.UnrollCustomDefinitions.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.UnrollCustomDefinitions.md
new file mode 100644
index 00000000000..9f47bb9716d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.UnrollCustomDefinitions.md
@@ -0,0 +1,136 @@
+---
+title: UnrollCustomDefinitions
+description: API reference for qiskit.transpiler.passes.UnrollCustomDefinitions
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.UnrollCustomDefinitions
+---
+
+# UnrollCustomDefinitions
+
+
+
+`qiskit.transpiler.passes.UnrollCustomDefinitions(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/basis/unroll_custom_definitions.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Unrolls instructions with custom definitions.
+
+Unrolls instructions with custom definitions.
+
+**Parameters**
+
+* **equivalence\_library** ([*EquivalenceLibrary*](qiskit.circuit.EquivalenceLibrary "qiskit.circuit.EquivalenceLibrary")) – The equivalence library which will be used by the BasisTranslator pass. (Instructions in this library will not be unrolled by this pass.)
+
+* **basis\_gates** (*Optional\[*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]]*) – Target basis names to unroll to, e.g. `['u3', 'cx']`. Ignored if `target` is also specified.
+
+* **target** (*Optional\[*[*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")*]*) –
+
+ **The [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object corresponding to the compilation**
+
+ target. When specified, any argument specified for `basis_gates` is ignored.
+
+ **min\_qubits (int): The minimum number of qubits for operations in the input**
+
+ dag to translate.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the UnrollCustomDefinitions pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – input dag
+
+**Raises**
+
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if unable to unroll given the basis due to undefined
+* **decomposition rules**\*\* (****such as a bad basis****) or \*\***excessive recursion.** –
+
+**Returns**
+
+output unrolled dag
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.UnrollForLoops.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.UnrollForLoops.md
new file mode 100644
index 00000000000..ac595f65867
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.UnrollForLoops.md
@@ -0,0 +1,123 @@
+---
+title: UnrollForLoops
+description: API reference for qiskit.transpiler.passes.UnrollForLoops
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.UnrollForLoops
+---
+
+# UnrollForLoops
+
+
+
+`qiskit.transpiler.passes.UnrollForLoops(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/utils/unroll_forloops.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+`UnrollForLoops` transpilation pass unrolls for-loops when possible.
+
+Things like `for x in {0, 3, 4} {rx(x) qr[1];}` will turn into `rx(0) qr[1]; rx(3) qr[1]; rx(4) qr[1];`.
+
+
+ The `UnrollForLoops` unrolls only one level of block depth. No inner loop will be considered by `max_target_depth`.
+
+
+**Parameters**
+
+**max\_target\_depth** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Optional. Checks if the unrolled block is over a particular subcircuit depth. To disable the check, use `-1` (Default).
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the UnrollForLoops pass on `dag`.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – the directed acyclic graph to run on.
+
+**Returns**
+
+Transformed DAG.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.Unroller.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Unroller.md
new file mode 100644
index 00000000000..dd930f08405
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Unroller.md
@@ -0,0 +1,131 @@
+---
+title: Unroller
+description: API reference for qiskit.transpiler.passes.Unroller
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.Unroller
+---
+
+# Unroller
+
+
+
+`qiskit.transpiler.passes.Unroller(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/basis/unroller.py "view source code")
+
+Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass")
+
+Unroll a circuit to a given basis.
+
+Unroll (expand) non-basis, non-opaque instructions recursively to a desired basis, using decomposition rules defined for each instruction.
+
+Unroller initializer.
+
+
+ The class `qiskit.transpiler.passes.basis.unroller.Unroller` is deprecated as of qiskit 0.45.0. It will be removed in the Qiskit 1.0 release. This has been replaced by the BasisTranslator pass.
+
+
+**Parameters**
+
+* **basis** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*] or None*) – Target basis names to unroll to, e.g. \[‘u3’, ‘cx’] . If None, does not unroll any gate.
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – The [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") representing the target backend, if both `basis` and this are specified then this argument will take precedence and `basis` will be ignored.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the Unroller pass on dag.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – input dag
+
+**Raises**
+
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if unable to unroll given the basis due to undefined
+* **decomposition rules**\*\* (****such as a bad basis****) or \*\***excessive recursion.** –
+
+**Returns**
+
+output unrolled dag
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.VF2Layout.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.VF2Layout.md
new file mode 100644
index 00000000000..c73c716b2ae
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.VF2Layout.md
@@ -0,0 +1,137 @@
+---
+title: VF2Layout
+description: API reference for qiskit.transpiler.passes.VF2Layout
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.VF2Layout
+---
+
+# VF2Layout
+
+
+
+`qiskit.transpiler.passes.VF2Layout(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/layout/vf2_layout.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+A pass for choosing a Layout of a circuit onto a Coupling graph, as a subgraph isomorphism problem, solved by VF2++.
+
+If a solution is found that means there is a “perfect layout” and that no further swap mapping or routing is needed. If a solution is found the layout will be set in the property set as `property_set['layout']`. However, if no solution is found, no `property_set['layout']` is set. The stopping reason is set in `property_set['VF2Layout_stop_reason']` in all the cases and will be one of the values enumerated in `VF2LayoutStopReason` which has the following values:
+
+> * `"solution found"`: If a perfect layout was found.
+> * `"nonexistent solution"`: If no perfect layout was found.
+> * `">2q gates in basis"`: If VF2Layout can’t work with basis
+
+By default, this pass will construct a heuristic scoring map based on the error rates in the provided `target` (or `properties` if `target` is not provided). However, analysis passes can be run prior to this pass and set `vf2_avg_error_map` in the property set with a `ErrorMap` instance. If a value is `NaN` that is treated as an ideal edge For example if an error map is created as:
+
+```python
+from qiskit.transpiler.passes.layout.vf2_utils import ErrorMap
+
+error_map = ErrorMap(3)
+error_map.add_error((0, 0), 0.0024)
+error_map.add_error((0, 1), 0.01)
+error_map.add_error((1, 1), 0.0032)
+```
+
+that represents the error map for a 2 qubit target, where the avg 1q error rate is `0.0024` on qubit 0 and `0.0032` on qubit 1. Then the avg 2q error rate for gates that operate on (0, 1) is 0.01 and (1, 0) is not supported by the target. This will be used for scoring if it’s set as the `vf2_avg_error_map` key in the property set when [`VF2Layout`](#qiskit.transpiler.passes.VF2Layout "qiskit.transpiler.passes.VF2Layout") is run.
+
+Initialize a `VF2Layout` pass instance
+
+**Parameters**
+
+* **coupling\_map** ([*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")) – Directed graph representing a coupling map.
+* **strict\_direction** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, considers the direction of the coupling map. Default is False.
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Sets the seed of the PRNG. -1 Means no node shuffling.
+* **call\_limit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of state visits to attempt in each execution of VF2.
+* **time\_limit** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The total time limit in seconds to run `VF2Layout`
+* **properties** ([*BackendProperties*](qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties")) – The backend properties for the backend. If [`readout_error()`](qiskit.providers.models.BackendProperties#readout_error "qiskit.providers.models.BackendProperties.readout_error") is available it is used to score the layout.
+* **max\_trials** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The maximum number of trials to run VF2 to find a layout. If this is not specified the number of trials will be limited based on the number of edges in the interaction graph or the coupling graph (whichever is larger) if no other limits are set. If set to a value \<= 0 no limit on the number of trials will be set.
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – A target representing the backend device to run `VF2Layout` on. If specified it will supersede a set value for `properties` and `coupling_map`.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – At runtime, if neither `coupling_map` or `target` are provided.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+run the layout method
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.VF2PostLayout.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.VF2PostLayout.md
new file mode 100644
index 00000000000..6258e33d590
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.VF2PostLayout.md
@@ -0,0 +1,139 @@
+---
+title: VF2PostLayout
+description: API reference for qiskit.transpiler.passes.VF2PostLayout
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.VF2PostLayout
+---
+
+# VF2PostLayout
+
+
+
+`qiskit.transpiler.passes.VF2PostLayout(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/layout/vf2_post_layout.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+A pass for choosing a Layout after transpilation of a circuit onto a Coupling graph, as a subgraph isomorphism problem, solved by VF2++.
+
+Unlike the [`VF2Layout`](qiskit.transpiler.passes.VF2Layout "qiskit.transpiler.passes.VF2Layout") transpiler pass which is designed to find an initial layout for a circuit early in the transpilation pipeline this transpiler pass is designed to try and find a better layout after transpilation is complete. The initial layout phase of the transpiler doesn’t have as much information available as we do after transpilation. This pass is designed to be paired in a similar pipeline as the layout passes. This pass will strip any idle wires from the circuit, use VF2 to find a subgraph in the coupling graph for the circuit to run on with better fidelity and then update the circuit layout to use the new qubits. The algorithm used in this pass is described in [arXiv:2209.15512](https://arxiv.org/abs/2209.15512).
+
+If a solution is found that means there is a lower error layout available for the circuit. If a solution is found the layout will be set in the property set as `property_set['post_layout']`. However, if no solution is found, no `property_set['post_layout']` is set. The stopping reason is set in `property_set['VF2PostLayout_stop_reason']` in all the cases and will be one of the values enumerated in `VF2PostLayoutStopReason` which has the following values:
+
+> * `"solution found"`: If a solution was found.
+> * `"nonexistent solution"`: If no solution was found.
+> * `">2q gates in basis"`: If VF2PostLayout can’t work with basis
+
+By default, this pass will construct a heuristic scoring map based on the error rates in the provided `target` (or `properties` if `target` is not provided). However, analysis passes can be run prior to this pass and set `vf2_avg_error_map` in the property set with a `ErrorMap` instance. If a value is `NaN` that is treated as an ideal edge For example if an error map is created as:
+
+```python
+from qiskit.transpiler.passes.layout.vf2_utils import ErrorMap
+
+error_map = ErrorMap(3)
+error_map.add_error((0, 0), 0.0024)
+error_map.add_error((0, 1), 0.01)
+error_map.add_error((1, 1), 0.0032)
+```
+
+that represents the error map for a 2 qubit target, where the avg 1q error rate is `0.0024` on qubit 0 and `0.0032` on qubit 1. Then the avg 2q error rate for gates that operate on (0, 1) is 0.01 and (1, 0) is not supported by the target. This will be used for scoring if it’s set as the `vf2_avg_error_map` key in the property set when [`VF2PostLayout`](#qiskit.transpiler.passes.VF2PostLayout "qiskit.transpiler.passes.VF2PostLayout") is run.
+
+Initialize a `VF2PostLayout` pass instance
+
+**Parameters**
+
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – A target representing the backend device to run `VF2PostLayout` on. If specified it will supersede a set value for `properties` and `coupling_map`.
+* **coupling\_map** ([*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")) – Directed graph representing a coupling map.
+* **properties** ([*BackendProperties*](qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties")) – The backend properties for the backend. If [`readout_error()`](qiskit.providers.models.BackendProperties#readout_error "qiskit.providers.models.BackendProperties.readout_error") is available it is used to score the layout.
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Sets the seed of the PRNG. -1 Means no node shuffling.
+* **call\_limit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of state visits to attempt in each execution of VF2.
+* **time\_limit** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The total time limit in seconds to run `VF2PostLayout`
+* **strict\_direction** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Whether the pass is configured to follow the strict direction in the coupling graph. If this is set to false, the pass will treat any edge in the coupling graph as a weak edge and the interaction graph will be undirected. For the purposes of evaluating layouts the avg error rate for each qubit and 2q link will be used. This enables the pass to be run prior to basis translation and work with any 1q and 2q operations. However, if `strict_direction=True` the pass expects the input [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") object to [`run()`](#qiskit.transpiler.passes.VF2PostLayout.run "qiskit.transpiler.passes.VF2PostLayout.run") to be in the target set of instructions.
+* **max\_trials** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The maximum number of trials to run VF2 to find a layout. A value of `0` (the default) means ‘unlimited’.
+
+**Raises**
+
+[**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – At runtime, if neither `coupling_map` or `target` are provided.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+run the layout method
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.ValidatePulseGates.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.ValidatePulseGates.md
new file mode 100644
index 00000000000..2c392b26f2c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.ValidatePulseGates.md
@@ -0,0 +1,132 @@
+---
+title: ValidatePulseGates
+description: API reference for qiskit.transpiler.passes.ValidatePulseGates
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.ValidatePulseGates
+---
+
+# ValidatePulseGates
+
+
+
+`qiskit.transpiler.passes.ValidatePulseGates(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/scheduling/alignments/pulse_gate_validation.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Check custom gate length.
+
+This is a control electronics aware analysis pass.
+
+Quantum gates (instructions) are often implemented with shaped analog stimulus signals. These signals may be digitally stored in the waveform memory of the control electronics and converted into analog voltage signals by electronic components known as digital to analog converters (DAC).
+
+In Qiskit SDK, we can define the pulse-level implementation of custom quantum gate instructions, as a [pulse gate](https://docs.quantum-computing.ibm.com/build/pulse), thus user gates should satisfy all waveform memory constraints imposed by the backend.
+
+This pass validates all attached calibration entries and raises `TranspilerError` to kill the transpilation process if any invalid calibration entry is found. This pass saves users from waiting until job execution time to get an invalid pulse error from the backend control electronics.
+
+Create new pass.
+
+**Parameters**
+
+* **granularity** – Integer number representing the minimum time resolution to define the pulse gate length in units of `dt`. This value depends on the control electronics of your quantum processor.
+* **min\_length** – Integer number representing the minimum data point length to define the pulse gate in units of `dt`. This value depends on the control electronics of your quantum processor.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the pulse gate validation attached to `dag`.
+
+**Parameters**
+
+**dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.dagcircuit.DAGCircuit")) – DAG to be validated.
+
+**Returns**
+
+DAG with consistent timing and op nodes annotated with duration.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – When pulse gate violate pulse controller constraints.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.Width.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Width.md
new file mode 100644
index 00000000000..e135edc3229
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.Width.md
@@ -0,0 +1,103 @@
+---
+title: Width
+description: API reference for qiskit.transpiler.passes.Width
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.Width
+---
+
+# Width
+
+
+
+`qiskit.transpiler.passes.Width(*args, **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/analysis/width.py "view source code")
+
+Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass")
+
+Calculate the width of a DAG circuit.
+
+The result is saved in `property_set['width']` as an integer that contains the number of qubits + the number of clbits.
+
+## Attributes
+
+
+
+### is\_analysis\_pass
+
+Check if the pass is an analysis pass.
+
+If the pass is an AnalysisPass, that means that the pass can analyze the DAG and write the results of that analysis in the property set. Modifications on the DAG are not allowed by this kind of pass.
+
+
+
+### is\_transformation\_pass
+
+Check if the pass is a transformation pass.
+
+If the pass is a TransformationPass, that means that the pass can manipulate the DAG, but cannot modify the property set (but it can be read).
+
+## Methods
+
+### execute
+
+
+
+`execute(passmanager_ir, state, callback=None)`
+
+Execute optimization task for input Qiskit IR.
+
+**Parameters**
+
+* **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")) – Qiskit IR to optimize.
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – State associated with workflow execution by the pass manager itself.
+* **callback** ([*Callable*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Callable "(in Python v3.12)") *| None*) – A callback function which is caller per execution of optimization task.
+
+**Returns**
+
+Optimized Qiskit IR and state of the workflow.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")]
+
+### name
+
+
+
+`name()`
+
+Name of the pass.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### run
+
+
+
+`run(dag)`
+
+Run the Width pass on dag.
+
+### update\_status
+
+
+
+`update_status(state, run_state)`
+
+Update workflow status.
+
+**Parameters**
+
+* **state** ([*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")) – Pass manager state to update.
+* **run\_state** (*RunState*) – Completion status of current task.
+
+**Returns**
+
+Updated pass manager state.
+
+**Return type**
+
+[*PassManagerState*](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPlugin.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPlugin.md
new file mode 100644
index 00000000000..09997127db7
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPlugin.md
@@ -0,0 +1,48 @@
+---
+title: HighLevelSynthesisPlugin
+description: API reference for qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPlugin
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPlugin
+---
+
+# HighLevelSynthesisPlugin
+
+
+
+`qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPlugin`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/synthesis/plugin.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Abstract high-level synthesis plugin class.
+
+This abstract class defines the interface for high-level synthesis plugins.
+
+## Methods
+
+### run
+
+
+
+`abstract run(high_level_object, coupling_map=None, target=None, qubits=None, **options)`
+
+Run synthesis for the given Operation.
+
+**Parameters**
+
+* **high\_level\_object** ([*Operation*](qiskit.circuit.Operation "qiskit.circuit.Operation")) – The Operation to synthesize to a [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") object.
+* **coupling\_map** ([*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")) – The coupling map of the backend in case synthesis is done on a physical circuit.
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – A target representing the target backend.
+* **qubits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – List of qubits over which the operation is defined in case synthesis is done on a physical circuit.
+* **options** – Additional method-specific optional kwargs.
+
+**Returns**
+
+**The quantum circuit representation of the Operation**
+
+when successful, and `None` otherwise.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPluginManager.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPluginManager.md
new file mode 100644
index 00000000000..d9428503746
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPluginManager.md
@@ -0,0 +1,36 @@
+---
+title: HighLevelSynthesisPluginManager
+description: API reference for qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPluginManager
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPluginManager
+---
+
+# HighLevelSynthesisPluginManager
+
+
+
+`qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPluginManager`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/synthesis/plugin.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Class tracking the installed high-level-synthesis plugins.
+
+## Methods
+
+### method
+
+
+
+`method(op_name, method_name)`
+
+Returns the plugin for `op_name` and `method_name`.
+
+### method\_names
+
+
+
+`method_names(op_name)`
+
+Returns plugin methods for op\_name.
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin.md
new file mode 100644
index 00000000000..23e00b3647c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin.md
@@ -0,0 +1,200 @@
+---
+title: UnitarySynthesisPlugin
+description: API reference for qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin
+---
+
+# UnitarySynthesisPlugin
+
+
+
+`qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/synthesis/plugin.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+Abstract unitary synthesis plugin class
+
+This abstract class defines the interface for unitary synthesis plugins.
+
+## Attributes
+
+
+
+### max\_qubits
+
+Return the maximum number of qubits the unitary synthesis plugin supports.
+
+If the size of the unitary to be synthesized exceeds this value the `default` plugin will be used. If there is no upper bound return `None` and all unitaries (`>= min_qubits` if it’s defined) will be passed to this plugin when it’s enabled.
+
+
+
+### min\_qubits
+
+Return the minimum number of qubits the unitary synthesis plugin supports.
+
+If the size of the unitary to be synthesized is below this value the `default` plugin will be used. If there is no lower bound return `None` and all unitaries (`<= max_qubits` if it’s defined) will be passed to this plugin when it’s enabled.
+
+
+
+### supported\_bases
+
+Returns a dictionary of supported bases for synthesis
+
+This is expected to return a dictionary where the key is a string basis and the value is a list of gate names that the basis works in. If the synthesis method doesn’t support multiple bases this should return `None`. For example:
+
+```python
+{
+ "XZX": ["rz", "rx"],
+ "XYX": ["rx", "ry"],
+}
+```
+
+If a dictionary is returned by this method the run kwargs will be passed a parameter `matched_basis` which contains a list of the basis strings (i.e. keys in the dictionary) which match the target basis gate set for the transpilation. If no entry in the dictionary matches the target basis gate set then the `matched_basis` kwarg will be set to an empty list, and a plugin can choose how to deal with the target basis gate set not matching the plugin’s capabilities.
+
+
+
+### supports\_basis\_gates
+
+Return whether the plugin supports taking `basis_gates`
+
+If this returns `True` the plugin’s `run()` method will be passed a `basis_gates` kwarg with a list of gate names the target backend supports. For example, `['sx', 'x', 'cx', 'id', 'rz']`.
+
+
+
+### supports\_coupling\_map
+
+Return whether the plugin supports taking `coupling_map`
+
+If this returns `True` the plugin’s `run()` method will receive one kwarg `coupling_map`. The `coupling_map` kwarg will be set to a tuple with the first element being a [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object representing the qubit connectivity of the target backend, the second element will be a list of integers that represent the qubit indices in the coupling map that unitary is on. Note that if the target backend doesn’t have a coupling map set, the `coupling_map` kwarg’s value will be `(None, qubit_indices)`.
+
+
+
+### supports\_gate\_errors
+
+Return whether the plugin supports taking `gate_errors`
+
+`gate_errors` will be a dictionary in the form of `{gate_name: {(qubit_1, qubit_2): error}}`. For example:
+
+```python
+{
+'sx': {(0,): 0.0006149355812506126, (1,): 0.0006149355812506126},
+'cx': {(0, 1): 0.012012477900732316, (1, 0): 5.191111111111111e-07}
+}
+```
+
+Do note that this dictionary might not be complete or could be empty as it depends on the target backend reporting gate errors on every gate for each qubit. The gate error rates reported in `gate_errors` are provided by the target device `Backend` object and the exact meaning might be different depending on the backend.
+
+
+
+### supports\_gate\_errors\_by\_qubit
+
+Return whether the plugin supports taking `gate_errors_by_qubit`
+
+This differs from `supports_gate_errors`/`gate_errors` by using a different view of the same data. Instead of being keyed by gate name this is keyed by qubit and uses [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate") instances to represent gates (instead of gate names).
+
+`gate_errors_by_qubit` will be a dictionary in the form of `{(qubits,): [Gate, error]}`. For example:
+
+```python
+{
+(0,): [SXGate(): 0.0006149355812506126, RZGate(): 0.0],
+(0, 1): [CXGate(): 0.012012477900732316]
+}
+```
+
+Do note that this dictionary might not be complete or could be empty as it depends on the target backend reporting gate errors on every gate for each qubit. The gate error rates reported in `gate_errors` are provided by the target device `Backend` object and the exact meaning might be different depending on the backend.
+
+This defaults to False
+
+
+
+### supports\_gate\_lengths
+
+Return whether the plugin supports taking `gate_lengths`
+
+`gate_lengths` will be a dictionary in the form of `{gate_name: {(qubit_1, qubit_2): length}}`. For example:
+
+```python
+{
+'sx': {(0,): 0.0006149355812506126, (1,): 0.0006149355812506126},
+'cx': {(0, 1): 0.012012477900732316, (1, 0): 5.191111111111111e-07}
+}
+```
+
+where the `length` value is in units of seconds.
+
+Do note that this dictionary might not be complete or could be empty as it depends on the target backend reporting gate lengths on every gate for each qubit.
+
+
+
+### supports\_gate\_lengths\_by\_qubit
+
+Return whether the plugin supports taking `gate_lengths_by_qubit`
+
+This differs from `supports_gate_lengths`/`gate_lengths` by using a different view of the same data. Instead of being keyed by gate name this is keyed by qubit and uses [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate") instances to represent gates (instead of gate names)
+
+`gate_lengths_by_qubit` will be a dictionary in the form of `{(qubits,): [Gate, length]}`. For example:
+
+```python
+{
+(0,): [SXGate(): 0.0006149355812506126, RZGate(): 0.0],
+(0, 1): [CXGate(): 0.012012477900732316]
+}
+```
+
+where the `length` value is in units of seconds.
+
+Do note that this dictionary might not be complete or could be empty as it depends on the target backend reporting gate lengths on every gate for each qubit.
+
+This defaults to False
+
+
+
+### supports\_natural\_direction
+
+Return whether the plugin supports a toggle for considering directionality of 2-qubit gates as `natural_direction`.
+
+Refer to the documentation for [`UnitarySynthesis`](qiskit.transpiler.passes.UnitarySynthesis "qiskit.transpiler.passes.UnitarySynthesis") for the possible values and meaning of these values.
+
+
+
+### supports\_pulse\_optimize
+
+Return whether the plugin supports a toggle to optimize pulses during synthesis as `pulse_optimize`.
+
+Refer to the documentation for [`UnitarySynthesis`](qiskit.transpiler.passes.UnitarySynthesis "qiskit.transpiler.passes.UnitarySynthesis") for the possible values and meaning of these values.
+
+
+
+### supports\_target
+
+Whether the plugin supports taking `target` as an option
+
+`target` will be a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object representing the target device for the output of the synthesis pass.
+
+By default this will be `False` since the plugin interface predates the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") class. If a plugin returns `True` for this attribute, it is expected that the plugin will use the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") instead of the values passed if any of `supports_gate_lengths`, `supports_gate_errors`, `supports_coupling_map`, and `supports_basis_gates` are set (although ideally all those parameters should contain duplicate information).
+
+## Methods
+
+### run
+
+
+
+`abstract run(unitary, **options)`
+
+Run synthesis for the given unitary matrix
+
+**Parameters**
+
+* **unitary** ([*numpy.ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – The unitary matrix to synthesize to a [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") object
+* **options** – The optional kwargs that are passed based on the output the `support_*` methods on the class. Refer to the documentation for these methods on [`UnitarySynthesisPlugin`](#qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin "qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin") to see what the keys and values are.
+
+**Returns**
+
+The dag circuit representation of the unitary. Alternatively, you can return a tuple of the form `(dag, wires)` where `dag` is the dag circuit representation of the circuit representation of the unitary and `wires` is the mapping wires to use for [`qiskit.dagcircuit.DAGCircuit.substitute_node_with_dag()`](qiskit.dagcircuit.DAGCircuit#substitute_node_with_dag "qiskit.dagcircuit.DAGCircuit.substitute_node_with_dag"). If you return a tuple and `wires` is `None` this will behave just as if only a [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") was returned. Additionally if this returns `None` no substitution will be made.
+
+**Return type**
+
+[DAGCircuit](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPluginManager.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPluginManager.md
new file mode 100644
index 00000000000..08ab5da53cd
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPluginManager.md
@@ -0,0 +1,20 @@
+---
+title: UnitarySynthesisPluginManager
+description: API reference for qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPluginManager
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPluginManager
+---
+
+# UnitarySynthesisPluginManager
+
+
+
+`qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPluginManager`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/synthesis/plugin.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Unitary Synthesis plugin manager class
+
+This class tracks the installed plugins, it has a single property, `ext_plugins` which contains a list of stevedore plugin objects.
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names.md b/docs/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names.md
new file mode 100644
index 00000000000..e271476482c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names.md
@@ -0,0 +1,26 @@
+---
+title: unitary_synthesis_plugin_names
+description: API reference for qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names
+---
+
+
+
+# qiskit.transpiler.passes.synthesis.plugin.unitary\_synthesis\_plugin\_names
+
+
+
+`qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/passes/synthesis/plugin.py "view source code")
+
+Return a list of installed unitary synthesis plugin names
+
+**Returns**
+
+A list of the installed unitary synthesis plugin names. The plugin names are valid values for the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") kwarg `unitary_synthesis_method`.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePlugin.md b/docs/api/qiskit/0.46/qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePlugin.md
new file mode 100644
index 00000000000..f8f64d28ba1
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePlugin.md
@@ -0,0 +1,39 @@
+---
+title: PassManagerStagePlugin
+description: API reference for qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePlugin
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePlugin
+---
+
+# PassManagerStagePlugin
+
+
+
+`qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePlugin`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/preset_passmanagers/plugin.py "view source code")
+
+Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.12)")
+
+A `PassManagerStagePlugin` is a plugin interface object for using custom stages in [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile").
+
+A `PassManagerStagePlugin` object can be added to an external package and integrated into the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function with an entry point. This will enable users to use the output of [`pass_manager()`](#qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePlugin.pass_manager "qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePlugin.pass_manager") to implement a stage in the compilation process.
+
+## Methods
+
+### pass\_manager
+
+
+
+`abstract pass_manager(pass_manager_config, optimization_level=None)`
+
+This method is designed to return a [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager") for the stage this implements
+
+**Parameters**
+
+* **pass\_manager\_config** ([*PassManagerConfig*](qiskit.transpiler.PassManagerConfig "qiskit.transpiler.passmanager_config.PassManagerConfig")) – A configuration object that defines all the target device specifications and any user specified options to [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") or [`generate_preset_pass_manager()`](transpiler_preset#qiskit.transpiler.preset_passmanagers.generate_preset_pass_manager "qiskit.transpiler.preset_passmanagers.generate_preset_pass_manager")
+* **optimization\_level** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The optimization level of the transpilation, if set this should be used to set values for any tunable parameters to trade off runtime for potential optimization. Valid values should be `0`, `1`, `2`, or `3` and the higher the number the more optimization is expected.
+
+**Return type**
+
+[*PassManager*](qiskit.transpiler.PassManager "qiskit.transpiler.passmanager.PassManager")
+
diff --git a/docs/api/qiskit/0.46/qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePluginManager.md b/docs/api/qiskit/0.46/qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePluginManager.md
new file mode 100644
index 00000000000..3f9d49eb406
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePluginManager.md
@@ -0,0 +1,32 @@
+---
+title: PassManagerStagePluginManager
+description: API reference for qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePluginManager
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePluginManager
+---
+
+# PassManagerStagePluginManager
+
+
+
+`qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePluginManager`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/preset_passmanagers/plugin.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Manager class for preset pass manager stage plugins.
+
+## Methods
+
+### get\_passmanager\_stage
+
+
+
+`get_passmanager_stage(stage_name, plugin_name, pm_config, optimization_level=None)`
+
+Get a stage
+
+**Return type**
+
+[*PassManager*](qiskit.transpiler.PassManager "qiskit.transpiler.passmanager.PassManager")
+
diff --git a/docs/api/qiskit/0.46/qiskit.utils.QuantumInstance.md b/docs/api/qiskit/0.46/qiskit.utils.QuantumInstance.md
new file mode 100644
index 00000000000..d57cf46fdc7
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.utils.QuantumInstance.md
@@ -0,0 +1,316 @@
+---
+title: QuantumInstance
+description: API reference for qiskit.utils.QuantumInstance
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.utils.QuantumInstance
+---
+
+# QuantumInstance
+
+
+
+`qiskit.utils.QuantumInstance(backend, shots=None, seed_simulator=None, basis_gates=None, coupling_map=None, initial_layout=None, pass_manager=None, bound_pass_manager=None, seed_transpiler=None, optimization_level=None, backend_options=None, noise_model=None, timeout=None, wait=5.0, skip_qobj_validation=True, measurement_error_mitigation_cls=None, cals_matrix_refresh_period=30, measurement_error_mitigation_shots=None, job_callback=None, mit_pattern=None, max_job_retries=50)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/utils/quantum_instance.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Deprecated: Quantum Backend including execution setting.
+
+Quantum Instance holds a Qiskit Terra backend as well as configuration for circuit transpilation and execution. When provided to an Aqua algorithm the algorithm will execute the circuits it needs to run using the instance.
+
+
+ The class `qiskit.utils.quantum_instance.QuantumInstance` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/qi\_migration](https://qisk.it/qi_migration).
+
+
+**Parameters**
+
+* **backend** ([*Backend*](qiskit.providers.Backend "qiskit.providers.Backend")) – Instance of selected backend
+* **shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – Number of repetitions of each circuit, for sampling. If None, the shots are extracted from the backend. If the backend has none set, the default is 1024.
+* **seed\_simulator** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – Random seed for simulators
+* **basis\_gates** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*] | None*) – List of basis gate names supported by the target. Defaults to basis gates of the backend.
+* **coupling\_map** (*Optional\[Union\['CouplingMap', List\[List]]]*) – Coupling map (perhaps custom) to target in mapping
+* **initial\_layout** (*Optional\[Union\['Layout', Dict, List]]*) – Initial layout of qubits in mapping
+* **pass\_manager** (*Optional\['PassManager']*) – Pass manager to handle how to compile the circuits. To run only this pass manager and not the `bound_pass_manager`, call the [`transpile()`](#qiskit.utils.QuantumInstance.transpile "qiskit.utils.QuantumInstance.transpile") method with the argument `pass_manager=quantum_instance.unbound_pass_manager`.
+* **bound\_pass\_manager** (*Optional\['PassManager']*) – A second pass manager to apply on bound circuits only, that is, circuits without any free parameters. To only run this pass manager and not `pass_manager` call the [`transpile()`](#qiskit.utils.QuantumInstance.transpile "qiskit.utils.QuantumInstance.transpile") method with the argument `pass_manager=quantum_instance.bound_pass_manager`. manager should also be run.
+* **seed\_transpiler** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The random seed for circuit mapper
+* **optimization\_level** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – How much optimization to perform on the circuits. Higher levels generate more optimized circuits, at the expense of longer transpilation time.
+* **backend\_options** ([*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)") *| None*) – All running options for backend, please refer to the provider of the backend for information as to what options it supports.
+* **noise\_model** (*Optional\['NoiseModel']*) – noise model for simulator
+* **timeout** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – Seconds to wait for job. If None, wait indefinitely.
+* **wait** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Seconds between queries for job result
+* **skip\_qobj\_validation** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Bypass Qobj validation to decrease circuit processing time during submission to backend.
+* **measurement\_error\_mitigation\_cls** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *| None*) – The approach to mitigate measurement errors. The classes [`CompleteMeasFitter`](qiskit.utils.mitigation.CompleteMeasFitter "qiskit.utils.mitigation.CompleteMeasFitter") or [`TensoredMeasFitter`](qiskit.utils.mitigation.TensoredMeasFitter "qiskit.utils.mitigation.TensoredMeasFitter") from the [`qiskit.utils.mitigation`](utils_mitigation#module-qiskit.utils.mitigation "qiskit.utils.mitigation") module can be used here as exact values, not instances. `TensoredMeasFitter` doesn’t support the `subset_fitter` method.
+* **cals\_matrix\_refresh\_period** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – How often to refresh the calibration matrix in measurement mitigation. in minutes
+* **measurement\_error\_mitigation\_shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – The number of shots number for building calibration matrix. If None, the main shots parameter value is used.
+* **job\_callback** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *| None*) – Optional user supplied callback which can be used to monitor job progress as jobs are submitted for processing by an Aqua algorithm. The callback is provided the following arguments: job\_id, job\_status, queue\_position, job
+* **mit\_pattern** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]] | None*) – Qubits on which to perform the TensoredMeasFitter measurement correction, divided to groups according to tensors. If None and qr is given then assumed to be performed over the entire qr as one group (default None).
+* **max\_job\_retries** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – positive non-zero number of trials for the job set (-1 for infinite trials) (default: 50)
+
+**Raises**
+
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – the shots exceeds the maximum number of shots
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – set noise model but the backend does not support that
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – set backend\_options but the backend does not support that
+
+## Attributes
+
+
+
+### backend
+
+Return Backend backend object.
+
+
+
+### backend\_config
+
+Getter of backend\_config.
+
+
+
+### backend\_name
+
+Return backend name.
+
+
+
+### backend\_options
+
+Getter of backend\_options.
+
+
+
+### bound\_pass\_manager
+
+Return the pass manager for designated for bound circuits.
+
+**Returns**
+
+The pass manager for bound circuits, if it has been set.
+
+**Return type**
+
+Optional\[‘PassManager’]
+
+
+
+### cals\_matrix\_refresh\_period
+
+returns matrix refresh period
+
+
+
+### circuit\_summary
+
+Getter of circuit summary.
+
+
+
+### compile\_config
+
+Getter of compile\_config.
+
+
+
+### is\_local
+
+Return True if backend is a local backend.
+
+
+
+### is\_simulator
+
+Return True if backend is a simulator.
+
+
+
+### is\_statevector
+
+Return True if backend is a statevector-type simulator.
+
+
+
+### max\_job\_retries
+
+Getter of max tries
+
+
+
+### measurement\_error\_mitigation\_cls
+
+returns measurement error mitigation cls
+
+
+
+### measurement\_error\_mitigation\_shots
+
+returns measurement error mitigation shots
+
+
+
+### noise\_config
+
+Getter of noise\_config.
+
+
+
+### qjob\_config
+
+Getter of qjob\_config.
+
+
+
+### run\_config
+
+Getter of run\_config.
+
+
+
+### skip\_qobj\_validation
+
+checks if skip qobj validation
+
+
+
+### time\_taken
+
+Accumulated time taken for execution.
+
+
+
+### unbound\_pass\_manager
+
+Return the pass manager for designated for unbound circuits.
+
+**Returns**
+
+The pass manager for unbound circuits, if it has been set.
+
+**Return type**
+
+Optional\[‘PassManager’]
+
+## Methods
+
+### assemble
+
+
+
+`assemble(circuits)`
+
+assemble circuits
+
+**Return type**
+
+[*QasmQobj*](qiskit.qobj.QasmQobj "qiskit.qobj.qasm_qobj.QasmQobj") | [*PulseQobj*](qiskit.qobj.PulseQobj "qiskit.qobj.pulse_qobj.PulseQobj")
+
+### cals\_matrix
+
+
+
+`cals_matrix(qubit_index=None)`
+
+Get the stored calibration matrices and its timestamp.
+
+**Parameters**
+
+**qubit\_index** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – the qubit index of corresponding calibration matrix. If None, return all stored calibration matrices.
+
+**Returns**
+
+The calibration matrix and the creation timestamp if qubit\_index is not None otherwise, return all matrices and their timestamp in a dictionary.
+
+**Return type**
+
+[*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")\[[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)"), [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")] | [*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")\[[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)"), [*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")\[[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)"), [float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")]] | None
+
+### execute
+
+
+
+`execute(circuits, had_transpiled=False)`
+
+A wrapper to interface with quantum backend.
+
+**Parameters**
+
+* **circuits** (*Union\['QuantumCircuit', List\['QuantumCircuit']]*) – circuits to execute
+* **had\_transpiled** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – whether or not circuits had been transpiled
+
+**Raises**
+
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – Invalid error mitigation fitter class
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – TensoredMeasFitter class doesn’t support subset fitter
+* [**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – Ignis not installed
+
+**Returns**
+
+result object
+
+**Return type**
+
+[Result](qiskit.result.Result "qiskit.result.Result")
+
+**TODO: Maybe we can combine the circuits for the main ones and calibration circuits before**
+
+assembling to the qobj.
+
+### maybe\_refresh\_cals\_matrix
+
+
+
+`maybe_refresh_cals_matrix(timestamp=None)`
+
+Calculate the time difference from the query of last time.
+
+**Parameters**
+
+**timestamp** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *| None*) – timestamp
+
+**Returns**
+
+Whether or not refresh the cals\_matrix
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### reset\_execution\_results
+
+
+
+`reset_execution_results()`
+
+Reset execution results
+
+### set\_config
+
+
+
+`set_config(**kwargs)`
+
+Set configurations for the quantum instance.
+
+### transpile
+
+
+
+`transpile(circuits, pass_manager=None)`
+
+A wrapper to transpile circuits to allow algorithm access the transpiled circuits.
+
+**Parameters**
+
+* **circuits** (*Union\['QuantumCircuit', List\['QuantumCircuit']]*) – circuits to transpile
+* **pass\_manager** (*Optional\['PassManager']*) – A pass manager to transpile the circuits. If none is given, but either `pass_manager` or `bound_pass_manager` has been set in the initializer, these are run. If none has been provided there either, the backend and compile configs from the initializer are used.
+
+**Returns**
+
+**The transpiled circuits, it is always a list even though**
+
+the length is one.
+
+**Return type**
+
+List\[‘QuantumCircuit’]
+
diff --git a/docs/api/qiskit/0.46/qiskit.utils.mitigation.CompleteMeasFitter.md b/docs/api/qiskit/0.46/qiskit.utils.mitigation.CompleteMeasFitter.md
new file mode 100644
index 00000000000..7a71cec3797
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.utils.mitigation.CompleteMeasFitter.md
@@ -0,0 +1,128 @@
+---
+title: CompleteMeasFitter
+description: API reference for qiskit.utils.mitigation.CompleteMeasFitter
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.utils.mitigation.CompleteMeasFitter
+---
+
+# CompleteMeasFitter
+
+
+
+`qiskit.utils.mitigation.CompleteMeasFitter(results, state_labels, qubit_list=None, circlabel='')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/utils/mitigation/fitters.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Deprecated: Measurement correction fitter for a full calibration
+
+Initialize a measurement calibration matrix from the results of running the circuits returned by measurement\_calibration\_circuits
+
+A wrapper for the tensored fitter
+
+
+ This class is not a public API. The internals are not stable and will likely change. It is used solely for the `measurement_error_mitigation_cls` kwarg of the [`QuantumInstance`](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance") class’s constructor (as a class not an instance). Anything outside of that usage does not have the normal user-facing API stability.
+
+
+
+ The class `qiskit.utils.mitigation.fitters.CompleteMeasFitter` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/qi\_migration](https://qisk.it/qi_migration).
+
+
+**Parameters**
+
+* **results** – the results of running the measurement calibration circuits. If this is None the user will set a calibration matrix later.
+* **state\_labels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – list of calibration state labels returned from measurement\_calibration\_circuits. The output matrix will obey this ordering.
+* **qubit\_list** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]*) – List of the qubits (for reference and if the subset is needed). If None, the qubit\_list will be created according to the length of state\_labels\[0].
+* **circlabel** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – if the qubits were labeled.
+
+## Attributes
+
+
+
+### cal\_matrix
+
+Return cal\_matrix.
+
+
+
+### filter
+
+Return a measurement filter using the cal matrix.
+
+
+
+### qubit\_list
+
+Return list of qubits.
+
+
+
+### state\_labels
+
+Return state\_labels.
+
+## Methods
+
+### add\_data
+
+
+
+`add_data(new_results, rebuild_cal_matrix=True)`
+
+Add measurement calibration data
+
+**Parameters**
+
+* **new\_results** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or*[*qiskit.result.Result*](qiskit.result.Result "qiskit.result.Result")) – a single result or list of result objects.
+* **rebuild\_cal\_matrix** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – rebuild the calibration matrix
+
+### readout\_fidelity
+
+
+
+`readout_fidelity(label_list=None)`
+
+Based on the results, output the readout fidelity which is the normalized trace of the calibration matrix
+
+**Parameters**
+
+**label\_list** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If None, returns the average assignment fidelity of a single state. Otherwise it returns the assignment fidelity to be in any one of these states averaged over the second index.
+
+**Returns**
+
+readout fidelity (assignment fidelity)
+
+**Return type**
+
+numpy.array
+
+**Additional Information:**
+
+The on-diagonal elements of the calibration matrix are the probabilities of measuring state ‘x’ given preparation of state ‘x’ and so the normalized trace is the average assignment fidelity
+
+### subset\_fitter
+
+
+
+`subset_fitter(qubit_sublist)`
+
+Return a fitter object that is a subset of the qubits in the original list.
+
+**Parameters**
+
+**qubit\_sublist** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – must be a subset of qubit\_list
+
+**Returns**
+
+**A new fitter that has the calibration for a**
+
+subset of qubits
+
+**Return type**
+
+[CompleteMeasFitter](#qiskit.utils.mitigation.CompleteMeasFitter "qiskit.utils.mitigation.CompleteMeasFitter")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If the calibration matrix is not initialized
+
diff --git a/docs/api/qiskit/0.46/qiskit.utils.mitigation.TensoredMeasFitter.md b/docs/api/qiskit/0.46/qiskit.utils.mitigation.TensoredMeasFitter.md
new file mode 100644
index 00000000000..0c48b247637
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.utils.mitigation.TensoredMeasFitter.md
@@ -0,0 +1,139 @@
+---
+title: TensoredMeasFitter
+description: API reference for qiskit.utils.mitigation.TensoredMeasFitter
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.utils.mitigation.TensoredMeasFitter
+---
+
+# TensoredMeasFitter
+
+
+
+`qiskit.utils.mitigation.TensoredMeasFitter(results, mit_pattern, substate_labels_list=None, circlabel='')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/utils/mitigation/fitters.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Deprecated: Measurement correction fitter for a tensored calibration.
+
+Initialize a measurement calibration matrix from the results of running the circuits returned by measurement\_calibration\_circuits.
+
+
+ This class is not a public API. The internals are not stable and will likely change. It is used solely for the `measurement_error_mitigation_cls` kwarg of the [`QuantumInstance`](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance") class’s constructor (as a class not an instance). Anything outside of that usage does not have the normal user-facing API stability.
+
+
+
+ The class `qiskit.utils.mitigation.fitters.TensoredMeasFitter` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/qi\_migration](https://qisk.it/qi_migration).
+
+
+**Parameters**
+
+* **results** – the results of running the measurement calibration circuits. If this is None, the user will set calibration matrices later.
+* **mit\_pattern** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]]*) – qubits to perform the measurement correction on, divided to groups according to tensors
+* **substate\_labels\_list** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]]*) – for each calibration matrix, the labels of its rows and columns. If None, the labels are ordered lexicographically
+* **circlabel** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – if the qubits were labeled
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – if the mit\_pattern doesn’t match the substate\_labels\_list
+
+## Attributes
+
+
+
+### cal\_matrices
+
+Return cal\_matrices.
+
+
+
+### filter
+
+Return a measurement filter using the cal matrices.
+
+
+
+### nqubits
+
+Return \_qubit\_list\_sizes.
+
+
+
+### substate\_labels\_list
+
+Return \_substate\_labels\_list.
+
+## Methods
+
+### add\_data
+
+
+
+`add_data(new_results, rebuild_cal_matrix=True)`
+
+Add measurement calibration data
+
+**Parameters**
+
+* **new\_results** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or*[*qiskit.result.Result*](qiskit.result.Result "qiskit.result.Result")) – a single result or list of Result objects.
+* **rebuild\_cal\_matrix** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – rebuild the calibration matrix
+
+### readout\_fidelity
+
+
+
+`readout_fidelity(cal_index=0, label_list=None)`
+
+Based on the results, output the readout fidelity, which is the average of the diagonal entries in the calibration matrices.
+
+**Parameters**
+
+* **cal\_index** (*integer*) – readout fidelity for this index in \_cal\_matrices
+* **label\_list** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – Returns the average fidelity over of the groups f states. In the form of a list of lists of states. If None, then each state used in the construction of the calibration matrices forms a group of size 1
+
+**Returns**
+
+The readout fidelity (assignment fidelity)
+
+**Return type**
+
+numpy.array
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If the calibration matrix has not been set for the object.
+
+**Additional Information:**
+
+The on-diagonal elements of the calibration matrices are the probabilities of measuring state ‘x’ given preparation of state ‘x’.
+
+### subset\_fitter
+
+
+
+`subset_fitter(qubit_sublist)`
+
+Return a fitter object that is a subset of the qubits in the original list.
+
+This is only a partial implementation of the `subset_fitter` method since only mitigation patterns of length 1 are supported. This corresponds to patterns of the form `[[0], [1], [2], ...]`. Note however, that such patterns are a good first approximation to mitigate readout errors on large quantum circuits.
+
+**Parameters**
+
+**qubit\_sublist** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – must be a subset of qubit\_list
+
+**Returns**
+
+**A new fitter that has the calibration for a**
+
+subset of qubits
+
+**Return type**
+
+[TensoredMeasFitter](#qiskit.utils.mitigation.TensoredMeasFitter "qiskit.utils.mitigation.TensoredMeasFitter")
+
+**Raises**
+
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If the calibration matrix is not initialized
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If the mit pattern is not a tensor of single-qubit measurement error mitigation.
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If a qubit in the given `qubit_sublist` is not in the list of qubits in the mit. pattern.
+
diff --git a/docs/api/qiskit/0.46/qiskit.visualization.array_to_latex.md b/docs/api/qiskit/0.46/qiskit.visualization.array_to_latex.md
new file mode 100644
index 00000000000..6846804a895
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.visualization.array_to_latex.md
@@ -0,0 +1,51 @@
+---
+title: array_to_latex
+description: API reference for qiskit.visualization.array_to_latex
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.visualization.array_to_latex
+---
+
+
+
+# qiskit.visualization.array\_to\_latex
+
+
+
+`qiskit.visualization.array_to_latex(array, precision=10, prefix='', source=False, max_size=8)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/visualization/array.py "view source code")
+
+Latex representation of a complex numpy array (with dimension 1 or 2)
+
+**Parameters**
+
+* **array** (*ndarray*) – The array to be converted to latex, must have dimension 1 or 2 and contain only numerical data.
+
+* **precision** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – For numbers not close to integers or common terms, the number of decimal places to round to.
+
+* **prefix** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Latex string to be prepended to the latex, intended for labels.
+
+* **source** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If `False`, will return IPython.display.Latex object. If display is `True`, will instead return the LaTeX source string.
+
+* **max\_size** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*(*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*) or* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) –
+
+ The maximum size of the output Latex array.
+
+ * If list(`int`), then the 0th element of the list specifies the maximum width (including dots characters) and the 1st specifies the maximum height (also inc. dots characters).
+ * If a single `int` then this value sets the maximum width \_and\_ maximum height.
+
+**Returns**
+
+**If `source` is `True`, a `str` of the LaTeX**
+
+representation of the array, else an `IPython.display.Latex` representation of the array.
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") or IPython.display.Latex
+
+**Raises**
+
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – If array can not be interpreted as a numerical numpy array.
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If the dimension of array is not 1 or 2.
+* [**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – If `source` is `False` and `IPython.display.Latex` cannot be imported.
+
diff --git a/docs/api/qiskit/0.46/qiskit.visualization.circuit.qcstyle.DefaultStyle.md b/docs/api/qiskit/0.46/qiskit.visualization.circuit.qcstyle.DefaultStyle.md
new file mode 100644
index 00000000000..646f7fcbc40
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.visualization.circuit.qcstyle.DefaultStyle.md
@@ -0,0 +1,161 @@
+---
+title: DefaultStyle
+description: API reference for qiskit.visualization.circuit.qcstyle.DefaultStyle
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.visualization.circuit.qcstyle.DefaultStyle
+---
+
+# DefaultStyle
+
+
+
+`qiskit.visualization.circuit.qcstyle.DefaultStyle`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/visualization/circuit/qcstyle.py "view source code")
+
+Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.12)")
+
+Creates a Default Style dictionary
+
+**Style Dict Details**
+
+The style dict contains numerous options that define the style of the output circuit visualization. The style dict is used by the mpl or latex output. The options available in the style dict are defined below:
+
+**name (str): the name of the style. The name can be set to `iqp`,**
+
+`iqp-dark`, `textbook`, `bw`, `clifford`, or the name of a user-created json file. This overrides the setting in the user config file (usually `~/.qiskit/settings.conf`).
+
+**textcolor (str): the color code to use for all text not inside a gate.**
+
+Defaults to `#000000`
+
+**subtextcolor (str): the color code to use for subtext. Defaults to**
+
+`#000000`
+
+**linecolor (str): the color code to use for lines. Defaults to**
+
+`#000000`
+
+**creglinecolor (str): the color code to use for classical register**
+
+lines. Defaults to `#778899`
+
+**gatetextcolor (str): the color code to use for gate text. Defaults to**
+
+`#000000`
+
+**gatefacecolor (str): the color code to use for a gate if no color**
+
+specified in the ‘displaycolor’ dict. Defaults to `#BB8BFF`
+
+**barrierfacecolor (str): the color code to use for barriers. Defaults to**
+
+`#BDBDBD`
+
+**backgroundcolor (str): the color code to use for the background.**
+
+Defaults to `#FFFFFF`
+
+**edgecolor (str): the color code to use for gate edges when using the**
+
+bw style. Defaults to `#000000`.
+
+fontsize (int): the font size to use for text. Defaults to 13.
+
+subfontsize (int): the font size to use for subtext. Defaults to 8.
+
+**showindex (bool): if set to True, show the index numbers at the top.**
+
+Defaults to False.
+
+**figwidth (int): the maximum width (in inches) for the output figure.**
+
+If set to -1, the maximum displayable width will be used. Defaults to -1.
+
+dpi (int): the DPI to use for the output image. Defaults to 150.
+
+**margin (list): a list of margin values to adjust spacing around output**
+
+image. Takes a list of 4 ints: \[x left, x right, y bottom, y top]. Defaults to \[2.0, 0.1, 0.1, 0.3].
+
+**creglinestyle (str): The style of line to use for classical registers.**
+
+Choices are `solid`, `doublet`, or any valid matplotlib linestyle kwarg value. Defaults to `doublet`.
+
+**displaytext (dict): a dictionary of the text to use for certain element**
+
+types in the output visualization. These items allow the use of LaTeX formatting for gate names. The ‘displaytext’ dict can contain any number of elements. User created names and labels may be used as keys, which allow these to have Latex formatting. The default values are (default.json):
+
+```python
+{
+ 'u1': 'U_1',
+ 'u2': 'U_2',
+ 'u3': 'U_3',
+ 'sdg': 'S^\dagger',
+ 'sx': '\sqrt{X}',
+ 'sxdg': '\sqrt{X}^\dagger',
+ 't': 'T',
+ 'tdg': 'T^\dagger',
+ 'dcx': 'Dcx',
+ 'iswap': 'Iswap',
+ 'ms': 'MS',
+ 'rx': 'R_X',
+ 'ry': 'R_Y',
+ 'rz': 'R_Z',
+ 'rxx': 'R_{XX}',
+ 'ryy': 'R_{YY}',
+ 'rzx': 'R_{ZX}',
+ 'rzz': 'ZZ',
+ 'reset': '\left|0\right\rangle',
+ 'initialize': '|\psi\rangle'
+}
+```
+
+**displaycolor (dict): the color codes to use for each circuit element in**
+
+the form (gate\_color, text\_color). Colors can also be entered without the text color, such as ‘u1’: ‘#FA74A6’, in which case the text color will always be gatetextcolor. The displaycolor dict can contain any number of elements. User names and labels may be used as keys, which allows for custom colors for user-created gates. The default values are (default.json):
+
+```python
+{
+ 'u1': ('#FA74A6', '#000000'),
+ 'u2': ('#FA74A6', '#000000'),
+ 'u3': ('#FA74A6', '#000000'),
+ 'id': ('#05BAB6', '#000000'),
+ 'u': ('#BB8BFF', '#000000'),
+ 'p': ('#BB8BFF', '#000000'),
+ 'x': ('#05BAB6', '#000000'),
+ 'y': ('#05BAB6', '#000000'),
+ 'z': ('#05BAB6', '#000000'),
+ 'h': ('#6FA4FF', '#000000'),
+ 'cx': ('#6FA4FF', '#000000'),
+ 'ccx': ('#BB8BFF', '#000000'),
+ 'mcx': ('#BB8BFF', '#000000'),
+ 'mcx_gray': ('#BB8BFF', '#000000'),
+ 'cy': ('#6FA4FF', '#000000'),
+ 'cz': ('#6FA4FF', '#000000'),
+ 'swap': ('#6FA4FF', '#000000'),
+ 'cswap': ('#BB8BFF', '#000000'),
+ 'ccswap': ('#BB8BFF', '#000000'),
+ 'dcx': ('#6FA4FF', '#000000'),
+ 'cdcx': ('#BB8BFF', '#000000'),
+ 'ccdcx': ('#BB8BFF', '#000000'),
+ 'iswap': ('#6FA4FF', '#000000'),
+ 's': ('#6FA4FF', '#000000'),
+ 'sdg': ('#6FA4FF', '#000000'),
+ 't': ('#BB8BFF', '#000000'),
+ 'tdg': ('#BB8BFF', '#000000'),
+ 'sx': ('#6FA4FF', '#000000'),
+ 'sxdg': ('#6FA4FF', '#000000')
+ 'r': ('#BB8BFF', '#000000'),
+ 'rx': ('#BB8BFF', '#000000'),
+ 'ry': ('#BB8BFF', '#000000'),
+ 'rz': ('#BB8BFF', '#000000'),
+ 'rxx': ('#BB8BFF', '#000000'),
+ 'ryy': ('#BB8BFF', '#000000'),
+ 'rzx': ('#BB8BFF', '#000000'),
+ 'reset': ('#000000', '#FFFFFF'),
+ 'target': ('#FFFFFF', '#FFFFFF'),
+ 'measure': ('#000000', '#FFFFFF'),
+}
+```
+
diff --git a/docs/api/qiskit/0.46/qiskit.visualization.circuit_drawer.md b/docs/api/qiskit/0.46/qiskit.visualization.circuit_drawer.md
new file mode 100644
index 00000000000..5a089c3f88b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.visualization.circuit_drawer.md
@@ -0,0 +1,91 @@
+---
+title: circuit_drawer
+description: API reference for qiskit.visualization.circuit_drawer
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.visualization.circuit_drawer
+---
+
+
+
+# qiskit.visualization.circuit\_drawer
+
+
+
+`qiskit.visualization.circuit_drawer(circuit, scale=None, filename=None, style=None, output=None, interactive=False, plot_barriers=True, reverse_bits=None, justify=None, vertical_compression='medium', idle_wires=True, with_layout=True, fold=None, ax=None, initial_state=False, cregbundle=None, wire_order=None, expr_len=30)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/visualization/circuit/circuit_visualization.py "view source code")
+
+Draw the quantum circuit. Use the output parameter to choose the drawing format:
+
+**text**: ASCII art TextDrawing that can be printed in the console.
+
+**matplotlib**: images with color rendered purely in Python.
+
+**latex**: high-quality images compiled via latex.
+
+**latex\_source**: raw uncompiled latex output.
+
+
+ Support for [`Expr`](circuit_classical#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.Expr") nodes in conditions and `SwitchCaseOp.target` fields is preliminary and incomplete. The `text` and `mpl` drawers will make a best-effort attempt to show data dependencies, but the LaTeX-based drawers will skip these completely.
+
+
+**Parameters**
+
+* **circuit** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – the quantum circuit to draw
+* **scale** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – scale of image to draw (shrink if \< 1.0). Only used by the mpl, latex and latex\_source outputs. Defaults to 1.0.
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – file path to save image to. Defaults to None.
+* **style** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – dictionary of style or file name of style json file. This option is only used by the mpl or latex output type. If style is a str, it is used as the path to a json file which contains a style dict. The file will be opened, parsed, and then any style elements in the dict will replace the default values in the input dict. A file to be loaded must end in `.json`, but the name entered here can omit `.json`. For example, `style='iqp.json'` or `style='iqp'`. If style is a dict and the `'name'` key is set, that name will be used to load a json file, followed by loading the other items in the style dict. For example, `style={'name': 'iqp'}`. If style is not a str and name is not a key in the style dict, then the default value from the user config file (usually `~/.qiskit/settings.conf`) will be used, for example, `circuit_mpl_style = iqp`. If none of these are set, the clifford style will be used. The search path for style json files can be specified in the user config, for example, `circuit_mpl_style_path = /home/user/styles:/home/user`. See: [`DefaultStyle`](qiskit.visualization.circuit.qcstyle.DefaultStyle "qiskit.visualization.circuit.qcstyle.DefaultStyle") for more information on the contents.
+* **output** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – select the output method to use for drawing the circuit. Valid choices are `text`, `mpl`, `latex`, `latex_source`. By default, the text drawer is used unless the user config file (usually `~/.qiskit/settings.conf`) has an alternative backend set as the default. For example, `circuit_drawer = latex`. If the output kwarg is set, that backend will always be used over the default in the user config file.
+* **interactive** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – when set to true, show the circuit in a new window (for mpl this depends on the matplotlib backend being used supporting this). Note when used with either the text or the latex\_source output type this has no effect and will be silently ignored. Defaults to False.
+* **reverse\_bits** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – when set to True, reverse the bit order inside registers for the output visualization. Defaults to False unless the user config file (usually `~/.qiskit/settings.conf`) has an alternative value set. For example, `circuit_reverse_bits = True`.
+* **plot\_barriers** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – enable/disable drawing barriers in the output circuit. Defaults to True.
+* **justify** (*string*) – options are `left`, `right` or `none`. If anything else is supplied, it defaults to left justified. It refers to where gates should be placed in the output circuit if there is an option. `none` results in each gate being placed in its own column.
+* **vertical\_compression** (*string*) – `high`, `medium` or `low`. It merges the lines generated by the text output so the drawing will take less vertical room. Default is `medium`. Only used by the text output, will be silently ignored otherwise.
+* **idle\_wires** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – include idle wires (wires with no circuit elements) in output visualization. Default is True.
+* **with\_layout** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – include layout information, with labels on the physical layout. Default is True.
+* **fold** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – sets pagination. It can be disabled using -1. In text, sets the length of the lines. This is useful when the drawing does not fit in the console. If None (default), it will try to guess the console width using `shutil.get_terminal_size()`. However, if running in jupyter, the default line length is set to 80 characters. In mpl, it is the number of (visual) layers before folding. Default is 25.
+* **ax** ([*matplotlib.axes.Axes*](https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.html#matplotlib.axes.Axes "(in Matplotlib v3.8.2)")) – Only used by the mpl backend. An optional Axes object to be used for the visualization output. If none is specified, a new matplotlib Figure will be created and used. Additionally, if specified there will be no returned Figure since it is redundant.
+* **initial\_state** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Optional. Adds `|0>` in the beginning of the wire. Default is False.
+* **cregbundle** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Optional. If set True, bundle classical registers into a single wire. Default is true if possible, and false if a block instruction needs to access an individual bit from a register.
+* **wire\_order** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – Optional. A list of integers used to reorder the display of the bits. The list must have an entry for every bit with the bits in the range 0 to (num\_qubits + num\_clbits).
+* **expr\_len** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Optional. The number of characters to display if an [`Expr`](circuit_classical#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.Expr") is used for the condition in a [`ControlFlowOp`](qiskit.circuit.ControlFlowOp "qiskit.circuit.ControlFlowOp"). If this number is exceeded, the string will be truncated at that number and ‘…’ added to the end.
+
+**Returns**
+
+`TextDrawing` or `matplotlib.figure` or `PIL.Image` or [`str`](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)"):
+
+* **TextDrawing (output=’text’)**
+
+ A drawing that can be printed as ascii art.
+
+* **matplotlib.figure.Figure (output=’mpl’)**
+
+ A matplotlib figure object for the circuit diagram.
+
+* **PIL.Image (output=’latex’)**
+
+ An in-memory representation of the image of the circuit diagram.
+
+* **str (output=’latex\_source’)**
+
+ The LaTeX source code for visualizing the circuit diagram.
+
+**Raises**
+
+* [**VisualizationError**](visualization#qiskit.visualization.VisualizationError "qiskit.visualization.VisualizationError") – when an invalid output method is selected
+* [**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – when the output methods requires non-installed libraries.
+
+**Example**
+
+```python
+from qiskit import QuantumRegister, ClassicalRegister, QuantumCircuit
+from qiskit.tools.visualization import circuit_drawer
+q = QuantumRegister(1)
+c = ClassicalRegister(1)
+qc = QuantumCircuit(q, c)
+qc.h(q)
+qc.measure(q, c)
+circuit_drawer(qc, output='mpl', style={'backgroundcolor': '#EEEEEE'})
+```
+
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.visualization.dag_drawer.md b/docs/api/qiskit/0.46/qiskit.visualization.dag_drawer.md
new file mode 100644
index 00000000000..e715833e0f2
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.visualization.dag_drawer.md
@@ -0,0 +1,62 @@
+---
+title: dag_drawer
+description: API reference for qiskit.visualization.dag_drawer
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.visualization.dag_drawer
+---
+
+
+
+# qiskit.visualization.dag\_drawer
+
+
+
+`qiskit.visualization.dag_drawer(dag, scale=0.7, filename=None, style='color')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/visualization/dag_visualization.py "view source code")
+
+Plot the directed acyclic graph (dag) to represent operation dependencies in a quantum circuit.
+
+This function calls the [`graphviz_draw()`](https://www.rustworkx.org/apiref/rustworkx.visualization.graphviz_draw.html#rustworkx.visualization.graphviz_draw "(in rustworkx v0.14.0)") function from the `rustworkx` package to draw the DAG.
+
+**Parameters**
+
+* **dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit")) – The dag to draw.
+* **scale** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – scaling factor
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – file path to save image to (format inferred from name)
+* **style** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – ‘plain’: B\&W graph ‘color’ (default): color input/output/op nodes
+
+**Returns**
+
+**if in Jupyter notebook and not saving to file,**
+
+otherwise None.
+
+**Return type**
+
+PIL.Image
+
+**Raises**
+
+* [**VisualizationError**](visualization#qiskit.visualization.VisualizationError "qiskit.visualization.VisualizationError") – when style is not recognized.
+* [**InvalidFileError**](exceptions#qiskit.exceptions.InvalidFileError "qiskit.exceptions.InvalidFileError") – when filename provided is not valid
+
+**Example**
+
+```python
+from qiskit import QuantumRegister, ClassicalRegister, QuantumCircuit
+from qiskit.dagcircuit import DAGCircuit
+from qiskit.converters import circuit_to_dag
+from qiskit.visualization import dag_drawer
+
+q = QuantumRegister(3, 'q')
+c = ClassicalRegister(3, 'c')
+circ = QuantumCircuit(q, c)
+circ.h(q[0])
+circ.cx(q[0], q[1])
+circ.measure(q[0], c[0])
+circ.rz(0.5, q[1]).c_if(c, 2)
+
+dag = circuit_to_dag(circ)
+dag_drawer(dag)
+```
+
diff --git a/docs/api/qiskit/0.46/qiskit.visualization.pass_manager_drawer.md b/docs/api/qiskit/0.46/qiskit.visualization.pass_manager_drawer.md
new file mode 100644
index 00000000000..068c6b20607
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.visualization.pass_manager_drawer.md
@@ -0,0 +1,62 @@
+---
+title: pass_manager_drawer
+description: API reference for qiskit.visualization.pass_manager_drawer
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.visualization.pass_manager_drawer
+---
+
+
+
+# qiskit.visualization.pass\_manager\_drawer
+
+
+
+`qiskit.visualization.pass_manager_drawer(pass_manager, filename=None, style=None, raw=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/visualization/pass_manager_visualization.py "view source code")
+
+Draws the pass manager.
+
+This function needs [pydot](https://github.com/pydot/pydot), which in turn needs [Graphviz](https://www.graphviz.org/) to be installed.
+
+**Parameters**
+
+* **pass\_manager** ([*PassManager*](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager")) – the pass manager to be drawn
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – file path to save image to
+* **style** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *or OrderedDict*) – keys are the pass classes and the values are the colors to make them. An example can be seen in the DEFAULT\_STYLE. An ordered dict can be used to ensure a priority coloring when pass falls into multiple categories. Any values not included in the provided dict will be filled in from the default dict
+* **raw** ([*Bool*](circuit_classical#qiskit.circuit.classical.types.Bool "qiskit.circuit.classical.types.Bool")) – True if you want to save the raw Dot output not an image. The default is False.
+
+**Returns**
+
+an in-memory representation of the pass manager. Or None if no image was generated or PIL is not installed.
+
+**Return type**
+
+PIL.Image or None
+
+**Raises**
+
+* [**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – when nxpd or pydot not installed.
+* [**VisualizationError**](visualization#qiskit.visualization.VisualizationError "qiskit.visualization.VisualizationError") – If raw=True and filename=None.
+
+**Example**
+
+```python
+ %matplotlib inline
+from qiskit import QuantumCircuit
+from qiskit.compiler import transpile
+from qiskit.transpiler import PassManager
+from qiskit.visualization import pass_manager_drawer
+from qiskit.transpiler.passes import Unroller
+
+circ = QuantumCircuit(3)
+circ.ccx(0, 1, 2)
+circ.draw()
+
+pass_ = Unroller(['u1', 'u2', 'u3', 'cx'])
+pm = PassManager(pass_)
+new_circ = pm.run(circ)
+new_circ.draw(output='mpl')
+
+pass_manager_drawer(pm, "passmanager.jpg")
+```
+
diff --git a/docs/api/qiskit/0.46/qiskit.visualization.plot_bloch_multivector.md b/docs/api/qiskit/0.46/qiskit.visualization.plot_bloch_multivector.md
new file mode 100644
index 00000000000..9163bb4f15b
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.visualization.plot_bloch_multivector.md
@@ -0,0 +1,85 @@
+---
+title: plot_bloch_multivector
+description: API reference for qiskit.visualization.plot_bloch_multivector
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.visualization.plot_bloch_multivector
+---
+
+
+
+# qiskit.visualization.plot\_bloch\_multivector
+
+
+
+`qiskit.visualization.plot_bloch_multivector(state, title='', figsize=None, *, reverse_bits=False, filename=None, font_size=None, title_font_size=None, title_pad=1)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/visualization/state_visualization.py "view source code")
+
+Plot a Bloch sphere for each qubit.
+
+Each component $(x,y,z)$ of the Bloch sphere labeled as ‘qubit i’ represents the expected value of the corresponding Pauli operator acting only on that qubit, that is, the expected value of $I_{N-1} \otimes\dotsb\otimes I_{i+1}\otimes P_i \otimes I_{i-1}\otimes\dotsb\otimes I_0$, where $N$ is the number of qubits, $P\in \{X,Y,Z\}$ and $I$ is the identity operator.
+
+**Parameters**
+
+* **state** ([*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") *or*[*DensityMatrix*](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix") *or ndarray*) – an N-qubit quantum state.
+* **title** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – a string that represents the plot title
+* **figsize** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – size of each individual Bloch sphere figure, in inches.
+* **reverse\_bits** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, plots qubits following Qiskit’s convention \[Default:False].
+* **font\_size** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Font size for the Bloch ball figures.
+* **title\_font\_size** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Font size for the title.
+* **title\_pad** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Padding for the title (suptitle y position is y=1+title\_pad/100).
+
+**Returns**
+
+A matplotlib figure instance.
+
+**Return type**
+
+[`matplotlib.figure.Figure`](https://matplotlib.org/stable/api/figure_api.html#matplotlib.figure.Figure "(in Matplotlib v3.8.2)")
+
+**Raises**
+
+* [**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – Requires matplotlib.
+* [**VisualizationError**](visualization#qiskit.visualization.VisualizationError "qiskit.visualization.VisualizationError") – if input is not a valid N-qubit state.
+
+**Examples**
+
+```python
+from qiskit import QuantumCircuit
+from qiskit.quantum_info import Statevector
+from qiskit.visualization import plot_bloch_multivector
+
+qc = QuantumCircuit(2)
+qc.h(0)
+qc.x(1)
+
+state = Statevector(qc)
+plot_bloch_multivector(state)
+```
+
+
+
+```python
+from qiskit import QuantumCircuit
+from qiskit.quantum_info import Statevector
+from qiskit.visualization import plot_bloch_multivector
+
+qc = QuantumCircuit(2)
+qc.h(0)
+qc.x(1)
+
+# You can reverse the order of the qubits.
+
+from qiskit.quantum_info import DensityMatrix
+
+qc = QuantumCircuit(2)
+qc.h([0, 1])
+qc.t(1)
+qc.s(0)
+qc.cx(0,1)
+
+matrix = DensityMatrix(qc)
+plot_bloch_multivector(matrix, title='My Bloch Spheres', reverse_bits=True)
+```
+
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.visualization.plot_bloch_vector.md b/docs/api/qiskit/0.46/qiskit.visualization.plot_bloch_vector.md
new file mode 100644
index 00000000000..7de41a589f2
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.visualization.plot_bloch_vector.md
@@ -0,0 +1,62 @@
+---
+title: plot_bloch_vector
+description: API reference for qiskit.visualization.plot_bloch_vector
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.visualization.plot_bloch_vector
+---
+
+
+
+# qiskit.visualization.plot\_bloch\_vector
+
+
+
+`qiskit.visualization.plot_bloch_vector(bloch, title='', ax=None, figsize=None, coord_type='cartesian', font_size=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/visualization/state_visualization.py "view source code")
+
+Plot the Bloch sphere.
+
+Plot a Bloch sphere with the specified coordinates, that can be given in both cartesian and spherical systems.
+
+**Parameters**
+
+* **bloch** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[double]*) – array of three elements where \[\, \, \] (Cartesian) or \[\, \, \] (spherical in radians) \ is inclination angle from +z direction \ is azimuth from +x direction
+* **title** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – a string that represents the plot title
+* **ax** ([*matplotlib.axes.Axes*](https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.html#matplotlib.axes.Axes "(in Matplotlib v3.8.2)")) – An Axes to use for rendering the bloch sphere
+* **figsize** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – Figure size in inches. Has no effect is passing `ax`.
+* **coord\_type** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – a string that specifies coordinate type for bloch (Cartesian or spherical), default is Cartesian
+* **font\_size** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Font size.
+
+**Returns**
+
+A matplotlib figure instance if `ax = None`.
+
+**Return type**
+
+[`matplotlib.figure.Figure`](https://matplotlib.org/stable/api/figure_api.html#matplotlib.figure.Figure "(in Matplotlib v3.8.2)")
+
+**Raises**
+
+[**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – Requires matplotlib.
+
+**Examples**
+
+```python
+from qiskit.visualization import plot_bloch_vector
+
+plot_bloch_vector([0,1,0], title="New Bloch Sphere")
+```
+
+
+
+```python
+import numpy as np
+from qiskit.visualization import plot_bloch_vector
+
+# You can use spherical coordinates instead of cartesian.
+
+plot_bloch_vector([1, np.pi/2, np.pi/3], coord_type='spherical')
+```
+
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.visualization.plot_circuit_layout.md b/docs/api/qiskit/0.46/qiskit.visualization.plot_circuit_layout.md
new file mode 100644
index 00000000000..e9135816645
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.visualization.plot_circuit_layout.md
@@ -0,0 +1,62 @@
+---
+title: plot_circuit_layout
+description: API reference for qiskit.visualization.plot_circuit_layout
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.visualization.plot_circuit_layout
+---
+
+
+
+# qiskit.visualization.plot\_circuit\_layout
+
+
+
+`qiskit.visualization.plot_circuit_layout(circuit, backend, view='virtual', qubit_coordinates=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/visualization/gate_map.py "view source code")
+
+Plot the layout of a circuit transpiled for a given target backend.
+
+**Parameters**
+
+* **circuit** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – Input quantum circuit.
+* **backend** ([*Backend*](qiskit.providers.Backend "qiskit.providers.Backend")) – Target backend.
+* **view** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Layout view: either ‘virtual’ or ‘physical’.
+* **qubit\_coordinates** (*Sequence*) – An optional sequence input (list or array being the most common) of 2d coordinates for each qubit. The length of the sequence must match the number of qubits on the backend. The sequence should be the planar coordinates in a 0-based square grid where each qubit is located.
+
+**Returns**
+
+A matplotlib figure showing layout.
+
+**Return type**
+
+Figure
+
+**Raises**
+
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – Invalid view type given.
+* [**VisualizationError**](visualization#qiskit.visualization.VisualizationError "qiskit.visualization.VisualizationError") – Circuit has no layout attribute.
+
+**Example**
+
+```python
+import numpy as np
+from qiskit import QuantumCircuit, transpile
+from qiskit.providers.fake_provider import FakeVigoV2
+from qiskit.visualization import plot_circuit_layout
+from qiskit.tools.monitor import job_monitor
+from qiskit.providers.fake_provider import FakeVigoV2
+import matplotlib.pyplot as plt
+
+ghz = QuantumCircuit(3, 3)
+ghz.h(0)
+for idx in range(1,3):
+ ghz.cx(0,idx)
+ghz.measure(range(3), range(3))
+
+backend = FakeVigoV2()
+new_circ_lv3 = transpile(ghz, backend=backend, optimization_level=3)
+plot_circuit_layout(new_circ_lv3, backend)
+```
+
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.visualization.plot_coupling_map.md b/docs/api/qiskit/0.46/qiskit.visualization.plot_coupling_map.md
new file mode 100644
index 00000000000..c8aaf26be62
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.visualization.plot_coupling_map.md
@@ -0,0 +1,62 @@
+---
+title: plot_coupling_map
+description: API reference for qiskit.visualization.plot_coupling_map
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.visualization.plot_coupling_map
+---
+
+
+
+# qiskit.visualization.plot\_coupling\_map
+
+
+
+`qiskit.visualization.plot_coupling_map(num_qubits, qubit_coordinates, coupling_map, figsize=None, plot_directed=False, label_qubits=True, qubit_size=None, line_width=4, font_size=None, qubit_color=None, qubit_labels=None, line_color=None, font_color='white', ax=None, filename=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/visualization/gate_map.py "view source code")
+
+Plots an arbitrary coupling map of qubits (embedded in a plane).
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of qubits defined and plotted.
+* **qubit\_coordinates** (*List\[List\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]]*) – A list of two-element lists, with entries of each nested list being the planar coordinates in a 0-based square grid where each qubit is located.
+* **coupling\_map** (*List\[List\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]]*) – A list of two-element lists, with entries of each nested list being the qubit numbers of the bonds to be plotted.
+* **figsize** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – Output figure size (wxh) in inches.
+* **plot\_directed** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Plot directed coupling map.
+* **label\_qubits** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Label the qubits.
+* **qubit\_size** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Size of qubit marker.
+* **line\_width** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Width of lines.
+* **font\_size** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Font size of qubit labels.
+* **qubit\_color** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of colors for the qubits
+* **qubit\_labels** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of qubit labels
+* **line\_color** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of colors for each line from coupling\_map.
+* **font\_color** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The font color for the qubit labels.
+* **ax** (*Axes*) – A Matplotlib axes instance.
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – file path to save image to.
+
+**Returns**
+
+A Matplotlib figure instance.
+
+**Return type**
+
+Figure
+
+**Raises**
+
+* [**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – If matplotlib or graphviz is not installed.
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If length of qubit labels does not match number of qubits.
+
+**Example**
+
+```python
+from qiskit.visualization import plot_coupling_map
+
+num_qubits = 8
+qubit_coordinates = [[0, 1], [1, 1], [1, 0], [1, 2], [2, 0], [2, 2], [2, 1], [3, 1]]
+coupling_map = [[0, 1], [1, 2], [2, 3], [3, 5], [4, 5], [5, 6], [2, 4], [6, 7]]
+plot_coupling_map(num_qubits, qubit_coordinates, coupling_map)
+```
+
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.visualization.plot_distribution.md b/docs/api/qiskit/0.46/qiskit.visualization.plot_distribution.md
new file mode 100644
index 00000000000..0a1031aeba0
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.visualization.plot_distribution.md
@@ -0,0 +1,79 @@
+---
+title: plot_distribution
+description: API reference for qiskit.visualization.plot_distribution
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.visualization.plot_distribution
+---
+
+
+
+# qiskit.visualization.plot\_distribution
+
+
+
+`qiskit.visualization.plot_distribution(data, figsize=(7, 5), color=None, number_to_keep=None, sort='asc', target_string=None, legend=None, bar_labels=True, title=None, ax=None, filename=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/visualization/counts_visualization.py "view source code")
+
+Plot a distribution from input sampled data.
+
+**Parameters**
+
+* **data** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – This is either a list of dictionaries or a single dict containing the values to represent (ex \{‘001’: 130})
+* **figsize** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – Figure size in inches.
+* **color** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – String or list of strings for distribution bar colors.
+* **number\_to\_keep** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of terms to plot per dataset. The rest is made into a single bar called ‘rest’. If multiple datasets are given, the `number_to_keep` applies to each dataset individually, which may result in more bars than `number_to_keep + 1`. The `number_to_keep` applies to the total values, rather than the x-axis sort.
+* **sort** (*string*) – Could be ‘asc’, ‘desc’, ‘hamming’, ‘value’, or ‘value\_desc’. If set to ‘value’ or ‘value\_desc’ the x axis will be sorted by the maximum probability for each bitstring. Defaults to ‘asc’.
+* **target\_string** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Target string if ‘sort’ is a distance measure.
+* **legend** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of strings to use for labels of the data. The number of entries must match the length of data (if data is a list or 1 if it’s a dict)
+* **bar\_labels** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Label each bar in histogram with probability value.
+* **title** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – A string to use for the plot title
+* **ax** ([*matplotlib.axes.Axes*](https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.html#matplotlib.axes.Axes "(in Matplotlib v3.8.2)")) – An optional Axes object to be used for the visualization output. If none is specified a new matplotlib Figure will be created and used. Additionally, if specified there will be no returned Figure since it is redundant.
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – file path to save image to.
+
+**Returns**
+
+A figure for the rendered distribution, if the `ax` kwarg is not set.
+
+**Return type**
+
+matplotlib.Figure
+
+**Raises**
+
+* [**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – Matplotlib not available.
+* [**VisualizationError**](visualization#qiskit.visualization.VisualizationError "qiskit.visualization.VisualizationError") – When legend is provided and the length doesn’t match the input data.
+
+**Examples**
+
+```python
+# Plot two counts in the same figure with legends and colors specified.
+
+from qiskit.visualization import plot_distribution
+
+counts1 = {'00': 525, '11': 499}
+counts2 = {'00': 511, '11': 514}
+
+legend = ['First execution', 'Second execution']
+
+plot_distribution([counts1, counts2], legend=legend, color=['crimson','midnightblue'],
+ title="New Distribution")
+
+# You can sort the bitstrings using different methods.
+
+counts = {'001': 596, '011': 211, '010': 50, '000': 117, '101': 33, '111': 8,
+ '100': 6, '110': 3}
+
+# Sort by the counts in descending order
+dist1 = plot_distribution(counts, sort='value_desc')
+
+# Sort by the hamming distance (the number of bit flips to change from
+# one bitstring to the other) from a target string.
+dist2 = plot_distribution(counts, sort='hamming', target_string='001')
+```
+
+
+
+
+
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.visualization.plot_error_map.md b/docs/api/qiskit/0.46/qiskit.visualization.plot_error_map.md
new file mode 100644
index 00000000000..0ed2f68688a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.visualization.plot_error_map.md
@@ -0,0 +1,51 @@
+---
+title: plot_error_map
+description: API reference for qiskit.visualization.plot_error_map
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.visualization.plot_error_map
+---
+
+
+
+# qiskit.visualization.plot\_error\_map
+
+
+
+`qiskit.visualization.plot_error_map(backend, figsize=(15, 12), show_title=True, qubit_coordinates=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/visualization/gate_map.py "view source code")
+
+Plots the error map of a given backend.
+
+**Parameters**
+
+* **backend** ([*Backend*](qiskit.providers.Backend "qiskit.providers.Backend")) – Given backend.
+* **figsize** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – Figure size in inches.
+* **show\_title** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Show the title or not.
+* **qubit\_coordinates** (*Sequence*) – An optional sequence input (list or array being the most common) of 2d coordinates for each qubit. The length of the sequence much mast the number of qubits on the backend. The sequence should be the planar coordinates in a 0-based square grid where each qubit is located.
+
+**Returns**
+
+A matplotlib figure showing error map.
+
+**Return type**
+
+Figure
+
+**Raises**
+
+* [**VisualizationError**](visualization#qiskit.visualization.VisualizationError "qiskit.visualization.VisualizationError") – The backend does not provide gate errors for the ‘sx’ gate.
+* [**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – If matplotlib or seaborn is not installed.
+
+**Example**
+
+```python
+from qiskit import QuantumCircuit, execute
+from qiskit.visualization import plot_error_map
+from qiskit.providers.fake_provider import FakeVigoV2
+
+backend = FakeVigoV2()
+plot_error_map(backend)
+```
+
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.visualization.plot_gate_map.md b/docs/api/qiskit/0.46/qiskit.visualization.plot_gate_map.md
new file mode 100644
index 00000000000..7ed7fe14ce5
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.visualization.plot_gate_map.md
@@ -0,0 +1,62 @@
+---
+title: plot_gate_map
+description: API reference for qiskit.visualization.plot_gate_map
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.visualization.plot_gate_map
+---
+
+
+
+# qiskit.visualization.plot\_gate\_map
+
+
+
+`qiskit.visualization.plot_gate_map(backend, figsize=None, plot_directed=False, label_qubits=True, qubit_size=None, line_width=4, font_size=None, qubit_color=None, qubit_labels=None, line_color=None, font_color='white', ax=None, filename=None, qubit_coordinates=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/visualization/gate_map.py "view source code")
+
+Plots the gate map of a device.
+
+**Parameters**
+
+* **backend** ([*Backend*](qiskit.providers.Backend "qiskit.providers.Backend")) – The backend instance that will be used to plot the device gate map.
+* **figsize** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – Output figure size (wxh) in inches.
+* **plot\_directed** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Plot directed coupling map.
+* **label\_qubits** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Label the qubits.
+* **qubit\_size** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Size of qubit marker.
+* **line\_width** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Width of lines.
+* **font\_size** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Font size of qubit labels.
+* **qubit\_color** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of colors for the qubits
+* **qubit\_labels** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of qubit labels
+* **line\_color** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of colors for each line from coupling\_map.
+* **font\_color** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The font color for the qubit labels.
+* **ax** (*Axes*) – A Matplotlib axes instance.
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – file path to save image to.
+* **qubit\_coordinates** (*Sequence*) – An optional sequence input (list or array being the most common) of 2d coordinates for each qubit. The length of the sequence much match the number of qubits on the backend. The sequence should be the planar coordinates in a 0-based square grid where each qubit is located.
+
+**Returns**
+
+A Matplotlib figure instance.
+
+**Return type**
+
+Figure
+
+**Raises**
+
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if tried to pass a simulator, or if the backend is None, but one of num\_qubits, mpl\_data, or cmap is None.
+* [**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – if matplotlib not installed.
+
+**Example**
+
+```python
+from qiskit import QuantumCircuit, execute
+from qiskit.providers.fake_provider import FakeVigoV2
+from qiskit.visualization import plot_gate_map
+
+backend = FakeVigoV2()
+
+plot_gate_map(backend)
+```
+
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.visualization.plot_histogram.md b/docs/api/qiskit/0.46/qiskit.visualization.plot_histogram.md
new file mode 100644
index 00000000000..f33a5e5687a
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.visualization.plot_histogram.md
@@ -0,0 +1,84 @@
+---
+title: plot_histogram
+description: API reference for qiskit.visualization.plot_histogram
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.visualization.plot_histogram
+---
+
+
+
+# qiskit.visualization.plot\_histogram
+
+
+
+`qiskit.visualization.plot_histogram(data, figsize=(7, 5), color=None, number_to_keep=None, sort='asc', target_string=None, legend=None, bar_labels=True, title=None, ax=None, filename=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/visualization/counts_visualization.py "view source code")
+
+Plot a histogram of input counts data.
+
+
+ Using plot\_histogram() `data` argument with QuasiDistribution, ProbDistribution, or a distribution dictionary is deprecated as of qiskit-terra 0.22.0. It will be removed no earlier than 3 months after the release date. Instead, use `plot_distribution()`.
+
+
+**Parameters**
+
+* **data** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – This is either a list of dictionaries or a single dict containing the values to represent (ex `{'001': 130}`)
+* **figsize** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – Figure size in inches.
+* **color** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – String or list of strings for histogram bar colors.
+* **number\_to\_keep** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of terms to plot per dataset. The rest is made into a single bar called ‘rest’. If multiple datasets are given, the `number_to_keep` applies to each dataset individually, which may result in more bars than `number_to_keep + 1`. The `number_to_keep` applies to the total values, rather than the x-axis sort.
+* **sort** (*string*) – Could be ‘asc’, ‘desc’, ‘hamming’, ‘value’, or ‘value\_desc’. If set to ‘value’ or ‘value\_desc’ the x axis will be sorted by the number of counts for each bitstring. Defaults to ‘asc’.
+* **target\_string** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Target string if ‘sort’ is a distance measure.
+* **legend** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of strings to use for labels of the data. The number of entries must match the length of data (if data is a list or 1 if it’s a dict)
+* **bar\_labels** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Label each bar in histogram with counts value.
+* **title** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – A string to use for the plot title
+* **ax** ([*matplotlib.axes.Axes*](https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.html#matplotlib.axes.Axes "(in Matplotlib v3.8.2)")) – An optional Axes object to be used for the visualization output. If none is specified a new matplotlib Figure will be created and used. Additionally, if specified there will be no returned Figure since it is redundant.
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – file path to save image to.
+
+**Returns**
+
+A figure for the rendered histogram, if the `ax` kwarg is not set.
+
+**Return type**
+
+matplotlib.Figure
+
+**Raises**
+
+* [**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – Matplotlib not available.
+* [**VisualizationError**](visualization#qiskit.visualization.VisualizationError "qiskit.visualization.VisualizationError") – When legend is provided and the length doesn’t match the input data.
+* [**VisualizationError**](visualization#qiskit.visualization.VisualizationError "qiskit.visualization.VisualizationError") – Input must be Counts or a dict
+
+**Examples**
+
+```python
+# Plot two counts in the same figure with legends and colors specified.
+
+from qiskit.visualization import plot_histogram
+
+counts1 = {'00': 525, '11': 499}
+counts2 = {'00': 511, '11': 514}
+
+legend = ['First execution', 'Second execution']
+
+plot_histogram([counts1, counts2], legend=legend, color=['crimson','midnightblue'],
+ title="New Histogram")
+
+# You can sort the bitstrings using different methods.
+
+counts = {'001': 596, '011': 211, '010': 50, '000': 117, '101': 33, '111': 8,
+ '100': 6, '110': 3}
+
+# Sort by the counts in descending order
+hist1 = plot_histogram(counts, sort='value_desc')
+
+# Sort by the hamming distance (the number of bit flips to change from
+# one bitstring to the other) from a target string.
+hist2 = plot_histogram(counts, sort='hamming', target_string='001')
+```
+
+
+
+
+
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.visualization.plot_state_city.md b/docs/api/qiskit/0.46/qiskit.visualization.plot_state_city.md
new file mode 100644
index 00000000000..13598298d07
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.visualization.plot_state_city.md
@@ -0,0 +1,89 @@
+---
+title: plot_state_city
+description: API reference for qiskit.visualization.plot_state_city
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.visualization.plot_state_city
+---
+
+
+
+# qiskit.visualization.plot\_state\_city
+
+
+
+`qiskit.visualization.plot_state_city(state, title='', figsize=None, color=None, alpha=1, ax_real=None, ax_imag=None, *, filename=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/visualization/state_visualization.py "view source code")
+
+Plot the cityscape of quantum state.
+
+Plot two 3d bar graphs (two dimensional) of the real and imaginary part of the density matrix rho.
+
+**Parameters**
+
+* **state** ([*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") *or*[*DensityMatrix*](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix") *or ndarray*) – an N-qubit quantum state.
+* **title** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – a string that represents the plot title
+* **figsize** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – Figure size in inches.
+* **color** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of len=2 giving colors for real and imaginary components of matrix elements.
+* **alpha** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Transparency value for bars
+* **ax\_real** ([*matplotlib.axes.Axes*](https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.html#matplotlib.axes.Axes "(in Matplotlib v3.8.2)")) – An optional Axes object to be used for the visualization output. If none is specified a new matplotlib Figure will be created and used. If this is specified without an ax\_imag only the real component plot will be generated. Additionally, if specified there will be no returned Figure since it is redundant.
+* **ax\_imag** ([*matplotlib.axes.Axes*](https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.html#matplotlib.axes.Axes "(in Matplotlib v3.8.2)")) – An optional Axes object to be used for the visualization output. If none is specified a new matplotlib Figure will be created and used. If this is specified without an ax\_real only the imaginary component plot will be generated. Additionally, if specified there will be no returned Figure since it is redundant.
+
+**Returns**
+
+The matplotlib.Figure of the visualization if the `ax_real` and `ax_imag` kwargs are not set
+
+**Return type**
+
+[`matplotlib.figure.Figure`](https://matplotlib.org/stable/api/figure_api.html#matplotlib.figure.Figure "(in Matplotlib v3.8.2)")
+
+**Raises**
+
+* [**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – Requires matplotlib.
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – When ‘color’ is not a list of len=2.
+* [**VisualizationError**](visualization#qiskit.visualization.VisualizationError "qiskit.visualization.VisualizationError") – if input is not a valid N-qubit state.
+
+**Examples**
+
+```python
+# You can choose different colors for the real and imaginary parts of the density matrix.
+
+from qiskit import QuantumCircuit
+from qiskit.quantum_info import DensityMatrix
+from qiskit.visualization import plot_state_city
+
+qc = QuantumCircuit(2)
+qc.h(0)
+qc.cx(0, 1)
+
+state = DensityMatrix(qc)
+plot_state_city(state, color=['midnightblue', 'crimson'], title="New State City")
+```
+
+
+
+```python
+# You can make the bars more transparent to better see the ones that are behind
+# if they overlap.
+
+import numpy as np
+from qiskit.quantum_info import Statevector
+from qiskit.visualization import plot_state_city
+from qiskit import QuantumCircuit
+
+qc = QuantumCircuit(2)
+qc.h(0)
+qc.cx(0, 1)
+
+
+qc = QuantumCircuit(2)
+qc.h([0, 1])
+qc.cz(0,1)
+qc.ry(np.pi/3, 0)
+qc.rx(np.pi/5, 1)
+
+state = Statevector(qc)
+plot_state_city(state, alpha=0.6)
+```
+
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.visualization.plot_state_hinton.md b/docs/api/qiskit/0.46/qiskit.visualization.plot_state_hinton.md
new file mode 100644
index 00000000000..27e62eea163
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.visualization.plot_state_hinton.md
@@ -0,0 +1,62 @@
+---
+title: plot_state_hinton
+description: API reference for qiskit.visualization.plot_state_hinton
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.visualization.plot_state_hinton
+---
+
+
+
+# qiskit.visualization.plot\_state\_hinton
+
+
+
+`qiskit.visualization.plot_state_hinton(state, title='', figsize=None, ax_real=None, ax_imag=None, *, filename=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/visualization/state_visualization.py "view source code")
+
+Plot a hinton diagram for the density matrix of a quantum state.
+
+The hinton diagram represents the values of a matrix using squares, whose size indicate the magnitude of their corresponding value and their color, its sign. A white square means the value is positive and a black one means negative.
+
+**Parameters**
+
+* **state** ([*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") *or*[*DensityMatrix*](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix") *or ndarray*) – An N-qubit quantum state.
+* **title** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – a string that represents the plot title
+* **figsize** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – Figure size in inches.
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – file path to save image to.
+* **ax\_real** ([*matplotlib.axes.Axes*](https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.html#matplotlib.axes.Axes "(in Matplotlib v3.8.2)")) – An optional Axes object to be used for the visualization output. If none is specified a new matplotlib Figure will be created and used. If this is specified without an ax\_imag only the real component plot will be generated. Additionally, if specified there will be no returned Figure since it is redundant.
+* **ax\_imag** ([*matplotlib.axes.Axes*](https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.html#matplotlib.axes.Axes "(in Matplotlib v3.8.2)")) – An optional Axes object to be used for the visualization output. If none is specified a new matplotlib Figure will be created and used. If this is specified without an ax\_imag only the real component plot will be generated. Additionally, if specified there will be no returned Figure since it is redundant.
+
+**Returns**
+
+The matplotlib.Figure of the visualization if neither ax\_real or ax\_imag is set.
+
+**Return type**
+
+[`matplotlib.figure.Figure`](https://matplotlib.org/stable/api/figure_api.html#matplotlib.figure.Figure "(in Matplotlib v3.8.2)")
+
+**Raises**
+
+* [**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – Requires matplotlib.
+* [**VisualizationError**](visualization#qiskit.visualization.VisualizationError "qiskit.visualization.VisualizationError") – if input is not a valid N-qubit state.
+
+**Examples**
+
+```python
+import numpy as np
+from qiskit import QuantumCircuit
+from qiskit.quantum_info import DensityMatrix
+from qiskit.visualization import plot_state_hinton
+
+qc = QuantumCircuit(2)
+qc.h([0, 1])
+qc.cz(0,1)
+qc.ry(np.pi/3 , 0)
+qc.rx(np.pi/5, 1)
+
+state = DensityMatrix(qc)
+plot_state_hinton(state, title="New Hinton Plot")
+```
+
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.visualization.plot_state_paulivec.md b/docs/api/qiskit/0.46/qiskit.visualization.plot_state_paulivec.md
new file mode 100644
index 00000000000..0ae95376352
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.visualization.plot_state_paulivec.md
@@ -0,0 +1,92 @@
+---
+title: plot_state_paulivec
+description: API reference for qiskit.visualization.plot_state_paulivec
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.visualization.plot_state_paulivec
+---
+
+
+
+# qiskit.visualization.plot\_state\_paulivec
+
+
+
+`qiskit.visualization.plot_state_paulivec(state, title='', figsize=None, color=None, ax=None, *, filename=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/visualization/state_visualization.py "view source code")
+
+Plot the Pauli-vector representation of a quantum state as bar graph.
+
+The Pauli-vector of a density matrix $\rho$ is defined by the expectation of each possible tensor product of single-qubit Pauli operators (including the identity), that is
+
+$$
+\rho = \frac{1}{2^n} \sum_{\sigma \in \{I, X, Y, Z\}^{\otimes n}}
+ \mathrm{Tr}(\sigma \rho) \sigma.
+$$
+
+This function plots the coefficients $\mathrm{Tr}(\sigma\rho)$ as bar graph.
+
+**Parameters**
+
+* **state** ([*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") *or*[*DensityMatrix*](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix") *or ndarray*) – an N-qubit quantum state.
+* **title** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – a string that represents the plot title
+* **figsize** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – Figure size in inches.
+* **color** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)") *or*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Color of the coefficient value bars.
+* **ax** ([*matplotlib.axes.Axes*](https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.html#matplotlib.axes.Axes "(in Matplotlib v3.8.2)")) – An optional Axes object to be used for the visualization output. If none is specified a new matplotlib Figure will be created and used. Additionally, if specified there will be no returned Figure since it is redundant.
+
+**Returns**
+
+The matplotlib.Figure of the visualization if the `ax` kwarg is not set
+
+**Return type**
+
+[`matplotlib.figure.Figure`](https://matplotlib.org/stable/api/figure_api.html#matplotlib.figure.Figure "(in Matplotlib v3.8.2)")
+
+**Raises**
+
+* [**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – Requires matplotlib.
+* [**VisualizationError**](visualization#qiskit.visualization.VisualizationError "qiskit.visualization.VisualizationError") – if input is not a valid N-qubit state.
+
+**Examples**
+
+```python
+# You can set a color for all the bars.
+
+from qiskit import QuantumCircuit
+from qiskit.quantum_info import Statevector
+from qiskit.visualization import plot_state_paulivec
+
+qc = QuantumCircuit(2)
+qc.h(0)
+qc.cx(0, 1)
+
+state = Statevector(qc)
+plot_state_paulivec(state, color='midnightblue', title="New PauliVec plot")
+```
+
+
+
+```python
+# If you introduce a list with less colors than bars, the color of the bars will
+# alternate following the sequence from the list.
+
+import numpy as np
+from qiskit.quantum_info import DensityMatrix
+from qiskit import QuantumCircuit
+from qiskit.visualization import plot_state_paulivec
+
+qc = QuantumCircuit(2)
+qc.h(0)
+qc.cx(0, 1)
+
+qc = QuantumCircuit(2)
+qc.h([0, 1])
+qc.cz(0, 1)
+qc.ry(np.pi/3, 0)
+qc.rx(np.pi/5, 1)
+
+matrix = DensityMatrix(qc)
+plot_state_paulivec(matrix, color=['crimson', 'midnightblue', 'seagreen'])
+```
+
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.visualization.plot_state_qsphere.md b/docs/api/qiskit/0.46/qiskit.visualization.plot_state_qsphere.md
new file mode 100644
index 00000000000..8e2d662146c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.visualization.plot_state_qsphere.md
@@ -0,0 +1,81 @@
+---
+title: plot_state_qsphere
+description: API reference for qiskit.visualization.plot_state_qsphere
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.visualization.plot_state_qsphere
+---
+
+
+
+# qiskit.visualization.plot\_state\_qsphere
+
+
+
+`qiskit.visualization.plot_state_qsphere(state, figsize=None, ax=None, show_state_labels=True, show_state_phases=False, use_degrees=False, *, filename=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/visualization/state_visualization.py "view source code")
+
+Plot the qsphere representation of a quantum state. Here, the size of the points is proportional to the probability of the corresponding term in the state and the color represents the phase.
+
+**Parameters**
+
+* **state** ([*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") *or*[*DensityMatrix*](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix") *or ndarray*) – an N-qubit quantum state.
+* **figsize** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – Figure size in inches.
+* **ax** ([*matplotlib.axes.Axes*](https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.html#matplotlib.axes.Axes "(in Matplotlib v3.8.2)")) – An optional Axes object to be used for the visualization output. If none is specified a new matplotlib Figure will be created and used. Additionally, if specified there will be no returned Figure since it is redundant.
+* **show\_state\_labels** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – An optional boolean indicating whether to show labels for each basis state.
+* **show\_state\_phases** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – An optional boolean indicating whether to show the phase for each basis state.
+* **use\_degrees** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – An optional boolean indicating whether to use radians or degrees for the phase values in the plot.
+
+**Returns**
+
+A matplotlib figure instance if the `ax` kwarg is not set
+
+**Return type**
+
+[`matplotlib.figure.Figure`](https://matplotlib.org/stable/api/figure_api.html#matplotlib.figure.Figure "(in Matplotlib v3.8.2)")
+
+**Raises**
+
+* [**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – Requires matplotlib.
+* [**VisualizationError**](visualization#qiskit.visualization.VisualizationError "qiskit.visualization.VisualizationError") – if input is not a valid N-qubit state.
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – Input statevector does not have valid dimensions.
+
+**Examples**
+
+```python
+from qiskit import QuantumCircuit
+from qiskit.quantum_info import Statevector
+from qiskit.visualization import plot_state_qsphere
+
+qc = QuantumCircuit(2)
+qc.h(0)
+qc.cx(0, 1)
+
+state = Statevector(qc)
+plot_state_qsphere(state)
+```
+
+
+
+```python
+# You can show the phase of each state and use
+# degrees instead of radians
+
+from qiskit.quantum_info import DensityMatrix
+import numpy as np
+from qiskit import QuantumCircuit
+from qiskit.visualization import plot_state_qsphere
+
+qc = QuantumCircuit(2)
+qc.h([0, 1])
+qc.cz(0,1)
+qc.ry(np.pi/3, 0)
+qc.rx(np.pi/5, 1)
+qc.z(1)
+
+matrix = DensityMatrix(qc)
+plot_state_qsphere(matrix,
+ show_state_phases = True, use_degrees = True)
+```
+
+
+
diff --git a/docs/api/qiskit/0.46/qiskit.visualization.pulse.IQXDebugging.md b/docs/api/qiskit/0.46/qiskit.visualization.pulse.IQXDebugging.md
new file mode 100644
index 00000000000..2928b54b7f0
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.visualization.pulse.IQXDebugging.md
@@ -0,0 +1,113 @@
+---
+title: IQXDebugging
+description: API reference for qiskit.visualization.pulse.IQXDebugging
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.visualization.pulse.IQXDebugging
+---
+
+# IQXDebugging
+
+
+
+`qiskit.visualization.pulse.IQXDebugging(**kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/visualization/pulse_v2/stylesheet.py "view source code")
+
+Bases: [`dict`](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+Pulse stylesheet for pulse programmers. Show details of instructions.
+
+\# TODO: add more generators
+
+* Generate stepwise waveform envelope with latex pulse names.
+* Generate annotation for waveform height.
+* Apply phase modulation to waveforms.
+* Plot frame change symbol with raw operand values.
+* Show chart name and channel frequency.
+* Show snapshot and barrier.
+* Show acquire channels.
+* Channels are sorted by index and control channels are added to the end.
+
+## Methods
+
+### clear
+
+
+
+`clear() → None. Remove all items from D.`
+
+### copy
+
+
+
+`copy() → a shallow copy of D`
+
+### fromkeys
+
+
+
+`fromkeys(value=None, /)`
+
+Create a new dictionary with keys from iterable and values set to value.
+
+### get
+
+
+
+`get(key, default=None, /)`
+
+Return the value for key if key is in the dictionary, else default.
+
+### items
+
+
+
+`items() → a set-like object providing a view on D's items`
+
+### keys
+
+
+
+`keys() → a set-like object providing a view on D's keys`
+
+### pop
+
+
+
+`pop(k[, d]) → v, remove specified key and return the corresponding value.`
+
+If key is not found, default is returned if given, otherwise KeyError is raised
+
+### popitem
+
+
+
+`popitem()`
+
+Remove and return a (key, value) pair as a 2-tuple.
+
+Pairs are returned in LIFO (last-in, first-out) order. Raises KeyError if the dict is empty.
+
+### setdefault
+
+
+
+`setdefault(key, default=None, /)`
+
+Insert key with a value of default if key is not in the dictionary.
+
+Return the value for key if key is in the dictionary, else default.
+
+### update
+
+
+
+`update([E, ]**F) → None. Update D from dict/iterable E and F.`
+
+If E is present and has a .keys() method, then does: for k in E: D\[k] = E\[k] If E is present and lacks a .keys() method, then does: for k, v in E: D\[k] = v In either case, this is followed by: for k in F: D\[k] = F\[k]
+
+### values
+
+
+
+`values() → an object providing a view on D's values`
+
diff --git a/docs/api/qiskit/0.46/qiskit.visualization.pulse.IQXSimple.md b/docs/api/qiskit/0.46/qiskit.visualization.pulse.IQXSimple.md
new file mode 100644
index 00000000000..8d15cb026c5
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.visualization.pulse.IQXSimple.md
@@ -0,0 +1,110 @@
+---
+title: IQXSimple
+description: API reference for qiskit.visualization.pulse.IQXSimple
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.visualization.pulse.IQXSimple
+---
+
+# IQXSimple
+
+
+
+`qiskit.visualization.pulse.IQXSimple(**kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/visualization/pulse_v2/stylesheet.py "view source code")
+
+Bases: [`dict`](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+Simple pulse stylesheet without channel notation.
+
+* Generate stepwise waveform envelope with latex pulse names.
+* Apply phase modulation to waveforms.
+* Do not show frame changes.
+* Show chart name.
+* Do not show snapshot and barrier.
+* Do not show acquire channels.
+* Channels are sorted by qubit index.
+
+## Methods
+
+### clear
+
+
+
+`clear() → None. Remove all items from D.`
+
+### copy
+
+
+
+`copy() → a shallow copy of D`
+
+### fromkeys
+
+
+
+`fromkeys(value=None, /)`
+
+Create a new dictionary with keys from iterable and values set to value.
+
+### get
+
+
+
+`get(key, default=None, /)`
+
+Return the value for key if key is in the dictionary, else default.
+
+### items
+
+
+
+`items() → a set-like object providing a view on D's items`
+
+### keys
+
+
+
+`keys() → a set-like object providing a view on D's keys`
+
+### pop
+
+
+
+`pop(k[, d]) → v, remove specified key and return the corresponding value.`
+
+If key is not found, default is returned if given, otherwise KeyError is raised
+
+### popitem
+
+
+
+`popitem()`
+
+Remove and return a (key, value) pair as a 2-tuple.
+
+Pairs are returned in LIFO (last-in, first-out) order. Raises KeyError if the dict is empty.
+
+### setdefault
+
+
+
+`setdefault(key, default=None, /)`
+
+Insert key with a value of default if key is not in the dictionary.
+
+Return the value for key if key is in the dictionary, else default.
+
+### update
+
+
+
+`update([E, ]**F) → None. Update D from dict/iterable E and F.`
+
+If E is present and has a .keys() method, then does: for k in E: D\[k] = E\[k] If E is present and lacks a .keys() method, then does: for k, v in E: D\[k] = v In either case, this is followed by: for k in F: D\[k] = F\[k]
+
+### values
+
+
+
+`values() → an object providing a view on D's values`
+
diff --git a/docs/api/qiskit/0.46/qiskit.visualization.pulse.IQXStandard.md b/docs/api/qiskit/0.46/qiskit.visualization.pulse.IQXStandard.md
new file mode 100644
index 00000000000..23d0b0883bf
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.visualization.pulse.IQXStandard.md
@@ -0,0 +1,110 @@
+---
+title: IQXStandard
+description: API reference for qiskit.visualization.pulse.IQXStandard
+in_page_toc_min_heading_level: 1
+python_api_type: class
+python_api_name: qiskit.visualization.pulse.IQXStandard
+---
+
+# IQXStandard
+
+
+
+`qiskit.visualization.pulse.IQXStandard(**kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/visualization/pulse_v2/stylesheet.py "view source code")
+
+Bases: [`dict`](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+Standard pulse stylesheet.
+
+* Generate stepwise waveform envelope with latex pulse names.
+* Apply phase modulation to waveforms.
+* Plot frame change symbol with formatted operand values.
+* Show chart name with scaling factor.
+* Show snapshot and barrier.
+* Do not show acquire channels.
+* Channels are sorted by index and control channels are added to the end.
+
+## Methods
+
+### clear
+
+
+
+`clear() → None. Remove all items from D.`
+
+### copy
+
+
+
+`copy() → a shallow copy of D`
+
+### fromkeys
+
+
+
+`fromkeys(value=None, /)`
+
+Create a new dictionary with keys from iterable and values set to value.
+
+### get
+
+
+
+`get(key, default=None, /)`
+
+Return the value for key if key is in the dictionary, else default.
+
+### items
+
+
+
+`items() → a set-like object providing a view on D's items`
+
+### keys
+
+
+
+`keys() → a set-like object providing a view on D's keys`
+
+### pop
+
+
+
+`pop(k[, d]) → v, remove specified key and return the corresponding value.`
+
+If key is not found, default is returned if given, otherwise KeyError is raised
+
+### popitem
+
+
+
+`popitem()`
+
+Remove and return a (key, value) pair as a 2-tuple.
+
+Pairs are returned in LIFO (last-in, first-out) order. Raises KeyError if the dict is empty.
+
+### setdefault
+
+
+
+`setdefault(key, default=None, /)`
+
+Insert key with a value of default if key is not in the dictionary.
+
+Return the value for key if key is in the dictionary, else default.
+
+### update
+
+
+
+`update([E, ]**F) → None. Update D from dict/iterable E and F.`
+
+If E is present and has a .keys() method, then does: for k in E: D\[k] = E\[k] If E is present and lacks a .keys() method, then does: for k, v in E: D\[k] = v In either case, this is followed by: for k in F: D\[k] = F\[k]
+
+### values
+
+
+
+`values() → an object providing a view on D's values`
+
diff --git a/docs/api/qiskit/0.46/qiskit.visualization.pulse_drawer.md b/docs/api/qiskit/0.46/qiskit.visualization.pulse_drawer.md
new file mode 100644
index 00000000000..65cdb11761c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.visualization.pulse_drawer.md
@@ -0,0 +1,323 @@
+---
+title: pulse_drawer
+description: API reference for qiskit.visualization.pulse_drawer
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.visualization.pulse_drawer
+---
+
+
+
+# qiskit.visualization.pulse\_drawer
+
+
+
+`qiskit.visualization.pulse_drawer(program, style=None, backend=None, time_range=None, time_unit='dt', disable_channels=None, show_snapshot=True, show_framechange=True, show_waveform_info=True, show_barrier=True, plotter='mpl2d', axis=None)`
+
+Generate visualization data for pulse programs.
+
+**Parameters**
+
+* **program** ([*Waveform*](qiskit.pulse.library.Waveform "qiskit.pulse.library.waveform.Waveform") *|*[*ParametricPulse*](qiskit.pulse.library.ParametricPulse "qiskit.pulse.library.parametric_pulses.ParametricPulse") *|*[*SymbolicPulse*](qiskit.pulse.library.SymbolicPulse "qiskit.pulse.library.symbolic_pulses.SymbolicPulse") *|*[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule") *|*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock")) – Program to visualize. This program can be arbitrary Qiskit Pulse program, such as `Waveform`, `ParametricPulse`, `SymbolicPulse`, [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") and [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock").
+
+* **style** ([*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")*] | None*) – Stylesheet options. This can be dictionary or preset stylesheet classes. See `IQXStandard`, `IQXSimple`, and `IQXDebugging` for details of preset stylesheets. See also the stylesheet section for details of configuration keys.
+
+* **backend** ([*Backend*](qiskit.providers.Backend "qiskit.providers.backend.Backend") *| None*) – Backend object to play the input pulse program. If provided, the plotter may use to make the visualization hardware aware.
+
+* **time\_range** ([*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – Set horizontal axis limit. Tuple `(tmin, tmax)`.
+
+* **time\_unit** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The unit of specified time range either `dt` or `ns`. The unit of `ns` is available only when `backend` object is provided.
+
+* **disable\_channels** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*Channel*](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")*] | None*) – A control property to show specific pulse channel. Pulse channel instances provided as a list is not shown in the output image.
+
+* **show\_snapshot** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Show snapshot instructions.
+
+* **show\_framechange** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Show frame change instructions. The frame change represents instructions that modulate phase or frequency of pulse channels.
+
+* **show\_waveform\_info** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Show waveform annotations, i.e. name, of waveforms. Set `True` to show additional information about waveforms.
+
+* **show\_barrier** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Show barrier lines.
+
+* **plotter** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) –
+
+ Name of plotter API to generate an output image. One of following APIs should be specified:
+
+ ```python
+ mpl2d: Matplotlib API for 2D image generation.
+ Matplotlib API to generate 2D image. Charts are placed along y axis with
+ vertical offset. This API takes matplotlib.axes.Axes as `axis` input.
+ ```
+
+ axis and style kwargs may depend on the plotter.
+
+* **axis** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)") *| None*) – Arbitrary object passed to the plotter. If this object is provided, the plotters use a given `axis` instead of internally initializing a figure object. This object format depends on the plotter. See plotter argument for details.
+
+**Returns**
+
+Visualization output data. The returned data type depends on the plotter. If matplotlib family is specified, this will be a matplotlib.pyplot.Figure data. The returned data is generated by the `get_image()` method of the specified plotter API.
+
+**Style Dict Details**
+
+The stylesheet kwarg contains numerous options that define the style of the output pulse visualization. The stylesheet options can be classified into formatter, generator and layout. Those options available in the stylesheet are defined below:
+
+**Parameters**
+
+* **formatter.general.fig\_width** – Width of output image (default 13).
+
+* **formatter.general.fig\_chart\_height** – Height of output image per chart. The height of each chart is multiplied with this factor and the sum of all chart heights becomes the height of output image (default 1.5).
+
+* **formatter.general.vertical\_resolution** – Vertical resolution of the pulse envelope. The change of data points below this limit is ignored (default 1e-6).
+
+* **formatter.general.max\_scale** – Maximum scaling factor of each chart. This factor is considered when chart auto-scaling is enabled (default 100).
+
+* **formatter.color.waveforms** –
+
+ A dictionary of the waveform colors to use for each element type in the output visualization. The default values are:
+
+ ```python
+ {
+ 'W': `['#648fff', '#002999']`,
+ 'D': `['#648fff', '#002999']`,
+ 'U': `['#ffb000', '#994A00']`,
+ 'M': `['#dc267f', '#760019']`,
+ 'A': `['#dc267f', '#760019']`
+ }
+ ```
+
+* **formatter.color.baseline** – Color code of lines of zero line of each chart (default ‘#000000’).
+
+* **formatter.color.barrier** – Color code of lines of barrier (default ‘#222222’).
+
+* **formatter.color.background** – Color code of the face color of canvas (default ‘#f2f3f4’).
+
+* **formatter.color.fig\_title** – Color code of the figure title text (default ‘#000000’).
+
+* **formatter.color.annotate** – Color code of annotation texts in the canvas (default ‘#222222’).
+
+* **formatter.color.frame\_change** – Color code of the symbol for frame changes (default ‘#000000’).
+
+* **formatter.color.snapshot** – Color code of the symbol for snapshot (default ‘#000000’)
+
+* **formatter.color.opaque\_shape** – Color code of the face and edge of opaque shape box (default \[‘#fffacd’, ‘#000000’])
+
+* **formatter.color.axis\_label** – Color code of axis labels (default ‘#000000’).
+
+* **formatter.alpha.fill\_waveform** – Transparency of waveforms. A value in the range from 0 to 1. The value 0 gives completely transparent waveforms (default 0.3).
+
+* **formatter.alpha.baseline** – Transparency of base lines. A value in the range from 0 to 1. The value 0 gives completely transparent base lines (default 1.0).
+
+* **formatter.alpha.barrier** – Transparency of barrier lines. A value in the range from 0 to 1. The value 0 gives completely transparent barrier lines (default 0.7).
+
+* **formatter.alpha.opaque\_shape** – Transparency of opaque shape box. A value in the range from 0 to 1. The value 0 gives completely transparent barrier lines (default 0.7).
+
+* **formatter.layer.fill\_waveform** – Layer index of waveforms. Larger number comes in the front of the output image (default 2).
+
+* **formatter.layer.baseline** – Layer index of baselines. Larger number comes in the front of the output image (default 1).
+
+* **formatter.layer.barrier** – Layer index of barrier lines. Larger number comes in the front of the output image (default 1).
+
+* **formatter.layer.annotate** – Layer index of annotations. Larger number comes in the front of the output image (default 5).
+
+* **formatter.layer.axis\_label** – Layer index of axis labels. Larger number comes in the front of the output image (default 5).
+
+* **formatter.layer.frame\_change** – Layer index of frame change symbols. Larger number comes in the front of the output image (default 4).
+
+* **formatter.layer.snapshot** – Layer index of snapshot symbols. Larger number comes in the front of the output image (default 3).
+
+* **formatter.layer.fig\_title** – Layer index of the figure title. Larger number comes in the front of the output image (default 6).
+
+* **formatter.margin.top** – Margin from the top boundary of the figure canvas to the surface of the first chart (default 0.5).
+
+* **formatter.margin.bottom** – Margin from the bottom boundary of the figure canvas to the surface of the last chart (default 0.5).
+
+* **formatter.margin.left\_percent** – Margin from the left boundary of the figure canvas to the zero point of the horizontal axis. The value is in units of percentage of the whole program duration. If the duration is 100 and the value of 0.5 is set, this keeps left margin of 5 (default 0.05).
+
+* **formatter.margin.right\_percent** – Margin from the right boundary of the figure canvas to the left limit of the horizontal axis. The value is in units of percentage of the whole program duration. If the duration is 100 and the value of 0.5 is set, this keeps right margin of 5 (default 0.05).
+
+* **formatter.margin.between\_channel** – Vertical margin between charts (default 0.2).
+
+* **formatter.label\_offset.pulse\_name** – Offset of pulse name annotations from the chart baseline (default 0.3).
+
+* **formatter.label\_offset.chart\_info** – Offset of chart info annotations from the chart baseline (default 0.3).
+
+* **formatter.label\_offset.frame\_change** – Offset of frame change annotations from the chart baseline (default 0.3).
+
+* **formatter.label\_offset.snapshot** – Offset of snapshot annotations from the chart baseline (default 0.3).
+
+* **formatter.text\_size.axis\_label** – Text size of axis labels (default 15).
+
+* **formatter.text\_size.annotate** – Text size of annotations (default 12).
+
+* **formatter.text\_size.frame\_change** – Text size of frame change symbols (default 20).
+
+* **formatter.text\_size.snapshot** – Text size of snapshot symbols (default 20).
+
+* **formatter.text\_size.fig\_title** – Text size of the figure title (default 15).
+
+* **formatter.text\_size.axis\_break\_symbol** – Text size of axis break symbols (default 15).
+
+* **formatter.line\_width.fill\_waveform** – Line width of the fringe of filled waveforms (default 0).
+
+* **formatter.line\_width.axis\_break** – Line width of axis breaks. The axis break line paints over other drawings with the background face color (default 6).
+
+* **formatter.line\_width.baseline** – Line width of base lines (default 1)
+
+* **formatter.line\_width.barrier** – Line width of barrier lines (default 1).
+
+* **formatter.line\_width.opaque\_shape** – Line width of opaque shape box (default 1).
+
+* **formatter.line\_style.fill\_waveform** – Line style of the fringe of filled waveforms. This conforms to the line style spec of matplotlib (default ‘-’).
+
+* **formatter.line\_style.baseline** – Line style of base lines. This conforms to the line style spec of matplotlib (default ‘-’).
+
+* **formatter.line\_style.barrier** – Line style of barrier lines. This conforms to the line style spec of matplotlib (default ‘:’).
+
+* **formatter.line\_style.opaque\_shape** – Line style of opaque shape box. This conforms to the line style spec of matplotlib (default ‘–’).
+
+* **formatter.channel\_scaling.drive** – Default scaling value of drive channel waveforms (default 1.0).
+
+* **formatter.channel\_scaling.control** – Default scaling value of control channel waveforms (default 1.0).
+
+* **formatter.channel\_scaling.measure** – Default scaling value of measure channel waveforms (default 1.0).
+
+* **formatter.channel\_scaling.acquire** – Default scaling value of acquire channel waveforms (default 1.0).
+
+* **formatter.channel\_scaling.pos\_spacing** – Minimum height of chart above the baseline. Chart top is determined based on the maximum height of waveforms associated with the chart. If the maximum height is below this value, this value is set as the chart top (default 0.1).
+
+* **formatter.channel\_scaling.neg\_spacing** – Minimum height of chart below the baseline. Chart bottom is determined based on the minimum height of waveforms associated with the chart. If the minimum height is above this value, this value is set as the chart bottom (default -0.1).
+
+* **formatter.box\_width.opaque\_shape** – Default box length of the waveform representation when the instruction is parameterized and duration is not bound or not defined. Value is units in dt (default: 150).
+
+* **formatter.box\_height.opaque\_shape** – Default box height of the waveform representation when the instruction is parameterized (default: 0.4).
+
+* **formatter.axis\_break.length** – Waveform or idle time duration that axis break is applied. Intervals longer than this value are truncated. The value is in units of data points (default 3000).
+
+* **formatter.axis\_break.max\_length** – Length of new waveform or idle time duration after axis break is applied. Longer intervals are truncated to this length (default 1000).
+
+* **formatter.control.fill\_waveform** – Set True to fill waveforms with face color (default True). When you disable this option, you should set finite line width to formatter.line\_width.fill\_waveform, otherwise nothing will appear in the graph.
+
+* **formatter.control.apply\_phase\_modulation** – Set True to apply phase modulation to the waveforms (default True).
+
+* **formatter.control.show\_snapshot\_channel** – Set True to show snapshot instructions (default True).
+
+* **formatter.control.show\_acquire\_channel** – Set True to show acquire channels (default True).
+
+* **formatter.control.show\_empty\_channel** – Set True to show charts without any waveforms (default True).
+
+* **formatter.control.auto\_chart\_scaling** – Set True to apply auto-scaling to charts (default True).
+
+* **formatter.control.axis\_break** – Set True to apply axis break for long intervals (default True).
+
+* **formatter.unicode\_symbol.frame\_change** – Text that represents the symbol of frame change. This text is used when the plotter doesn’t support latex (default u’↺’).
+
+* **formatter.unicode\_symbol.snapshot** – Text that represents the symbol of snapshot. This text is used when the plotter doesn’t support latex (default u’↯’).
+
+* **formatter.unicode\_symbol.phase\_parameter** – Text that represents the symbol of parameterized phase value. This text is used when the plotter doesn’t support latex (default u’θ’).
+
+* **formatter.unicode\_symbol.freq\_parameter** – Text that represents the symbol of parameterized frequency value. This text is used when the plotter doesn’t support latex (default ‘f’).
+
+* **formatter.latex\_symbol.frame\_change** – Latex text that represents the symbol of frame change (default r’circlearrowleft’).
+
+* **formatter.latex\_symbol.snapshot** – Latex text that represents the symbol of snapshot (default ‘’).
+
+* **formatter.latex\_symbol.phase\_parameter** – Latex text that represents the symbol of parameterized phase value (default r’ heta’).
+
+* **formatter.latex\_symbol.freq\_parameter** – Latex text that represents the symbol of parameterized frequency value (default ‘f’).
+
+* **generator.waveform** – List of callback functions that generates drawing for waveforms. Arbitrary callback functions satisfying the generator format can be set here. There are some default generators in the pulse drawer. See `waveform` for more details. No default generator is set.
+
+* **generator.frame** – List of callback functions that generates drawing for frame changes. Arbitrary callback functions satisfying the generator format can be set here. There are some default generators in the pulse drawer. See `frame` for more details. No default generator is set.
+
+* **generator.chart** – List of callback functions that generates drawing for charts. Arbitrary callback functions satisfying the generator format can be set here. There are some default generators in the pulse drawer. See `chart` for more details. No default generator is set.
+
+* **generator.snapshot** – List of callback functions that generates drawing for snapshots. Arbitrary callback functions satisfying the generator format can be set here. There are some default generators in the pulse drawer. See `snapshot` for more details. No default generator is set.
+
+* **generator.barrier** – List of callback functions that generates drawing for barriers. Arbitrary callback functions satisfying the generator format can be set here. There are some default generators in the pulse drawer. See `barrier` for more details. No default generator is set.
+
+* **layout.chart\_channel\_map** – Callback function that determines the relationship between pulse channels and charts. See `layout` for more details. No default layout is set.
+
+* **layout.time\_axis\_map** – Callback function that determines the layout of horizontal axis labels. See `layout` for more details. No default layout is set.
+
+* **layout.figure\_title** – Callback function that generates a string for the figure title. See `layout` for more details. No default layout is set.
+
+**Examples**
+
+To visualize a pulse program, you can call this function with set of control arguments. Most of appearance of the output image can be controlled by the stylesheet.
+
+Drawing with the default stylesheet.
+
+```python
+from qiskit import QuantumCircuit, transpile, schedule
+from qiskit.visualization.pulse_v2 import draw
+from qiskit.providers.fake_provider import FakeBoeblingen
+
+qc = QuantumCircuit(2)
+qc.h(0)
+qc.cx(0, 1)
+qc.measure_all()
+qc = transpile(qc, FakeBoeblingen(), layout_method='trivial')
+sched = schedule(qc, FakeBoeblingen())
+
+draw(sched, backend=FakeBoeblingen())
+```
+
+
+
+Drawing with the stylesheet suited for publication.
+
+```python
+from qiskit import QuantumCircuit, transpile, schedule
+from qiskit.visualization.pulse_v2 import draw, IQXSimple
+from qiskit.providers.fake_provider import FakeBoeblingen
+
+qc = QuantumCircuit(2)
+qc.h(0)
+qc.cx(0, 1)
+qc.measure_all()
+qc = transpile(qc, FakeBoeblingen(), layout_method='trivial')
+sched = schedule(qc, FakeBoeblingen())
+
+draw(sched, style=IQXSimple(), backend=FakeBoeblingen())
+```
+
+
+
+Drawing with the stylesheet suited for program debugging.
+
+```python
+from qiskit import QuantumCircuit, transpile, schedule
+from qiskit.visualization.pulse_v2 import draw, IQXDebugging
+from qiskit.providers.fake_provider import FakeBoeblingen
+
+qc = QuantumCircuit(2)
+qc.h(0)
+qc.cx(0, 1)
+qc.measure_all()
+qc = transpile(qc, FakeBoeblingen(), layout_method='trivial')
+sched = schedule(qc, FakeBoeblingen())
+
+draw(sched, style=IQXDebugging(), backend=FakeBoeblingen())
+```
+
+
+
+You can partially customize a preset stylesheet when initializing it.
+
+```python
+my_style = {
+ 'formatter.channel_scaling.drive': 5,
+ 'formatter.channel_scaling.control': 1,
+ 'formatter.channel_scaling.measure': 5
+}
+style = IQXStandard(**my_style)
+# draw
+draw(sched, style=style, backend=FakeBoeblingen())
+```
+
+In the same way as above, you can create custom generator or layout functions and update the existing stylesheet with custom functions. This feature enables you to customize most of the appearance of the output image without modifying the codebase.
+
+**Raises**
+
+* [**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – When required visualization package is not installed.
+* [**VisualizationError**](visualization#qiskit.visualization.VisualizationError "qiskit.visualization.VisualizationError") – When invalid plotter API or invalid time range is specified.
+
diff --git a/docs/api/qiskit/0.46/qiskit.visualization.timeline_drawer.md b/docs/api/qiskit/0.46/qiskit.visualization.timeline_drawer.md
new file mode 100644
index 00000000000..1800e433bb1
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.visualization.timeline_drawer.md
@@ -0,0 +1,321 @@
+---
+title: timeline_drawer
+description: API reference for qiskit.visualization.timeline_drawer
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.visualization.timeline_drawer
+---
+
+
+
+# qiskit.visualization.timeline\_drawer
+
+
+
+`qiskit.visualization.timeline_drawer(program, style=None, time_range=None, disable_bits=None, show_clbits=None, show_idle=None, show_barriers=None, show_delays=None, show_labels=True, plotter='mpl', axis=None, filename=None)`
+
+Generate visualization data for scheduled circuit programs.
+
+**Parameters**
+
+* **program** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")) – Program to visualize. This program should be a QuantumCircuit which is transpiled with a scheduling\_method, thus containing gate time information.
+
+* **style** ([*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)")*] | None*) – Stylesheet options. This can be dictionary or preset stylesheet classes. See `IQXStandard`, `IQXSimple`, and `IQXDebugging` for details of preset stylesheets. See also the stylesheet section for details of configuration keys.
+
+* **time\_range** ([*Tuple*](https://docs.python.org/3/library/typing.html#typing.Tuple "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*,* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – Set horizontal axis limit.
+
+* **disable\_bits** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[Bits] | None*) – List of qubits of classical bits not shown in the output image.
+
+* **show\_clbits** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – A control property to show classical bits. Set True to show classical bits.
+
+* **show\_idle** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – A control property to show idle timeline. Set True to show timeline without gates.
+
+* **show\_barriers** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – A control property to show barrier instructions. Set True to show barrier instructions.
+
+* **show\_delays** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – A control property to show delay instructions. Set True to show delay instructions.
+
+* **show\_labels** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – A control property to show annotations, i.e. name, of gates. Set True to show annotations.
+
+* **plotter** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) –
+
+ Name of plotter API to generate an output image. One of following APIs should be specified:
+
+ ```python
+ mpl: Matplotlib API
+ Matplotlib API to generate 2D image. Timelines are placed along y axis with
+ vertical offset. This API takes matplotlib.axes.Axes as `axis` input.
+ ```
+
+ axis and style kwargs may depend on the plotter.
+
+* **axis** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.12)") *| None*) – Arbitrary object passed to the plotter. If this object is provided, the plotters uses given axis instead of internally initializing a figure object. This object format depends on the plotter. See plotters section for details.
+
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – If provided the output image is dumped into a file under the filename.
+
+**Returns**
+
+Visualization output data.
+
+The returned data type depends on the plotter. If matplotlib family is specified, this will be a matplotlib.pyplot.Figure data. The returned data is generated by the .get\_image method of the specified plotter API.
+
+**Raises**
+
+* [**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – When required visualization package is not installed.
+* [**VisualizationError**](visualization#qiskit.visualization.VisualizationError "qiskit.visualization.VisualizationError") – When invalid plotter API is specified.
+
+**Style Dict Details**
+
+The stylesheet kwarg contains numerous options that define the style of the output timeline visualization. The stylesheet options can be classified into formatter, generator and layout. Those options available in the stylesheet are defined below:
+
+**Parameters**
+
+* **formatter.general.fig\_width** – Width of output image (default 14).
+
+* **formatter.general.fig\_unit\_height** – Height of output image per timeline. The sum of all timeline becomes the height of the output image (default 0.8).
+
+* **formatter.general.dpi** – Dot per inch of image if filename is set (default 150).
+
+* **formatter.margin.top** – Margin from the top boundary of the figure canvas to the zero line of the first time slot (default 0.5).
+
+* **formatter.margin.bottom** – Margin from the bottom boundary of the figure canvas to the zero lien of the last time slot (default 0.5).
+
+* **formatter.margin.left\_percent** – Margin from the left boundary of the figure canvas to the left limit of the horizontal axis. The value is in units of percentage of the whole program duration. If the duration is 100 and the value of 0.5 is set, this keeps left margin of 5 (default 0.02).
+
+* **formatter.margin.right\_percent** – Margin from the right boundary of the figure canvas to the right limit of the horizontal axis. The value is in units of percentage of the whole program duration. If the duration is 100 and the value of 0.5 is set, this keeps right margin of 5 (default 0.02).
+
+* **formatter.margin.link\_interval\_percent** – Allowed overlap of gate links. If multiple gate links are drawing within this range, links are horizontally shifted not to overlap with each other. The value is in units of percentage of the whole program duration (default 0.01).
+
+* **formatter.time\_bucket.edge\_dt** – The length of round edge of gate boxes. Gate boxes are smoothly faded in and out from the zero line. This value is in units of the system cycle time dt (default 10).
+
+* **formatter.margin.minimum\_duration** – Minimum scheduled circuit duration. If the duration of input circuit is below this value, horizontal limit is set based on this value. This value is in units of the system cycle time dt (default 50).
+
+* **formatter.color.background** – Color code of the face color of canvas (default #FFFFFF).
+
+* **formatter.color.timeslot** – Face color of the time slot box (default #DDDDDD).
+
+* **formatter.color.gate\_name** – Text color of the gate name annotations (default #000000).
+
+* **formatter.color.bit\_name** – Text color of the bit label annotations (default #000000).
+
+* **formatter.color.barrier** – Line color of barriers (default #222222).
+
+* **formatter.color.gates** –
+
+ A dictionary of the gate box or gate symbol colors to use for each element type in the output visualization. The default values are:
+
+ ```python
+ {
+ 'u0': '#FA74A6',
+ 'u1': '#000000',
+ 'u2': '#FA74A6',
+ 'u3': '#FA74A6',
+ 'id': '#05BAB6',
+ 'sx': '#FA74A6',
+ 'sxdg': '#FA74A6',
+ 'x': '#05BAB6',
+ 'y': '#05BAB6',
+ 'z': '#05BAB6',
+ 'h': '#6FA4FF',
+ 'cx': '#6FA4FF',
+ 'cy': '#6FA4FF',
+ 'cz': '#6FA4FF',
+ 'swap': '#6FA4FF',
+ 's': '#6FA4FF',
+ 'sdg': '#6FA4FF',
+ 'dcx': '#6FA4FF',
+ 'iswap': '#6FA4FF',
+ 't': '#BB8BFF',
+ 'tdg': '#BB8BFF',
+ 'r': '#BB8BFF',
+ 'rx': '#BB8BFF',
+ 'ry': '#BB8BFF',
+ 'rz': '#000000',
+ 'reset': '#808080',
+ 'measure': '#808080'
+ }
+ ```
+
+ You must specify all the necessary values if using this. If a gate name is not specified, the color in formatter.color.default\_gate is applied.
+
+* **formatter.color.default\_gate** – Default gate color. This color is applied when a gate name to visualize is not contained in the dictionary of formatter.color.gates (default #BB8BFF).
+
+* **formatter.latex\_symbol.gates** –
+
+ A dictionary of latex representation of gate names to use for each element type in the output visualization. The default values are:
+
+ ```python
+ {
+ 'u0': r'{\rm U}_0',
+ 'u1': r'{\rm U}_1',
+ 'u2': r'{\rm U}_2',
+ 'u3': r'{\rm U}_3',
+ 'id': r'{\rm Id}',
+ 'x': r'{\rm X}',
+ 'y': r'{\rm Y}',
+ 'z': r'{\rm Z}',
+ 'h': r'{\rm H}',
+ 'cx': r'{\rm CX}',
+ 'cy': r'{\rm CY}',
+ 'cz': r'{\rm CZ}',
+ 'swap': r'{\rm SWAP}',
+ 's': r'{\rm S}',
+ 'sdg': r'{\rm S}^\dagger',
+ 'sx': r'{\rm √X}',
+ 'sxdg': r'{\rm √X}^\dagger',
+ 'dcx': r'{\rm DCX}',
+ 'iswap': r'{\rm iSWAP}',
+ 't': r'{\rm T}',
+ 'tdg': r'{\rm T}^\dagger',
+ 'r': r'{\rm R}',
+ 'rx': r'{\rm R}_x',
+ 'ry': r'{\rm R}_y',
+ 'rz': r'{\rm R}_z',
+ 'reset': r'|0\rangle',
+ 'measure': r'{\rm Measure}'
+ }
+ ```
+
+ You must specify all the necessary values if using this. There is no provision for passing an incomplete dict in.
+
+* **formatter.latex\_symbol.frame\_change** – Latex representation of the frame change symbol (default r\`circlearrowleft\`).
+
+* **formatter.unicode\_symbol.frame\_change** – Unicode representation of the frame change symbol (default u’u21BA’).
+
+* **formatter.box\_height.gate** – Height of gate box (default 0.5).
+
+* **formatter.box\_height.timeslot** – Height of time slot (default 0.6).
+
+* **formatter.layer.gate** – Layer index of gate boxes. Larger number comes in the front of the output image (default 3).
+
+* **formatter.layer.timeslot** – Layer index of time slots. Larger number comes in the front of the output image (default 0).
+
+* **formatter.layer.gate\_name** – Layer index of gate name annotations. Larger number comes in the front of the output image (default 5).
+
+* **formatter.layer.bit\_name** – Layer index of bit labels. Larger number comes in the front of the output image (default 5).
+
+* **formatter.layer.frame\_change** – Layer index of frame change symbols. Larger number comes in the front of the output image (default 4).
+
+* **formatter.layer.barrier** – Layer index of barrier lines. Larger number comes in the front of the output image (default 1).
+
+* **formatter.layer.gate\_link** – Layer index of gate link lines. Larger number comes in the front of the output image (default 2).
+
+* **formatter.alpha.gate** – Transparency of gate boxes. A value in the range from 0 to 1. The value 0 gives completely transparent boxes (default 1.0).
+
+* **formatter.alpha.timeslot** – Transparency of time slots. A value in the range from 0 to 1. The value 0 gives completely transparent boxes (default 0.7).
+
+* **formatter.alpha.barrier** – Transparency of barrier lines. A value in the range from 0 to 1. The value 0 gives completely transparent lines (default 0.5).
+
+* **formatter.alpha.gate\_link** – Transparency of gate link lines. A value in the range from 0 to 1. The value 0 gives completely transparent lines (default 0.8).
+
+* **formatter.line\_width.gate** – Line width of the fringe of gate boxes (default 0).
+
+* **formatter.line\_width.timeslot** – Line width of the fringe of time slots (default 0).
+
+* **formatter.line\_width.barrier** – Line width of barrier lines (default 3).
+
+* **formatter.line\_width.gate\_link** – Line width of gate links (default 3).
+
+* **formatter.line\_style.barrier** – Line style of barrier lines. This conforms to the line style spec of matplotlib (default ‘-’).
+
+* **formatter.line\_style.gate\_link** – Line style of gate link lines. This conforms to the line style spec of matplotlib (default ‘-’).
+
+* **formatter.text\_size.gate\_name** – Text size of gate name annotations (default 12).
+
+* **formatter.text\_size.bit\_name** – Text size of bit labels (default 15).
+
+* **formatter.text\_size.frame\_change** – Text size of frame change symbols (default 18).
+
+* **formatter.text\_size.axis\_label** – Text size of axis labels (default 13).
+
+* **formatter.label\_offset.frame\_change** – Offset of zero duration gate name annotations from the zero line of time slot (default 0.25).
+
+* **formatter.control.show\_idle** – Set True to show time slots without gate (default True).
+
+* **formatter.control.show\_clbits** – Set True to show time slots of classical bits (default True).
+
+* **formatter.control.show\_barriers** – Set True to show barriers (default True).
+
+* **formatter.control.show\_delays** – Set True to show delay boxes (default True).
+
+* **generator.gates** – List of callback functions that generates drawings for gates. Arbitrary callback functions satisfying the generator format can be set here. There are some default generators in the timeline drawer. See `generators` for more details. No default generator is set (default \[]).
+
+* **generator.bits** – List of callback functions that generates drawings for bit labels and time slots. Arbitrary callback functions satisfying the generator format can be set here. There are some default generators in the timeline drawer. See `generators` for more details. No default generator is set (default \[]).
+
+* **generator.barriers** – List of callback functions that generates drawings for barriers. Arbitrary callback functions satisfying the generator format can be set here. There are some default generators in the timeline drawer. See `generators` for more details. No default generator is set (default \[]).
+
+* **generator.gate\_links** – List of callback functions that generates drawings for gate links. Arbitrary callback functions satisfying the generator format can be set here. There are some default generators in the timeline drawer. See `generators` for more details. No default generator is set (default \[]).
+
+* **layout.bit\_arrange** – Callback function that sorts bits. See `layouts` for more details. No default layout is set. (default None).
+
+* **layout.time\_axis\_map** – Callback function that determines the layout of horizontal axis labels. See `layouts` for more details. No default layout is set. (default None).
+
+**Examples**
+
+To visualize a scheduled circuit program, you can call this function with set of control arguments. Most of appearance of the output image can be controlled by the stylesheet.
+
+Drawing with the default stylesheet.
+
+```python
+from qiskit import QuantumCircuit, transpile, schedule
+from qiskit.visualization.timeline import draw
+from qiskit.providers.fake_provider import FakeBoeblingen
+
+qc = QuantumCircuit(2)
+qc.h(0)
+qc.cx(0,1)
+
+qc = transpile(qc, FakeBoeblingen(), scheduling_method='alap', layout_method='trivial')
+draw(qc)
+```
+
+
+
+Drawing with the simple stylesheet.
+
+```python
+from qiskit import QuantumCircuit, transpile, schedule
+from qiskit.visualization.timeline import draw, IQXSimple
+from qiskit.providers.fake_provider import FakeBoeblingen
+
+qc = QuantumCircuit(2)
+qc.h(0)
+qc.cx(0,1)
+
+qc = transpile(qc, FakeBoeblingen(), scheduling_method='alap', layout_method='trivial')
+draw(qc, style=IQXSimple())
+```
+
+
+
+Drawing with the stylesheet suited for program debugging.
+
+```python
+from qiskit import QuantumCircuit, transpile, schedule
+from qiskit.visualization.timeline import draw, IQXDebugging
+from qiskit.providers.fake_provider import FakeBoeblingen
+
+qc = QuantumCircuit(2)
+qc.h(0)
+qc.cx(0,1)
+
+qc = transpile(qc, FakeBoeblingen(), scheduling_method='alap', layout_method='trivial')
+draw(qc, style=IQXDebugging())
+```
+
+
+
+You can partially customize a preset stylesheet when call it:
+
+```python
+my_style = {
+ 'formatter.general.fig_width': 16,
+ 'formatter.general.fig_unit_height': 1
+}
+style = IQXStandard(**my_style)
+
+# draw
+draw(qc, style=style)
+```
+
+In the same way as above, you can create custom generator or layout functions and update existing stylesheet with custom functions. This feature enables you to control the most of appearance of the output image without modifying the codebase of the scheduled circuit drawer.
+
diff --git a/docs/api/qiskit/0.46/qiskit.visualization.visualize_transition.md b/docs/api/qiskit/0.46/qiskit.visualization.visualize_transition.md
new file mode 100644
index 00000000000..c3746ef468d
--- /dev/null
+++ b/docs/api/qiskit/0.46/qiskit.visualization.visualize_transition.md
@@ -0,0 +1,39 @@
+---
+title: visualize_transition
+description: API reference for qiskit.visualization.visualize_transition
+in_page_toc_min_heading_level: 1
+python_api_type: function
+python_api_name: qiskit.visualization.visualize_transition
+---
+
+
+
+# qiskit.visualization.visualize\_transition
+
+
+
+`qiskit.visualization.visualize_transition(circuit, trace=False, saveas=None, fpg=100, spg=2)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/visualization/transition_visualization.py "view source code")
+
+Creates animation showing transitions between states of a single qubit by applying quantum gates.
+
+**Parameters**
+
+* **circuit** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – Qiskit single-qubit QuantumCircuit. Gates supported are h,x, y, z, rx, ry, rz, s, sdg, t, tdg and u1.
+* **trace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Controls whether to display tracing vectors - history of 10 past vectors at each step of the animation.
+* **saveas** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – User can choose to save the animation as a video to their filesystem. This argument is a string of path with filename and extension (e.g. “movie.mp4” to save the video in current working directory).
+* **fpg** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Frames per gate. Finer control over animation smoothness and computational needs to render the animation. Works well for tkinter GUI as it is, for jupyter GUI it might be preferable to choose fpg between 5-30.
+* **spg** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Seconds per gate. How many seconds should animation of individual gate transitions take.
+
+**Returns**
+
+If arg jupyter is set to True. Otherwise opens tkinter GUI and returns after the GUI is closed.
+
+**Return type**
+
+IPython.core.display.HTML
+
+**Raises**
+
+* [**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – Must have Matplotlib (and/or IPython) installed.
+* [**VisualizationError**](visualization#qiskit.visualization.VisualizationError "qiskit.visualization.VisualizationError") – Given gate(s) are not supported.
+
diff --git a/docs/api/qiskit/0.46/qobj.md b/docs/api/qiskit/0.46/qobj.md
new file mode 100644
index 00000000000..8f12c528eb2
--- /dev/null
+++ b/docs/api/qiskit/0.46/qobj.md
@@ -0,0 +1,51 @@
+---
+title: qobj
+description: API reference for qiskit.qobj
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.qobj
+---
+
+
+
+
+
+
+
+# Qobj
+
+
+
+`qiskit.qobj`
+
+## Base
+
+| | |
+| --------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
+| [`QobjExperimentHeader`](qiskit.qobj.QobjExperimentHeader "qiskit.qobj.QobjExperimentHeader")(\*\*kwargs) | A class representing a header dictionary for a Qobj Experiment. |
+| [`QobjHeader`](qiskit.qobj.QobjHeader "qiskit.qobj.QobjHeader")(\*\*kwargs) | A class used to represent a dictionary header in Qobj objects. |
+
+## Qasm
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
+| [`QasmQobj`](qiskit.qobj.QasmQobj "qiskit.qobj.QasmQobj")(\[qobj\_id, config, experiments, header]) | An OpenQASM 2 Qobj. |
+| [`QasmQobjInstruction`](qiskit.qobj.QasmQobjInstruction "qiskit.qobj.QasmQobjInstruction")(name\[, params, qubits, ...]) | A class representing a single instruction in an QasmQobj Experiment. |
+| [`QasmQobjExperimentConfig`](qiskit.qobj.QasmQobjExperimentConfig "qiskit.qobj.QasmQobjExperimentConfig")(\[calibrations, ...]) | Configuration for a single OpenQASM 2 experiment in the qobj. |
+| [`QasmQobjExperiment`](qiskit.qobj.QasmQobjExperiment "qiskit.qobj.QasmQobjExperiment")(\[config, header, ...]) | An OpenQASM 2 Qobj Experiment. |
+| [`QasmQobjConfig`](qiskit.qobj.QasmQobjConfig "qiskit.qobj.QasmQobjConfig")(\[shots, seed\_simulator, ...]) | A configuration for an OpenQASM 2 Qobj. |
+| [`QasmExperimentCalibrations`](qiskit.qobj.QasmExperimentCalibrations "qiskit.qobj.QasmExperimentCalibrations")(gates) | A container for any calibrations data. |
+| [`GateCalibration`](qiskit.qobj.GateCalibration "qiskit.qobj.GateCalibration")(name, qubits, params, ...) | Each calibration specifies a unique gate by name, qubits and params, and contains the Pulse instructions to implement it. |
+
+## Pulse
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
+| [`PulseQobj`](qiskit.qobj.PulseQobj "qiskit.qobj.PulseQobj")(qobj\_id, config, experiments\[, header]) | A Pulse Qobj. |
+| [`PulseQobjInstruction`](qiskit.qobj.PulseQobjInstruction "qiskit.qobj.PulseQobjInstruction")(name, t0\[, ch, ...]) | A class representing a single instruction in an PulseQobj Experiment. |
+| [`PulseQobjExperimentConfig`](qiskit.qobj.PulseQobjExperimentConfig "qiskit.qobj.PulseQobjExperimentConfig")(\[qubit\_lo\_freq, ...]) | A config for a single Pulse experiment in the qobj. |
+| [`PulseQobjExperiment`](qiskit.qobj.PulseQobjExperiment "qiskit.qobj.PulseQobjExperiment")(instructions\[, config, ...]) | A Pulse Qobj Experiment. |
+| [`PulseQobjConfig`](qiskit.qobj.PulseQobjConfig "qiskit.qobj.PulseQobjConfig")(meas\_level, meas\_return, ...) | A configuration for a Pulse Qobj. |
+| [`QobjMeasurementOption`](qiskit.qobj.QobjMeasurementOption "qiskit.qobj.QobjMeasurementOption")(name\[, params]) | An individual measurement option. |
+| [`PulseLibraryItem`](qiskit.qobj.PulseLibraryItem "qiskit.qobj.PulseLibraryItem")(name, samples) | An item in a pulse library. |
+
diff --git a/docs/api/qiskit/0.46/qpy.md b/docs/api/qiskit/0.46/qpy.md
new file mode 100644
index 00000000000..066b775c41c
--- /dev/null
+++ b/docs/api/qiskit/0.46/qpy.md
@@ -0,0 +1,1088 @@
+---
+title: qpy
+description: API reference for qiskit.qpy
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.qpy
+---
+
+
+
+
+
+
+
+# QPY serialization
+
+
+
+`qiskit.qpy`
+
+QPY is a binary serialization format for [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") and [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") objects that is designed to be cross-platform, Python version agnostic, and backwards compatible moving forward. QPY should be used if you need a mechanism to save or copy between systems a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") or [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") that preserves the full Qiskit object structure (except for custom attributes defined outside of Qiskit code). This differs from other serialization formats like [OpenQASM](https://github.com/openqasm/openqasm) (2.0 or 3.0) which has a different abstraction model and can result in a loss of information contained in the original circuit (or is unable to represent some aspects of the Qiskit objects) or Python’s [pickle](https://docs.python.org/3/library/pickle.html) which will preserve the Qiskit object exactly but will only work for a single Qiskit version (it is also [potentially insecure](https://docs.python.org/3/library/pickle.html#module-pickle)).
+
+## Using QPY
+
+Using QPY is defined to be straightforward and mirror the user API of the serializers in Python’s standard library, `pickle` and `json`. There are 2 user facing functions: [`qiskit.qpy.dump()`](#qiskit.qpy.dump "qiskit.qpy.dump") and [`qiskit.qpy.load()`](#qiskit.qpy.load "qiskit.qpy.load") which are used to dump QPY data to a file object and load circuits from QPY data in a file object respectively. For example:
+
+```python
+from qiskit.circuit import QuantumCircuit
+from qiskit import qpy
+
+qc = QuantumCircuit(2, name='Bell', metadata={'test': True})
+qc.h(0)
+qc.cx(0, 1)
+qc.measure_all()
+
+with open('bell.qpy', 'wb') as fd:
+ qpy.dump(qc, fd)
+
+with open('bell.qpy', 'rb') as fd:
+ new_qc = qpy.load(fd)[0]
+```
+
+The [`qiskit.qpy.dump()`](#qiskit.qpy.dump "qiskit.qpy.dump") function also lets you include multiple circuits in a single QPY file:
+
+```python
+with open('twenty_bells.qpy', 'wb') as fd:
+ qpy.dump([qc] * 20, fd)
+```
+
+and then loading that file will return a list with all the circuits
+
+> **with open(‘twenty\_bells.qpy’, ‘rb’) as fd:**
+>
+> twenty\_new\_bells = qpy.load(fd)
+
+### API documentation
+
+### load
+
+
+
+`qiskit.qpy.load(file_obj, metadata_deserializer=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qpy/interface.py "view source code")
+
+Load a QPY binary file
+
+This function is used to load a serialized QPY Qiskit program file and create [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") objects or [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock") objects from its contents. For example:
+
+```python
+from qiskit import qpy
+
+with open('bell.qpy', 'rb') as fd:
+ circuits = qpy.load(fd)
+```
+
+or with a gzip compressed file:
+
+```python
+import gzip
+from qiskit import qpy
+
+with gzip.open('bell.qpy.gz', 'rb') as fd:
+ circuits = qpy.load(fd)
+```
+
+which will read the contents of the qpy and return a list of [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") objects or [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock") objects from the file.
+
+**Parameters**
+
+* **file\_obj** ([*BinaryIO*](https://docs.python.org/3/library/typing.html#typing.BinaryIO "(in Python v3.12)")) – A file like object that contains the QPY binary data for a circuit or pulse schedule.
+* **metadata\_deserializer** ([*Type*](https://docs.python.org/3/library/typing.html#typing.Type "(in Python v3.12)")*\[JSONDecoder] | None*) – An optional JSONDecoder class that will be used for the `cls` kwarg on the internal `json.load` call used to deserialize the JSON payload used for the `.metadata` attribute for any programs in the QPY file. If this is not specified the circuit metadata will be parsed as JSON with the stdlib `json.load()` function using the default `JSONDecoder` class.
+
+**Returns**
+
+The list of Qiskit programs contained in the QPY data. A list is always returned, even if there is only 1 program in the QPY data.
+
+**Raises**
+
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if `file_obj` is not a valid QPY file
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – When invalid data type is loaded.
+
+**Return type**
+
+[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")\[[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit") | [*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock")]
+
+### dump
+
+
+
+`qiskit.qpy.dump(programs, file_obj, metadata_serializer=None, use_symengine=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qpy/interface.py "view source code")
+
+Write QPY binary data to a file
+
+This function is used to save a circuit to a file for later use or transfer between machines. The QPY format is backwards compatible and can be loaded with future versions of Qiskit.
+
+For example:
+
+```python
+from qiskit.circuit import QuantumCircuit
+from qiskit import qpy
+
+qc = QuantumCircuit(2, name='Bell', metadata={'test': True})
+qc.h(0)
+qc.cx(0, 1)
+qc.measure_all()
+```
+
+from this you can write the qpy data to a file:
+
+```python
+with open('bell.qpy', 'wb') as fd:
+ qpy.dump(qc, fd)
+```
+
+or a gzip compressed file:
+
+```python
+import gzip
+
+with gzip.open('bell.qpy.gz', 'wb') as fd:
+ qpy.dump(qc, fd)
+```
+
+Which will save the qpy serialized circuit to the provided file.
+
+**Parameters**
+
+* **programs** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit") *|*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock")*] |* [*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit") *|*[*ScheduleBlock*](qiskit.pulse.ScheduleBlock "qiskit.pulse.schedule.ScheduleBlock")) – QPY supported object(s) to store in the specified file like object. QPY supports [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") and [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock"). Different data types must be separately serialized.
+* **file\_obj** ([*BinaryIO*](https://docs.python.org/3/library/typing.html#typing.BinaryIO "(in Python v3.12)")) – The file like object to write the QPY data too
+* **metadata\_serializer** ([*Type*](https://docs.python.org/3/library/typing.html#typing.Type "(in Python v3.12)")*\[JSONEncoder] | None*) – An optional JSONEncoder class that will be passed the `.metadata` attribute for each program in `programs` and will be used as the `cls` kwarg on the json.dump()\` call to JSON serialize that dictionary.
+* **use\_symengine** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, all objects containing symbolic expressions will be serialized using symengine’s native mechanism. This is a faster serialization alternative, but not supported in all platforms. Please check that your target platform is supported by the symengine library before setting this option, as it will be required by qpy to deserialize the payload. For this reason, the option defaults to False.
+
+**Raises**
+
+* [**QpyError**](#qiskit.qpy.QpyError "qiskit.qpy.QpyError") – When multiple data format is mixed in the output.
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – When invalid data type is input.
+
+These functions will raise a custom subclass of [`QiskitError`](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") if they encounter problems during serialization or deserialization.
+
+### QpyError
+
+
+
+`qiskit.qpy.QpyError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/qpy/exceptions.py "view source code")
+
+Errors raised by the qpy module.
+
+Set the error message.
+
+### QPY Compatibility
+
+The QPY format is designed to be backwards compatible moving forward. This means you should be able to load a QPY with any newer Qiskit version than the one that generated it. However, loading a QPY file with an older Qiskit version is not supported and may not work.
+
+For example, if you generated a QPY file using qiskit-terra 0.18.1 you could load that QPY file with qiskit-terra 0.19.0 and a hypothetical qiskit-terra 0.29.0. However, loading that QPY file with 0.18.0 is not supported and may not work.
+
+
+
+## QPY Format
+
+The QPY serialization format is a portable cross-platform binary serialization format for [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") objects in Qiskit. The basic file format is as follows:
+
+A QPY file (or memory object) always starts with the following 6 byte UTF8 string: `QISKIT` which is immediately followed by the overall file header. The contents of the file header as defined as a C struct are:
+
+```python
+struct {
+ uint8_t qpy_version;
+ uint8_t qiskit_major_version;
+ uint8_t qiskit_minor_version;
+ uint8_t qiskit_patch_version;
+ uint64_t num_circuits;
+}
+```
+
+From V10 on, a new field is added to the file header struct to represent the encoding scheme used for symbolic expressions:
+
+```python
+struct {
+ uint8_t qpy_version;
+ uint8_t qiskit_major_version;
+ uint8_t qiskit_minor_version;
+ uint8_t qiskit_patch_version;
+ uint64_t num_circuits;
+ char symbolic_encoding;
+}
+```
+
+All values use network byte order [\[1\]](#f1) (big endian) for cross platform compatibility.
+
+The file header is immediately followed by the circuit payloads. Each individual circuit is composed of the following parts:
+
+`HEADER | METADATA | REGISTERS | CUSTOM_DEFINITIONS | INSTRUCTIONS`
+
+There is a circuit payload for each circuit (where the total number is dictated by `num_circuits` in the file header). There is no padding between the circuits in the data.
+
+
+
+### Version 10
+
+Version 10 adds support for symengine-native serialization for objects of type [`ParameterExpression`](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression") as well as symbolic expressions in Pulse schedule blocks. Version 10 also adds support for new fields in the [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") class added in the Qiskit 0.45.0 release.
+
+The symbolic\_encoding field is added to the file header, and a new encoding type char is introduced, mapped to each symbolic library as follows: `p` refers to sympy encoding and `e` refers to symengine encoding.
+
+
+
+#### FILE\_HEADER
+
+The contents of FILE\_HEADER after V10 are defined as a C struct as:
+
+```python
+struct {
+ uint8_t qpy_version;
+ uint8_t qiskit_major_version;
+ uint8_t qiskit_minor_version;
+ uint8_t qiskit_patch_version;
+ uint64_t num_circuits;
+ char symbolic_encoding;
+}
+```
+
+#### LAYOUT
+
+The `LAYOUT` struct is updated to have an additional `input_qubit_count` field. With version 10 the `LAYOUT` struct is now:
+
+```python
+struct {
+ char exists;
+ int32_t initial_layout_size;
+ int32_t input_mapping_size;
+ int32_t final_layout_size;
+ uint32_t extra_registers;
+ int32_t input_qubit_count;
+}
+```
+
+The rest of the layout data after the `LAYOUT` struct is represented as in previous versions. If `input qubit_count` is \< 0 that indicates that both `_input_qubit_count` and `_output_qubit_list` in the [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") object are `None`.
+
+
+
+### Version 9
+
+Version 9 adds support for classical [`Expr`](circuit_classical#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.Expr") nodes and their associated [`Type`](circuit_classical#qiskit.circuit.classical.types.Type "qiskit.circuit.classical.types.Type")s.
+
+#### EXPRESSION
+
+An [`Expr`](circuit_classical#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.Expr") node is represented by a stream of variable-width data. A node itself is represented by (in order in the byte stream):
+
+1. a one-byte type code discriminator;
+2. an EXPR\_TYPE object;
+3. a type-code-specific additional payload;
+4. a type-code-specific number of child EXPRESSION payloads (the number of these is implied by the type code and not explicitly stored).
+
+Each of these are described in the following table:
+
+| Qiskit class | Type code | Payload | Children |
+| --------------------------------------------------------------------------------------------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
+| [`Var`](circuit_classical#qiskit.circuit.classical.expr.Var "qiskit.circuit.classical.expr.Var") | `x` | One EXPR\_VAR. | 0 |
+| [`Value`](circuit_classical#qiskit.circuit.classical.expr.Value "qiskit.circuit.classical.expr.Value") | `v` | One EXPR\_VALUE. | 0 |
+| [`Cast`](circuit_classical#qiskit.circuit.classical.expr.Cast "qiskit.circuit.classical.expr.Cast") | `c` | One `_Bool` that corresponds to the value of `implicit`. | 1 |
+| [`Unary`](circuit_classical#qiskit.circuit.classical.expr.Unary "qiskit.circuit.classical.expr.Unary") | `u` | One `uint8_t` with the same numeric value as the [`Unary.Op`](circuit_classical#qiskit.circuit.classical.expr.Unary.Op "qiskit.circuit.classical.expr.Unary.Op"). | 1 |
+| [`Binary`](circuit_classical#qiskit.circuit.classical.expr.Binary "qiskit.circuit.classical.expr.Binary") | `b` | One `uint8_t` with the same numeric value as the [`Binary.Op`](circuit_classical#qiskit.circuit.classical.expr.Binary.Op "qiskit.circuit.classical.expr.Binary.Op"). | 2 |
+
+
+
+#### EXPR\_TYPE
+
+A [`Type`](circuit_classical#qiskit.circuit.classical.types.Type "qiskit.circuit.classical.types.Type") is encoded by a single-byte ASCII `char` that encodes the kind of type, followed by a payload that varies depending on the type. The defined codes are:
+
+| Qiskit class | Type code | Payload |
+| ----------------------------------------------------------------------------------------------------- | --------- | --------------------- |
+| [`Bool`](circuit_classical#qiskit.circuit.classical.types.Bool "qiskit.circuit.classical.types.Bool") | `b` | None. |
+| [`Uint`](circuit_classical#qiskit.circuit.classical.types.Uint "qiskit.circuit.classical.types.Uint") | `u` | One `uint32_t width`. |
+
+
+
+#### EXPR\_VAR
+
+This represents a runtime variable of a [`Var`](circuit_classical#qiskit.circuit.classical.expr.Var "qiskit.circuit.classical.expr.Var") node. These are a type code, followed by a type-code-specific payload:
+
+| Python class | Type code | Payload |
+| ------------------------------------------------------------------------------------------ | --------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| [`Clbit`](qiskit.circuit.Clbit "qiskit.circuit.Clbit") | `C` | One `uint32_t index` that is the index of the [`Clbit`](qiskit.circuit.Clbit "qiskit.circuit.Clbit") in the containing circuit. |
+| [`ClassicalRegister`](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister") | `R` | One `uint16_t reg_name_size`, followed by that many bytes of UTF-8 string data of the register name. |
+
+
+
+#### EXPR\_VALUE
+
+This represents a literal object in the classical type system, such as an integer. Currently there are very few such literals. These are encoded as a type code, followed by a type-code-specific payload.
+
+| Python type | Type code | Payload |
+| ----------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| `bool` | `b` | One `_Bool value`. |
+| `int` | `i` | One `uint8_t num_bytes`, followed by the integer encoded into that many many bytes (network order) in a two’s complement representation. |
+
+#### Changes to INSTRUCTION
+
+To support the use of [`Expr`](circuit_classical#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.Expr") nodes in the fields [`IfElseOp.condition`](qiskit.circuit.IfElseOp#condition "qiskit.circuit.IfElseOp.condition"), [`WhileLoopOp.condition`](qiskit.circuit.WhileLoopOp#condition "qiskit.circuit.WhileLoopOp.condition") and `SwitchCaseOp.target`, the INSTRUCTION struct is changed in an ABI compatible-manner to [its previous definition](#qpy-instruction-v5). The new struct is the C struct:
+
+```python
+struct {
+ uint16_t name_size;
+ uint16_t label_size;
+ uint16_t num_parameters;
+ uint32_t num_qargs;
+ uint32_t num_cargs;
+ uint8_t conditional_key;
+ uint16_t conditional_reg_name_size;
+ int64_t conditional_value;
+ uint32_t num_ctrl_qubits;
+ uint32_t ctrl_state;
+}
+```
+
+where the only change is that a `uint8_t conditional_key` entry has replaced `_Bool has_conditional`. This new `conditional_key` takes the following numeric values, with these effects:
+
+| Value | Effects |
+| ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 0 | The instruction has its `.condition` field set to `None`. The `conditional_reg_name_size` and `conditional_value` fields should be ignored. |
+| 1 | The instruction has its `.condition` field set to a 2-tuple of either a [`Clbit`](qiskit.circuit.Clbit "qiskit.circuit.Clbit") or a [`ClassicalRegister`](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister"), and a integer of value `conditional_value`. The INSTRUCTION payload, including its trailing data is parsed exactly as it would be in QPY versions less than 8. |
+| 2 | The instruction has its `.condition` field set to a [`Expr`](circuit_classical#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.Expr") node. The `conditional_reg_name_size` and `conditional_value` fields should be ignored. The data following the struct is followed (as in QPY versions less than 8) by `name_size` bytes of UTF-8 string data for the class name and `label_size` bytes of UTF-8 string data for the label (if any). Then, there is one INSTRUCTION\_PARAM, which will contain an EXPRESSION. After that, parsing continues with the INSTRUCTION\_ARG structs, as in previous versions of QPY. |
+
+
+
+#### Changes to INSTRUCTION\_PARAM
+
+A new type code `x` is added that defines an EXPRESSION parameter.
+
+
+
+### Version 8
+
+Version 8 adds support for handling a [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") stored in the [`QuantumCircuit.layout`](qiskit.circuit.QuantumCircuit#layout "qiskit.circuit.QuantumCircuit.layout") attribute. In version 8 immediately following the calibrations block at the end of the circuit payload there is now the `LAYOUT` struct. This struct outlines the size of the three attributes of a [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") class.
+
+
+
+#### LAYOUT
+
+```python
+struct {
+ char exists;
+ int32_t initial_layout_size;
+ int32_t input_mapping_size;
+ int32_t final_layout_size;
+ uint32_t extra_registers;
+}
+```
+
+If any of the signed values are `-1` this indicates the corresponding attribute is `None`.
+
+Immediately following the `LAYOUT` struct there is a [REGISTERS](#qpy-registers) struct for `extra_registers` (specifically the format introduced in [Version 4](#qpy-version-4)) standalone register definitions that aren’t present in the circuit. Then there are `initial_layout_size` `INITIAL_LAYOUT_BIT` structs to define the [`TranspileLayout.initial_layout`](qiskit.transpiler.TranspileLayout#initial_layout "qiskit.transpiler.TranspileLayout.initial_layout") attribute.
+
+
+
+#### INITIAL\_LAYOUT\_BIT
+
+```python
+struct {
+ int32_t index;
+ int32_t register_size;
+}
+```
+
+Where a value of `-1` indicates `None` (as in no register is associated with the bit). Following each `INITIAL_LAYOUT_BIT` struct is `register_size` bytes for a `utf8` encoded string for the register name.
+
+Following the initial layout there is `input_mapping_size` array of `uint32_t` integers representing the positions of the physical bit from the initial layout. This enables constructing a list of virtual bits where the array index is its input mapping position.
+
+Finally, there is an array of `final_layout_size` `uint32_t` integers. Each element is an index in the circuit’s `qubits` attribute which enables building a mapping from qubit starting position to the output position at the end of the circuit.
+
+
+
+### Version 7
+
+Version 7 adds support for `Reference` instruction and serialization of a `ScheduleBlock` program while keeping its reference to subroutines:
+
+```python
+from qiskit import pulse
+from qiskit import qpy
+
+with pulse.build() as schedule:
+ pulse.reference("cr45p", "q0", "q1")
+ pulse.reference("x", "q0")
+ pulse.reference("cr45p", "q0", "q1")
+
+with open('template_ecr.qpy', 'wb') as fd:
+ qpy.dump(schedule, fd)
+```
+
+The conventional [SCHEDULE\_BLOCK](#qpy-schedule-block) data model is preserved, but in version 7 it is immediately followed by an extra [MAPPING](#qpy-mapping) utf8 bytes block representing the data of the referenced subroutines.
+
+New type key character is added to the [SCHEDULE\_BLOCK\_INSTRUCTIONS](#qpy-schedule-instructions) group for the `Reference` instruction.
+
+* `y`: [`Reference`](qiskit.pulse.instructions.Reference "qiskit.pulse.instructions.Reference") instruction
+
+New type key character is added to the [SCHEDULE\_BLOCK\_OPERANDS](#qpy-schedule-operands) group for the operands of `Reference` instruction, which is a tuple of strings, e.g. (“cr45p”, “q0”, “q1”).
+
+* `o`: string (operand string)
+
+Note that this is the same encoding with the built-in Python string, however, the standard value encoding in QPY uses `s` type character for string data, which conflicts with the [`SymbolicPulse`](qiskit.pulse.library.SymbolicPulse "qiskit.pulse.library.SymbolicPulse") in the scope of pulse instruction operands. A special type character `o` is reserved for the string data that appears in the pulse instruction operands.
+
+In addition, version 7 adds two new type keys to the INSTRUCTION\_PARM struct. `"d"` is followed by no data and represents the literal value [`CASE_DEFAULT`](circuit#qiskit.circuit.CASE_DEFAULT "qiskit.circuit.CASE_DEFAULT") for switch-statement support. `"R"` represents a [`ClassicalRegister`](qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister") or [`Clbit`](qiskit.circuit.Clbit "qiskit.circuit.Clbit"), and is followed by the same format as the description of register or classical bit as used in the first element of [the condition of an INSTRUCTION field](#qpy-instructions).
+
+
+
+### Version 6
+
+Version 6 adds support for `ScalableSymbolicPulse`. These objects are saved and read like SymbolicPulse objects, and the class name is added to the data to correctly handle the class selection.
+
+SymbolicPulse block now starts with SYMBOLIC\_PULSE\_V2 header:
+
+```python
+struct {
+ uint16_t class_name_size;
+ uint16_t type_size;
+ uint16_t envelope_size;
+ uint16_t constraints_size;
+ uint16_t valid_amp_conditions_size;
+ _bool amp_limited;
+}
+```
+
+The only change compared to [Version 5](#qpy-version-5) is the addition of class\_name\_size. The header is then immediately followed by `class_name_size` utf8 bytes with the name of the class. Currently, either SymbolicPulse or ScalableSymbolicPulse are supported. The rest of the data is then identical to [Version 5](#qpy-version-5).
+
+
+
+### Version 5
+
+Version 5 changes from [Version 4](#qpy-version-4) by adding support for `ScheduleBlock` and changing two payloads the INSTRUCTION metadata payload and the CUSTOM\_INSTRUCTION block. These now have new fields to better account for [`ControlledGate`](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate") objects in a circuit. In addition, new payload MAP\_ITEM is defined to implement the [MAPPING](#qpy-mapping) block.
+
+With the support of `ScheduleBlock`, now [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") can be serialized together with [`calibrations`](qiskit.circuit.QuantumCircuit#calibrations "qiskit.circuit.QuantumCircuit.calibrations"), or [Pulse Gates](https://docs.quantum-computing.ibm.com/build/pulse). In QPY version 5 and above, [CIRCUIT\_CALIBRATIONS](#qpy-circuit-calibrations) payload is packed after the [INSTRUCTIONS](#qpy-instructions) block.
+
+In QPY version 5 and above,
+
+```python
+struct {
+ char type;
+}
+```
+
+immediately follows the file header block to represent the program type stored in the file.
+
+* When `type==c`, [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") payload follows
+* When `type==s`, [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") payload follows
+
+
+ Different programs cannot be packed together in the same file. You must create different files for different program types. Multiple objects with the same type can be saved in a single file.
+
+
+
+
+
+
+#### SCHEDULE\_BLOCK
+
+[`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") is first supported in QPY Version 5. This allows users to save pulse programs in the QPY binary format as follows:
+
+```python
+from qiskit import pulse, qpy
+
+with pulse.build() as schedule:
+ pulse.play(pulse.Gaussian(160, 0.1, 40), pulse.DriveChannel(0))
+
+with open('schedule.qpy', 'wb') as fd:
+ qpy.dump(qc, fd)
+
+with open('schedule.qpy', 'rb') as fd:
+ new_qc = qpy.load(fd)[0]
+```
+
+Note that circuit and schedule block are serialized and deserialized through the same QPY interface. Input data type is implicitly analyzed and no extra option is required to save the schedule block.
+
+
+
+
+
+#### SCHEDULE\_BLOCK\_HEADER
+
+[`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") block starts with the following header:
+
+```python
+struct {
+ uint16_t name_size;
+ uint64_t metadata_size;
+ uint16_t num_element;
+}
+```
+
+which is immediately followed by `name_size` utf8 bytes of schedule name and `metadata_size` utf8 bytes of the JSON serialized metadata dictionary attached to the schedule.
+
+
+
+
+
+#### SCHEDULE\_BLOCK\_ALIGNMENTS
+
+Then, alignment context of the schedule block starts with `char` representing the supported context type followed by the [SEQUENCE](#qpy-sequence) block representing the parameters associated with the alignment context `AlignmentKind._context_params`. The context type char is mapped to each alignment subclass as follows:
+
+* `l`: [`AlignLeft`](qiskit.pulse.transforms.AlignLeft "qiskit.pulse.transforms.AlignLeft")
+* `r`: [`AlignRight`](qiskit.pulse.transforms.AlignRight "qiskit.pulse.transforms.AlignRight")
+* `s`: [`AlignSequential`](qiskit.pulse.transforms.AlignSequential "qiskit.pulse.transforms.AlignSequential")
+* `e`: [`AlignEquispaced`](qiskit.pulse.transforms.AlignEquispaced "qiskit.pulse.transforms.AlignEquispaced")
+
+Note that [`AlignFunc`](qiskit.pulse.transforms.AlignFunc "qiskit.pulse.transforms.AlignFunc") context is not supported because of the callback function stored in the context parameters.
+
+
+
+
+
+#### SCHEDULE\_BLOCK\_INSTRUCTIONS
+
+This alignment block is further followed by `num_element` length of block elements which may consist of nested schedule blocks and schedule instructions. Each schedule instruction starts with `char` representing the instruction type followed by the [SEQUENCE](#qpy-sequence) block representing the instruction `operands`. Note that the data structure of pulse [`Instruction`](pulse#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.Instruction") is unified so that instance can be uniquely determined by the class and a tuple of operands. The mapping of type char to the instruction subclass is defined as follows:
+
+* `a`: [`Acquire`](qiskit.pulse.instructions.Acquire "qiskit.pulse.instructions.Acquire") instruction
+* `p`: [`Play`](qiskit.pulse.instructions.Play "qiskit.pulse.instructions.Play") instruction
+* `d`: [`Delay`](qiskit.pulse.instructions.Delay "qiskit.pulse.instructions.Delay") instruction
+* `f`: [`SetFrequency`](qiskit.pulse.instructions.SetFrequency "qiskit.pulse.instructions.SetFrequency") instruction
+* `g`: [`ShiftFrequency`](qiskit.pulse.instructions.ShiftFrequency "qiskit.pulse.instructions.ShiftFrequency") instruction
+* `q`: [`SetPhase`](qiskit.pulse.instructions.SetPhase "qiskit.pulse.instructions.SetPhase") instruction
+* `r`: [`ShiftPhase`](qiskit.pulse.instructions.ShiftPhase "qiskit.pulse.instructions.ShiftPhase") instruction
+* `b`: [`RelativeBarrier`](qiskit.pulse.instructions.RelativeBarrier "qiskit.pulse.instructions.RelativeBarrier") instruction
+* `t`: [`TimeBlockade`](qiskit.pulse.instructions.TimeBlockade "qiskit.pulse.instructions.TimeBlockade") instruction
+* `y`: [`Reference`](qiskit.pulse.instructions.Reference "qiskit.pulse.instructions.Reference") instruction (new in version 0.7)
+
+
+
+
+
+#### SCHEDULE\_BLOCK\_OPERANDS
+
+The operands of these instances can be serialized through the standard QPY value serialization mechanism, however there are special object types that only appear in the schedule operands. Since the operands are serialized as [SEQUENCE](#qpy-sequence), each element must be packed with the INSTRUCTION\_PARAM pack struct, where each payload starts with a header block consists of the char `type` and uint64\_t `size`. Special objects start with the following type key:
+
+* `c`: [`Channel`](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel")
+* `w`: [`Waveform`](qiskit.pulse.library.Waveform "qiskit.pulse.library.Waveform")
+* `s`: [`SymbolicPulse`](qiskit.pulse.library.SymbolicPulse "qiskit.pulse.library.SymbolicPulse")
+* `o`: string (operand string, new in version 0.7)
+
+
+
+#### CHANNEL
+
+Channel block starts with channel subtype `char` that maps an object data to [`Channel`](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel") subclass. Mapping is defined as follows:
+
+* `d`: [`DriveChannel`](qiskit.pulse.channels.DriveChannel "qiskit.pulse.channels.DriveChannel")
+* `c`: [`ControlChannel`](qiskit.pulse.channels.ControlChannel "qiskit.pulse.channels.ControlChannel")
+* `m`: [`MeasureChannel`](qiskit.pulse.channels.MeasureChannel "qiskit.pulse.channels.MeasureChannel")
+* `a`: [`AcquireChannel`](qiskit.pulse.channels.AcquireChannel "qiskit.pulse.channels.AcquireChannel")
+* `e`: [`MemorySlot`](qiskit.pulse.channels.MemorySlot "qiskit.pulse.channels.MemorySlot")
+* `r`: [`RegisterSlot`](qiskit.pulse.channels.RegisterSlot "qiskit.pulse.channels.RegisterSlot")
+
+The key is immediately followed by the channel index serialized as the INSTRUCTION\_PARAM.
+
+
+
+#### Waveform
+
+Waveform block starts with WAVEFORM header:
+
+```python
+struct {
+ double epsilon;
+ uint32_t data_size;
+ _bool amp_limited;
+}
+```
+
+which is followed by `data_size` bytes of complex `ndarray` binary generated by [numpy.save](https://numpy.org/doc/stable/reference/generated/numpy.save.html). This represents the complex IQ data points played on a quantum device. [`name`](qiskit.pulse.library.Waveform#name "qiskit.pulse.library.Waveform.name") is saved after the samples in the INSTRUCTION\_PARAM pack struct, which can be string or `None`.
+
+
+
+#### SymbolicPulse
+
+SymbolicPulse block starts with SYMBOLIC\_PULSE header:
+
+```python
+struct {
+ uint16_t type_size;
+ uint16_t envelope_size;
+ uint16_t constraints_size;
+ uint16_t valid_amp_conditions_size;
+ _bool amp_limited;
+}
+```
+
+which is followed by `type_size` utf8 bytes of [`SymbolicPulse.pulse_type`](qiskit.pulse.library.SymbolicPulse#pulse_type "qiskit.pulse.library.SymbolicPulse.pulse_type") string that represents a class of waveform, such as “Gaussian” or “GaussianSquare”. Then, `envelope_size`, `constraints_size`, `valid_amp_conditions_size` utf8 bytes of serialized symbolic expressions are generated for [`SymbolicPulse.envelope`](qiskit.pulse.library.SymbolicPulse#envelope "qiskit.pulse.library.SymbolicPulse.envelope"), [`SymbolicPulse.constraints`](qiskit.pulse.library.SymbolicPulse#constraints "qiskit.pulse.library.SymbolicPulse.constraints"), and [`SymbolicPulse.valid_amp_conditions`](qiskit.pulse.library.SymbolicPulse#valid_amp_conditions "qiskit.pulse.library.SymbolicPulse.valid_amp_conditions"), respectively. Since string representation of these expressions are usually lengthy, the expression binary is generated by the python [zlib](https://docs.python.org/3/library/zlib.html) module with data compression.
+
+To uniquely specify a pulse instance, we also need to store the associated parameters, which consist of `duration` and the rest of parameters as a dictionary. Dictionary parameters are first dumped in the [MAPPING](#qpy-mapping) form, and then `duration` is dumped with the INSTRUCTION\_PARAM pack struct. Lastly, [`name`](qiskit.pulse.library.SymbolicPulse#name "qiskit.pulse.library.SymbolicPulse.name") is saved also with the INSTRUCTION\_PARAM pack struct, which can be string or `None`.
+
+
+
+#### MAPPING
+
+The MAPPING is a representation for arbitrary mapping object. This is a fixed length [SEQUENCE](#qpy-sequence) of key-value pair represented by the MAP\_ITEM payload.
+
+A MAP\_ITEM starts with a header defined as:
+
+```python
+struct {
+ uint16_t key_size;
+ char type;
+ uint16_t size;
+}
+```
+
+which is immediately followed by the `key_size` utf8 bytes representing the dictionary key in string and `size` utf8 bytes of arbitrary object data of QPY serializable `type`.
+
+
+
+
+
+#### CIRCUIT\_CALIBRATIONS
+
+The CIRCUIT\_CALIBRATIONS block is a dictionary to define pulse calibrations of the custom instruction set. This block starts with the following CALIBRATION header:
+
+```python
+struct {
+ uint16_t num_cals;
+}
+```
+
+which is followed by the `num_cals` length of calibration entries, each starts with the CALIBRATION\_DEF header:
+
+```python
+struct {
+ uint16_t name_size;
+ uint16_t num_qubits;
+ uint16_t num_params;
+ char type;
+}
+```
+
+The calibration definition header is then followed by `name_size` utf8 bytes of the gate name, `num_qubits` length of integers representing a sequence of qubits, and `num_params` length of INSTRUCTION\_PARAM payload for parameters associated to the custom instruction. The `type` indicates the class of pulse program which is either, in principle, [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") or [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule"). As of QPY Version 5, only [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") payload is supported. Finally, [SCHEDULE\_BLOCK](#qpy-schedule-block) payload is packed for each CALIBRATION\_DEF entry.
+
+
+
+#### INSTRUCTION
+
+The INSTRUCTION block was modified to add two new fields `num_ctrl_qubits` and `ctrl_state` which are used to model the [`ControlledGate.num_ctrl_qubits`](qiskit.circuit.ControlledGate#num_ctrl_qubits "qiskit.circuit.ControlledGate.num_ctrl_qubits") and [`ControlledGate.ctrl_state`](qiskit.circuit.ControlledGate#ctrl_state "qiskit.circuit.ControlledGate.ctrl_state") attributes. The new payload packed struct format is:
+
+```python
+struct {
+ uint16_t name_size;
+ uint16_t label_size;
+ uint16_t num_parameters;
+ uint32_t num_qargs;
+ uint32_t num_cargs;
+ _Bool has_conditional;
+ uint16_t conditional_reg_name_size;
+ int64_t conditional_value;
+ uint32_t num_ctrl_qubits;
+ uint32_t ctrl_state;
+}
+```
+
+The rest of the instruction payload is the same. You can refer to [INSTRUCTIONS](#qpy-instructions) for the details of the full payload.
+
+
+
+#### CUSTOM\_INSTRUCTION
+
+The CUSTOM\_INSTRUCTION block in QPY version 5 adds a new field `base_gate_size` which is used to define the size of the [`qiskit.circuit.Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") object stored in the `ControlledGate.base_gate` attribute for a custom [`ControlledGate`](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate") object. With this change the CUSTOM\_INSTRUCTION metadata block becomes:
+
+```python
+struct {
+ uint16_t name_size;
+ char type;
+ uint32_t num_qubits;
+ uint32_t num_clbits;
+ _Bool custom_definition;
+ uint64_t size;
+ uint32_t num_ctrl_qubits;
+ uint32_t ctrl_state;
+ uint64_t base_gate_size
+}
+```
+
+Immediately following the CUSTOM\_INSTRUCTION struct is the utf8 encoded name of size `name_size`.
+
+If `custom_definition` is `True` that means that the immediately following `size` bytes contains a QPY circuit data which can be used for the custom definition of that gate. If `custom_definition` is `False` then the instruction can be considered opaque (ie no definition). The `type` field determines what type of object will get created with the custom definition. If it’s `'g'` it will be a [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate") object, `'i'` it will be a [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") object.
+
+Following this the next `base_gate_size` bytes contain the `INSTRUCTION` payload for the `ControlledGate.base_gate`.
+
+Additionally an addition value for `type` is added `'c'` which is used to indicate the custom instruction is a custom [`ControlledGate`](qiskit.circuit.ControlledGate "qiskit.circuit.ControlledGate").
+
+
+
+### Version 4
+
+Version 4 is identical to [Version 3](#qpy-version-3) except that it adds 2 new type strings to the INSTRUCTION\_PARAM struct, `z` to represent `None` (which is encoded as no data), `q` to represent a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") (which is encoded as a QPY circuit), `r` to represent a `range` of integers (which is encoded as a [RANGE](#qpy-range-pack)), and `t` to represent a `sequence` (which is encoded as defined by [SEQUENCE](#qpy-sequence)). Additionally, version 4 changes the type of register index mapping array from `uint32_t` to `int64_t`. If the values of any of the array elements are negative they represent a register bit that is not present in the circuit.
+
+The [REGISTERS](#qpy-registers) header format has also been updated to
+
+```python
+struct {
+ char type;
+ _Bool standalone;
+ uint32_t size;
+ uint16_t name_size;
+ _bool in_circuit;
+}
+```
+
+which just adds the `in_circuit` field which represents whether the register is part of the circuit or not.
+
+
+
+#### RANGE
+
+A RANGE is a representation of a `range` object. It is defined as:
+
+```python
+struct {
+ int64_t start;
+ int64_t stop;
+ int64_t step;
+}
+```
+
+
+
+#### SEQUENCE
+
+A SEQUENCE is a representation of an arbitrary sequence object. As sequence are just fixed length containers of arbitrary python objects their QPY can’t fully represent any sequence, but as long as the contents in a sequence are other QPY serializable types for the INSTRUCTION\_PARAM payload the `sequence` object can be serialized.
+
+A sequence instruction parameter starts with a header defined as:
+
+```python
+struct {
+ uint64_t size;
+}
+```
+
+followed by `size` elements that are INSTRUCTION\_PARAM payloads, where each of these define an element in the sequence. The sequence object will be typecasted into proper type, e.g. `tuple`, afterwards.
+
+
+
+### Version 3
+
+Version 3 of the QPY format is identical to [Version 2](#qpy-version-2) except that it defines a struct format to represent a [`PauliEvolutionGate`](qiskit.circuit.library.PauliEvolutionGate "qiskit.circuit.library.PauliEvolutionGate") natively in QPY. To accomplish this the [CUSTOM\_DEFINITIONS](#qpy-custom-definition) struct now supports a new type value `'p'` to represent a [`PauliEvolutionGate`](qiskit.circuit.library.PauliEvolutionGate "qiskit.circuit.library.PauliEvolutionGate"). Enties in the custom instructions tables have unique name generated that start with the string `"###PauliEvolutionGate_"` followed by a uuid string. This gate name is reservered in QPY and if you have a custom [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") object with a definition set and that name prefix it will error. If it’s of type `'p'` the data payload is defined as follows:
+
+
+
+
+
+#### PAULI\_EVOLUTION
+
+This represents the high level [`PauliEvolutionGate`](qiskit.circuit.library.PauliEvolutionGate "qiskit.circuit.library.PauliEvolutionGate")
+
+```python
+struct {
+ uint64_t operator_count;
+ _Bool standalone_op;
+ char time_type;
+ uint64_t time_size;
+ uint64_t synthesis_size;
+}
+```
+
+This is immediately followed by `operator_count` elements defined by the [SPARSE\_PAULI\_OP\_LIST\_ELEM](#qpy-pauli-sum-op) payload. Following that we have `time_size` bytes representing the `time` attribute. If `standalone_op` is `True` then there must only be a single operator. The encoding of these bytes is determined by the value of `time_type`. Possible values of `time_type` are `'f'`, `'p'`, and `'e'`. If `time_type` is `'f'` it’s a double, `'p'` defines a [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") object which is represented by a [PARAMETER](#qpy-param-struct), `e` defines a [`ParameterExpression`](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression") object (that’s not a [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter")) which is represented by a [PARAMETER\_EXPR](#qpy-param-expr). Following that is `synthesis_size` bytes which is a utf8 encoded json payload representing the [`EvolutionSynthesis`](qiskit.synthesis.EvolutionSynthesis "qiskit.synthesis.EvolutionSynthesis") class used by the gate.
+
+
+
+
+
+#### SPARSE\_PAULI\_OP\_LIST\_ELEM
+
+This represents an instance of [`PauliSumOp`](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp").
+
+```python
+struct {
+ uint32_t pauli_op_size;
+}
+```
+
+which is immediately followed by `pauli_op_size` bytes which are .npy format [\[2\]](#f2) data which represents the [`SparsePauliOp`](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp").
+
+Version 3 of the QPY format also defines a struct format to represent a `ParameterVectorElement` as a distinct subclass from a [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter"). This adds a new parameter type char `'v'` to represent a `ParameterVectorElement` which is now supported as a type string value for an INSTRUCTION\_PARAM. The payload for these parameters are defined below as [PARAMETER\_VECTOR\_ELEMENT](#qpy-param-vector).
+
+
+
+
+
+#### PARAMETER\_VECTOR\_ELEMENT
+
+A PARAMETER\_VECTOR\_ELEMENT represents a `ParameterVectorElement` object the data for a INSTRUCTION\_PARAM. The contents of the PARAMETER\_VECTOR\_ELEMENT are defined as:
+
+```python
+struct {
+ uint16_t vector_name_size;
+ uint64_t vector_size;
+ char uuid[16];
+ uint64_t index;
+}
+```
+
+which is immediately followed by `vector_name_size` utf8 bytes representing the parameter’s vector name.
+
+
+
+
+
+#### PARAMETER\_EXPR
+
+Additionally, since QPY format version v3 distinguishes between a [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") and `ParameterVectorElement` the payload for a [`ParameterExpression`](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression") needs to be updated to distinguish between the types. The following is the modified payload format which is mostly identical to the format in Version 1 and [Version 2](#qpy-version-2) but just modifies the `map_elements` struct to include a symbol type field.
+
+A PARAMETER\_EXPR represents a [`ParameterExpression`](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression") object that the data for an INSTRUCTION\_PARAM. The contents of a PARAMETER\_EXPR are defined as:
+
+```python
+struct {
+ uint64_t map_elements;
+ uint64_t expr_size;
+}
+```
+
+Immediately following the header is `expr_size` bytes of utf8 data containing the expression string, which is the sympy srepr of the expression for the parameter expression. Following that is a symbol map which contains `map_elements` elements with the format
+
+```python
+struct {
+ char symbol_type;
+ char type;
+ uint64_t size;
+}
+```
+
+The `symbol_type` key determines the payload type of the symbol representation for the element. If it’s `p` it represents a [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") and if it’s `v` it represents a `ParameterVectorElement`. The map element struct is immediately followed by the symbol map key payload, if `symbol_type` is `p` then it is followed immediately by a [PARAMETER](#qpy-param-struct) object (both the struct and utf8 name bytes) and if `symbol_type` is `v` then the struct is imediately followed by [PARAMETER\_VECTOR\_ELEMENT](#qpy-param-vector) (both the struct and utf8 name bytes). That is followed by `size` bytes for the data of the symbol. The data format is dependent on the value of `type`. If `type` is `p` then it represents a [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") and size will be 0, the value will just be the same as the key. Similarly if the `type` is `v` then it represents a `ParameterVectorElement` and size will be 0 as the value will just be the same as the key. If `type` is `f` then it represents a double precision float. If `type` is `c` it represents a double precision complex, which is represented by the [COMPLEX](#qpy-complex). Finally, if type is `i` it represents an integer which is an `int64_t`.
+
+
+
+### Version 2
+
+Version 2 of the QPY format is identical to version 1 except for the HEADER section is slightly different. You can refer to the [Version 1](#qpy-version-1) section for the details on the rest of the payload format.
+
+#### HEADER
+
+The contents of HEADER are defined as a C struct are:
+
+```python
+struct {
+ uint16_t name_size;
+ char global_phase_type;
+ uint16_t global_phase_size;
+ uint32_t num_qubits;
+ uint32_t num_clbits;
+ uint64_t metadata_size;
+ uint32_t num_registers;
+ uint64_t num_instructions;
+ uint64_t num_custom_gates;
+}
+```
+
+This is immediately followed by `name_size` bytes of utf8 data for the name of the circuit. Following this is immediately `global_phase_size` bytes representing the global phase. The content of that data is dictated by the value of `global_phase_type`. If it’s `'f'` the data is a float and is the size of a `double`. If it’s `'p'` defines a [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") object which is represented by a PARAM struct (see below), `e` defines a [`ParameterExpression`](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression") object (that’s not a [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter")) which is represented by a PARAM\_EXPR struct (see below).
+
+
+
+### Version 1
+
+
+
+#### HEADER
+
+The contents of HEADER as defined as a C struct are:
+
+```python
+struct {
+ uint16_t name_size;
+ double global_phase;
+ uint32_t num_qubits;
+ uint32_t num_clbits;
+ uint64_t metadata_size;
+ uint32_t num_registers;
+ uint64_t num_instructions;
+ uint64_t num_custom_gates;
+}
+```
+
+This is immediately followed by `name_size` bytes of utf8 data for the name of the circuit.
+
+#### METADATA
+
+The METADATA field is a UTF8 encoded JSON string. After reading the HEADER (which is a fixed size at the start of the QPY file) and the `name` string you then read the `metadata_size` number of bytes and parse the JSON to get the metadata for the circuit.
+
+
+
+#### REGISTERS
+
+The contents of REGISTERS is a number of REGISTER object. If num\_registers is > 0 then after reading METADATA you read that number of REGISTER structs defined as:
+
+```python
+struct {
+ char type;
+ _Bool standalone;
+ uint32_t size;
+ uint16_t name_size;
+}
+```
+
+`type` can be `'q'` or `'c'`.
+
+Immediately following the REGISTER struct is the utf8 encoded register name of size `name_size`. After the `name` utf8 bytes there is then an array of int64\_t values of size `size` that contains a map of the register’s index to the circuit’s qubit index. For example, array element 0’s value is the index of the `register[0]`’s position in the containing circuit’s qubits list.
+
+
+ Prior to QPY [Version 4](#qpy-version-4) the type of array elements was uint32\_t. This was changed to enable negative values which represent bits in the array not present in the circuit
+
+
+The standalone boolean determines whether the register is constructed as a standalone register that was added to the circuit or was created from existing bits. A register is considered standalone if it has bits constructed solely as part of it, for example:
+
+```python
+qr = QuantumRegister(2)
+qc = QuantumCircuit(qr)
+```
+
+the register `qr` would be a standalone register. While something like:
+
+```python
+bits = [Qubit(), Qubit()]
+qr2 = QuantumRegister(bits=bits)
+qc = QuantumCircuit(qr2)
+```
+
+`qr2` would have `standalone` set to `False`.
+
+
+
+
+
+#### CUSTOM\_DEFINITIONS
+
+This section specifies custom definitions for any of the instructions in the circuit.
+
+CUSTOM\_DEFINITION\_HEADER contents are defined as:
+
+```python
+struct {
+ uint64_t size;
+}
+```
+
+If size is greater than 0 that means the circuit contains custom instruction(s). Each custom instruction is defined with a CUSTOM\_INSTRUCTION block defined as:
+
+```python
+struct {
+ uint16_t name_size;
+ char type;
+ uint32_t num_qubits;
+ uint32_t num_clbits;
+ _Bool custom_definition;
+ uint64_t size;
+}
+```
+
+Immediately following the CUSTOM\_INSTRUCTION struct is the utf8 encoded name of size `name_size`.
+
+If `custom_definition` is `True` that means that the immediately following `size` bytes contains a QPY circuit data which can be used for the custom definition of that gate. If `custom_definition` is `False` then the instruction can be considered opaque (ie no definition). The `type` field determines what type of object will get created with the custom definition. If it’s `'g'` it will be a [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate") object, `'i'` it will be a [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") object.
+
+
+
+#### INSTRUCTIONS
+
+The contents of INSTRUCTIONS is a list of INSTRUCTION metadata objects
+
+```python
+struct {
+ uint16_t name_size;
+ uint16_t label_size;
+ uint16_t num_parameters;
+ uint32_t num_qargs;
+ uint32_t num_cargs;
+ _Bool has_conditional;
+ uint16_t conditional_reg_name_size;
+ int64_t conditional_value;
+}
+```
+
+This metadata object is immediately followed by `name_size` bytes of utf8 bytes for the `name`. `name` here is the Qiskit class name for the Instruction class if it’s defined in Qiskit. Otherwise it falls back to the custom instruction name. Following the `name` bytes there are `label_size` bytes of utf8 data for the label if one was set on the instruction. Following the label bytes if `has_conditional` is `True` then there are `conditional_reg_name_size` bytes of utf8 data for the name of the conditional register name. In case of single classical bit conditions the register name utf8 data will be prefixed with a null character “x00” and then a utf8 string integer representing the classical bit index in the circuit that the condition is on.
+
+This is immediately followed by the INSTRUCTION\_ARG structs for the list of arguments of that instruction. These are in the order of all quantum arguments (there are num\_qargs of these) followed by all classical arguments (num\_cargs of these).
+
+The contents of each INSTRUCTION\_ARG is:
+
+```python
+struct {
+ char type;
+ uint32_t index;
+}
+```
+
+`type` can be `'q'` or `'c'`.
+
+After all arguments for an instruction the parameters are specified with `num_parameters` INSTRUCTION\_PARAM structs.
+
+The contents of each INSTRUCTION\_PARAM is:
+
+```python
+struct {
+ char type;
+ uint64_t size;
+}
+```
+
+After each INSTRUCTION\_PARAM the next `size` bytes are the parameter’s data. The `type` field can be `'i'`, `'f'`, `'p'`, `'e'`, `'s'`, `'c'` or `'n'` which dictate the format. For `'i'` it’s an integer, `'f'` it’s a double, `'s'` if it’s a string (encoded as utf8), `'c'` is a complex and the data is represented by the struct format in the [PARAMETER\_EXPR](#qpy-param-expr) section. `'p'` defines a [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") object which is represented by a [PARAMETER](#qpy-param-struct) struct, `e` defines a [`ParameterExpression`](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression") object (that’s not a [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter")) which is represented by a [PARAMETER\_EXPR](#qpy-param-expr) struct (on QPY format [Version 3](#qpy-version-3) the format is tweak slightly see: [PARAMETER\_EXPR](#qpy-param-expr-v3)), `'n'` represents an object from numpy (either an `ndarray` or a numpy type) which means the data is .npy format [\[2\]](#f2) data, and in QPY [Version 3](#qpy-version-3) `'v'` represents a `ParameterVectorElement` which is represented by a [PARAMETER\_VECTOR\_ELEMENT](#qpy-param-vector) struct.
+
+
+
+#### PARAMETER
+
+A PARAMETER represents a [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") object the data for a INSTRUCTION\_PARAM. The contents of the PARAMETER are defined as:
+
+```python
+struct {
+ uint16_t name_size;
+ char uuid[16];
+}
+```
+
+which is immediately followed by `name_size` utf8 bytes representing the parameter name.
+
+
+
+
+
+#### PARAMETER\_EXPR
+
+A PARAMETER\_EXPR represents a [`ParameterExpression`](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression") object that the data for an INSTRUCTION\_PARAM. The contents of a PARAMETER\_EXPR are defined as:
+
+The PARAMETER\_EXPR data starts with a header:
+
+```python
+struct {
+ uint64_t map_elements;
+ uint64_t expr_size;
+}
+```
+
+Immediately following the header is `expr_size` bytes of utf8 data containing the expression string, which is the sympy srepr of the expression for the parameter expression. Follwing that is a symbol map which contains `map_elements` elements with the format
+
+```python
+struct {
+ char type;
+ uint64_t size;
+}
+```
+
+Which is followed immediately by `PARAMETER` object (both the struct and utf8 name bytes) for the symbol map key. That is followed by `size` bytes for the data of the symbol. The data format is dependent on the value of `type`. If `type` is `p` then it represents a [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter") and size will be 0, the value will just be the same as the key. If `type` is `f` then it represents a double precision float. If `type` is `c` it represents a double precision complex, which is represented by [COMPLEX](#qpy-complex). Finally, if type is `i` it represents an integer which is an `int64_t`.
+
+
+
+#### COMPLEX
+
+When representing a double precision complex value in QPY the following struct is used:
+
+```python
+struct {
+ double real;
+ double imag;
+}
+```
+
+this matches the internal C representation of Python’s complex type. [\[3\]](#f3)
+
+\[[1](#id2)]
+
+[https://tools.ietf.org/html/rfc1700](https://tools.ietf.org/html/rfc1700)
+
+\[2] ([1](#id4),[2](#id6))
+
+[https://numpy.org/doc/stable/reference/generated/numpy.lib.format.html](https://numpy.org/doc/stable/reference/generated/numpy.lib.format.html)
+
+\[[3](#id8)]
+
+[https://docs.python.org/3/c-api/complex.html#c.Py\_complex](https://docs.python.org/3/c-api/complex.html#c.Py_complex)
+
diff --git a/docs/api/qiskit/0.46/quantum_info.md b/docs/api/qiskit/0.46/quantum_info.md
new file mode 100644
index 00000000000..c7f298768fa
--- /dev/null
+++ b/docs/api/qiskit/0.46/quantum_info.md
@@ -0,0 +1,944 @@
+---
+title: quantum_info
+description: API reference for qiskit.quantum_info
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.quantum_info
+---
+
+
+
+
+
+
+
+# Quantum Information
+
+
+
+`qiskit.quantum_info`
+
+
+
+## Operators
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
+| [`Operator`](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")(data\[, input\_dims, output\_dims]) | Matrix operator class |
+| [`Pauli`](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli")(\[data]) | N-qubit Pauli operator. |
+| [`Clifford`](qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")(data\[, validate, copy]) | An N-qubit unitary operator from the Clifford group. |
+| [`ScalarOp`](qiskit.quantum_info.ScalarOp "qiskit.quantum_info.ScalarOp")(\[dims, coeff]) | Scalar identity operator class. |
+| [`SparsePauliOp`](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp")(data\[, coeffs, ...]) | Sparse N-qubit operator in a Pauli basis representation. |
+| [`CNOTDihedral`](qiskit.quantum_info.CNOTDihedral "qiskit.quantum_info.CNOTDihedral")(\[data, num\_qubits, validate]) | An N-qubit operator from the CNOT-Dihedral group. |
+| [`PauliList`](qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")(data) | List of N-qubit Pauli operators. |
+| [`pauli_basis`](qiskit.quantum_info.pauli_basis "qiskit.quantum_info.pauli_basis")(num\_qubits\[, weight]) | Return the ordered PauliList for the n-qubit Pauli basis. |
+
+
+
+## States
+
+| | |
+| ----------------------------------------------------------------------------------------------------------------- | ---------------------- |
+| [`Statevector`](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector")(data\[, dims]) | Statevector class |
+| [`DensityMatrix`](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")(data\[, dims]) | DensityMatrix class |
+| [`StabilizerState`](qiskit.quantum_info.StabilizerState "qiskit.quantum_info.StabilizerState")(data\[, validate]) | StabilizerState class. |
+
+## Channels
+
+| | |
+| ---------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
+| [`Choi`](qiskit.quantum_info.Choi "qiskit.quantum_info.Choi")(data\[, input\_dims, output\_dims]) | Choi-matrix representation of a Quantum Channel. |
+| [`SuperOp`](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp")(data\[, input\_dims, output\_dims]) | Superoperator representation of a quantum channel. |
+| [`Kraus`](qiskit.quantum_info.Kraus "qiskit.quantum_info.Kraus")(data\[, input\_dims, output\_dims]) | Kraus representation of a quantum channel. |
+| [`Stinespring`](qiskit.quantum_info.Stinespring "qiskit.quantum_info.Stinespring")(data\[, input\_dims, output\_dims]) | Stinespring representation of a quantum channel. |
+| [`Chi`](qiskit.quantum_info.Chi "qiskit.quantum_info.Chi")(data\[, input\_dims, output\_dims]) | Pauli basis Chi-matrix representation of a quantum channel. |
+| [`PTM`](qiskit.quantum_info.PTM "qiskit.quantum_info.PTM")(data\[, input\_dims, output\_dims]) | Pauli Transfer Matrix (PTM) representation of a Quantum Channel. |
+
+## Measures
+
+### average\_gate\_fidelity
+
+
+
+`qiskit.quantum_info.average_gate_fidelity(channel, target=None, require_cp=True, require_tp=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/measures.py "view source code")
+
+Return the average gate fidelity of a noisy quantum channel.
+
+The average gate fidelity $F_{\text{ave}}$ is given by
+
+$$
+\begin{aligned}
+F_{\text{ave}}(\mathcal{E}, U)
+ &= \int d\psi \langle\psi|U^\dagger
+ \mathcal{E}(|\psi\rangle\!\langle\psi|)U|\psi\rangle \\
+ &= \frac{d F_{\text{pro}}(\mathcal{E}, U) + 1}{d + 1}
+\end{aligned}
+
+
+$$
+
+where $F_{\text{pro}}(\mathcal{E}, U)$ is the [`process_fidelity()`](#qiskit.quantum_info.process_fidelity "qiskit.quantum_info.process_fidelity") of the input quantum *channel* $\mathcal{E}$ with a *target* unitary $U$, and $d$ is the dimension of the *channel*.
+
+**Parameters**
+
+* **channel** (*QuantumChannel or* [*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – noisy quantum channel.
+* **target** ([*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator") *or None*) – target unitary operator. If None target is the identity operator \[Default: None].
+* **require\_cp** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – check if input and target channels are completely-positive and if non-CP log warning containing negative eigenvalues of Choi-matrix \[Default: True].
+* **require\_tp** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – check if input and target channels are trace-preserving and if non-TP log warning containing negative eigenvalues of partial Choi-matrix $Tr_{\text{out}}[\mathcal{E}] - I$ \[Default: True].
+
+**Returns**
+
+The average gate fidelity $F_{\text{ave}}$.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the channel and target do not have the same dimensions, or have different input and output dimensions.
+
+### process\_fidelity
+
+
+
+`qiskit.quantum_info.process_fidelity(channel, target=None, require_cp=True, require_tp=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/measures.py "view source code")
+
+Return the process fidelity of a noisy quantum channel.
+
+The process fidelity $F_{\text{pro}}(\mathcal{E}, \mathcal{F})$ between two quantum channels $\mathcal{E}, \mathcal{F}$ is given by
+
+$$
+F_{\text{pro}}(\mathcal{E}, \mathcal{F})
+ = F(\rho_{\mathcal{E}}, \rho_{\mathcal{F}})
+
+
+$$
+
+where $F$ is the [`state_fidelity()`](#qiskit.quantum_info.state_fidelity "qiskit.quantum_info.state_fidelity"), $\rho_{\mathcal{E}} = \Lambda_{\mathcal{E}} / d$ is the normalized [`Choi`](qiskit.quantum_info.Choi "qiskit.quantum_info.Choi") matrix for the channel $\mathcal{E}$, and $d$ is the input dimension of $\mathcal{E}$.
+
+When the target channel is unitary this is equivalent to
+
+$$
+F_{\text{pro}}(\mathcal{E}, U)
+ = \frac{Tr[S_U^\dagger S_{\mathcal{E}}]}{d^2}
+
+
+$$
+
+where $S_{\mathcal{E}}, S_{U}$ are the [`SuperOp`](qiskit.quantum_info.SuperOp "qiskit.quantum_info.SuperOp") matrices for the *input* quantum channel $\mathcal{E}$ and *target* unitary $U$ respectively, and $d$ is the input dimension of the channel.
+
+**Parameters**
+
+* **channel** ([*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator") *or QuantumChannel*) – input quantum channel.
+* **target** ([*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator") *or QuantumChannel or None*) – target quantum channel. If None target is the identity operator \[Default: None].
+* **require\_cp** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – check if input and target channels are completely-positive and if non-CP log warning containing negative eigenvalues of Choi-matrix \[Default: True].
+* **require\_tp** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – check if input and target channels are trace-preserving and if non-TP log warning containing negative eigenvalues of partial Choi-matrix $Tr_{\text{out}}[\mathcal{E}] - I$ \[Default: True].
+
+**Returns**
+
+The process fidelity $F_{\text{pro}}$.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the channel and target do not have the same dimensions.
+
+### gate\_error
+
+
+
+`qiskit.quantum_info.gate_error(channel, target=None, require_cp=True, require_tp=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/measures.py "view source code")
+
+Return the gate error of a noisy quantum channel.
+
+The gate error $E$ is given by the average gate infidelity
+
+$$
+E(\mathcal{E}, U) = 1 - F_{\text{ave}}(\mathcal{E}, U)
+
+
+$$
+
+where $F_{\text{ave}}(\mathcal{E}, U)$ is the [`average_gate_fidelity()`](#qiskit.quantum_info.average_gate_fidelity "qiskit.quantum_info.average_gate_fidelity") of the input quantum *channel* $\mathcal{E}$ with a *target* unitary $U$.
+
+**Parameters**
+
+* **channel** (*QuantumChannel*) – noisy quantum channel.
+* **target** ([*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator") *or None*) – target unitary operator. If None target is the identity operator \[Default: None].
+* **require\_cp** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – check if input and target channels are completely-positive and if non-CP log warning containing negative eigenvalues of Choi-matrix \[Default: True].
+* **require\_tp** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – check if input and target channels are trace-preserving and if non-TP log warning containing negative eigenvalues of partial Choi-matrix $Tr_{\text{out}}[\mathcal{E}] - I$ \[Default: True].
+
+**Returns**
+
+The average gate error $E$.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the channel and target do not have the same dimensions, or have different input and output dimensions.
+
+### diamond\_norm
+
+
+
+`qiskit.quantum_info.diamond_norm(choi, solver='SCS', **kwargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/measures.py "view source code")
+
+Return the diamond norm of the input quantum channel object.
+
+This function computes the completely-bounded trace-norm (often referred to as the diamond-norm) of the input quantum channel object using the semidefinite-program from reference \[1].
+
+**Parameters**
+
+* **choi** ([*Choi*](qiskit.quantum_info.Choi "qiskit.quantum_info.Choi") *or QuantumChannel*) – a quantum channel object or Choi-matrix array.
+* **solver** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The solver to use.
+* **kwargs** – optional arguments to pass to CVXPY solver.
+
+**Returns**
+
+The completely-bounded trace norm $\|\mathcal{E}\|_{\diamond}$.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if CVXPY package cannot be found.
+
+**Additional Information:**
+
+The input to this function is typically *not* a CPTP quantum channel, but rather the *difference* between two quantum channels $\|\Delta\mathcal{E}\|_\diamond$ where $\Delta\mathcal{E} = \mathcal{E}_1 - \mathcal{E}_2$.
+
+**Reference:**
+
+J. Watrous. “Simpler semidefinite programs for completely bounded norms”, arXiv:1207.5726 \[quant-ph] (2012).
+
+
+ This function requires the optional CVXPY package to be installed. Any additional kwargs will be passed to the `cvxpy.solve` function. See the CVXPY documentation for information on available SDP solvers.
+
+
+### state\_fidelity
+
+
+
+`qiskit.quantum_info.state_fidelity(state1, state2, validate=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/states/measures.py "view source code")
+
+Return the state fidelity between two quantum states.
+
+The state fidelity $F$ for density matrix input states $\rho_1, \rho_2$ is given by
+
+$$
+F(\rho_1, \rho_2) = Tr[\sqrt{\sqrt{\rho_1}\rho_2\sqrt{\rho_1}}]^2.
+
+
+$$
+
+If one of the states is a pure state this simplifies to $F(\rho_1, \rho_2) = \langle\psi_1|\rho_2|\psi_1\rangle$, where $\rho_1 = |\psi_1\rangle\!\langle\psi_1|$.
+
+**Parameters**
+
+* **state1** ([*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") *or*[*DensityMatrix*](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")) – the first quantum state.
+* **state2** ([*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") *or*[*DensityMatrix*](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")) – the second quantum state.
+* **validate** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – check if the inputs are valid quantum states \[Default: True]
+
+**Returns**
+
+The state fidelity $F(\rho_1, \rho_2)$.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if `validate=True` and the inputs are invalid quantum states.
+
+### purity
+
+
+
+`qiskit.quantum_info.purity(state, validate=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/states/measures.py "view source code")
+
+Calculate the purity of a quantum state.
+
+The purity of a density matrix $\rho$ is
+
+$$
+\text{Purity}(\rho) = Tr[\rho^2]
+$$
+
+**Parameters**
+
+* **state** ([*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") *or*[*DensityMatrix*](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")) – a quantum state.
+* **validate** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – check if input state is valid \[Default: True]
+
+**Returns**
+
+the purity $Tr[\rho^2]$.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input isn’t a valid quantum state.
+
+### concurrence
+
+
+
+`qiskit.quantum_info.concurrence(state)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/states/measures.py "view source code")
+
+Calculate the concurrence of a quantum state.
+
+The concurrence of a bipartite [`Statevector`](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") $|\psi\rangle$ is given by
+
+$$
+C(|\psi\rangle) = \sqrt{2(1 - Tr[\rho_0^2])}
+$$
+
+where $\rho_0 = Tr_1[|\psi\rangle\!\langle\psi|]$ is the reduced state from by taking the [`partial_trace()`](#qiskit.quantum_info.partial_trace "qiskit.quantum_info.partial_trace") of the input state.
+
+For density matrices the concurrence is only defined for 2-qubit states, it is given by:
+
+$$
+C(\rho) = \max(0, \lambda_1 - \lambda_2 - \lambda_3 - \lambda_4)
+$$
+
+where $\lambda _1 \ge \lambda _2 \ge \lambda _3 \ge \lambda _4$ are the ordered eigenvalues of the matrix $R=\sqrt{\sqrt{\rho }(Y\otimes Y)\overline{\rho}(Y\otimes Y)\sqrt{\rho}}$.
+
+**Parameters**
+
+**state** ([*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") *or*[*DensityMatrix*](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")) – a 2-qubit quantum state.
+
+**Returns**
+
+The concurrence.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+**Raises**
+
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input state is not a valid QuantumState.
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if input is not a bipartite QuantumState.
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if density matrix input is not a 2-qubit state.
+
+### entropy
+
+
+
+`qiskit.quantum_info.entropy(state, base=2)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/states/measures.py "view source code")
+
+Calculate the von-Neumann entropy of a quantum state.
+
+The entropy $S$ is given by
+
+$$
+S(\rho) = - Tr[\rho \log(\rho)]
+$$
+
+**Parameters**
+
+* **state** ([*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") *or*[*DensityMatrix*](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")) – a quantum state.
+* **base** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the base of the logarithm \[Default: 2].
+
+**Returns**
+
+The von-Neumann entropy S(rho).
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input state is not a valid QuantumState.
+
+### entanglement\_of\_formation
+
+
+
+`qiskit.quantum_info.entanglement_of_formation(state)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/states/measures.py "view source code")
+
+Calculate the entanglement of formation of quantum state.
+
+The input quantum state must be either a bipartite state vector, or a 2-qubit density matrix.
+
+**Parameters**
+
+**state** ([*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") *or*[*DensityMatrix*](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")) – a 2-qubit quantum state.
+
+**Returns**
+
+The entanglement of formation.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+**Raises**
+
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input state is not a valid QuantumState.
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if input is not a bipartite QuantumState.
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if density matrix input is not a 2-qubit state.
+
+### mutual\_information
+
+
+
+`qiskit.quantum_info.mutual_information(state, base=2)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/states/measures.py "view source code")
+
+Calculate the mutual information of a bipartite state.
+
+The mutual information $I$ is given by:
+
+$$
+I(\rho_{AB}) = S(\rho_A) + S(\rho_B) - S(\rho_{AB})
+$$
+
+where $\rho_A=Tr_B[\rho_{AB}], \rho_B=Tr_A[\rho_{AB}]$, are the reduced density matrices of the bipartite state $\rho_{AB}$.
+
+**Parameters**
+
+* **state** ([*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") *or*[*DensityMatrix*](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")) – a bipartite state.
+* **base** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the base of the logarithm \[Default: 2].
+
+**Returns**
+
+The mutual information $I(\rho_{AB})$.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+**Raises**
+
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input state is not a valid QuantumState.
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if input is not a bipartite QuantumState.
+
+## Utility Functions
+
+| | |
+| ------------------------------------------------------------------------------------- | ---------------------------------- |
+| [`Quaternion`](qiskit.quantum_info.Quaternion "qiskit.quantum_info.Quaternion")(data) | A class representing a Quaternion. |
+
+### partial\_trace
+
+
+
+`qiskit.quantum_info.partial_trace(state, qargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/states/utils.py "view source code")
+
+Return reduced density matrix by tracing out part of quantum state.
+
+If all subsystems are traced over this returns the [`trace()`](qiskit.quantum_info.DensityMatrix#trace "qiskit.quantum_info.DensityMatrix.trace") of the input state.
+
+**Parameters**
+
+* **state** ([*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") *or*[*DensityMatrix*](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")) – the input state.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – The subsystems to trace over.
+
+**Returns**
+
+The reduced density matrix.
+
+**Return type**
+
+[DensityMatrix](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if input state is invalid.
+
+### schmidt\_decomposition
+
+
+
+`qiskit.quantum_info.schmidt_decomposition(state, qargs)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/states/utils.py "view source code")
+
+Return the Schmidt Decomposition of a pure quantum state.
+
+For an arbitrary bipartite state:
+
+$$
+|\psi\rangle_{AB} = \sum_{i,j} c_{ij}
+ |x_i\rangle_A \otimes |y_j\rangle_B,
+
+
+$$
+
+its Schmidt Decomposition is given by the single-index sum over k:
+
+$$
+|\psi\rangle_{AB} = \sum_{k} \lambda_{k}
+ |u_k\rangle_A \otimes |v_k\rangle_B
+
+
+$$
+
+where $|u_k\rangle_A$ and $|v_k\rangle_B$ are an orthonormal set of vectors in their respective spaces $A$ and $B$, and the Schmidt coefficients $\lambda_k$ are positive real values.
+
+**Parameters**
+
+* **state** ([*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") *or*[*DensityMatrix*](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")) – the input state.
+* **qargs** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – the list of Input state positions corresponding to subsystem $B$.
+
+**Returns**
+
+list of tuples `(s, u, v)`, where `s` (float) are the Schmidt coefficients $\lambda_k$, and `u` (Statevector), `v` (Statevector) are the Schmidt vectors $|u_k\rangle_A$, $|u_k\rangle_B$, respectively.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if Input qargs is not a list of positions of the Input state.
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if Input qargs is not a proper subset of Input state.
+
+
+ In Qiskit, qubits are ordered using little-endian notation, with the least significant qubits having smaller indices. For example, a four-qubit system is represented as $|q_3q_2q_1q_0\rangle$. Using this convention, setting `qargs=[0]` will partition the state as $|q_3q_2q_1\rangle_A\otimes|q_0\rangle_B$. Furthermore, qubits will be organized in this notation regardless of the order they are passed. For instance, passing either `qargs=[1,2]` or `qargs=[2,1]` will result in partitioning the state as $|q_3q_0\rangle_A\otimes|q_2q_1\rangle_B$.
+
+
+### shannon\_entropy
+
+
+
+`qiskit.quantum_info.shannon_entropy(pvec, base=2)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/states/utils.py "view source code")
+
+Compute the Shannon entropy of a probability vector.
+
+The shannon entropy of a probability vector $\vec{p} = [p_0, ..., p_{n-1}]$ is defined as
+
+$$
+H(\vec{p}) = \sum_{i=0}^{n-1} p_i \log_b(p_i)
+$$
+
+where $b$ is the log base and (default 2), and $0 \log_b(0) \equiv 0$.
+
+**Parameters**
+
+* **pvec** (*array\_like*) – a probability vector.
+* **base** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the base of the logarithm \[Default: 2].
+
+**Returns**
+
+The Shannon entropy H(pvec).
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+### commutator
+
+
+
+`qiskit.quantum_info.commutator(a, b)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/utils/commutator.py "view source code")
+
+Compute commutator of a and b.
+
+$$
+ab - ba.
+$$
+
+**Parameters**
+
+* **a** (*OperatorTypeT*) – Operator a.
+* **b** (*OperatorTypeT*) – Operator b.
+
+**Returns**
+
+The commutator
+
+**Return type**
+
+*OperatorTypeT*
+
+### anti\_commutator
+
+
+
+`qiskit.quantum_info.anti_commutator(a, b)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/utils/anti_commutator.py "view source code")
+
+Compute anti-commutator of a and b.
+
+$$
+ab + ba.
+$$
+
+**Parameters**
+
+* **a** (*OperatorTypeT*) – Operator a.
+* **b** (*OperatorTypeT*) – Operator b.
+
+**Returns**
+
+The anti-commutator
+
+**Return type**
+
+*OperatorTypeT*
+
+### double\_commutator
+
+
+
+`qiskit.quantum_info.double_commutator(a, b, c, *, commutator=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/utils/double_commutator.py "view source code")
+
+Compute symmetric double commutator of a, b and c.
+
+See also Equation (13.6.18) in \[1].
+
+If commutator is True, it returns
+
+$$
+[[A, B], C]/2 + [A, [B, C]]/2
+= (2ABC + 2CBA - BAC - CAB - ACB - BCA)/2.
+$$
+
+If commutator is False, it returns
+
+$$
+\lbrace[A, B], C\rbrace/2 + \lbrace A, [B, C]\rbrace/2
+= (2ABC - 2CBA - BAC + CAB - ACB + BCA)/2.
+
+
+$$
+
+**Parameters**
+
+* **a** (*OperatorTypeT*) – Operator a.
+* **b** (*OperatorTypeT*) – Operator b.
+* **c** (*OperatorTypeT*) – Operator c.
+* **commutator** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If `True` compute the double commutator, if `False` the double anti-commutator.
+
+**Returns**
+
+The double commutator
+
+**Return type**
+
+*OperatorTypeT*
+
+**References**
+
+**\[1]: R. McWeeny.**
+
+Methods of Molecular Quantum Mechanics. 2nd Edition, Academic Press, 1992. ISBN 0-12-486552-6.
+
+## Random
+
+### random\_statevector
+
+
+
+`qiskit.quantum_info.random_statevector(dims, seed=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/states/random.py "view source code")
+
+Generator a random Statevector.
+
+The statevector is sampled from the uniform distribution. This is the measure induced by the Haar measure on unitary matrices.
+
+**Parameters**
+
+* **dims** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the dimensions of the state.
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or np.random.Generator*) – Optional. Set a fixed seed or generator for RNG.
+
+**Returns**
+
+the random statevector.
+
+**Return type**
+
+[Statevector](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector")
+
+**Reference:**
+
+K. Zyczkowski and H. Sommers (2001), “Induced measures in the space of mixed quantum states”, [J. Phys. A: Math. Gen. 34 7111](https://arxiv.org/abs/quant-ph/0012101).
+
+### random\_density\_matrix
+
+
+
+`qiskit.quantum_info.random_density_matrix(dims, rank=None, method='Hilbert-Schmidt', seed=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/states/random.py "view source code")
+
+Generator a random DensityMatrix.
+
+**Parameters**
+
+* **dims** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the dimensions of the DensityMatrix.
+* **rank** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or None*) – Optional, the rank of the density matrix. The default value is full-rank.
+* **method** (*string*) – Optional. The method to use. ‘Hilbert-Schmidt’: (Default) sample from the Hilbert-Schmidt metric. ‘Bures’: sample from the Bures metric.
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or np.random.Generator*) – Optional. Set a fixed seed or generator for RNG.
+
+**Returns**
+
+the random density matrix.
+
+**Return type**
+
+[DensityMatrix](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the method is not valid.
+
+### random\_unitary
+
+
+
+`qiskit.quantum_info.random_unitary(dims, seed=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/random.py "view source code")
+
+Return a random unitary Operator.
+
+The operator is sampled from the unitary Haar measure.
+
+**Parameters**
+
+* **dims** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the input dimensions of the Operator.
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or np.random.Generator*) – Optional. Set a fixed seed or generator for RNG.
+
+**Returns**
+
+a unitary operator.
+
+**Return type**
+
+[Operator](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")
+
+### random\_hermitian
+
+
+
+`qiskit.quantum_info.random_hermitian(dims, traceless=False, seed=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/random.py "view source code")
+
+Return a random hermitian Operator.
+
+The operator is sampled from Gaussian Unitary Ensemble.
+
+**Parameters**
+
+* **dims** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the input dimension of the Operator.
+* **traceless** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Optional. If True subtract diagonal entries to return a traceless hermitian operator (Default: False).
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or np.random.Generator*) – Optional. Set a fixed seed or generator for RNG.
+
+**Returns**
+
+a Hermitian operator.
+
+**Return type**
+
+[Operator](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")
+
+### random\_pauli
+
+
+
+`qiskit.quantum_info.random_pauli(num_qubits, group_phase=False, seed=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/symplectic/random.py "view source code")
+
+Return a random Pauli.
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of qubits.
+* **group\_phase** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Optional. If True generate random phase. Otherwise the phase will be set so that the Pauli coefficient is +1 (default: False).
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or np.random.Generator*) – Optional. Set a fixed seed or generator for RNG.
+
+**Returns**
+
+a random Pauli
+
+**Return type**
+
+[Pauli](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli")
+
+### random\_clifford
+
+
+
+`qiskit.quantum_info.random_clifford(num_qubits, seed=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/symplectic/random.py "view source code")
+
+Return a random Clifford operator.
+
+The Clifford is sampled using the method of Reference \[1].
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of qubits for the Clifford
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or np.random.Generator*) – Optional. Set a fixed seed or generator for RNG.
+
+**Returns**
+
+a random Clifford operator.
+
+**Return type**
+
+[Clifford](qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")
+
+**Reference:**
+
+1. S. Bravyi and D. Maslov, *Hadamard-free circuits expose the structure of the Clifford group*. [arXiv:2003.09412 \[quant-ph\]](https://arxiv.org/abs/2003.09412)
+
+### random\_quantum\_channel
+
+
+
+`qiskit.quantum_info.random_quantum_channel(input_dims=None, output_dims=None, rank=None, seed=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/random.py "view source code")
+
+Return a random CPTP quantum channel.
+
+This constructs the Stinespring operator for the quantum channel by sampling a random isometry from the unitary Haar measure.
+
+**Parameters**
+
+* **input\_dims** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the input dimension of the channel.
+* **output\_dims** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")) – the input dimension of the channel.
+* **rank** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Optional. The rank of the quantum channel Choi-matrix.
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or np.random.Generator*) – Optional. Set a fixed seed or generator for RNG.
+
+**Returns**
+
+a quantum channel operator.
+
+**Return type**
+
+[Stinespring](qiskit.quantum_info.Stinespring "qiskit.quantum_info.Stinespring")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if rank or dimensions are invalid.
+
+### random\_cnotdihedral
+
+
+
+`qiskit.quantum_info.random_cnotdihedral(num_qubits, seed=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/dihedral/random.py "view source code")
+
+Return a random CNOTDihedral element.
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of qubits for the CNOTDihedral object.
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or RandomState*) – Optional. Set a fixed seed or generator for RNG.
+
+**Returns**
+
+a random CNOTDihedral element.
+
+**Return type**
+
+[CNOTDihedral](qiskit.quantum_info.CNOTDihedral "qiskit.quantum_info.CNOTDihedral")
+
+### random\_pauli\_list
+
+
+
+`qiskit.quantum_info.random_pauli_list(num_qubits, size=1, seed=None, phase=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/operators/symplectic/random.py "view source code")
+
+Return a random PauliList.
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the number of qubits.
+* **size** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Optional. The length of the Pauli list (Default: 1).
+* **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *or np.random.Generator*) – Optional. Set a fixed seed or generator for RNG.
+* **phase** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True the Pauli phases are randomized, otherwise the phases are fixed to 0. \[Default: True]
+
+**Returns**
+
+a random PauliList.
+
+**Return type**
+
+[PauliList](qiskit.quantum_info.PauliList "qiskit.quantum_info.PauliList")
+
+## Analysis
+
+### hellinger\_distance
+
+
+
+`qiskit.quantum_info.hellinger_distance(dist_p, dist_q)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/analysis/distance.py "view source code")
+
+Computes the Hellinger distance between two counts distributions.
+
+**Parameters**
+
+* **dist\_p** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – First dict of counts.
+* **dist\_q** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – Second dict of counts.
+
+**Returns**
+
+Distance
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+**References**
+
+[Hellinger Distance @ wikipedia](https://en.wikipedia.org/wiki/Hellinger_distance)
+
+### hellinger\_fidelity
+
+
+
+`qiskit.quantum_info.hellinger_fidelity(dist_p, dist_q)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/quantum_info/analysis/distance.py "view source code")
+
+Computes the Hellinger fidelity between two counts distributions.
+
+The fidelity is defined as $\left(1-H^{2}\right)^{2}$ where H is the Hellinger distance. This value is bounded in the range \[0, 1].
+
+This is equivalent to the standard classical fidelity $F(Q,P)=\left(\sum_{i}\sqrt{p_{i}q_{i}}\right)^{2}$ that in turn is equal to the quantum state fidelity for diagonal density matrices.
+
+**Parameters**
+
+* **dist\_p** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – First dict of counts.
+* **dist\_q** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – Second dict of counts.
+
+**Returns**
+
+Fidelity
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+**Example**
+
+```python
+from qiskit import QuantumCircuit
+from qiskit.quantum_info.analysis import hellinger_fidelity
+from qiskit.providers.basic_provider import BasicSimulator
+
+qc = QuantumCircuit(5, 5)
+qc.h(2)
+qc.cx(2, 1)
+qc.cx(2, 3)
+qc.cx(3, 4)
+qc.cx(1, 0)
+qc.measure(range(5), range(5))
+
+sim = BasicSimulator()
+res1 = sim.run(qc).result()
+res2 = sim.run(qc).result()
+
+hellinger_fidelity(res1.get_counts(), res2.get_counts())
+```
+
+**References**
+
+[Quantum Fidelity @ wikipedia](https://en.wikipedia.org/wiki/Fidelity_of_quantum_states) [Hellinger Distance @ wikipedia](https://en.wikipedia.org/wiki/Hellinger_distance)
+
+| | |
+| ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| [`Z2Symmetries`](qiskit.quantum_info.Z2Symmetries "qiskit.quantum_info.Z2Symmetries")(symmetries, sq\_paulis, sq\_list) | The \$Z\_2\$ symmetry converter identifies symmetries from the problem hamiltonian and uses them to provide a tapered - more efficient - representation of operators as Paulis for this problem. |
+
diff --git a/docs/api/qiskit/0.46/result.md b/docs/api/qiskit/0.46/result.md
new file mode 100644
index 00000000000..3d0e674bce6
--- /dev/null
+++ b/docs/api/qiskit/0.46/result.md
@@ -0,0 +1,160 @@
+---
+title: result
+description: API reference for qiskit.result
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.result
+---
+
+
+
+
+
+
+
+# Experiment Results
+
+
+
+`qiskit.result`
+
+| | |
+| ----------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
+| [`Result`](qiskit.result.Result "qiskit.result.Result")(backend\_name, backend\_version, ...\[, ...]) | Model for Results. |
+| [`ResultError`](qiskit.result.ResultError "qiskit.result.ResultError")(error) | Exceptions raised due to errors in result output. |
+| [`Counts`](qiskit.result.Counts "qiskit.result.Counts")(data\[, time\_taken, creg\_sizes, ...]) | A class to store a counts result from a circuit execution. |
+
+### marginal\_counts
+
+
+
+`qiskit.result.marginal_counts(result, indices=None, inplace=False, format_marginal=False, marginalize_memory=True)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/result/utils.py "view source code")
+
+Marginalize counts from an experiment over some indices of interest.
+
+**Parameters**
+
+* **result** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *|*[*Result*](qiskit.result.Result "qiskit.result.result.Result")) – result to be marginalized (a Result object or a dict(str, int) of counts).
+* **indices** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – The bit positions of interest to marginalize over. If `None` (default), do not marginalize at all.
+* **inplace** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Default: False. Operates on the original Result argument if True, leading to loss of original Job Result. It has no effect if `result` is a dict.
+* **format\_marginal** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Default: False. If True, takes the output of marginalize and formats it with placeholders between cregs and for non-indices.
+* **marginalize\_memory** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – If True, then also marginalize the memory field (if present). If False, remove the memory field from the result. If None, leave the memory field as is.
+
+**Returns**
+
+**A Result object or a dictionary with**
+
+the observed counts, marginalized to only account for frequency of observations of bits of interest.
+
+**Return type**
+
+[Result](qiskit.result.Result "qiskit.result.Result") or [dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")([str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)"), [int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)"))
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – in case of invalid indices to marginalize over.
+
+### marginal\_distribution
+
+
+
+`qiskit.result.marginal_distribution(counts, indices=None, format_marginal=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/result/utils.py "view source code")
+
+Marginalize counts from an experiment over some indices of interest.
+
+Unlike [`marginal_counts()`](#qiskit.result.marginal_counts "qiskit.result.marginal_counts") this function respects the order of the input `indices`. If the input `indices` list is specified then the order the bit indices are specified will be the output order of the bitstrings in the marginalized output.
+
+**Parameters**
+
+* **counts** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – result to be marginalized
+* **indices** ([*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – The bit positions of interest to marginalize over. If `None` (default), do not marginalize at all.
+* **format\_marginal** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Default: False. If True, takes the output of marginalize and formats it with placeholders between cregs and for non-indices.
+
+**Returns**
+
+A marginalized dictionary
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")([str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)"), [int](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)"))
+
+**Raises**
+
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If any value in `indices` is invalid or the `counts` dict
+* **is invalid.** –
+
+### marginal\_memory
+
+
+
+`qiskit.result.marginal_memory(memory, indices=None, int_return=False, hex_return=False, avg_data=False, parallel_threshold=1000)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/result/utils.py "view source code")
+
+Marginalize shot memory
+
+This function is multithreaded and will launch a thread pool with threads equal to the number of CPUs by default. You can tune the number of threads with the `RAYON_NUM_THREADS` environment variable. For example, setting `RAYON_NUM_THREADS=4` would limit the thread pool to 4 threads.
+
+**Parameters**
+
+* **memory** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*] |* [*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – The input memory list, this is either a list of hexadecimal strings to be marginalized representing measure level 2 memory or a numpy array representing level 0 measurement memory (single or avg) or level 1 measurement memory (single or avg).
+* **indices** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*] | None*) – The bit positions of interest to marginalize over. If `None` (default), do not marginalize at all.
+* **int\_return** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If set to `True` the output will be a list of integers. By default the return type is a bit string. This and `hex_return` are mutually exclusive and can not be specified at the same time. This option only has an effect with memory level 2.
+* **hex\_return** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If set to `True` the output will be a list of hexadecimal strings. By default the return type is a bit string. This and `int_return` are mutually exclusive and can not be specified at the same time. This option only has an effect with memory level 2.
+* **avg\_data** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If a 2 dimensional numpy array is passed in for `memory` this can be set to `True` to indicate it’s a avg level 0 data instead of level 1 single data.
+* **parallel\_threshold** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The number of elements in `memory` to start running in multiple threads. If `len(memory)` is >= this value, the function will run in multiple threads. By default this is set to 1000.
+
+**Returns**
+
+The list of marginalized memory
+
+**Return type**
+
+marginal\_memory
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – if both `int_return` and `hex_return` are set to `True`
+
+## Distributions
+
+| | |
+| ------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
+| [`ProbDistribution`](qiskit.result.ProbDistribution "qiskit.result.ProbDistribution")(data\[, shots]) | A generic dict-like class for probability distributions. |
+| [`QuasiDistribution`](qiskit.result.QuasiDistribution "qiskit.result.QuasiDistribution")(data\[, shots, ...]) | A dict-like class for representing quasi-probabilities. |
+
+## Expectation values
+
+### sampled\_expectation\_value
+
+
+
+`qiskit.result.sampled_expectation_value(dist, oper)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/result/sampled_expval.py "view source code")
+
+Computes expectation value from a sampled distribution
+
+Note that passing a raw dict requires bit-string keys.
+
+**Parameters**
+
+* **dist** ([*Counts*](qiskit.result.Counts "qiskit.result.Counts") *or*[*QuasiDistribution*](qiskit.result.QuasiDistribution "qiskit.result.QuasiDistribution") *or*[*ProbDistribution*](qiskit.result.ProbDistribution "qiskit.result.ProbDistribution") *or*[*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – Input sampled distribution
+* **oper** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or*[*Pauli*](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli") *or*[*PauliOp*](qiskit.opflow.primitive_ops.PauliOp "qiskit.opflow.primitive_ops.PauliOp") *or*[*PauliSumOp*](qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp") *or*[*SparsePauliOp*](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp")) – The operator for the observable
+
+**Returns**
+
+The expectation value
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input distribution or operator is an invalid type
+
+## Mitigation
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
+| [`BaseReadoutMitigator`](qiskit.result.BaseReadoutMitigator "qiskit.result.BaseReadoutMitigator")() | Base readout error mitigator class. |
+| [`CorrelatedReadoutMitigator`](qiskit.result.CorrelatedReadoutMitigator "qiskit.result.CorrelatedReadoutMitigator")(assignment\_matrix) | N-qubit readout error mitigator. |
+| [`LocalReadoutMitigator`](qiskit.result.LocalReadoutMitigator "qiskit.result.LocalReadoutMitigator")(\[assignment\_matrices, ...]) | 1-qubit tensor product readout error mitigator. |
+
diff --git a/docs/api/qiskit/0.46/scheduler.md b/docs/api/qiskit/0.46/scheduler.md
new file mode 100644
index 00000000000..eb0d6427858
--- /dev/null
+++ b/docs/api/qiskit/0.46/scheduler.md
@@ -0,0 +1,122 @@
+---
+title: scheduler
+description: API reference for qiskit.scheduler
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.scheduler
+---
+
+
+
+
+
+
+
+# Circuit Scheduler
+
+
+
+`qiskit.scheduler`
+
+A circuit scheduler compiles a circuit program to a pulse program.
+
+
+
+`qiskit.scheduler.ScheduleConfig(inst_map, meas_map, dt)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/scheduler/config.py "view source code")
+
+Configuration for pulse scheduling.
+
+Container for information needed to schedule a QuantumCircuit into a pulse Schedule.
+
+**Parameters**
+
+* **inst\_map** ([*InstructionScheduleMap*](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.instruction_schedule_map.InstructionScheduleMap")) – The schedule definition of all gates supported on a backend.
+* **meas\_map** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*]]*) – A list of groups of qubits which have to be measured together.
+* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Sample duration.
+
+### schedule\_circuit
+
+
+
+`qiskit.scheduler.schedule_circuit.schedule_circuit(circuit, schedule_config, method=None, backend=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/scheduler/schedule_circuit.py "view source code")
+
+Basic scheduling pass from a circuit to a pulse Schedule, using the backend. If no method is specified, then a basic, as late as possible scheduling pass is performed, i.e. pulses are scheduled to occur as late as possible.
+
+Supported methods:
+
+> * `'as_soon_as_possible'`: Schedule pulses greedily, as early as possible on a qubit resource. (alias: `'asap'`)
+> * `'as_late_as_possible'`: Schedule pulses late– keep qubits in the ground state when possible. (alias: `'alap'`)
+
+**Parameters**
+
+* **circuit** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")) – The quantum circuit to translate.
+* **schedule\_config** ([*ScheduleConfig*](#qiskit.scheduler.ScheduleConfig "qiskit.scheduler.config.ScheduleConfig")) – Backend specific parameters used for building the Schedule.
+* **method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The scheduling pass method to use.
+* **backend** ([*BackendV1*](qiskit.providers.BackendV1 "qiskit.providers.backend.BackendV1") *|*[*BackendV2*](qiskit.providers.BackendV2 "qiskit.providers.backend.BackendV2") *| None*) – A backend used to build the Schedule, the backend could be BackendV1 or BackendV2.
+
+**Returns**
+
+Schedule corresponding to the input circuit.
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If method isn’t recognized.
+
+**Return type**
+
+[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")
+
+
+
+Pulse scheduling methods.
+
+### as\_soon\_as\_possible
+
+
+
+`qiskit.scheduler.methods.as_soon_as_possible(circuit, schedule_config, backend=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/scheduler/methods/basic.py "view source code")
+
+Return the pulse Schedule which implements the input circuit using an “as soon as possible” (asap) scheduling policy.
+
+Circuit instructions are first each mapped to equivalent pulse Schedules according to the command definition given by the schedule\_config. Then, this circuit instruction-equivalent Schedule is appended at the earliest time at which all qubits involved in the instruction are available.
+
+**Parameters**
+
+* **circuit** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")) – The quantum circuit to translate.
+* **schedule\_config** ([*ScheduleConfig*](#qiskit.scheduler.ScheduleConfig "qiskit.scheduler.config.ScheduleConfig")) – Backend specific parameters used for building the Schedule.
+* **backend** ([*BackendV1*](qiskit.providers.BackendV1 "qiskit.providers.backend.BackendV1") *|*[*BackendV2*](qiskit.providers.BackendV2 "qiskit.providers.backend.BackendV2") *| None*) – A backend used to build the Schedule, the backend could be BackendV1 or BackendV2.
+
+**Returns**
+
+A schedule corresponding to the input `circuit` with pulses occurring as early as possible.
+
+**Return type**
+
+[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")
+
+### as\_late\_as\_possible
+
+
+
+`qiskit.scheduler.methods.as_late_as_possible(circuit, schedule_config, backend=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/scheduler/methods/basic.py "view source code")
+
+Return the pulse Schedule which implements the input circuit using an “as late as possible” (alap) scheduling policy.
+
+Circuit instructions are first each mapped to equivalent pulse Schedules according to the command definition given by the schedule\_config. Then, this circuit instruction-equivalent Schedule is appended at the latest time that it can be without allowing unnecessary time between instructions or allowing instructions with common qubits to overlap.
+
+This method should improves the outcome fidelity over ASAP scheduling, because we may maximize the time that the qubit remains in the ground state.
+
+**Parameters**
+
+* **circuit** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")) – The quantum circuit to translate.
+* **schedule\_config** ([*ScheduleConfig*](#qiskit.scheduler.ScheduleConfig "qiskit.scheduler.config.ScheduleConfig")) – Backend specific parameters used for building the Schedule.
+* **backend** ([*BackendV1*](qiskit.providers.BackendV1 "qiskit.providers.backend.BackendV1") *|*[*BackendV2*](qiskit.providers.BackendV2 "qiskit.providers.backend.BackendV2") *| None*) – A backend used to build the Schedule, the backend could be BackendV1 or BackendV2.
+
+**Returns**
+
+A schedule corresponding to the input `circuit` with pulses occurring as late as possible.
+
+**Return type**
+
+[*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule")
+
diff --git a/docs/api/qiskit/0.46/synthesis.md b/docs/api/qiskit/0.46/synthesis.md
new file mode 100644
index 00000000000..bb841c6ed7c
--- /dev/null
+++ b/docs/api/qiskit/0.46/synthesis.md
@@ -0,0 +1,729 @@
+---
+title: synthesis
+description: API reference for qiskit.synthesis
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.synthesis
+---
+
+
+
+
+
+
+
+# Circuit Synthesis
+
+
+
+`qiskit.synthesis`
+
+
+
+## Evolution Synthesis
+
+| | |
+| ---------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`EvolutionSynthesis`](qiskit.synthesis.EvolutionSynthesis "qiskit.synthesis.EvolutionSynthesis")() | Interface for evolution synthesis algorithms. |
+| [`ProductFormula`](qiskit.synthesis.ProductFormula "qiskit.synthesis.ProductFormula")(order\[, reps, ...]) | Product formula base class for the decomposition of non-commuting operator exponentials. |
+| [`LieTrotter`](qiskit.synthesis.LieTrotter "qiskit.synthesis.LieTrotter")(\[reps, insert\_barriers, ...]) | The Lie-Trotter product formula. |
+| [`SuzukiTrotter`](qiskit.synthesis.SuzukiTrotter "qiskit.synthesis.SuzukiTrotter")(\[order, reps, ...]) | The (higher order) Suzuki-Trotter product formula. |
+| [`MatrixExponential`](qiskit.synthesis.MatrixExponential "qiskit.synthesis.MatrixExponential")() | Exact operator evolution via matrix exponentiation and unitary synthesis. |
+| [`QDrift`](qiskit.synthesis.QDrift "qiskit.synthesis.QDrift")(\[reps, insert\_barriers, ...]) | The QDrift Trotterization method, which selects each each term in the Trotterization randomly, with a probability proportional to its weight. |
+
+## Linear Function Synthesis
+
+### synth\_cnot\_count\_full\_pmh
+
+
+
+`qiskit.synthesis.synth_cnot_count_full_pmh(state, section_size=2)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/linear/cnot_synth.py "view source code")
+
+Synthesize linear reversible circuits for all-to-all architecture using Patel, Markov and Hayes method.
+
+This function is an implementation of the Patel, Markov and Hayes algorithm from \[1] for optimal synthesis of linear reversible circuits for all-to-all architecture, as specified by an n x n matrix.
+
+**Parameters**
+
+* **state** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*] or ndarray*) – n x n boolean invertible matrix, describing the state of the input circuit
+* **section\_size** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the size of each section, used in the Patel–Markov–Hayes algorithm \[1]. section\_size must be a factor of num\_qubits.
+
+**Returns**
+
+a CX-only circuit implementing the linear transformation.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – when variable “state” isn’t of type numpy.ndarray
+
+**References**
+
+1. Patel, Ketan N., Igor L. Markov, and John P. Hayes, *Optimal synthesis of linear reversible circuits*, Quantum Information & Computation 8.3 (2008): 282-294. [arXiv:quant-ph/0302002 \[quant-ph\]](https://arxiv.org/abs/quant-ph/0302002)
+
+### synth\_cnot\_depth\_line\_kms
+
+
+
+`qiskit.synthesis.synth_cnot_depth_line_kms(mat)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/linear/linear_depth_lnn.py "view source code")
+
+Synthesize linear reversible circuit for linear nearest-neighbor architectures using Kutin, Moulton, Smithline method.
+
+Synthesis algorithm for linear reversible circuits from \[1], Chapter 7. Synthesizes any linear reversible circuit of n qubits over linear nearest-neighbor architecture using CX gates with depth at most 5\*n.
+
+**Parameters**
+
+**mat** (*np.ndarray]*) – A boolean invertible matrix.
+
+**Returns**
+
+the synthesized quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if mat is not invertible.
+
+**References**
+
+1. Kutin, S., Moulton, D. P., Smithline, L., *Computation at a distance*, Chicago J. Theor. Comput. Sci., vol. 2007, (2007), [arXiv:quant-ph/0701194](https://arxiv.org/abs/quant-ph/0701194)
+
+## Linear-Phase Synthesis
+
+### synth\_cz\_depth\_line\_mr
+
+
+
+`qiskit.synthesis.synth_cz_depth_line_mr(mat)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/linear_phase/cz_depth_lnn.py "view source code")
+
+Synthesis of a CZ circuit for linear nearest neighbour (LNN) connectivity, based on Maslov and Roetteler.
+
+Note that this method *reverts* the order of qubits in the circuit, and returns a circuit containing CX and phase (S, Sdg or Z) gates.
+
+**Parameters**
+
+**mat** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – an upper-diagonal matrix representing the CZ circuit. mat\[i]\[j]=1 for i\
+
+`qiskit.synthesis.synth_cx_cz_depth_line_my(mat_x, mat_z)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/linear_phase/cx_cz_depth_lnn.py "view source code")
+
+Joint synthesis of a -CZ-CX- circuit for linear nearest neighbour (LNN) connectivity, with 2-qubit depth at most 5n, based on Maslov and Yang. This method computes the CZ circuit inside the CX circuit via phase gate insertions.
+
+**Parameters**
+
+* **mat\_z** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – a boolean symmetric matrix representing a CZ circuit. Mz\[i]\[j]=1 represents a CZ(i,j) gate
+* **mat\_x** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")) – a boolean invertible matrix representing a CX circuit.
+
+**Returns**
+
+a circuit implementation of a CX circuit following a CZ circuit, denoted as a -CZ-CX- circuit,in two-qubit depth at most 5n, for LNN connectivity.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Reference:**
+
+1. Kutin, S., Moulton, D. P., Smithline, L., *Computation at a distance*, Chicago J. Theor. Comput. Sci., vol. 2007, (2007), [arXiv:quant-ph/0701194](https://arxiv.org/abs/quant-ph/0701194)
+2. Dmitri Maslov, Willers Yang, *CNOT circuits need little help to implement arbitrary Hadamard-free Clifford transformations they generate*, [arXiv:2210.16195](https://arxiv.org/abs/2210.16195).
+
+### synth\_cnot\_phase\_aam
+
+
+
+`qiskit.synthesis.synth_cnot_phase_aam(cnots, angles, section_size=2)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/linear_phase/cnot_phase_synth.py "view source code")
+
+This function is an implementation of the GraySynth algorithm of Amy, Azimadeh and Mosca.
+
+GraySynth is a heuristic algorithm from \[1] for synthesizing small parity networks. It is inspired by Gray codes. Given a set of binary strings S (called “cnots” bellow), the algorithm synthesizes a parity network for S by repeatedly choosing an index i to expand and then effectively recursing on the co-factors S\_0 and S\_1, consisting of the strings y in S, with y\_i = 0 or 1 respectively. As a subset S is recursively expanded, CNOT gates are applied so that a designated target bit contains the (partial) parity ksi\_y(x) where y\_i = 1 if and only if y’\_i = 1 for all y’ in S. If S is a singleton \{y’}, then y = y’, hence the target bit contains the value ksi\_y’(x) as desired.
+
+Notably, rather than uncomputing this sequence of CNOT gates when a subset S is finished being synthesized, the algorithm maintains the invariant that the remaining parities to be computed are expressed over the current state of bits. This allows the algorithm to avoid the ‘backtracking’ inherent in uncomputing-based methods.
+
+The algorithm is described in detail in section 4 of \[1].
+
+**Parameters**
+
+* **cnots** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*]*) –
+
+ a matrix whose columns are the parities to be synthesized e.g.:
+
+ ```python
+ [[0, 1, 1, 1, 1, 1],
+ [1, 0, 0, 1, 1, 1],
+ [1, 0, 0, 1, 0, 0],
+ [0, 0, 1, 0, 1, 0]]
+ ```
+
+ corresponds to:
+
+ ```python
+ x1^x2 + x0 + x0^x3 + x0^x1^x2 + x0^x1^x3 + x0^x1
+ ```
+
+* **angles** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – a list containing all the phase-shift gates which are to be applied, in the same order as in “cnots”. A number is interpreted as the angle of p(angle), otherwise the elements have to be ‘t’, ‘tdg’, ‘s’, ‘sdg’ or ‘z’.
+
+* **section\_size** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – the size of every section, used in \_lwr\_cnot\_synth(), in the Patel–Markov–Hayes algorithm. section\_size must be a factor of num\_qubits.
+
+**Returns**
+
+the decomposed quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – when dimensions of cnots and angles don’t align.
+
+**References**
+
+1. Matthew Amy, Parsiad Azimzadeh, and Michele Mosca. *On the controlled-NOT complexity of controlled-NOT–phase circuits.*, Quantum Science and Technology 4.1 (2018): 015002. [arXiv:1712.01859](https://arxiv.org/abs/1712.01859)
+
+## Permutation Synthesis
+
+### synth\_permutation\_depth\_lnn\_kms
+
+
+
+`qiskit.synthesis.synth_permutation_depth_lnn_kms(pattern)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/permutation/permutation_lnn.py "view source code")
+
+Synthesize a permutation circuit for a linear nearest-neighbor architecture using the Kutin, Moulton, Smithline method.
+
+This is the permutation synthesis algorithm from [https://arxiv.org/abs/quant-ph/0701194](https://arxiv.org/abs/quant-ph/0701194), Chapter 6. It synthesizes any permutation of n qubits over linear nearest-neighbor architecture using SWAP gates with depth at most n and size at most n(n-1)/2 (where both depth and size are measured with respect to SWAPs).
+
+**Parameters**
+
+**pattern** (*Union\[*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*], np.ndarray]*) – permutation pattern, describing which qubits occupy the positions 0, 1, 2, etc. after applying the permutation. That is, `pattern[k] = m` when the permutation maps qubit `m` to position `k`. As an example, the pattern `[2, 4, 3, 0, 1]` means that qubit `2` goes to position `0`, qubit `4` goes to position `1`, etc.
+
+**Returns**
+
+the synthesized quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### synth\_permutation\_basic
+
+
+
+`qiskit.synthesis.synth_permutation_basic(pattern)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/permutation/permutation_full.py "view source code")
+
+Synthesize a permutation circuit for a fully-connected architecture using sorting.
+
+More precisely, if the input permutation is a cycle of length `m`, then this creates a quantum circuit with `m-1` SWAPs (and of depth `m-1`); if the input permutation consists of several disjoint cycles, then each cycle is essentially treated independently.
+
+**Parameters**
+
+**pattern** (*Union\[*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*], np.ndarray]*) – permutation pattern, describing which qubits occupy the positions 0, 1, 2, etc. after applying the permutation. That is, `pattern[k] = m` when the permutation maps qubit `m` to position `k`. As an example, the pattern `[2, 4, 3, 0, 1]` means that qubit `2` goes to position `0`, qubit `4` goes to position `1`, etc.
+
+**Returns**
+
+the synthesized quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+### synth\_permutation\_acg
+
+
+
+`qiskit.synthesis.synth_permutation_acg(pattern)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/permutation/permutation_full.py "view source code")
+
+Synthesize a permutation circuit for a fully-connected architecture using the Alon, Chung, Graham method.
+
+This produces a quantum circuit of depth 2 (measured in the number of SWAPs).
+
+This implementation is based on the Theorem 2 in the paper “Routing Permutations on Graphs Via Matchings” (1993), available at [https://www.cs.tau.ac.il/\~nogaa/PDFS/r.pdf](https://www.cs.tau.ac.il/~nogaa/PDFS/r.pdf).
+
+**Parameters**
+
+**pattern** (*Union\[*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")*], np.ndarray]*) – permutation pattern, describing which qubits occupy the positions 0, 1, 2, etc. after applying the permutation. That is, `pattern[k] = m` when the permutation maps qubit `m` to position `k`. As an example, the pattern `[2, 4, 3, 0, 1]` means that qubit `2` goes to position `0`, qubit `4` goes to position `1`, etc.
+
+**Returns**
+
+the synthesized quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+## Clifford Synthesis
+
+### synth\_clifford\_full
+
+
+
+`qiskit.synthesis.synth_clifford_full(clifford, method=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/clifford/clifford_decompose_full.py "view source code")
+
+Decompose a Clifford operator into a QuantumCircuit.
+
+For N \<= 3 qubits this is based on optimal CX cost decomposition from reference \[1]. For N > 3 qubits this is done using the general non-optimal greedy compilation routine from reference \[3], which typically yields better CX cost compared to the AG method in \[2].
+
+**Parameters**
+
+* **clifford** ([*Clifford*](qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")) – a clifford operator.
+* **method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Optional, a synthesis method (‘AG’ or ‘greedy’). If set this overrides optimal decomposition for N \<=3 qubits.
+
+**Returns**
+
+a circuit implementation of the Clifford.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**References**
+
+1. S. Bravyi, D. Maslov, *Hadamard-free circuits expose the structure of the Clifford group*, [arXiv:2003.09412 \[quant-ph\]](https://arxiv.org/abs/2003.09412)
+2. S. Aaronson, D. Gottesman, *Improved Simulation of Stabilizer Circuits*, Phys. Rev. A 70, 052328 (2004). [arXiv:quant-ph/0406196](https://arxiv.org/abs/quant-ph/0406196)
+3. Sergey Bravyi, Shaohan Hu, Dmitri Maslov, Ruslan Shaydulin, *Clifford Circuit Optimization with Templates and Symbolic Pauli Gates*, [arXiv:2105.02291 \[quant-ph\]](https://arxiv.org/abs/2105.02291)
+
+### synth\_clifford\_ag
+
+
+
+`qiskit.synthesis.synth_clifford_ag(clifford)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/clifford/clifford_decompose_ag.py "view source code")
+
+Decompose a Clifford operator into a QuantumCircuit based on Aaronson-Gottesman method.
+
+**Parameters**
+
+**clifford** ([*Clifford*](qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")) – a clifford operator.
+
+**Returns**
+
+a circuit implementation of the Clifford.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Reference:**
+
+1. S. Aaronson, D. Gottesman, *Improved Simulation of Stabilizer Circuits*, Phys. Rev. A 70, 052328 (2004). [arXiv:quant-ph/0406196](https://arxiv.org/abs/quant-ph/0406196)
+
+### synth\_clifford\_bm
+
+
+
+`qiskit.synthesis.synth_clifford_bm(clifford)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/clifford/clifford_decompose_bm.py "view source code")
+
+Optimal CX-cost decomposition of a Clifford operator on 2-qubits or 3-qubits into a QuantumCircuit based on Bravyi-Maslov method.
+
+**Parameters**
+
+**clifford** ([*Clifford*](qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")) – a clifford operator.
+
+**Returns**
+
+a circuit implementation of the Clifford.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if clifford is on more than 3 qubits.
+
+**Reference:**
+
+1. S. Bravyi, D. Maslov, *Hadamard-free circuits expose the structure of the Clifford group*, [arXiv:2003.09412 \[quant-ph\]](https://arxiv.org/abs/2003.09412)
+
+### synth\_clifford\_greedy
+
+
+
+`qiskit.synthesis.synth_clifford_greedy(clifford)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/clifford/clifford_decompose_greedy.py "view source code")
+
+Decompose a Clifford operator into a QuantumCircuit based on the greedy Clifford compiler that is described in Appendix A of Bravyi, Hu, Maslov and Shaydulin.
+
+This method typically yields better CX cost compared to the Aaronson-Gottesman method.
+
+**Parameters**
+
+**clifford** ([*Clifford*](qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")) – a clifford operator.
+
+**Returns**
+
+a circuit implementation of the Clifford.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if symplectic Gaussian elimination fails.
+
+**Reference:**
+
+1. Sergey Bravyi, Shaohan Hu, Dmitri Maslov, Ruslan Shaydulin, *Clifford Circuit Optimization with Templates and Symbolic Pauli Gates*, [arXiv:2105.02291 \[quant-ph\]](https://arxiv.org/abs/2105.02291)
+
+### synth\_clifford\_layers
+
+
+
+`qiskit.synthesis.synth_clifford_layers(cliff, cx_synth_func=, cz_synth_func=, cx_cz_synth_func=None, cz_func_reverse_qubits=False, validate=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/clifford/clifford_decompose_layers.py "view source code")
+
+Synthesis of a Clifford into layers, it provides a similar decomposition to the synthesis described in Lemma 8 of Bravyi and Maslov.
+
+For example, a 5-qubit Clifford circuit is decomposed into the following layers:
+
+```python
+ ┌─────┐┌─────┐┌────────┐┌─────┐┌─────┐┌─────┐┌─────┐┌────────┐
+q_0: ┤0 ├┤0 ├┤0 ├┤0 ├┤0 ├┤0 ├┤0 ├┤0 ├
+ │ ││ ││ ││ ││ ││ ││ ││ │
+q_1: ┤1 ├┤1 ├┤1 ├┤1 ├┤1 ├┤1 ├┤1 ├┤1 ├
+ │ ││ ││ ││ ││ ││ ││ ││ │
+q_2: ┤2 S2 ├┤2 CZ ├┤2 CX_dg ├┤2 H2 ├┤2 S1 ├┤2 CZ ├┤2 H1 ├┤2 Pauli ├
+ │ ││ ││ ││ ││ ││ ││ ││ │
+q_3: ┤3 ├┤3 ├┤3 ├┤3 ├┤3 ├┤3 ├┤3 ├┤3 ├
+ │ ││ ││ ││ ││ ││ ││ ││ │
+q_4: ┤4 ├┤4 ├┤4 ├┤4 ├┤4 ├┤4 ├┤4 ├┤4 ├
+ └─────┘└─────┘└────────┘└─────┘└─────┘└─────┘└─────┘└────────┘
+```
+
+This decomposition is for the default cz\_synth\_func and cx\_synth\_func functions, with other functions one may see slightly different decomposition.
+
+**Parameters**
+
+* **cliff** ([*Clifford*](qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")) – a clifford operator.
+* **cx\_synth\_func** (*Callable*) – a function to decompose the CX sub-circuit. It gets as input a boolean invertible matrix, and outputs a QuantumCircuit.
+* **cz\_synth\_func** (*Callable*) – a function to decompose the CZ sub-circuit. It gets as input a boolean symmetric matrix, and outputs a QuantumCircuit.
+* **cx\_cz\_synth\_func** (*Callable*) – optional, a function to decompose both sub-circuits CZ and CX.
+* **validate** (*Boolean*) – if True, validates the synthesis process.
+* **cz\_func\_reverse\_qubits** (*Boolean*) – True only if cz\_synth\_func is synth\_cz\_depth\_line\_mr, since this function returns a circuit that reverts the order of qubits.
+
+**Returns**
+
+a circuit implementation of the Clifford.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Reference:**
+
+1. S. Bravyi, D. Maslov, *Hadamard-free circuits expose the structure of the Clifford group*, [arXiv:2003.09412 \[quant-ph\]](https://arxiv.org/abs/2003.09412)
+
+### synth\_clifford\_depth\_lnn
+
+
+
+`qiskit.synthesis.synth_clifford_depth_lnn(cliff)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/clifford/clifford_decompose_layers.py "view source code")
+
+Synthesis of a Clifford into layers for linear-nearest neighbour connectivity.
+
+The depth of the synthesized n-qubit circuit is bounded by 7\*n+2, which is not optimal. It should be replaced by a better algorithm that provides depth bounded by 7\*n-4 \[3].
+
+**Parameters**
+
+**cliff** ([*Clifford*](qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")) – a clifford operator.
+
+**Returns**
+
+a circuit implementation of the Clifford.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Reference:**
+
+1. S. Bravyi, D. Maslov, *Hadamard-free circuits expose the structure of the Clifford group*, [arXiv:2003.09412 \[quant-ph\]](https://arxiv.org/abs/2003.09412)
+2. Dmitri Maslov, Martin Roetteler, *Shorter stabilizer circuits via Bruhat decomposition and quantum circuit transformations*, [arXiv:1705.09176](https://arxiv.org/abs/1705.09176).
+3. Dmitri Maslov, Willers Yang, *CNOT circuits need little help to implement arbitrary Hadamard-free Clifford transformations they generate*, [arXiv:2210.16195](https://arxiv.org/abs/2210.16195).
+
+## CNOTDihedral Synthesis
+
+### synth\_cnotdihedral\_full
+
+
+
+`qiskit.synthesis.synth_cnotdihedral_full(elem)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/cnotdihedral/cnotdihedral_decompose_full.py "view source code")
+
+Decompose a CNOTDihedral element into a QuantumCircuit. For N \<= 2 qubits this is based on optimal CX cost decomposition from reference \[1]. For N > 2 qubits this is done using the general non-optimal compilation routine from reference \[2].
+
+**Parameters**
+
+**elem** ([*CNOTDihedral*](qiskit.quantum_info.CNOTDihedral "qiskit.quantum_info.CNOTDihedral")) – a CNOTDihedral element.
+
+**Returns**
+
+a circuit implementation of the CNOTDihedral element.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**References**
+
+1. Shelly Garion and Andrew W. Cross, *Synthesis of CNOT-Dihedral circuits with optimal number of two qubit gates*, [Quantum 4(369), 2020](https://quantum-journal.org/papers/q-2020-12-07-369/)
+2. Andrew W. Cross, Easwar Magesan, Lev S. Bishop, John A. Smolin and Jay M. Gambetta, *Scalable randomised benchmarking of non-Clifford gates*, npj Quantum Inf 2, 16012 (2016).
+
+### synth\_cnotdihedral\_two\_qubits
+
+
+
+`qiskit.synthesis.synth_cnotdihedral_two_qubits(elem)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/cnotdihedral/cnotdihedral_decompose_two_qubits.py "view source code")
+
+Decompose a CNOTDihedral element on a single qubit and two qubits into a QuantumCircuit. This decomposition has an optimal number of CX gates.
+
+**Parameters**
+
+**elem** ([*CNOTDihedral*](qiskit.quantum_info.CNOTDihedral "qiskit.quantum_info.CNOTDihedral")) – a CNOTDihedral element.
+
+**Returns**
+
+a circuit implementation of the CNOTDihedral element.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the element in not 1-qubit or 2-qubit CNOTDihedral.
+
+**Reference:**
+
+1. Shelly Garion and Andrew W. Cross, *On the structure of the CNOT-Dihedral group*, [arXiv:2006.12042 \[quant-ph\]](https://arxiv.org/abs/2006.12042)
+
+### synth\_cnotdihedral\_general
+
+
+
+`qiskit.synthesis.synth_cnotdihedral_general(elem)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/cnotdihedral/cnotdihedral_decompose_general.py "view source code")
+
+Decompose a CNOTDihedral element into a QuantumCircuit.
+
+Decompose a general CNOTDihedral elements. The number of CNOT gates is not necessarily optimal. For a decomposition of a 1-qubit or 2-qubit element, call synth\_cnotdihedral\_two\_qubits.
+
+**Parameters**
+
+**elem** ([*CNOTDihedral*](qiskit.quantum_info.CNOTDihedral "qiskit.quantum_info.CNOTDihedral")) – a CNOTDihedral element.
+
+**Returns**
+
+a circuit implementation of the CNOTDihedral element.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the element could not be decomposed into a circuit.
+
+**Reference:**
+
+1. Andrew W. Cross, Easwar Magesan, Lev S. Bishop, John A. Smolin and Jay M. Gambetta, *Scalable randomised benchmarking of non-Clifford gates*, npj Quantum Inf 2, 16012 (2016).
+
+## Stabilizer State Synthesis
+
+### synth\_stabilizer\_layers
+
+
+
+`qiskit.synthesis.synth_stabilizer_layers(stab, cz_synth_func=, cz_func_reverse_qubits=False, validate=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/stabilizer/stabilizer_decompose.py "view source code")
+
+Synthesis of a stabilizer state into layers.
+
+It provides a similar decomposition to the synthesis described in Lemma 8 of Bravyi and Maslov, without the initial Hadamard-free sub-circuit which do not affect the stabilizer state.
+
+For example, a 5-qubit stabilizer state is decomposed into the following layers:
+
+```python
+ ┌─────┐┌─────┐┌─────┐┌─────┐┌────────┐
+q_0: ┤0 ├┤0 ├┤0 ├┤0 ├┤0 ├
+ │ ││ ││ ││ ││ │
+q_1: ┤1 ├┤1 ├┤1 ├┤1 ├┤1 ├
+ │ ││ ││ ││ ││ │
+q_2: ┤2 H2 ├┤2 S1 ├┤2 CZ ├┤2 H1 ├┤2 Pauli ├
+ │ ││ ││ ││ ││ │
+q_3: ┤3 ├┤3 ├┤3 ├┤3 ├┤3 ├
+ │ ││ ││ ││ ││ │
+q_4: ┤4 ├┤4 ├┤4 ├┤4 ├┤4 ├
+ └─────┘└─────┘└─────┘└─────┘└────────┘
+```
+
+**Parameters**
+
+* **stab** ([*StabilizerState*](qiskit.quantum_info.StabilizerState "qiskit.quantum_info.StabilizerState")) – a stabilizer state.
+* **cz\_synth\_func** (*Callable*) – a function to decompose the CZ sub-circuit. It gets as input a boolean symmetric matrix, and outputs a QuantumCircuit.
+* **validate** (*Boolean*) – if True, validates the synthesis process.
+* **cz\_func\_reverse\_qubits** (*Boolean*) – True only if cz\_synth\_func is synth\_cz\_depth\_line\_mr, since this function returns a circuit that reverts the order of qubits.
+
+**Returns**
+
+a circuit implementation of the stabilizer state.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if the input is not a StabilizerState.
+
+**Reference:**
+
+1. S. Bravyi, D. Maslov, *Hadamard-free circuits expose the structure of the Clifford group*, [arXiv:2003.09412 \[quant-ph\]](https://arxiv.org/abs/2003.09412)
+
+### synth\_stabilizer\_depth\_lnn
+
+
+
+`qiskit.synthesis.synth_stabilizer_depth_lnn(stab)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/stabilizer/stabilizer_decompose.py "view source code")
+
+Synthesis of an n-qubit stabilizer state for linear-nearest neighbour connectivity, in 2-qubit depth 2\*n+2 and two distinct CX layers, using CX and phase gates (S, Sdg or Z).
+
+**Parameters**
+
+**stab** ([*StabilizerState*](qiskit.quantum_info.StabilizerState "qiskit.quantum_info.StabilizerState")) – a stabilizer state.
+
+**Returns**
+
+a circuit implementation of the stabilizer state.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Reference:**
+
+1. S. Bravyi, D. Maslov, *Hadamard-free circuits expose the structure of the Clifford group*, [arXiv:2003.09412 \[quant-ph\]](https://arxiv.org/abs/2003.09412)
+2. Dmitri Maslov, Martin Roetteler, *Shorter stabilizer circuits via Bruhat decomposition and quantum circuit transformations*, [arXiv:1705.09176](https://arxiv.org/abs/1705.09176).
+
+## Discrete Basis Synthesis
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
+| [`SolovayKitaevDecomposition`](qiskit.synthesis.SolovayKitaevDecomposition "qiskit.synthesis.SolovayKitaevDecomposition")(\[...]) | The Solovay Kitaev discrete decomposition algorithm. |
+
+### generate\_basic\_approximations
+
+
+
+`qiskit.synthesis.generate_basic_approximations(basis_gates, depth, filename=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/discrete_basis/generate_basis_approximations.py "view source code")
+
+Generates a list of `GateSequence``s with the gates in ``basic_gates`.
+
+**Parameters**
+
+* **basis\_gates** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*Gate*](qiskit.circuit.Gate "qiskit.circuit.Gate")*]*) – The gates from which to create the sequences of gates.
+* **depth** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The maximum depth of the approximations.
+* **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – If provided, the basic approximations are stored in this file.
+
+**Returns**
+
+List of `GateSequences` using the gates in `basic_gates`.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If `basis_gates` contains an invalid gate identifier.
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")\[GateSequence]
+
+## Unitary Synthesis
+
+Decomposition of general $2^n \times 2^n$ unitary matrices for any number of qubits.
+
+### qs\_decomposition
+
+
+
+`qiskit.synthesis.qs_decomposition(mat, opt_a1=True, opt_a2=True, decomposer_1q=None, decomposer_2q=None, *, _depth=0)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/unitary/qsd.py "view source code")
+
+Decomposes a unitary matrix into one and two qubit gates using Quantum Shannon Decomposition,
+
+This decomposition is described in Shende et al. \[1].
+
+```python
+ ┌───┐ ┌───┐ ┌───┐ ┌───┐
+ ─┤ ├─ ───────┤ Rz├─────┤ Ry├─────┤ Rz├─────
+ │ │ ≃ ┌───┐└─┬─┘┌───┐└─┬─┘┌───┐└─┬─┘┌───┐
+/─┤ ├─ /─┤ ├──□──┤ ├──□──┤ ├──□──┤ ├
+ └───┘ └───┘ └───┘ └───┘ └───┘
+```
+
+The number of CX gates generated with the decomposition without optimizations is,
+
+$$
+\frac{9}{16} 4^n - \frac{3}{2} 2^n
+$$
+
+If opt\_a1 = True, the default, the CX count is reduced by,
+
+$$
+\frac{1}{3} 4^{n - 2} - 1.
+$$
+
+If opt\_a2 = True, the default, the CX count is reduced by,
+
+$$
+4^{n-2} - 1.
+$$
+
+**Parameters**
+
+* **mat** (*np.ndarray*) – unitary matrix to decompose
+* **opt\_a1** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – whether to try optimization A.1 from Shende et al. \[1]. This should eliminate 1 cx per call. If True CZ gates are left in the output. If desired these can be further decomposed to CX.
+* **opt\_a2** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – whether to try optimization A.2 from Shende et al. \[1]. This decomposes two qubit unitaries into a diagonal gate and a two cx unitary and reduces overall cx count by $4^{n-2} - 1$.
+* **decomposer\_1q** (*Callable\[\[np.ndarray],* [*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*] | None*) – optional 1Q decomposer. If None, uses [`OneQubitEulerDecomposer`](qiskit.synthesis.OneQubitEulerDecomposer "qiskit.synthesis.OneQubitEulerDecomposer").
+* **decomposer\_2q** (*Callable\[\[np.ndarray],* [*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*] | None*) – optional 2Q decomposer. If None, uses [`TwoQubitBasisDecomposer`](qiskit.synthesis.TwoQubitBasisDecomposer "qiskit.synthesis.TwoQubitBasisDecomposer").
+
+**Returns**
+
+Decomposed quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Reference:**
+
+1. Shende, Bullock, Markov, *Synthesis of Quantum Logic Circuits*, [arXiv:0406176 \[quant-ph\]](https://arxiv.org/abs/quant-ph/0406176)
+
+The Approximate Quantum Compiler is available here: [`qiskit.synthesis.unitary.aqc`](synthesis_aqc#module-qiskit.synthesis.unitary.aqc "qiskit.synthesis.unitary.aqc")
+
+## One-Qubit Synthesis
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------- |
+| [`OneQubitEulerDecomposer`](qiskit.synthesis.OneQubitEulerDecomposer "qiskit.synthesis.OneQubitEulerDecomposer")(\[basis, use\_dag]) | A class for decomposing 1-qubit unitaries into Euler angle rotations. |
+
+## Two-Qubit Synthesis
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`TwoQubitBasisDecomposer`](qiskit.synthesis.TwoQubitBasisDecomposer "qiskit.synthesis.TwoQubitBasisDecomposer")(gate\[, ...]) | A class for decomposing 2-qubit unitaries into minimal number of uses of a 2-qubit basis gate. |
+| [`XXDecomposer`](qiskit.synthesis.XXDecomposer "qiskit.synthesis.XXDecomposer")(\[basis\_fidelity, euler\_basis, ...]) | A class for optimal decomposition of 2-qubit unitaries into 2-qubit basis gates of XX type (i.e., each locally equivalent to CAN(alpha, 0, 0) for a possibly varying alpha). |
+
diff --git a/docs/api/qiskit/0.46/synthesis_aqc.md b/docs/api/qiskit/0.46/synthesis_aqc.md
new file mode 100644
index 00000000000..821bc5dc1f9
--- /dev/null
+++ b/docs/api/qiskit/0.46/synthesis_aqc.md
@@ -0,0 +1,168 @@
+---
+title: aqc
+description: API reference for qiskit.synthesis.unitary.aqc
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.synthesis.unitary.aqc
+---
+
+
+
+
+
+
+
+# Approximate Quantum Compiler
+
+
+
+`qiskit.synthesis.unitary.aqc`
+
+Implementation of Approximate Quantum Compiler as described in the paper \[1].
+
+## Interface
+
+The main public interface of this module is reached by passing `unitary_synthesis_method='aqc'` to [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile"). This will swap the synthesis method to use `AQCSynthesisPlugin`. The individual classes are:
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
+| [`AQC`](qiskit.synthesis.unitary.aqc.AQC "qiskit.synthesis.unitary.aqc.AQC")(\[optimizer, seed]) | A generic implementation of the Approximate Quantum Compiler. |
+| [`ApproximateCircuit`](qiskit.synthesis.unitary.aqc.ApproximateCircuit "qiskit.synthesis.unitary.aqc.ApproximateCircuit")(num\_qubits\[, name]) | A base class that represents an approximate circuit. |
+| [`ApproximatingObjective`](qiskit.synthesis.unitary.aqc.ApproximatingObjective "qiskit.synthesis.unitary.aqc.ApproximatingObjective")() | A base class for an optimization problem definition. |
+| [`CNOTUnitCircuit`](qiskit.synthesis.unitary.aqc.CNOTUnitCircuit "qiskit.synthesis.unitary.aqc.CNOTUnitCircuit")(num\_qubits, cnots\[, tol, name]) | A class that represents an approximate circuit based on CNOT unit blocks. |
+| [`CNOTUnitObjective`](qiskit.synthesis.unitary.aqc.CNOTUnitObjective "qiskit.synthesis.unitary.aqc.CNOTUnitObjective")(num\_qubits, cnots) | A base class for a problem definition based on CNOT unit. |
+| [`DefaultCNOTUnitObjective`](qiskit.synthesis.unitary.aqc.DefaultCNOTUnitObjective "qiskit.synthesis.unitary.aqc.DefaultCNOTUnitObjective")(num\_qubits, cnots) | A naive implementation of the objective function based on CNOT units. |
+| [`FastCNOTUnitObjective`](qiskit.synthesis.unitary.aqc.FastCNOTUnitObjective "qiskit.synthesis.unitary.aqc.FastCNOTUnitObjective")(num\_qubits, cnots) | Implementation of objective function and gradient calculator, which is similar to `DefaultCNOTUnitObjective` but several times faster. |
+
+## Mathematical Detail
+
+We are interested in compiling a quantum circuit, which we formalize as finding the best circuit representation in terms of an ordered gate sequence of a target unitary matrix $U\in U(d)$, with some additional hardware constraints. In particular, we look at representations that could be constrained in terms of hardware connectivity, as well as gate depth, and we choose a gate basis in terms of CNOT and rotation gates. We recall that the combination of CNOT and rotation gates is universal in $SU(d)$ and therefore it does not limit compilation.
+
+To properly define what we mean by best circuit representation, we define the metric as the Frobenius norm between the unitary matrix of the compiled circuit $V$ and the target unitary matrix $U$, i.e., $\|V - U\|_{\mathrm{F}}$. This choice is motivated by mathematical programming considerations, and it is related to other formulations that appear in the literature. Let’s take a look at the problem in more details.
+
+Let $n$ be the number of qubits and $d=2^n$. Given a CNOT structure $ct$ and a vector of rotation angles $\theta$, the parametric circuit forms a matrix $Vct(\theta)\in SU(d)$. If we are given a target circuit forming a matrix $U\in SU(d)$, then we would like to compute
+
+$$
+\mathrm{argmax}_{\theta}\frac{1}{d}|\langle Vct(\theta),U\rangle|
+$$
+
+where the inner product is the Frobenius inner product. Note that $|\langle V,U\rangle|\leq d$ for all unitaries $U$ and $V$, so the objective has range in $[0,1]$.
+
+Our strategy is to maximize
+
+$$
+\frac{1}{d}\Re \langle Vct(\theta),U\rangle
+$$
+
+using its gradient. We will now discuss the specifics by going through an example.
+
+While the range of $Vct$ is a subset of $SU(d)$ by construction, the target circuit may form a general unitary matrix. However, for any $U\in U(d)$,
+
+$$
+\frac{\exp(2\pi i k/d)}{\det(U)^{1/d}}U\in SU(d)\text{ for all }k\in\{0,\ldots,d-1\}.
+$$
+
+Thus, we should normalize the target circuit by its global phase and then approximately compile the normalized circuit. We can add the global phase back in afterwards.
+
+In the algorithm let $U'$ denote the un-normalized target matrix and $U$ the normalized target matrix. Now that we have $U$, we give the gradient function to the Nesterov’s method optimizer and compute $\theta$.
+
+To add the global phase back in, we can form the control circuit as
+
+$$
+\frac{\langle Vct(\theta),U'\rangle}{|\langle Vct(\theta),U'\rangle|}Vct(\theta).
+$$
+
+Note that while we optimized using Nesterov’s method in the paper, this was for its convergence guarantees, not its speed in practice. It is much faster to use L-BFGS which is used as a default optimizer in this implementation.
+
+A basic usage of the AQC algorithm should consist of the following steps:
+
+```python
+# Define a target circuit as a unitary matrix
+unitary = ...
+
+# Define a number of qubits for the algorithm, at least 3 qubits
+num_qubits = int(round(np.log2(unitary.shape[0])))
+
+# Choose a layout of the CNOT structure for the approximate circuit, e.g. ``spin`` for
+# a linear layout.
+layout = options.get("layout") or "spin"
+
+# Choose a connectivity type, e.g. ``full`` for full connectivity between qubits.
+connectivity = options.get("connectivity") or "full"
+
+# Define a targeted depth of the approximate circuit in the number of CNOT units.
+depth = int(options.get("depth") or 0)
+
+# Generate a network made of CNOT units
+cnots = make_cnot_network(
+ num_qubits=num_qubits,
+ network_layout=layout,
+ connectivity_type=connectivity,
+ depth=depth
+)
+
+# Create an optimizer to be used by AQC
+optimizer = partial(scipy.optimize.minimize, method="L-BFGS-B")
+
+# Create an instance
+aqc = AQC(optimizer)
+
+# Create a template circuit that will approximate our target circuit
+approximate_circuit = CNOTUnitCircuit(num_qubits=num_qubits, cnots=cnots)
+
+# Create an objective that defines our optimization problem
+approximating_objective = DefaultCNOTUnitObjective(num_qubits=num_qubits, cnots=cnots)
+
+# Run optimization process to compile the unitary
+aqc.compile_unitary(
+ target_matrix=unitary,
+ approximate_circuit=approximate_circuit,
+ approximating_objective=approximating_objective
+)
+```
+
+Now `approximate_circuit` is a circuit that approximates the target unitary to a certain degree and can be used instead of the original matrix.
+
+This uses a helper function, [`make_cnot_network`](#qiskit.synthesis.unitary.aqc.make_cnot_network "qiskit.synthesis.unitary.aqc.make_cnot_network").
+
+### make\_cnot\_network
+
+
+
+`qiskit.synthesis.unitary.aqc.make_cnot_network(num_qubits, network_layout='spin', connectivity_type='full', depth=0)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/synthesis/unitary/aqc/cnot_structures.py "view source code")
+
+Generates a network consisting of building blocks each containing a CNOT gate and possibly some single-qubit ones. This network models a quantum operator in question. Note, each building block has 2 input and outputs corresponding to a pair of qubits. What we actually return here is a chain of indices of qubit pairs shared by every building block in a row.
+
+**Parameters**
+
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – number of qubits.
+* **network\_layout** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – type of network geometry, `{"sequ", "spin", "cart", "cyclic_spin", "cyclic_line"}`.
+* **connectivity\_type** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – type of inter-qubit connectivity, `{"full", "line", "star"}`.
+* **depth** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – depth of the CNOT-network, i.e. the number of layers, where each layer consists of a single CNOT-block; default value will be selected, if `L <= 0`.
+
+**Returns**
+
+**A matrix of size `(2, N)` matrix that defines layers in cnot-network, where `N`**
+
+is either equal `L`, or defined by a concrete type of the network.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – if unsupported type of CNOT-network layout or number of qubits or combination of parameters are passed.
+
+**Return type**
+
+[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v1.26)")
+
+One can take advantage of accelerated version of objective function. It implements the same mathematical algorithm as the default one `DefaultCNOTUnitObjective` but runs several times faster. Instantiation of accelerated objective function class is similar to the default case:
+
+> \# Create an objective that defines our optimization problem approximating\_objective = FastCNOTUnitObjective(num\_qubits=num\_qubits, cnots=cnots)
+
+The rest of the code in the above example does not change.
+
+**References**
+
+**\[1]: Liam Madden, Andrea Simonetto, Best Approximate Quantum Compiling Problems.**
+
+[arXiv:2106.05649](https://arxiv.org/abs/2106.05649)
+
diff --git a/docs/api/qiskit/0.46/tools.md b/docs/api/qiskit/0.46/tools.md
new file mode 100644
index 00000000000..185c0534fc5
--- /dev/null
+++ b/docs/api/qiskit/0.46/tools.md
@@ -0,0 +1,140 @@
+---
+title: tools
+description: API reference for qiskit.tools
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.tools
+---
+
+
+
+
+
+# Qiskit Tools
+
+
+
+`qiskit.tools`
+
+## Monitoring
+
+A helper module to get IBM backend information and submitted job status.
+
+### job\_monitor
+
+
+
+`qiskit.tools.job_monitor(job, interval=None, quiet=False, output=<_io.TextIOWrapper name='' mode='w' encoding='utf-8'>, line_discipline='\r')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/tools/monitor/job_monitor.py "view source code")
+
+Monitor the status of a IBMQJob instance.
+
+**Parameters**
+
+* **job** (*BaseJob*) – Job to monitor.
+* **interval** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Time interval between status queries.
+* **quiet** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If True, do not print status messages.
+* **output** (*file*) – The file like object to write status messages to.
+* **sys.stdout.** (*By default this is*) –
+* **line\_discipline** (*string*) – character emitted at start of a line of job monitor output,
+* **r.** (*This defaults to*) –
+
+**Examples**
+
+```python
+from qiskit import BasicAer, transpile
+from qiskit.circuit import QuantumCircuit
+from qiskit.tools.monitor import job_monitor
+sim_backend = BasicAer.get_backend("qasm_simulator")
+qc = QuantumCircuit(2, 2)
+qc.h(0)
+qc.cx(0, 1)
+qc.measure_all()
+tqc = transpile(qc, sim_backend)
+job_sim = sim_backend.run(tqc)
+job_monitor(job_sim)
+```
+
+### backend\_monitor
+
+
+
+`qiskit.tools.backend_monitor(backend)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/tools/monitor/overview.py "view source code")
+
+Monitor a single IBMQ backend.
+
+**Parameters**
+
+**backend** (*IBMQBackend*) – Backend to monitor.
+
+**Raises**
+
+* [**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – Input is not a IBMQ backend.
+* [**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – If qiskit-ibmq-provider is not installed
+
+Examples: .. code-block:: python
+
+> from qiskit.providers.ibmq import IBMQ from qiskit.tools.monitor import backend\_monitor provider = IBMQ.get\_provider(hub=’ibm-q’) backend\_monitor(provider.backends.ibmq\_lima)
+
+### backend\_overview
+
+
+
+`qiskit.tools.backend_overview()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/tools/monitor/overview.py "view source code")
+
+Gives overview information on all the IBMQ backends that are available.
+
+**Examples**
+
+```python
+from qiskit.providers.ibmq import IBMQ
+from qiskit.tools.monitor import backend_overview
+provider = IBMQ.get_provider(hub='ibm-q')
+backend_overview()
+```
+
+
+
+
+
+### Events ([`qiskit.tools.events`](#module-qiskit.tools.events "qiskit.tools.events"))
+
+A helper component for publishing and subscribing to events.
+
+
+
+`qiskit.tools.events.TextProgressBar(output_handler=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/tools/events/progressbar.py "view source code")
+
+A simple text-based progress bar.
+
+**output\_handlerthe handler the progress bar should be written to, default**
+
+is sys.stdout, another option is sys.stderr
+
+**Examples**
+
+The progress bar can be used to track the progress of a parallel\_map.
+
+```python
+import numpy as np
+import qiskit.tools.jupyter
+from qiskit.tools.parallel import parallel_map
+from qiskit.tools.events import TextProgressBar
+
+TextProgressBar()
+%qiskit_progress_bar -t text
+parallel_map(np.sin, np.linspace(0,10,100));
+```
+
+And it can also be used individually.
+
+```python
+from qiskit.tools.events import TextProgressBar
+
+iterations = 100
+t = TextProgressBar()
+t.start(iterations=iterations)
+for i in range(iterations):
+ # step i of heavy calculation ...
+ t.update(i + 1) # update progress bar
+```
+
diff --git a/docs/api/qiskit/0.46/tools_jupyter.md b/docs/api/qiskit/0.46/tools_jupyter.md
new file mode 100644
index 00000000000..d3b10441b51
--- /dev/null
+++ b/docs/api/qiskit/0.46/tools_jupyter.md
@@ -0,0 +1,86 @@
+---
+title: jupyter
+description: API reference for qiskit.tools.jupyter
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.tools.jupyter
+---
+
+
+
+
+
+
+
+# Jupyter Tools
+
+
+
+`qiskit.tools.jupyter`
+
+A Collection of Jupyter magic functions and tools that extend the functionality of Qiskit.
+
+## Overview of all available backends
+
+```python
+from qiskit.providers.ibmq import IBMQ
+import qiskit.tools.jupyter
+%matplotlib inline
+
+IBMQ.load_account()
+
+%qiskit_backend_overview
+```
+
+## Detailed information on a single backend
+
+```python
+from qiskit.providers.ibmq import IBMQ
+import qiskit.tools.jupyter
+%matplotlib inline
+
+IBMQ.load_account()
+provider = IBMQ.get_provider(hub='ibm-q')
+backend = provider.get_backend('ibmq_vigo')
+backend
+```
+
+## Load Qiskit Job Watcher
+
+```python
+import qiskit.tools.jupyter
+%qiskit_job_watcher
+```
+
+## HTMLProgressBar
+
+```python
+import numpy as np
+from qiskit.tools.parallel import parallel_map
+import qiskit.tools.jupyter
+
+%qiskit_progress_bar
+parallel_map(np.sin, np.linspace(0,10,100));
+```
+
+## Qiskit version table
+
+```python
+import qiskit.tools.jupyter
+%qiskit_version_table
+```
+
+## Qiskit copyright
+
+```python
+import qiskit.tools.jupyter
+%qiskit_copyright
+```
+
+## Monospaced output
+
+```python
+import qiskit.tools.jupyter
+%monospaced_output
+```
+
diff --git a/docs/api/qiskit/0.46/transpiler.md b/docs/api/qiskit/0.46/transpiler.md
new file mode 100644
index 00000000000..508bcf5e9a3
--- /dev/null
+++ b/docs/api/qiskit/0.46/transpiler.md
@@ -0,0 +1,980 @@
+---
+title: transpiler
+description: API reference for qiskit.transpiler
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.transpiler
+---
+
+
+
+
+
+
+
+# Transpiler
+
+
+
+`qiskit.transpiler`
+
+## Overview
+
+Transpilation is the process of rewriting a given input circuit to match the topology of a specific quantum device, and/or to optimize the circuit for execution on present day noisy quantum systems.
+
+Most circuits must undergo a series of transformations that make them compatible with a given target device, and optimize them to reduce the effects of noise on the resulting outcomes. Rewriting quantum circuits to match hardware constraints and optimizing for performance can be far from trivial. The flow of logic in the rewriting tool chain need not be linear, and can often have iterative sub-loops, conditional branches, and other complex behaviors. That being said, the standard compilation flow follows the structure given below:
+
+
+
+Qiskit has four pre-built transpilation pipelines available here: [`qiskit.transpiler.preset_passmanagers`](transpiler_preset#module-qiskit.transpiler.preset_passmanagers "qiskit.transpiler.preset_passmanagers"). Unless the reader is familiar with quantum circuit optimization methods and their usage, it is best to use one of these ready-made routines. By default the preset pass managers are composed of six stages:
+
+1. `init` - This stage runs any initial passes that are required before we start embedding the circuit to the backend. This typically involves unrolling custom instructions and converting the circuit to all 1 and 2 qubit gates.
+2. `layout` - This stage applies a layout, mapping the virtual qubits in the circuit to the physical qubits on a backend. See [Layout Stage](#layout-stage) for more details.
+3. `routing` - This stage runs after a layout has been applied and will inject gates (i.e. swaps) into the original circuit to make it compatible with the backend’s connectivity. See [Routing Stage](#routing-stage) for more details.
+4. `translation` - This stage translates the gates in the circuit to the target backend’s basis set. See [Translation Stage](#translation-stage) for more details.
+5. `optimization` - This stage runs the main optimization loop repeatedly until a condition (such as fixed depth) is reached. See [Optimization Stage](#optimization-stage) for more details.
+6. `scheduling` - This stage is for any hardware-aware scheduling passes. See [Scheduling Stage](#scheduling-stage) for more details.
+
+When using [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile"), the implementation of each stage can be modified with the `*_method` arguments (e.g. `layout_method`). These can be set to one of the built-in methods and can also refer to available external plugins. See [`qiskit.transpiler.preset_passmanagers.plugin`](transpiler_plugins#module-qiskit.transpiler.preset_passmanagers.plugin "qiskit.transpiler.preset_passmanagers.plugin") for details on this plugin interface.
+
+
+
+## Working with Preset Pass Managers
+
+Qiskit includes functions to build preset [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager") objects. These preset passmanagers are used by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function for each optimization level. There are 4 optimization levels ranging from 0 to 3, where higher optimization levels take more time and computational effort but may yield a more optimal circuit. Optimization level 0 is intended for device characterization experiments and, as such, only maps the input circuit to the constraints of the target backend, without performing any optimizations. Optimization level 3 spends the most effort to optimize the circuit. However, as many of the optimization techniques in the transpiler are heuristic based, spending more computational effort does not always result in an improvement in the quality of the output circuit.
+
+If you’d like to work directly with a preset pass manager you can use the [`generate_preset_pass_manager()`](transpiler_preset#qiskit.transpiler.preset_passmanagers.generate_preset_pass_manager "qiskit.transpiler.preset_passmanagers.generate_preset_pass_manager") function to easily generate one. For example:
+
+```python
+from qiskit.transpiler.preset_passmanagers import generate_preset_pass_manager
+from qiskit.providers.fake_provider import FakeLagosV2
+
+backend = FakeLagosV2()
+pass_manager = generate_preset_pass_manager(3, backend)
+```
+
+which will generate a [`StagedPassManager`](qiskit.transpiler.StagedPassManager "qiskit.transpiler.StagedPassManager") object for optimization level 3 targeting the [`FakeLagosV2`](qiskit.providers.fake_provider.FakeLagosV2 "qiskit.providers.fake_provider.FakeLagosV2") backend (equivalent to what is used internally by [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") with `backend=FakeLagosV2()` and `optimization_level=3`). You can use this just like you would any other [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager"). However, because it is a [`StagedPassManager`](qiskit.transpiler.StagedPassManager "qiskit.transpiler.StagedPassManager") it also makes it easy to compose and/or replace stages of the pipeline. For example, if you wanted to run a custom scheduling stage using dynamical decoupling (via the [`PadDynamicalDecoupling`](qiskit.transpiler.passes.PadDynamicalDecoupling "qiskit.transpiler.passes.PadDynamicalDecoupling") pass) and also add initial logical optimization prior to routing, you would do something like (building off the previous example):
+
+```python
+import numpy as np
+from qiskit.circuit.library import HGate, PhaseGate, RXGate, TdgGate, TGate, XGate
+from qiskit.transpiler import PassManager
+from qiskit.transpiler.passes import (
+ ALAPScheduleAnalysis,
+ CXCancellation,
+ InverseCancellation,
+ PadDynamicalDecoupling,
+)
+
+dd_sequence = [XGate(), XGate()]
+scheduling_pm = PassManager(
+ [
+ ALAPScheduleAnalysis(target=backend.target),
+ PadDynamicalDecoupling(target=backend.target, dd_sequence=dd_sequence),
+ ]
+)
+inverse_gate_list = [
+ HGate(),
+ (RXGate(np.pi / 4), RXGate(-np.pi / 4)),
+ (PhaseGate(np.pi / 4), PhaseGate(-np.pi / 4)),
+ (TGate(), TdgGate()),
+]
+logical_opt = PassManager(
+ [
+ CXCancellation(),
+ InverseCancellation(inverse_gate_list),
+ ]
+)
+
+
+# Add pre-layout stage to run extra logical optimization
+pass_manager.pre_layout = logical_opt
+# Set scheduling stage to custom pass manager
+pass_manager.scheduling = scheduling_pm
+```
+
+Now, when the staged pass manager is run via the [`run()`](qiskit.transpiler.StagedPassManager#run "qiskit.transpiler.StagedPassManager.run") method, the `logical_opt` pass manager will be called before the `layout` stage, and the `scheduling_pm` pass manager will be used for the `scheduling` stage instead of the default.
+
+## Custom Pass Managers
+
+In addition to modifying preset pass managers, it is also possible to construct a pass manager to build an entirely custom pipeline for transforming input circuits. You can use the [`StagedPassManager`](qiskit.transpiler.StagedPassManager "qiskit.transpiler.StagedPassManager") class directly to do this. You can define arbitrary stage names and populate them with a [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager") instance. For example, the following code creates a new [`StagedPassManager`](qiskit.transpiler.StagedPassManager "qiskit.transpiler.StagedPassManager") that has 2 stages, `init` and `translation`.:
+
+```python
+from qiskit.transpiler.passes import (
+ UnitarySynthesis,
+ Collect2qBlocks,
+ ConsolidateBlocks,
+ UnitarySynthesis,
+ Unroll3qOrMore,
+)
+from qiskit.transpiler import PassManager, StagedPassManager
+
+basis_gates = ["rx", "ry", "rxx"]
+init = PassManager([UnitarySynthesis(basis_gates, min_qubits=3), Unroll3qOrMore()])
+translate = PassManager(
+ [
+ Collect2qBlocks(),
+ ConsolidateBlocks(basis_gates=basis_gates),
+ UnitarySynthesis(basis_gates),
+ ]
+)
+
+staged_pm = StagedPassManager(
+ stages=["init", "translation"], init=init, translation=translate
+)
+```
+
+There is no limit on the number of stages you can put in a [`StagedPassManager`](qiskit.transpiler.StagedPassManager "qiskit.transpiler.StagedPassManager").
+
+The [Stage Generator Functions](transpiler_preset#stage-generators) may be useful for the construction of custom `generate_embed_passmanager` generates a [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager") to “embed” a selected initial [`Layout`](qiskit.transpiler.Layout "qiskit.transpiler.Layout") from a layout pass to the specified target device.
+
+## Representing Quantum Computers
+
+To be able to compile a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") for a specific backend, the transpiler needs a specialized representation of that backend, including its constraints, instruction set, qubit properties, and more, to be able to compile and optimize effectively. While the [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") class defines an interface for querying and interacting with backends, its scope is larger than just the transpiler’s needs including managing job submission and potentially interfacing with remote services. The specific information needed by the transpiler is described by the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") class
+
+For example, to construct a simple [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object, one can iteratively add descriptions of the instructions it supports:
+
+```python
+from qiskit.circuit import Parameter, Measure
+from qiskit.transpiler import Target, InstructionProperties
+from qiskit.circuit.library import UGate, RZGate, RXGate, RYGate, CXGate, CZGate
+
+target = Target(num_qubits=3)
+target.add_instruction(CXGate(), {(0, 1): InstructionProperties(error=.0001, duration=5e-7)})
+target.add_instruction(
+ UGate(Parameter('theta'), Parameter('phi'), Parameter('lam')),
+ {
+ (0,): InstructionProperties(error=.00001, duration=5e-8),
+ (1,): InstructionProperties(error=.00002, duration=6e-8)
+ }
+)
+target.add_instruction(
+ RZGate(Parameter('theta')),
+ {
+ (1,): InstructionProperties(error=.00001, duration=5e-8),
+ (2,): InstructionProperties(error=.00002, duration=6e-8)
+ }
+)
+target.add_instruction(
+ RYGate(Parameter('theta')),
+ {
+ (1,): InstructionProperties(error=.00001, duration=5e-8),
+ (2,): InstructionProperties(error=.00002, duration=6e-8)
+ }
+)
+target.add_instruction(
+ RXGate(Parameter('theta')),
+ {
+ (1,): InstructionProperties(error=.00001, duration=5e-8),
+ (2,): InstructionProperties(error=.00002, duration=6e-8)
+ }
+)
+target.add_instruction(
+ CZGate(),
+ {
+ (1, 2): InstructionProperties(error=.0001, duration=5e-7),
+ (2, 0): InstructionProperties(error=.0001, duration=5e-7)
+ }
+)
+target.add_instruction(
+ Measure(),
+ {
+ (0,): InstructionProperties(error=.001, duration=5e-5),
+ (1,): InstructionProperties(error=.002, duration=6e-5),
+ (2,): InstructionProperties(error=.2, duration=5e-7)
+ }
+)
+print(target)
+```
+
+```python
+Target
+Number of qubits: 3
+Instructions:
+ cx
+ (0, 1):
+ Duration: 5e-07 sec.
+ Error Rate: 0.0001
+ u
+ (0,):
+ Duration: 5e-08 sec.
+ Error Rate: 1e-05
+ (1,):
+ Duration: 6e-08 sec.
+ Error Rate: 2e-05
+ rz
+ (1,):
+ Duration: 5e-08 sec.
+ Error Rate: 1e-05
+ (2,):
+ Duration: 6e-08 sec.
+ Error Rate: 2e-05
+ ry
+ (1,):
+ Duration: 5e-08 sec.
+ Error Rate: 1e-05
+ (2,):
+ Duration: 6e-08 sec.
+ Error Rate: 2e-05
+ rx
+ (1,):
+ Duration: 5e-08 sec.
+ Error Rate: 1e-05
+ (2,):
+ Duration: 6e-08 sec.
+ Error Rate: 2e-05
+ cz
+ (1, 2):
+ Duration: 5e-07 sec.
+ Error Rate: 0.0001
+ (2, 0):
+ Duration: 5e-07 sec.
+ Error Rate: 0.0001
+ measure
+ (0,):
+ Duration: 5e-05 sec.
+ Error Rate: 0.001
+ (1,):
+ Duration: 6e-05 sec.
+ Error Rate: 0.002
+ (2,):
+ Duration: 5e-07 sec.
+ Error Rate: 0.2
+```
+
+This [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") represents a 3 qubit backend that supports [`CXGate`](qiskit.circuit.library.CXGate "qiskit.circuit.library.CXGate") between qubits 0 and 1, [`UGate`](qiskit.circuit.library.UGate "qiskit.circuit.library.UGate") on qubits 0 and 1, [`RZGate`](qiskit.circuit.library.RZGate "qiskit.circuit.library.RZGate"), [`RXGate`](qiskit.circuit.library.RXGate "qiskit.circuit.library.RXGate"), and [`RYGate`](qiskit.circuit.library.RYGate "qiskit.circuit.library.RYGate") on qubits 1 and 2, [`CZGate`](qiskit.circuit.library.CZGate "qiskit.circuit.library.CZGate") between qubits 1 and 2, and qubits 2 and 0, and [`Measure`](qiskit.circuit.library.Measure "qiskit.circuit.library.Measure") on all qubits.
+
+There are also specific data structures to represent a specific subset of information from the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target"). For example, the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") class is used to solely represent the connectivity constraints of a backend as a directed graph. A coupling map can be generated from a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") using the [`Target.build_coupling_map()`](qiskit.transpiler.Target#build_coupling_map "qiskit.transpiler.Target.build_coupling_map") method. These data structures typically pre-date the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") class but are still used by some transpiler passes that do not work natively with a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") instance yet or when dealing with backends that aren’t using the latest [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.BackendV2") interface.
+
+For example, if we wanted to visualize the [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") for the example 3 qubit [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") above:
+
+```python
+from qiskit.circuit import Parameter, Measure
+from qiskit.transpiler import Target, InstructionProperties
+from qiskit.circuit.library import UGate, RZGate, RXGate, RYGate, CXGate, CZGate
+
+target = Target(num_qubits=3)
+target.add_instruction(CXGate(), {(0, 1): InstructionProperties(error=.0001, duration=5e-7)})
+target.add_instruction(
+ UGate(Parameter('theta'), Parameter('phi'), Parameter('lam')),
+ {
+ (0,): InstructionProperties(error=.00001, duration=5e-8),
+ (1,): InstructionProperties(error=.00002, duration=6e-8)
+ }
+)
+target.add_instruction(
+ RZGate(Parameter('theta')),
+ {
+ (1,): InstructionProperties(error=.00001, duration=5e-8),
+ (2,): InstructionProperties(error=.00002, duration=6e-8)
+ }
+)
+target.add_instruction(
+ RYGate(Parameter('theta')),
+ {
+ (1,): InstructionProperties(error=.00001, duration=5e-8),
+ (2,): InstructionProperties(error=.00002, duration=6e-8)
+ }
+)
+target.add_instruction(
+ RXGate(Parameter('theta')),
+ {
+ (1,): InstructionProperties(error=.00001, duration=5e-8),
+ (2,): InstructionProperties(error=.00002, duration=6e-8)
+ }
+)
+target.add_instruction(
+ CZGate(),
+ {
+ (1, 2): InstructionProperties(error=.0001, duration=5e-7),
+ (2, 0): InstructionProperties(error=.0001, duration=5e-7)
+ }
+)
+target.add_instruction(
+ Measure(),
+ {
+ (0,): InstructionProperties(error=.001, duration=5e-5),
+ (1,): InstructionProperties(error=.002, duration=6e-5),
+ (2,): InstructionProperties(error=.2, duration=5e-7)
+ }
+)
+
+target.build_coupling_map().draw()
+```
+
+This shows the global connectivity of the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") which is the combination of the supported qubits for [`CXGate`](qiskit.circuit.library.CXGate "qiskit.circuit.library.CXGate") and [`CZGate`](qiskit.circuit.library.CZGate "qiskit.circuit.library.CZGate"). To see the individual connectivity, you can pass the operation name to `CouplingMap.build_coupling_map()`:
+
+```python
+from qiskit.circuit import Parameter, Measure
+from qiskit.transpiler import Target, InstructionProperties
+from qiskit.circuit.library import UGate, RZGate, RXGate, RYGate, CXGate, CZGate
+
+target = Target(num_qubits=3)
+target.add_instruction(CXGate(), {(0, 1): InstructionProperties(error=.0001, duration=5e-7)})
+target.add_instruction(
+ UGate(Parameter('theta'), Parameter('phi'), Parameter('lam')),
+ {
+ (0,): InstructionProperties(error=.00001, duration=5e-8),
+ (1,): InstructionProperties(error=.00002, duration=6e-8)
+ }
+)
+target.add_instruction(
+ RZGate(Parameter('theta')),
+ {
+ (1,): InstructionProperties(error=.00001, duration=5e-8),
+ (2,): InstructionProperties(error=.00002, duration=6e-8)
+ }
+)
+target.add_instruction(
+ RYGate(Parameter('theta')),
+ {
+ (1,): InstructionProperties(error=.00001, duration=5e-8),
+ (2,): InstructionProperties(error=.00002, duration=6e-8)
+ }
+)
+target.add_instruction(
+ RXGate(Parameter('theta')),
+ {
+ (1,): InstructionProperties(error=.00001, duration=5e-8),
+ (2,): InstructionProperties(error=.00002, duration=6e-8)
+ }
+)
+target.add_instruction(
+ CZGate(),
+ {
+ (1, 2): InstructionProperties(error=.0001, duration=5e-7),
+ (2, 0): InstructionProperties(error=.0001, duration=5e-7)
+ }
+)
+target.add_instruction(
+ Measure(),
+ {
+ (0,): InstructionProperties(error=.001, duration=5e-5),
+ (1,): InstructionProperties(error=.002, duration=6e-5),
+ (2,): InstructionProperties(error=.2, duration=5e-7)
+ }
+)
+
+target.build_coupling_map('cx').draw()
+```
+
+```python
+from qiskit.circuit import Parameter, Measure
+from qiskit.transpiler import Target, InstructionProperties
+from qiskit.circuit.library import UGate, RZGate, RXGate, RYGate, CXGate, CZGate
+
+target = Target(num_qubits=3)
+target.add_instruction(CXGate(), {(0, 1): InstructionProperties(error=.0001, duration=5e-7)})
+target.add_instruction(
+ UGate(Parameter('theta'), Parameter('phi'), Parameter('lam')),
+ {
+ (0,): InstructionProperties(error=.00001, duration=5e-8),
+ (1,): InstructionProperties(error=.00002, duration=6e-8)
+ }
+)
+target.add_instruction(
+ RZGate(Parameter('theta')),
+ {
+ (1,): InstructionProperties(error=.00001, duration=5e-8),
+ (2,): InstructionProperties(error=.00002, duration=6e-8)
+ }
+)
+target.add_instruction(
+ RYGate(Parameter('theta')),
+ {
+ (1,): InstructionProperties(error=.00001, duration=5e-8),
+ (2,): InstructionProperties(error=.00002, duration=6e-8)
+ }
+)
+target.add_instruction(
+ RXGate(Parameter('theta')),
+ {
+ (1,): InstructionProperties(error=.00001, duration=5e-8),
+ (2,): InstructionProperties(error=.00002, duration=6e-8)
+ }
+)
+target.add_instruction(
+ CZGate(),
+ {
+ (1, 2): InstructionProperties(error=.0001, duration=5e-7),
+ (2, 0): InstructionProperties(error=.0001, duration=5e-7)
+ }
+)
+target.add_instruction(
+ Measure(),
+ {
+ (0,): InstructionProperties(error=.001, duration=5e-5),
+ (1,): InstructionProperties(error=.002, duration=6e-5),
+ (2,): InstructionProperties(error=.2, duration=5e-7)
+ }
+)
+
+target.build_coupling_map('cz').draw()
+```
+
+
+
+## Transpiler Stage Details
+
+Below are a description of the default transpiler stages and the problems they solve. The default passes used for each stage are described, but the specifics are configurable via the `*_method` keyword arguments for the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") and [`generate_preset_pass_manager()`](transpiler_preset#qiskit.transpiler.preset_passmanagers.generate_preset_pass_manager "qiskit.transpiler.preset_passmanagers.generate_preset_pass_manager") functions which can be used to override the methods described in this section.
+
+
+
+### Translation Stage
+
+When writing a quantum circuit you are free to use any quantum gate (unitary operator) that you like, along with a collection of non-gate operations such as qubit measurements and reset operations. However, most quantum devices only natively support a handful of quantum gates and non-gate operations. The allowed instructions for a given backend can be found by querying the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") for the devices:
+
+```python
+from qiskit.providers.fake_provider import FakeVigoV2
+backend = FakeVigoV2()
+
+print(backend.target)
+```
+
+Every quantum circuit run on the target device must be expressed using only these instructions. For example, to run a simple phase estimation circuit:
+
+```python
+import numpy as np
+from qiskit import QuantumCircuit
+from qiskit.providers.fake_provider import FakeVigoV2
+
+backend = FakeVigoV2()
+
+qc = QuantumCircuit(2, 1)
+
+qc.h(0)
+qc.x(1)
+qc.cp(np.pi/4, 0, 1)
+qc.h(0)
+qc.measure([0], [0])
+qc.draw(output='mpl')
+```
+
+
+
+We have $H$, $X$, and controlled-$P$ gates, none of which are in our device’s basis gate set, and thus must be translated. This translation is taken care of for us in the `qiskit.execute()` function. However, we can transpile the circuit to show what it will look like in the native gate set of the target IBM Quantum device (the [`FakeVigoV2`](qiskit.providers.fake_provider.FakeVigoV2 "qiskit.providers.fake_provider.FakeVigoV2") backend is a fake backend that models the historical IBM Vigo 5 qubit device for test purposes):
+
+```python
+from qiskit import transpile
+from qiskit import QuantumCircuit
+from qiskit.providers.fake_provider import FakeVigoV2
+
+backend = FakeVigoV2()
+
+qc = QuantumCircuit(2, 1)
+
+qc.h(0)
+qc.x(1)
+qc.cp(np.pi/4, 0, 1)
+qc.h(0)
+qc.measure([0], [0])
+
+qc_basis = transpile(qc, backend)
+qc_basis.draw(output='mpl')
+```
+
+
+
+A few things to highlight. First, the circuit has gotten longer with respect to the original. This can be verified by checking the depth of both circuits:
+
+```python
+print('Original depth:', qc.depth(), 'Decomposed Depth:', qc_basis.depth())
+```
+
+```python
+Original depth: 4 Decomposed Depth: 10
+```
+
+Second, although we had a single controlled gate, the fact that it was not in the basis set means that, when expanded, it requires more than a single [`CXGate`](qiskit.circuit.library.CXGate "qiskit.circuit.library.CXGate") to implement. All said, unrolling to the basis set of gates leads to an increase in the depth of a quantum circuit and the number of gates.
+
+It is important to highlight two special cases:
+
+1. If A swap gate is not a native gate and must be decomposed this requires three CNOT gates:
+
+ ```python
+ from qiskit.providers.fake_provider import FakeVigoV2
+ backend = FakeVigoV2()
+
+ print(backend.operation_names)
+ ```
+
+ ```python
+ ['id', 'rz', 'sx', 'x', 'cx', 'measure', 'delay']
+ ```
+
+ As a product of three CNOT gates, swap gates are expensive operations to perform on noisy quantum devices. However, such operations are usually necessary for embedding a circuit into the limited gate connectivities of many devices. Thus, minimizing the number of swap gates in a circuit is a primary goal in the transpilation process.
+
+2. A Toffoli, or controlled-controlled-not gate (`ccx`), is a three-qubit gate. Given that our basis gate set includes only single- and two-qubit gates, it is obvious that this gate must be decomposed. This decomposition is quite costly:
+
+ ```python
+ from qiskit.circuit import QuantumCircuit
+
+ ccx_circ = QuantumCircuit(3)
+ ccx_circ.ccx(0, 1, 2)
+ ccx_circ.decompose().draw(output='mpl')
+ ```
+
+ 
+
+ For every Toffoli gate in a quantum circuit, the hardware may execute up to six CNOT gates, and a handful of single-qubit gates. From this example, it should be clear that any algorithm that makes use of multiple Toffoli gates will end up as a circuit with large depth and will therefore be appreciably affected by noise and gate errors.
+
+
+
+### Layout Stage
+
+Quantum circuits are abstract entities whose qubits are “virtual” representations of actual qubits used in computations. We need to be able to map these virtual qubits in a one-to-one manner to the “physical” qubits in an actual quantum device.
+
+
+
+By default, qiskit will do this mapping for you. The choice of mapping depends on the properties of the circuit, the particular device you are targeting, and the optimization level that is chosen. The choice of initial layout is extremely important for minimizing the number of swap operations needed to map the input circuit onto the device topology and for minimizing the loss due to non-uniform noise properties across a device. Due to the importance of this stage, the preset pass managers try a few different methods to find the best layout. Typically this involves 2 steps: first, trying to find a “perfect” layout (a layout which does not require any swap operations), and then, a heuristic pass that tries to find the best layout to use if a perfect layout cannot be found. There are 2 passes typically used for the first stage:
+
+* [`VF2Layout`](qiskit.transpiler.passes.VF2Layout "qiskit.transpiler.passes.VF2Layout"): Models layout selection as a subgraph isomorphism problem and tries to find a subgraph of the connectivity graph that is isomorphic to the graph of 2 qubit interactions in the circuit. If more than one isomorphic mapping is found a scoring heuristic is run to select the mapping which would result in the lowest average error when executing the circuit.
+* [`TrivialLayout`](qiskit.transpiler.passes.TrivialLayout "qiskit.transpiler.passes.TrivialLayout"): Maps each virtual qubit to the same numbered physical qubit on the device, i.e. `[0,1,2,3,4]` -> `[0,1,2,3,4]`. This is historical behavior used only in `optimization_level=1` to try to find a perfect layout. If it fails to do so, [`VF2Layout`](qiskit.transpiler.passes.VF2Layout "qiskit.transpiler.passes.VF2Layout") is tried next.
+
+Next, for the heuristic stage, 2 passes are used by default:
+
+* [`SabreLayout`](qiskit.transpiler.passes.SabreLayout "qiskit.transpiler.passes.SabreLayout"): Selects a layout by starting from an initial random layout and then repeatedly running a routing algorithm (by default [`SabreSwap`](qiskit.transpiler.passes.SabreSwap "qiskit.transpiler.passes.SabreSwap")) both forward and backward over the circuit, using the permutation caused by swap insertions to adjust that initial random layout. For more details you can refer to the paper describing the algorithm: [arXiv:1809.02573](https://arxiv.org/abs/1809.02573) [`SabreLayout`](qiskit.transpiler.passes.SabreLayout "qiskit.transpiler.passes.SabreLayout") is used to select a layout if a perfect layout isn’t found for optimization levels 1, 2, and 3.
+* [`TrivialLayout`](qiskit.transpiler.passes.TrivialLayout "qiskit.transpiler.passes.TrivialLayout"): Always used for the layout at optimization level 0.
+* [`DenseLayout`](qiskit.transpiler.passes.DenseLayout "qiskit.transpiler.passes.DenseLayout"): Finds the sub-graph of the device with greatest connectivity that has the same number of qubits as the circuit. Used for optimization level 1 if there are control flow operations (such as [`IfElseOp`](qiskit.circuit.IfElseOp "qiskit.circuit.IfElseOp")) present in the circuit.
+
+Let’s see what layouts are automatically picked at various optimization levels. The circuits returned by [`qiskit.compiler.transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") are annotated with this initial layout information, and we can view this layout selection graphically using [`qiskit.visualization.plot_circuit_layout()`](qiskit.visualization.plot_circuit_layout "qiskit.visualization.plot_circuit_layout"):
+
+```python
+from qiskit import QuantumCircuit, transpile
+from qiskit.visualization import plot_circuit_layout
+from qiskit.providers.fake_provider import FakeVigo
+backend = FakeVigo()
+
+ghz = QuantumCircuit(3, 3)
+ghz.h(0)
+ghz.cx(0,range(1,3))
+ghz.barrier()
+ghz.measure(range(3), range(3))
+ghz.draw(output='mpl')
+```
+
+
+
+* **Layout Using Optimization Level 0**
+
+ > ```python
+ > from qiskit import QuantumCircuit, transpile
+ > from qiskit.visualization import plot_circuit_layout
+ > from qiskit.providers.fake_provider import FakeVigo
+ > backend = FakeVigo()
+ >
+ > ghz = QuantumCircuit(3, 3)
+ > ghz.h(0)
+ > ghz.cx(0,range(1,3))
+ > ghz.barrier()
+ > ghz.measure(range(3), range(3))
+ >
+ > new_circ_lv0 = transpile(ghz, backend=backend, optimization_level=0)
+ > plot_circuit_layout(new_circ_lv0, backend)
+ > ```
+ >
+ > 
+
+* **Layout Using Optimization Level 3**
+
+ > ```python
+ > from qiskit import QuantumCircuit, transpile
+ > from qiskit.visualization import plot_circuit_layout
+ > from qiskit.providers.fake_provider import FakeVigo
+ > backend = FakeVigo()
+ >
+ > ghz = QuantumCircuit(3, 3)
+ > ghz.h(0)
+ > ghz.cx(0,range(1,3))
+ > ghz.barrier()
+ > ghz.measure(range(3), range(3))
+ >
+ > new_circ_lv3 = transpile(ghz, backend=backend, optimization_level=3)
+ > plot_circuit_layout(new_circ_lv3, backend)
+ > ```
+ >
+ > 
+
+It is possible to override automatic layout selection by specifying an initial layout. To do so we can pass a list of integers to [`qiskit.compiler.transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") via the initial\_layout keyword argument, where the index labels the virtual qubit in the circuit and the corresponding value is the label for the physical qubit to map onto:
+
+```python
+from qiskit import QuantumCircuit, transpile
+from qiskit.visualization import plot_circuit_layout
+from qiskit.providers.fake_provider import FakeVigo
+backend = FakeVigo()
+
+ghz = QuantumCircuit(3, 3)
+ghz.h(0)
+ghz.cx(0,range(1,3))
+ghz.barrier()
+ghz.measure(range(3), range(3))
+
+# Virtual -> physical
+# 0 -> 3
+# 1 -> 4
+# 2 -> 2
+
+my_ghz = transpile(ghz, backend, initial_layout=[3, 4, 2])
+plot_circuit_layout(my_ghz, backend)
+```
+
+
+
+
+
+### Routing Stage
+
+In order to implement a 2-qubit gate between qubits in a quantum circuit that are not directly connected on a quantum device, one or more swap gates must be inserted into the circuit to move the qubit states around until they are adjacent on the device gate map. Each swap gate typically represents an expensive and noisy operation to perform. Thus, finding the minimum number of swap gates needed to map a circuit onto a given device, is an important step (if not the most important) in the whole execution process.
+
+However, as with many important things in life, finding the optimal swap mapping is hard. In fact it is in a class of problems called NP-hard, and is thus prohibitively expensive to compute for all but the smallest quantum devices and input circuits. To get around this, by default Qiskit uses a stochastic heuristic algorithm called [`SabreSwap`](qiskit.transpiler.passes.SabreSwap "qiskit.transpiler.passes.SabreSwap") to compute a good, but not necessarily optimal swap mapping. The use of a stochastic method means the circuits generated by [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") (or [`execute()`](execute#qiskit.execute_function.execute "qiskit.execute_function.execute") that calls [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") internally) are not guaranteed to be the same over repeated runs. Indeed, running the same circuit repeatedly will in general result in a distribution of circuit depths and gate counts at the output.
+
+In order to highlight this, we run a GHZ circuit 100 times, using a “bad” (disconnected) initial\_layout:
+
+
+
+```python
+import matplotlib.pyplot as plt
+from qiskit import QuantumCircuit, transpile
+from qiskit.providers.fake_provider import FakeAuckland
+backend = FakeAuckland()
+
+ghz = QuantumCircuit(15)
+ghz.h(0)
+ghz.cx(0, range(1, 15))
+
+depths = []
+for _ in range(100):
+ depths.append(
+ transpile(
+ ghz,
+ backend,
+ layout_method='trivial' # Fixed layout mapped in circuit order
+ ).depth()
+ )
+
+plt.figure(figsize=(8, 6))
+plt.hist(depths, align='left', color='#AC557C')
+plt.xlabel('Depth', fontsize=14)
+plt.ylabel('Counts', fontsize=14);
+```
+
+
+
+This distribution is quite wide, signaling the difficulty the swap mapper is having in computing the best mapping. Most circuits will have a distribution of depths, perhaps not as wide as this one, due to the stochastic nature of the default swap mapper. Of course, we want the best circuit we can get, especially in cases where the depth is critical to success or failure. The [`SabreSwap`](qiskit.transpiler.passes.SabreSwap "qiskit.transpiler.passes.SabreSwap") pass will by default by run its algorithm in parallel with multiple seed values and select the output which uses the fewest swaps. If you would like to increase the number of trials [`SabreSwap`](qiskit.transpiler.passes.SabreSwap "qiskit.transpiler.passes.SabreSwap") runs you can refer to [Working with Preset Pass Managers](#working-with-preset-pass-managers) and modify the `routing` stage with a custom instance of [`SabreSwap`](qiskit.transpiler.passes.SabreSwap "qiskit.transpiler.passes.SabreSwap") with a larger value for the `trials` argument.
+
+Typically, following the swap mapper, the routing stage in the preset pass managers also includes running the [`VF2PostLayout`](qiskit.transpiler.passes.VF2PostLayout "qiskit.transpiler.passes.VF2PostLayout") pass. As its name implies, [`VF2PostLayout`](qiskit.transpiler.passes.VF2PostLayout "qiskit.transpiler.passes.VF2PostLayout") uses the same basic algorithm as [`VF2Layout`](qiskit.transpiler.passes.VF2Layout "qiskit.transpiler.passes.VF2Layout"), but instead of using it to find a perfect initial layout, it is designed to run after mapping and try to find a layout on qubits with lower error rates which will result in better output fidelity when running the circuit. The details of this algorithm are described in [arXiv:2209.15512](https://arxiv.org/abs/2209.15512).
+
+
+
+### Optimization Stage
+
+Decomposing quantum circuits into the basis gate set of the target device, and the addition of swap gates needed to match hardware topology, conspire to increase the depth and gate count of quantum circuits. Fortunately many routines for optimizing circuits by combining or eliminating gates exist. In some cases these methods are so effective the output circuits have lower depth than the inputs. In other cases, not much can be done, and the computation may be difficult to perform on noisy devices. Different gate optimizations are turned on with different `optimization_level` values. Below we show the benefits gained from setting the optimization level higher:
+
+
+ The output from [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") varies due to the stochastic swap mapper. So the numbers below will likely change each time you run the code.
+
+
+
+
+```python
+import matplotlib.pyplot as plt
+from qiskit import QuantumCircuit, transpile
+from qiskit.providers.fake_provider import FakeAuckland
+backend = FakeAuckland()
+
+ghz = QuantumCircuit(15)
+ghz.h(0)
+ghz.cx(0, range(1, 15))
+
+depths = []
+gate_counts = []
+non_local_gate_counts = []
+levels = [str(x) for x in range(4)]
+for level in range(4):
+ circ = transpile(ghz, backend, optimization_level=level)
+ depths.append(circ.depth())
+ gate_counts.append(sum(circ.count_ops().values()))
+ non_local_gate_counts.append(circ.num_nonlocal_gates())
+fig, (ax1, ax2) = plt.subplots(2, 1)
+ax1.bar(levels, depths, label='Depth')
+ax1.set_xlabel("Optimization Level")
+ax1.set_ylabel("Depth")
+ax1.set_title("Output Circuit Depth")
+ax2.bar(levels, gate_counts, label='Number of Circuit Operations')
+ax2.bar(levels, non_local_gate_counts, label='Number of non-local gates')
+ax2.set_xlabel("Optimization Level")
+ax2.set_ylabel("Number of gates")
+ax2.legend()
+ax2.set_title("Number of output circuit gates")
+fig.tight_layout()
+plt.show()
+```
+
+
+
+
+
+### Scheduling Stage
+
+After the circuit has been translated to the target basis, mapped to the device, and optimized, a scheduling phase can be applied to optionally account for all the idle time in the circuit. At a high level, the scheduling can be thought of as inserting delays into the circuit to account for idle time on the qubits between the execution of instructions. For example, if we start with a circuit such as:
+
+
+
+we can then call [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") on it with `scheduling_method` set:
+
+```python
+from qiskit import QuantumCircuit, transpile
+from qiskit.providers.fake_provider import FakeBoeblingen
+
+backend = FakeBoeblingen()
+
+ghz = QuantumCircuit(5)
+ghz.h(0)
+ghz.cx(0,range(1,5))
+
+circ = transpile(ghz, backend, scheduling_method="asap")
+circ.draw(output='mpl')
+```
+
+
+
+You can see here that the transpiler inserted [`Delay`](qiskit.circuit.Delay "qiskit.circuit.Delay") instructions to account for idle time on each qubit. To get a better idea of the timing of the circuit we can also look at it with the `timeline.draw()` function:
+
+
+
+The scheduling of a circuit involves two parts: analysis and constraint mapping, followed by a padding pass. The first part requires running a scheduling analysis pass such as `ALAPSchedulingAnalysis` or `ASAPSchedulingAnalysis` which analyzes the circuit and records the start time of each instruction in the circuit using a scheduling algorithm (“as late as possible” for `ALAPSchedulingAnalysis` and “as soon as possible” for `ASAPSchedulingAnalysis`) in the property set. Once the circuit has an initial scheduling, additional passes can be run to account for any timing constraints on the target backend, such as alignment constraints. This is typically done with the [`ConstrainedReschedule`](qiskit.transpiler.passes.ConstrainedReschedule "qiskit.transpiler.passes.ConstrainedReschedule") pass which will adjust the scheduling set in the property set to the constraints of the target backend. Once all the scheduling and adjustments/rescheduling are finished, a padding pass, such as [`PadDelay`](qiskit.transpiler.passes.PadDelay "qiskit.transpiler.passes.PadDelay") or [`PadDynamicalDecoupling`](qiskit.transpiler.passes.PadDynamicalDecoupling "qiskit.transpiler.passes.PadDynamicalDecoupling") is run to insert the instructions into the circuit, which completes the scheduling.
+
+#### Scheduling Analysis with control flow instructions
+
+When running scheduling analysis passes on a circuit, you must keep in mind that there are additional constraints on classical conditions and control flow instructions. This section covers the details of these additional constraints that any scheduling pass will need to account for.
+
+##### Topological node ordering in scheduling
+
+The DAG representation of `QuantumCircuit` respects the node ordering in the classical register wires, though theoretically two conditional instructions conditioned on the same register could commute, i.e. read-access to the classical register doesn’t change its state.
+
+```python
+qc = QuantumCircuit(2, 1)
+qc.delay(100, 0)
+qc.x(0).c_if(0, True)
+qc.x(1).c_if(0, True)
+```
+
+The scheduler SHOULD comply with the above topological ordering policy of the DAG circuit. Accordingly, the asap-scheduled circuit will become
+
+```python
+ ┌────────────────┐ ┌───┐
+q_0: ┤ Delay(100[dt]) ├───┤ X ├──────────────
+ ├────────────────┤ └─╥─┘ ┌───┐
+q_1: ┤ Delay(100[dt]) ├─────╫────────┤ X ├───
+ └────────────────┘ ║ └─╥─┘
+ ┌────╨────┐┌────╨────┐
+c: 1/══════════════════╡ c_0=0x1 ╞╡ c_0=0x1 ╞
+ └─────────┘└─────────┘
+```
+
+Note that this scheduling might be inefficient in some cases, because the second conditional operation could start without waiting for the 100 dt delay. However, any additional optimization should be done in a different pass, not to break the topological ordering of the original circuit.
+
+##### Realistic control flow scheduling (respecting microarchitecture)
+
+In the dispersive QND readout scheme, the qubit (Q) is measured by sending a microwave stimulus, followed by a resonator ring-down (depopulation). This microwave signal is recorded in the buffer memory (B) with the hardware kernel, then a discriminated (D) binary value is moved to the classical register (C). A sequence from t0 to t1 of the measure instruction interval could be modeled as follows:
+
+```python
+Q ░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░
+B ░░▒▒▒▒▒▒▒▒░░░░░░░░░
+D ░░░░░░░░░░▒▒▒▒▒▒░░░
+C ░░░░░░░░░░░░░░░░▒▒░
+```
+
+However, the [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") representation is not accurate enough to represent this model. In the circuit representation, the corresponding [`Qubit`](qiskit.circuit.Qubit "qiskit.circuit.Qubit") is occupied by the stimulus microwave signal during the first half of the interval, and the [`Clbit`](qiskit.circuit.Clbit "qiskit.circuit.Clbit") is only occupied at the very end of the interval.
+
+The lack of precision representing the physical model may induce edge cases in the scheduling:
+
+```python
+ ┌───┐
+q_0: ───┤ X ├──────
+ └─╥─┘ ┌─┐
+q_1: ─────╫─────┤M├
+ ┌────╨────┐└╥┘
+c: 1/╡ c_0=0x1 ╞═╩═
+ └─────────┘ 0
+```
+
+In this example, a user may intend to measure the state of `q_1` after the [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.library.XGate") is applied to `q_0`. This is the correct interpretation from the viewpoint of topological node ordering, i.e. The [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.library.XGate") node comes in front of the [`Measure`](qiskit.circuit.library.Measure "qiskit.circuit.library.Measure") node. However, according to the measurement model above, the data in the register is unchanged during the application of the stimulus, so two nodes are simultaneously operated. If one tries to alap-schedule this circuit, it may return following circuit:
+
+```python
+ ┌────────────────┐ ┌───┐
+q_0: ┤ Delay(500[dt]) ├───┤ X ├──────
+ └────────────────┘ └─╥─┘ ┌─┐
+q_1: ───────────────────────╫─────┤M├
+ ┌────╨────┐└╥┘
+c: 1/══════════════════╡ c_0=0x1 ╞═╩═
+ └─────────┘ 0
+```
+
+Note that there is no delay on the `q_1` wire, and the measure instruction immediately starts after t=0, while the conditional gate starts after the delay. It looks like the topological ordering between the nodes is flipped in the scheduled view. This behavior can be understood by considering the control flow model described above,
+
+```python
+: Quantum Circuit, first-measure
+0 ░░░░░░░░░░░░▒▒▒▒▒▒░
+1 ░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░
+
+: In wire q0
+Q ░░░░░░░░░░░░░░░▒▒▒░
+C ░░░░░░░░░░░░▒▒░░░░░
+
+: In wire q1
+Q ░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░
+B ░░▒▒▒▒▒▒▒▒░░░░░░░░░
+D ░░░░░░░░░░▒▒▒▒▒▒░░░
+C ░░░░░░░░░░░░░░░░▒▒░
+```
+
+Since there is no qubit register overlap between Q0 and Q1, the node ordering is determined by the shared classical register C. As you can see, the execution order is still preserved on C, i.e. read C then apply `XGate`, finally store the measured outcome in C. But because `DAGOpNode` cannot define different durations for the associated registers, the time ordering of the two nodes is inverted.
+
+This behavior can be controlled by `clbit_write_latency` and `conditional_latency`. `clbit_write_latency` determines the delay of the register write-access from the beginning of the measure instruction (t0), while `conditional_latency` determines the delay of conditional gate operations with respect to t0, which is determined by the register read-access. This information is accessible in the backend configuration and should be copied to the pass manager property set before the pass is called.
+
+Due to default latencies, the alap-scheduled circuit of above example may become
+
+```python
+ ┌───┐
+q_0: ───┤ X ├──────
+ └─╥─┘ ┌─┐
+q_1: ─────╫─────┤M├
+ ┌────╨────┐└╥┘
+c: 1/╡ c_0=0x1 ╞═╩═
+ └─────────┘ 0
+```
+
+If the backend microarchitecture supports smart scheduling of the control flow instructions, such as separately scheduling qubits and classical registers, the insertion of the delay yields an unnecessarily longer total execution time.
+
+```python
+: Quantum Circuit, first-XGate
+0 ░▒▒▒░░░░░░░░░░░░░░░
+1 ░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░
+
+: In wire q0
+Q ░▒▒▒░░░░░░░░░░░░░░░
+C ░░░░░░░░░░░░░░░░░░░ (zero latency)
+
+: In wire q1
+Q ░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░
+C ░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░ (zero latency, scheduled after C0 read-access)
+```
+
+However, this result is much more intuitive in the topological ordering view. If a finite conditional latency value is provided, for example, 30 dt, the circuit is scheduled as follows:
+
+```python
+ ┌───────────────┐ ┌───┐
+q_0: ┤ Delay(30[dt]) ├───┤ X ├──────
+ ├───────────────┤ └─╥─┘ ┌─┐
+q_1: ┤ Delay(30[dt]) ├─────╫─────┤M├
+ └───────────────┘┌────╨────┐└╥┘
+c: 1/═════════════════╡ c_0=0x1 ╞═╩═
+ └─────────┘ 0
+```
+
+with the timing model:
+
+```python
+: Quantum Circuit, first-xgate
+0 ░░▒▒▒░░░░░░░░░░░░░░░
+1 ░░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░
+
+: In wire q0
+Q ░░▒▒▒░░░░░░░░░░░░░░░
+C ░▒░░░░░░░░░░░░░░░░░░ (30dt latency)
+
+: In wire q1
+Q ░░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░
+C ░░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░
+```
+
+See [https://arxiv.org/abs/2102.01682](https://arxiv.org/abs/2102.01682) for more details.
+
+## Transpiler API
+
+### Transpiler Target
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target")(\[description, num\_qubits, dt, ...]) | The intent of the `Target` object is to inform Qiskit's compiler about the constraints of a particular backend so the compiler can compile an input circuit to something that works and is optimized for a device. |
+| [`InstructionProperties`](qiskit.transpiler.InstructionProperties "qiskit.transpiler.InstructionProperties")(\[duration, error, ...]) | A representation of the properties of a gate implementation. |
+
+### Pass Manager Construction
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
+| [`StagedPassManager`](qiskit.transpiler.StagedPassManager "qiskit.transpiler.StagedPassManager")(\[stages]) | A pass manager pipeline built from individual stages. |
+| [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager")(\[passes, max\_iteration]) | Manager for a set of Passes and their scheduling during transpilation. |
+| [`PassManagerConfig`](qiskit.transpiler.PassManagerConfig "qiskit.transpiler.PassManagerConfig")(\[initial\_layout, ...]) | Pass Manager Configuration. |
+
+### Layout and Topology
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------ |
+| [`Layout`](qiskit.transpiler.Layout "qiskit.transpiler.Layout")(\[input\_dict]) | Two-ways dict to represent a Layout. |
+| [`CouplingMap`](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")(\[couplinglist, description]) | Directed graph specifying fixed coupling. |
+| [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout")(initial\_layout, ...\[, ...]) | Layout attributes from output circuit from transpiler. |
+
+### Scheduling
+
+| | |
+| ---------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
+| [`InstructionDurations`](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations")(\[instruction\_durations, dt]) | Helper class to provide durations of instructions for scheduling. |
+
+### Fenced Objects
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
+| [`FencedPropertySet`](qiskit.transpiler.FencedPropertySet "qiskit.transpiler.FencedPropertySet")(property\_set\_instance) | A property set that cannot be written (via \_\_setitem\_\_) |
+| [`FencedDAGCircuit`](qiskit.transpiler.FencedDAGCircuit "qiskit.transpiler.FencedDAGCircuit")(dag\_circuit\_instance) | A dag circuit that cannot be modified (via remove\_op\_node) |
+
+### Abstract Passes
+
+| | |
+| ----------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
+| [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.TransformationPass")(\*args, \*\*kwargs) | A transformation pass: change DAG, not property set. |
+| [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.AnalysisPass")(\*args, \*\*kwargs) | An analysis pass: change property set, not DAG. |
+
+### Exceptions
+
+### TranspilerError
+
+
+
+`qiskit.transpiler.TranspilerError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/exceptions.py "view source code")
+
+Exceptions raised during transpilation.
+
+Set the error message.
+
+### TranspilerAccessError
+
+
+
+`qiskit.transpiler.TranspilerAccessError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/exceptions.py "view source code")
+
+DEPRECATED: Exception of access error in the transpiler passes.
+
+Set the error message.
+
+### CouplingError
+
+
+
+`qiskit.transpiler.CouplingError(*msg)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/exceptions.py "view source code")
+
+Base class for errors raised by the coupling graph object.
+
+Set the error message.
+
+### LayoutError
+
+
+
+`qiskit.transpiler.LayoutError(*msg)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/exceptions.py "view source code")
+
+Errors raised by the layout object.
+
+Set the error message.
+
diff --git a/docs/api/qiskit/0.46/transpiler_builtin_plugins.md b/docs/api/qiskit/0.46/transpiler_builtin_plugins.md
new file mode 100644
index 00000000000..c5595272581
--- /dev/null
+++ b/docs/api/qiskit/0.46/transpiler_builtin_plugins.md
@@ -0,0 +1,8 @@
+
+
+# Built-in Transpiler Synthesis Plugins
+
+* [Approximate Quantum Compiler (`qiskit.synthesis.unitary.aqc`)](synthesis_aqc)
+
+ * [Interface](synthesis_aqc#interface)
+ * [Mathematical Detail](synthesis_aqc#mathematical-detail)
diff --git a/docs/api/qiskit/0.46/transpiler_passes.md b/docs/api/qiskit/0.46/transpiler_passes.md
new file mode 100644
index 00000000000..186692598c3
--- /dev/null
+++ b/docs/api/qiskit/0.46/transpiler_passes.md
@@ -0,0 +1,162 @@
+---
+title: passes
+description: API reference for qiskit.transpiler.passes
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.transpiler.passes
+---
+
+
+
+
+
+
+
+# Transpiler Passes
+
+
+
+`qiskit.transpiler.passes`
+
+## Layout Selection (Placement)
+
+| | |
+| ---------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| [`SetLayout`](qiskit.transpiler.passes.SetLayout "qiskit.transpiler.passes.SetLayout")(\*args, \*\*kwargs) | Set the `layout` property to the given layout. |
+| [`TrivialLayout`](qiskit.transpiler.passes.TrivialLayout "qiskit.transpiler.passes.TrivialLayout")(\*args, \*\*kwargs) | Choose a Layout by assigning `n` circuit qubits to device qubits `0, .., n-1`. |
+| [`DenseLayout`](qiskit.transpiler.passes.DenseLayout "qiskit.transpiler.passes.DenseLayout")(\*args, \*\*kwargs) | Choose a Layout by finding the most connected subset of qubits. |
+| [`NoiseAdaptiveLayout`](qiskit.transpiler.passes.NoiseAdaptiveLayout "qiskit.transpiler.passes.NoiseAdaptiveLayout")(\*args, \*\*kwargs) | Choose a noise-adaptive Layout based on current calibration data for the backend. |
+| [`SabreLayout`](qiskit.transpiler.passes.SabreLayout "qiskit.transpiler.passes.SabreLayout")(\*args, \*\*kwargs) | Choose a Layout via iterative bidirectional routing of the input circuit. |
+| [`CSPLayout`](qiskit.transpiler.passes.CSPLayout "qiskit.transpiler.passes.CSPLayout")(\*args, \*\*kwargs) | If possible, chooses a Layout as a CSP, using backtracking. |
+| [`VF2Layout`](qiskit.transpiler.passes.VF2Layout "qiskit.transpiler.passes.VF2Layout")(\*args, \*\*kwargs) | A pass for choosing a Layout of a circuit onto a Coupling graph, as a subgraph isomorphism problem, solved by VF2++. |
+| [`ApplyLayout`](qiskit.transpiler.passes.ApplyLayout "qiskit.transpiler.passes.ApplyLayout")(\*args, \*\*kwargs) | Transform a circuit with virtual qubits into a circuit with physical qubits. |
+| [`Layout2qDistance`](qiskit.transpiler.passes.Layout2qDistance "qiskit.transpiler.passes.Layout2qDistance")(\*args, \*\*kwargs) | Evaluate how good the layout selection was. |
+| [`EnlargeWithAncilla`](qiskit.transpiler.passes.EnlargeWithAncilla "qiskit.transpiler.passes.EnlargeWithAncilla")(\*args, \*\*kwargs) | Extend the dag with virtual qubits that are in layout but not in the circuit yet. |
+| [`FullAncillaAllocation`](qiskit.transpiler.passes.FullAncillaAllocation "qiskit.transpiler.passes.FullAncillaAllocation")(\*args, \*\*kwargs) | Allocate all idle nodes from the coupling map or target as ancilla on the layout. |
+| [`SabrePreLayout`](qiskit.transpiler.passes.SabrePreLayout "qiskit.transpiler.passes.SabrePreLayout")(\*args, \*\*kwargs) | Choose a starting layout to use for additional Sabre layout trials. |
+
+## Routing
+
+| | |
+| ---------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
+| [`BasicSwap`](qiskit.transpiler.passes.BasicSwap "qiskit.transpiler.passes.BasicSwap")(\*args, \*\*kwargs) | Map (with minimum effort) a DAGCircuit onto a `coupling_map` adding swap gates. |
+| [`LookaheadSwap`](qiskit.transpiler.passes.LookaheadSwap "qiskit.transpiler.passes.LookaheadSwap")(\*args, \*\*kwargs) | Map input circuit onto a backend topology via insertion of SWAPs. |
+| [`StochasticSwap`](qiskit.transpiler.passes.StochasticSwap "qiskit.transpiler.passes.StochasticSwap")(\*args, \*\*kwargs) | Map a DAGCircuit onto a coupling\_map adding swap gates. |
+| [`SabreSwap`](qiskit.transpiler.passes.SabreSwap "qiskit.transpiler.passes.SabreSwap")(\*args, \*\*kwargs) | Map input circuit onto a backend topology via insertion of SWAPs. |
+| [`Commuting2qGateRouter`](qiskit.transpiler.passes.Commuting2qGateRouter "qiskit.transpiler.passes.Commuting2qGateRouter")(\*args, \*\*kwargs) | A class to swap route one or more commuting gates to the coupling map. |
+
+## Basis Change
+
+| | |
+| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
+| [`BasisTranslator`](qiskit.transpiler.passes.BasisTranslator "qiskit.transpiler.passes.BasisTranslator")(\*args, \*\*kwargs) | Translates gates to a target basis by searching for a set of translations from a given EquivalenceLibrary. |
+| [`Decompose`](qiskit.transpiler.passes.Decompose "qiskit.transpiler.passes.Decompose")(\*args, \*\*kwargs) | Expand a gate in a circuit using its decomposition rules. |
+| [`TranslateParameterizedGates`](qiskit.transpiler.passes.TranslateParameterizedGates "qiskit.transpiler.passes.TranslateParameterizedGates")(\*args, \*\*kwargs) | Translate parameterized gates to a supported basis set. |
+| [`Unroll3qOrMore`](qiskit.transpiler.passes.Unroll3qOrMore "qiskit.transpiler.passes.Unroll3qOrMore")(\*args, \*\*kwargs) | Recursively expands 3q+ gates until the circuit only contains 2q or 1q gates. |
+| [`UnrollCustomDefinitions`](qiskit.transpiler.passes.UnrollCustomDefinitions "qiskit.transpiler.passes.UnrollCustomDefinitions")(\*args, \*\*kwargs) | Unrolls instructions with custom definitions. |
+| [`Unroller`](qiskit.transpiler.passes.Unroller "qiskit.transpiler.passes.Unroller")(\*args, \*\*kwargs) | Unroll a circuit to a given basis. |
+
+## Optimizations
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`Optimize1qGates`](qiskit.transpiler.passes.Optimize1qGates "qiskit.transpiler.passes.Optimize1qGates")(\*args, \*\*kwargs) | Optimize chains of single-qubit u1, u2, u3 gates by combining them into a single gate. |
+| [`Optimize1qGatesDecomposition`](qiskit.transpiler.passes.Optimize1qGatesDecomposition "qiskit.transpiler.passes.Optimize1qGatesDecomposition")(\*args, \*\*kwargs) | Optimize chains of single-qubit gates by combining them into a single gate. |
+| [`Collect1qRuns`](qiskit.transpiler.passes.Collect1qRuns "qiskit.transpiler.passes.Collect1qRuns")(\*args, \*\*kwargs) | Collect one-qubit subcircuits. |
+| [`Collect2qBlocks`](qiskit.transpiler.passes.Collect2qBlocks "qiskit.transpiler.passes.Collect2qBlocks")(\*args, \*\*kwargs) | Collect two-qubit subcircuits. |
+| [`CollectMultiQBlocks`](qiskit.transpiler.passes.CollectMultiQBlocks "qiskit.transpiler.passes.CollectMultiQBlocks")(\*args, \*\*kwargs) | Collect sequences of uninterrupted gates acting on groups of qubits. |
+| [`CollectLinearFunctions`](qiskit.transpiler.passes.CollectLinearFunctions "qiskit.transpiler.passes.CollectLinearFunctions")(\*args, \*\*kwargs) | Collect blocks of linear gates ([`CXGate`](qiskit.circuit.library.CXGate "qiskit.circuit.library.CXGate") and [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate") gates) and replaces them by linear functions ([`LinearFunction`](qiskit.circuit.library.LinearFunction "qiskit.circuit.library.LinearFunction")). |
+| [`CollectCliffords`](qiskit.transpiler.passes.CollectCliffords "qiskit.transpiler.passes.CollectCliffords")(\*args, \*\*kwargs) | Collects blocks of Clifford gates and replaces them by a [`Clifford`](qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford") object. |
+| [`ConsolidateBlocks`](qiskit.transpiler.passes.ConsolidateBlocks "qiskit.transpiler.passes.ConsolidateBlocks")(\*args, \*\*kwargs) | Replace each block of consecutive gates by a single Unitary node. |
+| [`CXCancellation`](qiskit.transpiler.passes.CXCancellation "qiskit.transpiler.passes.CXCancellation")(\*args, \*\*kwargs) | Cancel back-to-back `cx` gates in dag. |
+| [`InverseCancellation`](qiskit.transpiler.passes.InverseCancellation "qiskit.transpiler.passes.InverseCancellation")(\*args, \*\*kwargs) | Cancel specific Gates which are inverses of each other when they occur back-to- back. |
+| [`CommutationAnalysis`](qiskit.transpiler.passes.CommutationAnalysis "qiskit.transpiler.passes.CommutationAnalysis")(\*args, \*\*kwargs) | Analysis pass to find commutation relations between DAG nodes. |
+| [`CommutativeCancellation`](qiskit.transpiler.passes.CommutativeCancellation "qiskit.transpiler.passes.CommutativeCancellation")(\*args, \*\*kwargs) | Cancel the redundant (self-adjoint) gates through commutation relations. |
+| [`CommutativeInverseCancellation`](qiskit.transpiler.passes.CommutativeInverseCancellation "qiskit.transpiler.passes.CommutativeInverseCancellation")(\*args, \*\*kwargs) | Cancel pairs of inverse gates exploiting commutation relations. |
+| [`Optimize1qGatesSimpleCommutation`](qiskit.transpiler.passes.Optimize1qGatesSimpleCommutation "qiskit.transpiler.passes.Optimize1qGatesSimpleCommutation")(\*args, \*\*kwargs) | Optimizes 1Q gate strings interrupted by 2Q gates by commuting the components and resynthesizing the results. |
+| [`RemoveDiagonalGatesBeforeMeasure`](qiskit.transpiler.passes.RemoveDiagonalGatesBeforeMeasure "qiskit.transpiler.passes.RemoveDiagonalGatesBeforeMeasure")(\*args, \*\*kwargs) | Remove diagonal gates (including diagonal 2Q gates) before a measurement. |
+| [`RemoveResetInZeroState`](qiskit.transpiler.passes.RemoveResetInZeroState "qiskit.transpiler.passes.RemoveResetInZeroState")(\*args, \*\*kwargs) | Remove reset gate when the qubit is in zero state. |
+| [`CrosstalkAdaptiveSchedule`](qiskit.transpiler.passes.CrosstalkAdaptiveSchedule "qiskit.transpiler.passes.CrosstalkAdaptiveSchedule")(\*args, \*\*kwargs) | Crosstalk mitigation through adaptive instruction scheduling. |
+| [`HoareOptimizer`](qiskit.transpiler.passes.HoareOptimizer "qiskit.transpiler.passes.HoareOptimizer")(\*args, \*\*kwargs) | This is a transpiler pass using Hoare logic circuit optimization. |
+| [`TemplateOptimization`](qiskit.transpiler.passes.TemplateOptimization "qiskit.transpiler.passes.TemplateOptimization")(\*args, \*\*kwargs) | Class for the template optimization pass. |
+| [`EchoRZXWeylDecomposition`](qiskit.transpiler.passes.EchoRZXWeylDecomposition "qiskit.transpiler.passes.EchoRZXWeylDecomposition")(\*args, \*\*kwargs) | Rewrite two-qubit gates using the Weyl decomposition. |
+| [`ResetAfterMeasureSimplification`](qiskit.transpiler.passes.ResetAfterMeasureSimplification "qiskit.transpiler.passes.ResetAfterMeasureSimplification")(\*args, \*\*kwargs) | This pass replaces reset after measure with a conditional X gate. |
+| [`OptimizeCliffords`](qiskit.transpiler.passes.OptimizeCliffords "qiskit.transpiler.passes.OptimizeCliffords")(\*args, \*\*kwargs) | Combine consecutive Cliffords over the same qubits. |
+| [`NormalizeRXAngle`](qiskit.transpiler.passes.NormalizeRXAngle "qiskit.transpiler.passes.NormalizeRXAngle")(\*args, \*\*kwargs) | Normalize theta parameter of RXGate instruction. |
+
+## Calibration
+
+| | |
+| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
+| [`PulseGates`](qiskit.transpiler.passes.PulseGates "qiskit.transpiler.passes.PulseGates")(\*args, \*\*kwargs) | Pulse gate adding pass. |
+| [`RZXCalibrationBuilder`](qiskit.transpiler.passes.RZXCalibrationBuilder "qiskit.transpiler.passes.RZXCalibrationBuilder")(\*args, \*\*kwargs) | Creates calibrations for RZXGate(theta) by stretching and compressing Gaussian square pulses in the CX gate. |
+| [`RZXCalibrationBuilderNoEcho`](qiskit.transpiler.passes.RZXCalibrationBuilderNoEcho "qiskit.transpiler.passes.RZXCalibrationBuilderNoEcho")(\*args, \*\*kwargs) | Creates calibrations for RZXGate(theta) by stretching and compressing Gaussian square pulses in the CX gate. |
+| [`RXCalibrationBuilder`](qiskit.transpiler.passes.RXCalibrationBuilder "qiskit.transpiler.passes.RXCalibrationBuilder")(\*args, \*\*kwargs) | Add single-pulse RX calibrations that are bootstrapped from the SX calibration. |
+
+## Scheduling
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| [`TimeUnitConversion`](qiskit.transpiler.passes.TimeUnitConversion "qiskit.transpiler.passes.TimeUnitConversion")(\*args, \*\*kwargs) | Choose a time unit to be used in the following time-aware passes, and make all circuit time units consistent with that. |
+| [`ALAPScheduleAnalysis`](qiskit.transpiler.passes.ALAPScheduleAnalysis "qiskit.transpiler.passes.ALAPScheduleAnalysis")(\*args, \*\*kwargs) | ALAP Scheduling pass, which schedules the **stop** time of instructions as late as possible. |
+| [`ASAPScheduleAnalysis`](qiskit.transpiler.passes.ASAPScheduleAnalysis "qiskit.transpiler.passes.ASAPScheduleAnalysis")(\*args, \*\*kwargs) | ASAP Scheduling pass, which schedules the start time of instructions as early as possible. |
+| [`PadDynamicalDecoupling`](qiskit.transpiler.passes.PadDynamicalDecoupling "qiskit.transpiler.passes.PadDynamicalDecoupling")(\*args, \*\*kwargs) | Dynamical decoupling insertion pass. |
+| [`PadDelay`](qiskit.transpiler.passes.PadDelay "qiskit.transpiler.passes.PadDelay")(\*args, \*\*kwargs) | Padding idle time with Delay instructions. |
+| [`ConstrainedReschedule`](qiskit.transpiler.passes.ConstrainedReschedule "qiskit.transpiler.passes.ConstrainedReschedule")(\*args, \*\*kwargs) | Rescheduler pass that updates node start times to conform to the hardware alignments. |
+| [`ValidatePulseGates`](qiskit.transpiler.passes.ValidatePulseGates "qiskit.transpiler.passes.ValidatePulseGates")(\*args, \*\*kwargs) | Check custom gate length. |
+| [`InstructionDurationCheck`](qiskit.transpiler.passes.InstructionDurationCheck "qiskit.transpiler.passes.InstructionDurationCheck")(\*args, \*\*kwargs) | Duration validation pass for reschedule. |
+| [`SetIOLatency`](qiskit.transpiler.passes.SetIOLatency "qiskit.transpiler.passes.SetIOLatency")(\*args, \*\*kwargs) | Set IOLatency information to the input circuit. |
+| [`ALAPSchedule`](qiskit.transpiler.passes.ALAPSchedule "qiskit.transpiler.passes.ALAPSchedule")(\*args, \*\*kwargs) | ALAP Scheduling pass, which schedules the **stop** time of instructions as late as possible. |
+| [`ASAPSchedule`](qiskit.transpiler.passes.ASAPSchedule "qiskit.transpiler.passes.ASAPSchedule")(\*args, \*\*kwargs) | ASAP Scheduling pass, which schedules the start time of instructions as early as possible.. |
+| [`DynamicalDecoupling`](qiskit.transpiler.passes.DynamicalDecoupling "qiskit.transpiler.passes.DynamicalDecoupling")(\*args, \*\*kwargs) | Dynamical decoupling insertion pass. |
+| [`AlignMeasures`](qiskit.transpiler.passes.AlignMeasures "qiskit.transpiler.passes.AlignMeasures")(\*args, \*\*kwargs) | Measurement alignment. |
+
+## Circuit Analysis
+
+| | |
+| ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`Width`](qiskit.transpiler.passes.Width "qiskit.transpiler.passes.Width")(\*args, \*\*kwargs) | Calculate the width of a DAG circuit. |
+| [`Depth`](qiskit.transpiler.passes.Depth "qiskit.transpiler.passes.Depth")(\*args, \*\*kwargs) | Calculate the depth of a DAG circuit. |
+| [`Size`](qiskit.transpiler.passes.Size "qiskit.transpiler.passes.Size")(\*args, \*\*kwargs) | Calculate the size of a DAG circuit. |
+| [`CountOps`](qiskit.transpiler.passes.CountOps "qiskit.transpiler.passes.CountOps")(\*args, \*\*kwargs) | Count the operations in a DAG circuit. |
+| [`CountOpsLongestPath`](qiskit.transpiler.passes.CountOpsLongestPath "qiskit.transpiler.passes.CountOpsLongestPath")(\*args, \*\*kwargs) | Count the operations on the longest path in a [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit"). |
+| [`NumTensorFactors`](qiskit.transpiler.passes.NumTensorFactors "qiskit.transpiler.passes.NumTensorFactors")(\*args, \*\*kwargs) | Calculate the number of tensor factors of a DAG circuit. |
+| [`DAGLongestPath`](qiskit.transpiler.passes.DAGLongestPath "qiskit.transpiler.passes.DAGLongestPath")(\*args, \*\*kwargs) | Return the longest path in a [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") as a list of [`DAGOpNode`](qiskit.dagcircuit.DAGOpNode "qiskit.dagcircuit.DAGOpNode")s, [`DAGInNode`](qiskit.dagcircuit.DAGInNode "qiskit.dagcircuit.DAGInNode")s, and [`DAGOutNode`](qiskit.dagcircuit.DAGOutNode "qiskit.dagcircuit.DAGOutNode")s. |
+
+## Synthesis
+
+| | |
+| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| [`UnitarySynthesis`](qiskit.transpiler.passes.UnitarySynthesis "qiskit.transpiler.passes.UnitarySynthesis")(\*args, \*\*kwargs) | Synthesize gates according to their basis gates. |
+| [`LinearFunctionsSynthesis`](qiskit.transpiler.passes.LinearFunctionsSynthesis "qiskit.transpiler.passes.LinearFunctionsSynthesis")(\*args, \*\*kwargs) | DEPRECATED: Synthesize linear functions. |
+| [`LinearFunctionsToPermutations`](qiskit.transpiler.passes.LinearFunctionsToPermutations "qiskit.transpiler.passes.LinearFunctionsToPermutations")(\*args, \*\*kwargs) | Promotes linear functions to permutations when possible. |
+| [`HighLevelSynthesis`](qiskit.transpiler.passes.HighLevelSynthesis "qiskit.transpiler.passes.HighLevelSynthesis")(\*args, \*\*kwargs) | Synthesize higher-level objects and unroll custom definitions. |
+| [`SolovayKitaev`](qiskit.transpiler.passes.SolovayKitaev "qiskit.transpiler.passes.SolovayKitaev")(\*args, \*\*kwargs) | Approximately decompose 1q gates to a discrete basis using the Solovay-Kitaev algorithm. |
+| [`SolovayKitaevSynthesis`](qiskit.transpiler.passes.SolovayKitaevSynthesis "qiskit.transpiler.passes.SolovayKitaevSynthesis")() | A Solovay-Kitaev Qiskit unitary synthesis plugin. |
+| [`AQCSynthesisPlugin`](qiskit.transpiler.passes.AQCSynthesisPlugin "qiskit.transpiler.passes.AQCSynthesisPlugin")() | An AQC-based Qiskit unitary synthesis plugin. |
+
+## Post Layout (Post transpile qubit selection)
+
+| | |
+| ---------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| [`VF2PostLayout`](qiskit.transpiler.passes.VF2PostLayout "qiskit.transpiler.passes.VF2PostLayout")(\*args, \*\*kwargs) | A pass for choosing a Layout after transpilation of a circuit onto a Coupling graph, as a subgraph isomorphism problem, solved by VF2++. |
+
+## Additional Passes
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
+| [`CheckMap`](qiskit.transpiler.passes.CheckMap "qiskit.transpiler.passes.CheckMap")(\*args, \*\*kwargs) | Check if a DAG circuit is already mapped to a coupling map. |
+| [`CheckGateDirection`](qiskit.transpiler.passes.CheckGateDirection "qiskit.transpiler.passes.CheckGateDirection")(\*args, \*\*kwargs) | Check if the two-qubit gates follow the right direction with respect to the coupling map. |
+| [`GateDirection`](qiskit.transpiler.passes.GateDirection "qiskit.transpiler.passes.GateDirection")(\*args, \*\*kwargs) | Modify asymmetric gates to match the hardware coupling direction. |
+| [`MergeAdjacentBarriers`](qiskit.transpiler.passes.MergeAdjacentBarriers "qiskit.transpiler.passes.MergeAdjacentBarriers")(\*args, \*\*kwargs) | Return a circuit with any adjacent barriers merged together. |
+| [`RemoveBarriers`](qiskit.transpiler.passes.RemoveBarriers "qiskit.transpiler.passes.RemoveBarriers")(\*args, \*\*kwargs) | Return a circuit with any barrier removed. |
+| [`BarrierBeforeFinalMeasurements`](qiskit.transpiler.passes.BarrierBeforeFinalMeasurements "qiskit.transpiler.passes.BarrierBeforeFinalMeasurements")(\*args, \*\*kwargs) | Add a barrier before final measurements. |
+| [`RemoveFinalMeasurements`](qiskit.transpiler.passes.RemoveFinalMeasurements "qiskit.transpiler.passes.RemoveFinalMeasurements")(\*args, \*\*kwargs) | Remove final measurements and barriers at the end of a circuit. |
+| [`DAGFixedPoint`](qiskit.transpiler.passes.DAGFixedPoint "qiskit.transpiler.passes.DAGFixedPoint")(\*args, \*\*kwargs) | Check if the DAG has reached a fixed point. |
+| [`FixedPoint`](qiskit.transpiler.passes.FixedPoint "qiskit.transpiler.passes.FixedPoint")(\*args, \*\*kwargs) | Check if a property reached a fixed point. |
+| [`MinimumPoint`](qiskit.transpiler.passes.MinimumPoint "qiskit.transpiler.passes.MinimumPoint")(\*args, \*\*kwargs) | Check if the DAG has reached a relative semi-stable point over previous runs |
+| [`ContainsInstruction`](qiskit.transpiler.passes.ContainsInstruction "qiskit.transpiler.passes.ContainsInstruction")(\*args, \*\*kwargs) | An analysis pass to detect if the DAG contains a specific instruction. |
+| [`GatesInBasis`](qiskit.transpiler.passes.GatesInBasis "qiskit.transpiler.passes.GatesInBasis")(\*args, \*\*kwargs) | Check if all gates in a DAG are in a given set of gates |
+| [`ConvertConditionsToIfOps`](qiskit.transpiler.passes.ConvertConditionsToIfOps "qiskit.transpiler.passes.ConvertConditionsToIfOps")(\*args, \*\*kwargs) | Convert instructions whose `condition` attribute is set to a non-`None` value into the equivalent single-statement `IfElseBlock`. |
+| [`UnrollForLoops`](qiskit.transpiler.passes.UnrollForLoops "qiskit.transpiler.passes.UnrollForLoops")(\*args, \*\*kwargs) | `UnrollForLoops` transpilation pass unrolls for-loops when possible. |
+
diff --git a/docs/api/qiskit/0.46/transpiler_plugins.md b/docs/api/qiskit/0.46/transpiler_plugins.md
new file mode 100644
index 00000000000..8a999a278ca
--- /dev/null
+++ b/docs/api/qiskit/0.46/transpiler_plugins.md
@@ -0,0 +1,170 @@
+---
+title: plugin
+description: API reference for qiskit.transpiler.preset_passmanagers.plugin
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.transpiler.preset_passmanagers.plugin
+---
+
+
+
+
+
+
+
+# Transpiler Stage Plugin Interface
+
+
+
+`qiskit.transpiler.preset_passmanagers.plugin`
+
+This module defines the plugin interface for providing custom stage implementations for the preset pass managers and the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function. This enables external Python packages to provide [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager") objects that can be used for each named stage.
+
+The plugin interfaces are built using setuptools [entry points](https://setuptools.readthedocs.io/en/latest/userguide/entry_point.html) which enable packages external to Qiskit to advertise they include a transpiler stage(s).
+
+For details on how to instead write plugins for transpiler synthesis methods, see [`qiskit.transpiler.passes.synthesis.plugin`](transpiler_synthesis_plugins#module-qiskit.transpiler.passes.synthesis.plugin "qiskit.transpiler.passes.synthesis.plugin").
+
+
+
+## Plugin Stages
+
+Currently, there are 6 stages in the preset pass managers, all of which actively load external plugins via corresponding entry points.
+
+| Stage Name | Entry Point | Reserved Names | Description and expectations |
+| -------------- | -------------------------------- | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `init` | `qiskit.transpiler.init` | `default` | This stage runs first and is typically used for any initial logical optimization. Because most layout and routing algorithms are only designed to work with 1 and 2 qubit gates, this stage is also used to translate any gates that operate on more than 2 qubits into gates that only operate on 1 or 2 qubits. |
+| `layout` | `qiskit.transpiler.layout` | `trivial`, `dense`, `noise_adaptive`, `sabre`, `default` | The output from this stage is expected to have the `layout` property set field set with a [`Layout`](qiskit.transpiler.Layout "qiskit.transpiler.Layout") object. Additionally, the circuit is typically expected to be embedded so that it is expanded to include all qubits and the [`ApplyLayout`](qiskit.transpiler.passes.ApplyLayout "qiskit.transpiler.passes.ApplyLayout") pass is expected to be run to apply the layout. The embedding of the [`Layout`](qiskit.transpiler.Layout "qiskit.transpiler.Layout") can be generated with [`generate_embed_passmanager()`](transpiler_preset#qiskit.transpiler.preset_passmanagers.common.generate_embed_passmanager "qiskit.transpiler.preset_passmanagers.common.generate_embed_passmanager"). |
+| `routing` | `qiskit.transpiler.routing` | `basic`, `stochastic`, `lookahead`, `sabre`, `toqm` | The output from this stage is expected to have the circuit match the connectivity constraints of the target backend. This does not necessarily need to match the directionality of the edges in the target as a later stage typically will adjust directional gates to match that constraint (but there is no penalty for doing that in the `routing` stage). |
+| `translation` | `qiskit.transpiler.translation` | `translator`, `synthesis`, `unroller` | **The output of this stage is expected to have every operation be a native**instruction on the target backend. |
+| `optimization` | `qiskit.transpiler.optimization` | `default` | This stage is expected to perform optimization and simplification. The constraints from earlier stages still apply to the output of this stage. After the `optimization` stage is run we expect the circuit to still be executable on the target. |
+| `scheduling` | `qiskit.transpiler.scheduling` | `alap`, `asap`, `default` | This is the last stage run and it is expected to output a scheduled circuit such that all idle periods in the circuit are marked by explicit [`Delay`](qiskit.circuit.Delay "qiskit.circuit.Delay") instructions. |
+
+## Writing Plugins
+
+To write a pass manager stage plugin there are 2 main steps. The first step is to create a subclass of the abstract plugin class [`PassManagerStagePlugin`](qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePlugin "qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePlugin") which is used to define how the [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager") for the stage will be constructed. For example, to create a `layout` stage plugin that just runs [`VF2Layout`](qiskit.transpiler.passes.VF2Layout "qiskit.transpiler.passes.VF2Layout") (with increasing amount of trials, depending on the optimization level) and falls back to using [`TrivialLayout`](qiskit.transpiler.passes.TrivialLayout "qiskit.transpiler.passes.TrivialLayout") if `VF2Layout` is unable to find a perfect layout:
+
+```python
+from qiskit.transpiler.preset_passmanagers.plugin import PassManagerStagePlugin
+from qiskit.transpiler.preset_passmanagers import common
+from qiskit.transpiler import PassManager
+from qiskit.transpiler.passes import VF2Layout, TrivialLayout
+from qiskit.transpiler.passes.layout.vf2_layout import VF2LayoutStopReason
+
+
+def _vf2_match_not_found(property_set):
+ return property_set["layout"] is None or (
+ property_set["VF2Layout_stop_reason"] is not None
+ and property_set["VF2Layout_stop_reason"] is not VF2LayoutStopReason.SOLUTION_FOUND
+
+
+class VF2LayoutPlugin(PassManagerStagePlugin):
+
+ def pass_manager(self, pass_manager_config, optimization_level):
+ layout_pm = PassManager(
+ [
+ VF2Layout(
+ coupling_map=pass_manager_config.coupling_map,
+ properties=pass_manager_config.backend_properties,
+ max_trials=optimization_level * 10 + 1
+ target=pass_manager_config.target
+ )
+ ]
+ )
+ layout_pm.append(
+ TrivialLayout(pass_manager_config.coupling_map),
+ condition=_vf2_match_not_found,
+ )
+ layout_pm += common.generate_embed_passmanager(pass_manager_config.coupling_map)
+ return layout_pm
+```
+
+The second step is to expose the [`PassManagerStagePlugin`](qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePlugin "qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePlugin") subclass as a setuptools entry point in the package metadata. This can be done by simply adding an `entry_points` entry to the `setuptools.setup` call in the `setup.py` or the plugin package with the necessary entry points under the appropriate namespace for the stage your plugin is for. You can see the list of stages, entry points, and expectations from the stage in [Plugin Stages](#stage-table). For example, continuing from the example plugin above:
+
+```python
+entry_points = {
+ 'qiskit.transpiler.layout': [
+ 'vf2 = qiskit_plugin_pkg.module.plugin:VF2LayoutPlugin',
+ ]
+},
+```
+
+Note that the entry point `name = path` is a single string not a Python expression. There isn’t a limit to the number of plugins a single package can include as long as each plugin has a unique name. So a single package can expose multiple plugins if necessary. Refer to [Plugin Stages](#stage-table) for a list of reserved names for each stage.
+
+## Plugin API
+
+| | |
+| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`PassManagerStagePlugin`](qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePlugin "qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePlugin")() | A `PassManagerStagePlugin` is a plugin interface object for using custom stages in [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile"). |
+| [`PassManagerStagePluginManager`](qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePluginManager "qiskit.transpiler.preset_passmanagers.plugin.PassManagerStagePluginManager")() | Manager class for preset pass manager stage plugins. |
+
+### list\_stage\_plugins
+
+
+
+`qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins(stage_name)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/preset_passmanagers/plugin.py "view source code")
+
+Get a list of installed plugins for a stage.
+
+**Parameters**
+
+**stage\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The stage name to get the plugin names for
+
+**Returns**
+
+The list of installed plugin names for the specified stages
+
+**Return type**
+
+plugins
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – If an invalid stage name is specified.
+
+### passmanager\_stage\_plugins
+
+
+
+`qiskit.transpiler.preset_passmanagers.plugin.passmanager_stage_plugins(stage)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/preset_passmanagers/plugin.py "view source code")
+
+Return a dict with, for each stage name, the class type of the plugin.
+
+This function is useful for getting more information about a plugin:
+
+```python
+from qiskit.transpiler.preset_passmanagers.plugin import passmanager_stage_plugins
+routing_plugins = passmanager_stage_plugins('routing')
+basic_plugin = routing_plugins['basic']
+help(basic_plugin)
+```
+
+```python
+Help on BasicSwapPassManager in module ...preset_passmanagers.builtin_plugins object:
+
+class BasicSwapPassManager(...preset_passmanagers.plugin.PassManagerStagePlugin)
+ | Plugin class for routing stage with :class:`~.BasicSwap`
+ |
+ | Method resolution order:
+ | BasicSwapPassManager
+ | ...preset_passmanagers.plugin.PassManagerStagePlugin
+ | abc.ABC
+ | builtins.object
+ ...
+```
+
+**Parameters**
+
+**stage** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The stage name to get
+
+**Returns**
+
+the key is the name of the plugin and the value is the class type for each.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – If an invalid stage name is specified.
+
diff --git a/docs/api/qiskit/0.46/transpiler_preset.md b/docs/api/qiskit/0.46/transpiler_preset.md
new file mode 100644
index 00000000000..06e2c6b6741
--- /dev/null
+++ b/docs/api/qiskit/0.46/transpiler_preset.md
@@ -0,0 +1,398 @@
+---
+title: preset_passmanagers
+description: API reference for qiskit.transpiler.preset_passmanagers
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.transpiler.preset_passmanagers
+---
+
+
+
+
+
+
+
+# Preset Passmanagers
+
+
+
+`qiskit.transpiler.preset_passmanagers`
+
+This module contains functions for generating the preset pass managers for the transpiler. The preset pass managers are instances of [`StagedPassManager`](qiskit.transpiler.StagedPassManager "qiskit.transpiler.StagedPassManager") which are used to execute the circuit transformations as part of Qiskit’s compiler inside the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function at the different optimization levels. The functionality here is divided into two parts, the first includes the functions used generate the entire pass manager which is used by [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") ([Preset Pass Manager Generation](#preset-pass-manager-generators)) and the second includes functions which are used to build (either entirely or in part) the stages which the preset pass managers are composed of ([Stage Generator Functions](#stage-generators)).
+
+
+
+## Preset Pass Manager Generation
+
+### generate\_preset\_pass\_manager
+
+
+
+`qiskit.transpiler.preset_passmanagers.generate_preset_pass_manager(optimization_level, backend=None, target=None, basis_gates=None, inst_map=None, coupling_map=None, instruction_durations=None, backend_properties=None, timing_constraints=None, initial_layout=None, layout_method=None, routing_method=None, translation_method=None, scheduling_method=None, approximation_degree=None, seed_transpiler=None, unitary_synthesis_method='default', unitary_synthesis_plugin_config=None, hls_config=None, init_method=None, optimization_method=None, *, _skip_target=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/preset_passmanagers/__init__.py "view source code")
+
+Generate a preset [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager")
+
+This function is used to quickly generate a preset pass manager. A preset pass manager are the default pass managers used by the [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function. This function provides a convenient and simple method to construct a standalone [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager") object that mirrors what the transpile
+
+**Parameters**
+
+* **optimization\_level** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) –
+
+ The optimization level to generate a [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager") for. This can be 0, 1, 2, or 3. Higher levels generate more optimized circuits, at the expense of longer transpilation time:
+
+ > * 0: no optimization
+ > * 1: light optimization
+ > * 2: heavy optimization
+ > * 3: even heavier optimization
+
+* **backend** ([*Backend*](qiskit.providers.Backend "qiskit.providers.Backend")) – An optional backend object which can be used as the source of the default values for the `basis_gates`, `inst_map`, `couplig_map`, `backend_properties`, `instruction_durations`, `timing_constraints`, and `target`. If any of those other arguments are specified in addition to `backend` they will take precedence over the value contained in the backend.
+
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – The [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") representing a backend compilation target. The following attributes will be inferred from this argument if they are not set: `coupling_map`, `basis_gates`, `instruction_durations`, `inst_map`, `timing_constraints` and `backend_properties`.
+
+* **basis\_gates** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – List of basis gate names to unroll to (e.g: `['u1', 'u2', 'u3', 'cx']`).
+
+* **inst\_map** ([*InstructionScheduleMap*](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap")) – Mapping object that maps gate to schedules. If any user defined calibration is found in the map and this is used in a circuit, transpiler attaches the custom gate definition to the circuit. This enables one to flexibly override the low-level instruction implementation.
+
+* **coupling\_map** ([*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")) – Directed graph represented a coupling map.
+
+* **instruction\_durations** ([*InstructionDurations*](qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations")) – Dictionary of duration (in dt) for each instruction.
+
+* **timing\_constraints** (*TimingConstraints*) – Hardware time alignment restrictions.
+
+* **initial\_layout** ([*Layout*](qiskit.transpiler.Layout "qiskit.transpiler.Layout")) – Initial position of virtual qubits on physical qubits.
+
+* **layout\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The `Pass` to use for choosing initial qubit placement. Valid choices are `'trivial'`, `'dense'`, `'noise_adaptive'`, and, `'sabre'` representing [`TrivialLayout`](qiskit.transpiler.passes.TrivialLayout "qiskit.transpiler.passes.TrivialLayout"), `DenseLayout`, [`NoiseAdaptiveLayout`](qiskit.transpiler.passes.NoiseAdaptiveLayout "qiskit.transpiler.passes.NoiseAdaptiveLayout"), [`SabreLayout`](qiskit.transpiler.passes.SabreLayout "qiskit.transpiler.passes.SabreLayout") respectively. This can also be the external plugin name to use for the `layout` stage of the output [`StagedPassManager`](qiskit.transpiler.StagedPassManager "qiskit.transpiler.StagedPassManager"). You can see a list of installed plugins by using [`list_stage_plugins()`](transpiler_plugins#qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins "qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins") with `"layout"` for the `stage_name` argument.
+
+* **routing\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The pass to use for routing qubits on the architecture. Valid choices are `'basic'`, `'lookahead'`, `'stochastic'`, `'sabre'`, and `'none'` representing [`BasicSwap`](qiskit.transpiler.passes.BasicSwap "qiskit.transpiler.passes.BasicSwap"), [`LookaheadSwap`](qiskit.transpiler.passes.LookaheadSwap "qiskit.transpiler.passes.LookaheadSwap"), [`StochasticSwap`](qiskit.transpiler.passes.StochasticSwap "qiskit.transpiler.passes.StochasticSwap"), [`SabreSwap`](qiskit.transpiler.passes.SabreSwap "qiskit.transpiler.passes.SabreSwap"), and erroring if routing is required respectively. This can also be the external plugin name to use for the `routing` stage of the output [`StagedPassManager`](qiskit.transpiler.StagedPassManager "qiskit.transpiler.StagedPassManager"). You can see a list of installed plugins by using [`list_stage_plugins()`](transpiler_plugins#qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins "qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins") with `"routing"` for the `stage_name` argument.
+
+* **translation\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The method to use for translating gates to basis gates. Valid choices `'unroller'`, `'translator'`, `'synthesis'` representing [`Unroller`](qiskit.transpiler.passes.Unroller "qiskit.transpiler.passes.Unroller"), [`BasisTranslator`](qiskit.transpiler.passes.BasisTranslator "qiskit.transpiler.passes.BasisTranslator"), and [`UnitarySynthesis`](qiskit.transpiler.passes.UnitarySynthesis "qiskit.transpiler.passes.UnitarySynthesis") respectively. This can also be the external plugin name to use for the `translation` stage of the output [`StagedPassManager`](qiskit.transpiler.StagedPassManager "qiskit.transpiler.StagedPassManager"). You can see a list of installed plugins by using [`list_stage_plugins()`](transpiler_plugins#qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins "qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins") with `"translation"` for the `stage_name` argument.
+
+* **scheduling\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The pass to use for scheduling instructions. Valid choices are `'alap'` and `'asap'`. This can also be the external plugin name to use for the `scheduling` stage of the output [`StagedPassManager`](qiskit.transpiler.StagedPassManager "qiskit.transpiler.StagedPassManager"). You can see a list of installed plugins by using [`list_stage_plugins()`](transpiler_plugins#qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins "qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins") with `"scheduling"` for the `stage_name` argument.
+
+* **backend\_properties** ([*BackendProperties*](qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties")) – Properties returned by a backend, including information on gate errors, readout errors, qubit coherence times, etc.
+
+* **approximation\_degree** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Heuristic dial used for circuit approximation (1.0=no approximation, 0.0=maximal approximation).
+
+* **seed\_transpiler** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Sets random seed for the stochastic parts of the transpiler.
+
+* **unitary\_synthesis\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the unitary synthesis method to use. By default `'default'` is used. You can see a list of installed plugins with [`unitary_synthesis_plugin_names()`](qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names "qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names").
+
+* **unitary\_synthesis\_plugin\_config** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – An optional configuration dictionary that will be passed directly to the unitary synthesis plugin. By default this setting will have no effect as the default unitary synthesis method does not take custom configuration. This should only be necessary when a unitary synthesis plugin is specified with the `unitary_synthesis` argument. As this is custom for each unitary synthesis plugin refer to the plugin documentation for how to use this option.
+
+* **hls\_config** (*HLSConfig*) – An optional configuration class `HLSConfig` that will be passed directly to [`HighLevelSynthesis`](qiskit.transpiler.passes.HighLevelSynthesis "qiskit.transpiler.passes.HighLevelSynthesis") transformation pass. This configuration class allows to specify for various high-level objects the lists of synthesis algorithms and their parameters.
+
+* **init\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The plugin name to use for the `init` stage of the output [`StagedPassManager`](qiskit.transpiler.StagedPassManager "qiskit.transpiler.StagedPassManager"). By default an external plugin is not used. You can see a list of installed plugins by using [`list_stage_plugins()`](transpiler_plugins#qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins "qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins") with `"init"` for the stage name argument.
+
+* **optimization\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The plugin name to use for the `optimization` stage of the output [`StagedPassManager`](qiskit.transpiler.StagedPassManager "qiskit.transpiler.StagedPassManager"). By default an external plugin is not used. You can see a list of installed plugins by using [`list_stage_plugins()`](transpiler_plugins#qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins "qiskit.transpiler.preset_passmanagers.plugin.list_stage_plugins") with `"optimization"` for the `stage_name` argument.
+
+**Returns**
+
+The preset pass manager for the given options
+
+**Return type**
+
+[StagedPassManager](qiskit.transpiler.StagedPassManager "qiskit.transpiler.StagedPassManager")
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – if an invalid value for `optimization_level` is passed in.
+
+### level\_0\_pass\_manager
+
+
+
+`qiskit.transpiler.preset_passmanagers.level_0_pass_manager(pass_manager_config)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/preset_passmanagers/level0.py "view source code")
+
+Level 0 pass manager: no explicit optimization other than mapping to backend.
+
+This pass manager applies the user-given initial layout. If none is given, a trivial layout consisting of mapping the i-th virtual qubit to the i-th physical qubit is used. Any unused physical qubit is allocated as ancilla space.
+
+The pass manager then unrolls the circuit to the desired basis, and transforms the circuit to match the coupling map.
+
+**Parameters**
+
+**pass\_manager\_config** ([*PassManagerConfig*](qiskit.transpiler.PassManagerConfig "qiskit.transpiler.passmanager_config.PassManagerConfig")) – configuration of the pass manager.
+
+**Returns**
+
+a level 0 pass manager.
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if the passmanager config is invalid.
+
+**Return type**
+
+[*StagedPassManager*](qiskit.transpiler.StagedPassManager "qiskit.transpiler.passmanager.StagedPassManager")
+
+### level\_1\_pass\_manager
+
+
+
+`qiskit.transpiler.preset_passmanagers.level_1_pass_manager(pass_manager_config)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/preset_passmanagers/level1.py "view source code")
+
+Level 1 pass manager: light optimization by simple adjacent gate collapsing.
+
+This pass manager applies the user-given initial layout. If none is given, and a trivial layout (i-th virtual -> i-th physical) makes the circuit fit the coupling map, that is used. Otherwise, the circuit is mapped to the most densely connected coupling subgraph, and swaps are inserted to map. Any unused physical qubit is allocated as ancilla space. The pass manager then unrolls the circuit to the desired basis, and transforms the circuit to match the coupling map. Finally, optimizations in the form of adjacent gate collapse and redundant reset removal are performed.
+
+**Parameters**
+
+**pass\_manager\_config** ([*PassManagerConfig*](qiskit.transpiler.PassManagerConfig "qiskit.transpiler.passmanager_config.PassManagerConfig")) – configuration of the pass manager.
+
+**Returns**
+
+a level 1 pass manager.
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if the passmanager config is invalid.
+
+**Return type**
+
+[*StagedPassManager*](qiskit.transpiler.StagedPassManager "qiskit.transpiler.passmanager.StagedPassManager")
+
+### level\_2\_pass\_manager
+
+
+
+`qiskit.transpiler.preset_passmanagers.level_2_pass_manager(pass_manager_config)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/preset_passmanagers/level2.py "view source code")
+
+Level 2 pass manager: medium optimization by initial layout selection and gate cancellation using commutativity rules.
+
+This pass manager applies the user-given initial layout. If none is given, a search for a perfect layout (i.e. one that satisfies all 2-qubit interactions) is conducted. If no such layout is found, qubits are laid out on the most densely connected subset which also exhibits the best gate fidelities.
+
+The pass manager then transforms the circuit to match the coupling constraints. It is then unrolled to the basis, and any flipped cx directions are fixed. Finally, optimizations in the form of commutative gate cancellation and redundant reset removal are performed.
+
+**Parameters**
+
+**pass\_manager\_config** ([*PassManagerConfig*](qiskit.transpiler.PassManagerConfig "qiskit.transpiler.passmanager_config.PassManagerConfig")) – configuration of the pass manager.
+
+**Returns**
+
+a level 2 pass manager.
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if the passmanager config is invalid.
+
+**Return type**
+
+[*StagedPassManager*](qiskit.transpiler.StagedPassManager "qiskit.transpiler.passmanager.StagedPassManager")
+
+### level\_3\_pass\_manager
+
+
+
+`qiskit.transpiler.preset_passmanagers.level_3_pass_manager(pass_manager_config)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/preset_passmanagers/level3.py "view source code")
+
+Level 3 pass manager: heavy optimization by noise adaptive qubit mapping and gate cancellation using commutativity rules and unitary synthesis.
+
+This pass manager applies the user-given initial layout. If none is given, a search for a perfect layout (i.e. one that satisfies all 2-qubit interactions) is conducted. If no such layout is found, and device calibration information is available, the circuit is mapped to the qubits with best readouts and to CX gates with highest fidelity.
+
+The pass manager then transforms the circuit to match the coupling constraints. It is then unrolled to the basis, and any flipped cx directions are fixed. Finally, optimizations in the form of commutative gate cancellation, resynthesis of two-qubit unitary blocks, and redundant reset removal are performed.
+
+**Parameters**
+
+**pass\_manager\_config** ([*PassManagerConfig*](qiskit.transpiler.PassManagerConfig "qiskit.transpiler.passmanager_config.PassManagerConfig")) – configuration of the pass manager.
+
+**Returns**
+
+a level 3 pass manager.
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – if the passmanager config is invalid.
+
+**Return type**
+
+[*StagedPassManager*](qiskit.transpiler.StagedPassManager "qiskit.transpiler.passmanager.StagedPassManager")
+
+
+
+## Stage Generator Functions
+
+### generate\_control\_flow\_options\_check
+
+
+
+`qiskit.transpiler.preset_passmanagers.common.generate_control_flow_options_check(layout_method=None, routing_method=None, translation_method=None, optimization_method=None, scheduling_method=None, basis_gates=(), target=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/preset_passmanagers/common.py "view source code")
+
+Generate a pass manager that, when run on a DAG that contains control flow, fails with an error message explaining the invalid options, and what could be used instead.
+
+**Returns**
+
+a pass manager that populates the `contains_x` properties for each of the control-flow operations, and raises an error if any of the given options do not support control flow, but a circuit with control flow is given.
+
+**Return type**
+
+[PassManager](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager")
+
+### generate\_error\_on\_control\_flow
+
+
+
+`qiskit.transpiler.preset_passmanagers.common.generate_error_on_control_flow(message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/preset_passmanagers/common.py "view source code")
+
+Get a pass manager that always raises an error if control flow is present in a given circuit.
+
+### generate\_unroll\_3q
+
+
+
+`qiskit.transpiler.preset_passmanagers.common.generate_unroll_3q(target, basis_gates=None, approximation_degree=None, unitary_synthesis_method='default', unitary_synthesis_plugin_config=None, hls_config=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/preset_passmanagers/common.py "view source code")
+
+Generate an unroll >3q [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager")
+
+**Parameters**
+
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object representing the backend
+* **basis\_gates** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of str gate names that represent the basis gates on the backend target
+* **approximation\_degree** (*Optional\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The heuristic approximation degree to use. Can be between 0 and 1.
+* **unitary\_synthesis\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The unitary synthesis method to use. You can see a list of installed plugins with [`unitary_synthesis_plugin_names()`](qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names "qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names").
+* **unitary\_synthesis\_plugin\_config** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – The optional dictionary plugin configuration, this is plugin specific refer to the specified plugin’s documentation for how to use.
+* **hls\_config** (*HLSConfig*) – An optional configuration class to use for [`HighLevelSynthesis`](qiskit.transpiler.passes.HighLevelSynthesis "qiskit.transpiler.passes.HighLevelSynthesis") pass. Specifies how to synthesize various high-level objects.
+
+**Returns**
+
+The unroll 3q or more pass manager
+
+**Return type**
+
+[PassManager](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager")
+
+### generate\_embed\_passmanager
+
+
+
+`qiskit.transpiler.preset_passmanagers.common.generate_embed_passmanager(coupling_map)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/preset_passmanagers/common.py "view source code")
+
+Generate a layout embedding [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager")
+
+This is used to generate a [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager") object that can be used to expand and apply an initial layout to a circuit
+
+**Parameters**
+
+**coupling\_map** (*Union\[*[*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")*,* [*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – The coupling map for the backend to embed the circuit to.
+
+**Returns**
+
+**The embedding passmanager that assumes the layout property**
+
+set has been set in earlier stages
+
+**Return type**
+
+[PassManager](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager")
+
+### generate\_routing\_passmanager
+
+
+
+`qiskit.transpiler.preset_passmanagers.common.generate_routing_passmanager(routing_pass, target, coupling_map=None, vf2_call_limit=None, backend_properties=None, seed_transpiler=None, check_trivial=False, use_barrier_before_measurement=True, vf2_max_trials=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/preset_passmanagers/common.py "view source code")
+
+Generate a routing [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager")
+
+**Parameters**
+
+* **routing\_pass** ([*TransformationPass*](qiskit.transpiler.TransformationPass "qiskit.transpiler.TransformationPass")) – The pass which will perform the routing
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object representing the backend
+* **coupling\_map** ([*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")) – The coupling map of the backend to route for
+* **vf2\_call\_limit** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The internal call limit for the vf2 post layout pass. If this is `None` or `0` the vf2 post layout will not be run.
+* **backend\_properties** ([*BackendProperties*](qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties")) – Properties of a backend to synthesize for (e.g. gate fidelities).
+* **seed\_transpiler** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Sets random seed for the stochastic parts of the transpiler.
+* **check\_trivial** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If set to true this will condition running the [`VF2PostLayout`](qiskit.transpiler.passes.VF2PostLayout "qiskit.transpiler.passes.VF2PostLayout") pass after routing on whether a trivial layout was tried and was found to not be perfect. This is only needed if the constructed pass manager runs [`TrivialLayout`](qiskit.transpiler.passes.TrivialLayout "qiskit.transpiler.passes.TrivialLayout") as a first layout attempt and uses it if it’s a perfect layout (as is the case with preset pass manager level 1).
+* **use\_barrier\_before\_measurement** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If true (the default) the [`BarrierBeforeFinalMeasurements`](qiskit.transpiler.passes.BarrierBeforeFinalMeasurements "qiskit.transpiler.passes.BarrierBeforeFinalMeasurements") transpiler pass will be run prior to the specified pass in the `routing_pass` argument.
+* **vf2\_max\_trials** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The maximum number of trials to run VF2 when evaluating the vf2 post layout pass. If this is `None` or `0` the vf2 post layout will not be run.
+
+**Returns**
+
+The routing pass manager
+
+**Return type**
+
+[PassManager](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager")
+
+### generate\_pre\_op\_passmanager
+
+
+
+`qiskit.transpiler.preset_passmanagers.common.generate_pre_op_passmanager(target=None, coupling_map=None, remove_reset_in_zero=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/preset_passmanagers/common.py "view source code")
+
+Generate a pre-optimization loop [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager")
+
+This pass manager will check to ensure that directionality from the coupling map is respected
+
+**Parameters**
+
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object representing the backend
+* **coupling\_map** ([*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")) – The coupling map to use
+* **remove\_reset\_in\_zero** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If `True` include the remove reset in zero pass in the generated PassManager
+
+**Returns**
+
+The pass manager
+
+**Return type**
+
+[PassManager](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager")
+
+### generate\_translation\_passmanager
+
+
+
+`qiskit.transpiler.preset_passmanagers.common.generate_translation_passmanager(target, basis_gates=None, method='translator', approximation_degree=None, coupling_map=None, backend_props=None, unitary_synthesis_method='default', unitary_synthesis_plugin_config=None, hls_config=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/preset_passmanagers/common.py "view source code")
+
+Generate a basis translation [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager")
+
+**Parameters**
+
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – the [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object representing the backend
+* **basis\_gates** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – A list of str gate names that represent the basis gates on the backend target
+* **method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The basis translation method to use
+* **approximation\_degree** (*Optional\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) – The heuristic approximation degree to use. Can be between 0 and 1.
+* **coupling\_map** ([*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap")) – the coupling map of the backend in case synthesis is done on a physical circuit. The directionality of the coupling\_map will be taken into account if pulse\_optimize is True/None and natural\_direction is True/None.
+* **unitary\_synthesis\_plugin\_config** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – The optional dictionary plugin configuration, this is plugin specific refer to the specified plugin’s documentation for how to use.
+* **backend\_props** ([*BackendProperties*](qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties")) – Properties of a backend to synthesize for (e.g. gate fidelities).
+* **unitary\_synthesis\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The unitary synthesis method to use. You can see a list of installed plugins with [`unitary_synthesis_plugin_names()`](qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names "qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names").
+* **hls\_config** (*HLSConfig*) – An optional configuration class to use for [`HighLevelSynthesis`](qiskit.transpiler.passes.HighLevelSynthesis "qiskit.transpiler.passes.HighLevelSynthesis") pass. Specifies how to synthesize various high-level objects.
+
+**Returns**
+
+The basis translation pass manager
+
+**Return type**
+
+[PassManager](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager")
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – If the `method` kwarg is not a valid value
+
+### generate\_scheduling
+
+
+
+`qiskit.transpiler.preset_passmanagers.common.generate_scheduling(instruction_durations, scheduling_method, timing_constraints, inst_map, target=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/transpiler/preset_passmanagers/common.py "view source code")
+
+Generate a post optimization scheduling [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager")
+
+**Parameters**
+
+* **instruction\_durations** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – The dictionary of instruction durations
+* **scheduling\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The scheduling method to use, can either be `'asap'`/`'as_soon_as_possible'` or `'alap'`/`'as_late_as_possible'`
+* **timing\_constraints** (*TimingConstraints*) – Hardware time alignment restrictions.
+* **inst\_map** ([*InstructionScheduleMap*](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap")) – Mapping object that maps gate to schedule.
+* **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – The [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") object representing the backend
+
+**Returns**
+
+The scheduling pass manager
+
+**Return type**
+
+[PassManager](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager")
+
+**Raises**
+
+[**TranspilerError**](transpiler#qiskit.transpiler.TranspilerError "qiskit.transpiler.TranspilerError") – If the `scheduling_method` kwarg is not a valid value
+
diff --git a/docs/api/qiskit/0.46/transpiler_synthesis_plugins.md b/docs/api/qiskit/0.46/transpiler_synthesis_plugins.md
new file mode 100644
index 00000000000..cb32aa6c3a6
--- /dev/null
+++ b/docs/api/qiskit/0.46/transpiler_synthesis_plugins.md
@@ -0,0 +1,169 @@
+---
+title: plugin
+description: API reference for qiskit.transpiler.passes.synthesis.plugin
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.transpiler.passes.synthesis.plugin
+---
+
+
+
+
+
+
+
+# Synthesis Plugins
+
+
+
+`qiskit.transpiler.passes.synthesis.plugin`
+
+This module defines the plugin interfaces for the synthesis transpiler passes in Qiskit. These provide a hook point for external python packages to implement their own synthesis techniques and have them seamlessly exposed as opt-in options to users when they run [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile").
+
+The plugin interfaces are built using setuptools [entry points](https://setuptools.readthedocs.io/en/latest/userguide/entry_point.html) which enable packages external to qiskit to advertise they include a synthesis plugin.
+
+See [`qiskit.transpiler.preset_passmanagers.plugin`](transpiler_plugins#module-qiskit.transpiler.preset_passmanagers.plugin "qiskit.transpiler.preset_passmanagers.plugin") for details on how to write plugins for transpiler stages.
+
+## Writing Plugins
+
+### Unitary Synthesis Plugins
+
+To write a unitary synthesis plugin there are 2 main steps. The first step is to create a subclass of the abstract plugin class: [`UnitarySynthesisPlugin`](qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin "qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin"). The plugin class defines the interface and contract for unitary synthesis plugins. The primary method is [`run()`](qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin#run "qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin.run") which takes in a single positional argument, a unitary matrix as a numpy array, and is expected to return a [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") object representing the synthesized circuit from that unitary matrix. Then to inform the Qiskit transpiler about what information is necessary for the pass there are several required property methods that need to be implemented such as `supports_basis_gates` and `supports_coupling_map` depending on whether the plugin supports and/or requires that input to perform synthesis. For the full details refer to the [`UnitarySynthesisPlugin`](qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin "qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin") documentation for all the required fields. An example plugin class would look something like:
+
+```python
+from qiskit.transpiler.passes.synthesis import plugin
+from qiskit_plugin_pkg.synthesis import generate_dag_circuit_from_matrix
+
+
+class SpecialUnitarySynthesis(plugin.UnitarySynthesisPlugin):
+ @property
+ def supports_basis_gates(self):
+ return True
+
+ @property
+ def supports_coupling_map(self):
+ return False
+
+ @property
+ def supports_natural_direction(self):
+ return False
+
+ @property
+ def supports_pulse_optimize(self):
+ return False
+
+ @property
+ def supports_gate_lengths(self):
+ return False
+
+ @property
+ def supports_gate_errors(self):
+ return False
+
+ @property
+ def supports_gate_lengths_by_qubit(self):
+ return False
+
+ @property
+ def supports_gate_errors_by_qubit(self):
+ return False
+
+ @property
+ def min_qubits(self):
+ return None
+
+ @property
+ def max_qubits(self):
+ return None
+
+ @property
+ def supported_bases(self):
+ return None
+
+ def run(self, unitary, **options):
+ basis_gates = options['basis_gates']
+ dag_circuit = generate_dag_circuit_from_matrix(unitary, basis_gates)
+ return dag_circuit
+```
+
+If for some reason the available inputs to the [`run()`](qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin#run "qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin.run") method are insufficient please open an issue and we can discuss expanding the plugin interface with new opt-in inputs that can be added in a backwards compatible manner for future releases. Do note though that this plugin interface is considered stable and guaranteed to not change in a breaking manner. If changes are needed (for example to expand the available optional input options) it will be done in a way that will **not** require changes from existing plugins.
+
+
+ All methods prefixed with `supports_` are reserved on a `UnitarySynthesisPlugin` derived class for part of the interface. You should not define any custom `supports_*` methods on a subclass that are not defined in the abstract class.
+
+
+The second step is to expose the [`UnitarySynthesisPlugin`](qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin "qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin") as a setuptools entry point in the package metadata. This is done by simply adding an `entry_points` entry to the `setuptools.setup` call in the `setup.py` for the plugin package with the necessary entry points under the `qiskit.unitary_synthesis` namespace. For example:
+
+```python
+entry_points = {
+ 'qiskit.unitary_synthesis': [
+ 'special = qiskit_plugin_pkg.module.plugin:SpecialUnitarySynthesis',
+ ]
+},
+```
+
+(note that the entry point `name = path` is a single string not a Python expression). There isn’t a limit to the number of plugins a single package can include as long as each plugin has a unique name. So a single package can expose multiple plugins if necessary. The name `default` is used by Qiskit itself and can’t be used in a plugin.
+
+#### Unitary Synthesis Plugin Configuration
+
+For some unitary synthesis plugins that expose multiple options and tunables the plugin interface has an option for users to provide a free form configuration dictionary. This will be passed through to the `run()` method as the `config` kwarg. If your plugin has these configuration options you should clearly document how a user should specify these configuration options and how they’re used as it’s a free form field.
+
+### High-Level Synthesis Plugins
+
+Writing a high-level synthesis plugin is conceptually similar to writing a unitary synthesis plugin. The first step is to create a subclass of the abstract plugin class: [`HighLevelSynthesisPlugin`](qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPlugin "qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPlugin"), which defines the interface and contract for high-level synthesis plugins. The primary method is [`run()`](qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPlugin#run "qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPlugin.run"). The positional argument `high_level_object` specifies the “higher-level-object” to be synthesized, which is any object of type [`Operation`](qiskit.circuit.Operation "qiskit.circuit.Operation") (including, for example, [`LinearFunction`](qiskit.circuit.library.LinearFunction "qiskit.circuit.library.generalized_gates.linear_function.LinearFunction") or [`Clifford`](qiskit.quantum_info.Clifford "qiskit.quantum_info.operators.symplectic.clifford.Clifford")). The keyword argument `target` specifies the target backend, allowing the plugin to access all target-specific information, such as the coupling map, the supported gate set, and so on. The keyword argument `coupling_map` only specifies the coupling map, and is only used when `target` is not specified. The keyword argument `qubits` specifies the list of qubits over which the higher-level-object is defined, in case the synthesis is done on the physical circuit. The value of `None` indicates that the layout has not yet been chosen and the physical qubits in the target or coupling map that this operation is operating on has not yet been determined. Additionally, plugin-specific options and tunables can be specified via `options`, which is a free form configuration dictionary. If your plugin has these configuration options you should clearly document how a user should specify these configuration options and how they’re used as it’s a free form field. The method [`run()`](qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPlugin#run "qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPlugin.run") is expected to return a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") object representing the synthesized circuit from that higher-level-object. It is also allowed to return `None` representing that the synthesis method is unable to synthesize the given higher-level-object. The actual synthesis of higher-level objects is performed by [`HighLevelSynthesis`](qiskit.transpiler.passes.HighLevelSynthesis "qiskit.transpiler.passes.synthesis.high_level_synthesis.HighLevelSynthesis") transpiler pass. For the full details refer to the [`HighLevelSynthesisPlugin`](qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPlugin "qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPlugin") documentation for all the required fields. An example plugin class would look something like:
+
+```python
+from qiskit.transpiler.passes.synthesis.plugin import HighLevelSynthesisPlugin
+from qiskit.synthesis.clifford import synth_clifford_bm
+
+
+class SpecialSynthesisClifford(HighLevelSynthesisPlugin):
+
+def run(self, high_level_object, coupling_map=None, target=None, qubits=None, **options):
+ if higher_level_object.num_qubits <= 3:
+ return synth_clifford_bm(high_level_object)
+ else:
+ return None
+```
+
+The above example creates a plugin to synthesize objects of type [`Clifford`](qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford") that have at most 3 qubits, using the method `synth_clifford_bm`.
+
+The second step is to expose the [`HighLevelSynthesisPlugin`](qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPlugin "qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPlugin") as a setuptools entry point in the package metadata. This is done by adding an `entry_points` entry to the `setuptools.setup` call in the `setup.py` for the plugin package with the necessary entry points under the `qiskit.synthesis` namespace. For example:
+
+```python
+entry_points = {
+ 'qiskit.synthesis': [
+ 'clifford.special = qiskit_plugin_pkg.module.plugin:SpecialSynthesisClifford',
+ ]
+},
+```
+
+(note that the entry point `name = path` is a single string not a Python expression). The `name` consists of two parts separated by dot “.”: the name of the type of [`Operation`](qiskit.circuit.Operation "qiskit.circuit.Operation") to which the synthesis plugin applies (`clifford`), and the name of the plugin (`special`). There isn’t a limit to the number of plugins a single package can include as long as each plugin has a unique name.
+
+## Using Plugins
+
+To use a plugin all you need to do is install the package that includes a synthesis plugin. Then Qiskit will automatically discover the installed plugins and expose them as valid options for the appropriate [`transpile()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") kwargs and pass constructors. If there are any installed plugins which can’t be loaded/imported this will be logged to Python logging.
+
+To get the installed list of installed unitary synthesis plugins you can use the [`qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names()`](qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names "qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names") function.
+
+## Plugin API
+
+
+
+### Unitary Synthesis Plugins
+
+| | |
+| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
+| [`UnitarySynthesisPlugin`](qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin "qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin")() | Abstract unitary synthesis plugin class |
+| [`UnitarySynthesisPluginManager`](qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPluginManager "qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPluginManager")() | Unitary Synthesis plugin manager class |
+| [`unitary_synthesis_plugin_names`](qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names "qiskit.transpiler.passes.synthesis.plugin.unitary_synthesis_plugin_names")() | Return a list of installed unitary synthesis plugin names |
+
+
+
+### High-Level Synthesis Plugins
+
+| | |
+| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
+| [`HighLevelSynthesisPlugin`](qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPlugin "qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPlugin")() | Abstract high-level synthesis plugin class. |
+| [`HighLevelSynthesisPluginManager`](qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPluginManager "qiskit.transpiler.passes.synthesis.plugin.HighLevelSynthesisPluginManager")() | Class tracking the installed high-level-synthesis plugins. |
+
diff --git a/docs/api/qiskit/0.46/utils.md b/docs/api/qiskit/0.46/utils.md
new file mode 100644
index 00000000000..b7b8bc4ec70
--- /dev/null
+++ b/docs/api/qiskit/0.46/utils.md
@@ -0,0 +1,712 @@
+---
+title: utils
+description: API reference for qiskit.utils
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.utils
+---
+
+
+
+
+
+
+
+# Utilities
+
+
+
+`qiskit.utils`
+
+### add\_deprecation\_to\_docstring
+
+
+
+`qiskit.utils.add_deprecation_to_docstring(func, msg, *, since, pending)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/utils/deprecation.py "view source code")
+
+Dynamically insert the deprecation message into `func`’s docstring.
+
+**Parameters**
+
+* **func** (*Callable*) – The function to modify.
+* **msg** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The full deprecation message.
+* **since** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The version the deprecation started at.
+* **pending** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Is the deprecation still pending?
+
+### deprecate\_arg
+
+
+
+`qiskit.utils.deprecate_arg(name, *, since, additional_msg=None, deprecation_description=None, pending=False, package_name='qiskit', new_alias=None, predicate=None, removal_timeline='no earlier than 3 months after the release date')`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/utils/deprecation.py "view source code")
+
+Decorator to indicate an argument has been deprecated in some way.
+
+This decorator may be used multiple times on the same function, once per deprecated argument. It should be placed beneath other decorators like `@staticmethod` and property decorators.
+
+**Parameters**
+
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The name of the deprecated argument.
+* **since** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The version the deprecation started at. If the deprecation is pending, set the version to when that started; but later, when switching from pending to deprecated, update since to the new version.
+* **deprecation\_description** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – What is being deprecated? E.g. “Setting my\_func()’s my\_arg argument to None.” If not set, will default to “\{func\_name}’s argument \{name}”.
+* **additional\_msg** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Put here any additional information, such as what to use instead (if new\_alias is not set). For example, “Instead, use the argument new\_arg, which is similar but does not impact the circuit’s setup.”
+* **pending** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Set to True if the deprecation is still pending.
+* **package\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The PyPI package name, e.g. “qiskit-nature”.
+* **new\_alias** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – If the arg has simply been renamed, set this to the new name. The decorator will dynamically update the kwargs so that when the user sets the old arg, it will be passed in as the new\_alias arg.
+* **predicate** (*Callable\[\[Any],* [*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")*] | None*) – Only log the runtime warning if the predicate returns True. This is useful to deprecate certain values or types for an argument, e.g. lambda my\_arg: isinstance(my\_arg, dict). Regardless of if a predicate is set, the runtime warning will only log when the user specifies the argument.
+* **removal\_timeline** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – How soon can this deprecation be removed? Expects a value like “no sooner than 6 months after the latest release” or “in release 9.99”.
+
+**Returns**
+
+The decorated callable.
+
+**Return type**
+
+Callable
+
+### deprecate\_arguments
+
+
+
+`qiskit.utils.deprecate_arguments(kwarg_map, category=, *, since=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/utils/deprecation.py "view source code")
+
+Deprecated. Instead, use @deprecate\_arg.
+
+**Parameters**
+
+* **kwarg\_map** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None]*) – A dictionary of the old argument name to the new name.
+* **category** ([*Type*](circuit_classical#qiskit.circuit.classical.types.Type "qiskit.circuit.classical.types.Type")*\[*[*Warning*](https://docs.python.org/3/library/exceptions.html#Warning "(in Python v3.12)")*]*) – Usually either DeprecationWarning or PendingDeprecationWarning.
+* **since** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The version the deprecation started at. Only Optional for backwards compatibility - this should always be set. If the deprecation is pending, set the version to when that started; but later, when switching from pending to deprecated, update since to the new version.
+
+**Returns**
+
+The decorated callable.
+
+**Return type**
+
+Callable
+
+### deprecate\_func
+
+
+
+`qiskit.utils.deprecate_func(*, since, additional_msg=None, pending=False, package_name='qiskit', removal_timeline='no earlier than 3 months after the release date', is_property=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/utils/deprecation.py "view source code")
+
+Decorator to indicate a function has been deprecated.
+
+It should be placed beneath other decorators like @staticmethod and property decorators.
+
+When deprecating a class, set this decorator on its \_\_init\_\_ function.
+
+**Parameters**
+
+* **since** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The version the deprecation started at. If the deprecation is pending, set the version to when that started; but later, when switching from pending to deprecated, update `since` to the new version.
+* **additional\_msg** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – Put here any additional information, such as what to use instead. For example, “Instead, use the function `new_func` from the module `.`, which is similar but uses GPU acceleration.”
+* **pending** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Set to `True` if the deprecation is still pending.
+* **package\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – The PyPI package name, e.g. “qiskit-nature”.
+* **removal\_timeline** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – How soon can this deprecation be removed? Expects a value like “no sooner than 6 months after the latest release” or “in release 9.99”.
+* **is\_property** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If the deprecated function is a @property, set this to True so that the generated message correctly describes it as such. (This isn’t necessary for property setters, as their docstring is ignored by Python.)
+
+**Returns**
+
+The decorated callable.
+
+**Return type**
+
+Callable
+
+### deprecate\_function
+
+
+
+`qiskit.utils.deprecate_function(msg, stacklevel=2, category=, *, since=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/utils/deprecation.py "view source code")
+
+Deprecated. Instead, use @deprecate\_func.
+
+**Parameters**
+
+* **msg** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Warning message to emit.
+* **stacklevel** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – The warning stacklevel to use, defaults to 2.
+* **category** ([*Type*](circuit_classical#qiskit.circuit.classical.types.Type "qiskit.circuit.classical.types.Type")*\[*[*Warning*](https://docs.python.org/3/library/exceptions.html#Warning "(in Python v3.12)")*]*) – Usually either DeprecationWarning or PendingDeprecationWarning.
+* **since** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *| None*) – The version the deprecation started at. Only Optional for backwards compatibility - this should always be set. If the deprecation is pending, set the version to when that started; but later, when switching from pending to deprecated, update since to the new version.
+
+**Returns**
+
+The decorated, deprecated callable.
+
+**Return type**
+
+Callable
+
+### local\_hardware\_info
+
+
+
+`qiskit.utils.local_hardware_info()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/utils/multiprocessing.py "view source code")
+
+Basic hardware information about the local machine.
+
+Gives actual number of CPU’s in the machine, even when hyperthreading is turned on. CPU count defaults to 1 when true count can’t be determined.
+
+**Returns**
+
+The hardware information.
+
+**Return type**
+
+[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
+
+### is\_main\_process
+
+
+
+`qiskit.utils.is_main_process()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/utils/multiprocessing.py "view source code")
+
+Checks whether the current process is the main one
+
+### apply\_prefix
+
+
+
+`qiskit.utils.apply_prefix(value, unit)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/utils/units.py "view source code")
+
+Given a SI unit prefix and value, apply the prefix to convert to standard SI unit.
+
+**Parameters**
+
+* **value** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")) – The number to apply prefix to.
+* **unit** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – String prefix.
+
+**Returns**
+
+Converted value.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") | [ParameterExpression](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")
+
+
+ This may induce tiny value error due to internal representation of float object. See [https://docs.python.org/3/tutorial/floatingpoint.html](https://docs.python.org/3/tutorial/floatingpoint.html) for details.
+
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If the `units` aren’t recognized.
+
+**Return type**
+
+[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") | [ParameterExpression](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")
+
+### detach\_prefix
+
+
+
+`qiskit.utils.detach_prefix(value, decimal=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/utils/units.py "view source code")
+
+Given a SI unit value, find the most suitable prefix to scale the value.
+
+For example, the `value = 1.3e8` will be converted into a tuple of `(130.0, "M")`, which represents a scaled value and auxiliary unit that may be used to display the value. In above example, that value might be displayed as `130 MHz` (unit is arbitrary here).
+
+**Example**
+
+```python
+>>> value, prefix = detach_prefix(1e4)
+>>> print(f"{value} {prefix}Hz")
+10 kHz
+```
+
+**Parameters**
+
+* **value** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – The number to find prefix.
+* **decimal** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)") *| None*) – Optional. An arbitrary integer number to represent a precision of the value. If specified, it tries to round the mantissa and adjust the prefix to rounded value. For example, 999\_999.91 will become 999.9999 k with `decimal=4`, while 1.0 M with `decimal=3` or less.
+
+**Returns**
+
+A tuple of scaled value and prefix.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)"), [str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")]
+
+
+ This may induce tiny value error due to internal representation of float object. See [https://docs.python.org/3/tutorial/floatingpoint.html](https://docs.python.org/3/tutorial/floatingpoint.html) for details.
+
+
+**Raises**
+
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If the `value` is out of range.
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – If the `value` is not real number.
+
+**Return type**
+
+[tuple](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.12)")\[[float](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)"), [str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")]
+
+### wrap\_method
+
+
+
+`qiskit.utils.wrap_method(cls, name, *, before=None, after=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/utils/classtools.py "view source code")
+
+Wrap the functionality the instance- or class method `cls.name` with additional behaviour `before` and `after`.
+
+This mutates `cls`, replacing the attribute `name` with the new functionality. This is useful when creating class decorators. The method is allowed to be defined on any parent class instead.
+
+If either `before` or `after` are given, they should be callables with a compatible signature to the method referred to. They will be called immediately before or after the method as appropriate, and any return value will be ignored.
+
+**Parameters**
+
+* **cls** ([*Type*](https://docs.python.org/3/library/typing.html#typing.Type "(in Python v3.12)")) – the class to modify.
+* **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – the name of the method on the class to wrap.
+* **before** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *| None*) – a callable that should be called before the method that is being wrapped.
+* **after** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.12)") *| None*) – a callable that should be called after the method that is being wrapped.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – if the named method is not defined on the class or any parent class.
+
+## Algorithm Utilities
+
+### summarize\_circuits
+
+
+
+`qiskit.utils.summarize_circuits(circuits)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/utils/circuit_utils.py "view source code")
+
+**Summarize circuits based on QuantumCircuit, and five metrics are summarized.**
+
+* Number of qubits
+* Number of classical bits
+* Number of operations
+* Depth of circuits
+* Counts of different gate operations
+
+The average statistic of the first four is provided if multiple circuits are provided.
+
+>
+> The function `qiskit.utils.circuit_utils.summarize_circuits()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. This function was only used in the context of qiskit.opflow/qiskit.algorithms, two modules deprecated and planned to be removed in Qiskit 1.0.
+>
+
+**Parameters**
+
+**circuits** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or \[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*]*) – the to-be-summarized circuits
+
+**Returns**
+
+a formatted string records the summary
+
+**Return type**
+
+[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")
+
+### get\_entangler\_map
+
+
+
+`qiskit.utils.get_entangler_map(map_type, num_qubits, offset=0)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/utils/entangler_map.py "view source code")
+
+Utility method to get an entangler map among qubits.
+
+
+ The function `qiskit.utils.entangler_map.get_entangler_map()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. This function was only used in the context of qiskit.opflow/qiskit.algorithms, two modules deprecated and planned to be removed in Qiskit 1.0.
+
+
+**Parameters**
+
+* **map\_type** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – ‘full’ entangles each qubit with all the subsequent ones ‘linear’ entangles each qubit with the next ‘sca’ (shifted circular alternating entanglement) is a circular entanglement where the ‘long’ entanglement is shifted by one position every block and every block the role or control/target qubits alternate
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of qubits for which the map is needed
+* **offset** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Some map\_types (e.g. ‘sca’) can shift the gates in the entangler map by the specified integer offset.
+
+**Returns**
+
+A map of qubit index to an array of indexes to which this should be entangled
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – if map\_type is not valid.
+
+### validate\_entangler\_map
+
+
+
+`qiskit.utils.validate_entangler_map(entangler_map, num_qubits, allow_double_entanglement=False)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/utils/entangler_map.py "view source code")
+
+Validate a user supplied entangler map and converts entries to ints.
+
+
+ The function `qiskit.utils.entangler_map.validate_entangler_map()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. This function was only used in the context of qiskit.opflow/qiskit.algorithms, two modules deprecated and planned to be removed in Qiskit 1.0.
+
+
+**Parameters**
+
+* **entangler\_map** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*\[*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")*]*) – An entangler map, keys are source qubit index (int), value is array of target qubit index(es) (int)
+* **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of qubits
+* **allow\_double\_entanglement** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – If we allow in two qubits can be entangled each other
+
+**Returns**
+
+Validated/converted map
+
+**Return type**
+
+[list](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")
+
+**Raises**
+
+* [**TypeError**](https://docs.python.org/3/library/exceptions.html#TypeError "(in Python v3.12)") – entangler map is not list type or list of list
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – the index of entangler map is out of range
+* [**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – the qubits are cross-entangled.
+
+### has\_ibmq
+
+
+
+`qiskit.utils.has_ibmq()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/utils/backend_utils.py "view source code")
+
+Check if IBMQ is installed.
+
+
+ The function `qiskit.utils.backend_utils.has_ibmq()` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/qi\_migration](https://qisk.it/qi_migration).
+
+
+### has\_aer
+
+
+
+`qiskit.utils.has_aer()`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/utils/backend_utils.py "view source code")
+
+Check if Aer is installed.
+
+
+ The function `qiskit.utils.backend_utils.has_aer()` is deprecated as of qiskit-terra 0.24.0. It will be removed in the Qiskit 1.0 release. For code migration guidelines, visit [https://qisk.it/qi\_migration](https://qisk.it/qi_migration).
+
+
+### name\_args
+
+
+
+`qiskit.utils.name_args(mapping, skip=0)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/utils/name_unnamed_args.py "view source code")
+
+Decorator to convert unnamed arguments to named ones.
+
+Can be used to deprecate old signatures of a function, e.g.
+
+```python
+old_f(a: TypeA, b: TypeB, c: TypeC)
+new_f(a: TypeA, d: TypeD, b: TypeB=None, c: TypeC=None)
+```
+
+Then, to support the old signature this decorator can be used as
+
+```python
+@name_args([
+ ('a'), # stays the same
+ ('d', {TypeB: 'b'}), # if arg is of type TypeB, call if 'b' else 'd'
+ ('b', {TypeC: 'c'})
+])
+def new_f(a: TypeA, d: TypeD, b: TypeB=None, c: TypeC=None):
+ if b is not None:
+ # raise warning, this is deprecated!
+ if c is not None:
+ # raise warning, this is deprecated!
+```
+
+
+ The function `qiskit.utils.name_unnamed_args.name_args()` is deprecated as of qiskit 0.46.0. It will be removed in the Qiskit 1.0 release. This function was only used in the context of qiskit.opflow/qiskit.algorithms, two modules deprecated and planned to be removed in Qiskit 1.0.
+
+
+**qiskit.utils.algorithm\_globals *= \***
+
+Class for global properties.
+
+| | |
+| -------------------------------------------------------------------------------- | -------------------------------------------------------- |
+| [`QuantumInstance`](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance") | Deprecated: Quantum Backend including execution setting. |
+
+A QuantumInstance holds the Qiskit backend as well as a number of compile and runtime parameters controlling circuit compilation and execution. Quantum [`algorithms`](algorithms#module-qiskit.algorithms "qiskit.algorithms") are run on a device or simulator by passing a QuantumInstance setup with the desired backend etc.
+
+### Parallel Routines
+
+A helper function for calling a custom function with python `ProcessPoolExecutor`. Tasks can be executed in parallel using this function. It has a built-in event publisher to show the progress of the parallel tasks.
+
+### parallel\_map
+
+
+
+`qiskit.utils.parallel_map(task, values, task_args=(), task_kwargs={}, num_processes=2)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/utils/parallel.py "view source code")
+
+Parallel execution of a mapping of values to the function task. This is functionally equivalent to:
+
+```python
+result = [task(value, *task_args, **task_kwargs) for value in values]
+```
+
+On Windows this function defaults to a serial implementation to avoid the overhead from spawning processes in Windows.
+
+**Parameters**
+
+* **task** (*func*) – Function that is to be called for each value in `values`.
+* **values** (*array\_like*) – List or array of values for which the `task` function is to be evaluated.
+* **task\_args** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) – Optional additional arguments to the `task` function.
+* **task\_kwargs** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) – Optional additional keyword argument to the `task` function.
+* **num\_processes** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – Number of processes to spawn.
+
+**Returns**
+
+**The result list contains the value of**
+
+**`task(value, *task_args, **task_kwargs)` for**
+
+each value in `values`.
+
+**Return type**
+
+result
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – If user interrupts via keyboard.
+
+**Events:**
+
+terra.parallel.start: The collection of parallel tasks are about to start. terra.parallel.update: One of the parallel task has finished. terra.parallel.finish: All the parallel tasks have finished.
+
+**Examples**
+
+```python
+import time
+from qiskit.tools.parallel import parallel_map
+def func(_):
+ time.sleep(0.1)
+ return 0
+parallel_map(func, list(range(10)));
+```
+
+
+
+
+
+## Optional Dependency Checkers
+
+
+
+`qiskit.utils.optionals`
+
+Qiskit has several features that are enabled only if certain *optional* dependencies are satisfied. This module is a collection of objects that can be used to test if certain functionality is available, and optionally raise [`MissingOptionalLibraryError`](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") if the functionality is not available.
+
+### Available Testers
+
+#### Qiskit Components
+
+| | |
+| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **qiskit.utils.optionals.HAS\_AER** | [Qiskit Aer](https://qiskit.org/ecosystem/aer/) provides high-performance simulators for the quantum circuits constructed within Qiskit. |
+| **qiskit.utils.optionals.HAS\_IBMQ** | The Qiskit IBMQ Provider was historically used for accessing IBM Quantum hardware in the IBM cloud, but is now deprecated. |
+| **qiskit.utils.optionals.HAS\_IGNIS** | Qiskit Ignis provided tools for quantum hardware verification, noise characterization, and error correction, but is now deprecated. |
+| **qiskit.utils.optionals.HAS\_TOQM** | [Qiskit TOQM](https://github.com/qiskit-toqm/qiskit-toqm) provides transpiler passes for the [Time-optimal Qubit mapping algorithm](https://doi.org/10.1145/3445814.3446706). |
+
+#### External Python Libraries
+
+| | |
+| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **qiskit.utils.optionals.HAS\_CONSTRAINT** | python-constraint \<[https://github.com/python-constraint/python-constraint>\_\_](https://github.com/python-constraint/python-constraint>__) is a constraint satisfaction problem solver, used in the :class:\`\~.CSPLayout transpiler pass. |
+| **qiskit.utils.optionals.HAS\_CPLEX** | The [IBM CPLEX Optimizer](https://www.ibm.com/analytics/cplex-optimizer) is a high-performance mathematical programming solver for linear, mixed-integer and quadratic programming. This is no longer by Qiskit, but it weas historically and the optional remains for backwards compatibility. |
+| **qiskit.utils.optionals.HAS\_CVXPY** | [CVXPY](https://www.cvxpy.org/) is a Python package for solving convex optimization problems. It is required for calculating diamond norms with [`quantum_info.diamond_norm()`](quantum_info#qiskit.quantum_info.diamond_norm "qiskit.quantum_info.diamond_norm"). |
+| **qiskit.utils.optionals.HAS\_DOCPLEX** | [IBM Decision Optimization CPLEX Modelling](http://ibmdecisionoptimization.github.io/docplex-doc/) is a library for prescriptive analysis. Like CPLEX, this is no longer by Qiskit, but it weas historically and the optional remains for backwards compatibility. |
+| **qiskit.utils.optionals.HAS\_FIXTURES** | The test suite has additional features that are available if the optional [fixtures](https://launchpad.net/python-fixtures) module is installed. This generally also needs [`HAS_TESTTOOLS`](#qiskit.utils.optionals.HAS_TESTTOOLS "qiskit.utils.optionals.HAS_TESTTOOLS") as well. This is generally only needed for Qiskit developers. |
+| **qiskit.utils.optionals.HAS\_IPYTHON** | If [the IPython kernel](https://ipython.org/) is available, certain additional visualisations and line magics are made available. |
+| **qiskit.utils.optionals.HAS\_IPYWIDGETS** | Monitoring widgets for jobs running on external backends can be provided if [ipywidgets](https://ipywidgets.readthedocs.io/en/latest/) is available. |
+| **qiskit.utils.optionals.HAS\_JAX** | Some methods of gradient calculation within [`opflow.gradients`](qiskit.opflow.gradients#module-qiskit.opflow.gradients "qiskit.opflow.gradients") require [JAX](https://github.com/google/jax) for autodifferentiation. |
+| **qiskit.utils.optionals.HAS\_JUPYTER** | Some of the tests require a complete [Jupyter](https://jupyter.org/) installation to test interactivity features. |
+| **qiskit.utils.optionals.HAS\_MATPLOTLIB** | Qiskit provides several visualisation tools in the [`visualization`](visualization#module-qiskit.visualization "qiskit.visualization") module. Almost all of these are built using [Matplotlib](https://matplotlib.org/), which must be installed in order to use them. |
+| **qiskit.utils.optionals.HAS\_NETWORKX** | No longer used by Qiskit. Internally, Qiskit now uses the high-performance [rustworkx](https://github.com/Qiskit/rustworkx) library as a core dependency, and during the change-over period, it was sometimes convenient to convert things into the Python-only [NetworkX](https://networkx.org/) format. Some tests of application modules, such as [Qiskit Nature](https://qiskit.org/ecosystem/nature/) still use NetworkX. |
+| **qiskit.utils.optionals.HAS\_NLOPT** | [NLopt](https://nlopt.readthedocs.io/en/latest/) is a nonlinear optimization library, used by the global optimizers in the [`algorithms.optimizers`](qiskit.algorithms.optimizers#module-qiskit.algorithms.optimizers "qiskit.algorithms.optimizers") module. |
+| **qiskit.utils.optionals.HAS\_PIL** | PIL is a Python image-manipulation library. Qiskit actually uses the [pillow](https://pillow.readthedocs.io/en/stable/) fork of PIL if it is available when generating certain visualizations, for example of both [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") and [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") in certain modes. |
+| **qiskit.utils.optionals.HAS\_PYDOT** | For some graph visualisations, Qiskit uses [pydot](https://github.com/pydot/pydot) as an interface to GraphViz (see [`HAS_GRAPHVIZ`](#qiskit.utils.optionals.HAS_GRAPHVIZ "qiskit.utils.optionals.HAS_GRAPHVIZ")). |
+| **qiskit.utils.optionals.HAS\_PYGMENTS** | Pygments is a code highlighter and formatter used by many environments that involve rich display of code blocks, including Sphinx and Jupyter. Qiskit uses this when producing rich output for these environments. |
+| **qiskit.utils.optionals.HAS\_PYLATEX** | Various LaTeX-based visualizations, especially the circuit drawers, need access to the [pylatexenc](https://github.com/phfaist/pylatexenc) project to work correctly. |
+| **qiskit.utils.optionals.HAS\_QASM3\_IMPORT** | The functions [`qasm3.load()`](qasm3#qiskit.qasm3.load "qiskit.qasm3.load") and [`qasm3.loads()`](qasm3#qiskit.qasm3.loads "qiskit.qasm3.loads") for importing OpenQASM 3 programs into [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") instances use [an external importer package](https://qiskit.github.io/qiskit-qasm3-import). |
+| **qiskit.utils.optionals.HAS\_SEABORN** | Qiskit provides several visualisation tools in the [`visualization`](visualization#module-qiskit.visualization "qiskit.visualization") module. Some of these are built using [Seaborn](https://seaborn.pydata.org/), which must be installed in order to use them. |
+| **qiskit.utils.optionals.HAS\_SKLEARN** | Some of the gradient functions in [`opflow.gradients`](qiskit.opflow.gradients#module-qiskit.opflow.gradients "qiskit.opflow.gradients") use regularisation methods from [Scikit Learn](https://scikit-learn.org/stable/). |
+| **qiskit.utils.optionals.HAS\_SKQUANT** | Some of the optimisers in [`algorithms.optimizers`](qiskit.algorithms.optimizers#module-qiskit.algorithms.optimizers "qiskit.algorithms.optimizers") are based on those found in [Scikit Quant](https://github.com/scikit-quant/scikit-quant), which must be installed to use them. |
+| **qiskit.utils.optionals.HAS\_SQSNOBFIT** | [SQSnobFit](https://pypi.org/project/SQSnobFit/) is a library for the “stable noisy optimization by branch and fit” algorithm. It is used by the [`SNOBFIT`](qiskit.algorithms.optimizers.SNOBFIT "qiskit.algorithms.optimizers.SNOBFIT") optimizer. |
+| **qiskit.utils.optionals.HAS\_SYMENGINE** | [Symengine](https://github.com/symengine/symengine) is a fast C++ backend for the symbolic-manipulation library [Sympy](https://www.sympy.org/en/index.html). Qiskit uses special methods from Symengine to accelerate its handling of [`Parameter`](qiskit.circuit.Parameter "qiskit.circuit.Parameter")s if available. |
+| **qiskit.utils.optionals.HAS\_TESTTOOLS** | Qiskit’s test suite has more advanced functionality available if the optional [testtools](https://pypi.org/project/testtools/) library is installed. This is generally only needed for Qiskit developers. |
+| **qiskit.utils.optionals.HAS\_TWEEDLEDUM** | [Tweedledum](https://github.com/boschmitt/tweedledum) is an extension library for synthesis and optimization of circuits that may involve classical oracles. Qiskit’s [`PhaseOracle`](qiskit.circuit.library.PhaseOracle "qiskit.circuit.library.PhaseOracle") uses this, which is used in turn by amplification algorithms via the [`AmplificationProblem`](qiskit.algorithms.AmplificationProblem "qiskit.algorithms.AmplificationProblem"). |
+| **qiskit.utils.optionals.HAS\_Z3** | [Z3](https://github.com/Z3Prover/z3) is a theorem prover, used in the [`CrosstalkAdaptiveSchedule`](qiskit.transpiler.passes.CrosstalkAdaptiveSchedule "qiskit.transpiler.passes.CrosstalkAdaptiveSchedule") and [`HoareOptimizer`](qiskit.transpiler.passes.HoareOptimizer "qiskit.transpiler.passes.HoareOptimizer") transpiler passes. |
+
+#### External Command-Line Tools
+
+| | |
+| ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **qiskit.utils.optionals.HAS\_GRAPHVIZ** | For some graph visualisations, Qiskit uses the [GraphViz](https://graphviz.org/) visualisation tool via its `pydot` interface (see [`HAS_PYDOT`](#qiskit.utils.optionals.HAS_PYDOT "qiskit.utils.optionals.HAS_PYDOT")). |
+| **qiskit.utils.optionals.HAS\_PDFLATEX** | Visualisation tools that use LaTeX in their output, such as the circuit drawers, require `pdflatex` to be available. You will generally need to ensure that you have a working LaTeX installation available, and the `qcircuit.tex` package. |
+| **qiskit.utils.optionals.HAS\_PDFTOCAIRO** | Visualisation tools that convert LaTeX-generated files into rasterised images use the `pdftocairo` tool. This is part of the [Poppler suite of PDF tools](https://poppler.freedesktop.org/). |
+
+### Lazy Checker Classes
+
+Each of the lazy checkers is an instance of [`LazyDependencyManager`](#qiskit.utils.LazyDependencyManager "qiskit.utils.LazyDependencyManager") in one of its two subclasses: [`LazyImportTester`](#qiskit.utils.LazyImportTester "qiskit.utils.LazyImportTester") and [`LazySubprocessTester`](#qiskit.utils.LazySubprocessTester "qiskit.utils.LazySubprocessTester"). These should be imported from [`utils`](#module-qiskit.utils "qiskit.utils") directly if required, such as:
+
+```python
+from qiskit.utils import LazyImportTester
+```
+
+
+
+`qiskit.utils.LazyDependencyManager(*, name=None, callback=None, install=None, msg=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/utils/lazy_tester.py "view source code")
+
+A mananger for some optional features that are expensive to import, or to verify the existence of.
+
+These objects can be used as Booleans, such as `if x`, and will evaluate `True` if the dependency they test for is available, and `False` if not. The presence of the dependency will only be tested when the Boolean is evaluated, so it can be used as a runtime test in functions and methods without requiring an import-time test.
+
+These objects also encapsulate the error handling if their dependency is not present, so you can do things such as:
+
+```python
+from qiskit.utils import LazyImportManager
+HAS_MATPLOTLIB = LazyImportManager("matplotlib")
+
+@HAS_MATPLOTLIB.require_in_call
+def my_visualisation():
+ ...
+
+def my_other_visualisation():
+ # ... some setup ...
+ HAS_MATPLOTLIB.require_now("my_other_visualisation")
+ ...
+
+def my_third_visualisation():
+ if HAS_MATPLOTLIB:
+ from matplotlib import pyplot
+ else:
+ ...
+```
+
+In all of these cases, `matplotlib` is not imported until the functions are entered. In the case of the decorator, `matplotlib` is tested for import when the function is called for the first time. In the second and third cases, the loader attempts to import `matplotlib` when the [`require_now()`](#qiskit.utils.LazyDependencyManager.require_now "qiskit.utils.LazyDependencyManager.require_now") method is called, or when the Boolean context is evaluated. For the `require` methods, an error is raised if the library is not available.
+
+This is the base class, which provides the Boolean context checking and error management. The concrete classes [`LazyImportTester`](#qiskit.utils.LazyImportTester "qiskit.utils.LazyImportTester") and [`LazySubprocessTester`](#qiskit.utils.LazySubprocessTester "qiskit.utils.LazySubprocessTester") provide convenient entry points for testing that certain symbols are importable from modules, or certain command-line tools are available, respectively.
+
+**Parameters**
+
+* **name** – the name of this optional dependency.
+* **callback** – a callback that is called immediately after the availability of the library is tested with the result. This will only be called once.
+* **install** – how to install this optional dependency. Passed to [`MissingOptionalLibraryError`](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") as the `pip_install` parameter.
+* **msg** – an extra message to include in the error raised if this is required.
+
+### \_is\_available
+
+
+
+`abstract _is_available()`
+
+Subclasses of [`LazyDependencyManager`](#qiskit.utils.LazyDependencyManager "qiskit.utils.LazyDependencyManager") should override this method to implement the actual test of availability. This method should return a Boolean, where `True` indicates that the dependency was available. This method will only ever be called once.
+
+**Return type**
+
+[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")
+
+### disable\_locally
+
+
+
+`disable_locally()`
+
+Create a context, during which the value of the dependency manager will be `False`. This means that within the context, any calls to this object will behave as if the dependency is not available, including raising errors. It is valid to call this method whether or not the dependency has already been evaluated. This is most useful in tests.
+
+### require\_in\_call
+
+### require\_in\_call
+
+
+
+`require_in_call(feature_or_callable: Callable) → Callable`
+
+
+
+`require_in_call(feature_or_callable: str) → Callable[[Callable], Callable]`
+
+Create a decorator for callables that requires that the dependency is available when the decorated function or method is called.
+
+**Parameters**
+
+**feature\_or\_callable** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or Callable*) – the name of the feature that requires these dependencies. If this function is called directly as a decorator (for example `@HAS_X.require_in_call` as opposed to `@HAS_X.require_in_call("my feature")`), then the feature name will be taken to be the function name, or class and method name as appropriate.
+
+**Returns**
+
+a decorator that will make its argument require this dependency before it is called.
+
+**Return type**
+
+Callable
+
+### require\_in\_instance
+
+### require\_in\_instance
+
+
+
+`require_in_instance(feature_or_class: Type) → Type`
+
+
+
+`require_in_instance(feature_or_class: str) → Callable[[Type], Type]`
+
+A class decorator that requires the dependency is available when the class is initialised. This decorator can be used even if the class does not define an `__init__` method.
+
+**Parameters**
+
+**feature\_or\_class** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *or*[*Type*](circuit_classical#qiskit.circuit.classical.types.Type "qiskit.circuit.classical.types.Type")) – the name of the feature that requires these dependencies. If this function is called directly as a decorator (for example `@HAS_X.require_in_instance` as opposed to `@HAS_X.require_in_instance("my feature")`), then the feature name will be taken as the name of the class.
+
+**Returns**
+
+a class decorator that ensures that the wrapped feature is present if the class is initialised.
+
+**Return type**
+
+Callable
+
+### require\_now
+
+
+
+`require_now(feature)`
+
+Eagerly attempt to import the dependencies in this object, and raise an exception if they cannot be imported.
+
+**Parameters**
+
+**feature** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – the name of the feature that is requiring these dependencies.
+
+**Raises**
+
+[**MissingOptionalLibraryError**](exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – if the dependencies cannot be imported.
+
+
+
+`qiskit.utils.LazyImportTester(name_map_or_modules, *, name=None, callback=None, install=None, msg=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/utils/lazy_tester.py "view source code")
+
+A lazy dependency tester for importable Python modules. Any required objects will only be imported at the point that this object is tested for its Boolean value.
+
+**Parameters**
+
+**name\_map\_or\_modules** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*,* [*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]] |* [*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – if a name map, then a dictionary where the keys are modules or packages, and the values are iterables of names to try and import from that module. It should be valid to write `from import , , ...`. If simply a string or iterable of strings, then it should be valid to write `import ` for each of them.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – if no modules are given.
+
+
+
+`qiskit.utils.LazySubprocessTester(command, *, name=None, callback=None, install=None, msg=None)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/utils/lazy_tester.py "view source code")
+
+A lazy checker that a command-line tool is available. The command will only be run once, at the point that this object is checked for its Boolean value.
+
+**Parameters**
+
+**command** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)") *|*[*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.12)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) – the strings that make up the command to be run. For example, `["pdflatex", "-version"]`.
+
+**Raises**
+
+[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError "(in Python v3.12)") – if an empty command is given.
+
diff --git a/docs/api/qiskit/0.46/utils_mitigation.md b/docs/api/qiskit/0.46/utils_mitigation.md
new file mode 100644
index 00000000000..d8f435a5207
--- /dev/null
+++ b/docs/api/qiskit/0.46/utils_mitigation.md
@@ -0,0 +1,37 @@
+---
+title: mitigation
+description: API reference for qiskit.utils.mitigation
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.utils.mitigation
+---
+
+
+
+
+
+
+
+# Measurement Mitigation Utils
+
+
+
+`qiskit.utils.mitigation`
+
+
+ This module is deprecated and will be removed no sooner than 3 months after the release date. For code migration guidelines, visit [https://qisk.it/qi\_migration](https://qisk.it/qi_migration).
+
+
+
+ The user-facing API stability of this module is not guaranteed except for its use with the [`QuantumInstance`](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance") (i.e. using the [`CompleteMeasFitter`](qiskit.utils.mitigation.CompleteMeasFitter "qiskit.utils.mitigation.CompleteMeasFitter") or [`TensoredMeasFitter`](qiskit.utils.mitigation.TensoredMeasFitter "qiskit.utils.mitigation.TensoredMeasFitter") classes as values for the `meas_error_mitigation_cls`). The rest of this module should be treated as an internal private API that can not be relied upon.
+
+
+## Measurement correction
+
+The measurement calibration is used to mitigate measurement errors. The main idea is to prepare all $2^n$ basis input states and compute the probability of measuring counts in the other basis states. From these calibrations, it is possible to correct the average results of another experiment of interest. These tools are intended for use solely with the [`QuantumInstance`](qiskit.utils.QuantumInstance "qiskit.utils.QuantumInstance") class as part of [`qiskit.algorithms`](algorithms#module-qiskit.algorithms "qiskit.algorithms") and [`qiskit.opflow`](opflow#module-qiskit.opflow "qiskit.opflow").
+
+| | |
+| ----------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
+| [`CompleteMeasFitter`](qiskit.utils.mitigation.CompleteMeasFitter "qiskit.utils.mitigation.CompleteMeasFitter")(results, state\_labels\[, ...]) | Deprecated: Measurement correction fitter for a full calibration |
+| [`TensoredMeasFitter`](qiskit.utils.mitigation.TensoredMeasFitter "qiskit.utils.mitigation.TensoredMeasFitter")(results, mit\_pattern\[, ...]) | Deprecated: Measurement correction fitter for a tensored calibration. |
+
diff --git a/docs/api/qiskit/0.46/visualization.md b/docs/api/qiskit/0.46/visualization.md
new file mode 100644
index 00000000000..02e5fd0ca03
--- /dev/null
+++ b/docs/api/qiskit/0.46/visualization.md
@@ -0,0 +1,245 @@
+---
+title: visualization
+description: API reference for qiskit.visualization
+in_page_toc_min_heading_level: 1
+python_api_type: module
+python_api_name: qiskit.visualization
+---
+
+
+
+
+
+
+
+# Visualizations
+
+
+
+`qiskit.visualization`
+
+The visualization module contain functions that visualizes measurement outcome counts, quantum states, circuits, pulses, devices and more.
+
+To use visualization functions, you are required to install visualization optionals to your development environment:
+
+```python
+pip install 'qiskit[visualization]'
+```
+
+## Common Keyword Arguments
+
+Many of the figures created by visualization functions in this module are created by [Matplotlib](https://matplotlib.org/) and accept a subset of the following common arguments. Consult the individual documentation for exact details.
+
+* `title` (`str`): a text string to use for the plot title.
+* `legend` (`list`): a list of strings to use for labels of the data.
+* `figsize` (`tuple`): figure size in inches .
+* `color` (`list`): a list of strings for plotting.
+* `ax` ([matplotlib.axes.Axes](https://matplotlib.org/stable/api/axes_api.html)): An optional `Axes` object to be used for the visualization output. If none is specified a new [matplotlib.figure.Figure](https://matplotlib.org/stable/api/figure_api.html) will be created and used. Additionally, if specified there will be no returned `Figure` since it is redundant.
+* `filename` (`str`): file path to save image to.
+
+The following example demonstrates the common usage of these arguments:
+
+```python
+from qiskit.visualization import plot_histogram
+
+counts1 = {'00': 499, '11': 501}
+counts2 = {'00': 511, '11': 489}
+
+data = [counts1, counts2]
+plot_histogram(data)
+```
+
+
+
+You can specify `legend`, `title`, `figsize` and `color` by passing to the kwargs.
+
+```python
+from qiskit.visualization import plot_histogram
+
+counts1 = {'00': 499, '11': 501}
+counts2 = {'00': 511, '11': 489}
+data = [counts1, counts2]
+
+legend = ['First execution', 'Second execution']
+title = 'New histogram'
+figsize = (10,10)
+color=['crimson','midnightblue']
+plot_histogram(data, legend=legend, title=title, figsize=figsize, color=color)
+```
+
+
+
+You can save the figure to file either by passing the file name to `filename` kwarg or use [matplotlib.figure.Figure.savefig](https://matplotlib.org/stable/api/figure_api.html#matplotlib.figure.Figure.savefig) method.
+
+```python
+plot_histogram(data, filename='new_hist.png')
+
+hist = plot_histogram(data)
+hist.savefig('new_hist.png')
+```
+
+## Counts Visualizations
+
+This section contains functions that visualize measurement outcome counts.
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
+| [`plot_histogram`](qiskit.visualization.plot_histogram "qiskit.visualization.plot_histogram")(data\[, figsize, color, ...]) | Plot a histogram of input counts data. |
+
+### Example Usage
+
+Here is an example of using [`plot_histogram()`](qiskit.visualization.plot_histogram "qiskit.visualization.plot_histogram") to visualize measurement outcome counts:
+
+```python
+from qiskit.visualization import plot_histogram
+
+counts = {"00": 501, "11": 499}
+plot_histogram(counts)
+```
+
+
+
+The data can be a dictionary with bit string as key and counts as value, or more commonly a [`Counts`](qiskit.result.Counts "qiskit.result.Counts") object obtained from [`get_counts()`](qiskit.result.Result#get_counts "qiskit.result.Result.get_counts").
+
+## Distribution Visualizations
+
+This section contains functions that visualize sampled distributions.
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------- |
+| [`plot_distribution`](qiskit.visualization.plot_distribution "qiskit.visualization.plot_distribution")(data\[, figsize, color, ...]) | Plot a distribution from input sampled data. |
+
+## State Visualizations
+
+This section contains functions that visualize quantum states.
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
+| [`plot_bloch_vector`](qiskit.visualization.plot_bloch_vector "qiskit.visualization.plot_bloch_vector")(bloch\[, title, ax, ...]) | Plot the Bloch sphere. |
+| [`plot_bloch_multivector`](qiskit.visualization.plot_bloch_multivector "qiskit.visualization.plot_bloch_multivector")(state\[, title, ...]) | Plot a Bloch sphere for each qubit. |
+| [`plot_state_city`](qiskit.visualization.plot_state_city "qiskit.visualization.plot_state_city")(state\[, title, figsize, ...]) | Plot the cityscape of quantum state. |
+| [`plot_state_hinton`](qiskit.visualization.plot_state_hinton "qiskit.visualization.plot_state_hinton")(state\[, title, figsize, ...]) | Plot a hinton diagram for the density matrix of a quantum state. |
+| [`plot_state_paulivec`](qiskit.visualization.plot_state_paulivec "qiskit.visualization.plot_state_paulivec")(state\[, title, figsize, ...]) | Plot the Pauli-vector representation of a quantum state as bar graph. |
+| [`plot_state_qsphere`](qiskit.visualization.plot_state_qsphere "qiskit.visualization.plot_state_qsphere")(state\[, figsize, ax, ...]) | Plot the qsphere representation of a quantum state. |
+
+
+
+### Example Usage
+
+Here is an example of using [`plot_state_city()`](qiskit.visualization.plot_state_city "qiskit.visualization.plot_state_city") to visualize a quantum state:
+
+```python
+from qiskit.visualization import plot_state_city
+
+state = [[ 0.75 , 0.433j],
+ [-0.433j, 0.25 ]]
+plot_state_city(state)
+```
+
+
+
+The state can be array-like list of lists, `numpy.array`, or more commonly [`Statevector`](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") or [`DensityMatrix`](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix") objects obtained from a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"):
+
+```python
+from qiskit import QuantumCircuit
+from qiskit.quantum_info import Statevector
+from qiskit.visualization import plot_state_city
+
+qc = QuantumCircuit(2)
+qc.h(0)
+qc.cx(0,1)
+
+# plot using a Statevector
+state = Statevector(qc)
+plot_state_city(state)
+```
+
+
+
+```python
+from qiskit import QuantumCircuit
+from qiskit.quantum_info import DensityMatrix
+from qiskit.visualization import plot_state_city
+
+qc = QuantumCircuit(2)
+qc.h(0)
+qc.cx(0,1)
+
+# plot using a DensityMatrix
+state = DensityMatrix(qc)
+plot_state_city(state)
+```
+
+
+
+You can find code examples for each visualization functions on the individual function API page.
+
+## Device Visualizations
+
+| | |
+| -------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
+| [`plot_gate_map`](qiskit.visualization.plot_gate_map "qiskit.visualization.plot_gate_map")(backend\[, figsize, ...]) | Plots the gate map of a device. |
+| [`plot_error_map`](qiskit.visualization.plot_error_map "qiskit.visualization.plot_error_map")(backend\[, figsize, ...]) | Plots the error map of a given backend. |
+| [`plot_circuit_layout`](qiskit.visualization.plot_circuit_layout "qiskit.visualization.plot_circuit_layout")(circuit, backend\[, ...]) | Plot the layout of a circuit transpiled for a given target backend. |
+| [`plot_coupling_map`](qiskit.visualization.plot_coupling_map "qiskit.visualization.plot_coupling_map")(num\_qubits, ...\[, ...]) | Plots an arbitrary coupling map of qubits (embedded in a plane). |
+
+## Circuit Visualizations
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
+| [`circuit_drawer`](qiskit.visualization.circuit_drawer "qiskit.visualization.circuit_drawer")(circuit\[, scale, filename, ...]) | Draw the quantum circuit. |
+| [`DefaultStyle`](qiskit.visualization.circuit.qcstyle.DefaultStyle "qiskit.visualization.circuit.qcstyle.DefaultStyle")() | Creates a Default Style dictionary |
+
+## DAG Visualizations
+
+| | |
+| ----------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
+| [`dag_drawer`](qiskit.visualization.dag_drawer "qiskit.visualization.dag_drawer")(dag\[, scale, filename, style]) | Plot the directed acyclic graph (dag) to represent operation dependencies in a quantum circuit. |
+
+## Pass Manager Visualizations
+
+| | |
+| ----------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
+| [`pass_manager_drawer`](qiskit.visualization.pass_manager_drawer "qiskit.visualization.pass_manager_drawer")(pass\_manager\[, ...]) | Draws the pass manager. |
+
+## Pulse Visualizations
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------- |
+| [`pulse_drawer`](qiskit.visualization.pulse_drawer "qiskit.visualization.pulse_drawer")(program\[, style, backend, ...]) | Generate visualization data for pulse programs. |
+| [`IQXStandard`](qiskit.visualization.pulse.IQXStandard "qiskit.visualization.pulse.IQXStandard")(\*\*kwargs) | Standard pulse stylesheet. |
+| [`IQXSimple`](qiskit.visualization.pulse.IQXSimple "qiskit.visualization.pulse.IQXSimple")(\*\*kwargs) | Simple pulse stylesheet without channel notation. |
+| [`IQXDebugging`](qiskit.visualization.pulse.IQXDebugging "qiskit.visualization.pulse.IQXDebugging")(\*\*kwargs) | Pulse stylesheet for pulse programmers. |
+
+## Timeline Visualizations
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------- |
+| [`timeline_drawer`](qiskit.visualization.timeline_drawer "qiskit.visualization.timeline_drawer")(program\[, style, ...]) | Generate visualization data for scheduled circuit programs. |
+
+## Single Qubit State Transition Visualizations
+
+| | |
+| --------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
+| [`visualize_transition`](qiskit.visualization.visualize_transition "qiskit.visualization.visualize_transition")(circuit\[, trace, ...]) | Creates animation showing transitions between states of a single qubit by applying quantum gates. |
+
+
+
+## Array/Matrix Visualizations
+
+| | |
+| ------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
+| [`array_to_latex`](qiskit.visualization.array_to_latex "qiskit.visualization.array_to_latex")(array\[, precision, prefix, ...]) | Latex representation of a complex numpy array (with dimension 1 or 2) |
+
+## Exceptions
+
+### VisualizationError
+
+
+
+`qiskit.visualization.VisualizationError(*message)`[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/visualization/exceptions.py "view source code")
+
+For visualization specific errors.
+
+Set the error message.
+
diff --git a/public/images/api/qiskit/0.46/circuit-1.png b/public/images/api/qiskit/0.46/circuit-1.png
new file mode 100644
index 0000000000000000000000000000000000000000..1c2f70894dfb00cdcdd33915fd0f49f87eaa54bb
GIT binary patch
literal 4978
zcmdUzX*8Sdy2nGSYHkgc7e!TtR^>ITn#VV)C~ZwetA?hCmlr@W&$aIBx$fup|KC@Pg_$uIyAV47
z0N{fBVPFXWFiA6>XU?8sTveQ6zA?Ys;IxVoHOBsp{
zR9jT8_Z*ukRciDwhIy&%Vf&3$hKu@b0@*fd?Cm0NPYf2lhq96Sd5}s#TTHpU3h7Lg
z7c}AnFh1gsnk(Vj3T0i{w3Raa&!yWha>AON!mp59sc_)=^QQ`JHJ`ocw&9mPFQ3AE
zMWWL(&!F9gJ^2Oj7K-=$V;KtxXIT~#gZM(7m=~CT+d(V$dBm+MXOw^Zz#!Pu7XAcN
zpga5u6ln{Y(gM~<_s=u>~QqzO^`pIwKQUe=$dV8JQo^w^z)O`1?C)N2B
ze4U9gy@~jED}HHd$)*XZ84?oWNx=%B+gb*)Z_3EX%b>S))}WH7QGruWzAZbwfjM&dts73kYC>XpSP>tbj}vF9~gJG4VoXG%*p-=j@aZ&Eu$QsUiW_zyfPM|W4r
ziz_Sdi;CQ&%>c04%y;i3bWjy~YMjI)Uze=XT|&Y7cl(}9=+z8!{T=)(AMDBlF?#vh
zPlR6`vp|$XLm(z_)sCH=-Kdc=voXDcU;+Yx)0i&N$7>VyF7EDIgZeyQ#>P_ne9DBo
z$kXN8KM_sp8A9euC*i_p^k&NZFk;9+HJKTpE;{(m=_p-h6o8TAWf(`ao|1}61!89@
z-*xI>Ac$1!EtZgw;Ns@yOKaTQoPA?%dGDUU@C+9x=Q++Zk8{eJrcSxExw!a+2tO008>Z#dw-rvMWu~PzD9rDG?dxVQtR3{48_S-2;Uj=>*PmTBPMmI_
z6+tLL6)F)Yz_sXG1*L-A=>4X#3{u$GDkSZx@BL2)*M7a^Y^NHZ5W03K(T|SEDG#9|
zwd?Ea*~rLG{2!#lw8Rz{7nPKhIPE7VCQMyjufXT%R@T;n$fgLJ^4QqeA8Tv#?J<0^
z4njvg$+EkgtmBie_mkwWsMxQ7q2oh+$OD2~CTaY_@QKF8I~~JU>FE$dLl$LaWyXrX
zV`mpTMRV^;ycnz@%8Y8Zc!_OjVCo(i5XGL%(ZEv|62_K0Xi3!eUa_zAPW`TfG;8y;
z$jC^x{);?dm4TTk#YYckCs)6E)+lKO9GVe;$&uw2iHMEt(HbFvWa-V?|v<(WfR
zxcj+Crz7vLzhdL#IiGrXl$4bf*VUy_8iKY)tjv8@NSORL3v#I(&nn%C+(#@y0RdbM
z*M%A=TKNvk@wJan{3I=njEshO*p6j6Pj=%-qYl<;nG*+*=O>)*H^#{^}*ArBXo7Aqu5GM>AAfPOhk=B<9}7`>#?i91zp8vlEC5Gpn^z
zqF7o>6su4D16fBLDT7*!NxB}11D3Mc{WgQRUok#S^iIS(W^k>Ut(9oqg7Q3ljm2W0
zK%x0nRsN(+v=}mthTLoTh9hb3ooZbOl76Q1G|njU-Jzmq3bg29{zhM?wE
z@f%!bxmx|bZ?CaM>rF(Q9C=RRDUobtJOku^>vZDkU$IbqRK|M@vuiE6gi(wGEGQkjtyFhl)Sbyg
z4m3^)#{(;@wtF;)Y`KmhS1jHxTka7R?y0jXL!6G5tl7|Q6MLwScu=;_8Ape+5i5hUaMLG{ja=
zuEk!g+1p$vkMAdI*~D&}dUsWnx7Nu_}4)8k<%jT{x2#j6eeJ*
zwzjsOq;k~g==}$Bg2Jk>Dg+L?y!vK+0KGA_hMIv(0#8;==szSw{;7av)$BHA)_JMo
zSXn09y_|}S{udF_L7AM3V9i?jV`6uT&47Dv{s!M3P$5LUJ+9>+N{mVJo*iGq(eLoP
z=n#e{aW3~5lN&8{xTUMx@}V|VLligJ?bFHu#x-9Inm`RNx@>&!fMoe1HgnTOlPU9Q^W!(SdTO*7LSgPTsJ4txpyXCapt3K!q7wvw8Wck!)a6)<#jlM)aR7#SI{xPRXW3Y9@N
zSJD;($MlId4#uIyb
zE`_E9RN6pLv5bPg$6_-W2I>(ZGb6*M`l$dEs%~kP>?%qcPTuc2r?{A|3~_L9sH&=p
zSHlU5h`cW=OFBMAwo-o&4-bEUQyaMX!1Vz^qrCZT-744?aAQ1%j5keSR)#Q4LUT9Y
zEKze$gc}{jDi-$g4aodET+IgK9L>UK#sjVCM)zGYk*K|HRjhM+$OiQd7otdo2b0EP
z_&~39vPngs10)XPO*h#O&2XxQ(4|x7)Q;zOtVG*%czcycDNa)(G6P
zt5l%&SjKA}OazG5tR{vvtyaztq(Au<^*VVvpiNMlZP({Gsgce;HO?{91$}-|w0`+#
z_)sw~3xfv6-p{~O0!M8>Iu+ejJP(v)bHx4=2r`7m^`K?yOdKdsTbSYG=w34Wyl|~s
zy!vChklu97%bS_Dqms(zOop9VIUg>o7EVWrfsG0=j%XvE5{{rUzC`4WFZ-F`hVR39DO%CALYN@jIn~_
zR(mUQ>FgK!nWi4t%*W7cW|yO{Gb;C4RBslsw}xJi+oLw}Ji>uoGPq#9(b`96WgXJ0
zHe?HQVr)JX^EifaaI2Wp@g0P`PiNiS+9Twwq%9;aKvyFpKBFrIrJ52B%=UYWALb~+
z9{*;D;>9$VR9fs@-F6f?+Eo&+b2Gxz)}jX0h(jy3>m>Jw11tMPsB&X0=(WpHl*QIh
zl27CxS@-~_*=64kokIbl$SN_t{QUtaGmD924>AxK=|0oY&sUsJJ=%v2pZ+Hl)_^d%
zgPZX|e3h%Y7oX#g+dauwvD{aU0s;a)IW^_ra2ho*N^BeT;le<6a&q$E@UZ@)NBLhb
zo3QWiU^a-L+Z`QD`>U+wMdI@0+DL}^-rWuCB@kq;UUjBTHZqndK*j5u0TQY8jQNWE
zK|gB@h)yOz;3Cnu-WuKa6AsD(VK+C$J|th6xi;dVrZhA59?
zS!$dhxPn1c#^3tH+ZzM|p&2l`dhOa{(fy@o%CR>TySZ`8Tq!@??fNsl!mtF_#A<)b1S%qR2#lk_(~9g+(q5a@PTsrjzP|VG-bH3)2=(^%N?*Uu0Cwf$E^fw$N9jE5)A1UwU`Zty
zGLF6^_gZoSsXArfuiw=mPmlV8)^RiF((c~!xF_7NMNgr)M=|v03WpSf)&fZyn`c?M
zMW#2p#1@)Sr&cB#GlgMwDBDW61jHtN+37^x8@F+$47bUio}PZe^m>sGQRw8)AdO&(
zX{H)#H_!R|->q^H7KUYO}UHibog!T!^e*Wczn*m)&j`yuKdK3#*<*M
z4;kEhYog|Jp5_M#W0|}wEOc$BQVNo^dM6u08P49lC6c9J%C^+rBLxH_FGAtup?0q+
zcJ>iTWfc|XHuIONs;XO2V)SQ^yAogJ<|YjEj?m*DV;^?jJMNk{Lv#NMcoM{T)YC<|h_8>BbvKvSPGWxmi22vAJ$Q_-rrj
zi|OpCWjE3z0=64`FAc_Ma>U^dFVPRd5@HWkZ50)#2|>EYN}80CUredy$cZ>bcb7s=
z6>?DhYFomrC%P1#GhcDWw47Vf<~^vkx~TbOY|o`7TP#}JR_F$Q)&L`*{-3SuNRL_i
zUBYiqv;|{QH8nSva=qpFXPYacA))rUbARuwlt%r#cU(T5uo`_O$-yU|t1|ju0EnTP
KL8;!u$iD&O7?Ab=
literal 0
HcmV?d00001
diff --git a/public/images/api/qiskit/0.46/circuit-2.png b/public/images/api/qiskit/0.46/circuit-2.png
new file mode 100644
index 0000000000000000000000000000000000000000..2184a3d1db1b8be3cd5fb4e7a207ae02f9c1957c
GIT binary patch
literal 3885
zcmd5OObs^J|vAT*~StR
z6Irs98G8*eS%z%czo$RnzxUVo=lyZs_w(aE?&H4B>%6Y>dJ?P<#++}>&DHB9&l3+G;|2GL3;*zO%22+$3
zyBipY3DA&}^Znle7~0=UPHg|^J$MNOW8xS9033+lIDrenUjzWI9MkLiwxM||Q(;!4
zTSw&ebB#BH=SwBT&T$TXe$y=?DMlAzoRc=;$c;^)y5o6;_y1O(FKQ_<_>O-(hkUGn
zikj=Y^Z44K=db9eh(BMn-{m)dXOq_&FHP5XfPIS`gnmyB6Yyw~-H(pY_RLFQ_|7D2
zQyG!FwM$~APftqlJ}f4%ib>eupPI=3o1y5;t(THv!=j`zfn{?`7f#ivK$9IBG2)f3
zt>bbVn}3;@oJJIA-CI%+P56`Tbv
zxR;fSOVaqb)6GWA324M7j~&736b^R`+u>wm>m0j<;y%aJ*nt-9O1&R#I%;92iCqsZEan?G#}Khl^DaJ;?#txGL*
zO)NY-900JbqGdMVh%Bpk^)|h#Dd1vW#2sbyktW(|Tu}YU%B2hC#){zNN
z!){7Tns(+Wqb#;9EiK~=iu7Dv3pk~qIf{ykYgDho4l(>t~q)4TfxfuHJA8BGAKYsK*9Q&a_OscJ`
z;~y!tBt4U{uf9(+y5s3-P&_nCFDo<(2!MBXb^^fJvu81Zf!A$q(|e98D=Sa4vtKhb
zjN>eYVyFLJxX`lo#TkeKbzo3pEiNO&-hiHooYTqA&sU2)P?NZLvBqmq)a2>OrklwF
z0|;4A1y(E&3Z1@`B&?d6p8jBM4U?Xpt_RCx23*6}4NtPNGDj(xG&
z$HO!oeE7?%s)o=3Vo1aZHOH1iQlS07w^_CZ*AU|;~2NhA_!YhOvg
zYGLc^n@zRG`a0o%mX()7c6WD8%*{#7K}&0(251xL_7#7DB%_hy-NSLJ*H3`-W5M1*#o)765|Z;&@Z
zEU_of$+;@&m@`GSx9j>%wvXlHwKYyF=$U%Y*Ll^BH8w
zaPiEKA3tQL8!CQ_>po*z+h?+o2ROsW7YpHgzo+Tkxms`;dhl+hqoc#e#ob+8NJz-y
z1s;#T4pzoMzUCv45aG;*w{MGTYkA?Gebv8eK)#;aRa~7uGKrHD+7dwfDVvql8V7_R
zS0|fZR#vJw3h?l_s0@8NMZXKJv?k}Yi|$Idb{W8A0Qu(dXCIWc)=`d=Nxxr
zkLXnsrDJ1awJsZ?vU!TPtBr^MYc3K*9t7{5aIf+nbskE&{
z{txBD-z*8eJw4@vWqvNLqKSC?Nz8HJ@bC_U4l@B#B_Um1T~=3~#mC1l`e#IIoL%80
zCJs}n=Rao3k)K>NPEAdXYHU<{`PqAJZtfkJZ70GP$=*+&tXj6mQIvL^E-xS7dLMjH
zkg=Gp9#D!=<>HXCDMOqBz*^~ev2qpiGn$ngz9tx(Fl7hiO%}vRc~|k6&vf?)9#7x88x>vckTqyWV%=K}(lkM+H>Zf9iP7
zF%mg4o|l*RX?XbdQ2Bi~x945@Oi@O~`Y2RI>aot${Zy>~;otG>Y-|R4dU~0eL%!}_
zPXrmB3k#3~?KU(yOA%>S=occa?9FdxZq6ejGP$4`WP9Z-*k7@&?Qf~`aHPH8OdDsC
zQ7jm_bBck>T_2zKlT88OQT)cj-~?8r;&ys_Q|P(`Fp{VxnbF;Cq@G!VMmCOG|f`+%^?_zYm%iCPLlo!n%I*nuW-}-#e;hu$spsdD_-(~7~0sr
zDv%;dhX7KycD_H{m>y8H3caQQS(&ly58e4x21ISv?YB$qtc?|j#)L2YFxHCrgO{UN
z^8Wz;hm5Pv&#lX67Z>9}TX9Z-&nYP>iK(avu*ET@=pHr77glc12$twcA@brQ_P52a
zTfVt^q&wM<9Wt
zT?RrXSw=71E_H5+7=>Pb_Yy5{Ex%gM=+M}2u6
znN^QdFpK_AX{iA$leSEKy;R3*1Gcjg5?0`~w1tM(Ae*1>@7x`F$wW
zClH8?LvH=nfVYT8c`+|wWBoY-4=LH#7+%fcrFDAN*1YxTnPl~V@3ZfsnX{Bp0xG`a
z55Pp6$ftSda~(TxU)Uu0GVe9k^D7QOamgIY&N|&*{NE3EA;K1SB3kywljPbDc;n*Y
z92)#CfY!|kgznB~ex09>(+=C7eP-|4VRJ(pxuq^?YOqdads(IIHg0>C-+#ZUL(J1i
z(mV3Y>|Vb!08p#l9e8zxYu!mcTG>IAEjZHHm^FB1Jg&N0UYeinx9v$tFzxR!RQ)#S
zWjneSp8Yw>Qu{i;z>yrS=Sd)pyg-Cq;3-Oz?;MHH6Sd(-D4st8FC<0oKOkgfKUuq=
zJ=|^Mm@?H?y1clkXJNt7+uK|1*1<$u@dXXzx}_y2*p^NKSxWbKot&JW58drc<~ef)
zz~OMVwzdwNSvwpoN~%j?S`{ZDP2^+l<|Wk{MfDS|tE8}Se9>&~aaE_>4{S>{h70r+
zmd%=}N&ap$+ZWG7eLOJ{t0*-(R!O^Ks&32I?H;^2
zD!O8RXk01S$c_pYE-5)UJS_U`O}tt5*&B@5ZN0{6%U3Nm?1g>6%}N4ke!SUr#XKUj
zpq_s~E8;Dz#5$oca<6>imVXi+|G=&y&WWJnSZP=BTXdkQ^(*vnQCHwde}Bd4@D0ml
zN)7Ww16tMblIhd+AJgn|El~#t;hOy%wS0dEeF
zX1Ay-pU0Aux%zTdxxEGp48e2>$T|S__V%`a{q?o?nT+)1%L;z`%Wno>ynK0D#_qLV
zV4zYjXx_ip+-05XIhvZ9?6RxApX1~@rkP(qysyaX;pH%|U}E+30?OC-S@1GNyxjIm
zPgj@W&&|zrP+9+BX64HA-PxW%o71|J((>~2OJ--??t%7XZEXDLv!`ZOn1R{MR?+6t
zid2O*OG1xd;bp_JFUop0IOd_RHa^;HobpDdl7ht6Ju}HGzrX&)$T|j6J;!&;xF)*5
PUsu4?5OKZIz%Ay#$2BS`
literal 0
HcmV?d00001
diff --git a/public/images/api/qiskit/0.46/circuit-3.png b/public/images/api/qiskit/0.46/circuit-3.png
new file mode 100644
index 0000000000000000000000000000000000000000..70abaad117f4769f0332920b846eb7ed88dcc24e
GIT binary patch
literal 5628
zcmdT|S5#ENmc0#%fJ6bw83B=;a}JUbp(ToB1f*%n8A%326hx7%2qMtX#72@JNhJxA
zLz4xXAekn=;!XINH8bn|%*TA(?z?K;y0_}o+57B$o|+ixkdrczLJ&l*dsEXCf?yut
zK8KhH{QhJ!tOI{?zFHQ(w-GMB0rn4_Awzp#Z%>4;=Y0nbf9Hoj_Yqza!m`5Rf*fwX
zzTQ6aA|em|^8sPRLst=wqtjOK5)$v5mOcKxYAhX*6
zSfUL+5?GYrGkLYP*=KaOu1}i@5nR<0bhFJj%^Q&SGPhd^!Oqp})KrdPQ253d@K@qP
zQF&f#WiL?hOeAdJU86ynydddo_(c|4I_KM*^NkU*`KAPMR7uC*w&foCd~f&~a)8|?
zH}+aj`p%=9q^hY2H}qO2c=BXvnPEs%li;2O4K+!my`d%#6emUf3i^LNxGHE1RiRiv
zH?0Zi-`TwB>Uz)1ZDmLdIjc!~^=jJ3tf8fGj7a0@;R+n(xJCI6zZ{pB>js9EvD=L$v&3W!Og04xytZ@lav-VV6
zTrkn%r%x_4p?SHkKrLxcZbD=p|8=l{Q6PnMeSQ6naP*GJXS1b=FBN&6qRd!YM{V}d
z4OmaMN@7=+!SV5S@5a{Fx0D-q1a03KCU-6nQ&M&m+{&e*qKd>eglK#=`%qiUBqt~L
zy{oJB6}Qd~w(Gs==Z$WesT}>c!o-&^x2%n0gwPkO^@ZO$u8x#3NV(Gz5EAwk-4WqW
z(Hj^T;E<7_pNcqBYCPGqo}ZtWw1VfE&is0>VNx`BJ{x6?5kz17(}tGL#Y}}Wg9UHw
z?{`er1qj)`Fs#5}I+CvGquu(r0)v8uf7ZT}CES3$?uzU5YkX6jxhTwmjdjEGmr?4=^^78UX4U(IJU72k9
zZ4R4)zhI@6kh;3M_jD6X!t0T&9YS9q1ySpnJvL`4mF7AD><*XQrr(#v`kIBwv
z*G^!Hg%J{Q@bFyVHrq^GBs$n+{72}VUn
zQ?sxlZ$e2H*aa=n
ztzsLjhtq|ut2vaF+3u9yeem!d{oO#=4S2DtnHg=qarO({WZvaq3D+JLo@>|MAukKY
z^D$U2&;LkfP!5&d+S)?94+_+uogVQE3%BDp=WdysUsO?1(SJMQWss$4Nl!#CY@-UI
z1TVJe^E4rB8m(}prlX6UIy>F}Vo28$-tl#y;w#G7uC;ZxL_KvYr}MDOJ~Fw
zX-h4gwC70V*49H1)8!~8Xkubw`tRSwWIp3G#bPNYay@;0ayGj=pNMiKaR}R9h3K`4
z%mgcVgpePZ+Gy*l_=;HcCWAgy=NuYr
zY!pzcLV#C%N#%i`iHfrJ+U#u9!S6BBFS7XU=?!x-
z&P*dh94_)O_~u(-wLkBrgKfbhON>k|J6nb%q@?PanirsZ*!m!T5fPcdQM*gKbB+V7
z^1e+`7cZlOcijOe5&|HRzmdq7(bCe|*xB*y6aUlhIHWBgB&4OQOF}@v6j2ukFVcd;
z-)uZqU41R!yR$UB)G;P#Q$q!LAMV^|Q3;=zUPvQ#hb-#+h1@+nW@cs{{Yd7+XpN${
zQfzciIwGP%_XNLx(#Z`U_rD1bL~YJtKj!7lEcN9Qi42>W5Psd!M!_9_zP|pz6eBg8
zRrRW{s0gMguW;t^n1c0Nce>0tPqC7sqKTQA(+2)yL;-SKzEO@8i^U2R+GeBCqVtQ3
zD{Kn#^0;r3oSe4JV-NTX!bWBn
zJ{|@SAV!Ga^{Rg7`%30k^|G;7^Q7I-BosdtoSkeux3-or$Ge`;(9j@kU_F+eAH@{t
zTe8$C@>SEofXt;U^?ltK?#F}s_Ynps6g5Jk#R&u8#QAAS!SLRRW6Zr`c5@6K28|f95QHp8Q1ZGRUz(TRB8UO%SX@;Wt|t$UL}5$H(V(hwXGsO|RSyKXBI6*8WgXK&;@u8fk^n
z*45R`MH}hr_SqJi!QpXZV^;P1*boR35fK6OkQO2lvp?a}3xh~WNlk9u+8o%712p60
z;z9rg?<_qkv90@1T-@d4$E=?oLUK-57FAcu`IPB3{w$Lm)XV+iU5`|3VizxU6|`93
zP7DFk!R=Sj1&wGXe4fl?tzWbisy%@jrGOM7i1WJk*;hU{4ngX-ukj@Bb;aY*~HTFU|_|M
zJyA-s0G9Ld;{{NFTB9#fPUCRyboN5~jKl|JEy0V|c{SC=IQzTkq`Le1`lhk6^72e9
z1F9|9nlE3(ia!VS^z_^`Fwk^xaEM+W9UWy*3>2N;id#h7zJ0sf!uALqwC&=Ftsl)P
z^YimNM;5-P6%d%Lyw&1lB-co--;HXoN%vnC3EH_U37i4E*t&qy$=x{n2M&O2wU9_L
zE^d@7Mbg?-ESK+Ekd@W)T31Yl2pZ{kJt3%AHhrD5?Vr_u1dMf
zq2Tf53i}YW&T5NXT+cOLTEVRkElJpnmA~NIy(Pz3l>skmLq#C;=>udSw~dk1HL>b9
ze50m_;#UUl##6GoYeNms1VUe;FF|O2|0}b%Pst#QFZYNhY*0&d-H@?Y=g*50P)@Vs
zD-4immDkvaIR9s9_}}Wqe`T;*%wxDDHZhTM{-NC7+PLfTL(d*S9-sih`1ttnhljIu
ze;X@&b$1ZeSY{w+m#4m}RC|s_O`Yyx-UzqxHXQs(U;6!t(rca&|1~7sQ;=3$QG+w+VtC&mQPzAQ=Zc^sNJb@KD;(IHZRlC+?V^u8uorM
z$4R|<1VHnv%u%Oc(0#HJh(B%_nc*mN>R-yiEeILDbhEHCnBJ-RUguoeQSDS|%4=Ns
z+47j5ueT`-0-HDt_Iqr=`}=DT&b_9#Ryy?$4)?6EP~i3(uWk2r6;-j2-yjppbzki5
z$!48WzMiNVbi>Mg3YXigJiA%AzAq+nA;+$i&9J0G<1q!O!JeY14<876dX9x<9K|#S=PBDoZmlz?I!TcuNxlVeQck;0edHN?M3>U6?S>T`Pg
zqK6fx>M(q9Dz12I=PIj&xsJr#{CpzdM1T~m`KW
zjq#ev48W>sYZJv$u#ze$bY>2t3JROw>X;&njVI6g!XaWBPEUoGlpNDT4WG=1+i_Hl!w=F3=53QK;I(h9r~
zh0?OIVL3iNo}Qn-AR{Alu0_YIAJmG0XxHXce|%QRbUf9jzw~}R>QPvBnXjD7wd5b7
z*AMxw%{V
zovTMWXVkp?!gs#O`QEd`AM8|kYYpk}>LxiYb7`7eTgM~k+Bt!N02-uryuPBm+{DBr
z^7bdAW!s+7QAXf}v?oceO9wv`7Pc1zp9M?POt~)D_3_PP|VQwG%0tUvg@A&$g2I0;D$|S5``DYHH@_50}(<&tzX!ns9lZ9j}j^9|%ZQ
zdJvl2Q8xapqJoC@;R-gu*#e^uf^+VrfQ6ks*`Gp)8W#P#}X@>R%3OCfgu{r*{
z*35dq#W=cn_JTbe4+{?u5ALYn?okNbp9~O_^M}=6T4vWsK-q}4;3(@X_Vu5pj01xv
z?}v*4Zb>o?C@31nB946mU~JRL+^75U(xI2xC(-W;xqPTs!je+10~BOuXIrYw7%j{{
z(JD)}sx;U=xrARWnp;}^^X$$Cbxy)wbi8&FkEewgyHd!Wr@zhq`XuMu&b~PrR_kNM
z`@LpHLuc1h$UK@SN`oTtuT_|8=jP^MkaGC(7KwEW&2tnQ
zIj1dXT}@U5M}0foU19F>@cP@4aVL6%lxqA{cJ|{}+;O=8L9)o%3&0pMcTH8eQaU&~
zZmu>xk_}k@tBzfDyk5`L+CDfmAE(HYzfypsmtJM$2
zz4zB`p(gN|zJ`#1t}G>HNYr=9#2{6)d4AX2Y>-13DKe0$Fr(sP^hc$X{HCsMGc%$d
z_QmGK=i8qgc9!}IN=n*KPmW%_di4lE4p0&6$>FBFb2|5}qKU5&cENue_IcRZ*?%-Q
zt3CAbNe0K0hsWcI=IZO~d7$73m!6DK-m0*ZVW0jjN}9Zks2dN;!^@uo-=hbDNS>u3
zkfN6+;raq(os|Atod+=?L(;1~lcX8F!m1;ePbZ41)na2~`2_`I8XA-UmplWC$+DKm
zUE`nK7K?pqKQ1nUe>PzV{-X&43*Gv`#~}BRCn_rHWlGB6e2w4A5GOxBv19vlH6*f(
z@y5sMb~JDKLm;!%fcft4???MA8VOpKYyPdt$Y41)m#)28ZCeYSWx(o6+|hgR)ZWl(
z0W=h-n3zcOOrL@#!t@Zz+5&wKw)c06GC?~U0GV4sff?9*HDIEld*E0=v!>E}!ATD+
z^hUs9PbSf@NnK6Nz3w!rk#gtDf4b8jgI-AU@Gz!X_MJi8;bE|TiopZWjB{E5N&oSv
zfB*v3ECvY2=Zq5Gt0Q7v=`y8#vbssYatfLVRndXMn-X$*u=pw~ivp~GJ>r_-Szls2P8{-bGJO-}}Ds
zu(hMZaj4kxT-6Z}5Qu`V*~d?xxMgJ-fJ)aeF`;5%VR`xbwbOF{kC?zZInXNvRrFtx
iEB{M(?EiB5vC7sE&grNf;sKplNLR~9vqb$~)IR{GIdn+?
literal 0
HcmV?d00001
diff --git a/public/images/api/qiskit/0.46/circuit-4.png b/public/images/api/qiskit/0.46/circuit-4.png
new file mode 100644
index 0000000000000000000000000000000000000000..d7c78dda5565f4b92fccd801bd519bedc15471f9
GIT binary patch
literal 27444
zcmeFZcU+Tazds(Oipr|>QAAd)j0y@0MPx>$mL;G}kr9+7BkUoBB&Y?nDqvVLqq0GU
z?2U+uVMW;xAR-AHA^{RY*6#|n&p4;gdCu!O-{1M`{L!W_3dx=OzOK*b^Iq5e%clB5
z`;P2`Kp;Yf20xoaAm4~WAbdJ|c7vaEoJgmD7mc8cSA#5k-GV}|2e?8^t_S&f`v!S?
z-1t7kH6YN#*GE<9tdh!!?{5YL`2}h!E5rZ#3rfBL?#kaYId8z5?DaFS4TL}hO?m(9
zK!-j&27!1!GyM6y<*kh63B(hJV5BmKZvWkrc-*gkse4@vUd!J3_R{kk-`=^Idq(KU
zZz&&!F8}3XI$y~_!kAQeQ&nzW7DqeJQ@l{xrIWK(GGBRXD?MJDS=nW
z;qhMuz{|O#uXll$r{7NP1TUBG`SE_~$DixKzafA5!JhZBZ~yimMC}3h3le$Z|NiX%
zZpr_x60mVLz($JwMtvevn|Nhjp)*!ItBL#B$Odd6%L7w8*YD11VQ4~0rC?t@^*wxu
zx3B*F4fS;4gk#fLRrlUY78Vx2JUslkOR4chu}zt&v$Jz)-RIwoQbOMls!rC2+ES%O
zWQmTL6KJL5NeT`J!JhsZnJW-E8Pp*eO6oIK?iqRM9M~?Tp7ZS4QFUTOV4fK^D>gRv
zQrb_2eX>#*!YnLFbXWGkCQ9{g=N-d7TCp96r{mKYr!ErVMctyD#^Hf6+u
zrY=;^EtnpPP-ftYkQ7+GQYw9d)L@LU-oXb7re^fT%W5;dnd!lcL#}Oib~WCKlJW5L
z>`Xjvf!QOfK<0-M(Bh&V68%WMr?yp%LCC1h#j
zagri-xppzh2$yMWc8S69627&xuz?eia!5!>uc7OEfQvi@-o3DlemeM6pQmLMjYfNM
zty-bdt!K;&78)9we8LukOOU6Gg-kzEpDArz>BPtys|3w`Xj+E*c1g3^q+KSP!gN|3
zy}Z2Q77_IPoIEx|hOyZJ%?fQ<%Vc!B>n1cbG@uIW^G&rk)EG%bPNyS*J9W(6@@bl$
z4SJwlPYZRky-ftH;N5?j+G+Kyx>_wbIJkZ`3qc!cx$*Wl`_PGC!w`IJIf}hiRb9Qj
z|IDRS6Oei6!B=Bewi
zf7L5$E?9O@V~itngHnXGWp3mX8)*v>!7GzGmm!b>lvd1X)y+Mk1^e`3gnN=~98-4*
z9CDfIPE9@S{L9$bSU|stdMrNZ01d!f4lo1&bvn_WE%gUfRE7$a-
zR#u-Oecs0(Wls)zo7+*R5As7xYvjWEa~^wm9v+=l1BRLZ;Wj$4pUynO$M*p;&gv`u|!sz
zPLRv~0RnOQuwUu2TC|9C7GrHTzqwh5cUzWgiCJrSDAYJbsprl80~U66sKz)64V99T
zlCaIGn9ye0vluBOu&3WW61PeHTs(ffL$>ww#;YCeVm&x5M*{lyt1RDBG`6*|SQ$X>
z?0$0EIc}MPATp_<=vC3wGw^HCf?}9BG;6wkp{RKGxJzs+>vlT5krLW!ztDOiyv@tZ
z#PsmvarRZJfn6W_0X0rK%Rb1By49bsb$bH~cJbU%@T}oDjI3cr2kDU^wFAxS2wSP2
z4WNy>=QlQLQEqi;sf4bK@3Xw+A{H7EFj$p?)T0*qCfBmd)a5&*EJho^oNxn_f@*e@
zz{bW#s=BY^Oi#Ma?V_{c?^kAZQXhbOeR!n1{+w01s=KLCu6dqm=Cye+l0k}+|Gm~?
zz^ie`+WgxU9ol^O3J-yrtGP$?sq}V52JibJRPX_K`Tu{G$!Y1^_3H7byvBrCEd_^*
zqyFs)beR3T0=OfdKiEg2zC`HvwLI&y0@t!G)DG6k|74=F%zgVn)E#UEUWvT7|5(7N
zYl`c}!k~w@clSXX`z!O*0+or}oZ`klt5=`Q;ZXHV2g5?kd4-Xb(iJLGD6+*0Hox;}
z?Sy}aWc_-du_~y4<9_Wz9yf2k?@=da%=hQ#XJ;QvkTWR?x~~($WEE3CkCDSVghDCR
zluAk|PImajdqw4jBI4o?^DCxOwyEQ_C&H+sIf*Vm>#1y1k?yEs@~$V9e!Dws#k?Zt
zWIg3R={}8$H<|v}x>=tZ|4_mOs=jzemab$h6`?Rck~|=j`T=8q_NWHplDVD5{JuDQ
z@PCQuAHqHrx=asEzysTUB}u^fKFEW$mGob>8Oy1id=~CD0c*{;z9fVX+TS>U*+)Wj
zVMLlvgEi~AaQAjWrD8p~#l@eHMNs!KX<;T%@jYsy^7&a;A5(=#58&m{p`jHef%F=4
zOb4MW4(FT@+NxXFuU|#f+3=>mMPT4sA-)I?!X-`FROIcN9dmGwZEjI_rk48RP)XOF
zT>>Gy1PuEI20-h|lL570yp`ogahl4l@ivBg1Z~IDD6>Hq|^0$W|o0w4GpQYL~C~C7eq)B~ZdqAbIbmBNlOS(4S-m{s9M@Al?3nJ3MV`Tewjw-#Ei*II!`GLxx~diO
zle}1f!SKj@YDa5|vb_$g+_8~zEyRV~>5f>Ah;g2-X^_cIkm1cT9akIUM))X{H^O&7Z)}D;)~*@1kl7M33rcqRpeGG<(r&U
z)T-GcCmkcCPijFA5Q9uaVqf5DdebhQT^#o&RF&cvH6_}AsUfkkb`#UnTq1ECgW#-&
zZk7KK;(6HrLMh{Qnv^uumtzw^huRZj4(^D_E-5+b{O)04keI}7P`k7Lv`_DzjS$$-
zJEBrSUN=fU|=&B;#}_Wh#8V#r$|Z106zQNY(UolwvdY
zV#D2uqPrz9nQPgnd82~D+DuPZ{87CMFb0i>&1PzFS!;m=cr7^r%W}zzpyJr3>$eIP
z78gYd8;9a!5af#H8(=gzNb#)U$e!<-`
zlL=LqBnXGNm`n!seyFMuUc#oU`Xo2IPB
zc0W~T$R`!4L~MTP#zLWBD~;CqJNvY=>(MJWJsGB?xMR~&)ucjyz4iqE$TAM;utQfDZH1#_FEE
zfbk4oj}NHpZ#l}CoW>!+BY@4-pBp5=>ih<+Y;r9XmRG+$;rCQnat<7_mF#!BNZq|RBhe`LQl@5g
zUoPn3ma_jN`sDwnmp`9goX(9kovin@rD8?oYn2U?p(%+*Nu~QBk!?@Gn03y#aXMBj
zU_Lj+ZE56X{ZzDg--i$J>Ao!*{rP5Q`uh5ECTW)Q-yxQ03>)&>>aOjz?nQJbIwTmE
z+Q!>B23fTZUksiHn3nyF#59x11elgPd<^&G3hrQ;B6lwY!aN50>U4)Z?&&_!r)9yR^6JF&6Atwhwj#`62B}`Zg2}OZ1%bRm9X@p4
zDpf1g2kg5PfLoUK9m3=k7J`xBk|7ueQ?{n?bm+@8*ZE&%=W4Vy|k|8YcCDK`_9N_g|QHf*MsdMi`C2u@6n1XN0ez=Fd_gb@r4y!KWlP`90b#)j`rBK;rT#D|Cd&k~7aq34?JR7l|
z&*4sA0M_gRkVwH{cg%Uv!$zt+EHF8FZWLc9Q6>8)YF9E@OZ4
zFrTE=)RHF=l;taRAF%(S!&^Q*QiO}oj+X3O1-(-k^(_RVFY{+D)}dXJrcQhvE2%|o
zrXZE28SnMOgG!QQOa@DZwCoXB#ZUbJB0Et|>><-ON_iId8F97Ef+6{#{paiw;W
z^t(h*_9iCOJex<|@2?+YHps+6?y_fR$VJPjqWfU{g<3y&TGXAct~_iXXd)HyrH#kE
zgnen_-)_7)38tOp*V}0tAE#rWtf_G{m(3WeZAp5j7i0a@vmiq~!&X>WcxG_=b4maN
zLNmtiD(d_))vk)>ut3K|$1VRAGB>(s(VmGQe+(V>*I#K`>y<#WR@t@+f_w5MQdsW>
zNW~&c=t5k->7~gqNAA!r$g593*gst;fwk%?+LZE!7}^L&t94DQeyvw4aM&S~{ObYJ
zg3H1Dv@YqouvR9D-o<3d?1`DH&X<#aXs{A~A}j|U`u^0y6Vh|l1OdFk!lHs5p!E6D
zK_94f!C_<&rZaVb3}J1+xWTcS3k46Qp{QY+M}HpKj<{uwPT6x%ePxrR(~lWkOsMDD
zPKGSYk|O~E7XAe+P=Za}DbN8EX~X;yu}(tDsUbNv?hgzAEZi$uhzgwP27s+|pwL3m
z0Vo&etiJpAsQALNpdEfPXMJwvDvrRv9|VMsB|nd%v23u3^4O#|fY
zcjG~!)Cm3D;vcnqZc#Z86diyBaoOZofe#{C6oWB!%LZ^wkuBG+egm%Q-YAJ4
znD)}SVeka|x@fBPl7F3hG6!@zTrxiY65mbeYI?neQY`y5bJtllh|e
z3*i{~@?}sRk0aLe`*uKz;=t0W2w5KMPE%6^odEaz;sajml1bG;guIKB#>(7Pu!jhn
z0Q}m8#C@*Osco&3W%Oc5tiN03vW6;Pr~#12?ajUY8Vpjx8gG*k
zYJDmAfZL8$*8{1q68ND$U9r@7&=|wxt^=m*pHrW_KGl!q1jTC1Jkh3)2ZqgR5mUu|
zn@&q}H#SQaqf8S3$27$SY}$9uJQxq;ciMLvap6(C^xoyHx^Xjfnnwo&BGpQMep)V
z$f#a5=4Ms--{{e@2(n_Rj&hPwVM$5P0W$OQ{VC6rm|Jyvxb(E9ee8-->YHuXBz(43>k>`cpo#7=z*
z4qZ9>W?Ja(PRQIzzzx6q@Jug|oMht$NcB{WKsUGUCy&ABjR*Ccc=-7A7FiY3_KE6l
zeTOfbS0pzUQhv;fnim+I
zS8bKjWhC}@cmFAu2OHaCMDQ%e8n5f<)F?YN{B%Ix^b&lTBWf`E(pf+Gq-vD5p!G&D
zP781B!jq$tQiojCUzc5R}oMX4ost3FVZnvTqN|$Yo+!Ls7V4=@ZHtjDXo1xz;e0#y!Af
z(!r&LgTFScn01L&Q&VG5Q(7}b(3|a}El7l^_UapZ6obroBd>eqnZoT!l`!uB8V-jv
zlMz7M{|=SP4AKx4=CTk-%%!g_=f<0RC$3c$TsXJ`3BQTda2XL(vJWtQSiKuEr^l3z
z6t=q2o1t+$$tYDb*fZA{G^+xm|B+4{&nvF_cc!Cl8tzQ&Ha`h^P4Kr$=b*Q^Z<9(v
zm48b4pDJYFP5wLV?pLT~!sFX48-A;pj+Upi)@}2#gFy9We`3S}HaoW%yxW|3^hMsg
z{`xW1GchPC0wdVqx8rO8fH>S+z7=(FB9q|w
zJH+WRT=Zw#i9=p>@zDK~e+F_OyW_aFEnGk^E@$FwRzSx^9p4LaY6UpQ^Uo;EQD*`m
z)l~dHzX5m#@Xy&Df0gRui2qTlE4e8I>W{2gri^WKc(7*dg60>2-Q|GB%4t|}FDG_6
z7@HZW{AAd(BhHH$ul*%K%|o)j8Md$>bhjDqSUR?npLSFHaKyE1*UVuQ=LM&n!GeAN
zjOX+sav4yrymLpaPR>)O*^O&6zir344m$mxw{6NTU~ACx}&ko7Mect>J`e7Zg{2g
zUZXTqyb{eXBo?flNNK~VTEs59kYx|A_A>6s*cIcZ;a3Ou?|FM~I6sP*g!CV|)s
zV-Lc})GlR8oQg=-{rncWRw@BD>cxackRI-{&iLxKiLWfaBS#zYD4t3PAx>21W$6kmzDqw`%tGc|vM
zb772AZo5SQ;JQBd;aNSkQ?b&i?GA6G0~OW)sGmL!^Lan1tGf>tSs{KEz;f2}Rl}$x
z`=E~(>zON!B8+e#KgA3heDRw@@`ZF6OE0`rJn`jeD&@C3y(LqD9nh
zX7eS-RMt&KTU@ar06A*p5$Ck6h8#!L5yIbL9NuPW3R_bFZ*&6O_|VBP_g*NMH6B8M
zGf48#RC#Pf!0^v;X1WX)4$YT)Mnq@*a+KokkyiDLRMxGxZ8mqF0FI0Hgi{E%0Gik3
zc{DwT#YlysIZ}iaC5N>82juf=YMQ7E&Gbngr5<84QVtf~cCVL4N3^Uy@+CcgptL|A
z+u^v9IE{f}(^&m{Op(Lyu<_mD4m`+Ht_-g8?-jz~n$YG&hp@GDV$&jpPDGUrhYx3aAgL?rtCcauE>s8Ef1m3Shw7e)D#}xnNXI`
z7K{QSa{L(R0!Rlce`Q*1(G*Z_>K~{uwqJCN)
zH};6BI}>F>?$A@jpwT}9)|g}iOL};7ZrFSWBy#7k0_U(-Yme7&+$OEkvRd8rZK$s-
zaL3?4PqtgZfiEB!@p{+OVVz1PM!HtQBRdhwMtUtM_Au(w16b;6WAI(Lh9r3z-BTYvDTBSiwxJ))Ku~4%P~s1nxxr?xd@$44}>yrRMeF;
zVF02$^@TU-c@3BL02WKdwKEY6LO%)#kv9b0zmj_Q{hr00unpThaF+H4*~Rm_ow^KK
z+&|~><`f@bR|sodZ#eaHa!WIC6#CubNtAzXODQgGP~ce^0KE~a)52c%rMuT#3RgTPt#>Ps(GhE8j4vSmnkt@3Ndb}jHT2o7_e{vEvQf-~S
zoT(PpGELH{85~+d%ih~B#6)q-#cSmza&>BTY9jQ~jKl>j$C!XWKVG*URgaF-)Ud(Z
zrOIefnuhbHqpS{=7CiB6!2aH?^LY)iJn5Y+hV_490&Y
z+~nHHZH!WIB|Biq)}4&!vhe+*qoXjgb&`2uBdoN4Vp&`sI1TQ30*k@?rH>#Oye9zC4_GIT!Qt@w`MmVL@$n3OsW6#19op4i?X_+h9M3=jz?fVID7h%swDjyS
znmru&_Mpu+aVQcl+5Q7ua%%q}gm!ha*moK6{2fy0!L9!JMHMp1
zq}eiH}^k|LoPY%>=OloR`76mYC^1u
zb&JdEw<~>0on%LBH^3JG)$7rJ_6+`OJfy#K
zaA@ck{j7HNl{%gFs7Y&>o$x783U7C02v{})ON=|YGYQdC`=z=Jc@p?!c*@hUIBkqs
z#ODJ%D!?}NhvHX@ri+9%GpQ5_S>auf$Q_0Nn*1RVv0jU|#QRUb%YFIsv@e=TSX*r6
zEbYgL_Gki6cfW}Y*bv7!$1V(h2da=`-t5i~#S4oVx?|!c?N>&bS}BF&<+-c~SgeKu
zV_98xS}+FOksW4uP+Wydl=%he(9{zw|B8~e4~|g(OVr*q%zh!H1u)!fmrZOzp`j!C
z7iwoh0y8=3Zgec1|EwG<31(uQ#a)SZjo2BRhO~Cs753tPt+fK*3)0@>X
zs6;G$)P7zCBa?qdunV35bC_3|ljkALNQKqPlj&-k;f>r|8K7&O!OE4FSg$+5P9{L!erdc^WvQ)$9Z?9)c`??7