From 7531f41b284181e49fe9982514a8976e45c1b7f5 Mon Sep 17 00:00:00 2001 From: Eric Arellano <14852634+Eric-Arellano@users.noreply.github.com> Date: Fri, 1 Nov 2024 15:23:34 -0400 Subject: [PATCH] Revert "Update API dev docs (#2224)" This reverts commit f998723472532944210d6164cb8711a8a673a7a3. --- docs/api/qiskit/dev/_toc.json | 24 - docs/api/qiskit/dev/assembler.mdx | 6 +- docs/api/qiskit/dev/circuit.mdx | 18 +- docs/api/qiskit/dev/circuit_library.mdx | 243 ++---- docs/api/qiskit/dev/circuit_singleton.mdx | 8 +- docs/api/qiskit/dev/compiler.mdx | 32 +- docs/api/qiskit/dev/converters.mdx | 4 +- docs/api/qiskit/dev/passmanager.mdx | 4 +- .../qiskit/dev/providers_fake_provider.mdx | 2 +- docs/api/qiskit/dev/pulse.mdx | 248 ++---- docs/api/qiskit/dev/qasm2.mdx | 8 +- docs/api/qiskit/dev/qasm3.mdx | 8 +- .../qiskit/dev/qiskit.circuit.BreakLoopOp.mdx | 34 +- .../dev/qiskit.circuit.ContinueLoopOp.mdx | 34 +- .../dev/qiskit.circuit.ControlFlowOp.mdx | 34 +- .../dev/qiskit.circuit.ControlledGate.mdx | 28 +- .../qiskit/dev/qiskit.circuit.ForLoopOp.mdx | 34 +- docs/api/qiskit/dev/qiskit.circuit.Gate.mdx | 30 +- .../qiskit/dev/qiskit.circuit.IfElseOp.mdx | 38 +- .../qiskit/dev/qiskit.circuit.Instruction.mdx | 36 +- .../dev/qiskit.circuit.InstructionSet.mdx | 12 +- .../dev/qiskit.circuit.QuantumCircuit.mdx | 290 ++++--- .../dev/qiskit.circuit.SwitchCaseOp.mdx | 32 +- .../qiskit/dev/qiskit.circuit.WhileLoopOp.mdx | 38 +- ...it.classicalfunction.BooleanExpression.mdx | 30 +- ...it.classicalfunction.ClassicalFunction.mdx | 30 +- .../qiskit/dev/qiskit.circuit.library.AND.mdx | 14 +- .../dev/qiskit.circuit.library.AndGate.mdx | 164 ---- .../qiskit.circuit.library.BitwiseXorGate.mdx | 166 ---- .../dev/qiskit.circuit.library.C3SXGate.mdx | 8 - .../dev/qiskit.circuit.library.C3XGate.mdx | 8 - .../dev/qiskit.circuit.library.C4XGate.mdx | 8 - .../dev/qiskit.circuit.library.CCXGate.mdx | 12 +- .../dev/qiskit.circuit.library.CCZGate.mdx | 10 +- ...t.circuit.library.CDKMRippleCarryAdder.mdx | 10 +- .../dev/qiskit.circuit.library.CHGate.mdx | 12 +- .../dev/qiskit.circuit.library.CPhaseGate.mdx | 14 +- .../dev/qiskit.circuit.library.CRXGate.mdx | 12 +- .../dev/qiskit.circuit.library.CRYGate.mdx | 12 +- .../dev/qiskit.circuit.library.CRZGate.mdx | 30 +- .../dev/qiskit.circuit.library.CSGate.mdx | 10 +- .../dev/qiskit.circuit.library.CSXGate.mdx | 12 +- .../dev/qiskit.circuit.library.CSdgGate.mdx | 10 +- .../dev/qiskit.circuit.library.CSwapGate.mdx | 12 +- .../dev/qiskit.circuit.library.CU1Gate.mdx | 16 +- .../dev/qiskit.circuit.library.CU3Gate.mdx | 12 +- .../dev/qiskit.circuit.library.CUGate.mdx | 12 +- .../dev/qiskit.circuit.library.CXGate.mdx | 12 +- .../dev/qiskit.circuit.library.CYGate.mdx | 12 +- .../dev/qiskit.circuit.library.CZGate.mdx | 10 +- .../dev/qiskit.circuit.library.DCXGate.mdx | 10 +- .../dev/qiskit.circuit.library.Diagonal.mdx | 6 +- .../qiskit.circuit.library.DiagonalGate.mdx | 8 - .../qiskit.circuit.library.DraperQFTAdder.mdx | 6 +- .../dev/qiskit.circuit.library.ECRGate.mdx | 12 +- .../qiskit.circuit.library.EfficientSU2.mdx | 6 +- ....circuit.library.EvolvedOperatorAnsatz.mdx | 4 - ...qiskit.circuit.library.ExactReciprocal.mdx | 4 - ...t.circuit.library.ExcitationPreserving.mdx | 4 - ...qiskit.circuit.library.FourierChecking.mdx | 4 - ...rcuit.library.FunctionalPauliRotations.mdx | 4 - .../qiskit/dev/qiskit.circuit.library.GMS.mdx | 6 +- .../qiskit/dev/qiskit.circuit.library.GR.mdx | 6 +- .../qiskit/dev/qiskit.circuit.library.GRX.mdx | 6 +- .../qiskit/dev/qiskit.circuit.library.GRY.mdx | 6 +- .../qiskit/dev/qiskit.circuit.library.GRZ.mdx | 6 +- ...qiskit.circuit.library.GlobalPhaseGate.mdx | 8 - .../dev/qiskit.circuit.library.GraphState.mdx | 4 - .../qiskit.circuit.library.GroverOperator.mdx | 6 +- .../dev/qiskit.circuit.library.HGate.mdx | 10 +- ...ircuit.library.HRSCumulativeMultiplier.mdx | 6 +- ...qiskit.circuit.library.HamiltonianGate.mdx | 8 - ...t.circuit.library.HiddenLinearFunction.mdx | 4 - .../dev/qiskit.circuit.library.IGate.mdx | 10 +- .../qiskit/dev/qiskit.circuit.library.IQP.mdx | 12 +- .../dev/qiskit.circuit.library.Initialize.mdx | 8 - .../qiskit.circuit.library.InnerProduct.mdx | 14 +- ...iskit.circuit.library.InnerProductGate.mdx | 164 ---- ...skit.circuit.library.IntegerComparator.mdx | 6 +- .../dev/qiskit.circuit.library.Isometry.mdx | 8 - ...ircuit.library.LinearAmplitudeFunction.mdx | 6 +- .../qiskit.circuit.library.LinearFunction.mdx | 10 +- ...t.circuit.library.LinearPauliRotations.mdx | 8 +- .../dev/qiskit.circuit.library.MCMT.mdx | 8 +- .../dev/qiskit.circuit.library.MCMTGate.mdx | 8 - .../dev/qiskit.circuit.library.MCMTVChain.mdx | 6 +- .../qiskit.circuit.library.MCPhaseGate.mdx | 10 +- .../dev/qiskit.circuit.library.MCXGate.mdx | 8 - .../qiskit.circuit.library.MCXGrayCode.mdx | 8 - .../qiskit.circuit.library.MCXRecursive.mdx | 8 - .../dev/qiskit.circuit.library.MCXVChain.mdx | 8 - .../dev/qiskit.circuit.library.MSGate.mdx | 8 - .../dev/qiskit.circuit.library.NLocal.mdx | 8 +- .../qiskit/dev/qiskit.circuit.library.OR.mdx | 12 +- .../dev/qiskit.circuit.library.OrGate.mdx | 164 ---- ...kit.circuit.library.PauliEvolutionGate.mdx | 8 - ...qiskit.circuit.library.PauliFeatureMap.mdx | 8 +- .../dev/qiskit.circuit.library.PauliGate.mdx | 8 - .../qiskit.circuit.library.PauliTwoDesign.mdx | 8 +- .../qiskit.circuit.library.Permutation.mdx | 6 +- ...qiskit.circuit.library.PermutationGate.mdx | 8 - ...qiskit.circuit.library.PhaseEstimation.mdx | 6 +- .../dev/qiskit.circuit.library.PhaseGate.mdx | 24 +- .../qiskit.circuit.library.PhaseOracle.mdx | 8 +- ...kit.circuit.library.PiecewiseChebyshev.mdx | 6 +- ....library.PiecewiseLinearPauliRotations.mdx | 6 +- ...rary.PiecewisePolynomialPauliRotations.mdx | 6 +- ...rcuit.library.PolynomialPauliRotations.mdx | 6 +- .../dev/qiskit.circuit.library.QAOAAnsatz.mdx | 6 +- .../qiskit/dev/qiskit.circuit.library.QFT.mdx | 6 +- .../dev/qiskit.circuit.library.QFTGate.mdx | 8 - .../qiskit.circuit.library.QuadraticForm.mdx | 6 +- .../qiskit.circuit.library.QuantumVolume.mdx | 6 +- .../dev/qiskit.circuit.library.RC3XGate.mdx | 8 - .../dev/qiskit.circuit.library.RCCXGate.mdx | 8 - ...qiskit.circuit.library.RGQFTMultiplier.mdx | 8 +- .../dev/qiskit.circuit.library.RGate.mdx | 10 +- .../dev/qiskit.circuit.library.RVGate.mdx | 10 +- .../dev/qiskit.circuit.library.RXGate.mdx | 10 +- .../dev/qiskit.circuit.library.RXXGate.mdx | 10 +- .../dev/qiskit.circuit.library.RYGate.mdx | 10 +- .../dev/qiskit.circuit.library.RYYGate.mdx | 10 +- .../dev/qiskit.circuit.library.RZGate.mdx | 10 +- .../dev/qiskit.circuit.library.RZXGate.mdx | 12 +- .../dev/qiskit.circuit.library.RZZGate.mdx | 10 +- .../qiskit.circuit.library.RealAmplitudes.mdx | 8 +- .../dev/qiskit.circuit.library.SGate.mdx | 10 +- .../dev/qiskit.circuit.library.SXGate.mdx | 10 +- .../dev/qiskit.circuit.library.SXdgGate.mdx | 8 - .../dev/qiskit.circuit.library.SdgGate.mdx | 10 +- ...iskit.circuit.library.StatePreparation.mdx | 8 - .../dev/qiskit.circuit.library.SwapGate.mdx | 10 +- .../dev/qiskit.circuit.library.TGate.mdx | 10 +- .../dev/qiskit.circuit.library.TdgGate.mdx | 10 +- .../dev/qiskit.circuit.library.TwoLocal.mdx | 6 +- .../dev/qiskit.circuit.library.U1Gate.mdx | 26 +- .../dev/qiskit.circuit.library.U2Gate.mdx | 10 +- .../dev/qiskit.circuit.library.U3Gate.mdx | 10 +- .../dev/qiskit.circuit.library.UCGate.mdx | 8 - .../qiskit.circuit.library.UCPauliRotGate.mdx | 8 - .../dev/qiskit.circuit.library.UCRXGate.mdx | 8 - .../dev/qiskit.circuit.library.UCRYGate.mdx | 8 - .../dev/qiskit.circuit.library.UCRZGate.mdx | 8 - .../dev/qiskit.circuit.library.UGate.mdx | 10 +- .../qiskit.circuit.library.UnitaryGate.mdx | 8 - .../qiskit.circuit.library.UnitaryOverlap.mdx | 4 - ...it.circuit.library.VBERippleCarryAdder.mdx | 6 +- .../qiskit.circuit.library.WeightedAdder.mdx | 6 +- .../dev/qiskit.circuit.library.XGate.mdx | 10 +- .../qiskit/dev/qiskit.circuit.library.XOR.mdx | 10 +- .../qiskit.circuit.library.XXMinusYYGate.mdx | 12 +- .../qiskit.circuit.library.XXPlusYYGate.mdx | 12 +- .../dev/qiskit.circuit.library.YGate.mdx | 10 +- .../qiskit.circuit.library.ZFeatureMap.mdx | 6 +- .../dev/qiskit.circuit.library.ZGate.mdx | 10 +- .../qiskit.circuit.library.ZZFeatureMap.mdx | 14 +- .../dev/qiskit.circuit.library.iSwapGate.mdx | 12 +- .../dev/qiskit.dagcircuit.DAGCircuit.mdx | 4 - .../dev/qiskit.dagcircuit.DAGDependency.mdx | 52 +- .../qiskit/dev/qiskit.providers.Backend.mdx | 2 +- .../qiskit/dev/qiskit.providers.BackendV1.mdx | 18 +- .../qiskit/dev/qiskit.providers.BackendV2.mdx | 38 +- .../qiskit.providers.BackendV2Converter.mdx | 98 ++- .../dev/qiskit.providers.QubitProperties.mdx | 2 +- ...roviders.basic_provider.BasicSimulator.mdx | 44 +- .../qiskit.providers.convert_to_target.mdx | 10 +- ...roviders.fake_provider.Fake127QPulseV1.mdx | 12 +- .../qiskit.providers.fake_provider.Fake1Q.mdx | 10 +- ...skit.providers.fake_provider.Fake20QV1.mdx | 12 +- ...providers.fake_provider.Fake27QPulseV1.mdx | 14 +- ...iskit.providers.fake_provider.Fake5QV1.mdx | 12 +- ....providers.fake_provider.Fake7QPulseV1.mdx | 14 +- ...roviders.fake_provider.FakeOpenPulse2Q.mdx | 10 +- ...roviders.fake_provider.FakeOpenPulse3Q.mdx | 10 +- ...oviders.fake_provider.GenericBackendV2.mdx | 110 ++- .../dev/qiskit.providers.models.Command.mdx | 6 +- .../qiskit.providers.models.PulseDefaults.mdx | 10 +- .../qiskit.pulse.InstructionScheduleMap.mdx | 26 +- docs/api/qiskit/dev/qiskit.pulse.Schedule.mdx | 34 +- .../qiskit/dev/qiskit.pulse.ScheduleBlock.mdx | 40 +- .../qiskit.pulse.channels.AcquireChannel.mdx | 8 +- .../qiskit.pulse.channels.ControlChannel.mdx | 8 +- .../qiskit.pulse.channels.DriveChannel.mdx | 8 +- .../qiskit.pulse.channels.MeasureChannel.mdx | 8 +- .../dev/qiskit.pulse.channels.MemorySlot.mdx | 8 +- .../qiskit.pulse.channels.RegisterSlot.mdx | 8 +- .../qiskit.pulse.channels.SnapshotChannel.mdx | 4 +- .../dev/qiskit.pulse.instructions.Acquire.mdx | 20 +- .../dev/qiskit.pulse.instructions.Delay.mdx | 20 +- .../dev/qiskit.pulse.instructions.Play.mdx | 20 +- .../qiskit.pulse.instructions.Reference.mdx | 20 +- ...kit.pulse.instructions.RelativeBarrier.mdx | 20 +- ...qiskit.pulse.instructions.SetFrequency.mdx | 20 +- .../qiskit.pulse.instructions.SetPhase.mdx | 20 +- ...skit.pulse.instructions.ShiftFrequency.mdx | 20 +- .../qiskit.pulse.instructions.ShiftPhase.mdx | 20 +- .../qiskit.pulse.instructions.Snapshot.mdx | 20 +- ...qiskit.pulse.instructions.TimeBlockade.mdx | 20 +- .../dev/qiskit.pulse.library.Constant.mdx | 16 +- .../qiskit/dev/qiskit.pulse.library.Cos.mdx | 6 +- .../qiskit/dev/qiskit.pulse.library.Drag.mdx | 18 +- .../dev/qiskit.pulse.library.Gaussian.mdx | 17 +- .../qiskit.pulse.library.GaussianDeriv.mdx | 6 +- .../qiskit.pulse.library.GaussianSquare.mdx | 23 +- ...iskit.pulse.library.GaussianSquareDrag.mdx | 6 +- .../dev/qiskit.pulse.library.Sawtooth.mdx | 6 +- .../qiskit/dev/qiskit.pulse.library.Sech.mdx | 6 +- .../dev/qiskit.pulse.library.SechDeriv.mdx | 6 +- .../qiskit/dev/qiskit.pulse.library.Sin.mdx | 6 +- .../dev/qiskit.pulse.library.Square.mdx | 6 +- .../qiskit.pulse.library.SymbolicPulse.mdx | 14 +- .../dev/qiskit.pulse.library.Triangle.mdx | 6 +- .../dev/qiskit.pulse.library.Waveform.mdx | 10 +- ...kit.pulse.library.gaussian_square_echo.mdx | 6 +- .../dev/qiskit.quantum_info.CNOTDihedral.mdx | 2 +- .../dev/qiskit.quantum_info.Clifford.mdx | 2 +- .../dev/qiskit.quantum_info.DensityMatrix.mdx | 10 +- .../dev/qiskit.quantum_info.Operator.mdx | 50 +- .../qiskit/dev/qiskit.quantum_info.Pauli.mdx | 2 +- .../dev/qiskit.quantum_info.PauliList.mdx | 10 +- .../qiskit.quantum_info.SparseObservable.mdx | 762 ------------------ .../dev/qiskit.quantum_info.SparsePauliOp.mdx | 4 +- .../qiskit.quantum_info.StabilizerState.mdx | 2 +- .../dev/qiskit.quantum_info.Statevector.mdx | 10 +- .../qiskit.result.BaseReadoutMitigator.mdx | 2 +- ...skit.result.CorrelatedReadoutMitigator.mdx | 18 +- .../qiskit.result.LocalReadoutMitigator.mdx | 18 +- ...nthesis.unitary.aqc.ApproximateCircuit.mdx | 4 - ....synthesis.unitary.aqc.CNOTUnitCircuit.mdx | 4 - ...iskit.transpiler.InstructionProperties.mdx | 12 +- .../qiskit/dev/qiskit.transpiler.Target.mdx | 56 +- ...qiskit.transpiler.passes.AlignMeasures.mdx | 4 +- ...skit.transpiler.passes.BasisTranslator.mdx | 4 +- ...ranspiler.passes.Commuting2qGateRouter.mdx | 2 +- ...ranspiler.passes.ConstrainedReschedule.mdx | 4 +- ...spiler.passes.ConvertConditionsToIfOps.mdx | 8 +- ....transpiler.passes.DynamicalDecoupling.mdx | 4 +- ...spiler.passes.EchoRZXWeylDecomposition.mdx | 8 +- ...t.transpiler.passes.HighLevelSynthesis.mdx | 4 +- ...ranspiler.passes.MergeAdjacentBarriers.mdx | 2 +- .../dev/qiskit.transpiler.passes.PadDelay.mdx | 2 +- ...anspiler.passes.PadDynamicalDecoupling.mdx | 2 +- .../qiskit.transpiler.passes.PulseGates.mdx | 10 +- ...transpiler.passes.RXCalibrationBuilder.mdx | 10 +- ...ranspiler.passes.RZXCalibrationBuilder.mdx | 12 +- ...ler.passes.RZXCalibrationBuilderNoEcho.mdx | 12 +- ...spiler.passes.RemoveIdentityEquivalent.mdx | 122 --- ...qiskit.transpiler.passes.SolovayKitaev.mdx | 6 +- ...t.transpiler.passes.TimeUnitConversion.mdx | 4 +- ...kit.transpiler.passes.UnitarySynthesis.mdx | 4 +- ...t.transpiler.passes.ValidatePulseGates.mdx | 8 +- ...tary_synthesis.DefaultUnitarySynthesis.mdx | 4 +- .../dev/qiskit.visualization.dag_drawer.mdx | 2 +- docs/api/qiskit/dev/qpy.mdx | 90 +-- docs/api/qiskit/dev/quantum_info.mdx | 21 +- docs/api/qiskit/dev/result.mdx | 10 +- docs/api/qiskit/dev/scheduler.mdx | 24 +- docs/api/qiskit/dev/synthesis.mdx | 6 +- docs/api/qiskit/dev/transpiler.mdx | 26 +- docs/api/qiskit/dev/transpiler_passes.mdx | 1 - docs/api/qiskit/dev/transpiler_plugins.mdx | 2 +- docs/api/qiskit/dev/transpiler_preset.mdx | 42 +- .../dev/transpiler_synthesis_plugins.mdx | 4 +- docs/api/qiskit/dev/visualization.mdx | 2 +- public/api/qiskit/dev/objects.inv | Bin 74983 -> 73783 bytes .../dev/fake_provider-1_02.png | Bin 11771 -> 11721 bytes public/images/api/qiskit/dev/circuit-2.png | Bin 8941 -> 7538 bytes .../api/qiskit/dev/circuit_library-2.png | Bin 9282 -> 0 bytes .../api/qiskit/dev/circuit_library-3.png | Bin 15203 -> 0 bytes .../api/qiskit/dev/circuit_library-4.png | Bin 8323 -> 0 bytes .../dev/providers_fake_provider-1_01.png | Bin 22603 -> 22304 bytes .../dev/providers_fake_provider-1_02.png | Bin 10953 -> 10815 bytes public/images/api/qiskit/dev/pulse-2.png | Bin 10597 -> 10558 bytes public/images/api/qiskit/dev/pulse-3.png | Bin 59338 -> 59510 bytes public/images/api/qiskit/dev/pulse-4.png | Bin 19114 -> 18900 bytes public/images/api/qiskit/dev/pulse-5.png | Bin 16357 -> 16226 bytes public/images/api/qiskit/dev/pulse-6.png | Bin 11332 -> 11254 bytes public/images/api/qiskit/dev/pulse-7.png | Bin 13655 -> 13972 bytes .../dev/qiskit-circuit-ControlledGate-2.png | Bin 7028 -> 6891 bytes .../dev/qiskit-circuit-library-AndGate-1.png | Bin 13136 -> 0 bytes .../dev/qiskit-circuit-library-AndGate-2.png | Bin 15197 -> 0 bytes ...iskit-circuit-library-BitwiseXorGate-1.png | Bin 14297 -> 0 bytes ...kit-circuit-library-InnerProductGate-1.png | Bin 14304 -> 0 bytes .../dev/qiskit-circuit-library-OrGate-1.png | Bin 18708 -> 0 bytes .../dev/qiskit-circuit-library-OrGate-2.png | Bin 16530 -> 0 bytes ...skit-circuit-library-PermutationGate-2.png | Bin 15998 -> 15965 bytes ...skit-circuit-library-PhaseEstimation-1.png | Bin 12170 -> 12161 bytes ...it-visualization-plot_circuit_layout-1.png | Bin 10346 -> 10166 bytes .../qiskit-visualization-plot_error_map-1.png | Bin 49525 -> 49399 bytes ...qiskit-visualization-timeline_drawer-1.png | Bin 15297 -> 16040 bytes ...qiskit-visualization-timeline_drawer-2.png | Bin 7929 -> 8323 bytes ...qiskit-visualization-timeline_drawer-3.png | Bin 26319 -> 26706 bytes .../images/api/qiskit/dev/release_notes-1.png | Bin 2801 -> 6507 bytes .../images/api/qiskit/dev/release_notes-2.png | Bin 1454 -> 13722 bytes .../images/api/qiskit/dev/release_notes-3.png | Bin 4971 -> 11731 bytes .../images/api/qiskit/dev/release_notes-4.png | Bin 13722 -> 8695 bytes .../images/api/qiskit/dev/release_notes-5.png | Bin 11731 -> 7530 bytes .../images/api/qiskit/dev/release_notes-6.png | Bin 8695 -> 7069 bytes .../images/api/qiskit/dev/release_notes-7.png | Bin 7530 -> 0 bytes .../images/api/qiskit/dev/release_notes-8.png | Bin 7069 -> 0 bytes .../images/api/qiskit/dev/transpiler-16.png | Bin 24671 -> 24838 bytes .../images/api/qiskit/dev/transpiler-17.png | Bin 19543 -> 18840 bytes public/images/api/qiskit/dev/transpiler-5.png | Bin 19726 -> 19724 bytes scripts/config/api-html-artifacts.json | 4 +- .../config/historical-pages-to-latest.json | 6 - scripts/js/lib/links/ignores.ts | 13 +- 306 files changed, 1286 insertions(+), 4300 deletions(-) delete mode 100644 docs/api/qiskit/dev/qiskit.circuit.library.AndGate.mdx delete mode 100644 docs/api/qiskit/dev/qiskit.circuit.library.BitwiseXorGate.mdx delete mode 100644 docs/api/qiskit/dev/qiskit.circuit.library.InnerProductGate.mdx delete mode 100644 docs/api/qiskit/dev/qiskit.circuit.library.OrGate.mdx delete mode 100644 docs/api/qiskit/dev/qiskit.quantum_info.SparseObservable.mdx delete mode 100644 docs/api/qiskit/dev/qiskit.transpiler.passes.RemoveIdentityEquivalent.mdx delete mode 100644 public/images/api/qiskit/dev/circuit_library-2.png delete mode 100644 public/images/api/qiskit/dev/circuit_library-3.png delete mode 100644 public/images/api/qiskit/dev/circuit_library-4.png delete mode 100644 public/images/api/qiskit/dev/qiskit-circuit-library-AndGate-1.png delete mode 100644 public/images/api/qiskit/dev/qiskit-circuit-library-AndGate-2.png delete mode 100644 public/images/api/qiskit/dev/qiskit-circuit-library-BitwiseXorGate-1.png delete mode 100644 public/images/api/qiskit/dev/qiskit-circuit-library-InnerProductGate-1.png delete mode 100644 public/images/api/qiskit/dev/qiskit-circuit-library-OrGate-1.png delete mode 100644 public/images/api/qiskit/dev/qiskit-circuit-library-OrGate-2.png delete mode 100644 public/images/api/qiskit/dev/release_notes-7.png delete mode 100644 public/images/api/qiskit/dev/release_notes-8.png diff --git a/docs/api/qiskit/dev/_toc.json b/docs/api/qiskit/dev/_toc.json index 3c7b8a968b4..c36b11a4dd6 100644 --- a/docs/api/qiskit/dev/_toc.json +++ b/docs/api/qiskit/dev/_toc.json @@ -137,14 +137,6 @@ "title": "AND", "url": "/api/qiskit/dev/qiskit.circuit.library.AND" }, - { - "title": "AndGate", - "url": "/api/qiskit/dev/qiskit.circuit.library.AndGate" - }, - { - "title": "BitwiseXorGate", - "url": "/api/qiskit/dev/qiskit.circuit.library.BitwiseXorGate" - }, { "title": "C3SXGate", "url": "/api/qiskit/dev/qiskit.circuit.library.C3SXGate" @@ -333,10 +325,6 @@ "title": "InnerProduct", "url": "/api/qiskit/dev/qiskit.circuit.library.InnerProduct" }, - { - "title": "InnerProductGate", - "url": "/api/qiskit/dev/qiskit.circuit.library.InnerProductGate" - }, { "title": "IntegerComparator", "url": "/api/qiskit/dev/qiskit.circuit.library.IntegerComparator" @@ -409,10 +397,6 @@ "title": "OR", "url": "/api/qiskit/dev/qiskit.circuit.library.OR" }, - { - "title": "OrGate", - "url": "/api/qiskit/dev/qiskit.circuit.library.OrGate" - }, { "title": "PauliEvolutionGate", "url": "/api/qiskit/dev/qiskit.circuit.library.PauliEvolutionGate" @@ -728,10 +712,6 @@ "title": "ScalarOp", "url": "/api/qiskit/dev/qiskit.quantum_info.ScalarOp" }, - { - "title": "SparseObservable", - "url": "/api/qiskit/dev/qiskit.quantum_info.SparseObservable" - }, { "title": "SparsePauliOp", "url": "/api/qiskit/dev/qiskit.quantum_info.SparsePauliOp" @@ -1365,10 +1345,6 @@ "title": "RemoveFinalReset", "url": "/api/qiskit/dev/qiskit.transpiler.passes.RemoveFinalReset" }, - { - "title": "RemoveIdentityEquivalent", - "url": "/api/qiskit/dev/qiskit.transpiler.passes.RemoveIdentityEquivalent" - }, { "title": "RemoveResetInZeroState", "url": "/api/qiskit/dev/qiskit.transpiler.passes.RemoveResetInZeroState" diff --git a/docs/api/qiskit/dev/assembler.mdx b/docs/api/qiskit/dev/assembler.mdx index 71196f719ef..b0497f22cb3 100644 --- a/docs/api/qiskit/dev/assembler.mdx +++ b/docs/api/qiskit/dev/assembler.mdx @@ -65,13 +65,9 @@ python_api_name: qiskit.assembler ### assemble\_schedules - + Assembles a list of schedules into a qobj that can be run on the backend. - - The function `qiskit.assembler.assemble_schedules.assemble_schedules()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.assembler.assemble_schedules.assemble_schedules()` will have no alternative in Qiskit. - - **Parameters** * **schedules** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.13)")*\[*[*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.13)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")*,* [*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.schedule.Schedule") *|*[*Instruction*](pulse#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction")*]]*) – Schedules to assemble. diff --git a/docs/api/qiskit/dev/circuit.mdx b/docs/api/qiskit/dev/circuit.mdx index c6861d117a1..f699b2afb59 100644 --- a/docs/api/qiskit/dev/circuit.mdx +++ b/docs/api/qiskit/dev/circuit.mdx @@ -485,7 +485,7 @@ Hardware can be instructed to apply a real-time idle period on a given qubit. A #### Delay - + Bases: [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction") Do nothing and just delay/wait/idle for a specified duration. @@ -511,7 +511,7 @@ it is forbidden for the optimizer to cancel out the two $X$ instructions. #### Barrier - + Bases: [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction") 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. @@ -537,7 +537,7 @@ qc.store(creg[0], parity) #### Store - + Bases: [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.instruction.Instruction") A manual storage of some classical value to a classical memory location. @@ -549,14 +549,6 @@ qc.store(creg[0], parity) * **lvalue** ([*expr.Expr*](circuit_classical#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.Expr")) – the memory location being stored into. * **rvalue** ([*expr.Expr*](circuit_classical#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.Expr")) – the expression result being stored. - ##### c\_if - - - - The method `qiskit.circuit.store.Store.c_if()` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - - - ##### lvalue @@ -690,7 +682,7 @@ Consult [the control-flow construction documentation](qiskit.circuit.QuantumCirc If two operations in a circuit commute, we can swap the order in which they are applied. This can allow for optimizations and simplifications, for example, if it allows to merge or cancel gates: -```text +```python ┌─────────┐ ┌─────────┐ ┌─────────┐ q_0: ┤ Rz(0.5) ├──■──┤ Rz(1.2) ├──■── q_0: ┤ Rz(1.7) ├ └─────────┘┌─┴─┐└──┬───┬──┘┌─┴─┐ = └──┬───┬──┘ @@ -722,7 +714,7 @@ Subclasses of [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruc #### \_define - + Populate the cached `_definition` field of this [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction"). Subclasses should implement this method to provide lazy construction of their public [`definition`](qiskit.circuit.Instruction#definition "qiskit.circuit.Instruction.definition") attribute. A subclass can use its [`params`](qiskit.circuit.Instruction#params "qiskit.circuit.Instruction.params") at the time of the call. The method should populate `_definition` with a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") and not return a value. diff --git a/docs/api/qiskit/dev/circuit_library.mdx b/docs/api/qiskit/dev/circuit_library.mdx index a7c810484fb..9525b9f9554 100644 --- a/docs/api/qiskit/dev/circuit_library.mdx +++ b/docs/api/qiskit/dev/circuit_library.mdx @@ -48,7 +48,7 @@ print(gate.power(1/2).to_matrix()) # √X gate print(gate.control(1).to_matrix()) # CX (controlled X) gate ``` -```text +```python [[0.+0.j 1.+0.j] [1.+0.j 0.+0.j]] [[0.5+0.5j 0.5-0.5j] @@ -143,7 +143,7 @@ diagonal = Diagonal([1, 1, 1, 1]) print(diagonal.num_qubits) ``` -```text +```python 1 2 ``` @@ -182,31 +182,12 @@ print(diagonal.num_qubits) 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. | -| [`AndGate`](qiskit.circuit.library.AndGate "qiskit.circuit.library.AndGate")(num\_variable\_qubits\[, flags]) | A gate representing 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. | -| [`OrGate`](qiskit.circuit.library.OrGate "qiskit.circuit.library.OrGate")(num\_variable\_qubits\[, flags]) | A gate representing 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`. | -| [`BitwiseXorGate`](qiskit.circuit.library.BitwiseXorGate "qiskit.circuit.library.BitwiseXorGate")(num\_qubits, amount) | An n-qubit gate 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$. | -| [`InnerProductGate`](qiskit.circuit.library.InnerProductGate "qiskit.circuit.library.InnerProductGate")(num\_qubits) | A 2n-qubit Boolean function that computes the inner product of two n-qubit vectors over $F_2$. | - -### random\_bitwise\_xor - - - Create a random BitwiseXorGate. - - **Parameters** - - * **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")) – the width of circuit. - * **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")) – random seed in case a random xor is requested. - - **Return type** - - [*BitwiseXorGate*](qiskit.circuit.library.BitwiseXorGate "qiskit.circuit.library.boolean_logic.quantum_xor.BitwiseXorGate") - +| | | +| ------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- | +| [`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 @@ -289,72 +270,6 @@ These [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCi | [`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$. | -### iqp - - - Instantaneous quantum polynomial time (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 \times 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:** - - ![../\_images/circuit\_library-2.png](/images/api/qiskit/dev/circuit_library-2.png) - - **Expanded Circuit:** - - > ![../\_images/circuit\_library-3.png](/images/api/qiskit/dev/circuit_library-3.png) - - **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) - - **Parameters** - - **interactions** ([*Sequence*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Sequence "(in Python v3.13)")*\[*[*Sequence*](https://docs.python.org/3/library/collections.abc.html#collections.abc.Sequence "(in Python v3.13)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")*]]*) – The interactions as symmetric square matrix. If `None`, then the `num_qubits` argument must be set and a random IQP circuit will be generated. - - **Returns** - - An IQP circuit. - - **Return type** - - [*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit") - - -### random\_iqp - - - A random instantaneous quantum polynomial time (IQP) circuit. - - See [`iqp()`](#qiskit.circuit.library.iqp "qiskit.circuit.library.iqp") for more details on the IQP circuit. - - Example: - - ```python - from qiskit.circuit.library import random_iqp - - circuit = random_iqp(3) - circuit.draw("mpl") - ``` - - ![../\_images/circuit\_library-4.png](/images/api/qiskit/dev/circuit_library-4.png) - - **Parameters** - - * **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")) – The number of qubits in the circuit. - * **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)") *| None*) – A seed for the random number generator, in case the interactions matrix is randomly generated. - - **Returns** - - An IQP circuit. - - **Return type** - - [QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") - - ## 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. @@ -411,7 +326,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 2a\_1: - ```text + ```python ┌───┐┌───┐ q_0: ┤ X ├┤ X ├ └───┘└───┘ @@ -431,7 +346,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 2a\_2: - ```text + ```python q_0: ──■────■── ┌─┴─┐┌─┴─┐ q_1: ┤ X ├┤ X ├ @@ -452,7 +367,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 2a\_3: - ```text + ```python q_0: ──■────■── │ │ q_1: ──■────■── @@ -475,7 +390,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 4a\_1: - ```text + ```python q_0: ───────■─────────■── │ │ q_1: ──■────┼────■────┼── @@ -502,7 +417,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 4a\_2: - ```text + ```python q_0: ──■─────────■─────── │ │ q_1: ──■────■────■────■── @@ -527,7 +442,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 4a\_3: - ```text + ```python q_0: ──■────■────■────■── │ ┌─┴─┐ │ ┌─┴─┐ q_1: ──┼──┤ X ├──┼──┤ X ├ @@ -550,7 +465,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 4b\_1: - ```text + ```python q_0: ───────■─────────■── │ │ q_1: ──■────┼────■────┼── @@ -575,7 +490,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 4b\_2: - ```text + ```python q_0: ──■─────────■─────── │ │ q_1: ──■────■────■────■── @@ -598,7 +513,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 5a\_1: - ```text + ```python q_0: ──■────■────■────■────■── │ ┌─┴─┐ │ ┌─┴─┐ │ q_1: ──■──┤ X ├──■──┤ X ├──┼── @@ -621,7 +536,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 5a\_2: - ```text + ```python q_0: ──■─────────■─────────■── │ ┌───┐ │ ┌───┐ │ q_1: ──■──┤ X ├──■──┤ X ├──┼── @@ -644,7 +559,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 5a\_3: - ```text + ```python q_0: ───────■─────────■────■── ┌─┴─┐ ┌─┴─┐ │ q_1: ──■──┤ X ├──■──┤ X ├──┼── @@ -667,7 +582,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 5a\_4: - ```text + ```python ┌───┐ ┌───┐ q_0: ──■──┤ X ├──■──┤ X ├ ┌─┴─┐└───┘┌─┴─┐├───┤ @@ -689,7 +604,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 6a\_1: - ```text + ```python ┌───┐ ┌───┐ ┌───┐ q_0: ──■──┤ X ├──■──┤ X ├──■──┤ X ├ ┌─┴─┐└─┬─┘┌─┴─┐└─┬─┘┌─┴─┐└─┬─┘ @@ -711,7 +626,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 6a\_2: - ```text + ```python q_0: ──■────■────■────■────■────■── │ ┌─┴─┐ │ ┌─┴─┐ │ ┌─┴─┐ q_1: ──■──┤ X ├──■──┤ X ├──■──┤ X ├ @@ -734,7 +649,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 6a\_3: - ```text + ```python q_0: ───────■─────────■────■────■── ┌─┴─┐ ┌─┴─┐ │ ┌─┴─┐ q_1: ──■──┤ X ├──■──┤ X ├──■──┤ X ├ @@ -757,7 +672,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 6a\_4: - ```text + ```python q_0: ───────■──────────────■─────── ┌─┴─┐ ┌───┐ │ ┌───┐ q_1: ──■──┤ X ├──■──┤ X ├──■──┤ X ├ @@ -780,7 +695,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 6b\_1: - ```text + ```python q_0: ──■─────────■────■─────────■── │ ┌─┴─┐ │ ┌─┴─┐ q_1: ──■────■──┤ X ├──■────■──┤ X ├ @@ -803,7 +718,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 6b\_2: - ```text + ```python q_0: ───────■────■─────────■────■── │ ┌─┴─┐ │ ┌─┴─┐ q_1: ──■────■──┤ X ├──■────■──┤ X ├ @@ -826,7 +741,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 6c\_1: - ```text + ```python q_0: ──■─────────■─────────■────■── │ ┌───┐ │ ┌───┐ │ ┌─┴─┐ q_1: ──■──┤ X ├──■──┤ X ├──■──┤ X ├ @@ -849,7 +764,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 7a\_1: - ```text + ```python ┌───┐ ┌───┐ q_0: ┤ X ├──■─────────■────■──┤ X ├──■── └─┬─┘┌─┴─┐ │ ┌─┴─┐└─┬─┘ │ @@ -873,7 +788,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 7b\_1: - ```text + ```python ┌───┐ ┌───┐ q_0: ┤ X ├──■─────────■────■──┤ X ├──■── └───┘┌─┴─┐ │ ┌─┴─┐└───┘ │ @@ -897,7 +812,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 7c\_1: - ```text + ```python ┌───┐ ┌───┐ q_0: ┤ X ├──■─────────■────■──┤ X ├──■── └───┘┌─┴─┐ │ ┌─┴─┐└───┘ │ @@ -921,7 +836,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 7d\_1: - ```text + ```python ┌───┐ ┌───┐ q_0: ┤ X ├──■─────────■────■──┤ X ├──■── └─┬─┘┌─┴─┐ │ ┌─┴─┐└─┬─┘ │ @@ -945,7 +860,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 7e\_1: - ```text + ```python ┌───┐ ┌───┐ q_0: ┤ X ├──■─────────■────■──┤ X ├──■── └───┘┌─┴─┐ │ ┌─┴─┐└───┘ │ @@ -969,7 +884,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 9a\_1: - ```text + ```python ┌───┐ ┌───┐ ┌───┐ q_0: ┤ X ├──■──┤ X ├──■────■──┤ X ├──■── └─┬─┘┌─┴─┐└─┬─┘┌─┴─┐┌─┴─┐└─┬─┘┌─┴─┐ @@ -993,7 +908,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 9c\_1: - ```text + ```python ┌───┐ ┌───┐┌───┐ ┌───┐ ┌───┐ q_0: ┤ X ├──■──┤ X ├┤ X ├─────┤ X ├──■───────┤ X ├ └─┬─┘┌─┴─┐└───┘└─┬─┘┌───┐└─┬─┘┌─┴─┐┌───┐└─┬─┘ @@ -1015,7 +930,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 9c\_2: - ```text + ```python q_0: ───────■────■──────────────■────■─────────■── ┌───┐ │ ┌─┴─┐┌───┐ ┌─┴─┐ │ ┌─┴─┐ q_1: ┤ X ├──■──┤ X ├┤ X ├─────┤ X ├──■───────┤ X ├ @@ -1038,7 +953,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 9c\_3: - ```text + ```python q_0: ───────■────────────────────────■──────────── ┌───┐ │ ┌───┐┌───┐ ┌───┐ │ ┌───┐ q_1: ┤ X ├──■──┤ X ├┤ X ├─────┤ X ├──■───────┤ X ├ @@ -1061,7 +976,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 9c\_4: - ```text + ```python q_0: ──■────■─────────■──────────────■──────────── ┌─┴─┐ │ ┌───┐┌─┴─┐ ┌───┐ │ ┌───┐ q_1: ┤ X ├──■──┤ X ├┤ X ├─────┤ X ├──■───────┤ X ├ @@ -1084,7 +999,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 9c\_5: - ```text + ```python q_0: ────────────■─────────■──────────────■─────── ┌───┐ ┌─┴─┐┌───┐ │ ┌───┐ │ ┌───┐ q_1: ┤ X ├──■──┤ X ├┤ X ├──┼──┤ X ├──■────┼──┤ X ├ @@ -1107,7 +1022,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 9c\_6: - ```text + ```python q_0: ───────■────■─────────■─────────■────■─────── ┌───┐ │ ┌─┴─┐┌───┐ │ ┌───┐ │ │ ┌───┐ q_1: ┤ X ├──■──┤ X ├┤ X ├──┼──┤ X ├──■────┼──┤ X ├ @@ -1130,7 +1045,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 9c\_7: - ```text + ```python q_0: ──■────■────■────■────■─────────■────■─────── ┌─┴─┐ │ ┌─┴─┐┌─┴─┐ │ ┌───┐ │ │ ┌───┐ q_1: ┤ X ├──■──┤ X ├┤ X ├──┼──┤ X ├──■────┼──┤ X ├ @@ -1153,7 +1068,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 9c\_8: - ```text + ```python q_0: ──■─────────■────■─────────■──────────────■── ┌─┴─┐ ┌─┴─┐┌─┴─┐ ┌─┴─┐ ┌─┴─┐ q_1: ┤ X ├──■──┤ X ├┤ X ├─────┤ X ├──■───────┤ X ├ @@ -1176,7 +1091,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 9c\_9: - ```text + ```python q_0: ──■────■────■────■─────────■────■─────────■── ┌─┴─┐ │ ┌─┴─┐┌─┴─┐ ┌─┴─┐ │ ┌─┴─┐ q_1: ┤ X ├──■──┤ X ├┤ X ├─────┤ X ├──■───────┤ X ├ @@ -1199,7 +1114,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 9c\_10: - ```text + ```python q_0: ──■─────────■────■────■────■─────────■────■── ┌─┴─┐ ┌─┴─┐┌─┴─┐ │ ┌─┴─┐ │ ┌─┴─┐ q_1: ┤ X ├──■──┤ X ├┤ X ├──┼──┤ X ├──■────┼──┤ X ├ @@ -1222,7 +1137,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 9c\_11: - ```text + ```python q_0: ───────■────■─────────■────■────■────■────■── ┌───┐ │ ┌─┴─┐┌───┐ │ ┌─┴─┐ │ │ ┌─┴─┐ q_1: ┤ X ├──■──┤ X ├┤ X ├──┼──┤ X ├──■────┼──┤ X ├ @@ -1245,7 +1160,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 9c\_12: - ```text + ```python q_0: ──■────■────■────■────■────■────■────■────■── ┌─┴─┐ │ ┌─┴─┐┌─┴─┐ │ ┌─┴─┐ │ │ ┌─┴─┐ q_1: ┤ X ├──■──┤ X ├┤ X ├──┼──┤ X ├──■────┼──┤ X ├ @@ -1268,7 +1183,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 9d\_1: - ```text + ```python ┌───┐ ┌───┐ ┌───┐ q_0: ──■───────┤ X ├───────■──┤ X ├───────■──┤ X ├ ┌─┴─┐┌───┐└─┬─┘┌───┐┌─┴─┐└─┬─┘┌───┐┌─┴─┐└─┬─┘ @@ -1290,7 +1205,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 9d\_2: - ```text + ```python q_0: ──■────■────■──────────────■──────────────■── │ │ ┌─┴─┐ ┌─┴─┐ ┌─┴─┐ q_1: ──■────┼──┤ X ├───────■──┤ X ├───────■──┤ X ├ @@ -1313,7 +1228,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 9d\_3: - ```text + ```python q_0: ──■────■───────────────────■───────────────── │ │ ┌───┐ ┌─┴─┐ ┌───┐ q_1: ──■────┼──┤ X ├───────■──┤ X ├───────■──┤ X ├ @@ -1336,7 +1251,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 9d\_4: - ```text + ```python q_0: ───────■─────────■──────────────■──────────── │ ┌───┐ │ ┌───┐ │ ┌───┐ q_1: ──■────┼──┤ X ├──┼────■──┤ X ├──┼────■──┤ X ├ @@ -1359,7 +1274,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 9d\_5: - ```text + ```python q_0: ──■────■─────────■─────────■────■──────────── │ │ ┌───┐ │ ┌─┴─┐ │ ┌───┐ q_1: ──■────┼──┤ X ├──┼────■──┤ X ├──┼────■──┤ X ├ @@ -1382,7 +1297,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 9d\_6: - ```text + ```python q_0: ──■────■──────────────■────■─────────■─────── │ │ ┌───┐ │ ┌─┴─┐ │ ┌───┐ q_1: ──■────┼──┤ X ├───────■──┤ X ├───────■──┤ X ├ @@ -1405,7 +1320,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 9d\_7: - ```text + ```python q_0: ──■────■─────────■────■────■────■────■─────── │ │ ┌───┐ │ │ ┌─┴─┐ │ │ ┌───┐ q_1: ──■────┼──┤ X ├──┼────■──┤ X ├──┼────■──┤ X ├ @@ -1428,7 +1343,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 9d\_8: - ```text + ```python q_0: ──■────■────■────■─────────■────■─────────■── │ │ ┌─┴─┐ │ ┌─┴─┐ │ ┌─┴─┐ q_1: ──■────┼──┤ X ├──┼────■──┤ X ├──┼────■──┤ X ├ @@ -1451,7 +1366,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 9d\_9: - ```text + ```python q_0: ──■────■────■─────────■────■─────────■────■── │ │ ┌─┴─┐ │ ┌─┴─┐ │ ┌─┴─┐ q_1: ──■────┼──┤ X ├───────■──┤ X ├───────■──┤ X ├ @@ -1474,7 +1389,7 @@ Template circuits for [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.lib Template 9d\_10: - ```text + ```python q_0: ──■────■────■────■────■────■────■────■────■── │ │ ┌─┴─┐ │ │ ┌─┴─┐ │ │ ┌─┴─┐ q_1: ──■────┼──┤ X ├──┼────■──┤ X ├──┼────■──┤ X ├ @@ -1501,7 +1416,7 @@ Template circuits over Clifford gates. Clifford template 2\_1: - ```text + ```python q_0: ─■──■─ │ │ q_1: ─■──■─ @@ -1521,7 +1436,7 @@ Template circuits over Clifford gates. Clifford template 2\_2: - ```text + ```python q_0: ──■────■── ┌─┴─┐┌─┴─┐ q_1: ┤ X ├┤ X ├ @@ -1542,7 +1457,7 @@ Template circuits over Clifford gates. Clifford template 2\_3: - ```text + ```python ┌───┐┌───┐ q_0: ┤ H ├┤ H ├ └───┘└───┘ @@ -1562,7 +1477,7 @@ Template circuits over Clifford gates. Clifford template 2\_4: - ```text + ```python q_0: ─X──X─ │ │ q_1: ─X──X─ @@ -1582,7 +1497,7 @@ Template circuits over Clifford gates. Clifford template 3\_1: - ```text + ```python ┌───┐┌───┐┌───┐ q_0: ┤ S ├┤ S ├┤ Z ├ └───┘└───┘└───┘ @@ -1602,7 +1517,7 @@ Template circuits over Clifford gates. Clifford template 4\_1: - ```text + ```python ┌───┐ q_0: ──■──┤ X ├──■───X─ ┌─┴─┐└─┬─┘┌─┴─┐ │ @@ -1624,7 +1539,7 @@ Template circuits over Clifford gates. Clifford template 4\_2: - ```text + ```python q_0: ───────■────────■─ ┌───┐┌─┴─┐┌───┐ │ q_1: ┤ H ├┤ X ├┤ H ├─■─ @@ -1645,7 +1560,7 @@ Template circuits over Clifford gates. Clifford template 4\_3: - ```text + ```python ┌───┐ ┌─────┐ q_0: ┤ S ├──■──┤ SDG ├──■── └───┘┌─┴─┐└─────┘┌─┴─┐ @@ -1667,7 +1582,7 @@ Template circuits over Clifford gates. Clifford template 4\_4: - ```text + ```python ┌───┐ ┌─────┐ q_0: ┤ S ├─■─┤ SDG ├─■─ └───┘ │ └─────┘ │ @@ -1688,7 +1603,7 @@ Template circuits over Clifford gates. Clifford template 5\_1: - > ```text + > ```python > q_0: ──■─────────■─────────■── > ┌─┴─┐ ┌─┴─┐ │ > q_1: ┤ X ├──■──┤ X ├──■────┼── @@ -1711,7 +1626,7 @@ Template circuits over Clifford gates. Clifford template 6\_1: - > ```text + > ```python > ┌───┐ ┌───┐┌───┐ > q_0: ┤ H ├──■──┤ H ├┤ X ├ > ├───┤┌─┴─┐├───┤└─┬─┘ @@ -1733,7 +1648,7 @@ Template circuits over Clifford gates. Clifford template 6\_2: - > ```text + > ```python > ┌───┐ > q_0: ┤ S ├──■───────────■───■─ > ├───┤┌─┴─┐┌─────┐┌─┴─┐ │ @@ -1755,7 +1670,7 @@ Template circuits over Clifford gates. Clifford template 6\_3: - ```text + ```python ┌───┐ ┌───┐ q_0: ─X──■─┤ H ├──■──┤ X ├───── │ │ └───┘┌─┴─┐└─┬─┘┌───┐ @@ -1777,7 +1692,7 @@ Template circuits over Clifford gates. Clifford template 6\_4: - ```text + ```python ┌───┐┌───┐┌───┐┌───┐┌───┐┌───┐ q_0: ┤ S ├┤ H ├┤ S ├┤ H ├┤ S ├┤ H ├ └───┘└───┘└───┘└───┘└───┘└───┘ @@ -1797,7 +1712,7 @@ Template circuits over Clifford gates. Clifford template 6\_5: - ```text + ```python ┌───┐ q_0: ─■───■───┤ S ├───■─────── │ ┌─┴─┐┌┴───┴┐┌─┴─┐┌───┐ @@ -1819,7 +1734,7 @@ Template circuits over Clifford gates. Clifford template 8\_1: - ```text + ```python ┌───┐ ┌───┐ ┌───┐┌─────┐ q_0: ──■───────┤ X ├─┤ S ├─┤ X ├┤ SDG ├ ┌─┴─┐┌───┐└─┬─┘┌┴───┴┐└─┬─┘└┬───┬┘ @@ -1841,7 +1756,7 @@ Template circuits over Clifford gates. Clifford template 8\_2: - ```text + ```python ┌───┐ q_0: ──■─────────■───┤ S ├───■──────────── ┌─┴─┐┌───┐┌─┴─┐┌┴───┴┐┌─┴─┐┌───┐┌───┐ @@ -1863,7 +1778,7 @@ Template circuits over Clifford gates. Clifford template 8\_3: - ```text + ```python q_0: ─────────────────■───────────────────────■── ┌───┐┌───┐┌───┐┌─┴─┐┌─────┐┌───┐┌─────┐┌─┴─┐ q_1: ┤ S ├┤ H ├┤ S ├┤ X ├┤ SDG ├┤ H ├┤ SDG ├┤ X ├ @@ -1888,7 +1803,7 @@ Template circuits with [`RZXGate`](qiskit.circuit.library.RZXGate "qiskit.circui RZX-based template for CX - RYGate - CX. - ```text + ```python ┌────────┐ ┌─────────┐┌─────────┐┌──────────┐ q_0: ──■──┤ RY(-ϴ) ├──■──┤ RX(π/2) ├┤0 ├┤ RX(-π/2) ├ ┌─┴─┐└────────┘┌─┴─┐└─────────┘│ RZX(ϴ) │└──────────┘ @@ -1902,7 +1817,7 @@ Template circuits with [`RZXGate`](qiskit.circuit.library.RZXGate "qiskit.circui RZX-based template for CX - RXGate - CX. - ```text + ```python ┌───┐ ┌───┐┌─────────┐┌─────────┐┌─────────┐┌──────────┐» q_0: ┤ X ├─────────┤ X ├┤ RZ(π/2) ├┤ RX(π/2) ├┤ RZ(π/2) ├┤0 ├» └─┬─┘┌───────┐└─┬─┘└─────────┘└─────────┘└─────────┘│ RZX(-ϴ) │» @@ -1921,7 +1836,7 @@ Template circuits with [`RZXGate`](qiskit.circuit.library.RZXGate "qiskit.circui RZX-based template for CX - RYGate - CX. - ```text + ```python ┌──────────┐ q_0: ──■─────────────■─────────────────────────────────┤0 ├─────────── ┌─┴─┐┌───────┐┌─┴─┐┌────────┐┌──────────┐┌───────┐│ RZX(-ϴ) │┌─────────┐ @@ -1935,7 +1850,7 @@ Template circuits with [`RZXGate`](qiskit.circuit.library.RZXGate "qiskit.circui RZX-based template for CX - RZGate - CX. - ```text + ```python » q_0: ──■────────────────────────────────────────────■───────────────────────» ┌─┴─┐┌───────┐┌────┐┌───────┐┌────┐┌────────┐┌─┴─┐┌────────┐┌─────────┐» @@ -1959,7 +1874,7 @@ Template circuits with [`RZXGate`](qiskit.circuit.library.RZXGate "qiskit.circui RZX-based template for CX - PhaseGate - CX. - ```text + ```python » q_0: ──■────────────■─────────────────────────────────────────────────────» ┌─┴─┐┌──────┐┌─┴─┐┌───────┐┌─────────┐┌─────────┐┌─────────┐┌───────┐» @@ -1978,7 +1893,7 @@ Template circuits with [`RZXGate`](qiskit.circuit.library.RZXGate "qiskit.circui RZX-based template for CX - RZGate - CX. - ```text + ```python » q_0: ──■─────────────■──────────────────────────────────────────────────────» ┌─┴─┐┌───────┐┌─┴─┐┌────────┐┌─────────┐┌─────────┐┌─────────┐┌───────┐» diff --git a/docs/api/qiskit/dev/circuit_singleton.mdx b/docs/api/qiskit/dev/circuit_singleton.mdx index 0bcebeff629..5cfe5062dce 100644 --- a/docs/api/qiskit/dev/circuit_singleton.mdx +++ b/docs/api/qiskit/dev/circuit_singleton.mdx @@ -44,7 +44,7 @@ The public classes correspond to the standard classes [`Instruction`](qiskit.cir ### SingletonInstruction - + 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`](circuit#qiskit.circuit.Measure "qiskit.circuit.Measure") which has an immutable definition and any instance of [`Measure`](circuit#qiskit.circuit.Measure "qiskit.circuit.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. @@ -54,7 +54,7 @@ The public classes correspond to the standard classes [`Instruction`](qiskit.cir ### SingletonGate - + 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. @@ -62,7 +62,7 @@ The public classes correspond to the standard classes [`Instruction`](qiskit.cir ### SingletonControlledGate - + 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. @@ -124,7 +124,7 @@ Subclasses of [`SingletonInstruction`](#qiskit.circuit.singleton.SingletonInstru #### \_singleton\_lookup\_key - + 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. diff --git a/docs/api/qiskit/dev/compiler.mdx b/docs/api/qiskit/dev/compiler.mdx index e7c506305d2..d1def25cbd3 100644 --- a/docs/api/qiskit/dev/compiler.mdx +++ b/docs/api/qiskit/dev/compiler.mdx @@ -105,13 +105,9 @@ python_api_name: qiskit.compiler ### schedule - + Schedule a circuit to a pulse `Schedule`, using the backend, according to any specified methods. Supported methods are documented in `qiskit.scheduler.schedule_circuit`. - - The function `qiskit.compiler.scheduler.schedule()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that `qiskit.compiler.scheduler.schedule()` will be moved as well. - - **Parameters** * **circuits** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit") *|*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.13)")*\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")*]*) – The quantum circuit or circuits to translate @@ -136,7 +132,7 @@ python_api_name: qiskit.compiler ### transpile - + 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. @@ -153,22 +149,6 @@ python_api_name: qiskit.compiler | **timing\_constraints** | target | timing\_constraints | timing\_constraints | | **backend\_properties** | target | backend\_properties | backend\_properties | - - `qiskit.compiler.transpiler.transpile()`’s argument `inst_map` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and this argument uses a dependency on the package. - - - - `qiskit.compiler.transpiler.transpile()`’s argument `backend_properties` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The target parameter should be used instead. You can build a Target instance with defined properties with Target.from\_configuration(…, backend\_properties=…) - - - - `qiskit.compiler.transpiler.transpile()`’s argument `timing_constraints` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The target parameter should be used instead. You can build a Target instance with defined timing constraints with Target.from\_configuration(…, timing\_constraints=…) - - - - `qiskit.compiler.transpiler.transpile()`’s argument `instruction_durations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The target parameter should be used instead. You can build a Target instance with defined instruction durations with Target.from\_configuration(…, instruction\_durations=…) - - **Parameters** * **circuits** (*\_CircuitT*) – Circuit(s) to transpile @@ -177,7 +157,7 @@ python_api_name: qiskit.compiler * **basis\_gates** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.13)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.13)")*] | 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.13)")*\[*[*InstructionScheduleMap*](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.instruction_schedule_map.InstructionScheduleMap")*] | None*) – DEPRECATED. 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. + * **inst\_map** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.13)")*\[*[*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.13)")*\[*[*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.13)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")*]] | None*) – @@ -314,13 +294,9 @@ python_api_name: qiskit.compiler ### sequence - + Schedule a scheduled circuit to a pulse `Schedule`, using the backend. - - The function `qiskit.compiler.sequencer.sequence()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that `qiskit.compiler.sequencer.sequence()` will be moved as well. - - **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.13)")*\[*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")*]*) – Scheduled circuit(s) to be translated diff --git a/docs/api/qiskit/dev/converters.mdx b/docs/api/qiskit/dev/converters.mdx index ee3f4516273..20e67af4bec 100644 --- a/docs/api/qiskit/dev/converters.mdx +++ b/docs/api/qiskit/dev/converters.mdx @@ -184,7 +184,7 @@ python_api_name: qiskit.converters ### dagdependency\_to\_circuit - + Build a `QuantumCircuit` object from a `DAGDependency`. **Parameters** @@ -244,7 +244,7 @@ python_api_name: qiskit.converters ### dagdependency\_to\_dag - + Build a `DAGCircuit` object from a `DAGDependency`. **Parameters** diff --git a/docs/api/qiskit/dev/passmanager.mdx b/docs/api/qiskit/dev/passmanager.mdx index 2bd2f60ffe2..8df2148ef4a 100644 --- a/docs/api/qiskit/dev/passmanager.mdx +++ b/docs/api/qiskit/dev/passmanager.mdx @@ -82,7 +82,7 @@ pm.run([123456789, 45654, 36785554]) Output: -```text +```python [12346789, 464, 36784] ``` @@ -122,7 +122,7 @@ pm.run([123456789, 45654, 36785554]) Output: -```text +```python [12346789, 45654, 36784] ``` diff --git a/docs/api/qiskit/dev/providers_fake_provider.mdx b/docs/api/qiskit/dev/providers_fake_provider.mdx index 13a581747a2..b4b28c45d58 100644 --- a/docs/api/qiskit/dev/providers_fake_provider.mdx +++ b/docs/api/qiskit/dev/providers_fake_provider.mdx @@ -115,7 +115,7 @@ The V1 fake backends are based on a set of base classes: ### FakePulseBackend - + A fake pulse backend. FakeBackend initializer. diff --git a/docs/api/qiskit/dev/pulse.mdx b/docs/api/qiskit/dev/pulse.mdx index c1dcdcbd6c5..3075b754ce6 100644 --- a/docs/api/qiskit/dev/pulse.mdx +++ b/docs/api/qiskit/dev/pulse.mdx @@ -68,15 +68,11 @@ These are all instances of the same base class: ### Instruction - + The smallest schedulable unit: a single instruction. It has a fixed duration and specified channels. Instruction initializer. - - The class `qiskit.pulse.instructions.instruction.Instruction` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **operands** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.13)")) – The argument list. @@ -161,7 +157,7 @@ All channels are children of the same abstract base class: ### Channel - + 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. @@ -170,10 +166,6 @@ All channels are children of the same abstract base class: Channel class. - - The class `qiskit.pulse.channels.Channel` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** **index** – Index of channel. @@ -762,7 +754,7 @@ The above is just a small taste of what is possible with the builder. See the re ### build - + Create a context manager for launching the imperative pulse builder DSL. To enter a building context and starting building a pulse program: @@ -785,10 +777,6 @@ The above is just a small taste of what is possible with the builder. See the re backend.run(transpile(pulse_prog, backend)) ``` - - The function `qiskit.pulse.builder.build()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **backend** ([*Backend*](qiskit.providers.Backend "qiskit.providers.Backend")) – A Qiskit backend. If not supplied certain builder functionality will be unavailable. @@ -820,19 +808,15 @@ with pulse.build(backend) as drive_sched: print(d0) ``` -```text +```python DriveChannel(0) ``` #### acquire\_channel - + Return `AcquireChannel` for `qubit` on the active builder backend. - - The function `qiskit.pulse.builder.acquire_channel()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - Examples: ```python @@ -856,15 +840,11 @@ DriveChannel(0) #### control\_channels - + 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. - - The function `qiskit.pulse.builder.control_channels()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - Examples: ```python @@ -895,13 +875,9 @@ DriveChannel(0) #### drive\_channel - + Return `DriveChannel` for `qubit` on the active builder backend. - - The function `qiskit.pulse.builder.drive_channel()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - Examples: ```python @@ -925,13 +901,9 @@ DriveChannel(0) #### measure\_channel - + Return `MeasureChannel` for `qubit` on the active builder backend. - - The function `qiskit.pulse.builder.measure_channel()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - Examples: ```python @@ -988,13 +960,9 @@ drive_sched.draw() #### acquire - + Acquire for a `duration` on a `channel` and store the result in a `register`. - - The function `qiskit.pulse.builder.acquire()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - Examples: ```python @@ -1029,7 +997,7 @@ drive_sched.draw() #### barrier - + 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: @@ -1092,10 +1060,6 @@ drive_sched.draw() Requires the active builder context to have a backend set if qubits are barriered on. - - The function `qiskit.pulse.builder.barrier()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **channels\_or\_qubits** (*chans.Channel |* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")) – Channels or qubits to barrier. @@ -1104,17 +1068,13 @@ drive_sched.draw() #### call - + 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` 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` instruction. - - The function `qiskit.pulse.builder.call()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Examples** 1. Calling a schedule block (recommended) @@ -1134,7 +1094,7 @@ drive_sched.draw() print(pulse_prog) ``` - ```text + ```python ScheduleBlock( ScheduleBlock( Play( @@ -1155,7 +1115,7 @@ drive_sched.draw() print(pulse_prog.references) ``` - ```text + ```python ReferenceManager: - ('block0', '634b3b50bd684e26a673af1fbd2d6c81'): ScheduleBlock(Play(Gaussian(... ``` @@ -1175,7 +1135,7 @@ drive_sched.draw() print(pulse_prog) ``` - ```text + ```python ScheduleBlock( ScheduleBlock( Play( @@ -1214,7 +1174,7 @@ drive_sched.draw() print(pulse_prog) ``` - ```text + ```python ScheduleBlock( ScheduleBlock( Play(Gaussian(duration=160, amp=(0.1+0j), sigma=40), DriveChannel(0)), @@ -1238,7 +1198,7 @@ drive_sched.draw() print(pulse_prog) ``` - ```text + ```python ScheduleBlock( Call( Schedule( @@ -1277,13 +1237,9 @@ drive_sched.draw() #### delay - + Delay on a `channel` for a `duration`. - - The function `qiskit.pulse.builder.delay()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - Examples: ```python @@ -1304,13 +1260,9 @@ drive_sched.draw() #### play - + Play a `pulse` on a `channel`. - - The function `qiskit.pulse.builder.play()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - Examples: ```python @@ -1331,7 +1283,7 @@ drive_sched.draw() #### reference - + 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. @@ -1348,10 +1300,6 @@ drive_sched.draw() main_prog.assign_references(subroutine_dict={("x_gate", "q0"): subroutine}) ``` - - The function `qiskit.pulse.builder.reference()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.13)")) – Name of subroutine. @@ -1360,13 +1308,9 @@ drive_sched.draw() #### set\_frequency - + Set the `frequency` of a pulse `channel`. - - The function `qiskit.pulse.builder.set_frequency()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - Examples: ```python @@ -1387,13 +1331,9 @@ drive_sched.draw() #### set\_phase - + Set the `phase` of a pulse `channel`. - - The function `qiskit.pulse.builder.set_phase()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - Examples: ```python @@ -1416,13 +1356,9 @@ drive_sched.draw() #### shift\_frequency - + Shift the `frequency` of a pulse `channel`. - - The function `qiskit.pulse.builder.shift_frequency()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - Examples: ```python @@ -1443,13 +1379,9 @@ drive_sched.draw() #### shift\_phase - + Shift the `phase` of a pulse `channel`. - - The function `qiskit.pulse.builder.shift_phase()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - Examples: ```python @@ -1472,13 +1404,9 @@ drive_sched.draw() #### snapshot - + Simulator snapshot. - - The function `qiskit.pulse.builder.snapshot()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - Examples: ```python @@ -1518,17 +1446,13 @@ pulse_prog.draw() #### align\_equispaced - + 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. - - The function `qiskit.pulse.builder.align_equispaced()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - Examples: ```python @@ -1568,17 +1492,13 @@ pulse_prog.draw() #### align\_func - + 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. - - The function `qiskit.pulse.builder.align_func()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - Examples: ```python @@ -1624,15 +1544,11 @@ pulse_prog.draw() #### align\_left - + 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. - - The function `qiskit.pulse.builder.align_left()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - Examples: ```python @@ -1663,15 +1579,11 @@ pulse_prog.draw() #### align\_right - + 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. - - The function `qiskit.pulse.builder.align_right()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - Examples: ```python @@ -1702,15 +1614,11 @@ pulse_prog.draw() #### align\_sequential - + 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. - - The function `qiskit.pulse.builder.align_sequential()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - Examples: ```python @@ -1741,13 +1649,9 @@ pulse_prog.draw() #### frequency\_offset - + Shift the frequency of inputs channels on entry into context and undo on exit. - - The function `qiskit.pulse.builder.frequency_offset()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - Examples: ```python @@ -1791,13 +1695,9 @@ pulse_prog.draw() #### phase\_offset - + Shift the phase of input channels on entry into context and undo on exit. - - The function `qiskit.pulse.builder.phase_offset()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - Examples: ```python @@ -1843,13 +1743,13 @@ with pulse.build(backend) as measure_sched: print(mem_slot) ``` -```text +```python MemorySlot(0) ``` #### measure - + 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"). @@ -1888,10 +1788,6 @@ MemorySlot(0) Requires the active builder context to have a backend set. - - The function `qiskit.pulse.builder.measure()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **qubits** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.13)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")*] |* [*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")) – Physical qubit to measure. @@ -1908,15 +1804,11 @@ MemorySlot(0) #### measure\_all - + 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. - - The function `qiskit.pulse.builder.measure_all()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - Examples: ```python @@ -1945,13 +1837,9 @@ MemorySlot(0) #### delay\_qubits - + Insert delays on all the `channels.Channel`s that correspond to the input `qubits` at the same time. - - The function `qiskit.pulse.builder.delay_qubits()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - Examples: ```python @@ -1998,7 +1886,7 @@ with pulse.build(backend) as u3_sched: seconds, pulse.seconds_to_samples(1e-6))) ``` -```text +```python Number of qubits in backend: 1 There are 160 samples in 3.5555555555555554e-08 seconds There are 1e-06 seconds in 4500 samples. @@ -2006,13 +1894,9 @@ There are 1e-06 seconds in 4500 samples. #### active\_backend - + Get the backend of the currently active builder context. - - The function `qiskit.pulse.builder.active_backend()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Returns** **The active backend in the currently active** @@ -2030,13 +1914,9 @@ There are 1e-06 seconds in 4500 samples. #### num\_qubits - + Return number of qubits in the currently active backend. - - The function `qiskit.pulse.builder.num_qubits()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - Examples: ```python @@ -2049,7 +1929,7 @@ There are 1e-06 seconds in 4500 samples. print(pulse.num_qubits()) ``` - ```text + ```python 2 ``` @@ -2064,13 +1944,9 @@ There are 1e-06 seconds in 4500 samples. #### qubit\_channels - + Returns the set of channels associated with a qubit. - - The function `qiskit.pulse.builder.qubit_channels()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - Examples: ```python @@ -2083,7 +1959,7 @@ There are 1e-06 seconds in 4500 samples. print(pulse.qubit_channels(0)) ``` - ```text + ```python {MeasureChannel(0), ControlChannel(0), DriveChannel(0), AcquireChannel(0), ControlChannel(1)} ``` @@ -2102,13 +1978,9 @@ There are 1e-06 seconds in 4500 samples. #### samples\_to\_seconds - + Obtain the time in seconds that will elapse for the input number of samples on the active backend. - - The function `qiskit.pulse.builder.samples_to_seconds()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** **samples** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)") *| np.ndarray*) – Number of samples to convert to time in seconds. @@ -2124,15 +1996,11 @@ There are 1e-06 seconds in 4500 samples. #### seconds\_to\_samples - + Obtain the number of samples that will elapse in `seconds` on the active backend. Rounds down. - - The function `qiskit.pulse.builder.seconds_to_samples()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** **seconds** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.13)") *| np.ndarray*) – Time in seconds to convert to samples. @@ -2156,61 +2024,41 @@ There are 1e-06 seconds in 4500 samples. ### PulseError - + Errors raised by the pulse module. Set the error message. - - - The class `qiskit.pulse.exceptions.PulseError` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - ### BackendNotSet - + Raised if the builder context does not have a backend. Set the error message. - - - The class `qiskit.pulse.exceptions.PulseError` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - ### NoActiveBuilder - + Raised if no builder context is active. Set the error message. - - - The class `qiskit.pulse.exceptions.PulseError` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - ### UnassignedDurationError - + Raised if instruction duration is unassigned. Set the error message. - - - The class `qiskit.pulse.exceptions.PulseError` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - ### UnassignedReferenceError - + Raised if subroutine is unassigned. Set the error message. - - - The class `qiskit.pulse.exceptions.PulseError` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - diff --git a/docs/api/qiskit/dev/qasm2.mdx b/docs/api/qiskit/dev/qasm2.mdx index e9f99b57a8f..f58461dc5ae 100644 --- a/docs/api/qiskit/dev/qasm2.mdx +++ b/docs/api/qiskit/dev/qasm2.mdx @@ -236,7 +236,7 @@ qc.measure([0, 1], [0, 1]) print(qiskit.qasm2.dumps(qc)) ``` -```text +```python OPENQASM 2.0; include "qelib1.inc"; qreg q[2]; @@ -291,7 +291,7 @@ circuit = qiskit.qasm2.loads(program) circuit.draw() ``` -```text +```python ┌───┐ ┌─┐ q_0: ┤ H ├──■──┤M├─── └───┘┌─┴─┐└╥┘┌─┐ @@ -399,7 +399,7 @@ circuit = loads(program, custom_classical=customs) 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: -```text +```python gate u1(lambda) q { U(0, 0, lambda) q; } @@ -444,7 +444,7 @@ This will use Qiskit’s [`PhaseGate`](qiskit.circuit.library.PhaseGate "qiskit. Operator(qasm2.loads(program, custom_instructions=custom)) ``` -```text +```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,)) diff --git a/docs/api/qiskit/dev/qasm3.mdx b/docs/api/qiskit/dev/qasm3.mdx index d3f141153c3..67b7a26891f 100644 --- a/docs/api/qiskit/dev/qasm3.mdx +++ b/docs/api/qiskit/dev/qasm3.mdx @@ -57,7 +57,7 @@ Both of these exporter functions are single-use wrappers around the main [`Expor ### Exporter - + QASM3 exporter main class. **Parameters** @@ -96,13 +96,13 @@ Both of these exporter functions are single-use wrappers around the main [`Expor #### dump - + Convert the circuit to OpenQASM 3, dumping the result to a file or text stream. #### dumps - + Convert the circuit to OpenQASM 3, returning the result as a string. @@ -208,7 +208,7 @@ Currently only two high-level functions are offered, as Qiskit support for impor 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 with the `qasm3-import` extra, such as by: - ```text + ```python pip install qiskit[qasm3-import] ``` diff --git a/docs/api/qiskit/dev/qiskit.circuit.BreakLoopOp.mdx b/docs/api/qiskit/dev/qiskit.circuit.BreakLoopOp.mdx index dbe4f97d28c..46daa11ec1d 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.BreakLoopOp.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.BreakLoopOp.mdx @@ -46,20 +46,12 @@ python_api_name: qiskit.circuit.BreakLoopOp The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions @@ -136,13 +128,13 @@ python_api_name: qiskit.circuit.BreakLoopOp ### add\_decomposition - + Add a decomposition of the instruction to the SessionEquivalenceLibrary. ### assemble - + Assemble a QasmQobjInstruction @@ -152,7 +144,7 @@ python_api_name: qiskit.circuit.BreakLoopOp ### broadcast\_arguments - + Validation of the arguments. **Parameters** @@ -171,21 +163,17 @@ python_api_name: qiskit.circuit.BreakLoopOp ### c\_if - + 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. - - - The method `qiskit.circuit.instruction.Instruction.c_if()` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### copy - + Copy of the instruction. **Parameters** @@ -203,7 +191,7 @@ python_api_name: qiskit.circuit.BreakLoopOp ### inverse - + Invert this instruction. If annotated is False, the inverse instruction is implemented as a fresh instruction with the recursively inverted definition. @@ -227,13 +215,13 @@ python_api_name: qiskit.circuit.BreakLoopOp ### is\_parameterized - + Return whether the [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") contains [compile-time parameters](circuit#circuit-compile-time-parameters). ### repeat - + Creates an instruction with `self` repeated :math\`n\` times. If this operation has a conditional, the output instruction will have the same conditional and the inner repeated operations will be unconditional; instructions within a compound definition cannot be conditioned on registers within Qiskit’s data model. This means that it is not valid to apply a repeated instruction to a clbit that it both writes to and reads from in its condition. @@ -257,7 +245,7 @@ python_api_name: qiskit.circuit.BreakLoopOp ### 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. @@ -275,7 +263,7 @@ python_api_name: qiskit.circuit.BreakLoopOp ### soft\_compare - + 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** @@ -301,7 +289,7 @@ python_api_name: qiskit.circuit.BreakLoopOp ### validate\_parameter - + Instruction parameters has no validation or normalization. diff --git a/docs/api/qiskit/dev/qiskit.circuit.ContinueLoopOp.mdx b/docs/api/qiskit/dev/qiskit.circuit.ContinueLoopOp.mdx index 52cdf8bf4ad..29de201f7b2 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.ContinueLoopOp.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.ContinueLoopOp.mdx @@ -46,20 +46,12 @@ python_api_name: qiskit.circuit.ContinueLoopOp The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions @@ -136,13 +128,13 @@ python_api_name: qiskit.circuit.ContinueLoopOp ### add\_decomposition - + Add a decomposition of the instruction to the SessionEquivalenceLibrary. ### assemble - + Assemble a QasmQobjInstruction @@ -152,7 +144,7 @@ python_api_name: qiskit.circuit.ContinueLoopOp ### broadcast\_arguments - + Validation of the arguments. **Parameters** @@ -171,21 +163,17 @@ python_api_name: qiskit.circuit.ContinueLoopOp ### c\_if - + 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. - - - The method `qiskit.circuit.instruction.Instruction.c_if()` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### copy - + Copy of the instruction. **Parameters** @@ -203,7 +191,7 @@ python_api_name: qiskit.circuit.ContinueLoopOp ### inverse - + Invert this instruction. If annotated is False, the inverse instruction is implemented as a fresh instruction with the recursively inverted definition. @@ -227,13 +215,13 @@ python_api_name: qiskit.circuit.ContinueLoopOp ### is\_parameterized - + Return whether the [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") contains [compile-time parameters](circuit#circuit-compile-time-parameters). ### repeat - + Creates an instruction with `self` repeated :math\`n\` times. If this operation has a conditional, the output instruction will have the same conditional and the inner repeated operations will be unconditional; instructions within a compound definition cannot be conditioned on registers within Qiskit’s data model. This means that it is not valid to apply a repeated instruction to a clbit that it both writes to and reads from in its condition. @@ -257,7 +245,7 @@ python_api_name: qiskit.circuit.ContinueLoopOp ### 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. @@ -275,7 +263,7 @@ python_api_name: qiskit.circuit.ContinueLoopOp ### soft\_compare - + 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** @@ -301,7 +289,7 @@ python_api_name: qiskit.circuit.ContinueLoopOp ### validate\_parameter - + Instruction parameters has no validation or normalization. diff --git a/docs/api/qiskit/dev/qiskit.circuit.ControlFlowOp.mdx b/docs/api/qiskit/dev/qiskit.circuit.ControlFlowOp.mdx index adb8f0af389..ea3ed488584 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.ControlFlowOp.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.ControlFlowOp.mdx @@ -65,20 +65,12 @@ python_api_name: qiskit.circuit.ControlFlowOp The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions @@ -155,13 +147,13 @@ python_api_name: qiskit.circuit.ControlFlowOp ### add\_decomposition - + Add a decomposition of the instruction to the SessionEquivalenceLibrary. ### assemble - + Assemble a QasmQobjInstruction @@ -171,7 +163,7 @@ python_api_name: qiskit.circuit.ControlFlowOp ### broadcast\_arguments - + Validation of the arguments. **Parameters** @@ -190,21 +182,17 @@ python_api_name: qiskit.circuit.ControlFlowOp ### c\_if - + 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. - - - The method `qiskit.circuit.instruction.Instruction.c_if()` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### copy - + Copy of the instruction. **Parameters** @@ -222,7 +210,7 @@ python_api_name: qiskit.circuit.ControlFlowOp ### inverse - + Invert this instruction. If annotated is False, the inverse instruction is implemented as a fresh instruction with the recursively inverted definition. @@ -246,7 +234,7 @@ python_api_name: qiskit.circuit.ControlFlowOp ### is\_parameterized - + Return whether the [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") contains [compile-time parameters](circuit#circuit-compile-time-parameters). @@ -262,7 +250,7 @@ python_api_name: qiskit.circuit.ControlFlowOp ### repeat - + Creates an instruction with `self` repeated :math\`n\` times. If this operation has a conditional, the output instruction will have the same conditional and the inner repeated operations will be unconditional; instructions within a compound definition cannot be conditioned on registers within Qiskit’s data model. This means that it is not valid to apply a repeated instruction to a clbit that it both writes to and reads from in its condition. @@ -321,7 +309,7 @@ python_api_name: qiskit.circuit.ControlFlowOp ### 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. @@ -339,7 +327,7 @@ python_api_name: qiskit.circuit.ControlFlowOp ### soft\_compare - + 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** @@ -365,7 +353,7 @@ python_api_name: qiskit.circuit.ControlFlowOp ### validate\_parameter - + Instruction parameters has no validation or normalization. diff --git a/docs/api/qiskit/dev/qiskit.circuit.ControlledGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.ControlledGate.mdx index bd92c51f96b..c091d78d748 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.ControlledGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.ControlledGate.mdx @@ -93,20 +93,12 @@ python_api_name: qiskit.circuit.ControlledGate The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state @@ -219,13 +211,13 @@ python_api_name: qiskit.circuit.ControlledGate ### add\_decomposition - + Add a decomposition of the instruction to the SessionEquivalenceLibrary. ### assemble - + Assemble a QasmQobjInstruction @@ -288,16 +280,12 @@ python_api_name: qiskit.circuit.ControlledGate ### c\_if - + 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. - - - The method `qiskit.circuit.instruction.Instruction.c_if()` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### control @@ -325,7 +313,7 @@ python_api_name: qiskit.circuit.ControlledGate ### copy - + Copy of the instruction. **Parameters** @@ -353,7 +341,7 @@ python_api_name: qiskit.circuit.ControlledGate ### is\_parameterized - + Return whether the [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") contains [compile-time parameters](circuit#circuit-compile-time-parameters). @@ -380,7 +368,7 @@ python_api_name: qiskit.circuit.ControlledGate ### repeat - + Creates an instruction with `self` repeated :math\`n\` times. If this operation has a conditional, the output instruction will have the same conditional and the inner repeated operations will be unconditional; instructions within a compound definition cannot be conditioned on registers within Qiskit’s data model. This means that it is not valid to apply a repeated instruction to a clbit that it both writes to and reads from in its condition. @@ -404,7 +392,7 @@ python_api_name: qiskit.circuit.ControlledGate ### 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. @@ -422,7 +410,7 @@ python_api_name: qiskit.circuit.ControlledGate ### soft\_compare - + 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** diff --git a/docs/api/qiskit/dev/qiskit.circuit.ForLoopOp.mdx b/docs/api/qiskit/dev/qiskit.circuit.ForLoopOp.mdx index c1f551b9c9f..5993f0a1635 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.ForLoopOp.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.ForLoopOp.mdx @@ -51,20 +51,12 @@ python_api_name: qiskit.circuit.ForLoopOp The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions @@ -139,13 +131,13 @@ python_api_name: qiskit.circuit.ForLoopOp ### add\_decomposition - + Add a decomposition of the instruction to the SessionEquivalenceLibrary. ### assemble - + Assemble a QasmQobjInstruction @@ -155,7 +147,7 @@ python_api_name: qiskit.circuit.ForLoopOp ### broadcast\_arguments - + Validation of the arguments. **Parameters** @@ -174,21 +166,17 @@ python_api_name: qiskit.circuit.ForLoopOp ### c\_if - + 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. - - - The method `qiskit.circuit.instruction.Instruction.c_if()` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### copy - + Copy of the instruction. **Parameters** @@ -206,7 +194,7 @@ python_api_name: qiskit.circuit.ForLoopOp ### inverse - + Invert this instruction. If annotated is False, the inverse instruction is implemented as a fresh instruction with the recursively inverted definition. @@ -230,7 +218,7 @@ python_api_name: qiskit.circuit.ForLoopOp ### is\_parameterized - + Return whether the [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") contains [compile-time parameters](circuit#circuit-compile-time-parameters). @@ -246,7 +234,7 @@ python_api_name: qiskit.circuit.ForLoopOp ### repeat - + Creates an instruction with `self` repeated :math\`n\` times. If this operation has a conditional, the output instruction will have the same conditional and the inner repeated operations will be unconditional; instructions within a compound definition cannot be conditioned on registers within Qiskit’s data model. This means that it is not valid to apply a repeated instruction to a clbit that it both writes to and reads from in its condition. @@ -301,7 +289,7 @@ python_api_name: qiskit.circuit.ForLoopOp ### 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. @@ -319,7 +307,7 @@ python_api_name: qiskit.circuit.ForLoopOp ### soft\_compare - + 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** @@ -345,7 +333,7 @@ python_api_name: qiskit.circuit.ForLoopOp ### validate\_parameter - + Instruction parameters has no validation or normalization. diff --git a/docs/api/qiskit/dev/qiskit.circuit.Gate.mdx b/docs/api/qiskit/dev/qiskit.circuit.Gate.mdx index ceefb11ac31..9201826c1aa 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.Gate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.Gate.mdx @@ -49,20 +49,12 @@ python_api_name: qiskit.circuit.Gate The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions @@ -139,13 +131,13 @@ python_api_name: qiskit.circuit.Gate ### add\_decomposition - + Add a decomposition of the instruction to the SessionEquivalenceLibrary. ### assemble - + Assemble a QasmQobjInstruction @@ -208,16 +200,12 @@ python_api_name: qiskit.circuit.Gate ### c\_if - + 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. - - - The method `qiskit.circuit.instruction.Instruction.c_if()` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### control @@ -245,7 +233,7 @@ python_api_name: qiskit.circuit.Gate ### copy - + Copy of the instruction. **Parameters** @@ -263,7 +251,7 @@ python_api_name: qiskit.circuit.Gate ### inverse - + Invert this instruction. If annotated is False, the inverse instruction is implemented as a fresh instruction with the recursively inverted definition. @@ -287,7 +275,7 @@ python_api_name: qiskit.circuit.Gate ### is\_parameterized - + Return whether the [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") contains [compile-time parameters](circuit#circuit-compile-time-parameters). @@ -314,7 +302,7 @@ python_api_name: qiskit.circuit.Gate ### repeat - + Creates an instruction with `self` repeated :math\`n\` times. If this operation has a conditional, the output instruction will have the same conditional and the inner repeated operations will be unconditional; instructions within a compound definition cannot be conditioned on registers within Qiskit’s data model. This means that it is not valid to apply a repeated instruction to a clbit that it both writes to and reads from in its condition. @@ -338,7 +326,7 @@ python_api_name: qiskit.circuit.Gate ### 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. @@ -356,7 +344,7 @@ python_api_name: qiskit.circuit.Gate ### soft\_compare - + 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** diff --git a/docs/api/qiskit/dev/qiskit.circuit.IfElseOp.mdx b/docs/api/qiskit/dev/qiskit.circuit.IfElseOp.mdx index 89c69ab9d5c..5cd5e69a46a 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.IfElseOp.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.IfElseOp.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.circuit.IfElseOp # IfElseOp - + 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. @@ -53,16 +53,14 @@ python_api_name: qiskit.circuit.IfElseOp ### condition - + + The classical condition on the instruction. + ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions @@ -137,13 +135,13 @@ python_api_name: qiskit.circuit.IfElseOp ### add\_decomposition - + Add a decomposition of the instruction to the SessionEquivalenceLibrary. ### assemble - + Assemble a QasmQobjInstruction @@ -153,7 +151,7 @@ python_api_name: qiskit.circuit.IfElseOp ### broadcast\_arguments - + Validation of the arguments. **Parameters** @@ -172,21 +170,17 @@ python_api_name: qiskit.circuit.IfElseOp ### c\_if - + 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. - - - The method `qiskit.circuit.instruction.Instruction.c_if()` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### copy - + Copy of the instruction. **Parameters** @@ -204,7 +198,7 @@ python_api_name: qiskit.circuit.IfElseOp ### inverse - + Invert this instruction. If annotated is False, the inverse instruction is implemented as a fresh instruction with the recursively inverted definition. @@ -228,7 +222,7 @@ python_api_name: qiskit.circuit.IfElseOp ### is\_parameterized - + Return whether the [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") contains [compile-time parameters](circuit#circuit-compile-time-parameters). @@ -244,7 +238,7 @@ python_api_name: qiskit.circuit.IfElseOp ### repeat - + Creates an instruction with `self` repeated :math\`n\` times. If this operation has a conditional, the output instruction will have the same conditional and the inner repeated operations will be unconditional; instructions within a compound definition cannot be conditioned on registers within Qiskit’s data model. This means that it is not valid to apply a repeated instruction to a clbit that it both writes to and reads from in its condition. @@ -268,7 +262,7 @@ python_api_name: qiskit.circuit.IfElseOp ### replace\_blocks - + Replace blocks and return new instruction. **Parameters** @@ -286,7 +280,7 @@ python_api_name: qiskit.circuit.IfElseOp ### 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. @@ -304,7 +298,7 @@ python_api_name: qiskit.circuit.IfElseOp ### soft\_compare - + 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** @@ -330,7 +324,7 @@ python_api_name: qiskit.circuit.IfElseOp ### validate\_parameter - + Instruction parameters has no validation or normalization. diff --git a/docs/api/qiskit/dev/qiskit.circuit.Instruction.mdx b/docs/api/qiskit/dev/qiskit.circuit.Instruction.mdx index 878e376d475..91024014594 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.Instruction.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.Instruction.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.circuit.Instruction # Instruction - + Bases: [`Operation`](qiskit.circuit.Operation "qiskit.circuit.operation.Operation") Generic quantum instruction. @@ -57,20 +57,12 @@ python_api_name: qiskit.circuit.Instruction The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions @@ -147,13 +139,13 @@ python_api_name: qiskit.circuit.Instruction ### add\_decomposition - + Add a decomposition of the instruction to the SessionEquivalenceLibrary. ### assemble - + Assemble a QasmQobjInstruction @@ -163,7 +155,7 @@ python_api_name: qiskit.circuit.Instruction ### broadcast\_arguments - + Validation of the arguments. **Parameters** @@ -182,21 +174,17 @@ python_api_name: qiskit.circuit.Instruction ### c\_if - + 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. - - - The method `qiskit.circuit.instruction.Instruction.c_if()` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### copy - + Copy of the instruction. **Parameters** @@ -214,7 +202,7 @@ python_api_name: qiskit.circuit.Instruction ### inverse - + Invert this instruction. If annotated is False, the inverse instruction is implemented as a fresh instruction with the recursively inverted definition. @@ -238,13 +226,13 @@ python_api_name: qiskit.circuit.Instruction ### is\_parameterized - + Return whether the [`Instruction`](#qiskit.circuit.Instruction "qiskit.circuit.Instruction") contains [compile-time parameters](circuit#circuit-compile-time-parameters). ### repeat - + Creates an instruction with `self` repeated :math\`n\` times. If this operation has a conditional, the output instruction will have the same conditional and the inner repeated operations will be unconditional; instructions within a compound definition cannot be conditioned on registers within Qiskit’s data model. This means that it is not valid to apply a repeated instruction to a clbit that it both writes to and reads from in its condition. @@ -268,7 +256,7 @@ python_api_name: qiskit.circuit.Instruction ### 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. @@ -286,7 +274,7 @@ python_api_name: qiskit.circuit.Instruction ### soft\_compare - + 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** @@ -312,7 +300,7 @@ python_api_name: qiskit.circuit.Instruction ### validate\_parameter - + Instruction parameters has no validation or normalization. diff --git a/docs/api/qiskit/dev/qiskit.circuit.InstructionSet.mdx b/docs/api/qiskit/dev/qiskit.circuit.InstructionSet.mdx index cc7d04bd57f..6bd0dd5a584 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.InstructionSet.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.InstructionSet.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.circuit.InstructionSet # InstructionSet - + Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.13)") Instruction collection, and their contexts. @@ -51,13 +51,13 @@ python_api_name: qiskit.circuit.InstructionSet ### add - + Add an instruction and its context (where it is attached). ### c\_if - + Set a classical equality condition on all the instructions in this set between the [`ClassicalRegister`](circuit#qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister") or [`Clbit`](circuit#qiskit.circuit.Clbit "qiskit.circuit.Clbit") `classical` and value `val`. @@ -68,10 +68,6 @@ python_api_name: qiskit.circuit.InstructionSet 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. - - The method `qiskit.circuit.instructionset.InstructionSet.c_if()` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - - **Parameters** * **classical** ([*Clbit*](circuit#qiskit.circuit.Clbit "qiskit.circuit.Clbit") *|*[*ClassicalRegister*](circuit#qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister") *|*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")) – the classical resource the equality condition should be on. If this is given as an integer, it will be resolved into a [`Clbit`](circuit#qiskit.circuit.Clbit "qiskit.circuit.Clbit") using the same conventions as the circuit these instructions are attached to. @@ -92,7 +88,7 @@ python_api_name: qiskit.circuit.InstructionSet ### inverse - + Invert all instructions. diff --git a/docs/api/qiskit/dev/qiskit.circuit.QuantumCircuit.mdx b/docs/api/qiskit/dev/qiskit.circuit.QuantumCircuit.mdx index 0a77fe43496..155d1b958bd 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.QuantumCircuit.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.QuantumCircuit.mdx @@ -12,7 +12,7 @@ python_api_name: qiskit.circuit.QuantumCircuit # [`QuantumCircuit`](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") class - + Core Qiskit representation of a quantum circuit. @@ -196,10 +196,6 @@ python_api_name: qiskit.circuit.QuantumCircuit Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - If you have transpiled your circuit, so you have a physical circuit, you can inspect the [`layout`](#qiskit.circuit.QuantumCircuit.layout "qiskit.circuit.QuantumCircuit.layout") attribute for information stored by the transpiler about how the virtual qubits of the source circuit map to the hardware qubits of your physical circuit, both at the start and end of the circuit. @@ -325,7 +321,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### \_\_init\_\_ - + Default constructor of [`QuantumCircuit`](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"). **Parameters** @@ -377,7 +373,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### copy - + Copy the circuit. **Parameters** @@ -397,7 +393,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### copy\_empty\_like - + Return a copy of self with the same structure but empty. That structure includes: @@ -444,7 +440,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### from\_instructions - + Construct a circuit from an iterable of [`CircuitInstruction`](qiskit.circuit.CircuitInstruction "qiskit.circuit.CircuitInstruction")s. **Parameters** @@ -469,7 +465,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### from\_qasm\_file - + Read an OpenQASM 2.0 program from a file and convert to an instance of [`QuantumCircuit`](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"). **Parameters** @@ -491,7 +487,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### from\_qasm\_str - + Convert a string containing an OpenQASM 2.0 program to a [`QuantumCircuit`](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"). **Parameters** @@ -532,7 +528,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### add\_bits - + Add Bits to the circuit. @@ -540,7 +536,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### add\_register - + Add registers. @@ -548,7 +544,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### add\_var - + Add a classical variable with automatic storage and scope to this circuit. The variable is considered to have been “declared” at the beginning of the circuit, but it only becomes initialized at the point of the circuit that you call this method, so it can depend on variables defined before it. @@ -618,7 +614,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### add\_input - + Register a variable as an input to the circuit. **Parameters** @@ -639,7 +635,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### add\_uninitialized\_var - + Add a variable with no initializer. In most cases, you should use [`add_var()`](#qiskit.circuit.QuantumCircuit.add_var "qiskit.circuit.QuantumCircuit.add_var") to initialize the variable. To use this function, you must already hold a [`Var`](circuit_classical#qiskit.circuit.classical.expr.Var "qiskit.circuit.classical.expr.Var") instance, as the use of the function typically only makes sense in copying contexts. @@ -657,7 +653,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### add\_capture - + Add a variable to the circuit that it should capture from a scope it will be contained within. This method requires a [`Var`](circuit_classical#qiskit.circuit.classical.expr.Var "qiskit.circuit.classical.expr.Var") node to enforce that you’ve got a handle to one, because you will need to declare the same variable using the same object into the outer circuit. @@ -679,7 +675,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### find\_bit - + Find locations in the circuit which can be used to reference a given [`Bit`](circuit#qiskit.circuit.Bit "qiskit.circuit.Bit"). In particular, this function can find the integer index of a qubit, which corresponds to its hardware index for a transpiled circuit. @@ -738,7 +734,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### has\_register - + Test if this circuit has the register r. **Parameters** @@ -768,7 +764,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### assign\_parameters - + Assign parameters to new parameters or values. If `parameters` is passed as a dictionary, the keys should 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. @@ -844,7 +840,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### has\_parameter - + Check whether a parameter object exists in this circuit. **Parameters** @@ -872,7 +868,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### get\_parameter - + Retrieve a compile-time parameter that is accessible in this circuit scope by name. **Parameters** @@ -944,7 +940,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### get\_var - + Retrieve a variable that is accessible in this circuit scope by name. **Parameters** @@ -994,7 +990,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### has\_var - + Check whether a variable is accessible in this scope. **Parameters** @@ -1024,7 +1020,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### iter\_vars - + Get an iterable over all real-time classical variables in scope within this circuit. This method will iterate over all variables in scope. For more fine-grained iterators, see [`iter_declared_vars()`](#qiskit.circuit.QuantumCircuit.iter_declared_vars "qiskit.circuit.QuantumCircuit.iter_declared_vars"), [`iter_input_vars()`](#qiskit.circuit.QuantumCircuit.iter_input_vars "qiskit.circuit.QuantumCircuit.iter_input_vars") and [`iter_captured_vars()`](#qiskit.circuit.QuantumCircuit.iter_captured_vars "qiskit.circuit.QuantumCircuit.iter_captured_vars"). @@ -1036,7 +1032,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### iter\_input\_vars - + Get an iterable over all real-time classical variables that are declared as inputs to this circuit scope. This excludes locally declared variables (see [`iter_declared_vars()`](#qiskit.circuit.QuantumCircuit.iter_declared_vars "qiskit.circuit.QuantumCircuit.iter_declared_vars")) and captured variables (see [`iter_captured_vars()`](#qiskit.circuit.QuantumCircuit.iter_captured_vars "qiskit.circuit.QuantumCircuit.iter_captured_vars")). **Return type** @@ -1046,7 +1042,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### iter\_captured\_vars - + Get an iterable over all real-time classical variables that are captured by this circuit scope from a containing scope. This excludes input variables (see [`iter_input_vars()`](#qiskit.circuit.QuantumCircuit.iter_input_vars "qiskit.circuit.QuantumCircuit.iter_input_vars")) and locally declared variables (see [`iter_declared_vars()`](#qiskit.circuit.QuantumCircuit.iter_declared_vars "qiskit.circuit.QuantumCircuit.iter_declared_vars")). **Return type** @@ -1056,7 +1052,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### iter\_declared\_vars - + Get an iterable over all real-time classical variables that are declared with automatic storage duration in this scope. This excludes input variables (see [`iter_input_vars()`](#qiskit.circuit.QuantumCircuit.iter_input_vars "qiskit.circuit.QuantumCircuit.iter_input_vars")) and captured variables (see [`iter_captured_vars()`](#qiskit.circuit.QuantumCircuit.iter_captured_vars "qiskit.circuit.QuantumCircuit.iter_captured_vars")). **Return type** @@ -1099,7 +1095,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### append - + 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`](circuit#qiskit.circuit.Bit "qiskit.circuit.Bit") specifiers (such as integer indices) will be resolved into the relevant instances. @@ -1130,7 +1126,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### \_append - + Append an instruction to the end of the circuit, modifying the circuit in place. @@ -1172,7 +1168,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### compose - + Apply the instructions from one circuit onto specified qubits and/or clbits on another. @@ -1232,7 +1228,7 @@ python_api_name: qiskit.circuit.QuantumCircuit >>> lhs.compose(rhs, qubits=[3, 2], inplace=True) ``` - ```text + ```python ┌───┐ ┌─────┐ ┌───┐ lqr_1_0: ───┤ H ├─── rqr_0: ──■──┤ Tdg ├ lqr_1_0: ───┤ H ├─────────────── ├───┤ ┌─┴─┐└─────┘ ├───┤ @@ -1254,12 +1250,12 @@ python_api_name: qiskit.circuit.QuantumCircuit #### tensor - + 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](/guides/construct-circuits) for more information. - ```text + ```python ┌────────┐ ┌─────┐ ┌─────┐ q_0: ┤ bottom ├ ⊗ q_0: ┤ top ├ = q_0: ─┤ top ├── └────────┘ └─────┘ ┌┴─────┴─┐ @@ -1398,7 +1394,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### barrier - + Apply `Barrier`. If `qargs` is empty, applies to all qubits in the circuit. **Parameters** @@ -1417,7 +1413,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### ccx - + Apply [`CCXGate`](qiskit.circuit.library.CCXGate "qiskit.circuit.library.CCXGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -1440,7 +1436,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### ccz - + Apply [`CCZGate`](qiskit.circuit.library.CCZGate "qiskit.circuit.library.CCZGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -1464,7 +1460,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### ch - + Apply [`CHGate`](qiskit.circuit.library.CHGate "qiskit.circuit.library.CHGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -1487,7 +1483,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### cp - + Apply [`CPhaseGate`](qiskit.circuit.library.CPhaseGate "qiskit.circuit.library.CPhaseGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -1511,7 +1507,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### crx - + Apply [`CRXGate`](qiskit.circuit.library.CRXGate "qiskit.circuit.library.CRXGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -1535,7 +1531,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### cry - + Apply [`CRYGate`](qiskit.circuit.library.CRYGate "qiskit.circuit.library.CRYGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -1559,7 +1555,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### crz - + Apply [`CRZGate`](qiskit.circuit.library.CRZGate "qiskit.circuit.library.CRZGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -1583,7 +1579,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### cs - + Apply [`CSGate`](qiskit.circuit.library.CSGate "qiskit.circuit.library.CSGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -1606,7 +1602,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### csdg - + Apply [`CSdgGate`](qiskit.circuit.library.CSdgGate "qiskit.circuit.library.CSdgGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -1629,7 +1625,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### cswap - + Apply [`CSwapGate`](qiskit.circuit.library.CSwapGate "qiskit.circuit.library.CSwapGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -1653,7 +1649,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### csx - + Apply [`CSXGate`](qiskit.circuit.library.CSXGate "qiskit.circuit.library.CSXGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -1676,7 +1672,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### cu - + Apply [`CUGate`](qiskit.circuit.library.CUGate "qiskit.circuit.library.CUGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -1703,7 +1699,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### cx - + Apply [`CXGate`](qiskit.circuit.library.CXGate "qiskit.circuit.library.CXGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -1726,7 +1722,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### cy - + Apply [`CYGate`](qiskit.circuit.library.CYGate "qiskit.circuit.library.CYGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -1749,7 +1745,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### cz - + Apply [`CZGate`](qiskit.circuit.library.CZGate "qiskit.circuit.library.CZGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -1772,7 +1768,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### dcx - + Apply [`DCXGate`](qiskit.circuit.library.DCXGate "qiskit.circuit.library.DCXGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -1793,7 +1789,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### delay - + Apply [`Delay`](circuit#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** @@ -1817,7 +1813,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### ecr - + Apply [`ECRGate`](qiskit.circuit.library.ECRGate "qiskit.circuit.library.ECRGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -1838,7 +1834,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### h - + Apply [`HGate`](qiskit.circuit.library.HGate "qiskit.circuit.library.HGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -1858,7 +1854,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### id - + Apply [`IGate`](qiskit.circuit.library.IGate "qiskit.circuit.library.IGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -1878,7 +1874,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### initialize - + 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. @@ -1916,7 +1912,7 @@ python_api_name: qiskit.circuit.QuantumCircuit output: - ```text + ```python ┌──────────────────────────────┐ q_0: ┤ Initialize(0.70711,-0.70711) ├ └──────────────────────────────┘ @@ -1935,7 +1931,7 @@ python_api_name: qiskit.circuit.QuantumCircuit output: - ```text + ```python ┌──────────────────┐ q_0: ┤0 ├ │ Initialize(0,1) │ @@ -1956,7 +1952,7 @@ python_api_name: qiskit.circuit.QuantumCircuit output: - ```text + ```python ┌────────────────────────────────────┐ q_0: ┤0 ├ │ Initialize(0,0.70711,-0.70711j,0) │ @@ -1967,7 +1963,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### iswap - + Apply [`iSwapGate`](qiskit.circuit.library.iSwapGate "qiskit.circuit.library.iSwapGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -1988,7 +1984,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### mcp - + Apply [`MCPhaseGate`](qiskit.circuit.library.MCPhaseGate "qiskit.circuit.library.MCPhaseGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2067,7 +2063,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### mcx - + 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: @@ -2103,7 +2099,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### measure - + 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. @@ -2137,7 +2133,7 @@ python_api_name: qiskit.circuit.QuantumCircuit circuit.draw() ``` - ```text + ```python ┌───┐┌─┐ q: ┤ H ├┤M├ └───┘└╥┘ @@ -2179,7 +2175,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### ms - + Apply [`MSGate`](qiskit.circuit.library.MSGate "qiskit.circuit.library.MSGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2200,7 +2196,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### p - + Apply [`PhaseGate`](qiskit.circuit.library.PhaseGate "qiskit.circuit.library.PhaseGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2221,7 +2217,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### pauli - + Apply [`PauliGate`](qiskit.circuit.library.PauliGate "qiskit.circuit.library.PauliGate"). **Parameters** @@ -2240,7 +2236,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### prepare\_state - + Prepare qubits in a specific state. This class implements a state preparing unitary. Unlike [`initialize()`](#qiskit.circuit.QuantumCircuit.initialize "qiskit.circuit.QuantumCircuit.initialize") it does not reset the qubits first. @@ -2284,7 +2280,7 @@ python_api_name: qiskit.circuit.QuantumCircuit output: - ```text + ```python ┌─────────────────────────────────────┐ q_0: ┤ State Preparation(0.70711,-0.70711) ├ └─────────────────────────────────────┘ @@ -2303,7 +2299,7 @@ python_api_name: qiskit.circuit.QuantumCircuit output: - ```text + ```python ┌─────────────────────────┐ q_0: ┤0 ├ │ State Preparation(0,1) │ @@ -2324,7 +2320,7 @@ python_api_name: qiskit.circuit.QuantumCircuit output: - ```text + ```python ┌───────────────────────────────────────────┐ q_0: ┤0 ├ │ State Preparation(0,0.70711,-0.70711j,0) │ @@ -2335,7 +2331,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### r - + Apply [`RGate`](qiskit.circuit.library.RGate "qiskit.circuit.library.RGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2357,7 +2353,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### rcccx - + Apply [`RC3XGate`](qiskit.circuit.library.RC3XGate "qiskit.circuit.library.RC3XGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2380,7 +2376,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### rccx - + Apply [`RCCXGate`](qiskit.circuit.library.RCCXGate "qiskit.circuit.library.RCCXGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2402,7 +2398,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### reset - + Reset the quantum bit(s) to their default state. **Parameters** @@ -2420,7 +2416,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### rv - + Apply [`RVGate`](qiskit.circuit.library.RVGate "qiskit.circuit.library.RVGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2445,7 +2441,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### rx - + Apply [`RXGate`](qiskit.circuit.library.RXGate "qiskit.circuit.library.RXGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2467,7 +2463,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### rxx - + Apply [`RXXGate`](qiskit.circuit.library.RXXGate "qiskit.circuit.library.RXXGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2489,7 +2485,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### ry - + Apply [`RYGate`](qiskit.circuit.library.RYGate "qiskit.circuit.library.RYGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2511,7 +2507,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### ryy - + Apply [`RYYGate`](qiskit.circuit.library.RYYGate "qiskit.circuit.library.RYYGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2533,7 +2529,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### rz - + Apply [`RZGate`](qiskit.circuit.library.RZGate "qiskit.circuit.library.RZGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2554,7 +2550,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### rzx - + Apply [`RZXGate`](qiskit.circuit.library.RZXGate "qiskit.circuit.library.RZXGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2576,7 +2572,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### rzz - + Apply [`RZZGate`](qiskit.circuit.library.RZZGate "qiskit.circuit.library.RZZGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2598,7 +2594,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### s - + Apply [`SGate`](qiskit.circuit.library.SGate "qiskit.circuit.library.SGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2618,7 +2614,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### sdg - + Apply [`SdgGate`](qiskit.circuit.library.SdgGate "qiskit.circuit.library.SdgGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2638,7 +2634,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### store - + Store the result of the given real-time classical expression `rvalue` in the memory location defined by `lvalue`. Typically `lvalue` will be a [`Var`](circuit_classical#qiskit.circuit.classical.expr.Var "qiskit.circuit.classical.expr.Var") node and `rvalue` will be some [`Expr`](circuit_classical#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.Expr") to write into it, but anything that [`expr.lift()`](circuit_classical#qiskit.circuit.classical.expr.lift "qiskit.circuit.classical.expr.lift") can raise to an [`Expr`](circuit_classical#qiskit.circuit.classical.expr.Expr "qiskit.circuit.classical.expr.Expr") is permissible in both places, and it will be called on them. @@ -2665,7 +2661,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### swap - + Apply [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2686,7 +2682,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### sx - + Apply [`SXGate`](qiskit.circuit.library.SXGate "qiskit.circuit.library.SXGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2706,7 +2702,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### sxdg - + Apply [`SXdgGate`](qiskit.circuit.library.SXdgGate "qiskit.circuit.library.SXdgGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2726,7 +2722,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### t - + Apply [`TGate`](qiskit.circuit.library.TGate "qiskit.circuit.library.TGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2746,7 +2742,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### tdg - + Apply [`TdgGate`](qiskit.circuit.library.TdgGate "qiskit.circuit.library.TdgGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2766,7 +2762,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### u - + Apply [`UGate`](qiskit.circuit.library.UGate "qiskit.circuit.library.UGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2789,7 +2785,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### unitary - + Apply unitary gate specified by `obj` to `qubits`. **Parameters** @@ -2823,7 +2819,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### x - + Apply [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.library.XGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2844,7 +2840,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### y - + Apply [`YGate`](qiskit.circuit.library.YGate "qiskit.circuit.library.YGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2864,7 +2860,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### z - + Apply [`ZGate`](qiskit.circuit.library.ZGate "qiskit.circuit.library.ZGate"). For the full matrix form of this gate, see the underlying gate documentation. @@ -2908,7 +2904,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### break\_loop - + Apply [`BreakLoopOp`](qiskit.circuit.BreakLoopOp "qiskit.circuit.BreakLoopOp"). @@ -2930,7 +2926,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### continue\_loop - + Apply [`ContinueLoopOp`](qiskit.circuit.ContinueLoopOp "qiskit.circuit.ContinueLoopOp"). @@ -2952,7 +2948,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### for\_loop - + 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. @@ -3003,7 +2999,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### if\_else - + Apply [`IfElseOp`](qiskit.circuit.IfElseOp "qiskit.circuit.IfElseOp"). @@ -3047,7 +3043,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### if\_test - + 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. @@ -3101,7 +3097,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### switch - + 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. @@ -3148,7 +3144,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### while\_loop - + 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. @@ -3193,7 +3189,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### to\_instruction - + Create an [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") out of this circuit. @@ -3220,7 +3216,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### to\_gate - + Create a [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate") out of this circuit. The circuit must act only qubits and contain only unitary operations. @@ -3249,7 +3245,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### measure\_active - + 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. @@ -3269,7 +3265,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### measure\_all - + Adds measurement to all qubits. By default, adds new classical bits in a [`ClassicalRegister`](circuit#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`. @@ -3298,7 +3294,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### clear - + Clear all instructions in self. Clearing the circuits will keep the metadata and calibrations. @@ -3312,7 +3308,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### remove\_final\_measurements - + 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.) @@ -3362,13 +3358,9 @@ python_api_name: qiskit.circuit.QuantumCircuit #### add\_calibration - + Register a low-level, custom pulse definition for the given gate. - - The method `qiskit.circuit.quantumcircuit.QuantumCircuit.add_calibration()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.add_calibration()` will have no alternative in Qiskit. - - **Parameters** * **gate** (*Union\[*[*Gate*](qiskit.circuit.Gate "qiskit.circuit.Gate")*,* [*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.13)")*]*) – Gate information. @@ -3383,12 +3375,8 @@ python_api_name: qiskit.circuit.QuantumCircuit #### has\_calibration\_for - + 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. - - - The method `qiskit.circuit.quantumcircuit.QuantumCircuit.has_calibration_for()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.has_calibration_for()` will have no alternative in Qiskit. - ## Circuit properties @@ -3442,7 +3430,7 @@ python_api_name: qiskit.circuit.QuantumCircuit qc.count_ops() ``` - ```text + ```python OrderedDict([('cx', 8), ('h', 5), ('x', 3), ('swap', 3)]) ``` @@ -3466,7 +3454,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### count\_ops - + Count each operation kind in the circuit. **Returns** @@ -3480,7 +3468,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### depth - + Return circuit depth (i.e., length of critical path). @@ -3522,7 +3510,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### get\_instructions - + Get instructions matching name. **Parameters** @@ -3540,7 +3528,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### num\_connected\_components - + How many non-entangled subcircuits can the circuit be factored to. **Parameters** @@ -3558,7 +3546,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### num\_nonlocal\_gates - + Return number of non-local gates (i.e. involving 2+ qubits). Conditional nonlocal gates are also included. @@ -3570,7 +3558,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### num\_tensor\_factors - + Computes the number of tensor factors in the unitary (quantum) part of the circuit only. **Notes** @@ -3584,7 +3572,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### num\_unitary\_factors - + Computes the number of tensor factors in the unitary (quantum) part of the circuit only. **Return type** @@ -3594,7 +3582,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### size - + Returns total number of instructions in circuit. **Parameters** @@ -3612,7 +3600,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### width - + Return number of qubits plus clbits in circuit. **Returns** @@ -3630,7 +3618,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### qubit\_duration - + 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** @@ -3648,7 +3636,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### qubit\_start\_time - + 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 @@ -3673,7 +3661,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### qubit\_stop\_time - + 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 @@ -3702,7 +3690,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### control - + Control this circuit on `num_ctrl_qubits` qubits. **Parameters** @@ -3727,7 +3715,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### inverse - + Invert (take adjoint of) this circuit. This is done by recursively inverting all gates. @@ -3752,7 +3740,7 @@ python_api_name: qiskit.circuit.QuantumCircuit input: - ```text + ```python ┌───┐ q_0: ┤ H ├─────■────── └───┘┌────┴─────┐ @@ -3762,7 +3750,7 @@ python_api_name: qiskit.circuit.QuantumCircuit output: - ```text + ```python ┌───┐ q_0: ──────■──────┤ H ├ ┌─────┴─────┐└───┘ @@ -3773,7 +3761,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### power - + Raise this circuit to the power of `power`. If `power` is a positive integer and both `matrix_power` and `annotated` are `False`, this implementation defaults to calling `repeat`. Otherwise, the circuit is converted into a gate, and a new circuit, containing this gate raised to the given power, is returned. The gate raised to the given power is implemented either as a unitary gate if `annotated` is `False` or as an annotated operation if `annotated` is `True`. @@ -3799,7 +3787,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### repeat - + Repeat this circuit `reps` times. **Parameters** @@ -3818,7 +3806,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### 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. @@ -3835,7 +3823,7 @@ python_api_name: qiskit.circuit.QuantumCircuit input: - ```text + ```python ┌───┐ q_0: ┤ H ├─────■────── └───┘┌────┴─────┐ @@ -3845,7 +3833,7 @@ python_api_name: qiskit.circuit.QuantumCircuit output: - ```text + ```python ┌───┐ q_0: ─────■──────┤ H ├ ┌────┴─────┐└───┘ @@ -3866,7 +3854,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### draw - + Draw the quantum circuit. Use the output parameter to choose the drawing format: **text**: ASCII art TextDrawing that can be printed in the console. @@ -3966,7 +3954,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### decompose - + Call a decomposition pass on this circuit, to decompose one level (shallow decompose). **Parameters** @@ -3985,7 +3973,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### 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. @@ -4004,7 +3992,7 @@ python_api_name: qiskit.circuit.QuantumCircuit input: - ```text + ```python ┌───┐ a_0: ┤ H ├──■───────────────── └───┘┌─┴─┐ @@ -4020,7 +4008,7 @@ python_api_name: qiskit.circuit.QuantumCircuit output: - ```text + ```python ┌───┐ b_0: ────────────────────┤ X ├ ┌───┐└─┬─┘ @@ -4041,7 +4029,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### cast - + Best effort to cast value to type. Otherwise, returns the value. @@ -4055,7 +4043,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### cbit\_argument\_conversion - + Converts several classical bit representations (such as indexes, range, etc.) into a list of classical bits. @@ -4077,7 +4065,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### cls\_instances - + Return the current number of instances of this class, useful for auto naming. @@ -4091,7 +4079,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### cls\_prefix - + Return the prefix to use for auto naming. @@ -4105,7 +4093,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### qbit\_argument\_conversion - + Converts several qubit representations (such as indexes, range, etc.) into a list of qubits. diff --git a/docs/api/qiskit/dev/qiskit.circuit.SwitchCaseOp.mdx b/docs/api/qiskit/dev/qiskit.circuit.SwitchCaseOp.mdx index 7781808f95c..6e5edfea48d 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.SwitchCaseOp.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.SwitchCaseOp.mdx @@ -49,20 +49,12 @@ python_api_name: qiskit.circuit.SwitchCaseOp The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions @@ -139,13 +131,13 @@ python_api_name: qiskit.circuit.SwitchCaseOp ### add\_decomposition - + Add a decomposition of the instruction to the SessionEquivalenceLibrary. ### assemble - + Assemble a QasmQobjInstruction @@ -155,7 +147,7 @@ python_api_name: qiskit.circuit.SwitchCaseOp ### broadcast\_arguments - + Validation of the arguments. **Parameters** @@ -180,10 +172,6 @@ python_api_name: qiskit.circuit.SwitchCaseOp This is a setter method, not an additive one. Calling this multiple times will silently override any previously set condition; it does not stack. - - - The method `qiskit.circuit.instruction.Instruction.c_if()` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### cases @@ -218,7 +206,7 @@ python_api_name: qiskit.circuit.SwitchCaseOp ### copy - + Copy of the instruction. **Parameters** @@ -236,7 +224,7 @@ python_api_name: qiskit.circuit.SwitchCaseOp ### inverse - + Invert this instruction. If annotated is False, the inverse instruction is implemented as a fresh instruction with the recursively inverted definition. @@ -260,7 +248,7 @@ python_api_name: qiskit.circuit.SwitchCaseOp ### is\_parameterized - + Return whether the [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") contains [compile-time parameters](circuit#circuit-compile-time-parameters). @@ -276,7 +264,7 @@ python_api_name: qiskit.circuit.SwitchCaseOp ### repeat - + Creates an instruction with `self` repeated :math\`n\` times. If this operation has a conditional, the output instruction will have the same conditional and the inner repeated operations will be unconditional; instructions within a compound definition cannot be conditioned on registers within Qiskit’s data model. This means that it is not valid to apply a repeated instruction to a clbit that it both writes to and reads from in its condition. @@ -335,7 +323,7 @@ python_api_name: qiskit.circuit.SwitchCaseOp ### 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. @@ -353,7 +341,7 @@ python_api_name: qiskit.circuit.SwitchCaseOp ### soft\_compare - + 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** @@ -379,7 +367,7 @@ python_api_name: qiskit.circuit.SwitchCaseOp ### validate\_parameter - + Instruction parameters has no validation or normalization. diff --git a/docs/api/qiskit/dev/qiskit.circuit.WhileLoopOp.mdx b/docs/api/qiskit/dev/qiskit.circuit.WhileLoopOp.mdx index e594a59e323..a00b24b7cb1 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.WhileLoopOp.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.WhileLoopOp.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.circuit.WhileLoopOp # WhileLoopOp - + 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. @@ -50,16 +50,14 @@ python_api_name: qiskit.circuit.WhileLoopOp ### condition - + + The classical condition on the instruction. + ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions @@ -134,13 +132,13 @@ python_api_name: qiskit.circuit.WhileLoopOp ### add\_decomposition - + Add a decomposition of the instruction to the SessionEquivalenceLibrary. ### assemble - + Assemble a QasmQobjInstruction @@ -150,7 +148,7 @@ python_api_name: qiskit.circuit.WhileLoopOp ### broadcast\_arguments - + Validation of the arguments. **Parameters** @@ -169,21 +167,17 @@ python_api_name: qiskit.circuit.WhileLoopOp ### c\_if - + 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. - - - The method `qiskit.circuit.instruction.Instruction.c_if()` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### copy - + Copy of the instruction. **Parameters** @@ -201,7 +195,7 @@ python_api_name: qiskit.circuit.WhileLoopOp ### inverse - + Invert this instruction. If annotated is False, the inverse instruction is implemented as a fresh instruction with the recursively inverted definition. @@ -225,7 +219,7 @@ python_api_name: qiskit.circuit.WhileLoopOp ### is\_parameterized - + Return whether the [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") contains [compile-time parameters](circuit#circuit-compile-time-parameters). @@ -241,7 +235,7 @@ python_api_name: qiskit.circuit.WhileLoopOp ### repeat - + Creates an instruction with `self` repeated :math\`n\` times. If this operation has a conditional, the output instruction will have the same conditional and the inner repeated operations will be unconditional; instructions within a compound definition cannot be conditioned on registers within Qiskit’s data model. This means that it is not valid to apply a repeated instruction to a clbit that it both writes to and reads from in its condition. @@ -265,7 +259,7 @@ python_api_name: qiskit.circuit.WhileLoopOp ### replace\_blocks - + Return a new version of this control-flow operations with the [`blocks`](#qiskit.circuit.WhileLoopOp.blocks "qiskit.circuit.WhileLoopOp.blocks") mapped to the given new ones. Typically this is used in a workflow such as: @@ -296,7 +290,7 @@ python_api_name: qiskit.circuit.WhileLoopOp ### 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. @@ -314,7 +308,7 @@ python_api_name: qiskit.circuit.WhileLoopOp ### soft\_compare - + 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** @@ -340,7 +334,7 @@ python_api_name: qiskit.circuit.WhileLoopOp ### validate\_parameter - + Instruction parameters has no validation or normalization. diff --git a/docs/api/qiskit/dev/qiskit.circuit.classicalfunction.BooleanExpression.mdx b/docs/api/qiskit/dev/qiskit.circuit.classicalfunction.BooleanExpression.mdx index 9220c7a9f0f..034c6b44eba 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.classicalfunction.BooleanExpression.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.classicalfunction.BooleanExpression.mdx @@ -46,20 +46,12 @@ python_api_name: qiskit.circuit.classicalfunction.BooleanExpression The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions @@ -136,13 +128,13 @@ python_api_name: qiskit.circuit.classicalfunction.BooleanExpression ### add\_decomposition - + Add a decomposition of the instruction to the SessionEquivalenceLibrary. ### assemble - + Assemble a QasmQobjInstruction @@ -205,16 +197,12 @@ python_api_name: qiskit.circuit.classicalfunction.BooleanExpression ### c\_if - + 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. - - - The method `qiskit.circuit.instruction.Instruction.c_if()` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### control @@ -242,7 +230,7 @@ python_api_name: qiskit.circuit.classicalfunction.BooleanExpression ### copy - + Copy of the instruction. **Parameters** @@ -278,7 +266,7 @@ python_api_name: qiskit.circuit.classicalfunction.BooleanExpression ### inverse - + Invert this instruction. If annotated is False, the inverse instruction is implemented as a fresh instruction with the recursively inverted definition. @@ -302,7 +290,7 @@ python_api_name: qiskit.circuit.classicalfunction.BooleanExpression ### is\_parameterized - + Return whether the `Instruction` contains [compile-time parameters](circuit#circuit-compile-time-parameters). @@ -329,7 +317,7 @@ python_api_name: qiskit.circuit.classicalfunction.BooleanExpression ### repeat - + Creates an instruction with `self` repeated :math\`n\` times. If this operation has a conditional, the output instruction will have the same conditional and the inner repeated operations will be unconditional; instructions within a compound definition cannot be conditioned on registers within Qiskit’s data model. This means that it is not valid to apply a repeated instruction to a clbit that it both writes to and reads from in its condition. @@ -353,7 +341,7 @@ python_api_name: qiskit.circuit.classicalfunction.BooleanExpression ### 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. @@ -391,7 +379,7 @@ python_api_name: qiskit.circuit.classicalfunction.BooleanExpression ### soft\_compare - + 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** diff --git a/docs/api/qiskit/dev/qiskit.circuit.classicalfunction.ClassicalFunction.mdx b/docs/api/qiskit/dev/qiskit.circuit.classicalfunction.ClassicalFunction.mdx index f11e4e0d304..f9bbe589b45 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.classicalfunction.ClassicalFunction.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.classicalfunction.ClassicalFunction.mdx @@ -59,20 +59,12 @@ python_api_name: qiskit.circuit.classicalfunction.ClassicalFunction The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions @@ -187,13 +179,13 @@ python_api_name: qiskit.circuit.classicalfunction.ClassicalFunction ### add\_decomposition - + Add a decomposition of the instruction to the SessionEquivalenceLibrary. ### assemble - + Assemble a QasmQobjInstruction @@ -256,16 +248,12 @@ python_api_name: qiskit.circuit.classicalfunction.ClassicalFunction ### c\_if - + 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. - - - The method `qiskit.circuit.instruction.Instruction.c_if()` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### compile @@ -299,7 +287,7 @@ python_api_name: qiskit.circuit.classicalfunction.ClassicalFunction ### copy - + Copy of the instruction. **Parameters** @@ -317,7 +305,7 @@ python_api_name: qiskit.circuit.classicalfunction.ClassicalFunction ### inverse - + Invert this instruction. If annotated is False, the inverse instruction is implemented as a fresh instruction with the recursively inverted definition. @@ -341,7 +329,7 @@ python_api_name: qiskit.circuit.classicalfunction.ClassicalFunction ### is\_parameterized - + Return whether the `Instruction` contains [compile-time parameters](circuit#circuit-compile-time-parameters). @@ -368,7 +356,7 @@ python_api_name: qiskit.circuit.classicalfunction.ClassicalFunction ### repeat - + Creates an instruction with `self` repeated :math\`n\` times. If this operation has a conditional, the output instruction will have the same conditional and the inner repeated operations will be unconditional; instructions within a compound definition cannot be conditioned on registers within Qiskit’s data model. This means that it is not valid to apply a repeated instruction to a clbit that it both writes to and reads from in its condition. @@ -392,7 +380,7 @@ python_api_name: qiskit.circuit.classicalfunction.ClassicalFunction ### 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. @@ -444,7 +432,7 @@ python_api_name: qiskit.circuit.classicalfunction.ClassicalFunction ### soft\_compare - + 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** diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.AND.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.AND.mdx index 16e27b86140..0a71c11602f 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.AND.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.AND.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.circuit.library.AND # AND - + Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit") A circuit implementing the logical AND operation on a number of qubits. @@ -25,13 +25,9 @@ python_api_name: qiskit.circuit.library.AND Create a new logical AND circuit. - - The class `qiskit.circuit.library.boolean_logic.quantum_and.AND` is pending deprecation as of qiskit 1.3. It will be marked deprecated in a future release, and then removed no earlier than 3 months after the release date. Use qiskit.circuit.library.AndGate instead. - - **Parameters** - * **num\_variable\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")) – The qubits of which the AND is computed. The result will be written into an additional result qubit. + * **num\_variable\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")) – 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.13)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")*] | 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.13)")) – The mode to be used to implement the multi-controlled X gate. @@ -49,10 +45,6 @@ python_api_name: qiskit.circuit.library.AND Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -93,7 +85,7 @@ python_api_name: qiskit.circuit.library.AND ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.AndGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.AndGate.mdx deleted file mode 100644 index d2567f7661d..00000000000 --- a/docs/api/qiskit/dev/qiskit.circuit.library.AndGate.mdx +++ /dev/null @@ -1,164 +0,0 @@ ---- -title: AndGate -description: API reference for qiskit.circuit.library.AndGate -in_page_toc_min_heading_level: 1 -python_api_type: class -python_api_name: qiskit.circuit.library.AndGate ---- - -# AndGate - - - Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate") - - A gate representing 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 AndGate gate without special flags equals the multi-controlled-X gate: - - ![../\_images/qiskit-circuit-library-AndGate-1.png](/images/api/qiskit/dev/qiskit-circuit-library-AndGate-1.png) - - 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]`. - - ![../\_images/qiskit-circuit-library-AndGate-2.png](/images/api/qiskit/dev/qiskit-circuit-library-AndGate-2.png) - - **Parameters** - - * **num\_variable\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")) – The qubits of which the AND 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.13)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")*] | None*) – A list of +1/0/-1 marking negations or omissions of 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 behavioral perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.AndGate.base_class "qiskit.circuit.library.AndGate.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 parametrized 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 parametrized 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. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - - - - ### condition\_bits - - - Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - - - - ### decompositions - - - Get the decompositions of the instruction from the SessionEquivalenceLibrary. - - - ### definition - - - Return definition in terms of other basic gates. - - - ### duration - - - Get the duration. - - - The property `qiskit.circuit.instruction.Instruction.duration` is deprecated as of qiskit 1.3.0. It will be removed in Qiskit 2.0.0. - - - - ### 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 - - - The parameters of this `Instruction`. Ideally these will be gate angles. - - - ### unit - - - Get the time unit of duration. - - - The property `qiskit.circuit.instruction.Instruction.unit` is deprecated as of qiskit 1.3.0. It will be removed in Qiskit 2.0.0. - - - - ## Methods - - ### inverse - - - Return inverted AND gate (itself). - - **Parameters** - - **annotated** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.13)")) – when set to `True`, this is typically used to return an [`AnnotatedOperation`](qiskit.circuit.AnnotatedOperation "qiskit.circuit.AnnotatedOperation") with an inverse modifier set instead of a concrete [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate"). However, for this class this argument is ignored as this gate is self-inverse. - - **Returns** - - inverse gate (self-inverse). - - **Return type** - - [AndGate](#qiskit.circuit.library.AndGate "qiskit.circuit.library.AndGate") - - - diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.BitwiseXorGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.BitwiseXorGate.mdx deleted file mode 100644 index 1753fede31f..00000000000 --- a/docs/api/qiskit/dev/qiskit.circuit.library.BitwiseXorGate.mdx +++ /dev/null @@ -1,166 +0,0 @@ ---- -title: BitwiseXorGate -description: API reference for qiskit.circuit.library.BitwiseXorGate -in_page_toc_min_heading_level: 1 -python_api_type: class -python_api_name: qiskit.circuit.library.BitwiseXorGate ---- - -# BitwiseXorGate - - - Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate") - - An n-qubit gate for bitwise xor-ing the input with some integer `amount`. - - The `amount` is xor-ed in bitstring form with the input. - - This gate can also represent addition by `amount` over the finite field GF(2). - - Reference Circuit: - - ![../\_images/qiskit-circuit-library-BitwiseXorGate-1.png](/images/api/qiskit/dev/qiskit-circuit-library-BitwiseXorGate-1.png) - - **Parameters** - - * **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")) – the width of circuit. - * **amount** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")) – the xor amount in decimal form. - - **Raises** - - [**CircuitError**](circuit#qiskit.circuit.CircuitError "qiskit.circuit.CircuitError") – if the xor bitstring exceeds available 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 behavioral perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.BitwiseXorGate.base_class "qiskit.circuit.library.BitwiseXorGate.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 parametrized 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 parametrized 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. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - - - - ### condition\_bits - - - Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - - - - ### decompositions - - - Get the decompositions of the instruction from the SessionEquivalenceLibrary. - - - ### definition - - - Return definition in terms of other basic gates. - - - ### duration - - - Get the duration. - - - The property `qiskit.circuit.instruction.Instruction.duration` is deprecated as of qiskit 1.3.0. It will be removed in Qiskit 2.0.0. - - - - ### 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 - - - The parameters of this `Instruction`. Ideally these will be gate angles. - - - ### unit - - - Get the time unit of duration. - - - The property `qiskit.circuit.instruction.Instruction.unit` is deprecated as of qiskit 1.3.0. It will be removed in Qiskit 2.0.0. - - - - ## Methods - - ### inverse - - - Return inverted BitwiseXorGate gate (itself). - - **Parameters** - - **annotated** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.13)")) – when set to `True`, this is typically used to return an [`AnnotatedOperation`](qiskit.circuit.AnnotatedOperation "qiskit.circuit.AnnotatedOperation") with an inverse modifier set instead of a concrete [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate"). However, for this class this argument is ignored as this gate is self-inverse. - - **Returns** - - inverse gate (self-inverse). - - **Return type** - - [BitwiseXorGate](#qiskit.circuit.library.BitwiseXorGate "qiskit.circuit.library.BitwiseXorGate") - - - diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.C3SXGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.C3SXGate.mdx index 962d131d8e7..373fcc458df 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.C3SXGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.C3SXGate.mdx @@ -53,20 +53,12 @@ python_api_name: qiskit.circuit.library.C3SXGate The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.C3XGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.C3XGate.mdx index e34a7bb9a62..77f0eed4f05 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.C3XGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.C3XGate.mdx @@ -44,20 +44,12 @@ python_api_name: qiskit.circuit.library.C3XGate The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.C4XGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.C4XGate.mdx index 8582a4946c6..0ab0e60e957 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.C4XGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.C4XGate.mdx @@ -49,20 +49,12 @@ python_api_name: qiskit.circuit.library.C4XGate The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.CCXGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.CCXGate.mdx index 50fe9aa583d..347f6783e91 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.CCXGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.CCXGate.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.circuit.library.CCXGate **Circuit symbol:** - ```text + ```python q_0: ──■── │ q_1: ──■── @@ -46,7 +46,7 @@ $$ 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: - ```text + ```python ┌───┐ q_0: ┤ X ├ └─┬─┘ @@ -100,20 +100,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.CCZGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.CCZGate.mdx index 4d12c537484..25ccbf627f4 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.CCZGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.CCZGate.mdx @@ -19,7 +19,7 @@ python_api_name: qiskit.circuit.library.CCZGate **Circuit symbol:** - ```text + ```python q_0: ─■─ │ q_1: ─■─ @@ -75,20 +75,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.CDKMRippleCarryAdder.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.CDKMRippleCarryAdder.mdx index 00aaa8a5300..64fc3017969 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.CDKMRippleCarryAdder.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.CDKMRippleCarryAdder.mdx @@ -15,7 +15,7 @@ python_api_name: qiskit.circuit.library.CDKMRippleCarryAdder 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: - ```text + ```python ┌──────┐ ┌──────┐ cin_0: ┤2 ├─────────────────────────────────────┤2 ├ │ │┌──────┐ ┌──────┐│ │ @@ -41,7 +41,7 @@ python_api_name: qiskit.circuit.library.CDKMRippleCarryAdder The circuit diagram for the fixed-point adder (`kind="fixed"`) on 3-qubit sized inputs is - ```text + ```python ┌──────┐┌──────┐ ┌──────┐┌──────┐ a_0: ┤0 ├┤2 ├────────────────┤2 ├┤0 ├ │ ││ │┌──────┐┌──────┐│ ││ │ @@ -91,10 +91,6 @@ python_api_name: qiskit.circuit.library.CDKMRippleCarryAdder Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -135,7 +131,7 @@ python_api_name: qiskit.circuit.library.CDKMRippleCarryAdder ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.CHGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.CHGate.mdx index 80923de9a38..4deca7e59ec 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.CHGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.CHGate.mdx @@ -19,7 +19,7 @@ python_api_name: qiskit.circuit.library.CHGate **Circuit symbol:** - ```text + ```python q_0: ──■── ┌─┴─┐ q_1: ┤ H ├ @@ -42,7 +42,7 @@ $$ 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: - ```text + ```python ┌───┐ q_0: ┤ H ├ └─┬─┘ @@ -90,20 +90,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.CPhaseGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.CPhaseGate.mdx index 967d1090a48..d3a0610f30a 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.CPhaseGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.CPhaseGate.mdx @@ -19,9 +19,9 @@ python_api_name: qiskit.circuit.library.CPhaseGate **Circuit symbol:** - ```text + ```python q_0: ─■── - │θ + │λ q_1: ─■── ``` @@ -34,7 +34,7 @@ I \otimes |0\rangle\langle 0| + P \otimes |1\rangle\langle 1| = 1 & 0 & 0 & 0 \\ 0 & 1 & 0 & 0 \\ 0 & 0 & 1 & 0 \\ -0 & 0 & 0 & e^{i\theta} +0 & 0 & 0 & e^{i\lambda} \end{pmatrix} $$ @@ -71,20 +71,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.CRXGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.CRXGate.mdx index cb96e2fdc20..8ab64ff6280 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.CRXGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.CRXGate.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.circuit.library.CRXGate **Circuit symbol:** - ```text + ```python q_0: ────■──── ┌───┴───┐ q_1: ┤ Rx(ϴ) ├ @@ -42,7 +42,7 @@ $$ 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: - ```text + ```python ┌───────┐ q_0: ┤ Rx(ϴ) ├ └───┬───┘ @@ -92,20 +92,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.CRYGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.CRYGate.mdx index c8a4abaf411..f600012e350 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.CRYGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.CRYGate.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.circuit.library.CRYGate **Circuit symbol:** - ```text + ```python q_0: ────■──── ┌───┴───┐ q_1: ┤ Ry(ϴ) ├ @@ -42,7 +42,7 @@ $$ 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: - ```text + ```python ┌───────┐ q_0: ┤ Ry(ϴ) ├ └───┬───┘ @@ -92,20 +92,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.CRZGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.CRZGate.mdx index a0893fa65d2..dc9793a8835 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.CRZGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.CRZGate.mdx @@ -19,44 +19,44 @@ python_api_name: qiskit.circuit.library.CRZGate **Circuit symbol:** - ```text + ```python q_0: ────■──── ┌───┴───┐ - q_1: ┤ Rz(θ) ├ + q_1: ┤ Rz(λ) ├ └───────┘ ``` **Matrix representation:** $$ -CRZ(\theta)\ q_0, q_1 = -I \otimes |0\rangle\langle 0| + RZ(\theta) \otimes |1\rangle\langle 1| = +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{\theta}{2}} +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: - ```text + ```python ┌───────┐ - q_0: ┤ Rz(θ) ├ + q_0: ┤ Rz(λ) ├ └───┬───┘ q_1: ────■──── ``` $$ -CRZ(\theta)\ q_1, q_0 = -|0\rangle\langle 0| \otimes I + |1\rangle\langle 1| \otimes RZ(\theta) = +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{\theta}{2}} & 0 \\ -0 & 0 & 0 & e^{i\frac{\theta}{2}} +0 & 0 & e^{-i\frac{\lambda}{2}} & 0 \\ +0 & 0 & 0 & e^{i\frac{\lambda}{2}} \end{pmatrix} $$ @@ -94,20 +94,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.CSGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.CSGate.mdx index 935288777c6..469bd7d4744 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.CSGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.CSGate.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.circuit.library.CSGate **Circuit symbol:** - ```text + ```python q_0: ──■── ┌─┴─┐ q_1: ┤ S ├ @@ -66,20 +66,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.CSXGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.CSXGate.mdx index 963841b9591..5e32be34e56 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.CSXGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.CSXGate.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.circuit.library.CSXGate **Circuit symbol:** - ```text + ```python q_0: ──■── ┌─┴──┐ q_1: ┤ √X ├ @@ -40,7 +40,7 @@ $$ 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: - ```text + ```python ┌────┐ q_0: ┤ √X ├ └─┬──┘ @@ -88,20 +88,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.CSdgGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.CSdgGate.mdx index 80f3c4ea161..3f99c4978e8 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.CSdgGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.CSdgGate.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.circuit.library.CSdgGate **Circuit symbol:** - ```text + ```python q_0: ───■─── ┌──┴──┐ q_1: ┤ Sdg ├ @@ -66,20 +66,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.CSwapGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.CSwapGate.mdx index 9fe36c13a3e..5046c9e9887 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.CSwapGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.CSwapGate.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.circuit.library.CSwapGate **Circuit symbol:** - ```text + ```python q_0: ─■─ │ q_1: ─X─ @@ -46,7 +46,7 @@ $$ 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: - ```text + ```python q_0: ─X─ │ q_1: ─X─ @@ -109,20 +109,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.CU1Gate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.CU1Gate.mdx index ab33f37d328..b8601c86075 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.CU1Gate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.CU1Gate.mdx @@ -30,22 +30,22 @@ $$ **Circuit symbol:** - ```text + ```python q_0: ─■── - │θ + │λ q_1: ─■── ``` **Matrix representation:** $$ -CU1(\theta) = +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\theta} +0 & 0 & 0 & e^{i\lambda} \end{pmatrix} $$ @@ -82,20 +82,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.CU3Gate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.CU3Gate.mdx index b7781fbfda4..b563d98dabb 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.CU3Gate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.CU3Gate.mdx @@ -31,7 +31,7 @@ $$ **Circuit symbol:** - ```text + ```python q_0: ──────■────── ┌─────┴─────┐ q_1: ┤ U3(ϴ,φ,λ) ├ @@ -57,7 +57,7 @@ $$ 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: - ```text + ```python ┌───────────┐ q_0: ┤ U3(ϴ,φ,λ) ├ └─────┬─────┘ @@ -108,20 +108,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.CUGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.CUGate.mdx index 1590d0235b3..cdd6f779256 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.CUGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.CUGate.mdx @@ -19,7 +19,7 @@ python_api_name: qiskit.circuit.library.CUGate **Circuit symbol:** - ```text + ```python q_0: ──────■────── ┌─────┴──────┐ q_1: ┤ U(ϴ,φ,λ,γ) ├ @@ -47,7 +47,7 @@ $$ 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: - ```text + ```python ┌────────────┐ q_0: ┤ U(ϴ,φ,λ,γ) ├ └─────┬──────┘ @@ -98,20 +98,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.CXGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.CXGate.mdx index 581a6b1a95e..d67e68f5794 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.CXGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.CXGate.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.circuit.library.CXGate **Circuit symbol:** - ```text + ```python q_0: ──■── ┌─┴─┐ q_1: ┤ X ├ @@ -40,7 +40,7 @@ $$ 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: - ```text + ```python ┌───┐ q_0: ┤ X ├ └─┬─┘ @@ -96,20 +96,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.CYGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.CYGate.mdx index 2e34759330b..bf53437c129 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.CYGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.CYGate.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.circuit.library.CYGate **Circuit symbol:** - ```text + ```python q_0: ──■── ┌─┴─┐ q_1: ┤ Y ├ @@ -40,7 +40,7 @@ $$ 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: - ```text + ```python ┌───┐ q_0: ┤ Y ├ └─┬─┘ @@ -88,20 +88,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.CZGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.CZGate.mdx index 6612cf80d00..29ed630a693 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.CZGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.CZGate.mdx @@ -19,7 +19,7 @@ python_api_name: qiskit.circuit.library.CZGate **Circuit symbol:** - ```text + ```python q_0: ─■─ │ q_1: ─■─ @@ -69,20 +69,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.DCXGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.DCXGate.mdx index 0c64e820c87..dda61f5ef67 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.DCXGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.DCXGate.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.circuit.library.DCXGate Can be applied to a [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") with the [`dcx()`](qiskit.circuit.QuantumCircuit#dcx "qiskit.circuit.QuantumCircuit.dcx") method. - ```text + ```python ┌───┐ q_0: ──■──┤ X ├ ┌─┴─┐└─┬─┘ @@ -66,20 +66,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.Diagonal.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.Diagonal.mdx index d294ae870ea..1112f7a4832 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.Diagonal.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.Diagonal.mdx @@ -15,7 +15,7 @@ python_api_name: qiskit.circuit.library.Diagonal Circuit symbol: - ```text + ```python ┌───────────┐ q_0: ┤0 ├ │ │ @@ -73,10 +73,6 @@ $$ Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.DiagonalGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.DiagonalGate.mdx index d0d0c08503e..f88c7d9f440 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.DiagonalGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.DiagonalGate.mdx @@ -44,20 +44,12 @@ python_api_name: qiskit.circuit.library.DiagonalGate The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.DraperQFTAdder.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.DraperQFTAdder.mdx index f19da6327d6..0f643aeb6c6 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.DraperQFTAdder.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.DraperQFTAdder.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.circuit.library.DraperQFTAdder As an example, a non-fixed\_point QFT adder circuit that performs addition on two 2-qubit sized registers is as follows: - ```text + ```python a_0: ─────────■──────■────────────────────────■──────────────── │ │ │ a_1: ─────────┼──────┼────────■──────■────────┼──────────────── @@ -62,10 +62,6 @@ python_api_name: qiskit.circuit.library.DraperQFTAdder Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.ECRGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.ECRGate.mdx index dc59e6fa7cf..69069e7c3a4 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.ECRGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.ECRGate.mdx @@ -19,7 +19,7 @@ python_api_name: qiskit.circuit.library.ECRGate **Circuit Symbol:** - ```text + ```python ┌─────────┐ ┌────────────┐┌────────┐┌─────────────┐ q_0: ┤0 ├ q_0: ┤0 ├┤ RX(pi) ├┤0 ├ │ ECR │ = │ RZX(pi/4) │└────────┘│ RZX(-pi/4) │ @@ -42,7 +42,7 @@ $$ 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$: - ```text + ```python ┌─────────┐ q_0: ┤1 ├ │ ECR │ @@ -90,20 +90,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.EfficientSU2.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.EfficientSU2.mdx index 75723150973..b24dfc3f7cc 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.EfficientSU2.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.EfficientSU2.mdx @@ -19,7 +19,7 @@ python_api_name: qiskit.circuit.library.EfficientSU2 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: - ```text + ```python ┌──────────┐┌──────────┐ ░ ░ ░ ┌───────────┐┌───────────┐ ┤ RY(θ[0]) ├┤ RZ(θ[3]) ├─░────────■───░─ ... ─░─┤ RY(θ[12]) ├┤ RZ(θ[15]) ├ ├──────────┤├──────────┤ ░ ┌─┴─┐ ░ ░ ├───────────┤├───────────┤ @@ -88,10 +88,6 @@ python_api_name: qiskit.circuit.library.EfficientSU2 Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.EvolvedOperatorAnsatz.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.EvolvedOperatorAnsatz.mdx index 80ea44ddfde..4d830feda4d 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.EvolvedOperatorAnsatz.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.EvolvedOperatorAnsatz.mdx @@ -38,10 +38,6 @@ python_api_name: qiskit.circuit.library.EvolvedOperatorAnsatz Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.ExactReciprocal.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.ExactReciprocal.mdx index f93538979b8..527071ca50a 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.ExactReciprocal.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.ExactReciprocal.mdx @@ -42,10 +42,6 @@ $$ Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.ExcitationPreserving.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.ExcitationPreserving.mdx index a2ddd314373..f1a11bae679 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.ExcitationPreserving.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.ExcitationPreserving.mdx @@ -107,10 +107,6 @@ $$ Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.FourierChecking.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.FourierChecking.mdx index 6d95a9c20cb..aa0847953e7 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.FourierChecking.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.FourierChecking.mdx @@ -56,10 +56,6 @@ python_api_name: qiskit.circuit.library.FourierChecking Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.FunctionalPauliRotations.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.FunctionalPauliRotations.mdx index ca3a544c551..e8a5c0cb19b 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.FunctionalPauliRotations.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.FunctionalPauliRotations.mdx @@ -47,10 +47,6 @@ python_api_name: qiskit.circuit.library.FunctionalPauliRotations Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.GMS.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.GMS.mdx index defbf6335a9..088a6bb5fa4 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.GMS.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.GMS.mdx @@ -15,7 +15,7 @@ python_api_name: qiskit.circuit.library.GMS **Circuit symbol:** - ```text + ```python ┌───────────┐ q_0: ┤0 ├ │ │ @@ -65,10 +65,6 @@ $$ Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.GR.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.GR.mdx index 97930467c0a..2958004a986 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.GR.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.GR.mdx @@ -15,7 +15,7 @@ python_api_name: qiskit.circuit.library.GR **Circuit symbol:** - ```text + ```python ┌──────────┐ q_0: ┤0 ├ │ │ @@ -59,10 +59,6 @@ $$ Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.GRX.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.GRX.mdx index cc84083d6bf..e2d1a7b44e2 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.GRX.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.GRX.mdx @@ -15,7 +15,7 @@ python_api_name: qiskit.circuit.library.GRX **Circuit symbol:** - ```text + ```python ┌──────────┐ q_0: ┤0 ├ │ │ @@ -58,10 +58,6 @@ $$ Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.GRY.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.GRY.mdx index 325d5af30ab..d4198a28ea3 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.GRY.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.GRY.mdx @@ -15,7 +15,7 @@ python_api_name: qiskit.circuit.library.GRY **Circuit symbol:** - ```text + ```python ┌──────────┐ q_0: ┤0 ├ │ │ @@ -58,10 +58,6 @@ $$ Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.GRZ.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.GRZ.mdx index e6c212af1f1..ccb48f0a768 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.GRZ.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.GRZ.mdx @@ -15,7 +15,7 @@ python_api_name: qiskit.circuit.library.GRZ **Circuit symbol:** - ```text + ```python ┌──────────┐ q_0: ┤0 ├ │ │ @@ -58,10 +58,6 @@ $$ Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.GlobalPhaseGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.GlobalPhaseGate.mdx index 64d7a024ec7..608291f2566 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.GlobalPhaseGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.GlobalPhaseGate.mdx @@ -58,20 +58,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.GraphState.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.GraphState.mdx index 022708da62c..80c4b610d6f 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.GraphState.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.GraphState.mdx @@ -63,10 +63,6 @@ $$ Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.GroverOperator.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.GroverOperator.mdx index edcc5ac6800..b1a04b2ea73 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.GroverOperator.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.GroverOperator.mdx @@ -46,7 +46,7 @@ $$ 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 - ```text + ```python Bitflip oracle Phaseflip oracle q_0: ──■── q_0: ────────────■──────────── ┌─┴─┐ ┌───┐┌───┐┌─┴─┐┌───┐┌───┐ @@ -174,10 +174,6 @@ $$ Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.HGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.HGate.mdx index 5996f1dae04..abc108b3827 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.HGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.HGate.mdx @@ -19,7 +19,7 @@ python_api_name: qiskit.circuit.library.HGate **Circuit symbol:** - ```text + ```python ┌───┐ q_0: ┤ H ├ └───┘ @@ -64,20 +64,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.HRSCumulativeMultiplier.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.HRSCumulativeMultiplier.mdx index 57c048ab74c..d27b95fd79b 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.HRSCumulativeMultiplier.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.HRSCumulativeMultiplier.mdx @@ -15,7 +15,7 @@ python_api_name: qiskit.circuit.library.HRSCumulativeMultiplier 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`): - ```text + ```python a_0: ────■───────────────────────── │ a_1: ────┼─────────■─────────────── @@ -75,10 +75,6 @@ python_api_name: qiskit.circuit.library.HRSCumulativeMultiplier Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.HamiltonianGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.HamiltonianGate.mdx index 08df2906b33..544c7fdca3c 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.HamiltonianGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.HamiltonianGate.mdx @@ -52,20 +52,12 @@ python_api_name: qiskit.circuit.library.HamiltonianGate The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.HiddenLinearFunction.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.HiddenLinearFunction.mdx index 9fd4d39501f..9a30bc2fc1f 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.HiddenLinearFunction.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.HiddenLinearFunction.mdx @@ -65,10 +65,6 @@ $$ Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.IGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.IGate.mdx index bd6dab32b78..d11d457a1ef 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.IGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.IGate.mdx @@ -28,7 +28,7 @@ $$ **Circuit symbol:** - ```text + ```python ┌───┐ q_0: ┤ I ├ └───┘ @@ -63,20 +63,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.IQP.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.IQP.mdx index 3f47916c699..39b159c42c1 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.IQP.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.IQP.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.circuit.library.IQP # IQP - + Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit") Instantaneous quantum polynomial (IQP) circuit. @@ -31,10 +31,6 @@ python_api_name: qiskit.circuit.library.IQP Create IQP circuit. - - The class `qiskit.circuit.library.iqp.IQP` is pending deprecation as of qiskit 1.3. It will be marked deprecated in a future release, and then removed no earlier than 3 months after the release date. Use the qiskit.circuit.library.iqp function instead. - - **Parameters** **interactions** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.13)") *| np.ndarray*) – input n-by-n symmetric matrix. @@ -57,10 +53,6 @@ python_api_name: qiskit.circuit.library.IQP Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -101,7 +93,7 @@ python_api_name: qiskit.circuit.library.IQP ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.Initialize.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.Initialize.mdx index 5d187c2ecec..8916f6477b1 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.Initialize.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.Initialize.mdx @@ -62,20 +62,12 @@ python_api_name: qiskit.circuit.library.Initialize The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.InnerProduct.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.InnerProduct.mdx index bdca917b55d..c46f6f58164 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.InnerProduct.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.InnerProduct.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.circuit.library.InnerProduct # InnerProduct - + 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$. @@ -22,7 +22,7 @@ $$ 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. - ```text + ```python q0_0: ─■────────── │ q0_1: ─┼──■─────── @@ -46,10 +46,6 @@ $$ Return a circuit to compute the inner product of 2 n-qubit registers. - - The class `qiskit.circuit.library.boolean_logic.inner_product.InnerProduct` is pending deprecation as of qiskit 1.3. It will be marked deprecated in a future release, and then removed no earlier than 3 months after the release date. Use qiskit.circuit.library.InnerProductGate instead. - - **Parameters** **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")) – width of top and bottom registers (half total circuit width) @@ -68,10 +64,6 @@ $$ Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -112,7 +104,7 @@ $$ ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.InnerProductGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.InnerProductGate.mdx deleted file mode 100644 index 6d287989b21..00000000000 --- a/docs/api/qiskit/dev/qiskit.circuit.library.InnerProductGate.mdx +++ /dev/null @@ -1,164 +0,0 @@ ---- -title: InnerProductGate -description: API reference for qiskit.circuit.library.InnerProductGate -in_page_toc_min_heading_level: 1 -python_api_type: class -python_api_name: qiskit.circuit.library.InnerProductGate ---- - -# InnerProductGate - - - Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate") - - 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:** - - ![../\_images/qiskit-circuit-library-InnerProductGate-1.png](/images/api/qiskit/dev/qiskit-circuit-library-InnerProductGate-1.png) - - **Parameters** - - **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")) – width of top and bottom registers (half total number of 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 behavioral perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.InnerProductGate.base_class "qiskit.circuit.library.InnerProductGate.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 parametrized 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 parametrized 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. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - - - - ### condition\_bits - - - Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - - - - ### decompositions - - - Get the decompositions of the instruction from the SessionEquivalenceLibrary. - - - ### definition - - - Return definition in terms of other basic gates. - - - ### duration - - - Get the duration. - - - The property `qiskit.circuit.instruction.Instruction.duration` is deprecated as of qiskit 1.3.0. It will be removed in Qiskit 2.0.0. - - - - ### 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 - - - The parameters of this `Instruction`. Ideally these will be gate angles. - - - ### unit - - - Get the time unit of duration. - - - The property `qiskit.circuit.instruction.Instruction.unit` is deprecated as of qiskit 1.3.0. It will be removed in Qiskit 2.0.0. - - - - diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.IntegerComparator.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.IntegerComparator.mdx index 6ecae27da17..33ecf0e21c4 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.IntegerComparator.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.IntegerComparator.mdx @@ -44,10 +44,6 @@ $$ Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -98,7 +94,7 @@ $$ ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.Isometry.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.Isometry.mdx index ff661d56a50..000ff56be7d 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.Isometry.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.Isometry.mdx @@ -55,20 +55,12 @@ python_api_name: qiskit.circuit.library.Isometry The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.LinearAmplitudeFunction.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.LinearAmplitudeFunction.mdx index aeb4b9b3752..dd095ab8faa 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.LinearAmplitudeFunction.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.LinearAmplitudeFunction.mdx @@ -79,10 +79,6 @@ $$ Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -123,7 +119,7 @@ $$ ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.LinearFunction.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.LinearFunction.mdx index a009d0fb8bf..20b21c0acce 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.LinearFunction.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.LinearFunction.mdx @@ -21,7 +21,7 @@ python_api_name: qiskit.circuit.library.LinearFunction **Example:** the circuit - ```text + ```python q_0: ──■── ┌─┴─┐ q_1: ┤ X ├ @@ -81,20 +81,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.LinearPauliRotations.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.LinearPauliRotations.mdx index a269616435f..17e531a8b99 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.LinearPauliRotations.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.LinearPauliRotations.mdx @@ -15,7 +15,7 @@ python_api_name: qiskit.circuit.library.LinearPauliRotations For a register of state qubits $|x\rangle$, a target qubit $|0\rangle$ and the basis `'Y'` this circuit acts as: - ```text + ```python q_0: ─────────────────────────■───────── ... ────────────────────── │ . @@ -70,10 +70,6 @@ $$ Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -114,7 +110,7 @@ $$ ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.MCMT.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.MCMT.mdx index c5a206c8f99..6d69f20c921 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.MCMT.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.MCMT.mdx @@ -15,7 +15,7 @@ python_api_name: qiskit.circuit.library.MCMT For example, the H gate controlled on 3 qubits and acting on 2 target qubit is represented as: - ```text + ```python ───■──── │ ───■──── @@ -61,10 +61,6 @@ python_api_name: qiskit.circuit.library.MCMT Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -105,7 +101,7 @@ python_api_name: qiskit.circuit.library.MCMT ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.MCMTGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.MCMTGate.mdx index 53403e2f7dc..fa2ca2a61fe 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.MCMTGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.MCMTGate.mdx @@ -65,20 +65,12 @@ python_api_name: qiskit.circuit.library.MCMTGate The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.MCMTVChain.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.MCMTVChain.mdx index 9779adc955b..db9554ec614 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.MCMTVChain.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.MCMTVChain.mdx @@ -72,10 +72,6 @@ python_api_name: qiskit.circuit.library.MCMTVChain Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -116,7 +112,7 @@ python_api_name: qiskit.circuit.library.MCMTVChain ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.MCPhaseGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.MCPhaseGate.mdx index 388eea71148..8aedb6b9148 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.MCPhaseGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.MCPhaseGate.mdx @@ -19,7 +19,7 @@ python_api_name: qiskit.circuit.library.MCPhaseGate **Circuit symbol:** - ```text + ```python q_0: ───■──── │ . @@ -63,20 +63,12 @@ python_api_name: qiskit.circuit.library.MCPhaseGate The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.MCXGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.MCXGate.mdx index acc2e5208aa..2a1c9dbe27c 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.MCXGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.MCXGate.mdx @@ -44,20 +44,12 @@ python_api_name: qiskit.circuit.library.MCXGate The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.MCXGrayCode.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.MCXGrayCode.mdx index c369f0ebb9e..04302a0681a 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.MCXGrayCode.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.MCXGrayCode.mdx @@ -46,20 +46,12 @@ python_api_name: qiskit.circuit.library.MCXGrayCode The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.MCXRecursive.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.MCXRecursive.mdx index 6f8a85fe7c5..e95deaa18f2 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.MCXRecursive.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.MCXRecursive.mdx @@ -53,20 +53,12 @@ python_api_name: qiskit.circuit.library.MCXRecursive The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.MCXVChain.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.MCXVChain.mdx index 0013cf7d72a..940c10001f5 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.MCXVChain.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.MCXVChain.mdx @@ -50,20 +50,12 @@ python_api_name: qiskit.circuit.library.MCXVChain The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### ctrl\_state diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.MSGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.MSGate.mdx index d1a71d1d7d8..b326ca82208 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.MSGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.MSGate.mdx @@ -48,20 +48,12 @@ python_api_name: qiskit.circuit.library.MSGate The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.NLocal.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.NLocal.mdx index a6a95e07161..f69c495b3cb 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.NLocal.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.NLocal.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.circuit.library.NLocal For instance, a rotation block on 2 qubits and an entanglement block on 4 qubits using `'linear'` entanglement yields the following circuit. - ```text + ```python ┌──────┐ ░ ┌──────┐ ░ ┌──────┐ ┤0 ├─░─┤0 ├──────────────── ... ─░─┤0 ├ │ Rot │ ░ │ │┌──────┐ ░ │ Rot │ @@ -74,10 +74,6 @@ python_api_name: qiskit.circuit.library.NLocal Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -164,7 +160,7 @@ python_api_name: qiskit.circuit.library.NLocal ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.OR.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.OR.mdx index 52689ec1264..a8a1e4ea800 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.OR.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.OR.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.circuit.library.OR # OR - + Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit") A circuit implementing the logical OR operation on a number of qubits. @@ -25,10 +25,6 @@ python_api_name: qiskit.circuit.library.OR Create a new logical OR circuit. - - The class `qiskit.circuit.library.boolean_logic.quantum_or.OR` is pending deprecation as of qiskit 1.3. It will be marked deprecated in a future release, and then removed no earlier than 3 months after the release date. Use qiskit.circuit.library.OrGate instead. - - **Parameters** * **num\_variable\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")) – The qubits of which the OR is computed. The result will be written into an additional result qubit. @@ -49,10 +45,6 @@ python_api_name: qiskit.circuit.library.OR Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -93,7 +85,7 @@ python_api_name: qiskit.circuit.library.OR ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.OrGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.OrGate.mdx deleted file mode 100644 index 302d55c3821..00000000000 --- a/docs/api/qiskit/dev/qiskit.circuit.library.OrGate.mdx +++ /dev/null @@ -1,164 +0,0 @@ ---- -title: OrGate -description: API reference for qiskit.circuit.library.OrGate -in_page_toc_min_heading_level: 1 -python_api_type: class -python_api_name: qiskit.circuit.library.OrGate ---- - -# OrGate - - - Bases: [`Gate`](qiskit.circuit.Gate "qiskit.circuit.gate.Gate") - - A gate representing 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 OrGate gate without special flags: - - ![../\_images/qiskit-circuit-library-OrGate-1.png](/images/api/qiskit/dev/qiskit-circuit-library-OrGate-1.png) - - 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]`. - - ![../\_images/qiskit-circuit-library-OrGate-2.png](/images/api/qiskit/dev/qiskit-circuit-library-OrGate-2.png) - - **Parameters** - - * **num\_variable\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")) – The qubits of which the AND 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.13)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")*] | None*) – A list of +1/0/-1 marking negations or omissions of 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 behavioral perspective. In particular, you should *not* override [`base_class`](#qiskit.circuit.library.OrGate.base_class "qiskit.circuit.library.OrGate.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 parametrized 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 parametrized 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. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - - - - ### condition\_bits - - - Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - - - - ### decompositions - - - Get the decompositions of the instruction from the SessionEquivalenceLibrary. - - - ### definition - - - Return definition in terms of other basic gates. - - - ### duration - - - Get the duration. - - - The property `qiskit.circuit.instruction.Instruction.duration` is deprecated as of qiskit 1.3.0. It will be removed in Qiskit 2.0.0. - - - - ### 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 - - - The parameters of this `Instruction`. Ideally these will be gate angles. - - - ### unit - - - Get the time unit of duration. - - - The property `qiskit.circuit.instruction.Instruction.unit` is deprecated as of qiskit 1.3.0. It will be removed in Qiskit 2.0.0. - - - - ## Methods - - ### inverse - - - Return inverted OR gate (itself). - - **Parameters** - - **annotated** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.13)")) – when set to `True`, this is typically used to return an [`AnnotatedOperation`](qiskit.circuit.AnnotatedOperation "qiskit.circuit.AnnotatedOperation") with an inverse modifier set instead of a concrete [`Gate`](qiskit.circuit.Gate "qiskit.circuit.Gate"). However, for this class this argument is ignored as this gate is self-inverse. - - **Returns** - - inverse gate (self-inverse). - - **Return type** - - [OrGate](#qiskit.circuit.library.OrGate "qiskit.circuit.library.OrGate") - - - diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.PauliEvolutionGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.PauliEvolutionGate.mdx index 8084f70fea1..67eb42b01eb 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.PauliEvolutionGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.PauliEvolutionGate.mdx @@ -96,20 +96,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.PauliFeatureMap.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.PauliFeatureMap.mdx index f562a7d9caf..21bfd4a74a1 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.PauliFeatureMap.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.PauliFeatureMap.mdx @@ -37,7 +37,7 @@ $$ which will produce blocks of the form - ```text + ```python ┌───┐┌─────────────┐┌──────────┐ ┌───────────┐ ┤ H ├┤ P(2.0*x[0]) ├┤ RX(pi/2) ├──■──────────────────────────────────────■──┤ RX(-pi/2) ├ ├───┤├─────────────┤├──────────┤┌─┴─┐┌────────────────────────────────┐┌─┴─┐├───────────┤ @@ -137,10 +137,6 @@ $$ Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -237,7 +233,7 @@ $$ ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.PauliGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.PauliGate.mdx index 05e04e46271..a3078f6712c 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.PauliGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.PauliGate.mdx @@ -55,20 +55,12 @@ python_api_name: qiskit.circuit.library.PauliGate The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.PauliTwoDesign.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.PauliTwoDesign.mdx index 404f4036030..d46ee204bdf 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.PauliTwoDesign.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.PauliTwoDesign.mdx @@ -19,7 +19,7 @@ python_api_name: qiskit.circuit.library.PauliTwoDesign For instance, the circuit could look like this (but note that choosing a different seed yields different Pauli rotations). - ```text + ```python ┌─────────┐┌──────────┐ ░ ┌──────────┐ ░ ┌──────────┐ q_0: ┤ RY(π/4) ├┤ RZ(θ[0]) ├─■─────░─┤ RY(θ[4]) ├─■─────░──┤ RZ(θ[8]) ├ ├─────────┤├──────────┤ │ ░ ├──────────┤ │ ░ ├──────────┤ @@ -72,10 +72,6 @@ python_api_name: qiskit.circuit.library.PauliTwoDesign Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -162,7 +158,7 @@ python_api_name: qiskit.circuit.library.PauliTwoDesign ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.Permutation.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.Permutation.mdx index d4d27e1ffdf..868c618c74c 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.Permutation.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.Permutation.mdx @@ -47,10 +47,6 @@ python_api_name: qiskit.circuit.library.Permutation Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -91,7 +87,7 @@ python_api_name: qiskit.circuit.library.Permutation ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.PermutationGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.PermutationGate.mdx index ec3e7c2aec2..655381ce9f4 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.PermutationGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.PermutationGate.mdx @@ -58,20 +58,12 @@ python_api_name: qiskit.circuit.library.PermutationGate The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.PhaseEstimation.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.PhaseEstimation.mdx index 53f7ec902c1..0a552891de7 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.PhaseEstimation.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.PhaseEstimation.mdx @@ -64,10 +64,6 @@ $$ Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -108,7 +104,7 @@ $$ ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.PhaseGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.PhaseGate.mdx index 22510c3c3ba..e4b5023a515 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.PhaseGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.PhaseGate.mdx @@ -19,41 +19,41 @@ python_api_name: qiskit.circuit.library.PhaseGate **Circuit symbol:** - ```text + ```python ┌──────┐ - q_0: ┤ P(θ) ├ + q_0: ┤ P(λ) ├ └──────┘ ``` **Matrix Representation:** $$ -P(\theta) = +P(\lambda) = \begin{pmatrix} 1 & 0 \\ -0 & e^{i\theta} +0 & e^{i\lambda} \end{pmatrix} $$ **Examples:** > $$ - > P(\theta = \pi) = Z + > P(\lambda = \pi) = Z > $$ > > $$ - > P(\theta = \pi/2) = S + > P(\lambda = \pi/2) = S > $$ > > $$ - > P(\theta = \pi/4) = T + > P(\lambda = \pi/4) = T > $$ `RZGate`: This gate is equivalent to RZ up to a phase factor. > $$ - > P(\theta) = e^{i{\theta}/2} RZ(\theta) + > P(\lambda) = e^{i{\lambda}/2} RZ(\lambda) > $$ Reference for virtual Z gate implementation: [1612.00858](https://arxiv.org/abs/1612.00858) @@ -88,20 +88,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.PhaseOracle.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.PhaseOracle.mdx index 9ffbde02921..655223e0868 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.PhaseOracle.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.PhaseOracle.mdx @@ -41,10 +41,6 @@ python_api_name: qiskit.circuit.library.PhaseOracle Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -85,7 +81,7 @@ python_api_name: qiskit.circuit.library.PhaseOracle ### instances - + ### layout @@ -302,7 +298,7 @@ python_api_name: qiskit.circuit.library.PhaseOracle The following is an example of a CNF expressed in the DIMACS format: - ```text + ```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 diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.PiecewiseChebyshev.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.PiecewiseChebyshev.mdx index c3836d52f98..734b684fd8d 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.PiecewiseChebyshev.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.PiecewiseChebyshev.mdx @@ -76,10 +76,6 @@ python_api_name: qiskit.circuit.library.PiecewiseChebyshev Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -140,7 +136,7 @@ python_api_name: qiskit.circuit.library.PiecewiseChebyshev ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.PiecewiseLinearPauliRotations.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.PiecewiseLinearPauliRotations.mdx index 2d4b7ca38e4..3a9234a8dd9 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.PiecewiseLinearPauliRotations.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.PiecewiseLinearPauliRotations.mdx @@ -69,10 +69,6 @@ $$ Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -123,7 +119,7 @@ $$ ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.PiecewisePolynomialPauliRotations.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.PiecewisePolynomialPauliRotations.mdx index 041b849a048..b3e37767a52 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.PiecewisePolynomialPauliRotations.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.PiecewisePolynomialPauliRotations.mdx @@ -117,10 +117,6 @@ $$ Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -181,7 +177,7 @@ $$ ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.PolynomialPauliRotations.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.PolynomialPauliRotations.mdx index 12e08aad1a8..e6df906639b 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.PolynomialPauliRotations.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.PolynomialPauliRotations.mdx @@ -69,10 +69,6 @@ $$ Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -141,7 +137,7 @@ $$ ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.QAOAAnsatz.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.QAOAAnsatz.mdx index 39ec39ef3c3..3af103c3618 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.QAOAAnsatz.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.QAOAAnsatz.mdx @@ -42,10 +42,6 @@ python_api_name: qiskit.circuit.library.QAOAAnsatz Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -156,7 +152,7 @@ python_api_name: qiskit.circuit.library.QAOAAnsatz ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.QFT.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.QFT.mdx index 08ddac3a3a6..74e8c1c09f5 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.QFT.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.QFT.mdx @@ -70,10 +70,6 @@ $$ Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -134,7 +130,7 @@ $$ ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.QFTGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.QFTGate.mdx index e2858e2f911..9dfe5b2ac6e 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.QFTGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.QFTGate.mdx @@ -50,20 +50,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.QuadraticForm.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.QuadraticForm.mdx index 56ff6744c75..255c0462554 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.QuadraticForm.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.QuadraticForm.mdx @@ -66,10 +66,6 @@ $$ Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -110,7 +106,7 @@ $$ ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.QuantumVolume.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.QuantumVolume.mdx index f7bf977b671..91beefcd76e 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.QuantumVolume.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.QuantumVolume.mdx @@ -53,10 +53,6 @@ python_api_name: qiskit.circuit.library.QuantumVolume Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -97,7 +93,7 @@ python_api_name: qiskit.circuit.library.QuantumVolume ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.RC3XGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.RC3XGate.mdx index 45cea367349..8981c2e1825 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.RC3XGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.RC3XGate.mdx @@ -48,20 +48,12 @@ python_api_name: qiskit.circuit.library.RC3XGate The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.RCCXGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.RCCXGate.mdx index 8de02d30b27..78aa0a29ec9 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.RCCXGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.RCCXGate.mdx @@ -48,20 +48,12 @@ python_api_name: qiskit.circuit.library.RCCXGate The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.RGQFTMultiplier.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.RGQFTMultiplier.mdx index 4db240504a3..21d7c5dedbf 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.RGQFTMultiplier.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.RGQFTMultiplier.mdx @@ -15,7 +15,7 @@ python_api_name: qiskit.circuit.library.RGQFTMultiplier 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: - ```text + ```python a_0: ────────────────────────────────────────■───────■──────■──────■──────────────── │ │ │ │ a_1: ─────────■───────■───────■───────■──────┼───────┼──────┼──────┼──────────────── @@ -54,10 +54,6 @@ python_api_name: qiskit.circuit.library.RGQFTMultiplier Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -98,7 +94,7 @@ python_api_name: qiskit.circuit.library.RGQFTMultiplier ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.RGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.RGate.mdx index 05f492140bf..eccbc17ae25 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.RGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.RGate.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.circuit.library.RGate **Circuit symbol:** - ```text + ```python ┌──────┐ q_0: ┤ R(ϴ) ├ └──────┘ @@ -64,20 +64,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.RVGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.RVGate.mdx index 9975742ca2a..8f3162410ed 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.RVGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.RVGate.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.circuit.library.RVGate **Circuit symbol:** - ```text + ```python ┌─────────────────┐ q_0: ┤ RV(v_x,v_y,v_z) ├ └─────────────────┘ @@ -76,20 +76,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.RXGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.RXGate.mdx index 1cc7527d069..b5d9ce2713b 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.RXGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.RXGate.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.circuit.library.RXGate **Circuit symbol:** - ```text + ```python ┌───────┐ q_0: ┤ Rx(ϴ) ├ └───────┘ @@ -64,20 +64,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.RXXGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.RXXGate.mdx index f68198847f2..234c462ac0e 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.RXXGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.RXXGate.mdx @@ -19,7 +19,7 @@ python_api_name: qiskit.circuit.library.RXXGate **Circuit Symbol:** - ```text + ```python ┌─────────┐ q_0: ┤1 ├ │ Rxx(ϴ) │ @@ -90,20 +90,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.RYGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.RYGate.mdx index a15181f5342..2ccd8bcee78 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.RYGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.RYGate.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.circuit.library.RYGate **Circuit symbol:** - ```text + ```python ┌───────┐ q_0: ┤ Ry(ϴ) ├ └───────┘ @@ -64,20 +64,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.RYYGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.RYYGate.mdx index 887b4df246e..3c19a2c0af3 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.RYYGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.RYYGate.mdx @@ -19,7 +19,7 @@ python_api_name: qiskit.circuit.library.RYYGate **Circuit Symbol:** - ```text + ```python ┌─────────┐ q_0: ┤1 ├ │ Ryy(ϴ) │ @@ -90,20 +90,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.RZGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.RZGate.mdx index 3233a7e3b68..70e71f05cac 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.RZGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.RZGate.mdx @@ -19,7 +19,7 @@ python_api_name: qiskit.circuit.library.RZGate **Circuit symbol:** - ```text + ```python ┌───────┐ q_0: ┤ Rz(λ) ├ └───────┘ @@ -74,20 +74,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.RZXGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.RZXGate.mdx index a86b01fe216..f95eb2aa01a 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.RZXGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.RZXGate.mdx @@ -21,7 +21,7 @@ python_api_name: qiskit.circuit.library.RZXGate **Circuit Symbol:** - ```text + ```python ┌─────────┐ q_0: ┤0 ├ │ Rzx(θ) │ @@ -46,7 +46,7 @@ $$ 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$: - ```text + ```python ┌─────────┐ q_0: ┤1 ├ │ Rzx(θ) │ @@ -130,20 +130,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.RZZGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.RZZGate.mdx index 74ff099229d..fd1e618c297 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.RZZGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.RZZGate.mdx @@ -19,7 +19,7 @@ python_api_name: qiskit.circuit.library.RZZGate **Circuit Symbol:** - ```text + ```python q_0: ───■──── │zz(θ) q_1: ───■──── @@ -102,20 +102,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.RealAmplitudes.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.RealAmplitudes.mdx index d2d9a19760b..b82c5013a6f 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.RealAmplitudes.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.RealAmplitudes.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.circuit.library.RealAmplitudes For example a `RealAmplitudes` circuit with 2 repetitions on 3 qubits with `'reverse_linear'` entanglement is - ```text + ```python ┌──────────┐ ░ ░ ┌──────────┐ ░ ░ ┌──────────┐ ┤ Ry(θ[0]) ├─░────────■───░─┤ Ry(θ[3]) ├─░────────■───░─┤ Ry(θ[6]) ├ ├──────────┤ ░ ┌─┴─┐ ░ ├──────────┤ ░ ┌─┴─┐ ░ ├──────────┤ @@ -126,10 +126,6 @@ python_api_name: qiskit.circuit.library.RealAmplitudes Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -216,7 +212,7 @@ python_api_name: qiskit.circuit.library.RealAmplitudes ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.SGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.SGate.mdx index d3ef1885b66..ff1754deaef 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.SGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.SGate.mdx @@ -30,7 +30,7 @@ $$ **Circuit symbol:** - ```text + ```python ┌───┐ q_0: ┤ S ├ └───┘ @@ -67,20 +67,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.SXGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.SXGate.mdx index a731bd2a693..e062bfdd237 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.SXGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.SXGate.mdx @@ -26,7 +26,7 @@ $$ **Circuit symbol:** - ```text + ```python ┌────┐ q_0: ┤ √X ├ └────┘ @@ -73,20 +73,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.SXdgGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.SXdgGate.mdx index 608bcd7eefb..8e86e7649e8 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.SXdgGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.SXdgGate.mdx @@ -63,20 +63,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.SdgGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.SdgGate.mdx index fb781e84c2a..cf1667ac178 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.SdgGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.SdgGate.mdx @@ -30,7 +30,7 @@ $$ **Circuit symbol:** - ```text + ```python ┌─────┐ q_0: ┤ Sdg ├ └─────┘ @@ -67,20 +67,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.StatePreparation.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.StatePreparation.mdx index b57f71fd83e..ed7983000e2 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.StatePreparation.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.StatePreparation.mdx @@ -69,20 +69,12 @@ python_api_name: qiskit.circuit.library.StatePreparation The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.SwapGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.SwapGate.mdx index 59b76cc600f..c6f676b2195 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.SwapGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.SwapGate.mdx @@ -19,7 +19,7 @@ python_api_name: qiskit.circuit.library.SwapGate **Circuit symbol:** - ```text + ```python q_0: ─X─ │ q_1: ─X─ @@ -72,20 +72,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.TGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.TGate.mdx index 7c4571500b9..9aac4f303a9 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.TGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.TGate.mdx @@ -30,7 +30,7 @@ $$ **Circuit symbol:** - ```text + ```python ┌───┐ q_0: ┤ T ├ └───┘ @@ -67,20 +67,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.TdgGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.TdgGate.mdx index 780a694c469..46a8f0e6414 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.TdgGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.TdgGate.mdx @@ -30,7 +30,7 @@ $$ **Circuit symbol:** - ```text + ```python ┌─────┐ q_0: ┤ Tdg ├ └─────┘ @@ -67,20 +67,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.TwoLocal.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.TwoLocal.mdx index 47b2faac20a..8a5aa3a2ce3 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.TwoLocal.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.TwoLocal.mdx @@ -138,10 +138,6 @@ python_api_name: qiskit.circuit.library.TwoLocal Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits @@ -228,7 +224,7 @@ python_api_name: qiskit.circuit.library.TwoLocal ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.U1Gate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.U1Gate.mdx index 79591b55a36..140f28d161c 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.U1Gate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.U1Gate.mdx @@ -19,7 +19,7 @@ python_api_name: qiskit.circuit.library.U1Gate This gate is deprecated. Instead, the following replacements should be used $$ -U1(\theta) = P(\theta)= U(0,0,\theta) +U1(\lambda) = P(\lambda)= U(0,0,\lambda) $$ ```python @@ -30,41 +30,41 @@ $$ **Circuit symbol:** - ```text + ```python ┌───────┐ - q_0: ┤ U1(θ) ├ + q_0: ┤ U1(λ) ├ └───────┘ ``` **Matrix Representation:** $$ -U1(\theta) = +U1(\lambda) = \begin{pmatrix} 1 & 0 \\ -0 & e^{i\theta} +0 & e^{i\lambda} \end{pmatrix} $$ **Examples:** > $$ - > U1(\theta = \pi) = Z + > U1(\lambda = \pi) = Z > $$ > > $$ - > U1(\theta = \pi/2) = S + > U1(\lambda = \pi/2) = S > $$ > > $$ - > U1(\theta = \pi/4) = T + > U1(\lambda = \pi/4) = T > $$ `RZGate`: This gate is equivalent to RZ up to a phase factor. > $$ - > U1(\theta) = e^{i{\theta}/2} RZ(\theta) + > 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. @@ -101,20 +101,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.U2Gate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.U2Gate.mdx index c34ce296707..bc05c76c1ef 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.U2Gate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.U2Gate.mdx @@ -30,7 +30,7 @@ $$ **Circuit symbol:** - ```text + ```python ┌─────────┐ q_0: ┤ U2(φ,λ) ├ └─────────┘ @@ -100,20 +100,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.U3Gate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.U3Gate.mdx index e0202d21499..12b45ddeb0e 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.U3Gate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.U3Gate.mdx @@ -28,7 +28,7 @@ $$ **Circuit symbol:** - ```text + ```python ┌───────────┐ q_0: ┤ U3(ϴ,φ,λ) ├ └───────────┘ @@ -95,20 +95,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.UCGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.UCGate.mdx index b3120c15243..f3774eeba19 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.UCGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.UCGate.mdx @@ -70,20 +70,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.UCPauliRotGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.UCPauliRotGate.mdx index 64ef83c9f23..ca07081a680 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.UCPauliRotGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.UCPauliRotGate.mdx @@ -47,20 +47,12 @@ python_api_name: qiskit.circuit.library.UCPauliRotGate The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.UCRXGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.UCRXGate.mdx index 5cfbae63c87..47e4b062f2c 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.UCRXGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.UCRXGate.mdx @@ -46,20 +46,12 @@ python_api_name: qiskit.circuit.library.UCRXGate The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.UCRYGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.UCRYGate.mdx index 3a73a88d7e4..42621bb75ff 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.UCRYGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.UCRYGate.mdx @@ -46,20 +46,12 @@ python_api_name: qiskit.circuit.library.UCRYGate The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.UCRZGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.UCRZGate.mdx index e7d3364f29f..fa57448dfeb 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.UCRZGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.UCRZGate.mdx @@ -46,20 +46,12 @@ python_api_name: qiskit.circuit.library.UCRZGate The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.UGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.UGate.mdx index 55762933b7a..c9943012d46 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.UGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.UGate.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.circuit.library.UGate **Circuit symbol:** - ```text + ```python ┌──────────┐ q_0: ┤ U(ϴ,φ,λ) ├ └──────────┘ @@ -78,20 +78,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.UnitaryGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.UnitaryGate.mdx index da8e342d73e..2954e3045cd 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.UnitaryGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.UnitaryGate.mdx @@ -71,20 +71,12 @@ python_api_name: qiskit.circuit.library.UnitaryGate The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.UnitaryOverlap.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.UnitaryOverlap.mdx index 4394d4387cb..5a1512b70fe 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.UnitaryOverlap.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.UnitaryOverlap.mdx @@ -73,10 +73,6 @@ $$ Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.VBERippleCarryAdder.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.VBERippleCarryAdder.mdx index b0fb3857a96..dceaf6a4ba7 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.VBERippleCarryAdder.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.VBERippleCarryAdder.mdx @@ -15,7 +15,7 @@ python_api_name: qiskit.circuit.library.VBERippleCarryAdder 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: - ```text + ```python ┌────────┐ ┌───────────┐┌──────┐ cin_0: ┤0 ├───────────────────────┤0 ├┤0 ├ │ │ │ ││ │ @@ -63,10 +63,6 @@ python_api_name: qiskit.circuit.library.VBERippleCarryAdder Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.WeightedAdder.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.WeightedAdder.mdx index 1e7f7c32060..0377ba33f65 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.WeightedAdder.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.WeightedAdder.mdx @@ -30,7 +30,7 @@ $$ 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 - ```text + ```python ┌────────┐ state_0: ┤0 ├ | state_0 * weights[0] │ │ | @@ -76,10 +76,6 @@ $$ Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.XGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.XGate.mdx index 85befa60e6a..9e47b67b585 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.XGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.XGate.mdx @@ -26,7 +26,7 @@ $$ **Circuit symbol:** - ```text + ```python ┌───┐ q_0: ┤ X ├ └───┘ @@ -82,20 +82,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.XOR.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.XOR.mdx index 4efa88e9b05..1387b2a2e0a 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.XOR.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.XOR.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.circuit.library.XOR # XOR - + Bases: [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit") An n\_qubit circuit for bitwise xor-ing the input with some integer `amount`. @@ -19,10 +19,6 @@ python_api_name: qiskit.circuit.library.XOR Return a circuit implementing bitwise xor. - - The class `qiskit.circuit.library.boolean_logic.quantum_xor.XOR` is pending deprecation as of qiskit 1.3. It will be marked deprecated in a future release, and then removed no earlier than 3 months after the release date. Instead, for xor-ing with a specified amount, use BitwiseXorGate,and for xor-ing with a random amount, use random\_bitwise\_xor. - - **Parameters** * **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")) – the width of circuit. @@ -51,10 +47,6 @@ python_api_name: qiskit.circuit.library.XOR Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.XXMinusYYGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.XXMinusYYGate.mdx index e1a0e653d4d..56a0d2914e6 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.XXMinusYYGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.XXMinusYYGate.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.circuit.library.XXMinusYYGate **Circuit Symbol:** - ```text + ```python ┌───────────────┐ q_0: ┤0 ├ │ (XX-YY)(θ,β) │ @@ -43,7 +43,7 @@ $$ 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. - ```text + ```python ┌───────────────┐ q_0: ┤1 ├ │ (XX-YY)(θ,β) │ @@ -100,20 +100,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.XXPlusYYGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.XXPlusYYGate.mdx index 3ad04098a22..111b78c3a8e 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.XXPlusYYGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.XXPlusYYGate.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.circuit.library.XXPlusYYGate **Circuit Symbol:** - ```text + ```python ┌───────────────┐ q_0: ┤0 ├ │ (XX+YY)(θ,β) │ @@ -43,7 +43,7 @@ $$ 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. - ```text + ```python ┌───────────────┐ q_0: ┤1 ├ │ (XX+YY)(θ,β) │ @@ -102,20 +102,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.YGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.YGate.mdx index 032ee81b556..462994b22a3 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.YGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.YGate.mdx @@ -26,7 +26,7 @@ $$ **Circuit symbol:** - ```text + ```python ┌───┐ q_0: ┤ Y ├ └───┘ @@ -82,20 +82,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.ZFeatureMap.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.ZFeatureMap.mdx index 6bfd7425849..5c9d282b343 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.ZFeatureMap.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.ZFeatureMap.mdx @@ -15,7 +15,7 @@ python_api_name: qiskit.circuit.library.ZFeatureMap On 3 qubits and with 2 repetitions the circuit is represented by: - ```text + ```python ┌───┐┌─────────────┐┌───┐┌─────────────┐ ┤ H ├┤ P(2.0*x[0]) ├┤ H ├┤ P(2.0*x[0]) ├ ├───┤├─────────────┤├───┤├─────────────┤ @@ -106,10 +106,6 @@ python_api_name: qiskit.circuit.library.ZFeatureMap Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.ZGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.ZGate.mdx index c9d471a59a0..e3469e3ef36 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.ZGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.ZGate.mdx @@ -26,7 +26,7 @@ $$ **Circuit symbol:** - ```text + ```python ┌───┐ q_0: ┤ Z ├ └───┘ @@ -82,20 +82,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.ZZFeatureMap.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.ZZFeatureMap.mdx index 2ba0f0890ae..b2a5cef52fc 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.ZZFeatureMap.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.ZZFeatureMap.mdx @@ -15,7 +15,7 @@ python_api_name: qiskit.circuit.library.ZZFeatureMap For 3 qubits and 1 repetition and linear entanglement the circuit is represented by: - ```text + ```python ┌───┐┌────────────────┐ ┤ H ├┤ P(2.0*φ(x[0])) ├──■───────────────────────────■─────────────────────────────────── ├───┤├────────────────┤┌─┴─┐┌─────────────────────┐┌─┴─┐ @@ -35,7 +35,7 @@ python_api_name: qiskit.circuit.library.ZZFeatureMap print(prep.decompose()) ``` - ```text + ```python ┌───┐┌─────────────┐ q_0: ┤ H ├┤ P(2.0*x[0]) ├──■──────────────────────────────────────■── ├───┤├─────────────┤┌─┴─┐┌────────────────────────────────┐┌─┴─┐ @@ -49,7 +49,7 @@ python_api_name: qiskit.circuit.library.ZZFeatureMap classifier.num_parameters ``` - ```text + ```python 27 ``` @@ -57,7 +57,7 @@ python_api_name: qiskit.circuit.library.ZZFeatureMap classifier.parameters # 'x' for the data preparation, 'θ' for the SU2 parameters ``` - ```text + ```python ParameterView([ ParameterVectorElement(x[0]), ParameterVectorElement(x[1]), ParameterVectorElement(x[2]), ParameterVectorElement(θ[0]), @@ -80,7 +80,7 @@ python_api_name: qiskit.circuit.library.ZZFeatureMap classifier.count_ops() ``` - ```text + ```python OrderedDict([('ZZFeatureMap', 1), ('EfficientSU2', 1)]) ``` @@ -127,10 +127,6 @@ python_api_name: qiskit.circuit.library.ZZFeatureMap Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.iSwapGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.iSwapGate.mdx index 0531206f96b..08d3c5dd205 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.iSwapGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.iSwapGate.mdx @@ -19,7 +19,7 @@ python_api_name: qiskit.circuit.library.iSwapGate **Circuit Symbol:** - ```text + ```python q_0: ─⨂─ │ q_1: ─⨂─ @@ -27,7 +27,7 @@ python_api_name: qiskit.circuit.library.iSwapGate **Reference Implementation:** - ```text + ```python ┌───┐┌───┐ ┌───┐ q_0: ┤ S ├┤ H ├──■──┤ X ├───── ├───┤└───┘┌─┴─┐└─┬─┘┌───┐ @@ -95,20 +95,12 @@ $$ The classical condition on the instruction. - - - The property `qiskit.circuit.instruction.Instruction.condition` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### condition\_bits Get Clbits in condition. - - - The property `qiskit.circuit.instruction.Instruction.condition_bits` is deprecated as of qiskit 1.3.0. It will be removed in 2.0.0. - ### decompositions diff --git a/docs/api/qiskit/dev/qiskit.dagcircuit.DAGCircuit.mdx b/docs/api/qiskit/dev/qiskit.dagcircuit.DAGCircuit.mdx index fc935067d60..e5ccf09daea 100644 --- a/docs/api/qiskit/dev/qiskit.dagcircuit.DAGCircuit.mdx +++ b/docs/api/qiskit/dev/qiskit.dagcircuit.DAGCircuit.mdx @@ -25,8 +25,6 @@ python_api_name: qiskit.dagcircuit.DAGCircuit **The custom pulse definition of a given gate is of the form** \{‘gate\_name’: \{(qubits, params): schedule}} - - DEPRECATED since Qiskit 1.3.0 and will be removed in Qiskit 2.0.0 ### clbits @@ -529,8 +527,6 @@ python_api_name: qiskit.dagcircuit.DAGCircuit 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. - - DEPRECATED since Qiskit 1.3.0 and will be removed in Qiskit 2.0.0 ### has\_var diff --git a/docs/api/qiskit/dev/qiskit.dagcircuit.DAGDependency.mdx b/docs/api/qiskit/dev/qiskit.dagcircuit.DAGDependency.mdx index 6e4b6a79279..1c10e44ab97 100644 --- a/docs/api/qiskit/dev/qiskit.dagcircuit.DAGDependency.mdx +++ b/docs/api/qiskit/dev/qiskit.dagcircuit.DAGDependency.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.dagcircuit.DAGDependency # DAGDependency - + Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.13)") Object to represent a quantum circuit as a Directed Acyclic Graph (DAG) via operation dependencies (i.e. lack of commutation). @@ -21,7 +21,7 @@ python_api_name: qiskit.dagcircuit.DAGDependency Bell circuit with no measurement. - ```text + ```python ┌───┐ qr_0: ┤ H ├──■── └───┘┌─┴─┐ @@ -45,10 +45,6 @@ python_api_name: qiskit.dagcircuit.DAGDependency Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}`. - - - The property `qiskit.dagcircuit.dagdependency.DAGDependency.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.dagcircuit.dagdependency.DAGDependency.calibrations` will have no alternative in Qiskit. - ### global\_phase @@ -61,19 +57,19 @@ python_api_name: qiskit.dagcircuit.DAGDependency ### add\_clbits - + Add individual clbit wires. ### add\_creg - + Add clbits in a classical register. ### add\_op\_node - + Add a DAGDepNode to the graph and update the edges. **Parameters** @@ -85,31 +81,31 @@ python_api_name: qiskit.dagcircuit.DAGDependency ### add\_qreg - + Add qubits in a quantum register. ### add\_qubits - + Add individual qubit wires. ### copy - + Function to copy a DAGDependency object. :returns: a copy of a DAGDependency object. :rtype: DAGDependency ### depth - + Return the circuit depth. :returns: the circuit depth :rtype: int ### direct\_predecessors - + Direct predecessors id of a given node as sorted list. **Parameters** @@ -127,7 +123,7 @@ python_api_name: qiskit.dagcircuit.DAGDependency ### direct\_successors - + Direct successors id of a given node as sorted list. **Parameters** @@ -145,7 +141,7 @@ python_api_name: qiskit.dagcircuit.DAGDependency ### draw - + 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. @@ -167,7 +163,7 @@ python_api_name: qiskit.dagcircuit.DAGDependency ### get\_all\_edges - + Enumeration of all edges. **Returns** @@ -181,7 +177,7 @@ python_api_name: qiskit.dagcircuit.DAGDependency ### get\_edges - + Edge enumeration between two nodes through method get\_all\_edge\_data. **Parameters** @@ -200,7 +196,7 @@ python_api_name: qiskit.dagcircuit.DAGDependency ### get\_in\_edges - + Enumeration of all incoming edges for a given node. **Parameters** @@ -218,7 +214,7 @@ python_api_name: qiskit.dagcircuit.DAGDependency ### get\_node - + **Parameters** **node\_id** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")) – label of considered node. @@ -234,7 +230,7 @@ python_api_name: qiskit.dagcircuit.DAGDependency ### get\_nodes - + **Returns** iterator over all the nodes. @@ -246,7 +242,7 @@ python_api_name: qiskit.dagcircuit.DAGDependency ### get\_out\_edges - + Enumeration of all outgoing edges for a given node. **Parameters** @@ -264,7 +260,7 @@ python_api_name: qiskit.dagcircuit.DAGDependency ### predecessors - + Predecessors id of a given node as sorted list. **Parameters** @@ -282,7 +278,7 @@ python_api_name: qiskit.dagcircuit.DAGDependency ### replace\_block\_with\_op - + 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. @@ -303,13 +299,13 @@ python_api_name: qiskit.dagcircuit.DAGDependency ### size - + Returns the number of gates in the circuit ### successors - + Successors id of a given node as sorted list. **Parameters** @@ -327,13 +323,13 @@ python_api_name: qiskit.dagcircuit.DAGDependency ### to\_retworkx - + Returns the DAGDependency in retworkx format. ### topological\_nodes - + Yield nodes in topological order. **Returns** diff --git a/docs/api/qiskit/dev/qiskit.providers.Backend.mdx b/docs/api/qiskit/dev/qiskit.providers.Backend.mdx index 368c13389ca..79acc6c0594 100644 --- a/docs/api/qiskit/dev/qiskit.providers.Backend.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.Backend.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.providers.Backend # Backend - + Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.13)") Base common type for all versioned Backend abstract classes. diff --git a/docs/api/qiskit/dev/qiskit.providers.BackendV1.mdx b/docs/api/qiskit/dev/qiskit.providers.BackendV1.mdx index ad32df17e7f..858845c859e 100644 --- a/docs/api/qiskit/dev/qiskit.providers.BackendV1.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.BackendV1.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.providers.BackendV1 # BackendV1 - + Bases: [`Backend`](qiskit.providers.Backend "qiskit.providers.backend.Backend"), [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.13)") Abstract class for Backends @@ -21,7 +21,7 @@ python_api_name: qiskit.providers.BackendV1 ### \_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. @@ -71,7 +71,7 @@ python_api_name: qiskit.providers.BackendV1 ### configuration - + Return the backend configuration. **Returns** @@ -85,7 +85,7 @@ python_api_name: qiskit.providers.BackendV1 ### name - + Return the backend name. **Returns** @@ -99,7 +99,7 @@ python_api_name: qiskit.providers.BackendV1 ### properties - + Return the backend properties. **Returns** @@ -113,7 +113,7 @@ python_api_name: qiskit.providers.BackendV1 ### provider - + Return the backend Provider. **Returns** @@ -127,7 +127,7 @@ python_api_name: qiskit.providers.BackendV1 ### run - + 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. @@ -148,7 +148,7 @@ python_api_name: qiskit.providers.BackendV1 ### set\_options - + 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. @@ -164,7 +164,7 @@ python_api_name: qiskit.providers.BackendV1 ### status - + Return the backend status. **Returns** diff --git a/docs/api/qiskit/dev/qiskit.providers.BackendV2.mdx b/docs/api/qiskit/dev/qiskit.providers.BackendV2.mdx index 7d062d39c44..ddf787e8eaa 100644 --- a/docs/api/qiskit/dev/qiskit.providers.BackendV2.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.BackendV2.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.providers.BackendV2 # BackendV2 - + Bases: [`Backend`](qiskit.providers.Backend "qiskit.providers.backend.Backend"), [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.13)") Abstract class for Backends @@ -25,7 +25,7 @@ python_api_name: qiskit.providers.BackendV2 ### \_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. @@ -100,10 +100,6 @@ python_api_name: qiskit.providers.BackendV2 Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target. - - - The property `qiskit.providers.backend.BackendV2.instruction_schedule_map` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.providers.backend.BackendV2.instruction_schedule_map` will have no alternative in Qiskit. - ### instructions @@ -218,15 +214,11 @@ python_api_name: qiskit.providers.BackendV2 ### acquire\_channel - + Return the acquisition channel for the given qubit. This is required to be implemented if the backend supports Pulse scheduling. - - The method `qiskit.providers.backend.BackendV2.acquire_channel()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.providers.backend.BackendV2.acquire_channel()` will have no alternative in Qiskit. - - **Returns** The Qubit measurement acquisition line. @@ -242,17 +234,13 @@ python_api_name: qiskit.providers.BackendV2 ### control\_channel - + 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. - - The method `qiskit.providers.backend.BackendV2.control_channel()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.providers.backend.BackendV2.control_channel()` will have no alternative in Qiskit. - - **Parameters** **qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.13)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`. @@ -272,15 +260,11 @@ python_api_name: qiskit.providers.BackendV2 ### drive\_channel - + Return the drive channel for the given qubit. This is required to be implemented if the backend supports Pulse scheduling. - - The method `qiskit.providers.backend.BackendV2.drive_channel()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.providers.backend.BackendV2.drive_channel()` will have no alternative in Qiskit. - - **Returns** The Qubit drive channel @@ -296,15 +280,11 @@ python_api_name: qiskit.providers.BackendV2 ### measure\_channel - + Return the measure stimulus channel for the given qubit. This is required to be implemented if the backend supports Pulse scheduling. - - The method `qiskit.providers.backend.BackendV2.measure_channel()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.providers.backend.BackendV2.measure_channel()` will have no alternative in Qiskit. - - **Returns** The Qubit measurement stimulus line @@ -320,7 +300,7 @@ python_api_name: qiskit.providers.BackendV2 ### qubit\_properties - + 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. @@ -344,7 +324,7 @@ python_api_name: qiskit.providers.BackendV2 ### run - + 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. @@ -365,7 +345,7 @@ python_api_name: qiskit.providers.BackendV2 ### set\_options - + 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. diff --git a/docs/api/qiskit/dev/qiskit.providers.BackendV2Converter.mdx b/docs/api/qiskit/dev/qiskit.providers.BackendV2Converter.mdx index 12b80c3d1b8..7c4bd57679b 100644 --- a/docs/api/qiskit/dev/qiskit.providers.BackendV2Converter.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.BackendV2Converter.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.providers.BackendV2Converter # BackendV2Converter - + 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. @@ -69,10 +69,6 @@ python_api_name: qiskit.providers.BackendV2Converter Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target. - - - The property `qiskit.providers.backend.BackendV2.instruction_schedule_map` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.providers.backend.BackendV2.instruction_schedule_map` will have no alternative in Qiskit. - ### instructions @@ -171,39 +167,93 @@ python_api_name: qiskit.providers.BackendV2Converter ### acquire\_channel - - - The method `qiskit.providers.backend_compat.BackendV2Converter.acquire_channel()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.providers.backend_compat.BackendV2Converter.acquire_channel()` will have no alternative in Qiskit. - + + 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.13)") – if the backend doesn’t support querying the measurement mapping ### control\_channel - - - The method `qiskit.providers.backend_compat.BackendV2Converter.control_channel()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.providers.backend_compat.BackendV2Converter.control_channel()` will have no alternative in Qiskit. - + + 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.13)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")*]*) – 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.13)") – if the backend doesn’t support querying the measurement mapping ### drive\_channel - - - The method `qiskit.providers.backend_compat.BackendV2Converter.drive_channel()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.providers.backend_compat.BackendV2Converter.drive_channel()` will have no alternative in Qiskit. - + + 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.13)") – if the backend doesn’t support querying the measurement mapping ### measure\_channel - - - The method `qiskit.providers.backend_compat.BackendV2Converter.measure_channel()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.providers.backend_compat.BackendV2Converter.measure_channel()` will have no alternative in Qiskit. - + + 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.13)") – if the backend doesn’t support querying the measurement mapping ### qubit\_properties - + 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. @@ -227,7 +277,7 @@ python_api_name: qiskit.providers.BackendV2Converter ### run - + 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. @@ -248,7 +298,7 @@ python_api_name: qiskit.providers.BackendV2Converter ### set\_options - + 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. diff --git a/docs/api/qiskit/dev/qiskit.providers.QubitProperties.mdx b/docs/api/qiskit/dev/qiskit.providers.QubitProperties.mdx index f356cd8a12f..ebd3e736d0f 100644 --- a/docs/api/qiskit/dev/qiskit.providers.QubitProperties.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.QubitProperties.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.providers.QubitProperties # QubitProperties - + Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.13)") A representation of the properties of a qubit on a backend. diff --git a/docs/api/qiskit/dev/qiskit.providers.basic_provider.BasicSimulator.mdx b/docs/api/qiskit/dev/qiskit.providers.basic_provider.BasicSimulator.mdx index 2817bf6f0e6..395f4739c96 100644 --- a/docs/api/qiskit/dev/qiskit.providers.basic_provider.BasicSimulator.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.basic_provider.BasicSimulator.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.providers.basic_provider.BasicSimulator # BasicSimulator - + Bases: [`BackendV2`](qiskit.providers.BackendV2 "qiskit.providers.backend.BackendV2") Python implementation of a basic (non-efficient) quantum simulator. @@ -71,10 +71,6 @@ python_api_name: qiskit.providers.basic_provider.BasicSimulator Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target. - - - The property `qiskit.providers.backend.BackendV2.instruction_schedule_map` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.providers.backend.BackendV2.instruction_schedule_map` will have no alternative in Qiskit. - ### instructions @@ -179,15 +175,11 @@ python_api_name: qiskit.providers.basic_provider.BasicSimulator ### acquire\_channel - + Return the acquisition channel for the given qubit. This is required to be implemented if the backend supports Pulse scheduling. - - The method `qiskit.providers.backend.BackendV2.acquire_channel()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.providers.backend.BackendV2.acquire_channel()` will have no alternative in Qiskit. - - **Returns** The Qubit measurement acquisition line. @@ -203,13 +195,9 @@ python_api_name: qiskit.providers.basic_provider.BasicSimulator ### configuration - + Return the simulator backend configuration. - - The method `qiskit.providers.basic_provider.basic_simulator.BasicSimulator.configuration()` is deprecated as of qiskit 1.3.0. It will be removed in Qiskit 2.0.0. The BackendConfiguration class is part of the deprecated BackendV1 workflow, and no longer necessary for BackendV2. The individual configuration elements can be retrieved directly from the backend or from the contained Target instance (backend.target)). - - **Returns** The configuration for the backend. @@ -221,17 +209,13 @@ python_api_name: qiskit.providers.basic_provider.BasicSimulator ### control\_channel - + 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. - - The method `qiskit.providers.backend.BackendV2.control_channel()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.providers.backend.BackendV2.control_channel()` will have no alternative in Qiskit. - - **Parameters** **qubits** ([*Iterable*](https://docs.python.org/3/library/typing.html#typing.Iterable "(in Python v3.13)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")*]*) – Tuple or list of qubits of the form `(control_qubit, target_qubit)`. @@ -251,15 +235,11 @@ python_api_name: qiskit.providers.basic_provider.BasicSimulator ### drive\_channel - + Return the drive channel for the given qubit. This is required to be implemented if the backend supports Pulse scheduling. - - The method `qiskit.providers.backend.BackendV2.drive_channel()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.providers.backend.BackendV2.drive_channel()` will have no alternative in Qiskit. - - **Returns** The Qubit drive channel @@ -275,15 +255,11 @@ python_api_name: qiskit.providers.basic_provider.BasicSimulator ### measure\_channel - + Return the measure stimulus channel for the given qubit. This is required to be implemented if the backend supports Pulse scheduling. - - The method `qiskit.providers.backend.BackendV2.measure_channel()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.providers.backend.BackendV2.measure_channel()` will have no alternative in Qiskit. - - **Returns** The Qubit measurement stimulus line @@ -299,7 +275,7 @@ python_api_name: qiskit.providers.basic_provider.BasicSimulator ### qubit\_properties - + 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. @@ -323,7 +299,7 @@ python_api_name: qiskit.providers.basic_provider.BasicSimulator ### run - + Run on the backend. **Parameters** @@ -358,7 +334,7 @@ python_api_name: qiskit.providers.basic_provider.BasicSimulator ### run\_experiment - + Run an experiment (circuit) and return a single experiment result. **Parameters** @@ -396,7 +372,7 @@ python_api_name: qiskit.providers.basic_provider.BasicSimulator ### set\_options - + 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. diff --git a/docs/api/qiskit/dev/qiskit.providers.convert_to_target.mdx b/docs/api/qiskit/dev/qiskit.providers.convert_to_target.mdx index 70127e66958..9604423e0bd 100644 --- a/docs/api/qiskit/dev/qiskit.providers.convert_to_target.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.convert_to_target.mdx @@ -10,20 +10,16 @@ python_api_name: qiskit.providers.convert_to_target # qiskit.providers.convert\_to\_target - + Decode transpiler target from backend data set. This function generates `` Target` `` instance from intermediate legacy objects such as [`BackendProperties`](qiskit.providers.models.BackendProperties "qiskit.providers.models.BackendProperties") and [`PulseDefaults`](qiskit.providers.models.PulseDefaults "qiskit.providers.models.PulseDefaults"). These objects are usually components of the legacy [`BackendV1`](qiskit.providers.BackendV1 "qiskit.providers.BackendV1") model. - - `qiskit.providers.backend_compat.convert_to_target()`’s argument `defaults` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and this argument uses a dependency on the package. - - **Parameters** * **configuration** ([*BackendConfiguration*](qiskit.providers.models.BackendConfiguration "qiskit.providers.models.backendconfiguration.BackendConfiguration")) – Backend configuration as `BackendConfiguration` - * **properties** ([*BackendProperties*](qiskit.providers.models.BackendProperties "qiskit.providers.models.backendproperties.BackendProperties")) – Backend property dictionary or `BackendProperties` - * **defaults** ([*PulseDefaults*](qiskit.providers.models.PulseDefaults "qiskit.providers.models.pulsedefaults.PulseDefaults")) – DEPRECATED. Backend pulse defaults dictionary or `PulseDefaults` + * **properties** ([*BackendProperties*](qiskit.providers.models.BackendProperties "qiskit.providers.models.backendproperties.BackendProperties") *| None*) – Backend property dictionary or `BackendProperties` + * **defaults** ([*PulseDefaults*](qiskit.providers.models.PulseDefaults "qiskit.providers.models.pulsedefaults.PulseDefaults") *| None*) – Backend pulse defaults dictionary or `PulseDefaults` * **custom\_name\_mapping** ([*Dict*](https://docs.python.org/3/library/typing.html#typing.Dict "(in Python v3.13)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.13)")*,* [*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.13)")*] | None*) – A name mapping must be supplied for the operation not included in Qiskit Standard Gate name mapping, otherwise the operation will be dropped in the resulting `Target` object. * **add\_delay** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.13)")) – If True, adds delay to the instruction set. * **filter\_faulty** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.13)")) – If True, this filters the non-operational qubits. diff --git a/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake127QPulseV1.mdx b/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake127QPulseV1.mdx index 4e2a8f9d9c9..50e0153d0a6 100644 --- a/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake127QPulseV1.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake127QPulseV1.mdx @@ -72,7 +72,7 @@ python_api_name: qiskit.providers.fake_provider.Fake127QPulseV1 ### configuration - + Return the backend configuration. **Returns** @@ -86,13 +86,13 @@ python_api_name: qiskit.providers.fake_provider.Fake127QPulseV1 ### defaults - + Returns a snapshot of device defaults ### name - + Return the backend name. **Returns** @@ -112,7 +112,7 @@ python_api_name: qiskit.providers.fake_provider.Fake127QPulseV1 ### provider - + Return the backend Provider. **Returns** @@ -132,7 +132,7 @@ python_api_name: qiskit.providers.fake_provider.Fake127QPulseV1 ### set\_options - + 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. @@ -148,7 +148,7 @@ python_api_name: qiskit.providers.fake_provider.Fake127QPulseV1 ### status - + Return the backend status. **Returns** diff --git a/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake1Q.mdx b/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake1Q.mdx index cac547e0c8d..d29e426d131 100644 --- a/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake1Q.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake1Q.mdx @@ -33,7 +33,7 @@ python_api_name: qiskit.providers.fake_provider.Fake1Q ### configuration - + Return the backend configuration. **Returns** @@ -47,7 +47,7 @@ python_api_name: qiskit.providers.fake_provider.Fake1Q ### name - + Return the backend name. **Returns** @@ -67,7 +67,7 @@ python_api_name: qiskit.providers.fake_provider.Fake1Q ### provider - + Return the backend Provider. **Returns** @@ -87,7 +87,7 @@ python_api_name: qiskit.providers.fake_provider.Fake1Q ### set\_options - + 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. @@ -103,7 +103,7 @@ python_api_name: qiskit.providers.fake_provider.Fake1Q ### status - + Return the backend status. **Returns** diff --git a/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake20QV1.mdx b/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake20QV1.mdx index 963d245632e..bdf62a29a53 100644 --- a/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake20QV1.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake20QV1.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.providers.fake_provider.Fake20QV1 * coupling\_map: - > ```text + > ```python > 00 ↔ 01 ↔ 02 ↔ 03 ↔ 04 > ↕ ↕ > 05 ↔ 06 ↔ 07 ↔ 08 ↔ 09 @@ -74,7 +74,7 @@ python_api_name: qiskit.providers.fake_provider.Fake20QV1 ### configuration - + Return the backend configuration. **Returns** @@ -88,7 +88,7 @@ python_api_name: qiskit.providers.fake_provider.Fake20QV1 ### name - + Return the backend name. **Returns** @@ -108,7 +108,7 @@ python_api_name: qiskit.providers.fake_provider.Fake20QV1 ### provider - + Return the backend Provider. **Returns** @@ -128,7 +128,7 @@ python_api_name: qiskit.providers.fake_provider.Fake20QV1 ### set\_options - + 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. @@ -144,7 +144,7 @@ python_api_name: qiskit.providers.fake_provider.Fake20QV1 ### status - + Return the backend status. **Returns** diff --git a/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake27QPulseV1.mdx b/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake27QPulseV1.mdx index 5909fbc1f57..d12a1da64a0 100644 --- a/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake27QPulseV1.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake27QPulseV1.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.providers.fake_provider.Fake27QPulseV1 * coupling\_map: - > ```text + > ```python > 06 17 > ↕ ↕ > 00 ↔ 01 ↔ 04 ↔ 07 ↔ 10 ↔ 12 ↔ 15 ↔ 18 ↔ 20 ↔ 23 @@ -84,7 +84,7 @@ python_api_name: qiskit.providers.fake_provider.Fake27QPulseV1 ### configuration - + Return the backend configuration. **Returns** @@ -98,13 +98,13 @@ python_api_name: qiskit.providers.fake_provider.Fake27QPulseV1 ### defaults - + Returns a snapshot of device defaults ### name - + Return the backend name. **Returns** @@ -124,7 +124,7 @@ python_api_name: qiskit.providers.fake_provider.Fake27QPulseV1 ### provider - + Return the backend Provider. **Returns** @@ -144,7 +144,7 @@ python_api_name: qiskit.providers.fake_provider.Fake27QPulseV1 ### set\_options - + 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. @@ -160,7 +160,7 @@ python_api_name: qiskit.providers.fake_provider.Fake27QPulseV1 ### status - + Return the backend status. **Returns** diff --git a/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake5QV1.mdx b/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake5QV1.mdx index 1d129c9305c..feb233d8725 100644 --- a/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake5QV1.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake5QV1.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.providers.fake_provider.Fake5QV1 * coupling\_map: - > ```text + > ```python > 1 > / | > 0 - 2 - 3 @@ -72,7 +72,7 @@ python_api_name: qiskit.providers.fake_provider.Fake5QV1 ### configuration - + Return the backend configuration. **Returns** @@ -86,7 +86,7 @@ python_api_name: qiskit.providers.fake_provider.Fake5QV1 ### name - + Return the backend name. **Returns** @@ -106,7 +106,7 @@ python_api_name: qiskit.providers.fake_provider.Fake5QV1 ### provider - + Return the backend Provider. **Returns** @@ -126,7 +126,7 @@ python_api_name: qiskit.providers.fake_provider.Fake5QV1 ### set\_options - + 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. @@ -142,7 +142,7 @@ python_api_name: qiskit.providers.fake_provider.Fake5QV1 ### status - + Return the backend status. **Returns** diff --git a/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake7QPulseV1.mdx b/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake7QPulseV1.mdx index d377ff7d1ed..a1f0e157ae8 100644 --- a/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake7QPulseV1.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake7QPulseV1.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.providers.fake_provider.Fake7QPulseV1 * coupling\_map: - > ```text + > ```python > 0 ↔ 1 ↔ 3 ↔ 5 ↔ 6 > ↕ ↕ > 2 4 @@ -78,7 +78,7 @@ python_api_name: qiskit.providers.fake_provider.Fake7QPulseV1 ### configuration - + Return the backend configuration. **Returns** @@ -92,13 +92,13 @@ python_api_name: qiskit.providers.fake_provider.Fake7QPulseV1 ### defaults - + Returns a snapshot of device defaults ### name - + Return the backend name. **Returns** @@ -118,7 +118,7 @@ python_api_name: qiskit.providers.fake_provider.Fake7QPulseV1 ### provider - + Return the backend Provider. **Returns** @@ -138,7 +138,7 @@ python_api_name: qiskit.providers.fake_provider.Fake7QPulseV1 ### set\_options - + 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. @@ -154,7 +154,7 @@ python_api_name: qiskit.providers.fake_provider.Fake7QPulseV1 ### status - + Return the backend status. **Returns** diff --git a/docs/api/qiskit/dev/qiskit.providers.fake_provider.FakeOpenPulse2Q.mdx b/docs/api/qiskit/dev/qiskit.providers.fake_provider.FakeOpenPulse2Q.mdx index 5789717caf0..fa8ced8d13d 100644 --- a/docs/api/qiskit/dev/qiskit.providers.fake_provider.FakeOpenPulse2Q.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.fake_provider.FakeOpenPulse2Q.mdx @@ -42,7 +42,7 @@ python_api_name: qiskit.providers.fake_provider.FakeOpenPulse2Q ### configuration - + Return the backend configuration. **Returns** @@ -62,7 +62,7 @@ python_api_name: qiskit.providers.fake_provider.FakeOpenPulse2Q ### name - + Return the backend name. **Returns** @@ -82,7 +82,7 @@ python_api_name: qiskit.providers.fake_provider.FakeOpenPulse2Q ### provider - + Return the backend Provider. **Returns** @@ -102,7 +102,7 @@ python_api_name: qiskit.providers.fake_provider.FakeOpenPulse2Q ### set\_options - + 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. @@ -118,7 +118,7 @@ python_api_name: qiskit.providers.fake_provider.FakeOpenPulse2Q ### status - + Return the backend status. **Returns** diff --git a/docs/api/qiskit/dev/qiskit.providers.fake_provider.FakeOpenPulse3Q.mdx b/docs/api/qiskit/dev/qiskit.providers.fake_provider.FakeOpenPulse3Q.mdx index 70142a55d59..66b6db49e5f 100644 --- a/docs/api/qiskit/dev/qiskit.providers.fake_provider.FakeOpenPulse3Q.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.fake_provider.FakeOpenPulse3Q.mdx @@ -42,7 +42,7 @@ python_api_name: qiskit.providers.fake_provider.FakeOpenPulse3Q ### configuration - + Return the backend configuration. **Returns** @@ -60,7 +60,7 @@ python_api_name: qiskit.providers.fake_provider.FakeOpenPulse3Q ### name - + Return the backend name. **Returns** @@ -80,7 +80,7 @@ python_api_name: qiskit.providers.fake_provider.FakeOpenPulse3Q ### provider - + Return the backend Provider. **Returns** @@ -100,7 +100,7 @@ python_api_name: qiskit.providers.fake_provider.FakeOpenPulse3Q ### set\_options - + 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. @@ -116,7 +116,7 @@ python_api_name: qiskit.providers.fake_provider.FakeOpenPulse3Q ### status - + Return the backend status. **Returns** diff --git a/docs/api/qiskit/dev/qiskit.providers.fake_provider.GenericBackendV2.mdx b/docs/api/qiskit/dev/qiskit.providers.fake_provider.GenericBackendV2.mdx index ed88013d88b..08c70cb8736 100644 --- a/docs/api/qiskit/dev/qiskit.providers.fake_provider.GenericBackendV2.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.fake_provider.GenericBackendV2.mdx @@ -8,19 +8,11 @@ python_api_name: qiskit.providers.fake_provider.GenericBackendV2 # GenericBackendV2 - + 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. - - `qiskit.providers.fake_provider.generic_backend_v2.GenericBackendV2.__init__()`’s argument `calibrate_instructions` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and this argument uses a dependency on the package. - - - - `qiskit.providers.fake_provider.generic_backend_v2.GenericBackendV2.__init__()`’s argument `pulse_channels` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and this argument uses a dependency on the package. - - **Parameters** * **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")) – 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. @@ -40,7 +32,7 @@ python_api_name: qiskit.providers.fake_provider.GenericBackendV2 * **calibrate\_instructions** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.13)") *|*[*InstructionScheduleMap*](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") *| None*) – - DEPRECATED. Instruction calibration settings, this argument supports both boolean and [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") as input types, and is `None` by default: + 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. @@ -60,7 +52,7 @@ python_api_name: qiskit.providers.fake_provider.GenericBackendV2 * **seed** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)") *| None*) – Optional seed for generation of default values. - * **pulse\_channels** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.13)")) – DEPRECATED. If true, sets default pulse channel information on the backend. + * **pulse\_channels** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.13)")) – If true, sets default pulse channel information on the backend. * **noise\_info** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.13)")) – If true, associates gates and qubits with default noise information. @@ -100,10 +92,6 @@ python_api_name: qiskit.providers.fake_provider.GenericBackendV2 Return the [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions defined in this backend’s target. - - - The property `qiskit.providers.backend.BackendV2.instruction_schedule_map` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.providers.backend.BackendV2.instruction_schedule_map` will have no alternative in Qiskit. - ### instructions @@ -196,39 +184,93 @@ python_api_name: qiskit.providers.fake_provider.GenericBackendV2 ### acquire\_channel - - - The method `qiskit.providers.fake_provider.generic_backend_v2.GenericBackendV2.acquire_channel()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.providers.fake_provider.generic_backend_v2.GenericBackendV2.acquire_channel()` will have no alternative in Qiskit. - + + 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.13)") – if the backend doesn’t support querying the measurement mapping ### control\_channel - - - The method `qiskit.providers.fake_provider.generic_backend_v2.GenericBackendV2.control_channel()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.providers.fake_provider.generic_backend_v2.GenericBackendV2.control_channel()` will have no alternative in Qiskit. - + + 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.13)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")*]*) – 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.13)") – if the backend doesn’t support querying the measurement mapping ### drive\_channel - - - The method `qiskit.providers.fake_provider.generic_backend_v2.GenericBackendV2.drive_channel()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.providers.fake_provider.generic_backend_v2.GenericBackendV2.drive_channel()` will have no alternative in Qiskit. - + + 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.13)") – if the backend doesn’t support querying the measurement mapping ### measure\_channel - - - The method `qiskit.providers.fake_provider.generic_backend_v2.GenericBackendV2.measure_channel()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.providers.fake_provider.generic_backend_v2.GenericBackendV2.measure_channel()` will have no alternative in Qiskit. - + + 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.13)") – if the backend doesn’t support querying the measurement mapping ### qubit\_properties - + 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. @@ -252,7 +294,7 @@ python_api_name: qiskit.providers.fake_provider.GenericBackendV2 ### run - + 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. @@ -281,7 +323,7 @@ python_api_name: qiskit.providers.fake_provider.GenericBackendV2 ### set\_options - + 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. diff --git a/docs/api/qiskit/dev/qiskit.providers.models.Command.mdx b/docs/api/qiskit/dev/qiskit.providers.models.Command.mdx index 69e43c3070d..cf5bca5dc19 100644 --- a/docs/api/qiskit/dev/qiskit.providers.models.Command.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.models.Command.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.providers.models.Command # Command - + Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.13)") Class representing a Command. @@ -32,7 +32,7 @@ python_api_name: qiskit.providers.models.Command ### from\_dict - + Create a new Command object from a dictionary. **Parameters** @@ -50,7 +50,7 @@ python_api_name: qiskit.providers.models.Command ### to\_dict - + Return a dictionary format representation of the Command. **Returns** diff --git a/docs/api/qiskit/dev/qiskit.providers.models.PulseDefaults.mdx b/docs/api/qiskit/dev/qiskit.providers.models.PulseDefaults.mdx index 8d5f29c851b..97065449e76 100644 --- a/docs/api/qiskit/dev/qiskit.providers.models.PulseDefaults.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.models.PulseDefaults.mdx @@ -8,15 +8,11 @@ python_api_name: qiskit.providers.models.PulseDefaults # PulseDefaults - + Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.13)") 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. - - The class `qiskit.providers.models.pulsedefaults.PulseDefaults` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.providers.models.pulsedefaults.PulseDefaults` will have no alternative in Qiskit. - - 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 @@ -37,7 +33,7 @@ python_api_name: qiskit.providers.models.PulseDefaults ### from\_dict - + Create a new PulseDefaults object from a dictionary. **Parameters** @@ -55,7 +51,7 @@ python_api_name: qiskit.providers.models.PulseDefaults ### 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/dev/qiskit.pulse.InstructionScheduleMap.mdx b/docs/api/qiskit/dev/qiskit.pulse.InstructionScheduleMap.mdx index 6651e64155a..607aaf92e05 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.InstructionScheduleMap.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.InstructionScheduleMap.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.pulse.InstructionScheduleMap # InstructionScheduleMap - + Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.13)") 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: @@ -23,10 +23,6 @@ python_api_name: qiskit.pulse.InstructionScheduleMap Initialize a circuit instruction to schedule mapper instance. - - The class `qiskit.pulse.instruction_schedule_map.InstructionScheduleMap` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - ## Attributes ### instructions @@ -45,7 +41,7 @@ python_api_name: qiskit.pulse.InstructionScheduleMap ### add - + Add a new known instruction for the given qubits and its mapping to a pulse schedule. **Parameters** @@ -62,7 +58,7 @@ python_api_name: qiskit.pulse.InstructionScheduleMap ### assert\_has - + Error if the given instruction is not defined. **Parameters** @@ -77,7 +73,7 @@ python_api_name: qiskit.pulse.InstructionScheduleMap ### get - + 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. @@ -100,7 +96,7 @@ python_api_name: qiskit.pulse.InstructionScheduleMap ### get\_parameters - + Return the list of parameters taken by the given instruction on the given qubits. **Parameters** @@ -119,7 +115,7 @@ python_api_name: qiskit.pulse.InstructionScheduleMap ### has - + Is the instruction defined for the given qubits? **Parameters** @@ -138,7 +134,7 @@ python_api_name: qiskit.pulse.InstructionScheduleMap ### has\_custom\_gate - + Return `True` if the map has user provided instruction. **Return type** @@ -148,7 +144,7 @@ python_api_name: qiskit.pulse.InstructionScheduleMap ### pop - + Remove and return the defined schedule for the given instruction on the given qubits. **Parameters** @@ -169,7 +165,7 @@ python_api_name: qiskit.pulse.InstructionScheduleMap ### qubit\_instructions - + Return a list of the instruction names that are defined by the backend for the given qubit or qubits. **Parameters** @@ -189,7 +185,7 @@ python_api_name: qiskit.pulse.InstructionScheduleMap ### qubits\_with\_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** @@ -211,7 +207,7 @@ python_api_name: qiskit.pulse.InstructionScheduleMap ### remove - + Remove the given instruction from the listing of instructions defined in self. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.pulse.Schedule.mdx b/docs/api/qiskit/dev/qiskit.pulse.Schedule.mdx index bde30c76cb2..b268ab07ce4 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.Schedule.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.Schedule.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.pulse.Schedule # Schedule - + Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.13)") A quantum program *schedule* with exact time constraints for its instructions, operating over all input signal *channels* and supporting special syntaxes for building. @@ -55,10 +55,6 @@ python_api_name: qiskit.pulse.Schedule Create an empty schedule. - - The class `qiskit.pulse.schedule.Schedule` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **\*schedules** (*'ScheduleComponent' |* [*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.13)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")*, 'ScheduleComponent']*) – Child Schedules of this parent Schedule. May either be passed as the list of schedules, or a list of `(start_time, schedule)` pairs. @@ -153,7 +149,7 @@ python_api_name: qiskit.pulse.Schedule ### append - + Return a new schedule with `schedule` inserted at the maximum time over all channels shared between `self` and `schedule`. $$ @@ -174,7 +170,7 @@ $$ ### assign\_parameters - + Assign the parameters in this schedule according to the input. **Parameters** @@ -195,7 +191,7 @@ $$ ### ch\_duration - + Return the time of the end of the last instruction over the supplied channels. **Parameters** @@ -209,7 +205,7 @@ $$ ### ch\_start\_time - + Return the time of the start of the first instruction over the supplied channels. **Parameters** @@ -223,7 +219,7 @@ $$ ### ch\_stop\_time - + Return maximum start time over supplied channels. **Parameters** @@ -237,7 +233,7 @@ $$ ### draw - + Plot the schedule. **Parameters** @@ -283,7 +279,7 @@ $$ ### exclude - + Return a `Schedule` with only the instructions from this Schedule *failing* at least one of the provided filters. This method is the complement of [`filter()`](#qiskit.pulse.Schedule.filter "qiskit.pulse.Schedule.filter"), so that: ```python @@ -306,7 +302,7 @@ $$ ### filter - + 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. @@ -327,7 +323,7 @@ $$ ### get\_parameters - + 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. @@ -347,7 +343,7 @@ $$ ### initialize\_from - + Create new schedule object with metadata of another schedule object. **Parameters** @@ -370,7 +366,7 @@ $$ ### insert - + Return a new schedule with `schedule` inserted into `self` at `start_time`. **Parameters** @@ -387,7 +383,7 @@ $$ ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -397,7 +393,7 @@ $$ ### replace - + Return a `Schedule` with the `old` instruction replaced with a `new` instruction. The replacement matching is based on an instruction equality check. @@ -454,7 +450,7 @@ $$ ### shift - + Return a schedule shifted forward by `time`. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.pulse.ScheduleBlock.mdx b/docs/api/qiskit/dev/qiskit.pulse.ScheduleBlock.mdx index ea40eb3ffe1..bdcd90f161b 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.ScheduleBlock.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.ScheduleBlock.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.pulse.ScheduleBlock # ScheduleBlock - + Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.13)") Time-ordered sequence of instructions with alignment context. @@ -59,7 +59,7 @@ python_api_name: qiskit.pulse.ScheduleBlock print(sched_outer.parameters) ``` - ```text + ```python {Parameter(amp1), Parameter(amp2)} ``` @@ -69,7 +69,7 @@ python_api_name: qiskit.pulse.ScheduleBlock print(sched_outer.references) ``` - ```text + ```python ReferenceManager: - ('grand_child',): ScheduleBlock(Play(Constant(duration=100, amp=amp1,... ``` @@ -86,7 +86,7 @@ python_api_name: qiskit.pulse.ScheduleBlock print(main.parameters) ``` - ```text + ```python {Parameter(amp1), Parameter(amp2), Parameter(amp3} ``` @@ -98,7 +98,7 @@ python_api_name: qiskit.pulse.ScheduleBlock print(main.references) ``` - ```text + ```python ReferenceManager: - ('child',): ScheduleBlock(ScheduleBlock(ScheduleBlock(Play(Con... ``` @@ -113,10 +113,6 @@ python_api_name: qiskit.pulse.ScheduleBlock Create an empty schedule block. - - The class `qiskit.pulse.schedule.ScheduleBlock` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.13)") *| None*) – Name of this schedule. Defaults to an autogenerated string if not provided. @@ -201,7 +197,7 @@ python_api_name: qiskit.pulse.ScheduleBlock ### append - + 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** @@ -225,7 +221,7 @@ python_api_name: qiskit.pulse.ScheduleBlock ### assign\_parameters - + Assign the parameters in this schedule according to the input. **Parameters** @@ -250,7 +246,7 @@ python_api_name: qiskit.pulse.ScheduleBlock ### assign\_references - + 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: @@ -308,7 +304,7 @@ python_api_name: qiskit.pulse.ScheduleBlock ### ch\_duration - + Return the time of the end of the last instruction over the supplied channels. **Parameters** @@ -322,7 +318,7 @@ python_api_name: qiskit.pulse.ScheduleBlock ### draw - + Plot the schedule. **Parameters** @@ -368,7 +364,7 @@ python_api_name: qiskit.pulse.ScheduleBlock ### exclude - + 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 [`filter()`](#qiskit.pulse.ScheduleBlock.filter "qiskit.pulse.ScheduleBlock.filter"), so that: ```python @@ -393,7 +389,7 @@ python_api_name: qiskit.pulse.ScheduleBlock ### filter - + 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`. @@ -416,7 +412,7 @@ python_api_name: qiskit.pulse.ScheduleBlock ### get\_parameters - + 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, @@ -454,7 +450,7 @@ python_api_name: qiskit.pulse.ScheduleBlock ### initialize\_from - + Create new schedule object with metadata of another schedule object. **Parameters** @@ -477,7 +473,7 @@ python_api_name: qiskit.pulse.ScheduleBlock ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -487,7 +483,7 @@ python_api_name: qiskit.pulse.ScheduleBlock ### is\_referenced - + Return True iff the current schedule block contains reference to subroutine. **Return type** @@ -497,7 +493,7 @@ python_api_name: qiskit.pulse.ScheduleBlock ### is\_schedulable - + Return `True` if all durations are assigned. **Return type** @@ -507,7 +503,7 @@ python_api_name: qiskit.pulse.ScheduleBlock ### replace - + Return a `ScheduleBlock` with the `old` component replaced with a `new` component. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.pulse.channels.AcquireChannel.mdx b/docs/api/qiskit/dev/qiskit.pulse.channels.AcquireChannel.mdx index 7c5e8e7a343..03625a841f7 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.channels.AcquireChannel.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.channels.AcquireChannel.mdx @@ -8,17 +8,13 @@ python_api_name: qiskit.pulse.channels.AcquireChannel # AcquireChannel - + Bases: [`Channel`](pulse#qiskit.pulse.channels.Channel "qiskit.pulse.channels.Channel") Acquire channels are used to collect data. Channel class. - - The class `qiskit.pulse.channels.Channel` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** **index** – Index of channel. @@ -53,7 +49,7 @@ python_api_name: qiskit.pulse.channels.AcquireChannel ### is\_parameterized - + Return True iff the channel is parameterized. **Return type** diff --git a/docs/api/qiskit/dev/qiskit.pulse.channels.ControlChannel.mdx b/docs/api/qiskit/dev/qiskit.pulse.channels.ControlChannel.mdx index d57f0fccda6..fb07411ab9a 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.channels.ControlChannel.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.channels.ControlChannel.mdx @@ -8,17 +8,13 @@ python_api_name: qiskit.pulse.channels.ControlChannel # ControlChannel - + 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. - - The class `qiskit.pulse.channels.Channel` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** **index** – Index of channel. @@ -53,7 +49,7 @@ python_api_name: qiskit.pulse.channels.ControlChannel ### is\_parameterized - + Return True iff the channel is parameterized. **Return type** diff --git a/docs/api/qiskit/dev/qiskit.pulse.channels.DriveChannel.mdx b/docs/api/qiskit/dev/qiskit.pulse.channels.DriveChannel.mdx index 94dbe661579..0742a584071 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.channels.DriveChannel.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.channels.DriveChannel.mdx @@ -8,17 +8,13 @@ python_api_name: qiskit.pulse.channels.DriveChannel # DriveChannel - + Bases: `PulseChannel` Drive channels transmit signals to qubits which enact gate operations. Channel class. - - The class `qiskit.pulse.channels.Channel` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** **index** – Index of channel. @@ -53,7 +49,7 @@ python_api_name: qiskit.pulse.channels.DriveChannel ### is\_parameterized - + Return True iff the channel is parameterized. **Return type** diff --git a/docs/api/qiskit/dev/qiskit.pulse.channels.MeasureChannel.mdx b/docs/api/qiskit/dev/qiskit.pulse.channels.MeasureChannel.mdx index 90ae8023803..87b7b3198f2 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.channels.MeasureChannel.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.channels.MeasureChannel.mdx @@ -8,17 +8,13 @@ python_api_name: qiskit.pulse.channels.MeasureChannel # MeasureChannel - + Bases: `PulseChannel` Measure channels transmit measurement stimulus pulses for readout. Channel class. - - The class `qiskit.pulse.channels.Channel` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** **index** – Index of channel. @@ -53,7 +49,7 @@ python_api_name: qiskit.pulse.channels.MeasureChannel ### is\_parameterized - + Return True iff the channel is parameterized. **Return type** diff --git a/docs/api/qiskit/dev/qiskit.pulse.channels.MemorySlot.mdx b/docs/api/qiskit/dev/qiskit.pulse.channels.MemorySlot.mdx index 24e710e9ec0..7076c1dc8cc 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.channels.MemorySlot.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.channels.MemorySlot.mdx @@ -8,17 +8,13 @@ python_api_name: qiskit.pulse.channels.MemorySlot # MemorySlot - + Bases: `ClassicalIOChannel` Memory slot channels represent classical memory storage. Channel class. - - The class `qiskit.pulse.channels.Channel` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** **index** – Index of channel. @@ -53,7 +49,7 @@ python_api_name: qiskit.pulse.channels.MemorySlot ### is\_parameterized - + Return True iff the channel is parameterized. **Return type** diff --git a/docs/api/qiskit/dev/qiskit.pulse.channels.RegisterSlot.mdx b/docs/api/qiskit/dev/qiskit.pulse.channels.RegisterSlot.mdx index 7434e33f68a..984b744781a 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.channels.RegisterSlot.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.channels.RegisterSlot.mdx @@ -8,17 +8,13 @@ python_api_name: qiskit.pulse.channels.RegisterSlot # RegisterSlot - + Bases: `ClassicalIOChannel` Classical resister slot channels represent classical registers (low-latency classical memory). Channel class. - - The class `qiskit.pulse.channels.Channel` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** **index** – Index of channel. @@ -53,7 +49,7 @@ python_api_name: qiskit.pulse.channels.RegisterSlot ### is\_parameterized - + Return True iff the channel is parameterized. **Return type** diff --git a/docs/api/qiskit/dev/qiskit.pulse.channels.SnapshotChannel.mdx b/docs/api/qiskit/dev/qiskit.pulse.channels.SnapshotChannel.mdx index accd69f6874..915b9db81f2 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.channels.SnapshotChannel.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.channels.SnapshotChannel.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.pulse.channels.SnapshotChannel # SnapshotChannel - + Bases: `ClassicalIOChannel` Snapshot channels are used to specify instructions for simulators. @@ -45,7 +45,7 @@ python_api_name: qiskit.pulse.channels.SnapshotChannel ### is\_parameterized - + Return True iff the channel is parameterized. **Return type** diff --git a/docs/api/qiskit/dev/qiskit.pulse.instructions.Acquire.mdx b/docs/api/qiskit/dev/qiskit.pulse.instructions.Acquire.mdx index b45367006ab..38a0f2faf79 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.instructions.Acquire.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.instructions.Acquire.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.pulse.instructions.Acquire # Acquire - + 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: @@ -21,10 +21,6 @@ python_api_name: qiskit.pulse.instructions.Acquire Create a new Acquire instruction. - - The class `qiskit.pulse.instructions.acquire.Acquire` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")) – Length of time to acquire data in terms of dt. @@ -131,7 +127,7 @@ python_api_name: qiskit.pulse.instructions.Acquire ### append - + 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** @@ -150,7 +146,7 @@ python_api_name: qiskit.pulse.instructions.Acquire ### ch\_duration - + Return duration of the supplied channels in this Instruction. **Parameters** @@ -164,7 +160,7 @@ python_api_name: qiskit.pulse.instructions.Acquire ### ch\_start\_time - + Return minimum start time for supplied channels. **Parameters** @@ -178,7 +174,7 @@ python_api_name: qiskit.pulse.instructions.Acquire ### ch\_stop\_time - + Return maximum start time for supplied channels. **Parameters** @@ -192,7 +188,7 @@ python_api_name: qiskit.pulse.instructions.Acquire ### insert - + Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`. **Parameters** @@ -212,7 +208,7 @@ python_api_name: qiskit.pulse.instructions.Acquire ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -222,7 +218,7 @@ python_api_name: qiskit.pulse.instructions.Acquire ### shift - + Return a new schedule shifted forward by time. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.pulse.instructions.Delay.mdx b/docs/api/qiskit/dev/qiskit.pulse.instructions.Delay.mdx index 9b6fa81d6ff..b4ad411cdaf 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.instructions.Delay.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.instructions.Delay.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.pulse.instructions.Delay # Delay - + 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. @@ -29,10 +29,6 @@ python_api_name: qiskit.pulse.instructions.Delay No other instruction may be scheduled within a `Delay`. - - The class `qiskit.pulse.instructions.delay.Delay` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")) – Length of time of the delay in terms of dt. @@ -105,7 +101,7 @@ python_api_name: qiskit.pulse.instructions.Delay ### append - + 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** @@ -124,7 +120,7 @@ python_api_name: qiskit.pulse.instructions.Delay ### ch\_duration - + Return duration of the supplied channels in this Instruction. **Parameters** @@ -138,7 +134,7 @@ python_api_name: qiskit.pulse.instructions.Delay ### ch\_start\_time - + Return minimum start time for supplied channels. **Parameters** @@ -152,7 +148,7 @@ python_api_name: qiskit.pulse.instructions.Delay ### ch\_stop\_time - + Return maximum start time for supplied channels. **Parameters** @@ -166,7 +162,7 @@ python_api_name: qiskit.pulse.instructions.Delay ### insert - + Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`. **Parameters** @@ -186,7 +182,7 @@ python_api_name: qiskit.pulse.instructions.Delay ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -196,7 +192,7 @@ python_api_name: qiskit.pulse.instructions.Delay ### shift - + Return a new schedule shifted forward by time. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.pulse.instructions.Play.mdx b/docs/api/qiskit/dev/qiskit.pulse.instructions.Play.mdx index 2dcda4a0d3a..c04a5869b68 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.instructions.Play.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.instructions.Play.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.pulse.instructions.Play # Play - + Bases: [`Instruction`](pulse#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction") This instruction is responsible for applying a pulse on a channel. @@ -17,10 +17,6 @@ python_api_name: qiskit.pulse.instructions.Play Create a new pulse instruction. - - The class `qiskit.pulse.instructions.play.Play` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **pulse** (*Pulse*) – A pulse waveform description, such as [`Waveform`](qiskit.pulse.library.Waveform "qiskit.pulse.library.Waveform"). @@ -99,7 +95,7 @@ python_api_name: qiskit.pulse.instructions.Play ### append - + 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** @@ -118,7 +114,7 @@ python_api_name: qiskit.pulse.instructions.Play ### ch\_duration - + Return duration of the supplied channels in this Instruction. **Parameters** @@ -132,7 +128,7 @@ python_api_name: qiskit.pulse.instructions.Play ### ch\_start\_time - + Return minimum start time for supplied channels. **Parameters** @@ -146,7 +142,7 @@ python_api_name: qiskit.pulse.instructions.Play ### ch\_stop\_time - + Return maximum start time for supplied channels. **Parameters** @@ -160,7 +156,7 @@ python_api_name: qiskit.pulse.instructions.Play ### insert - + Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`. **Parameters** @@ -180,7 +176,7 @@ python_api_name: qiskit.pulse.instructions.Play ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -190,7 +186,7 @@ python_api_name: qiskit.pulse.instructions.Play ### shift - + Return a new schedule shifted forward by time. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.pulse.instructions.Reference.mdx b/docs/api/qiskit/dev/qiskit.pulse.instructions.Reference.mdx index e9dd828af33..878861462b6 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.instructions.Reference.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.instructions.Reference.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.pulse.instructions.Reference # Reference - + Bases: [`Instruction`](pulse#qiskit.pulse.instructions.Instruction "qiskit.pulse.instructions.instruction.Instruction") Pulse compiler directive that refers to a subroutine. @@ -21,10 +21,6 @@ python_api_name: qiskit.pulse.instructions.Reference Create new reference. - - The class `qiskit.pulse.instructions.reference.Reference` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.13)")) – Name of subroutine. @@ -104,7 +100,7 @@ python_api_name: qiskit.pulse.instructions.Reference ### append - + 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** @@ -123,7 +119,7 @@ python_api_name: qiskit.pulse.instructions.Reference ### ch\_duration - + Return duration of the supplied channels in this Instruction. **Parameters** @@ -137,7 +133,7 @@ python_api_name: qiskit.pulse.instructions.Reference ### ch\_start\_time - + Return minimum start time for supplied channels. **Parameters** @@ -151,7 +147,7 @@ python_api_name: qiskit.pulse.instructions.Reference ### ch\_stop\_time - + Return maximum start time for supplied channels. **Parameters** @@ -165,7 +161,7 @@ python_api_name: qiskit.pulse.instructions.Reference ### insert - + Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`. **Parameters** @@ -185,7 +181,7 @@ python_api_name: qiskit.pulse.instructions.Reference ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -195,7 +191,7 @@ python_api_name: qiskit.pulse.instructions.Reference ### shift - + Return a new schedule shifted forward by time. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.pulse.instructions.RelativeBarrier.mdx b/docs/api/qiskit/dev/qiskit.pulse.instructions.RelativeBarrier.mdx index 794296df5c6..51b5a649ec2 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.instructions.RelativeBarrier.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.instructions.RelativeBarrier.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.pulse.instructions.RelativeBarrier # RelativeBarrier - + Bases: `Directive` Pulse `RelativeBarrier` directive. @@ -17,10 +17,6 @@ python_api_name: qiskit.pulse.instructions.RelativeBarrier 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. - - The class `qiskit.pulse.instructions.directives.RelativeBarrier` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **channels** (*chans.Channel*) – The channel that the barrier applies to. @@ -86,7 +82,7 @@ python_api_name: qiskit.pulse.instructions.RelativeBarrier ### append - + 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** @@ -105,7 +101,7 @@ python_api_name: qiskit.pulse.instructions.RelativeBarrier ### ch\_duration - + Return duration of the supplied channels in this Instruction. **Parameters** @@ -119,7 +115,7 @@ python_api_name: qiskit.pulse.instructions.RelativeBarrier ### ch\_start\_time - + Return minimum start time for supplied channels. **Parameters** @@ -133,7 +129,7 @@ python_api_name: qiskit.pulse.instructions.RelativeBarrier ### ch\_stop\_time - + Return maximum start time for supplied channels. **Parameters** @@ -147,7 +143,7 @@ python_api_name: qiskit.pulse.instructions.RelativeBarrier ### insert - + Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`. **Parameters** @@ -167,7 +163,7 @@ python_api_name: qiskit.pulse.instructions.RelativeBarrier ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -177,7 +173,7 @@ python_api_name: qiskit.pulse.instructions.RelativeBarrier ### shift - + Return a new schedule shifted forward by time. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.pulse.instructions.SetFrequency.mdx b/docs/api/qiskit/dev/qiskit.pulse.instructions.SetFrequency.mdx index 28a63dd8378..88962b6e745 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.instructions.SetFrequency.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.instructions.SetFrequency.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.pulse.instructions.SetFrequency # SetFrequency - + 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 @@ -25,10 +25,6 @@ $$ Creates a new set channel frequency instruction. - - The class `qiskit.pulse.instructions.frequency.SetFrequency` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **frequency** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.13)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – New frequency of the channel in Hz. @@ -107,7 +103,7 @@ $$ ### append - + 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** @@ -126,7 +122,7 @@ $$ ### ch\_duration - + Return duration of the supplied channels in this Instruction. **Parameters** @@ -140,7 +136,7 @@ $$ ### ch\_start\_time - + Return minimum start time for supplied channels. **Parameters** @@ -154,7 +150,7 @@ $$ ### ch\_stop\_time - + Return maximum start time for supplied channels. **Parameters** @@ -168,7 +164,7 @@ $$ ### insert - + Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`. **Parameters** @@ -188,7 +184,7 @@ $$ ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -198,7 +194,7 @@ $$ ### shift - + Return a new schedule shifted forward by time. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.pulse.instructions.SetPhase.mdx b/docs/api/qiskit/dev/qiskit.pulse.instructions.SetPhase.mdx index 7bb64d80b6f..d077c85dd0e 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.instructions.SetPhase.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.instructions.SetPhase.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.pulse.instructions.SetPhase # SetPhase - + 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. @@ -23,10 +23,6 @@ $$ Instantiate a set phase instruction, setting the output signal phase on `channel` to `phase` \[radians]. - - The class `qiskit.pulse.instructions.phase.SetPhase` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **phase** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.13)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The rotation angle in radians. @@ -105,7 +101,7 @@ $$ ### append - + 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** @@ -124,7 +120,7 @@ $$ ### ch\_duration - + Return duration of the supplied channels in this Instruction. **Parameters** @@ -138,7 +134,7 @@ $$ ### ch\_start\_time - + Return minimum start time for supplied channels. **Parameters** @@ -152,7 +148,7 @@ $$ ### ch\_stop\_time - + Return maximum start time for supplied channels. **Parameters** @@ -166,7 +162,7 @@ $$ ### insert - + Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`. **Parameters** @@ -186,7 +182,7 @@ $$ ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -196,7 +192,7 @@ $$ ### shift - + Return a new schedule shifted forward by time. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.pulse.instructions.ShiftFrequency.mdx b/docs/api/qiskit/dev/qiskit.pulse.instructions.ShiftFrequency.mdx index 9f353016445..013e95e5fa2 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.instructions.ShiftFrequency.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.instructions.ShiftFrequency.mdx @@ -8,17 +8,13 @@ python_api_name: qiskit.pulse.instructions.ShiftFrequency # ShiftFrequency - + 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. - - The class `qiskit.pulse.instructions.frequency.ShiftFrequency` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **frequency** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.13)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – Frequency shift of the channel in Hz. @@ -97,7 +93,7 @@ python_api_name: qiskit.pulse.instructions.ShiftFrequency ### append - + 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** @@ -116,7 +112,7 @@ python_api_name: qiskit.pulse.instructions.ShiftFrequency ### ch\_duration - + Return duration of the supplied channels in this Instruction. **Parameters** @@ -130,7 +126,7 @@ python_api_name: qiskit.pulse.instructions.ShiftFrequency ### ch\_start\_time - + Return minimum start time for supplied channels. **Parameters** @@ -144,7 +140,7 @@ python_api_name: qiskit.pulse.instructions.ShiftFrequency ### ch\_stop\_time - + Return maximum start time for supplied channels. **Parameters** @@ -158,7 +154,7 @@ python_api_name: qiskit.pulse.instructions.ShiftFrequency ### insert - + Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`. **Parameters** @@ -178,7 +174,7 @@ python_api_name: qiskit.pulse.instructions.ShiftFrequency ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -188,7 +184,7 @@ python_api_name: qiskit.pulse.instructions.ShiftFrequency ### shift - + Return a new schedule shifted forward by time. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.pulse.instructions.ShiftPhase.mdx b/docs/api/qiskit/dev/qiskit.pulse.instructions.ShiftPhase.mdx index addbb9f6f0b..bc6c2256142 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.instructions.ShiftPhase.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.instructions.ShiftPhase.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.pulse.instructions.ShiftPhase # ShiftPhase - + 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. @@ -27,10 +27,6 @@ $$ Instantiate a shift phase instruction, increasing the output signal phase on `channel` by `phase` \[radians]. - - The class `qiskit.pulse.instructions.phase.ShiftPhase` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **phase** ([*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.13)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.parameterexpression.ParameterExpression")) – The rotation angle in radians. @@ -109,7 +105,7 @@ $$ ### append - + 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** @@ -128,7 +124,7 @@ $$ ### ch\_duration - + Return duration of the supplied channels in this Instruction. **Parameters** @@ -142,7 +138,7 @@ $$ ### ch\_start\_time - + Return minimum start time for supplied channels. **Parameters** @@ -156,7 +152,7 @@ $$ ### ch\_stop\_time - + Return maximum start time for supplied channels. **Parameters** @@ -170,7 +166,7 @@ $$ ### insert - + Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`. **Parameters** @@ -190,7 +186,7 @@ $$ ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -200,7 +196,7 @@ $$ ### shift - + Return a new schedule shifted forward by time. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.pulse.instructions.Snapshot.mdx b/docs/api/qiskit/dev/qiskit.pulse.instructions.Snapshot.mdx index 3bd3d13557f..9a004c0a1c7 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.instructions.Snapshot.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.instructions.Snapshot.mdx @@ -8,17 +8,13 @@ python_api_name: qiskit.pulse.instructions.Snapshot # Snapshot - + 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. - - The class `qiskit.pulse.instructions.snapshot.Snapshot` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.13)")) – Snapshot label which is used to identify the snapshot in the output. @@ -103,7 +99,7 @@ python_api_name: qiskit.pulse.instructions.Snapshot ### append - + 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** @@ -122,7 +118,7 @@ python_api_name: qiskit.pulse.instructions.Snapshot ### ch\_duration - + Return duration of the supplied channels in this Instruction. **Parameters** @@ -136,7 +132,7 @@ python_api_name: qiskit.pulse.instructions.Snapshot ### ch\_start\_time - + Return minimum start time for supplied channels. **Parameters** @@ -150,7 +146,7 @@ python_api_name: qiskit.pulse.instructions.Snapshot ### ch\_stop\_time - + Return maximum start time for supplied channels. **Parameters** @@ -164,7 +160,7 @@ python_api_name: qiskit.pulse.instructions.Snapshot ### insert - + Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`. **Parameters** @@ -184,7 +180,7 @@ python_api_name: qiskit.pulse.instructions.Snapshot ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -194,7 +190,7 @@ python_api_name: qiskit.pulse.instructions.Snapshot ### shift - + Return a new schedule shifted forward by time. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.pulse.instructions.TimeBlockade.mdx b/docs/api/qiskit/dev/qiskit.pulse.instructions.TimeBlockade.mdx index 97ef4f7cc3d..32e8d8d18da 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.instructions.TimeBlockade.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.instructions.TimeBlockade.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.pulse.instructions.TimeBlockade # TimeBlockade - + Bases: `Directive` Pulse `TimeBlockade` directive. @@ -51,10 +51,6 @@ python_api_name: qiskit.pulse.instructions.TimeBlockade Create a time blockade directive. - - The class `qiskit.pulse.instructions.directives.TimeBlockade` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")) – Length of time of the occupation in terms of dt. @@ -127,7 +123,7 @@ python_api_name: qiskit.pulse.instructions.TimeBlockade ### append - + 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** @@ -146,7 +142,7 @@ python_api_name: qiskit.pulse.instructions.TimeBlockade ### ch\_duration - + Return duration of the supplied channels in this Instruction. **Parameters** @@ -160,7 +156,7 @@ python_api_name: qiskit.pulse.instructions.TimeBlockade ### ch\_start\_time - + Return minimum start time for supplied channels. **Parameters** @@ -174,7 +170,7 @@ python_api_name: qiskit.pulse.instructions.TimeBlockade ### ch\_stop\_time - + Return maximum start time for supplied channels. **Parameters** @@ -188,7 +184,7 @@ python_api_name: qiskit.pulse.instructions.TimeBlockade ### insert - + Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`. **Parameters** @@ -208,7 +204,7 @@ python_api_name: qiskit.pulse.instructions.TimeBlockade ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -218,7 +214,7 @@ python_api_name: qiskit.pulse.instructions.TimeBlockade ### shift - + Return a new schedule shifted forward by time. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.pulse.library.Constant.mdx b/docs/api/qiskit/dev/qiskit.pulse.library.Constant.mdx index 1dd0e1b2571..c7f1645c662 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.library.Constant.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.library.Constant.mdx @@ -18,9 +18,19 @@ f(x) = \text{amp}\times\exp\left(i\text{angle}\right) , 0 <= x < duration f(x) = 0 , elsewhere $$ - - The class `qiskit.pulse.library.symbolic_pulses.Constant` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - + 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. + * **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 diff --git a/docs/api/qiskit/dev/qiskit.pulse.library.Cos.mdx b/docs/api/qiskit/dev/qiskit.pulse.library.Cos.mdx index 1fe02be6a2a..ec84a8d4658 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.library.Cos.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.library.Cos.mdx @@ -10,7 +10,7 @@ python_api_name: qiskit.pulse.library.Cos # qiskit.pulse.library.Cos - + A cosine pulse. The envelope of the pulse is given by: @@ -21,10 +21,6 @@ $$ where $\text{A} = \text{amp} \times\exp\left(i\times\text{angle}\right)$. - - The function `qiskit.pulse.library.symbolic_pulses.Cos()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")) – Pulse length in terms of the sampling period dt. diff --git a/docs/api/qiskit/dev/qiskit.pulse.library.Drag.mdx b/docs/api/qiskit/dev/qiskit.pulse.library.Drag.mdx index ded25c132a7..446aec006e4 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.library.Drag.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.library.Drag.mdx @@ -32,9 +32,21 @@ $$ 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) - - The class `qiskit.pulse.library.symbolic_pulses.Drag` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - + 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. + * **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 diff --git a/docs/api/qiskit/dev/qiskit.pulse.library.Gaussian.mdx b/docs/api/qiskit/dev/qiskit.pulse.library.Gaussian.mdx index 613ea52e2b0..3c7f4fd1473 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.library.Gaussian.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.library.Gaussian.mdx @@ -22,9 +22,20 @@ $$ 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)$. - - The class `qiskit.pulse.library.symbolic_pulses.Gaussian` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - + 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. + * **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 diff --git a/docs/api/qiskit/dev/qiskit.pulse.library.GaussianDeriv.mdx b/docs/api/qiskit/dev/qiskit.pulse.library.GaussianDeriv.mdx index 4d134eed37f..2346a433c3d 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.library.GaussianDeriv.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.library.GaussianDeriv.mdx @@ -10,7 +10,7 @@ python_api_name: qiskit.pulse.library.GaussianDeriv # qiskit.pulse.library.GaussianDeriv - + 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: @@ -22,10 +22,6 @@ $$ where $\text{A} = \text{amp} \times\exp\left(i\times\text{angle}\right)$, and $\mu=\text{duration}/2$. - - The function `qiskit.pulse.library.symbolic_pulses.GaussianDeriv()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)") *| ParameterValueType*) – Pulse length in terms of the sampling period dt. diff --git a/docs/api/qiskit/dev/qiskit.pulse.library.GaussianSquare.mdx b/docs/api/qiskit/dev/qiskit.pulse.library.GaussianSquare.mdx index 0732ef9fee2..205e1c9ff87 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.library.GaussianSquare.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.library.GaussianSquare.mdx @@ -45,9 +45,26 @@ $$ 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)$. - - The class `qiskit.pulse.library.symbolic_pulses.GaussianSquare` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - + 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. + * **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 diff --git a/docs/api/qiskit/dev/qiskit.pulse.library.GaussianSquareDrag.mdx b/docs/api/qiskit/dev/qiskit.pulse.library.GaussianSquareDrag.mdx index f0351feba65..930c341d21f 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.library.GaussianSquareDrag.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.library.GaussianSquareDrag.mdx @@ -10,7 +10,7 @@ python_api_name: qiskit.pulse.library.GaussianSquareDrag # qiskit.pulse.library.GaussianSquareDrag - + 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 "qiskit.pulse.library.Drag") for its rise and fall instead of [`Gaussian`](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. @@ -61,10 +61,6 @@ $$ where $\text{A} = \text{amp} \times \exp\left(i\times\text{angle}\right)$. - - The function `qiskit.pulse.library.symbolic_pulses.GaussianSquareDrag()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")) – Pulse length in terms of the sampling period dt. diff --git a/docs/api/qiskit/dev/qiskit.pulse.library.Sawtooth.mdx b/docs/api/qiskit/dev/qiskit.pulse.library.Sawtooth.mdx index a384e8884fd..c88940ed12b 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.library.Sawtooth.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.library.Sawtooth.mdx @@ -10,7 +10,7 @@ python_api_name: qiskit.pulse.library.Sawtooth # qiskit.pulse.library.Sawtooth - + A sawtooth pulse. The envelope of the pulse is given by: @@ -22,10 +22,6 @@ $$ 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. - - The function `qiskit.pulse.library.symbolic_pulses.Sawtooth()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")) – Pulse length in terms of the sampling period dt. diff --git a/docs/api/qiskit/dev/qiskit.pulse.library.Sech.mdx b/docs/api/qiskit/dev/qiskit.pulse.library.Sech.mdx index 84691ecb6be..d03b1d88161 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.library.Sech.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.library.Sech.mdx @@ -10,7 +10,7 @@ python_api_name: qiskit.pulse.library.Sech # qiskit.pulse.library.Sech - + 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: @@ -30,10 +30,6 @@ $$ 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\`\`. - - The function `qiskit.pulse.library.symbolic_pulses.Sech()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)") *| ParameterValueType*) – Pulse length in terms of the sampling period dt. diff --git a/docs/api/qiskit/dev/qiskit.pulse.library.SechDeriv.mdx b/docs/api/qiskit/dev/qiskit.pulse.library.SechDeriv.mdx index c35ebe884f7..f652ad51047 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.library.SechDeriv.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.library.SechDeriv.mdx @@ -10,7 +10,7 @@ python_api_name: qiskit.pulse.library.SechDeriv # qiskit.pulse.library.SechDeriv - + 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: @@ -22,10 +22,6 @@ $$ 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. - - The function `qiskit.pulse.library.symbolic_pulses.SechDeriv()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)") *| ParameterValueType*) – Pulse length in terms of the sampling period dt. diff --git a/docs/api/qiskit/dev/qiskit.pulse.library.Sin.mdx b/docs/api/qiskit/dev/qiskit.pulse.library.Sin.mdx index 4784deb84e0..7d8609a0df8 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.library.Sin.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.library.Sin.mdx @@ -10,7 +10,7 @@ python_api_name: qiskit.pulse.library.Sin # qiskit.pulse.library.Sin - + A sinusoidal pulse. The envelope of the pulse is given by: @@ -21,10 +21,6 @@ $$ where $\text{A} = \text{amp} \times\exp\left(i\times\text{angle}\right)$. - - The function `qiskit.pulse.library.symbolic_pulses.Sin()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")) – Pulse length in terms of the sampling period dt. diff --git a/docs/api/qiskit/dev/qiskit.pulse.library.Square.mdx b/docs/api/qiskit/dev/qiskit.pulse.library.Square.mdx index 201b29c9103..f7493f3758a 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.library.Square.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.library.Square.mdx @@ -10,7 +10,7 @@ python_api_name: qiskit.pulse.library.Square # qiskit.pulse.library.Square - + A square wave pulse. The envelope of the pulse is given by: @@ -22,10 +22,6 @@ $$ 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$. - - The function `qiskit.pulse.library.symbolic_pulses.Square()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)") *| ParameterValueType*) – Pulse length in terms of the sampling period `dt`. diff --git a/docs/api/qiskit/dev/qiskit.pulse.library.SymbolicPulse.mdx b/docs/api/qiskit/dev/qiskit.pulse.library.SymbolicPulse.mdx index b12ebdf1dca..ae0baa10711 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.library.SymbolicPulse.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.library.SymbolicPulse.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.pulse.library.SymbolicPulse # SymbolicPulse - + Bases: `Pulse` The pulse representation model with parameters and symbolic expressions. @@ -111,10 +111,6 @@ $$ Create a parametric pulse. - - The class `qiskit.pulse.library.symbolic_pulses.SymbolicPulse` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **pulse\_type** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.13)")) – Display name of this pulse shape. @@ -186,7 +182,7 @@ $$ ### draw - + Plot the interpolated envelope of pulse. **Parameters** @@ -222,7 +218,7 @@ $$ ### 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: @@ -247,7 +243,7 @@ $$ ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -257,7 +253,7 @@ $$ ### validate\_parameters - + Validate parameters. **Raises** diff --git a/docs/api/qiskit/dev/qiskit.pulse.library.Triangle.mdx b/docs/api/qiskit/dev/qiskit.pulse.library.Triangle.mdx index 288e9689f4f..07cf861fb9a 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.library.Triangle.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.library.Triangle.mdx @@ -10,7 +10,7 @@ python_api_name: qiskit.pulse.library.Triangle # qiskit.pulse.library.Triangle - + A triangle wave pulse. The envelope of the pulse is given by: @@ -21,10 +21,6 @@ $$ 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}$. - - The function `qiskit.pulse.library.symbolic_pulses.Triangle()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **duration** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)") *|*[*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")) – Pulse length in terms of the sampling period dt. diff --git a/docs/api/qiskit/dev/qiskit.pulse.library.Waveform.mdx b/docs/api/qiskit/dev/qiskit.pulse.library.Waveform.mdx index f0bded2d391..f11e6678526 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.library.Waveform.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.library.Waveform.mdx @@ -8,17 +8,13 @@ python_api_name: qiskit.pulse.library.Waveform # Waveform - + 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. - - The class `qiskit.pulse.library.waveform.Waveform` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **Parameters** * **samples** (*np.ndarray |* [*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.13)")*\[*[*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.13)")*]*) – Complex array of the samples in the pulse envelope. @@ -62,7 +58,7 @@ python_api_name: qiskit.pulse.library.Waveform ### draw - + Plot the interpolated envelope of pulse. **Parameters** @@ -98,7 +94,7 @@ python_api_name: qiskit.pulse.library.Waveform ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** diff --git a/docs/api/qiskit/dev/qiskit.pulse.library.gaussian_square_echo.mdx b/docs/api/qiskit/dev/qiskit.pulse.library.gaussian_square_echo.mdx index 2920340b518..d4761d4d48d 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.library.gaussian_square_echo.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.library.gaussian_square_echo.mdx @@ -10,7 +10,7 @@ python_api_name: qiskit.pulse.library.gaussian_square_echo # qiskit.pulse.library.gaussian\_square\_echo - + 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: @@ -43,10 +43,6 @@ $$ $$ - - The function `qiskit.pulse.library.symbolic_pulses.gaussian_square_echo()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics) - - **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) diff --git a/docs/api/qiskit/dev/qiskit.quantum_info.CNOTDihedral.mdx b/docs/api/qiskit/dev/qiskit.quantum_info.CNOTDihedral.mdx index 874c2f1d8b8..56d2767533a 100644 --- a/docs/api/qiskit/dev/qiskit.quantum_info.CNOTDihedral.mdx +++ b/docs/api/qiskit/dev/qiskit.quantum_info.CNOTDihedral.mdx @@ -39,7 +39,7 @@ python_api_name: qiskit.quantum_info.CNOTDihedral > print(elem) > ``` - ```text + ```python phase polynomial = 0 + 3*x_0 + 3*x_1 + 2*x_0*x_1 affine function = diff --git a/docs/api/qiskit/dev/qiskit.quantum_info.Clifford.mdx b/docs/api/qiskit/dev/qiskit.quantum_info.Clifford.mdx index c25fb5563b3..bd2d982d151 100644 --- a/docs/api/qiskit/dev/qiskit.quantum_info.Clifford.mdx +++ b/docs/api/qiskit/dev/qiskit.quantum_info.Clifford.mdx @@ -52,7 +52,7 @@ python_api_name: qiskit.quantum_info.Clifford print(cliff.to_labels(mode="S")) ``` - ```text + ```python Clifford: Stabilizer = ['+XX', '+ZZ'], Destabilizer = ['+IZ', '+XI'] ['+IZ', '+XI'] ['+XX', '+ZZ'] diff --git a/docs/api/qiskit/dev/qiskit.quantum_info.DensityMatrix.mdx b/docs/api/qiskit/dev/qiskit.quantum_info.DensityMatrix.mdx index 357729bbf86..16d30fa103e 100644 --- a/docs/api/qiskit/dev/qiskit.quantum_info.DensityMatrix.mdx +++ b/docs/api/qiskit/dev/qiskit.quantum_info.DensityMatrix.mdx @@ -351,7 +351,7 @@ python_api_name: qiskit.quantum_info.DensityMatrix print('Qubit-1 probs: {}'.format(probs_qubit_1)) ``` - ```text + ```python probs: [0.5 0. 0.5 0. ] Qubit-0 probs: [1. 0.] Qubit-1 probs: [0.5 0.5] @@ -374,7 +374,7 @@ python_api_name: qiskit.quantum_info.DensityMatrix print('Swapped probs: {}'.format(probs_swapped)) ``` - ```text + ```python probs: [0.5 0. 0.5 0. ] Swapped probs: [0.5 0.5 0. 0. ] ``` @@ -555,7 +555,7 @@ python_api_name: qiskit.quantum_info.DensityMatrix print(rho.to_dict()) ``` - ```text + ```python { '00|00': (0.4999999999999999+0j), '10|00': (-0.4999999999999999-0j), @@ -579,7 +579,7 @@ python_api_name: qiskit.quantum_info.DensityMatrix print(rho.to_dict()) ``` - ```text + ```python {'00|00': (0.25+0j), '10|10': (0.25+0j), '20|20': (0.25+0j), '22|22': (0.25+0j)} ``` @@ -596,7 +596,7 @@ python_api_name: qiskit.quantum_info.DensityMatrix print(rho.to_dict()) ``` - ```text + ```python {'00|00': (0.5+0j), '91|91': (0.5+0j)} ``` diff --git a/docs/api/qiskit/dev/qiskit.quantum_info.Operator.mdx b/docs/api/qiskit/dev/qiskit.quantum_info.Operator.mdx index 109233caaa0..167d2a0f464 100644 --- a/docs/api/qiskit/dev/qiskit.quantum_info.Operator.mdx +++ b/docs/api/qiskit/dev/qiskit.quantum_info.Operator.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.quantum_info.Operator # Operator - + Bases: `LinearOp` Matrix operator class @@ -116,7 +116,7 @@ $$ ### apply\_permutation - + Modifies operator’s data by composing it with a permutation. **Parameters** @@ -139,7 +139,7 @@ $$ ### compose - + Return the operator composition with another Operator. **Parameters** @@ -169,7 +169,7 @@ $$ ### conjugate - + Return the conjugate of the Operator. @@ -204,7 +204,7 @@ $$ ### draw - + Return a visualization of the Operator. **repr**: String of the state’s `__repr__`. @@ -235,7 +235,7 @@ $$ ### equiv - + Return True if operators are equivalent up to global phase. **Parameters** @@ -255,7 +255,7 @@ $$ ### expand - + Return the reverse-order tensor product with another Operator. **Parameters** @@ -275,7 +275,7 @@ $$ ### from\_circuit - + 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. @@ -300,7 +300,7 @@ $$ ### from\_label - + Return a tensor product of single-qubit operators. **Parameters** @@ -332,7 +332,7 @@ $$ ### is\_unitary - + Return True if operator is a unitary matrix. @@ -344,26 +344,12 @@ $$ ### power - + Return the matrix power of the operator. - Non-integer powers of operators with an eigenvalue whose complex phase is $\pi$ have a branch cut in the complex plane, which makes the calculation of the principal root around this cut subject to precision / differences in BLAS implementation. For example, the square root of Pauli Y can return the $\pi/2$ or $\-pi/2$ Y rotation depending on whether the -1 eigenvalue is found as `complex(-1, tiny)` or `complex(-1, -tiny)`. Such eigenvalues are really common in quantum information, so this function first phase-rotates the input matrix to shift the branch cut to a far less common point. The underlying numerical precision issues around the branch-cut point remain, if an operator has an eigenvalue close to this phase. The magnitude of this rotation can be controlled with the `branch_cut_rotation` parameter. - - The choice of `branch_cut_rotation` affects the principal root that is found. For example, the square root of [`ZGate`](qiskit.circuit.library.ZGate "qiskit.circuit.library.ZGate") will be calculated as either [`SGate`](qiskit.circuit.library.SGate "qiskit.circuit.library.SGate") or [`SdgGate`](qiskit.circuit.library.SdgGate "qiskit.circuit.library.SdgGate") depending on which way the rotation is done: - - ```python - from qiskit.circuit import library - from qiskit.quantum_info import Operator - - z_op = Operator(library.ZGate()) - assert z_op.power(0.5, branch_cut_rotation=1e-3) == Operator(library.SGate()) - assert z_op.power(0.5, branch_cut_rotation=-1e-3) == Operator(library.SdgGate()) - ``` - **Parameters** - * **n** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.13)")) – the power to raise the matrix to. - * **branch\_cut\_rotation** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.13)")) – The rotation angle to apply to the branch cut in the complex plane. This shifts the branch cut away from the common point of $-1$, but can cause a different root to be selected as the principal root. The rotation is anticlockwise, following the standard convention for complex phase. + **n** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.13)")) – the power to raise the matrix to. **Returns** @@ -404,7 +390,7 @@ $$ ### 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}$. @@ -420,7 +406,7 @@ $$ ### tensor - + Return the tensor product with another Operator. **Parameters** @@ -444,19 +430,19 @@ $$ ### to\_instruction - + Convert to a UnitaryGate instruction. ### to\_matrix - + Convert operator to NumPy matrix. ### to\_operator - + Convert operator to matrix operator class **Return type** @@ -466,7 +452,7 @@ $$ ### transpose - + Return the transpose of the Operator. diff --git a/docs/api/qiskit/dev/qiskit.quantum_info.Pauli.mdx b/docs/api/qiskit/dev/qiskit.quantum_info.Pauli.mdx index 5951f243ebd..90c8a9bc54a 100644 --- a/docs/api/qiskit/dev/qiskit.quantum_info.Pauli.mdx +++ b/docs/api/qiskit/dev/qiskit.quantum_info.Pauli.mdx @@ -271,7 +271,7 @@ $$ ### copy - + Make a deep copy of current operator. diff --git a/docs/api/qiskit/dev/qiskit.quantum_info.PauliList.mdx b/docs/api/qiskit/dev/qiskit.quantum_info.PauliList.mdx index 12c0a13c269..3d779304f70 100644 --- a/docs/api/qiskit/dev/qiskit.quantum_info.PauliList.mdx +++ b/docs/api/qiskit/dev/qiskit.quantum_info.PauliList.mdx @@ -59,7 +59,7 @@ python_api_name: qiskit.quantum_info.PauliList print("4. ", pauli_list) ``` - ```text + ```python 1. ['II', 'ZI', '-iYY'] 2. ['iXI'] 3. ['iXI', 'iZZ'] @@ -77,7 +77,7 @@ python_api_name: qiskit.quantum_info.PauliList print("Slice: ", repr(pauli_list[0:2])) ``` - ```text + ```python Integer: Pauli('ZZ') List: PauliList(['XX', 'IZ']) Slice: PauliList(['XX', 'ZZ']) @@ -297,7 +297,7 @@ python_api_name: qiskit.quantum_info.PauliList ### copy - + Make a deep copy of current operator. @@ -668,7 +668,7 @@ python_api_name: qiskit.quantum_info.PauliList print(srt) ``` - ```text + ```python Initial Ordering ['YX', 'ZZ', 'XZ', 'YI', 'YZ', 'II', 'XX', 'XI', 'XY', 'YY', 'IX', 'IZ', 'ZY', 'ZI', 'ZX', 'IY'] @@ -792,7 +792,7 @@ python_api_name: qiskit.quantum_info.PauliList print(unique) ``` - ```text + ```python ['X', 'Y', '-X', 'I', 'Z', 'iZ'] ``` diff --git a/docs/api/qiskit/dev/qiskit.quantum_info.SparseObservable.mdx b/docs/api/qiskit/dev/qiskit.quantum_info.SparseObservable.mdx deleted file mode 100644 index ebb8cfebd22..00000000000 --- a/docs/api/qiskit/dev/qiskit.quantum_info.SparseObservable.mdx +++ /dev/null @@ -1,762 +0,0 @@ ---- -title: SparseObservable -description: API reference for qiskit.quantum_info.SparseObservable -in_page_toc_min_heading_level: 1 -python_api_type: class -python_api_name: qiskit.quantum_info.SparseObservable ---- - -# SparseObservable - - - Bases: [`object`](https://docs.python.org/3/library/functions.html#object "(in Python v3.13)") - - An observable over Pauli bases that stores its data in a qubit-sparse format. - - ## Mathematics - - This observable represents a sum over strings of the Pauli operators and Pauli-eigenstate projectors, with each term weighted by some complex number. That is, the full observable is - -$$ -\text{\texttt{SparseObservable}} = \sum_i c_i \bigotimes_n A^{(n)}_i -$$ - - for complex numbers $c_i$ and single-qubit operators acting on qubit $n$ from a restricted alphabet $A^{(n)}_i$. The sum over $i$ is the sum of the individual terms, and the tensor product produces the operator strings. - - The alphabet of allowed single-qubit operators that the $A^{(n)}_i$ are drawn from is the Pauli operators and the Pauli-eigenstate projection operators. Explicitly, these are: - - - - | Label | Operator | Numeric value | [`BitTerm`](#qiskit.quantum_info.SparseObservable.BitTerm "qiskit.quantum_info.SparseObservable.BitTerm") attribute | - | ----- | ------------------------------------------------------------------------ | ------------- | ------------------------------------------------------------------------------------------------------------------- | - | `"I"` | $I$ (identity) | Not stored. | Not stored. | - | `"X"` | $X$ (Pauli X) | `0b0010` (2) | [`X`](#qiskit.quantum_info.SparseObservable.BitTerm.X "qiskit.quantum_info.SparseObservable.BitTerm.X") | - | `"Y"` | $Y$ (Pauli Y) | `0b0011` (3) | [`Y`](#qiskit.quantum_info.SparseObservable.BitTerm.Y "qiskit.quantum_info.SparseObservable.BitTerm.Y") | - | `"Z"` | $Z$ (Pauli Z) | `0b0001` (1) | [`Z`](#qiskit.quantum_info.SparseObservable.BitTerm.Z "qiskit.quantum_info.SparseObservable.BitTerm.Z") | - | `"+"` | $\lvert+\rangle\langle+\rvert$ (projector to positive eigenstate of X) | `0b1010` (10) | [`PLUS`](#qiskit.quantum_info.SparseObservable.BitTerm.PLUS "qiskit.quantum_info.SparseObservable.BitTerm.PLUS") | - | `"-"` | $\lvert-\rangle\langle-\rvert$ (projector to negative eigenstate of X) | `0b0110` (6) | [`MINUS`](#qiskit.quantum_info.SparseObservable.BitTerm.MINUS "qiskit.quantum_info.SparseObservable.BitTerm.MINUS") | - | `"r"` | $\lvert r\rangle\langle r\rvert$ (projector to positive eigenstate of Y) | `0b1011` (11) | [`RIGHT`](#qiskit.quantum_info.SparseObservable.BitTerm.RIGHT "qiskit.quantum_info.SparseObservable.BitTerm.RIGHT") | - | `"l"` | $\lvert l\rangle\langle l\rvert$ (projector to negative eigenstate of Y) | `0b0111` (7) | [`LEFT`](#qiskit.quantum_info.SparseObservable.BitTerm.LEFT "qiskit.quantum_info.SparseObservable.BitTerm.LEFT") | - | `"0"` | $\lvert0\rangle\langle0\rvert$ (projector to positive eigenstate of Z) | `0b1001` (9) | [`ZERO`](#qiskit.quantum_info.SparseObservable.BitTerm.ZERO "qiskit.quantum_info.SparseObservable.BitTerm.ZERO") | - | `"1"` | $\lvert1\rangle\langle1\rvert$ (projector to negative eigenstate of Z) | `0b0101` (5) | [`ONE`](#qiskit.quantum_info.SparseObservable.BitTerm.ONE "qiskit.quantum_info.SparseObservable.BitTerm.ONE") | - - The allowed alphabet forms an overcomplete basis of the operator space. This means that there is not a unique summation to represent a given observable. By comparison, [`SparsePauliOp`](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp") uses a precise basis of the operator space, so (after combining terms of the same Pauli string, removing zeros, and sorting the terms to [some canonical order](#sparse-observable-canonical-order)) there is only one representation of any operator. - - [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable") uses its particular overcomplete basis with the aim of making “efficiency of measurement” equivalent to “efficiency of representation”. For example, the observable ${\lvert0\rangle\langle0\rvert}^{\otimes n}$ can be efficiently measured on hardware with simple $Z$ measurements, but can only be represented by [`SparsePauliOp`](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp") as ${(I + Z)}^{\otimes n}/2^n$, which requires $2^n$ stored terms. [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable") requires only a single term to store this. - - The downside to this is that it is impractical to take an arbitrary matrix or [`SparsePauliOp`](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp") and find the *best* [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable") representation. You typically will want to construct a [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable") directly, rather than trying to decompose into one. - - ## Representation - - The internal representation of a [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable") stores only the non-identity qubit operators. This makes it significantly more efficient to represent observables such as $\sum_{n\in \text{qubits}} Z^{(n)}$; [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable") requires an amount of memory linear in the total number of qubits, while [`SparsePauliOp`](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp") scales quadratically. - - The terms are stored compressed, similar in spirit to the compressed sparse row format of sparse matrices. In this analogy, the terms of the sum are the “rows”, and the qubit terms are the “columns”, where an absent entry represents the identity rather than a zero. More explicitly, the representation is made up of four contiguous arrays: - - - - | Attribute | Length | Description | - | ------------------------------------------------------------------------------------------------------------------ | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - | [`coeffs`](#qiskit.quantum_info.SparseObservable.coeffs "qiskit.quantum_info.SparseObservable.coeffs") | $t$ | The complex scalar multiplier for each term. | - | [`bit_terms`](#qiskit.quantum_info.SparseObservable.bit_terms "qiskit.quantum_info.SparseObservable.bit_terms") | $s$ | Each of the non-identity single-qubit terms for all of the operators, in order. These correspond to the non-identity $A^{(n)}_i$ in the sum description, where the entries are stored in order of increasing $i$ first, and in order of increasing $n$ within each term. | - | [`indices`](#qiskit.quantum_info.SparseObservable.indices "qiskit.quantum_info.SparseObservable.indices") | $s$ | The corresponding qubit ($n$) for each of the operators in [`bit_terms`](#qiskit.quantum_info.SparseObservable.bit_terms "qiskit.quantum_info.SparseObservable.bit_terms"). [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable") requires that this list is term-wise sorted, and algorithms can rely on this invariant being upheld. | - | [`boundaries`](#qiskit.quantum_info.SparseObservable.boundaries "qiskit.quantum_info.SparseObservable.boundaries") | $t+1$ | The indices that partition [`bit_terms`](#qiskit.quantum_info.SparseObservable.bit_terms "qiskit.quantum_info.SparseObservable.bit_terms") and [`indices`](#qiskit.quantum_info.SparseObservable.indices "qiskit.quantum_info.SparseObservable.indices") into complete terms. For term number $i$, its complex coefficient is `coeffs[i]`, and its non-identity single-qubit operators and their corresponding qubits are the slice `boundaries[i] : boundaries[i+1]` into [`bit_terms`](#qiskit.quantum_info.SparseObservable.bit_terms "qiskit.quantum_info.SparseObservable.bit_terms") and [`indices`](#qiskit.quantum_info.SparseObservable.indices "qiskit.quantum_info.SparseObservable.indices") respectively. [`boundaries`](#qiskit.quantum_info.SparseObservable.boundaries "qiskit.quantum_info.SparseObservable.boundaries") always has an explicit 0 as its first element. | - - The length parameter $t$ is the number of terms in the sum, and the parameter $s$ is the total number of non-identity single-qubit terms. - - As illustrative examples: - - * in the case of a zero operator, [`boundaries`](#qiskit.quantum_info.SparseObservable.boundaries "qiskit.quantum_info.SparseObservable.boundaries") is length 1 (a single 0) and all other vectors are empty. - * in the case of a fully simplified identity operator, [`boundaries`](#qiskit.quantum_info.SparseObservable.boundaries "qiskit.quantum_info.SparseObservable.boundaries") is `[0, 0]`, [`coeffs`](#qiskit.quantum_info.SparseObservable.coeffs "qiskit.quantum_info.SparseObservable.coeffs") has a single entry, and [`bit_terms`](#qiskit.quantum_info.SparseObservable.bit_terms "qiskit.quantum_info.SparseObservable.bit_terms") and [`indices`](#qiskit.quantum_info.SparseObservable.indices "qiskit.quantum_info.SparseObservable.indices") are empty. - * for the operator $Z_2 Z_0 - X_3 Y_1$, [`boundaries`](#qiskit.quantum_info.SparseObservable.boundaries "qiskit.quantum_info.SparseObservable.boundaries") is `[0, 2, 4]`, [`coeffs`](#qiskit.quantum_info.SparseObservable.coeffs "qiskit.quantum_info.SparseObservable.coeffs") is `[1.0, -1.0]`, [`bit_terms`](#qiskit.quantum_info.SparseObservable.bit_terms "qiskit.quantum_info.SparseObservable.bit_terms") is `[BitTerm.Z, BitTerm.Z, BitTerm.Y, BitTerm.X]` and [`indices`](#qiskit.quantum_info.SparseObservable.indices "qiskit.quantum_info.SparseObservable.indices") is `[0, 2, 1, 3]`. The operator might act on more than four qubits, depending on the [`num_qubits`](#qiskit.quantum_info.SparseObservable.num_qubits "qiskit.quantum_info.SparseObservable.num_qubits") parameter. The [`bit_terms`](#qiskit.quantum_info.SparseObservable.bit_terms "qiskit.quantum_info.SparseObservable.bit_terms") are integer values, whose magic numbers can be accessed via the [`BitTerm`](#qiskit.quantum_info.SparseObservable.BitTerm "qiskit.quantum_info.SparseObservable.BitTerm") attribute class. Note that the single-bit terms and indices are sorted into termwise sorted order. This is a requirement of the class. - - These cases are not special, they’re fully consistent with the rules and should not need special handling. - - The scalar item of the [`bit_terms`](#qiskit.quantum_info.SparseObservable.bit_terms "qiskit.quantum_info.SparseObservable.bit_terms") array is stored as a numeric byte. The numeric values are related to the symplectic Pauli representation that [`SparsePauliOp`](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp") uses, and are accessible with named access by an enumeration: - - ### BitTerm - - - An [`IntEnum`](https://docs.python.org/3/library/enum.html#enum.IntEnum "(in Python v3.13)") that provides named access to the numerical values used to represent each of the single-qubit alphabet terms enumerated in [Alphabet of single-qubit terms used in SparseObservable](#sparse-observable-alphabet). - - This class is attached to [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable"). Access it as [`SparseObservable.BitTerm`](#qiskit.quantum_info.SparseObservable.BitTerm "qiskit.quantum_info.SparseObservable.BitTerm"). If this is too much typing, and you are solely dealing with :class:¬SparseObservable\` objects and the `BitTerm` name is not ambiguous, you might want to shorten it as: - - ```python - >>> ops = SparseObservable.BitTerm - >>> assert ops.X is SparseObservable.BitTerm.X - ``` - - You can access all the values of the enumeration by either their full all-capitals name, or by their single-letter label. The single-letter labels are not generally valid Python identifiers, so you must use indexing notation to access them: - - ```python - >>> assert SparseObservable.BitTerm.ZERO is SparseObservable.BitTerm["0"] - ``` - - The numeric structure of these is that they are all four-bit values of which the low two bits are the (phase-less) symplectic representation of the Pauli operator related to the object, where the low bit denotes a contribution by $Z$ and the second lowest a contribution by $X$, while the upper two bits are `00` for a Pauli operator, `01` for the negative-eigenstate projector, and `10` for the positive-eigenstate projector. - - #### X - - - The Pauli $X$ operator. Uses the single-letter label `"X"`. - - - #### PLUS - - - The projector to the positive eigenstate of the $X$ operator: $\lvert+\rangle\langle+\rvert$. Uses the single-letter label `"+"`. - - - #### MINUS - - - The projector to the negative eigenstate of the $X$ operator: $\lvert-\rangle\langle-\rvert$. Uses the single-letter label `"-"`. - - - #### Y - - - The Pauli $Y$ operator. Uses the single-letter label `"Y"`. - - - #### RIGHT - - - The projector to the positive eigenstate of the $Y$ operator: $\lvert r\rangle\langle r\rvert$. Uses the single-letter label `"r"`. - - - #### LEFT - - - The projector to the negative eigenstate of the $Y$ operator: $\lvert l\rangle\langle l\rvert$. Uses the single-letter label `"l"`. - - - #### Z - - - The Pauli $Z$ operator. Uses the single-letter label `"Z"`. - - - #### ZERO - - - The projector to the positive eigenstate of the $Z$ operator: $\lvert0\rangle\langle0\rvert$. Uses the single-letter label `"0"`. - - - #### ONE - - - The projector to the negative eigenstate of the $Z$ operator: $\lvert1\rangle\langle1\rvert$. Uses the single-letter label `"1"`. - - - - Each of the array-like attributes behaves like a Python sequence. You can index and slice these with standard [`list`](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.13)")-like semantics. Slicing an attribute returns a Numpy [`ndarray`](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v2.1)") containing a copy of the relevant data with the natural `dtype` of the field; this lets you easily do mathematics on the results, like bitwise operations on [`bit_terms`](#qiskit.quantum_info.SparseObservable.bit_terms "qiskit.quantum_info.SparseObservable.bit_terms"). You can assign to indices or slices of each of the attributes, but beware that you must uphold [the data coherence rules](#sparse-observable-arrays) while doing this. For example: - - ```python - >>> obs = SparseObservable.from_list([("XZY", 1.5j), ("+1r", -0.5)]) - >>> assert isinstance(obs.coeffs[:], np.ndarray) - >>> # Reduce all single-qubit terms to the relevant Pauli operator, if they are a projector. - >>> obs.bit_terms[:] = obs.bit_terms[:] & 0b00_11 - >>> assert obs == SparseObservable.from_list([("XZY", 1.5j), ("XZY", -0.5)]) - ``` - - - - ### Canonical ordering - - For any given mathematical observable, there are several ways of representing it with [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable"). For example, the same set of single-bit terms and their corresponding indices might appear multiple times in the observable. Mathematically, this is equivalent to having only a single term with all the coefficients summed. Similarly, the terms of the sum in a [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable") can be in any order while representing the same observable, since addition is commutative (although while floating-point addition is not associative, [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable") makes no guarantees about the summation order). - - These two categories of representation degeneracy can cause the `==` operator to claim that two observables are not equal, despite representating the same object. In these cases, it can be convenient to define some *canonical form*, which allows observables to be compared structurally. - - You can put a [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable") in canonical form by using the [`simplify()`](#qiskit.quantum_info.SparseObservable.simplify "qiskit.quantum_info.SparseObservable.simplify") method. The precise ordering of terms in canonical ordering is not specified, and may change between versions of Qiskit. Within the same version of Qiskit, however, you can compare two observables structurally by comparing their simplified forms. - - - If you wish to account for floating-point tolerance in the comparison, it is safest to use a recipe such as: - - ```python - def equivalent(left, right, tol): - return (left - right).simplify(tol) == SparseObservable.zero(left.num_qubits) - ``` - - - - The canonical form produced by [`simplify()`](#qiskit.quantum_info.SparseObservable.simplify "qiskit.quantum_info.SparseObservable.simplify") will still not universally detect all observables that are equivalent due to the over-complete basis alphabet; it is not computationally feasible to do this at scale. For example, on observable built from `+` and `-` components will not canonicalize to a single `X` term. - - - ## Construction - - [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable") defines several constructors. The default constructor will attempt to delegate to one of the more specific constructors, based on the type of the input. You can always use the specific constructors to have more control over the construction. - - - - | Method | Summary | - | -------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - | [`from_label()`](#qiskit.quantum_info.SparseObservable.from_label "qiskit.quantum_info.SparseObservable.from_label") | Convert a dense string label into a single-term [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable"). | - | [`from_list()`](#qiskit.quantum_info.SparseObservable.from_list "qiskit.quantum_info.SparseObservable.from_list") | Sum a list of tuples of dense string labels and the associated coefficients into an observable. | - | [`from_sparse_list()`](#qiskit.quantum_info.SparseObservable.from_sparse_list "qiskit.quantum_info.SparseObservable.from_sparse_list") | Sum a list of tuples of sparse string labels, the qubits they apply to, and their coefficients into an observable. | - | [`from_pauli()`](#qiskit.quantum_info.SparseObservable.from_pauli "qiskit.quantum_info.SparseObservable.from_pauli") | Raise a single [`Pauli`](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli") into a single-term [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable"). | - | [`from_sparse_pauli_op()`](#qiskit.quantum_info.SparseObservable.from_sparse_pauli_op "qiskit.quantum_info.SparseObservable.from_sparse_pauli_op") | Raise a [`SparsePauliOp`](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp") into a [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable"). | - | [`from_raw_parts()`](#qiskit.quantum_info.SparseObservable.from_raw_parts "qiskit.quantum_info.SparseObservable.from_raw_parts") | Build the observable from [the raw data arrays](#sparse-observable-arrays). | - - ### \_\_new\_\_ - - - The default constructor of [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable"). - - This delegates to one of [the explicit conversion-constructor methods](#sparse-observable-convert-constructors), based on the type of the `data` argument. If `num_qubits` is supplied and constructor implied by the type of `data` does not accept a number, the given integer must match the input. - - **Parameters** - - * **data** – The data type of the input. This can be another [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable"), in which case the input is copied, a [`Pauli`](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli") or [`SparsePauliOp`](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp"), in which case [`from_pauli()`](#qiskit.quantum_info.SparseObservable.from_pauli "qiskit.quantum_info.SparseObservable.from_pauli") or [`from_sparse_pauli_op()`](#qiskit.quantum_info.SparseObservable.from_sparse_pauli_op "qiskit.quantum_info.SparseObservable.from_sparse_pauli_op") are called as appropriate, or it can be a list in a valid format for either [`from_list()`](#qiskit.quantum_info.SparseObservable.from_list "qiskit.quantum_info.SparseObservable.from_list") or [`from_sparse_list()`](#qiskit.quantum_info.SparseObservable.from_sparse_list "qiskit.quantum_info.SparseObservable.from_sparse_list"). - * **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")*|None*) – Optional number of qubits for the operator. For most data inputs, this can be inferred and need not be passed. It is only necessary for empty lists or the sparse-list format. If given unnecessarily, it must match the data input. - - - In addition to the conversion-based constructors, there are also helper methods that construct special forms of observables. - - | Method | Summary | - | -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- | - | [`zero()`](#qiskit.quantum_info.SparseObservable.zero "qiskit.quantum_info.SparseObservable.zero") | The zero operator on a given number of qubits. | - | [`identity()`](#qiskit.quantum_info.SparseObservable.identity "qiskit.quantum_info.SparseObservable.identity") | The identity operator on a given number of qubits. | - - ## Mathematical manipulation - - [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable") supports the standard set of Python mathematical operators like other [`quantum_info`](quantum_info#module-qiskit.quantum_info "qiskit.quantum_info") operators. - - In basic arithmetic, you can: - - * add two observables using `+` - * subtract two observables using `-` - * multiply or divide by an [`int`](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)"), [`float`](https://docs.python.org/3/library/functions.html#float "(in Python v3.13)") or [`complex`](https://docs.python.org/3/library/functions.html#complex "(in Python v3.13)") using `*` and `/` - * negate all the coefficients in an observable with unary `-` - - Each of the basic binary arithmetic operators has a corresponding specialized in-place method, which mutates the left-hand side in-place. Using these is typically more efficient than the infix operators, especially for building an observable in a loop. - - The tensor product is calculated with [`tensor()`](#qiskit.quantum_info.SparseObservable.tensor "qiskit.quantum_info.SparseObservable.tensor") (for standard, juxtaposition ordering of Pauli labels) or [`expand()`](#qiskit.quantum_info.SparseObservable.expand "qiskit.quantum_info.SparseObservable.expand") (for the reverse order). The `^` operator is overloaded to be equivalent to [`tensor()`](#qiskit.quantum_info.SparseObservable.tensor "qiskit.quantum_info.SparseObservable.tensor"). - - - When using the binary operators `^` ([`tensor()`](#qiskit.quantum_info.SparseObservable.tensor "qiskit.quantum_info.SparseObservable.tensor")) and `&` (`compose()`), beware that [Python’s operator-precedence rules](https://docs.python.org/3/reference/expressions.html#operator-precedence) may cause the evaluation order to be different to your expectation. In particular, the operator `+` binds more tightly than `^` or `&`, just like `*` binds more tightly than `+`. - - When using the operators in mixed expressions, it is safest to use parentheses to group the operands of tensor products. - - - A [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable") has a well-defined [`adjoint()`](#qiskit.quantum_info.SparseObservable.adjoint "qiskit.quantum_info.SparseObservable.adjoint"). The notions of scalar complex conjugation ([`conjugate()`](#qiskit.quantum_info.SparseObservable.conjugate "qiskit.quantum_info.SparseObservable.conjugate")) and real-value transposition ([`transpose()`](#qiskit.quantum_info.SparseObservable.transpose "qiskit.quantum_info.SparseObservable.transpose")) are defined analogously to the matrix representation of other Pauli operators in Qiskit. - - ### Efficiency notes - - Internally, [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable") is in-place mutable, including using over-allocating growable vectors for extending the number of terms. This means that the cost of appending to an observable using `+=` is amortised linear in the total number of terms added, rather than the quadratic complexity that the binary `+` would require. - - Additions and subtractions are implemented by a term-stacking operation; there is no automatic “simplification” (summing of like terms), because the majority of additions to build up an observable generate only a small number of duplications, and like-term detection has additional costs. If this does not fit your use cases, you can either periodically call [`simplify()`](#qiskit.quantum_info.SparseObservable.simplify "qiskit.quantum_info.SparseObservable.simplify"), or discuss further APIs with us for better building of observables. - - ## Attributes - - #### bit\_terms - - - A flat list of single-qubit terms. This is more naturally a list of lists, but is stored flat for memory usage and locality reasons, with the sublists denoted by boundaries. - - - #### boundaries - - - Indices that partition [`bit_terms`](#qiskit.quantum_info.SparseObservable.bit_terms "qiskit.quantum_info.SparseObservable.bit_terms") and [`indices`](#qiskit.quantum_info.SparseObservable.indices "qiskit.quantum_info.SparseObservable.indices") into sublists for each individual term in the sum. `boundaries[0] : boundaries[1]` is the range of indices into [`bit_terms`](#qiskit.quantum_info.SparseObservable.bit_terms "qiskit.quantum_info.SparseObservable.bit_terms") and [`indices`](#qiskit.quantum_info.SparseObservable.indices "qiskit.quantum_info.SparseObservable.indices") that correspond to the first term of the sum. All unspecified qubit indices are implicitly the identity. This is one item longer than [`coeffs`](#qiskit.quantum_info.SparseObservable.coeffs "qiskit.quantum_info.SparseObservable.coeffs"), since `boundaries[0]` is always an explicit zero (for algorithmic ease). - - - #### coeffs - - - The coefficients of each abstract term in in the sum. This has as many elements as terms in the sum. - - - #### indices - - - A flat list of the qubit indices that the corresponding entries in [`bit_terms`](#qiskit.quantum_info.SparseObservable.bit_terms "qiskit.quantum_info.SparseObservable.bit_terms") act on. This list must always be term-wise sorted, where a term is a sublist as denoted by [`boundaries`](#qiskit.quantum_info.SparseObservable.boundaries "qiskit.quantum_info.SparseObservable.boundaries"). - - - If writing to this attribute from Python space, you *must* ensure that you only write in indices that are term-wise sorted. - - - - #### num\_qubits - - - The number of qubits the operator acts on. - - This is not inferable from any other shape or values, since identities are not stored explicitly. - - - #### num\_terms - - - The number of terms in the sum this operator is tracking. - - - ## Methods - - #### adjoint - - - Calculate the adjoint of this observable. - - This is well defined in the abstract mathematical sense. All the terms of the single-qubit alphabet are self-adjoint, so the result of this operation is the same observable, except its coefficients are all their complex conjugates. - - **Examples** - - ```python - >>> left = SparseObservable.from_list([("XY+-", 1j)]) - >>> right = SparseObservable.from_list([("XY+-", -1j)]) - >>> assert left.adjoint() == right - ``` - - - #### apply\_layout - - - Apply a transpiler layout to this [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable"). - - Typically you will have defined your observable in terms of the virtual qubits of the circuits you will use to prepare states. After transpilation, the virtual qubits are mapped to particular physical qubits on a device, which may be wider than your circuit. That mapping can also change over the course of the circuit. This method transforms the input observable on virtual qubits to an observable that is suitable to apply immediately after the fully transpiled *physical* circuit. - - **Parameters** - - * **layout** ([*TranspileLayout*](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout") *|*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.13)")*\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")*] | None*) – The layout to apply. Most uses of this function should pass the [`QuantumCircuit.layout`](qiskit.circuit.QuantumCircuit#layout "qiskit.circuit.QuantumCircuit.layout") field from a circuit that was transpiled for hardware. In addition, you can pass a list of new qubit indices. If given as explicitly `None`, no remapping is applied (but you can still use `num_qubits` to expand the observable). - * **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)") *| None*) – The number of qubits to expand the observable to. If not supplied, the output will be as wide as the given [`TranspileLayout`](qiskit.transpiler.TranspileLayout "qiskit.transpiler.TranspileLayout"), or the same width as the input if the `layout` is given in another form. - - **Returns** - - A new [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable") with the provided layout applied. - - - #### clear - - - Clear all the terms from this operator, making it equal to the zero operator again. - - This does not change the capacity of the internal allocations, so subsequent addition or substraction operations may not need to reallocate. - - **Examples** - - ```python - >>> obs = SparseObservable.from_list([("IX+-rl", 2.0), ("01YZII", -1j)]) - >>> obs.clear() - >>> assert obs == SparseObservable.zero(obs.num_qubits) - ``` - - - #### conjugate - - - Calculate the complex conjugation of this observable. - - This operation is defined in terms of the standard matrix conventions of Qiskit, in that the matrix form is taken to be in the \$Z\$ computational basis. The \$X\$- and \$Z\$-related alphabet terms are unaffected by the complex conjugation, but \$Y\$-related terms modify their alphabet terms. Precisely: - - * $Y$ conjguates to $-Y$ - * $\lvert r\rangle\langle r\rvert$ conjugates to $\lvert l\rangle\langle l\rvert$ - * $\lvert l\rangle\langle l\rvert$ conjugates to $\lvert r\rangle\langle r\rvert$ - - Additionally, all coefficients are conjugated. - - **Examples** - - ```python - >>> obs = SparseObservable([("III", 1j), ("Yrl", 0.5)]) - >>> assert obs.conjugate() == SparseObservable([("III", -1j), ("Ylr", -0.5)]) - ``` - - - #### copy - - - Get a copy of this observable. - - **Examples** - - ```python - >>> obs = SparseObservable.from_list([("IXZ+lr01", 2.5), ("ZXI-rl10", 0.5j)]) - >>> assert obs == obs.copy() - >>> assert obs is not obs.copy() - ``` - - - #### expand - - - Reverse-order tensor product. - - This is equivalent to `other.tensor(self)`, except that `other` will first be type-cast to [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable") if it isn’t already one (by calling the default constructor). - - **Parameters** - - **other** – the observable to put on the left-hand side of the tensor product. - - **Examples** - - This is equivalent to [`tensor()`](#qiskit.quantum_info.SparseObservable.tensor "qiskit.quantum_info.SparseObservable.tensor") with the order of the arguments flipped: - - ```python - >>> left = SparseObservable.from_label("XYZ") - >>> right = SparseObservable.from_label("+-IIrl") - >>> assert left.tensor(right) == right.expand(left) - ``` - - - [`tensor()`](#qiskit.quantum_info.SparseObservable.tensor "qiskit.quantum_info.SparseObservable.tensor") - - > The same function with the order of arguments flipped. [`tensor()`](#qiskit.quantum_info.SparseObservable.tensor "qiskit.quantum_info.SparseObservable.tensor") is the more standard argument ordering, and matches Qiskit’s other conventions. - - - - #### from\_label - - - Construct a single-term observable from a dense string label. - - The resulting operator will have a coefficient of 1. The label must be a sequence of the alphabet `'IXYZ+-rl01'`. The label is interpreted analogously to a bitstring. In other words, the right-most letter is associated with qubit 0, and so on. This is the same as the labels for [`Pauli`](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli") and [`SparsePauliOp`](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp"). - - **Parameters** - - **label** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.13)")) – the dense label. - - **Examples** - - ```python - >>> SparseObservable.from_label("IIII+ZI") - - >>> label = "IYXZI" - >>> pauli = Pauli(label) - >>> assert SparseObservable.from_label(label) == SparseObservable.from_pauli(pauli) - ``` - - - **[`from_list()`](#qiskit.quantum_info.SparseObservable.from_list "qiskit.quantum_info.SparseObservable.from_list")** - - A generalization of this method that constructs a sum operator from multiple labels and their corresponding coefficients. - - - - #### from\_list - - - Construct an observable from a list of dense labels and coefficients. - - This is analogous to [`SparsePauliOp.from_list()`](qiskit.quantum_info.SparsePauliOp#from_list "qiskit.quantum_info.SparsePauliOp.from_list"), except it uses [the extended alphabet](#sparse-observable-alphabet) of [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable"). In this dense form, you must supply all identities explicitly in each label. - - The label must be a sequence of the alphabet `'IXYZ+-rl01'`. The label is interpreted analogously to a bitstring. In other words, the right-most letter is associated with qubit 0, and so on. This is the same as the labels for [`Pauli`](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli") and [`SparsePauliOp`](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp"). - - **Parameters** - - * **iter** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.13)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.13)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.13)")*,* [*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.13)")*]]*) – Pairs of labels and their associated coefficients to sum. The labels are interpreted the same way as in [`from_label()`](#qiskit.quantum_info.SparseObservable.from_label "qiskit.quantum_info.SparseObservable.from_label"). - * **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)") *| None*) – It is not necessary to specify this if you are sure that `iter` is not an empty sequence, since it can be inferred from the label lengths. If `iter` may be empty, you must specify this argument to disambiguate how many qubits the observable is for. If this is given and `iter` is not empty, the value must match the label lengths. - - **Examples** - - Construct an observable from a list of labels of the same length: - - ```python - >>> SparseObservable.from_list([ - ... ("III++", 1.0), - ... ("II--I", 1.0j), - ... ("I++II", -0.5), - ... ("--III", -0.25j), - ... ]) - - ``` - - Use `num_qubits` to disambiguate potentially empty inputs: - - ```python - >>> SparseObservable.from_list([], num_qubits=10) - - ``` - - This method is equivalent to calls to [`from_sparse_list()`](#qiskit.quantum_info.SparseObservable.from_sparse_list "qiskit.quantum_info.SparseObservable.from_sparse_list") with the explicit qubit-arguments field set to decreasing integers: - - ```python - >>> labels = ["XY+Z", "rl01", "-lXZ"] - >>> coeffs = [1.5j, 2.0, -0.5] - >>> from_list = SparseObservable.from_list(list(zip(labels, coeffs))) - >>> from_sparse_list = SparseObservable.from_sparse_list([ - ... (label, (3, 2, 1, 0), coeff) - ... for label, coeff in zip(labels, coeffs) - ... ]) - >>> assert from_list == from_sparse_list - ``` - - - **[`from_label()`](#qiskit.quantum_info.SparseObservable.from_label "qiskit.quantum_info.SparseObservable.from_label")** - - A similar constructor, but takes only a single label and always has its coefficient set to `1.0`. - - **[`from_sparse_list()`](#qiskit.quantum_info.SparseObservable.from_sparse_list "qiskit.quantum_info.SparseObservable.from_sparse_list")** - - Construct the observable from a list of labels without explicit identities, but with the qubits each single-qubit term applies to listed explicitly. - - - - #### from\_pauli - - - Construct a [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable") from a single [`Pauli`](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli") instance. - - The output observable will have a single term, with a unitary coefficient dependent on the phase. - - **Parameters** - - **pauli** ([`Pauli`](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli")) – the single Pauli to convert. - - **Examples** - - ```python - >>> label = "IYXZI" - >>> pauli = Pauli(label) - >>> SparseObservable.from_pauli(pauli) - - >>> assert SparseObservable.from_label(label) == SparseObservable.from_pauli(pauli) - ``` - - - #### from\_raw\_parts - - - Construct a [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable") from raw Numpy arrays that match [the required data representation described in the class-level documentation](#sparse-observable-arrays). - - The data from each array is copied into fresh, growable Rust-space allocations. - - **Parameters** - - * **num\_qubits** – number of qubits in the observable. - - * **coeffs** – complex coefficients of each term of the observable. This should be a Numpy array with dtype [`complex128`](https://numpy.org/doc/stable/reference/arrays.scalars.html#numpy.complex128 "(in NumPy v2.1)"). - - * **bit\_terms** – flattened list of the single-qubit terms comprising all complete terms. This should be a Numpy array with dtype [`uint8`](https://numpy.org/doc/stable/reference/arrays.scalars.html#numpy.uint8 "(in NumPy v2.1)") (which is compatible with [`BitTerm`](#qiskit.quantum_info.SparseObservable.BitTerm "qiskit.quantum_info.SparseObservable.BitTerm")). - - * **indices** – flattened term-wise sorted list of the qubits each single-qubit term corresponds to. This should be a Numpy array with dtype [`uint32`](https://numpy.org/doc/stable/reference/arrays.scalars.html#numpy.uint32 "(in NumPy v2.1)"). - - * **boundaries** – the indices that partition `bit_terms` and `indices` into terms. This should be a Numpy array with dtype [`uintp`](https://numpy.org/doc/stable/reference/arrays.scalars.html#numpy.uintp "(in NumPy v2.1)"). - - * **check** – - - if `True` (the default), validate that the data satisfies all coherence guarantees. If `False`, no checks are done. - - - If `check=False`, the `bit_terms` absolutely *must* be all be valid values of [`SparseObservable.BitTerm`](#qiskit.quantum_info.SparseObservable.BitTerm "qiskit.quantum_info.SparseObservable.BitTerm"). If they are not, Rust-space undefined behavior may occur, entirely invalidating the program execution. - - - **Examples** - - Construct a sum of $Z$ on each individual qubit: - - ```python - >>> num_qubits = 100 - >>> terms = np.full((num_qubits,), SparseObservable.BitTerm.Z, dtype=np.uint8) - >>> indices = np.arange(num_qubits, dtype=np.uint32) - >>> coeffs = np.ones((num_qubits,), dtype=complex) - >>> boundaries = np.arange(num_qubits + 1, dtype=np.uintp) - >>> SparseObservable.from_raw_parts(num_qubits, coeffs, terms, indices, boundaries) - - ``` - - - #### from\_sparse\_list - - - Construct an observable from a list of labels, the qubits each item applies to, and the coefficient of the whole term. - - This is analogous to [`SparsePauliOp.from_sparse_list()`](qiskit.quantum_info.SparsePauliOp#from_sparse_list "qiskit.quantum_info.SparsePauliOp.from_sparse_list"), except it uses [the extended alphabet](#sparse-observable-alphabet) of [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable"). - - The “labels” and “indices” fields of the triples are associated by zipping them together. For example, this means that a call to [`from_list()`](#qiskit.quantum_info.SparseObservable.from_list "qiskit.quantum_info.SparseObservable.from_list") can be converted to the form used by this method by setting the “indices” field of each triple to `(num_qubits-1, ..., 1, 0)`. - - **Parameters** - - * **iter** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.13)")*\[*[*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple "(in Python v3.13)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.13)")*, Sequence\[*[*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")*],* [*complex*](https://docs.python.org/3/library/functions.html#complex "(in Python v3.13)")*]]*) – triples of labels, the qubits each single-qubit term applies to, and the coefficient of the entire term. - * **num\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")) – the number of qubits in the operator. - - **Examples** - - Construct a simple operator: - - ```python - >>> SparseObservable.from_sparse_list( - ... [("ZX", (1, 4), 1.0), ("YY", (0, 3), 2j)], - ... num_qubits=5, - ... ) - - ``` - - Construct the identity observable (though really, just use [`identity()`](#qiskit.quantum_info.SparseObservable.identity "qiskit.quantum_info.SparseObservable.identity")): - - ```python - >>> SparseObservable.from_sparse_list([("", (), 1.0)], num_qubits=100) - - ``` - - This method can replicate the behavior of [`from_list()`](#qiskit.quantum_info.SparseObservable.from_list "qiskit.quantum_info.SparseObservable.from_list"), if the qubit-arguments field of the triple is set to decreasing integers: - - ```python - >>> labels = ["XY+Z", "rl01", "-lXZ"] - >>> coeffs = [1.5j, 2.0, -0.5] - >>> from_list = SparseObservable.from_list(list(zip(labels, coeffs))) - >>> from_sparse_list = SparseObservable.from_sparse_list([ - ... (label, (3, 2, 1, 0), coeff) - ... for label, coeff in zip(labels, coeffs) - ... ]) - >>> assert from_list == from_sparse_list - ``` - - - #### from\_sparse\_pauli\_op - - - Construct a [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable") from a [`SparsePauliOp`](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp") instance. - - This will be a largely direct translation of the [`SparsePauliOp`](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp"); in particular, there is no on-the-fly summing of like terms, nor any attempt to refactorize sums of Pauli terms into equivalent projection operators. - - **Parameters** - - **op** ([`SparsePauliOp`](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp")) – the operator to convert. - - **Examples** - - ```python - >>> spo = SparsePauliOp.from_list([("III", 1.0), ("IIZ", 0.5), ("IZI", 0.5)]) - >>> SparseObservable.from_sparse_pauli_op(spo) - - ``` - - - #### identity - - - Get the identity operator over the given number of qubits. - - **Examples** - - Get the identity operator for 100 qubits: - - ```python - >>> SparseObservable.identity(100) - - ``` - - - #### simplify - - - Sum any like terms in this operator, removing them if the resulting complex coefficient has an absolute value within tolerance of zero. - - As a side effect, this sorts the operator into [canonical order](#sparse-observable-canonical-order). - - - When using this for equality comparisons, note that floating-point rounding and the non-associativity fo floating-point addition may cause non-zero coefficients of summed terms to compare unequal. To compare two observables up to a tolerance, it is safest to compare the canonicalized difference of the two observables to zero. - - - **Parameters** - - **tol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.13)")) – after summing like terms, any coefficients whose absolute value is less than the given absolute tolerance will be suppressed from the output. - - **Examples** - - Using [`simplify()`](#qiskit.quantum_info.SparseObservable.simplify "qiskit.quantum_info.SparseObservable.simplify") to compare two operators that represent the same observable, but would compare unequal due to the structural tests by default: - - ```python - >>> base = SparseObservable.from_sparse_list([ - ... ("XZ", (2, 1), 1e-10), # value too small - ... ("+-", (3, 1), 2j), - ... ("+-", (3, 1), 2j), # can be combined with the above - ... ("01", (3, 1), 0.5), # out of order compared to `expected` - ... ], num_qubits=5) - >>> expected = SparseObservable.from_list([("I0I1I", 0.5), ("I+I-I", 4j)]) - >>> assert base != expected # non-canonical comparison - >>> assert base.simplify() == expected.simplify() - ``` - - Note that in the above example, the coefficients are chosen such that all floating-point calculations are exact, and there are no intermediate rounding or associativity concerns. If this cannot be guaranteed to be the case, the safer form is: - - ```python - >>> left = SparseObservable.from_list([("XYZ", 1.0/3.0)] * 3) # sums to 1.0 - >>> right = SparseObservable.from_list([("XYZ", 1.0/7.0)] * 7) # doesn't sum to 1.0 - >>> assert left.simplify() != right.simplify() - >>> assert (left - right).simplify() == SparseObservable.zero(left.num_qubits) - ``` - - - #### tensor - - - Tensor product of two observables. - - The bit ordering is defined such that the qubit indices of the argument will remain the same, and the indices of `self` will be offset by the number of qubits in `other`. This is the same convention as used by the rest of Qiskit’s [`quantum_info`](quantum_info#module-qiskit.quantum_info "qiskit.quantum_info") operators. - - This function is used for the infix `^` operator. If using this operator, beware that [Python’s operator-precedence rules](https://docs.python.org/3/reference/expressions.html#operator-precedence) may cause the evaluation order to be different to your expectation. In particular, the operator `+` binds more tightly than `^`, just like `*` binds more tightly than `+`. Use parentheses to fix the evaluation order, if needed. - - The argument will be cast to [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable") using its default constructor, if it is not already in the correct form. - - **Parameters** - - **other** – the observable to put on the right-hand side of the tensor product. - - **Examples** - - The bit ordering of this is such that the tensor product of two observables made from a single label “looks like” an observable made by concatenating the two strings: - - ```python - >>> left = SparseObservable.from_label("XYZ") - >>> right = SparseObservable.from_label("+-IIrl") - >>> assert left.tensor(right) == SparseObservable.from_label("XYZ+-IIrl") - ``` - - You can also use the infix `^` operator for tensor products, which will similarly cast the right-hand side of the operation if it is not already a [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable"): - - ```python - >>> assert SparseObservable("rl") ^ Pauli("XYZ") == SparseObservable("rlXYZ") - ``` - - - [`expand()`](#qiskit.quantum_info.SparseObservable.expand "qiskit.quantum_info.SparseObservable.expand") - - > The same function, but with the order of arguments flipped. This can be useful if you like using the casting behavior for the argument, but you want your existing [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable") to be on the right-hand side of the tensor ordering. - - - - #### transpose - - - Calculate the matrix transposition of this observable. - - This operation is defined in terms of the standard matrix conventions of Qiskit, in that the matrix form is taken to be in the \$Z\$ computational basis. The \$X\$- and \$Z\$-related alphabet terms are unaffected by the transposition, but \$Y\$-related terms modify their alphabet terms. Precisely: - - * $Y$ transposes to $-Y$ - * $\lvert r\rangle\langle r\rvert$ transposes to $\lvert l\rangle\langle l\rvert$ - * $\lvert l\rangle\langle l\rvert$ transposes to $\lvert r\rangle\langle r\rvert$ - - **Examples** - - ```python - >>> obs = SparseObservable([("III", 1j), ("Yrl", 0.5)]) - >>> assert obs.transpose() == SparseObservable([("III", 1j), ("Ylr", -0.5)]) - ``` - - - #### zero - - - Get the zero operator over the given number of qubits. - - The zero operator is the operator whose expectation value is zero for all quantum states. It has no terms. It is the identity element for addition of two [`SparseObservable`](#qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable") instances; anything added to the zero operator is equal to itself. - - If you want the projector onto the all zeros state, use: - - ```python - >>> num_qubits = 10 - >>> all_zeros = SparseObservable.from_label("0" * num_qubits) - ``` - - **Examples** - - Get the zero operator for 100 qubits: - - ```python - >>> SparseObservable.zero(100) - - ``` - - - diff --git a/docs/api/qiskit/dev/qiskit.quantum_info.SparsePauliOp.mdx b/docs/api/qiskit/dev/qiskit.quantum_info.SparsePauliOp.mdx index 68961aa6db9..09f866b8c20 100644 --- a/docs/api/qiskit/dev/qiskit.quantum_info.SparsePauliOp.mdx +++ b/docs/api/qiskit/dev/qiskit.quantum_info.SparsePauliOp.mdx @@ -191,7 +191,7 @@ python_api_name: qiskit.quantum_info.SparsePauliOp print(srt) ``` - ```text + ```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]) @@ -707,7 +707,7 @@ $$ print(srt) ``` - ```text + ```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]) diff --git a/docs/api/qiskit/dev/qiskit.quantum_info.StabilizerState.mdx b/docs/api/qiskit/dev/qiskit.quantum_info.StabilizerState.mdx index 70c8b68c350..cc96c7b3e6c 100644 --- a/docs/api/qiskit/dev/qiskit.quantum_info.StabilizerState.mdx +++ b/docs/api/qiskit/dev/qiskit.quantum_info.StabilizerState.mdx @@ -33,7 +33,7 @@ python_api_name: qiskit.quantum_info.StabilizerState print (stab.expectation_value(Pauli('ZZ'))) ``` - ```text + ```python StabilizerState(StabilizerTable: ['+XX', '+ZZ']) {'00': 0.5, '11': 0.5} 1 diff --git a/docs/api/qiskit/dev/qiskit.quantum_info.Statevector.mdx b/docs/api/qiskit/dev/qiskit.quantum_info.Statevector.mdx index bafc4d54407..56b76e140cb 100644 --- a/docs/api/qiskit/dev/qiskit.quantum_info.Statevector.mdx +++ b/docs/api/qiskit/dev/qiskit.quantum_info.Statevector.mdx @@ -404,7 +404,7 @@ python_api_name: qiskit.quantum_info.Statevector print('Qubit-1 probs: {}'.format(probs_qubit_1)) ``` - ```text + ```python probs: [0.5 0. 0.5 0. ] Qubit-0 probs: [1. 0.] Qubit-1 probs: [0.5 0.5] @@ -427,7 +427,7 @@ python_api_name: qiskit.quantum_info.Statevector print('Swapped probs: {}'.format(probs_swapped)) ``` - ```text + ```python probs: [0.5 0. 0.5 0. ] Swapped probs: [0.5 0.5 0. 0. ] ``` @@ -612,7 +612,7 @@ python_api_name: qiskit.quantum_info.Statevector print(psi.to_dict()) ``` - ```text + ```python {'00': (0.7071067811865475+0j), '10': (-0.7071067811865475+0j)} ``` @@ -629,7 +629,7 @@ python_api_name: qiskit.quantum_info.Statevector print(psi.to_dict()) ``` - ```text + ```python {'00': (0.7071067811865475+0j), '22': (0.7071067811865475+0j)} ``` @@ -646,7 +646,7 @@ python_api_name: qiskit.quantum_info.Statevector print(psi.to_dict()) ``` - ```text + ```python {'00': (0.7071067811865475+0j), '91': (0.7071067811865475+0j)} ``` diff --git a/docs/api/qiskit/dev/qiskit.result.BaseReadoutMitigator.mdx b/docs/api/qiskit/dev/qiskit.result.BaseReadoutMitigator.mdx index 1c5d64542d7..f4ae024e3d2 100644 --- a/docs/api/qiskit/dev/qiskit.result.BaseReadoutMitigator.mdx +++ b/docs/api/qiskit/dev/qiskit.result.BaseReadoutMitigator.mdx @@ -11,7 +11,7 @@ python_api_name: qiskit.result.BaseReadoutMitigator Bases: [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.13)") - This class is DEPRECATED. Base readout error mitigator class. + Base readout error mitigator class. ## Methods diff --git a/docs/api/qiskit/dev/qiskit.result.CorrelatedReadoutMitigator.mdx b/docs/api/qiskit/dev/qiskit.result.CorrelatedReadoutMitigator.mdx index 2d206f5e7f6..0108b72d335 100644 --- a/docs/api/qiskit/dev/qiskit.result.CorrelatedReadoutMitigator.mdx +++ b/docs/api/qiskit/dev/qiskit.result.CorrelatedReadoutMitigator.mdx @@ -8,19 +8,15 @@ python_api_name: qiskit.result.CorrelatedReadoutMitigator # CorrelatedReadoutMitigator - + Bases: [`BaseReadoutMitigator`](qiskit.result.BaseReadoutMitigator "qiskit.result.mitigation.base_readout_mitigator.BaseReadoutMitigator") - This class is DEPRECATED. N-qubit readout error mitigator. + 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 - - The class `qiskit.result.mitigation.correlated_readout_mitigator.CorrelatedReadoutMitigator` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The qiskit.result.mitigation module is deprecated in favor of the [https://github.com/Qiskit/qiskit-addon-mthree](https://github.com/Qiskit/qiskit-addon-mthree) package. - - **Parameters** * **assignment\_matrix** ([*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v2.1)")) – readout error assignment matrix. @@ -48,7 +44,7 @@ python_api_name: qiskit.result.CorrelatedReadoutMitigator ### assignment\_matrix - + 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$. @@ -68,7 +64,7 @@ python_api_name: qiskit.result.CorrelatedReadoutMitigator ### expectation\_value - + 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|$. @@ -96,7 +92,7 @@ python_api_name: qiskit.result.CorrelatedReadoutMitigator ### mitigation\_matrix - + 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$. @@ -116,7 +112,7 @@ python_api_name: qiskit.result.CorrelatedReadoutMitigator ### quasi\_probabilities - + Compute mitigated quasi probabilities value. **Parameters** @@ -139,7 +135,7 @@ python_api_name: qiskit.result.CorrelatedReadoutMitigator ### stddev\_upper\_bound - + Return an upper bound on standard deviation of expval estimator. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.result.LocalReadoutMitigator.mdx b/docs/api/qiskit/dev/qiskit.result.LocalReadoutMitigator.mdx index d660bdb4bcc..c6a97ca137d 100644 --- a/docs/api/qiskit/dev/qiskit.result.LocalReadoutMitigator.mdx +++ b/docs/api/qiskit/dev/qiskit.result.LocalReadoutMitigator.mdx @@ -8,19 +8,15 @@ python_api_name: qiskit.result.LocalReadoutMitigator # LocalReadoutMitigator - + Bases: [`BaseReadoutMitigator`](qiskit.result.BaseReadoutMitigator "qiskit.result.mitigation.base_readout_mitigator.BaseReadoutMitigator") - This class is DEPRECATED. 1-qubit tensor product readout error mitigator. + 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 - - The class `qiskit.result.mitigation.local_readout_mitigator.LocalReadoutMitigator` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The qiskit.result.mitigation module is deprecated in favor of the [https://github.com/Qiskit/qiskit-addon-mthree](https://github.com/Qiskit/qiskit-addon-mthree) package. - - **Parameters** * **assignment\_matrices** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.13)")*\[*[*ndarray*](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v2.1)")*] | None*) – Optional, list of single-qubit readout error assignment matrices. @@ -49,7 +45,7 @@ python_api_name: qiskit.result.LocalReadoutMitigator ### assignment\_matrix - + 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$. @@ -69,7 +65,7 @@ python_api_name: qiskit.result.LocalReadoutMitigator ### expectation\_value - + 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|$. @@ -97,7 +93,7 @@ python_api_name: qiskit.result.LocalReadoutMitigator ### mitigation\_matrix - + 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$. @@ -117,7 +113,7 @@ python_api_name: qiskit.result.LocalReadoutMitigator ### quasi\_probabilities - + Compute mitigated quasi probabilities value. **Parameters** @@ -144,7 +140,7 @@ python_api_name: qiskit.result.LocalReadoutMitigator ### stddev\_upper\_bound - + Return an upper bound on standard deviation of expval estimator. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.synthesis.unitary.aqc.ApproximateCircuit.mdx b/docs/api/qiskit/dev/qiskit.synthesis.unitary.aqc.ApproximateCircuit.mdx index 63345c829f0..65465f74bb8 100644 --- a/docs/api/qiskit/dev/qiskit.synthesis.unitary.aqc.ApproximateCircuit.mdx +++ b/docs/api/qiskit/dev/qiskit.synthesis.unitary.aqc.ApproximateCircuit.mdx @@ -32,10 +32,6 @@ python_api_name: qiskit.synthesis.unitary.aqc.ApproximateCircuit Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.synthesis.unitary.aqc.CNOTUnitCircuit.mdx b/docs/api/qiskit/dev/qiskit.synthesis.unitary.aqc.CNOTUnitCircuit.mdx index e8148553124..38ac8af2aba 100644 --- a/docs/api/qiskit/dev/qiskit.synthesis.unitary.aqc.CNOTUnitCircuit.mdx +++ b/docs/api/qiskit/dev/qiskit.synthesis.unitary.aqc.CNOTUnitCircuit.mdx @@ -38,10 +38,6 @@ python_api_name: qiskit.synthesis.unitary.aqc.CNOTUnitCircuit Return calibration dictionary. The custom pulse definition of a given gate is of the form `{'gate_name': {(qubits, params): schedule}}` - - - The property `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.circuit.quantumcircuit.QuantumCircuit.calibrations` will have no alternative in Qiskit. - ### clbits diff --git a/docs/api/qiskit/dev/qiskit.transpiler.InstructionProperties.mdx b/docs/api/qiskit/dev/qiskit.transpiler.InstructionProperties.mdx index 1e74945e710..e47355da2ce 100644 --- a/docs/api/qiskit/dev/qiskit.transpiler.InstructionProperties.mdx +++ b/docs/api/qiskit/dev/qiskit.transpiler.InstructionProperties.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.transpiler.InstructionProperties # InstructionProperties - + Bases: `BaseInstructionProperties` A representation of the properties of a gate implementation. @@ -17,15 +17,11 @@ python_api_name: qiskit.transpiler.InstructionProperties Create a new `InstructionProperties` object - - `qiskit.transpiler.target.InstructionProperties.__init__()`’s argument `calibration` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and this argument uses a dependency on the package. - - **Parameters** * **duration** – The duration, in seconds, of the instruction on the specified set of qubits * **error** – The average error rate for the instruction on the specified set of qubits. - * **calibration** – DEPRECATED. The pulse representation of the instruction. + * **calibration** – The pulse representation of the instruction. ## Attributes @@ -41,10 +37,6 @@ python_api_name: qiskit.transpiler.InstructionProperties 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. - - - The property `qiskit.transpiler.target.InstructionProperties.calibration` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.transpiler.target.InstructionProperties.calibration` will have no alternative in Qiskit. - ### duration diff --git a/docs/api/qiskit/dev/qiskit.transpiler.Target.mdx b/docs/api/qiskit/dev/qiskit.transpiler.Target.mdx index 080057ce8ef..3cc93515e98 100644 --- a/docs/api/qiskit/dev/qiskit.transpiler.Target.mdx +++ b/docs/api/qiskit/dev/qiskit.transpiler.Target.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.transpiler.Target # Target - + Bases: `BaseTarget` 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. @@ -159,7 +159,7 @@ python_api_name: qiskit.transpiler.Target ### add\_instruction - + 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: @@ -198,7 +198,7 @@ python_api_name: qiskit.transpiler.Target ### build\_coupling\_map - + 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. @@ -226,7 +226,7 @@ python_api_name: qiskit.transpiler.Target ### durations - + Get an InstructionDurations object from the target **Returns** @@ -242,23 +242,19 @@ python_api_name: qiskit.transpiler.Target ### from\_configuration - + 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. - - `qiskit.transpiler.target.Target.from_configuration()`’s argument `inst_map` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and this argument uses a dependency on the package. - - **Parameters** * **basis\_gates** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.13)")*\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.13)")*]*) – 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.13)") *| 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*) – DEPRECATED. 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"). + * **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.13)")) – 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]]`. @@ -283,21 +279,17 @@ python_api_name: qiskit.transpiler.Target ### get - + Gets an item from the Target. If not found return a provided default or None. ### get\_calibration - + 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. - - The method `qiskit.transpiler.target.Target.get_calibration()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.transpiler.target.Target.get_calibration()` will have no alternative in Qiskit. - - **Parameters** * **operation\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.13)")) – The name of the operation for the instruction. @@ -336,13 +328,9 @@ python_api_name: qiskit.transpiler.Target ### has\_calibration - + Return whether the instruction (operation + qubits) defines a calibration. - - The method `qiskit.transpiler.target.Target.has_calibration()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.transpiler.target.Target.has_calibration()` will have no alternative in Qiskit. - - **Parameters** * **operation\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.13)")) – The name of the operation for the instruction. @@ -359,7 +347,7 @@ python_api_name: qiskit.transpiler.Target ### instruction\_properties - + 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: @@ -397,13 +385,9 @@ python_api_name: qiskit.transpiler.Target ### instruction\_schedule\_map - + Return an [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") for the instructions in the target with a pulse schedule defined. - - The method `qiskit.transpiler.target.Target.instruction_schedule_map()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.transpiler.target.Target.instruction_schedule_map()` will have no alternative in Qiskit. - - **Returns** The instruction schedule map for the instructions in this target with a pulse schedule defined. @@ -454,13 +438,13 @@ python_api_name: qiskit.transpiler.Target ### items - + Returns pairs of Gate names and its property map (str, dict\[tuple, InstructionProperties]) ### keys - + Return the keys (operation\_names) of the Target @@ -528,7 +512,7 @@ python_api_name: qiskit.transpiler.Target ### qargs\_for\_operation\_name - + Get the qargs for a given operation name **Parameters** @@ -546,7 +530,7 @@ python_api_name: qiskit.transpiler.Target ### timing\_constraints - + Get an `TimingConstraints` object from the target **Returns** @@ -560,15 +544,11 @@ python_api_name: qiskit.transpiler.Target ### update\_from\_instruction\_schedule\_map - + 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. - - The method `qiskit.transpiler.target.Target.update_from_instruction_schedule_map()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.transpiler.target.Target.update_from_instruction_schedule_map()` will have no alternative in Qiskit. - - **Parameters** * **inst\_map** ([*InstructionScheduleMap*](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap")) – The instruction @@ -596,7 +576,7 @@ python_api_name: qiskit.transpiler.Target ### update\_instruction\_properties - + Update the property object for an instruction qarg pair already in the Target **Parameters** @@ -612,7 +592,7 @@ python_api_name: qiskit.transpiler.Target ### values - + Return the Property Map (qargs -> InstructionProperties) of every instruction in the Target diff --git a/docs/api/qiskit/dev/qiskit.transpiler.passes.AlignMeasures.mdx b/docs/api/qiskit/dev/qiskit.transpiler.passes.AlignMeasures.mdx index b938b80bdce..9c770a1ada6 100644 --- a/docs/api/qiskit/dev/qiskit.transpiler.passes.AlignMeasures.mdx +++ b/docs/api/qiskit/dev/qiskit.transpiler.passes.AlignMeasures.mdx @@ -27,7 +27,7 @@ python_api_name: qiskit.transpiler.passes.AlignMeasures We assume executing the following circuit on a backend with `alignment=16`. - ```text + ```python ┌───┐┌────────────────┐┌─┐ q_0: ┤ X ├┤ Delay(100[dt]) ├┤M├ └───┘└────────────────┘└╥┘ @@ -37,7 +37,7 @@ python_api_name: qiskit.transpiler.passes.AlignMeasures 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. - ```text + ```python ┌───┐┌────────────────┐┌─┐ q_0: ┤ X ├┤ Delay(112[dt]) ├┤M├ └───┘└────────────────┘└╥┘ diff --git a/docs/api/qiskit/dev/qiskit.transpiler.passes.BasisTranslator.mdx b/docs/api/qiskit/dev/qiskit.transpiler.passes.BasisTranslator.mdx index feece377fe9..a645ab67239 100644 --- a/docs/api/qiskit/dev/qiskit.transpiler.passes.BasisTranslator.mdx +++ b/docs/api/qiskit/dev/qiskit.transpiler.passes.BasisTranslator.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.transpiler.passes.BasisTranslator # BasisTranslator - + 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. @@ -120,7 +120,7 @@ python_api_name: qiskit.transpiler.passes.BasisTranslator ### run - + Translate an input DAGCircuit to the target basis. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.transpiler.passes.Commuting2qGateRouter.mdx b/docs/api/qiskit/dev/qiskit.transpiler.passes.Commuting2qGateRouter.mdx index dab23bdefd7..f3e6ac566db 100644 --- a/docs/api/qiskit/dev/qiskit.transpiler.passes.Commuting2qGateRouter.mdx +++ b/docs/api/qiskit/dev/qiskit.transpiler.passes.Commuting2qGateRouter.mdx @@ -15,7 +15,7 @@ python_api_name: qiskit.transpiler.passes.Commuting2qGateRouter 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 - ```text + ```python 0 -- 1 -- 2 | 3 diff --git a/docs/api/qiskit/dev/qiskit.transpiler.passes.ConstrainedReschedule.mdx b/docs/api/qiskit/dev/qiskit.transpiler.passes.ConstrainedReschedule.mdx index 1d1a8e5b357..8555b0976da 100644 --- a/docs/api/qiskit/dev/qiskit.transpiler.passes.ConstrainedReschedule.mdx +++ b/docs/api/qiskit/dev/qiskit.transpiler.passes.ConstrainedReschedule.mdx @@ -19,7 +19,7 @@ python_api_name: qiskit.transpiler.passes.ConstrainedReschedule We assume executing the following circuit on a backend with 16 dt of acquire alignment. - ```text + ```python ┌───┐┌────────────────┐┌─┐ q_0: ┤ X ├┤ Delay(100[dt]) ├┤M├ └───┘└────────────────┘└╥┘ @@ -29,7 +29,7 @@ python_api_name: qiskit.transpiler.passes.ConstrainedReschedule 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. - ```text + ```python ┌───┐┌────────────────┐┌─┐ q_0: ┤ X ├┤ Delay(112[dt]) ├┤M├ └───┘└────────────────┘└╥┘ diff --git a/docs/api/qiskit/dev/qiskit.transpiler.passes.ConvertConditionsToIfOps.mdx b/docs/api/qiskit/dev/qiskit.transpiler.passes.ConvertConditionsToIfOps.mdx index a7ffc2e3aab..e5c4ab9a95e 100644 --- a/docs/api/qiskit/dev/qiskit.transpiler.passes.ConvertConditionsToIfOps.mdx +++ b/docs/api/qiskit/dev/qiskit.transpiler.passes.ConvertConditionsToIfOps.mdx @@ -8,17 +8,13 @@ python_api_name: qiskit.transpiler.passes.ConvertConditionsToIfOps # ConvertConditionsToIfOps - + 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. - - The class `qiskit.transpiler.passes.utils.convert_conditions_to_if_ops.ConvertConditionsToIfOps` is deprecated as of qiskit 1.3.0. It will be removed in Qiskit 2.0.0. - - ## Attributes ### is\_analysis\_pass @@ -71,7 +67,7 @@ python_api_name: qiskit.transpiler.passes.ConvertConditionsToIfOps ### run - + Run a pass on the DAGCircuit. This is implemented by the pass developer. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.transpiler.passes.DynamicalDecoupling.mdx b/docs/api/qiskit/dev/qiskit.transpiler.passes.DynamicalDecoupling.mdx index 8440cad6a0a..17c89ca5ee5 100644 --- a/docs/api/qiskit/dev/qiskit.transpiler.passes.DynamicalDecoupling.mdx +++ b/docs/api/qiskit/dev/qiskit.transpiler.passes.DynamicalDecoupling.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.transpiler.passes.DynamicalDecoupling # DynamicalDecoupling - + Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass") Dynamical decoupling insertion pass. @@ -148,7 +148,7 @@ python_api_name: qiskit.transpiler.passes.DynamicalDecoupling ### run - + Run the DynamicalDecoupling pass on dag. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.transpiler.passes.EchoRZXWeylDecomposition.mdx b/docs/api/qiskit/dev/qiskit.transpiler.passes.EchoRZXWeylDecomposition.mdx index 5bf02fd9294..27c89671a00 100644 --- a/docs/api/qiskit/dev/qiskit.transpiler.passes.EchoRZXWeylDecomposition.mdx +++ b/docs/api/qiskit/dev/qiskit.transpiler.passes.EchoRZXWeylDecomposition.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.transpiler.passes.EchoRZXWeylDecomposition # EchoRZXWeylDecomposition - + Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass") Rewrite two-qubit gates using the Weyl decomposition. @@ -17,10 +17,6 @@ python_api_name: qiskit.transpiler.passes.EchoRZXWeylDecomposition EchoRZXWeylDecomposition pass. - - The class `qiskit.transpiler.passes.optimization.echo_rzx_weyl_decomposition.EchoRZXWeylDecomposition` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.transpiler.passes.optimization.echo_rzx_weyl_decomposition.EchoRZXWeylDecomposition` will have no alternative in Qiskit. - - **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. @@ -78,7 +74,7 @@ python_api_name: qiskit.transpiler.passes.EchoRZXWeylDecomposition ### run - + 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. diff --git a/docs/api/qiskit/dev/qiskit.transpiler.passes.HighLevelSynthesis.mdx b/docs/api/qiskit/dev/qiskit.transpiler.passes.HighLevelSynthesis.mdx index bd3d8c7e691..98108f4ceb3 100644 --- a/docs/api/qiskit/dev/qiskit.transpiler.passes.HighLevelSynthesis.mdx +++ b/docs/api/qiskit/dev/qiskit.transpiler.passes.HighLevelSynthesis.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.transpiler.passes.HighLevelSynthesis # HighLevelSynthesis - + Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass") Synthesize higher-level objects and unroll custom definitions. @@ -106,7 +106,7 @@ python_api_name: qiskit.transpiler.passes.HighLevelSynthesis ### run - + Run the HighLevelSynthesis pass on dag. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.transpiler.passes.MergeAdjacentBarriers.mdx b/docs/api/qiskit/dev/qiskit.transpiler.passes.MergeAdjacentBarriers.mdx index cc600d30749..42f52246ed8 100644 --- a/docs/api/qiskit/dev/qiskit.transpiler.passes.MergeAdjacentBarriers.mdx +++ b/docs/api/qiskit/dev/qiskit.transpiler.passes.MergeAdjacentBarriers.mdx @@ -36,7 +36,7 @@ python_api_name: qiskit.transpiler.passes.MergeAdjacentBarriers i.e, - ```text + ```python ░ ░ ░ ░ q_0: ─░──░─ q_0: ─░──░─ ░ ░ ░ ░ diff --git a/docs/api/qiskit/dev/qiskit.transpiler.passes.PadDelay.mdx b/docs/api/qiskit/dev/qiskit.transpiler.passes.PadDelay.mdx index fc26a1fa459..119406836f5 100644 --- a/docs/api/qiskit/dev/qiskit.transpiler.passes.PadDelay.mdx +++ b/docs/api/qiskit/dev/qiskit.transpiler.passes.PadDelay.mdx @@ -29,7 +29,7 @@ python_api_name: qiskit.transpiler.passes.PadDelay The ASAP-scheduled circuit output may become - ```text + ```python ┌────────────────┐ q_0: ┤ Delay(160[dt]) ├──■── └─────┬───┬──────┘┌─┴─┐ diff --git a/docs/api/qiskit/dev/qiskit.transpiler.passes.PadDynamicalDecoupling.mdx b/docs/api/qiskit/dev/qiskit.transpiler.passes.PadDynamicalDecoupling.mdx index f6349200e10..49267e67bd4 100644 --- a/docs/api/qiskit/dev/qiskit.transpiler.passes.PadDynamicalDecoupling.mdx +++ b/docs/api/qiskit/dev/qiskit.transpiler.passes.PadDynamicalDecoupling.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.transpiler.passes.PadDynamicalDecoupling # PadDynamicalDecoupling - + Bases: `BasePadding` Dynamical decoupling insertion pass. diff --git a/docs/api/qiskit/dev/qiskit.transpiler.passes.PulseGates.mdx b/docs/api/qiskit/dev/qiskit.transpiler.passes.PulseGates.mdx index 4102e63f862..1f105f42594 100644 --- a/docs/api/qiskit/dev/qiskit.transpiler.passes.PulseGates.mdx +++ b/docs/api/qiskit/dev/qiskit.transpiler.passes.PulseGates.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.transpiler.passes.PulseGates # PulseGates - + Bases: `CalibrationBuilder` Pulse gate adding pass. @@ -27,10 +27,6 @@ python_api_name: qiskit.transpiler.passes.PulseGates Create new pass. - - The class `qiskit.transpiler.passes.calibration.pulse_gate.PulseGates` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.transpiler.passes.calibration.pulse_gate.PulseGates` will have no alternative in Qiskit. - - **Parameters** * **inst\_map** – Instruction schedule map that user may override. @@ -78,7 +74,7 @@ python_api_name: qiskit.transpiler.passes.PulseGates ### get\_calibration - + Gets the calibrated schedule for the given instruction and qubits. **Parameters** @@ -129,7 +125,7 @@ python_api_name: qiskit.transpiler.passes.PulseGates ### supported - + Determine if a given node supports the calibration. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.transpiler.passes.RXCalibrationBuilder.mdx b/docs/api/qiskit/dev/qiskit.transpiler.passes.RXCalibrationBuilder.mdx index 5e2bd26494b..7a0e536c0aa 100644 --- a/docs/api/qiskit/dev/qiskit.transpiler.passes.RXCalibrationBuilder.mdx +++ b/docs/api/qiskit/dev/qiskit.transpiler.passes.RXCalibrationBuilder.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.transpiler.passes.RXCalibrationBuilder # RXCalibrationBuilder - + Bases: `CalibrationBuilder` Add single-pulse RX calibrations that are bootstrapped from the SX calibration. @@ -58,10 +58,6 @@ python_api_name: qiskit.transpiler.passes.RXCalibrationBuilder Bootstrap single-pulse RX gate calibrations from the (hardware-calibrated) SX gate calibration. - - The class `qiskit.transpiler.passes.calibration.rx_builder.RXCalibrationBuilder` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.transpiler.passes.calibration.rx_builder.RXCalibrationBuilder` will have no alternative in Qiskit. - - **Parameters** * **target** ([*Target*](qiskit.transpiler.Target "qiskit.transpiler.Target")) – Should contain a SX calibration that will be @@ -109,7 +105,7 @@ python_api_name: qiskit.transpiler.passes.RXCalibrationBuilder ### get\_calibration - + Generate RX calibration for the rotation angle specified in node\_op. **Return type** @@ -147,7 +143,7 @@ python_api_name: qiskit.transpiler.passes.RXCalibrationBuilder ### supported - + Check if the calibration for SX gate exists and it’s a single DRAG pulse. **Return type** diff --git a/docs/api/qiskit/dev/qiskit.transpiler.passes.RZXCalibrationBuilder.mdx b/docs/api/qiskit/dev/qiskit.transpiler.passes.RZXCalibrationBuilder.mdx index 27496802bf5..728e56c885e 100644 --- a/docs/api/qiskit/dev/qiskit.transpiler.passes.RZXCalibrationBuilder.mdx +++ b/docs/api/qiskit/dev/qiskit.transpiler.passes.RZXCalibrationBuilder.mdx @@ -8,17 +8,13 @@ python_api_name: qiskit.transpiler.passes.RZXCalibrationBuilder # RZXCalibrationBuilder - + 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. - - The class `qiskit.transpiler.passes.calibration.rzx_builder.RZXCalibrationBuilder` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.transpiler.passes.calibration.rzx_builder.RZXCalibrationBuilder` will have no alternative in Qiskit. - - **Parameters** * **instruction\_schedule\_map** – The `InstructionScheduleMap` object representing the default pulse calibrations for the target backend @@ -71,7 +67,7 @@ python_api_name: qiskit.transpiler.passes.RZXCalibrationBuilder ### get\_calibration - + Builds the calibration schedule for the RZXGate(theta) with echos. **Parameters** @@ -106,7 +102,7 @@ python_api_name: qiskit.transpiler.passes.RZXCalibrationBuilder ### rescale\_cr\_inst - + A builder macro to play stretched pulse. **Parameters** @@ -148,7 +144,7 @@ python_api_name: qiskit.transpiler.passes.RZXCalibrationBuilder ### supported - + Determine if a given node supports the calibration. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.transpiler.passes.RZXCalibrationBuilderNoEcho.mdx b/docs/api/qiskit/dev/qiskit.transpiler.passes.RZXCalibrationBuilderNoEcho.mdx index b1d556b1e50..aa53c0ad22b 100644 --- a/docs/api/qiskit/dev/qiskit.transpiler.passes.RZXCalibrationBuilderNoEcho.mdx +++ b/docs/api/qiskit/dev/qiskit.transpiler.passes.RZXCalibrationBuilderNoEcho.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.transpiler.passes.RZXCalibrationBuilderNoEcho # RZXCalibrationBuilderNoEcho - + 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. @@ -17,10 +17,6 @@ python_api_name: qiskit.transpiler.passes.RZXCalibrationBuilderNoEcho Initializes a RZXGate calibration builder. - - The class `qiskit.transpiler.passes.calibration.rzx_builder.RZXCalibrationBuilder` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.transpiler.passes.calibration.rzx_builder.RZXCalibrationBuilder` will have no alternative in Qiskit. - - **Parameters** * **instruction\_schedule\_map** – The `InstructionScheduleMap` object representing the default pulse calibrations for the target backend @@ -73,7 +69,7 @@ python_api_name: qiskit.transpiler.passes.RZXCalibrationBuilderNoEcho ### get\_calibration - + Builds the calibration schedule for the RZXGate(theta) without echos. **Parameters** @@ -108,7 +104,7 @@ python_api_name: qiskit.transpiler.passes.RZXCalibrationBuilderNoEcho ### rescale\_cr\_inst - + A builder macro to play stretched pulse. **Parameters** @@ -150,7 +146,7 @@ python_api_name: qiskit.transpiler.passes.RZXCalibrationBuilderNoEcho ### supported - + Determine if a given node supports the calibration. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.transpiler.passes.RemoveIdentityEquivalent.mdx b/docs/api/qiskit/dev/qiskit.transpiler.passes.RemoveIdentityEquivalent.mdx deleted file mode 100644 index 41480e9aa69..00000000000 --- a/docs/api/qiskit/dev/qiskit.transpiler.passes.RemoveIdentityEquivalent.mdx +++ /dev/null @@ -1,122 +0,0 @@ ---- -title: RemoveIdentityEquivalent -description: API reference for qiskit.transpiler.passes.RemoveIdentityEquivalent -in_page_toc_min_heading_level: 1 -python_api_type: class -python_api_name: qiskit.transpiler.passes.RemoveIdentityEquivalent ---- - -# RemoveIdentityEquivalent - - - Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass") - - Remove gates with negligible effects. - - Removes gates whose effect is close to an identity operation, up to the specified tolerance. Zero qubit gates such as [`GlobalPhaseGate`](qiskit.circuit.library.GlobalPhaseGate "qiskit.circuit.library.GlobalPhaseGate") are not considered by this pass. - - For a cutoff fidelity $f$, this pass removes gates whose average gate fidelity with respect to the identity is below $f$. Concretely, a gate $G$ is removed if $\bar F < f$ where - -$$ -\bar{F} = \frac{1 + F_{\text{process}}{1 + d} - -F_{\text{process}} = \frac{|\mathrm{Tr}(G)|^2}{d^2} -$$ - - where $d = 2^n$ is the dimension of the gate for $n$ qubits. - - Initialize the transpiler pass. - - **Parameters** - - * **approximation\_degree** – The degree to approximate for the equivalence check. This can be a floating point value between 0 and 1, or `None`. If the value is 1 this does not approximate above floating point precision. For a value \< 1 this is used as a scaling factor for the cutoff fidelity. If the value is `None` this approximates up to the fidelity for the gate specified in `target`. - * **target** – If `approximation_degree` is set to `None` and a [`Target`](qiskit.transpiler.Target "qiskit.transpiler.Target") is provided for this field the tolerance for determining whether an operation is equivalent to identity will be set to the reported error rate in the target. If `approximation_degree` (the default) this has no effect, if `approximation_degree=None` it uses the error rate specified in the `Target` for the gate being evaluated, and a numeric value other than 1 with `target` set is used as a scaling factor of the target’s error rate. - - ## 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 optimization task for input Qiskit IR. - - **Parameters** - - * **passmanager\_ir** ([*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.13)")) – 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.13)") *| 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.13)")\[[*Any*](https://docs.python.org/3/library/typing.html#typing.Any "(in Python v3.13)"), [qiskit.passmanager.compilation\_status.PassManagerState](qiskit.passmanager.PassManagerState "qiskit.passmanager.compilation_status.PassManagerState")] - - - ### name - - - Name of the pass. - - **Return type** - - [str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.13)") - - - ### run - - - Run a pass on the DAGCircuit. This is implemented by the pass developer. - - **Parameters** - - **dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit._accelerate.circuit.DAGCircuit")) – the dag on which the pass is run. - - **Raises** - - [**NotImplementedError**](https://docs.python.org/3/library/exceptions.html#NotImplementedError "(in Python v3.13)") – when this is left unimplemented for a pass. - - **Return type** - - [*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit._accelerate.circuit.DAGCircuit") - - - ### update\_status - - - 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/dev/qiskit.transpiler.passes.SolovayKitaev.mdx b/docs/api/qiskit/dev/qiskit.transpiler.passes.SolovayKitaev.mdx index 979295e3027..5fdbbeef967 100644 --- a/docs/api/qiskit/dev/qiskit.transpiler.passes.SolovayKitaev.mdx +++ b/docs/api/qiskit/dev/qiskit.transpiler.passes.SolovayKitaev.mdx @@ -19,7 +19,7 @@ python_api_name: qiskit.transpiler.passes.SolovayKitaev For example, the following circuit - ```text + ```python ┌─────────┐ q_0: ┤ RX(0.8) ├ └─────────┘ @@ -27,7 +27,7 @@ python_api_name: qiskit.transpiler.passes.SolovayKitaev can be decomposed into - ```text + ```python global phase: 7π/8 ┌───┐┌───┐┌───┐ q_0: ┤ H ├┤ T ├┤ H ├ @@ -62,7 +62,7 @@ python_api_name: qiskit.transpiler.passes.SolovayKitaev print("Error:", np.linalg.norm(Operator(circuit).data - Operator(discretized).data)) ``` - ```text + ```python Original circuit: ┌─────────┐ q: ┤ Rx(0.8) ├ diff --git a/docs/api/qiskit/dev/qiskit.transpiler.passes.TimeUnitConversion.mdx b/docs/api/qiskit/dev/qiskit.transpiler.passes.TimeUnitConversion.mdx index efdac25c0f6..f9517878384 100644 --- a/docs/api/qiskit/dev/qiskit.transpiler.passes.TimeUnitConversion.mdx +++ b/docs/api/qiskit/dev/qiskit.transpiler.passes.TimeUnitConversion.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.transpiler.passes.TimeUnitConversion # TimeUnitConversion - + 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. @@ -80,7 +80,7 @@ python_api_name: qiskit.transpiler.passes.TimeUnitConversion ### run - + Run the TimeUnitAnalysis pass on dag. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.transpiler.passes.UnitarySynthesis.mdx b/docs/api/qiskit/dev/qiskit.transpiler.passes.UnitarySynthesis.mdx index a84f5c577fa..afbe3a46cd1 100644 --- a/docs/api/qiskit/dev/qiskit.transpiler.passes.UnitarySynthesis.mdx +++ b/docs/api/qiskit/dev/qiskit.transpiler.passes.UnitarySynthesis.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.transpiler.passes.UnitarySynthesis # UnitarySynthesis - + Bases: [`TransformationPass`](qiskit.transpiler.TransformationPass "qiskit.transpiler.basepasses.TransformationPass") Synthesize gates according to their basis gates. @@ -87,7 +87,7 @@ python_api_name: qiskit.transpiler.passes.UnitarySynthesis ### run - + Run the UnitarySynthesis pass on `dag`. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.transpiler.passes.ValidatePulseGates.mdx b/docs/api/qiskit/dev/qiskit.transpiler.passes.ValidatePulseGates.mdx index 054f79d9c0f..5c49b6199fd 100644 --- a/docs/api/qiskit/dev/qiskit.transpiler.passes.ValidatePulseGates.mdx +++ b/docs/api/qiskit/dev/qiskit.transpiler.passes.ValidatePulseGates.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.transpiler.passes.ValidatePulseGates # ValidatePulseGates - + Bases: [`AnalysisPass`](qiskit.transpiler.AnalysisPass "qiskit.transpiler.basepasses.AnalysisPass") Check custom gate length. @@ -23,10 +23,6 @@ python_api_name: qiskit.transpiler.passes.ValidatePulseGates Create new pass. - - The class `qiskit.transpiler.passes.scheduling.alignments.pulse_gate_validation.ValidatePulseGates` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that once removed, `qiskit.transpiler.passes.scheduling.alignments.pulse_gate_validation.ValidatePulseGates` will have no alternative in Qiskit. - - **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. @@ -85,7 +81,7 @@ python_api_name: qiskit.transpiler.passes.ValidatePulseGates ### run - + Run the pulse gate validation attached to `dag`. **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.transpiler.passes.synthesis.unitary_synthesis.DefaultUnitarySynthesis.mdx b/docs/api/qiskit/dev/qiskit.transpiler.passes.synthesis.unitary_synthesis.DefaultUnitarySynthesis.mdx index f8008139e3e..c465476c512 100644 --- a/docs/api/qiskit/dev/qiskit.transpiler.passes.synthesis.unitary_synthesis.DefaultUnitarySynthesis.mdx +++ b/docs/api/qiskit/dev/qiskit.transpiler.passes.synthesis.unitary_synthesis.DefaultUnitarySynthesis.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit.transpiler.passes.synthesis.unitary_synthesis.DefaultUni # DefaultUnitarySynthesis - + Bases: [`UnitarySynthesisPlugin`](qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin "qiskit.transpiler.passes.synthesis.plugin.UnitarySynthesisPlugin") The default unitary synthesis plugin. @@ -67,7 +67,7 @@ python_api_name: qiskit.transpiler.passes.synthesis.unitary_synthesis.DefaultUni ### run - + Run synthesis for the given unitary matrix **Parameters** diff --git a/docs/api/qiskit/dev/qiskit.visualization.dag_drawer.mdx b/docs/api/qiskit/dev/qiskit.visualization.dag_drawer.mdx index 74f295a2b9a..bc240b45bf3 100644 --- a/docs/api/qiskit/dev/qiskit.visualization.dag_drawer.mdx +++ b/docs/api/qiskit/dev/qiskit.visualization.dag_drawer.mdx @@ -17,7 +17,7 @@ python_api_name: qiskit.visualization.dag_drawer **Parameters** - * **dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") *or*[*DAGDependency*](qiskit.dagcircuit.DAGDependency "qiskit.dagcircuit.DAGDependency")) – The dag to draw. + * **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.13)")) – scaling factor * **filename** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.13)")) – file path to save image to (format inferred from name) * **style** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.13)")) – ‘plain’: B\&W graph ‘color’ (default): color input/output/op nodes diff --git a/docs/api/qiskit/dev/qpy.mdx b/docs/api/qiskit/dev/qpy.mdx index d4d8d5754ab..fc4d9ab1a58 100644 --- a/docs/api/qiskit/dev/qpy.mdx +++ b/docs/api/qiskit/dev/qpy.mdx @@ -55,7 +55,7 @@ and then loading that file will return a list with all the circuits ### load - + 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: @@ -100,7 +100,7 @@ and then loading that file will return a list with all the circuits ### dump - + 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. @@ -135,13 +135,9 @@ and then loading that file will return a list with all the circuits Which will save the qpy serialized circuit to the provided file. - - Passing ScheduleBlock to programs is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and this argument uses a dependency on the package. - - **Parameters** - * **programs** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.13)")*\[*[*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. Support for [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") is deprecated since Qiskit 1.3.0. + * **programs** ([*List*](https://docs.python.org/3/library/typing.html#typing.List "(in Python v3.13)")*\[*[*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.13)")) – The file like object to write the QPY data too @@ -287,7 +283,7 @@ The QPY serialization format is a portable cross-platform binary serialization f 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: -```c +```python struct { uint8_t qpy_version; uint8_t qiskit_major_version; @@ -299,7 +295,7 @@ struct { From V10 on, a new field is added to the file header struct to represent the encoding scheme used for symbolic expressions: -```c +```python struct { uint8_t qpy_version; uint8_t qiskit_major_version; @@ -332,7 +328,7 @@ Version 12 adds support for: The HEADER struct for an individual circuit has added three `uint32_t` counts of the input, captured and locally declared variables in the circuit. The new form looks like: -```c +```python struct { uint16_t name_size; char global_phase_type; @@ -354,7 +350,7 @@ The `HEADER_V12` struct is followed immediately by the same name, global-phase, An `EXPR_VAR_DECLARATION` defines an [`expr.Var`](circuit_classical#qiskit.circuit.classical.expr.Var "qiskit.circuit.classical.expr.Var") instance that is standalone; that is, it represents a self-owned memory location rather than wrapping a [`Clbit`](circuit#qiskit.circuit.Clbit "qiskit.circuit.Clbit") or [`ClassicalRegister`](circuit#qiskit.circuit.ClassicalRegister "qiskit.circuit.ClassicalRegister"). The payload is a C struct: -```c +```python struct { char uuid_bytes[16]; char usage; @@ -404,7 +400,7 @@ Version 11 is identical to Version 10 except for the following. First, the names This represents `Modifier` -```c +```python struct { char type; uint32_t num_ctrl_qubits; @@ -432,7 +428,7 @@ The symbolic\_encoding field is added to the file header, and a new encoding typ The contents of FILE\_HEADER after V10 are defined as a C struct as: -```c +```python struct { uint8_t qpy_version; uint8_t qiskit_major_version; @@ -447,7 +443,7 @@ struct { The `LAYOUT` struct is updated to have an additional `input_qubit_count` field. With version 10 the `LAYOUT` struct is now: -```c +```python struct { char exists; int32_t initial_layout_size; @@ -522,7 +518,7 @@ This represents a literal object in the classical type system, such as an intege 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: -```c +```python struct { uint16_t name_size; uint16_t label_size; @@ -559,7 +555,7 @@ Version 8 adds support for handling a [`TranspileLayout`](qiskit.transpiler.Tran #### LAYOUT -```c +```python struct { char exists; int32_t initial_layout_size; @@ -577,7 +573,7 @@ Immediately following the `LAYOUT` struct there is a [REGISTERS](#qpy-registers) #### INITIAL\_LAYOUT\_BIT -```c +```python struct { int32_t index; int32_t register_size; @@ -631,7 +627,7 @@ Version 6 adds support for `ScalableSymbolicPulse`. These objects are saved and SymbolicPulse block now starts with SYMBOLIC\_PULSE\_V2 header: -```c +```python struct { uint16_t class_name_size; uint16_t type_size; @@ -654,7 +650,7 @@ With the support of `ScheduleBlock`, now [`QuantumCircuit`](qiskit.circuit.Quant In QPY version 5 and above, -```c +```python struct { char type; } @@ -700,7 +696,7 @@ Note that circuit and schedule block are serialized and deserialized through the [`ScheduleBlock`](qiskit.pulse.ScheduleBlock "qiskit.pulse.ScheduleBlock") block starts with the following header: -```c +```python struct { uint16_t name_size; uint64_t metadata_size; @@ -778,7 +774,7 @@ The key is immediately followed by the channel index serialized as the INSTRUCTI Waveform block starts with WAVEFORM header: -```c +```python struct { double epsilon; uint32_t data_size; @@ -794,7 +790,7 @@ which is followed by `data_size` bytes of complex `ndarray` binary generated by SymbolicPulse block starts with SYMBOLIC\_PULSE header: -```c +```python struct { uint16_t type_size; uint16_t envelope_size; @@ -816,7 +812,7 @@ The MAPPING is a representation for arbitrary mapping object. This is a fixed le A MAP\_ITEM starts with a header defined as: -```c +```python struct { uint16_t key_size; char type; @@ -834,7 +830,7 @@ which is immediately followed by the `key_size` utf8 bytes representing the dict The CIRCUIT\_CALIBRATIONS block is a dictionary to define pulse calibrations of the custom instruction set. This block starts with the following CALIBRATION header: -```c +```python struct { uint16_t num_cals; } @@ -842,7 +838,7 @@ struct { which is followed by the `num_cals` length of calibration entries, each starts with the CALIBRATION\_DEF header: -```c +```python struct { uint16_t name_size; uint16_t num_qubits; @@ -859,7 +855,7 @@ The calibration definition header is then followed by `name_size` utf8 bytes of 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: -```c +```python struct { uint16_t name_size; uint16_t label_size; @@ -882,7 +878,7 @@ The rest of the instruction payload is the same. You can refer to [INSTRUCTIONS] 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: -```c +```python struct { uint16_t name_size; char type; @@ -912,7 +908,7 @@ Version 4 is identical to [Version 3](#qpy-version-3) except that it adds 2 new The [REGISTERS](#qpy-registers) header format has also been updated to -```c +```python struct { char type; _Bool standalone; @@ -930,7 +926,7 @@ which just adds the `in_circuit` field which represents whether the register is A RANGE is a representation of a `range` object. It is defined as: -```c +```python struct { int64_t start; int64_t stop; @@ -946,7 +942,7 @@ A SEQUENCE is a representation of an arbitrary sequence object. As sequence are A sequence instruction parameter starts with a header defined as: -```c +```python struct { uint64_t size; } @@ -968,7 +964,7 @@ Version 3 of the QPY format is identical to [Version 2](#qpy-version-2) except t This represents the high level [`PauliEvolutionGate`](qiskit.circuit.library.PauliEvolutionGate "qiskit.circuit.library.PauliEvolutionGate") -```c +```python struct { uint64_t operator_count; _Bool standalone_op; @@ -988,7 +984,7 @@ This is immediately followed by `operator_count` elements defined by the [SPARSE This represents an instance of [`SparsePauliOp`](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp"). -```c +```python struct { uint32_t pauli_op_size; } @@ -1006,7 +1002,7 @@ Version 3 of the QPY format also defines a struct format to represent a `Paramet A PARAMETER\_VECTOR\_ELEMENT represents a `ParameterVectorElement` object the data for a INSTRUCTION\_PARAM. The contents of the PARAMETER\_VECTOR\_ELEMENT are defined as: -```c +```python struct { uint16_t vector_name_size; uint64_t vector_size; @@ -1027,7 +1023,7 @@ Additionally, since QPY format version v3 distinguishes between a [`Parameter`]( 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: -```c +```python struct { uint64_t map_elements; uint64_t expr_size; @@ -1036,7 +1032,7 @@ struct { 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 -```c +```python struct { char symbol_type; char type; @@ -1056,7 +1052,7 @@ Version 2 of the QPY format is identical to version 1 except for the HEADER sect The contents of HEADER are defined as a C struct are: -```c +```python struct { uint16_t name_size; char global_phase_type; @@ -1081,7 +1077,7 @@ This is immediately followed by `name_size` bytes of utf8 data for the name of t The contents of HEADER as defined as a C struct are: -```c +```python struct { uint16_t name_size; double global_phase; @@ -1105,7 +1101,7 @@ The METADATA field is a UTF8 encoded JSON string. After reading the HEADER (whic 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: -```c +```python struct { char type; _Bool standalone; @@ -1149,7 +1145,7 @@ This section specifies custom definitions for any of the instructions in the cir CUSTOM\_DEFINITION\_HEADER contents are defined as: -```c +```python struct { uint64_t size; } @@ -1157,7 +1153,7 @@ struct { 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: -```c +```python struct { uint16_t name_size; char type; @@ -1178,7 +1174,7 @@ If `custom_definition` is `True` that means that the immediately following `size The contents of INSTRUCTIONS is a list of INSTRUCTION metadata objects -```c +```python struct { uint16_t name_size; uint16_t label_size; @@ -1197,7 +1193,7 @@ This is immediately followed by the INSTRUCTION\_ARG structs for the list of arg The contents of each INSTRUCTION\_ARG is: -```c +```python struct { char type; uint32_t index; @@ -1210,7 +1206,7 @@ After all arguments for an instruction the parameters are specified with `num_pa The contents of each INSTRUCTION\_PARAM is: -```c +```python struct { char type; uint64_t size; @@ -1225,7 +1221,7 @@ After each INSTRUCTION\_PARAM the next `size` bytes are the parameter’s data. 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: -```c +```python struct { uint16_t name_size; char uuid[16]; @@ -1244,7 +1240,7 @@ A PARAMETER\_EXPR represents a [`ParameterExpression`](qiskit.circuit.ParameterE The PARAMETER\_EXPR data starts with a header: -```c +```python struct { uint64_t map_elements; uint64_t expr_size; @@ -1253,7 +1249,7 @@ struct { 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 -```c +```python struct { char type; uint64_t size; @@ -1268,7 +1264,7 @@ Which is followed immediately by `PARAMETER` object (both the struct and utf8 na When representing a double precision complex value in QPY the following struct is used: -```c +```python struct { double real; double imag; diff --git a/docs/api/qiskit/dev/quantum_info.mdx b/docs/api/qiskit/dev/quantum_info.mdx index 0a682a6ec55..c4da200db3c 100644 --- a/docs/api/qiskit/dev/quantum_info.mdx +++ b/docs/api/qiskit/dev/quantum_info.mdx @@ -20,17 +20,16 @@ python_api_name: 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. | -| [`SparseObservable`](qiskit.quantum_info.SparseObservable "qiskit.quantum_info.SparseObservable") | An observable over Pauli bases that stores its data in a qubit-sparse format. | -| [`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. | +| | | +| --------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | +| [`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. | diff --git a/docs/api/qiskit/dev/result.mdx b/docs/api/qiskit/dev/result.mdx index 2d8c18be0b9..1980d5c57e0 100644 --- a/docs/api/qiskit/dev/result.mdx +++ b/docs/api/qiskit/dev/result.mdx @@ -146,9 +146,9 @@ python_api_name: qiskit.result ## Mitigation -| | | -| --------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- | -| [`BaseReadoutMitigator`](qiskit.result.BaseReadoutMitigator "qiskit.result.BaseReadoutMitigator")() | This class is DEPRECATED. | -| [`CorrelatedReadoutMitigator`](qiskit.result.CorrelatedReadoutMitigator "qiskit.result.CorrelatedReadoutMitigator")(assignment\_matrix) | This class is DEPRECATED. | -| [`LocalReadoutMitigator`](qiskit.result.LocalReadoutMitigator "qiskit.result.LocalReadoutMitigator")(\[assignment\_matrices, ...]) | This class is DEPRECATED. | +| | | +| --------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- | +| [`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/dev/scheduler.mdx b/docs/api/qiskit/dev/scheduler.mdx index 4317da07ca4..1e885240036 100644 --- a/docs/api/qiskit/dev/scheduler.mdx +++ b/docs/api/qiskit/dev/scheduler.mdx @@ -22,15 +22,11 @@ A circuit scheduler compiles a circuit program to a pulse program. ### ScheduleConfig - + Configuration for pulse scheduling. Container for information needed to schedule a QuantumCircuit into a pulse Schedule. - - The class `qiskit.scheduler.config.ScheduleConfig` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that `qiskit.scheduler.config.ScheduleConfig` will be moved as well. - - **Parameters** * **inst\_map** ([*InstructionScheduleMap*](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.instruction_schedule_map.InstructionScheduleMap")) – The schedule definition of all gates supported on a backend. @@ -40,7 +36,7 @@ A circuit scheduler compiles a circuit program to a pulse program. ### schedule\_circuit - + 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: @@ -48,10 +44,6 @@ A circuit scheduler compiles a circuit program to a pulse program. > * `'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'`) - - The function `qiskit.scheduler.schedule_circuit.schedule_circuit()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that `qiskit.scheduler.schedule_circuit.schedule_circuit()` will be moved as well. - - **Parameters** * **circuit** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")) – The quantum circuit to translate. @@ -76,15 +68,11 @@ A circuit scheduler compiles a circuit program to a pulse program. ### as\_soon\_as\_possible - + 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. - - The function `qiskit.scheduler.methods.basic.as_soon_as_possible()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that `qiskit.scheduler.methods.basic.as_soon_as_possible()` will be moved as well. - - **Parameters** * **circuit** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")) – The quantum circuit to translate. @@ -102,17 +90,13 @@ A circuit scheduler compiles a circuit program to a pulse program. ### as\_late\_as\_possible - + 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. - - The function `qiskit.scheduler.methods.basic.as_late_as_possible()` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and will be moved to the Qiskit Dynamics repository: [https://github.com/qiskit-community/qiskit-dynamics](https://github.com/qiskit-community/qiskit-dynamics). Note that `qiskit.scheduler.methods.basic.as_late_as_possible()` will be moved as well. - - **Parameters** * **circuit** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.quantumcircuit.QuantumCircuit")) – The quantum circuit to translate. diff --git a/docs/api/qiskit/dev/synthesis.mdx b/docs/api/qiskit/dev/synthesis.mdx index 3a056db097a..d8e2c7ca3b4 100644 --- a/docs/api/qiskit/dev/synthesis.mdx +++ b/docs/api/qiskit/dev/synthesis.mdx @@ -400,7 +400,7 @@ python_api_name: qiskit.synthesis For example, a 5-qubit Clifford circuit is decomposed into the following layers: - ```text + ```python ┌─────┐┌─────┐┌────────┐┌─────┐┌─────┐┌─────┐┌─────┐┌────────┐ q_0: ┤0 ├┤0 ├┤0 ├┤0 ├┤0 ├┤0 ├┤0 ├┤0 ├ │ ││ ││ ││ ││ ││ ││ ││ │ @@ -556,7 +556,7 @@ python_api_name: qiskit.synthesis For example, a 5-qubit stabilizer state is decomposed into the following layers: - ```text + ```python ┌─────┐┌─────┐┌─────┐┌─────┐┌────────┐ q_0: ┤0 ├┤0 ├┤0 ├┤0 ├┤0 ├ │ ││ ││ ││ ││ │ @@ -747,7 +747,7 @@ Decomposition of general $2^n \times 2^n$ unitary matrices for any number of qub This decomposition is described in Shende et al. \[1]. - ```text + ```python ┌───┐ ┌───┐ ┌───┐ ┌───┐ ─┤ ├─ ───────┤ Rz├─────┤ Ry├─────┤ Rz├───── │ │ ≃ ┌───┐└─┬─┘┌───┐└─┬─┘┌───┐└─┬─┘┌───┐ diff --git a/docs/api/qiskit/dev/transpiler.mdx b/docs/api/qiskit/dev/transpiler.mdx index 95d3946df86..5f1ff36f82a 100644 --- a/docs/api/qiskit/dev/transpiler.mdx +++ b/docs/api/qiskit/dev/transpiler.mdx @@ -190,7 +190,7 @@ target.add_instruction( print(target) ``` -```text +```python Target Number of qubits: 3 Instructions: @@ -484,7 +484,7 @@ A few things to highlight. First, the circuit has gotten longer with respect to print('Original depth:', qc.depth(), 'Decomposed Depth:', qc_basis.depth()) ``` -```text +```python Original depth: 4 Decomposed Depth: 10 ``` @@ -501,7 +501,7 @@ It is important to highlight two special cases: print(backend.operation_names) ``` - ```text + ```python ['id', 'rz', 'sx', 'x', 'cx', 'measure', 'delay'] ``` @@ -762,7 +762,7 @@ When running scheduling analysis passes on a circuit, you must keep in mind that 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. -```text +```python qc = QuantumCircuit(2, 1) qc.delay(100, 0) qc.x(0).c_if(0, True) @@ -771,7 +771,7 @@ 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 -```text +```python ┌────────────────┐ ┌───┐ q_0: ┤ Delay(100[dt]) ├───┤ X ├────────────── ├────────────────┤ └─╥─┘ ┌───┐ @@ -788,7 +788,7 @@ Note that this scheduling might be inefficient in some cases, because the second 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: -```text +```python Q ░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░ B ░░▒▒▒▒▒▒▒▒░░░░░░░░░ D ░░░░░░░░░░▒▒▒▒▒▒░░░ @@ -799,7 +799,7 @@ However, the [`QuantumCircuit`](qiskit.circuit.QuantumCircuit "qiskit.circuit.Qu The lack of precision representing the physical model may induce edge cases in the scheduling: -```text +```python ┌───┐ q_0: ───┤ X ├────── └─╥─┘ ┌─┐ @@ -811,7 +811,7 @@ c: 1/╡ c_0=0x1 ╞═╩═ 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`](circuit#qiskit.circuit.Measure "qiskit.circuit.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: -```text +```python ┌────────────────┐ ┌───┐ q_0: ┤ Delay(500[dt]) ├───┤ X ├────── └────────────────┘ └─╥─┘ ┌─┐ @@ -823,7 +823,7 @@ c: 1/══════════════════╡ c_0=0x1 ╞═╩ 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, -```text +```python : Quantum Circuit, first-measure 0 ░░░░░░░░░░░░▒▒▒▒▒▒░ 1 ░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░ @@ -845,7 +845,7 @@ This behavior can be controlled by `clbit_write_latency` and `conditional_latenc Due to default latencies, the alap-scheduled circuit of above example may become -```text +```python ┌───┐ q_0: ───┤ X ├────── └─╥─┘ ┌─┐ @@ -857,7 +857,7 @@ c: 1/╡ c_0=0x1 ╞═╩═ 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. -```text +```python : Quantum Circuit, first-XGate 0 ░▒▒▒░░░░░░░░░░░░░░░ 1 ░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░ @@ -873,7 +873,7 @@ C ░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░ (zero latency, sched 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: -```text +```python ┌───────────────┐ ┌───┐ q_0: ┤ Delay(30[dt]) ├───┤ X ├────── ├───────────────┤ └─╥─┘ ┌─┐ @@ -885,7 +885,7 @@ c: 1/═════════════════╡ c_0=0x1 ╞═╩═ with the timing model: -```text +```python : Quantum Circuit, first-xgate 0 ░░▒▒▒░░░░░░░░░░░░░░░ 1 ░░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░ diff --git a/docs/api/qiskit/dev/transpiler_passes.mdx b/docs/api/qiskit/dev/transpiler_passes.mdx index 45ba72a5793..a0b31083ccb 100644 --- a/docs/api/qiskit/dev/transpiler_passes.mdx +++ b/docs/api/qiskit/dev/transpiler_passes.mdx @@ -84,7 +84,6 @@ python_api_name: qiskit.transpiler.passes | [`NormalizeRXAngle`](qiskit.transpiler.passes.NormalizeRXAngle "qiskit.transpiler.passes.NormalizeRXAngle")(\*args, \*\*kwargs) | Normalize theta parameter of RXGate instruction. | | [`OptimizeAnnotated`](qiskit.transpiler.passes.OptimizeAnnotated "qiskit.transpiler.passes.OptimizeAnnotated")(\*args, \*\*kwargs) | Optimization pass on circuits with annotated operations. | | [`Split2QUnitaries`](qiskit.transpiler.passes.Split2QUnitaries "qiskit.transpiler.passes.Split2QUnitaries")(\*args, \*\*kwargs) | Attempt to splits two-qubit unitaries in a [`DAGCircuit`](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") into two single-qubit gates. | -| [`RemoveIdentityEquivalent`](qiskit.transpiler.passes.RemoveIdentityEquivalent "qiskit.transpiler.passes.RemoveIdentityEquivalent")(\*args, \*\*kwargs) | Remove gates with negligible effects. | ## Calibration diff --git a/docs/api/qiskit/dev/transpiler_plugins.mdx b/docs/api/qiskit/dev/transpiler_plugins.mdx index 0713637aa36..1bc3a544314 100644 --- a/docs/api/qiskit/dev/transpiler_plugins.mdx +++ b/docs/api/qiskit/dev/transpiler_plugins.mdx @@ -129,7 +129,7 @@ There isn’t a limit to the number of plugins a single package can include as l help(basic_plugin) ``` - ```text + ```python Help on BasicSwapPassManager in module ...preset_passmanagers.builtin_plugins object: class BasicSwapPassManager(...preset_passmanagers.plugin.PassManagerStagePlugin) diff --git a/docs/api/qiskit/dev/transpiler_preset.mdx b/docs/api/qiskit/dev/transpiler_preset.mdx index f8db6f4575a..a8d60fa35d2 100644 --- a/docs/api/qiskit/dev/transpiler_preset.mdx +++ b/docs/api/qiskit/dev/transpiler_preset.mdx @@ -24,7 +24,7 @@ This module contains functions for generating the preset pass managers for the t ### generate\_preset\_pass\_manager - + Generate a preset [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager") This function is used to quickly generate a preset pass manager. Preset pass managers 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()`](compiler#qiskit.compiler.transpile "qiskit.compiler.transpile") function internally builds and uses. @@ -41,22 +41,6 @@ This module contains functions for generating the preset pass managers for the t | **timing\_constraints** | target | timing\_constraints | timing\_constraints | | **backend\_properties** | target | backend\_properties | backend\_properties | - - `qiskit.transpiler.preset_passmanagers.generate_preset_pass_manager.generate_preset_pass_manager()`’s argument `inst_map` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and this argument uses a dependency on the package. - - - - `qiskit.transpiler.preset_passmanagers.generate_preset_pass_manager.generate_preset_pass_manager()`’s argument `backend_properties` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The target parameter should be used instead. You can build a Target instance with defined properties with Target.from\_configuration(…, backend\_properties=…) - - - - `qiskit.transpiler.preset_passmanagers.generate_preset_pass_manager.generate_preset_pass_manager()`’s argument `timing_constraints` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The target parameter should be used instead. You can build a Target instance with defined timing constraints with Target.from\_configuration(…, timing\_constraints=…) - - - - `qiskit.transpiler.preset_passmanagers.generate_preset_pass_manager.generate_preset_pass_manager()`’s argument `instruction_durations` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The target parameter should be used instead. You can build a Target instance with defined instruction durations with Target.from\_configuration(…, instruction\_durations=…) - - **Parameters** * **optimization\_level** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.13)")) – @@ -74,7 +58,7 @@ This module contains functions for generating the preset pass managers for the t * **basis\_gates** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.13)")) – List of basis gate names to unroll to (e.g: `['u1', 'u2', 'u3', 'cx']`). - * **inst\_map** ([*InstructionScheduleMap*](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap")) – DEPRECATED. Mapping object that maps gates 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. + * **inst\_map** ([*InstructionScheduleMap*](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap")) – Mapping object that maps gates 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") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.13)")) – @@ -253,7 +237,7 @@ This module contains functions for generating the preset pass managers for the t ### generate\_control\_flow\_options\_check - + 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** @@ -267,13 +251,13 @@ This module contains functions for generating the preset pass managers for the t ### generate\_error\_on\_control\_flow - + Get a pass manager that always raises an error if control flow is present in a given circuit. ### generate\_unroll\_3q - + Generate an unroll >3q [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager") **Parameters** @@ -297,7 +281,7 @@ This module contains functions for generating the preset pass managers for the t ### generate\_embed\_passmanager - + 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 @@ -319,7 +303,7 @@ This module contains functions for generating the preset pass managers for the t ### generate\_routing\_passmanager - + Generate a routing [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager") **Parameters** @@ -345,7 +329,7 @@ This module contains functions for generating the preset pass managers for the t ### generate\_pre\_op\_passmanager - + 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 @@ -367,7 +351,7 @@ This module contains functions for generating the preset pass managers for the t ### generate\_translation\_passmanager - + Generate a basis translation [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager") **Parameters** @@ -398,19 +382,15 @@ This module contains functions for generating the preset pass managers for the t ### generate\_scheduling - + Generate a post optimization scheduling [`PassManager`](qiskit.transpiler.PassManager "qiskit.transpiler.PassManager") - - `qiskit.transpiler.preset_passmanagers.common.generate_scheduling()`’s argument `inst_map` is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0. The entire Qiskit Pulse package is being deprecated and this argument uses a dependency on the package. - - **Parameters** * **instruction\_durations** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.13)")) – The dictionary of instruction durations * **scheduling\_method** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.13)")) – 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")) – DEPRECATED. Mapping object that maps gate to schedule. + * **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** diff --git a/docs/api/qiskit/dev/transpiler_synthesis_plugins.mdx b/docs/api/qiskit/dev/transpiler_synthesis_plugins.mdx index ea475654339..8d4001bccf5 100644 --- a/docs/api/qiskit/dev/transpiler_synthesis_plugins.mdx +++ b/docs/api/qiskit/dev/transpiler_synthesis_plugins.mdx @@ -110,7 +110,7 @@ If for some reason the available inputs to the [`run()`](qiskit.transpiler.passe 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` table in `pyproject.toml` for the plugin package with the necessary entry points under the `qiskit.unitary_synthesis` namespace. For example: -```toml +```python [project.entry-points."qiskit.unitary_synthesis"] "special" = "qiskit_plugin_pkg.module.plugin:SpecialUnitarySynthesis" ``` @@ -143,7 +143,7 @@ The above example creates a plugin to synthesize objects of type [`Clifford`](qi 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` table in `pyproject.toml` for the plugin package with the necessary entry points under the `qiskit.synthesis` namespace. For example: -```toml +```python [project.entry-points."qiskit.synthesis"] "clifford.special" = "qiskit_plugin_pkg.module.plugin:SpecialSynthesisClifford" ``` diff --git a/docs/api/qiskit/dev/visualization.mdx b/docs/api/qiskit/dev/visualization.mdx index cbbae68e72b..b4c7825bcd3 100644 --- a/docs/api/qiskit/dev/visualization.mdx +++ b/docs/api/qiskit/dev/visualization.mdx @@ -20,7 +20,7 @@ The visualization module contain functions that visualizes measurement outcome c To use visualization functions, you are required to install visualization optionals to your development environment: -```bash +```python pip install 'qiskit[visualization]' ``` diff --git a/public/api/qiskit/dev/objects.inv b/public/api/qiskit/dev/objects.inv index bb5464f8c843d9eea6cb6e07999ee3fa88c0f674..dc01c7152d2c882f5e3e59e4f40fb1d4885baf33 100644 GIT binary patch delta 70570 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

Mn?=_M+MQJtCwGieOn1f}>5ecM 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 J`RKVT{|DCO!-fC= diff --git a/public/images/api/qiskit/dev/circuit-2.png b/public/images/api/qiskit/dev/circuit-2.png index 0e14ad1fe832f30fb4d3b659379446801527ba1f..fa7b138f2c8d0c951e3702622739c010de08a51f 100644 GIT binary patch literal 7538 zcmd^kWl&XNxb8wF+;m7cC`fFO?ky=HDP00mf;3w?1SusI1Vu^&HofVVl1Ay4mhMLK ze4IOT?#!LJb7t<${dM;2nzhz^>-*mCeV_Mvo)w{?_5>eB4TB&EUrA9;3xY80!T&`Z zEbuKmDCh-#MBU}}-JdyGyL*_sT0yGj?#{2A++V%4V0>-m>h{vfksmG!=i_3ub$54m z6XW4=_^%7#POdgQOlr3$z#w;>6%E`V2v67SJJbwh-x9Le%|G>t!Bf3I?o1&I; zo0#~s;OAjXB4W)R%27GFTW0#C#CHSDRpnTrP(k82=zqw;g75G^l;8(bUqUN`e_Dwc zKFnCNp(nsXHTMRpev<3==vSr%06r-sH~!r z1rNT{EQIrai-%AmiI-0Dp1J7a{_@l-bXVwsnpp9Oz28SX%|PEug9Il$)46?jHOp`)sbUu0YpL?i6TC@xNukdS~z zqXR#FB)zz}AR;1y0s;c`_4Ne|PR@=tJg+ZLN^A$1?_guAXh>FIw@!w`jjIDk^7R(S zOJ4M^xqI$+u@N&c#56TMewre7&*ykEuJ$Lq%|Rb=0e`{9Wyz;MVR#!VCCFO!8J(6e z=3VMfbG991(A3d}sTg50lOi7PUqrFjct7hNOlIfcXsMd@fB&K*I-{VVV8SYz0YL!m z9v`>Ay-P|&Pft)|Opq>x8Y_Mtv%l}^d$yKCDdNmnP;k0OarZeli;}XkjGWvZUteFe z>yq;LqOG_D582@6$iENL-EtSeozt-Dq0T zAU#trOtBO-hT-WtkBLPA2qBO;^~6>&&NNzLu;aiJthA0ep8MWR~Lh766jFR~j@wNt)3!^S$Z+_LR9 zT{u^ZZs^#{v(Xb;ipX~tbyP#Jx$cA zo~EX`?he15WTo`vLj;1MrltmL=Sx2I{1IkB!HR*nlcSBX#npjKMOD=hnT)2xwV}Os z8Yf0L{C9dseqo`!zkf&6itk=A_M5Y!4%wIX0;m6q&*u+hJi|r?X;sDh{#IWgo@efS zjqqfBfVY-*zcu%{)1ki|JAtY{>9ZeKq(uQa&XM8ufsxQ-WXLmGD%6%@BBD-EW5OeQW)A^Vc{brBrMxm zO!h$DV&~z(4zxb6!X}`7EG;daN#5DP5Di!`Fr6y^?c0eM8FQ;0>o8zqi*0QaP=5FMrn+kh9MwAbagmm0sc@e?>i_4M?VfTFjwvYH>xeTIXJYhP+=Xh_Y>!ZLNH{WeD{cW!Cv zK9Y*CO-NDP%g3j6a8N5?QagBa^Hu%vq&?)nrI#2V|2Rua5VjK=OBA1wz{JVfBXiO}SAXXs_B_+K_z%>+hA(!+EP`t4{Pk<(y43#AS8UhMYMVOx;b;EP3gVw_ZPM_>#ilp6 z71h+*!--kYPP0-4CUxXgR8(iTWALBs?M&C@1h~b=#|wNJBjM!CC%CK`z0P`gYOW*G zgWJuu`|}&s1H_6UTsWqxz_lB?JWp2Qz)7I&Q7XO2-P6@;hsqn4oHF zYwPUnv?UpJt@*P#1)0!IF)E~MbCftt3H@DJ$t)8rK;h$AhY> zgny?Yil3kSsc}PBRfQE77Ynpqx3fH&N1wd>cUa`lqeim4KpAIgZG9{7>f+)PCCM;8 zb>+k^B`bL-68qu9htdEXJ|5&#aOnq*kL&+kTFOA9iJTfQg_eJ(*!MTfKhqfZX#Lrc zZ@x2D<}btVuqHL|g4caZVu*ZH{!g6;A=IDwB!)cEK~>{+U~)1Iw5#roX+_`oP&{LJ zSQ}F12{kCOz})^*6MS`fE(;(*OpKaF=v8cb3wGJgR&?ig)y^|9%f&^T{F$3yA_HDWpuzH zv(w#qba}bl&P)S-E#E*a55)HzZ-b!JbI*dyv|fLmuePAM=UZHwYgX4`JmTt}p(-~Q zmsOIB1#Z#h7Eazf<+xKBE&;21yLf~xb5;W)4X^U==v2+bGRc02zj^xBTs1}QWDe3M zkAJL}U9x{BRpIVWH{b_4~l#*2%p6(4RhexuWQ%0horBzAhjv-8LE5t^rU{yhBd(Y z*n;ON^#dGBLbC8)RKnYqPJ^ulQw23|S4yLvxlqmF#>8FD3w`JLdUg~ln`U~$#5i!3 zA&4*JUb$ceDnC!!!K&g1CdpYdXQ%jU4B^I0&6f2D`be;h?l$h{^9!GfA?Swg*=M1)TGo_7qu1D=E*z3=G0@dNsQ2*+W4B33@OmaTDP{F%ae{!5Ey{7l;nJ-1y zKK}4D+ILZ-zG}#-*iOhJrfH;scv(uXuBmn!cUGI`wj#%|n3zeR)-U0T5S~3VGX`%# zMEIR1^n?G$gU%8gYVftT6OB&^v&%;n709!xYwzQ&*M#GqA&D4TmeC6SL%7xT}gdq6@n7AtDw%x%F;?4cv*rk^WUqMIj>PU)*8?X$jHgR z6%`STj*hNQl(CV)+GNMNdVA%RlVcKI>9*Gn*4Y)+&(MycSFR27M5V6!c&))(KX?}GT z2OAq(PF{X~w9p8ERY!qA*>`wxPk#Qus?%&;Dt3w*o4KHg9_U{)z6YxH2fxKdkn7qX z)3KmJ-S^4DP78C*!TPoC4=Z0y1bz5G0ySbGy}U$eX=&%Sw;dO381c6aXq3P-nVFgA z78ipPIQ3daN6E!sZ#Dq|lcAeWOh(3vj3{J&rf)v?foeDH5$tv9w5DF6w3ix__7ng1 znv)Yn6VrTKj=b2~B~IfhFMY(;Zm-82Uq9h((}=g%k(wmBW60r=5%a!ONfGze*sJ&Z zfU3#c+OnS=uH9BwR|jlSTU(ovlM{EW$fR{3^NA+FtoV2`<68H-Lpkal00T8mO$jI{ zC<;s)sOjnHNf7))X8JVJ=H^Tm78XP#Btbua$^i<03$pG@#YZ3z5D~l}tONemMxV%E z|MKoTxOGcjvfx*St*Gs046Vdb4r=86tD{ZvYB#COuKKz}J{OBU>v-dah}fk*6%CUy zO+CG^>S_^Rpl6_)USl@j60&=ABOp40NB=7=1z^FqI0dF>)evGMe)?~{pUk#Dy zj(FRAa&i(vVL*-U((raa%(3(*bNpVYHQ0s)2?@!ewB(C+Jh>-NS^;Y!rnTaul9832 zpPRdBJ+>8wP}7h)Vmd2`+N^Jq{djXC7(|eTmlr+p4{(Yz;nA4}pGS7X?Cc5M)+Zdj z@>bH1yhAXXC)-TdwI&O`rBezYr|{WMa83~-odr$CCdzE$l9F(s8*%aUX{5CDG$TJh zDafNx-TaUQoy)5wFkamsoB%*iaxN}>0S#e(@F2TO0%RND{0cebqT=E&x<1^m_B$7n zy4Y>iMVLA`aPJ@BGo%@2<~kg`fST5>BRi5Bx#WA>VqADw2t9shv+SH=TKc8jn&$Bl zF3cJjW@hUUX|14^sW@SEM~04gi!Z^7((3Rw=%eY3b~_wgDxHdDW&5$g@x zt@Ga2R@rNLv!dQQF^u@c#M=-T7uT0wapyS*27^&oJbv&r34+EO0|Juic>qbDnVG@j zxh~qc@LkX;#U~&5h4* zr0L@$&%q!czyByWk&uBJrnA*RP|zu|N%s})*@gu*^)nq6CZF#lCVW!V8oME{^}_0D zQc*xCv6I2LjH}TTeO(1z%qYHE?<*)rSBMhewU7sHn(VT3Y7Y>E&wg z?(f@;h-J6`7j-4+h+%LNkObPjxZ#)@+9QAq^}nnDnSWcaG9Y-d@tU8Y&+t7x69(ue zTI+*&TDcC>#qVGy8;yah^VE|JnF>)s`T6!_a>&+HRqOOL9nduj`1U{}ptL!H6V*TeqwnUQx~eig z;jGcUt`?e}8s)&j!+UGD!={kiMszPv#`okf&Cs;}mWI?I?uvi)WS%4<7sbg@@?usK zY9d5jK~U5-XPwdzmZ;A$7YAp6!$AC}PYWPsP#_x38(ejO2FSO?!N}I$>+79+T?quJNUo6?$xEXP1fo-P?Od z<2v=|8rHuK_stXMqnLtB~&bmX&cHud^z3H8aKTNb>}j76BcMVOdVBTjGFJsX$+ zbKv4zsSGyzlVWv${+yjeBqkdprY z2m!H=^7E*lnFnkyc1vybaZW?*w(INbdHpXu4}q|4vjV$BOhaS8n-Fn)d<;}rurXY? zu21cWIk@?M(qKY3punUD%fE(Zt12o&VqyqOOG}^Xn~V+qYQ>zNy2f3qdKc@lz--5v z*Z=DmRqCRQnbpB=+%#$n3!nO}bTAfGc|l5{X~X}rMfG@JyB_~o=5LA;9g%6z(XMnTM*zTVsXGcdn_IAqsk?6l z1=7Q#9jNaV79x|xLy>I4+e5;@kgE*`a9;JY!6(b^XZsEoR4?WzaaHPufXo#Bx_5>8 z2tIigO!WW3c=g~L85v0ucA^JcHn+MOzPsye{KMB^y|feW9vRtOZceI9mE$z8SrhbC z)J4#cc zyPTcA=hC`rQc$|Wv-~uF-nBY~9=fMz1Te454)4E;s|+$VfZDq`Pwr}o!8aVg+$LG7!hN<;t$r3p}4Hnp$3x;56#GC4zQ-{C>wc$r10pUdi31V}Hd zvIFcpXY(GKiy{BykpfG!SIC79>y<7`a(xMLm?`1Q75Dpp%C>|2r%qU1*y|>kz4ynh zS0<(=EZV;hwA>MdBB_KZ8+>Yn#hr{-7xC85c?;^2XoL@l>W~yg-))pkU=^B;QVoyX zof{tvWwOPDm$bYT8a@rn{5t~Z(A`Qaz@x5|y}&2VtMe>SnF5DY^5iLZU=(sMmEVq|#O3?Sxs zgOBjw;2>jS4>1u@V2#^~1)yZyMbC3aWD1LHhhEsMOt(iRdr^*$5xT0V{NY@}Bw|h` zk-`g@O2c8p7LW9{NbfJUd5+*Y+*=FTnDC+$W*+~$qn=foJP{ze3uWHDxzFHtC6U*g zl)x84G4wDB3f=?z19*X>3(bl0NO;t&Ly%oWZS+#H1mTmg=tf4AWVMZh44{(jB`-SA zzW??gBnEm^y2(UzR^OZm#wH9^&XO@THBEkk4NOwYu{W%!eaFS6m7M0bKsV=zS`y+( z#$^)|wvVZ)(f*fbpM5DiHtVOVKYP&JK0AAain!Az6mB-W{!Zwm;90R1^O0e8949kL z8jhs>wn4InnHeLHVjP=|E<|ze<7Gk_Q8dB}QNlA#-3go}j?=XY2kv4i(t4>Cl{UXj z1vPu*Rt@+IR8iU4Sitn^==#X^=;a{m)2|}LLPA2-zW?}&OzJ{`?#Psy0f9W-unF5e z4SXyiF4&8jdcZtn(Kq>)42DU-AQed{bqdva?6kkT$7%NBMQ~ss)SE2aw;FS@6PX-q zpwH-Qi5{p@mCJ6E+)yh*qwYu=r+kM8hfhZQXMZ`^Mv)Q||K~F`qW>Y!)c*G}=dLk) YSH&K%-mM}8&p#n0c{RBr8MC1O05v=Ba{vGU literal 8941 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 diff --git a/public/images/api/qiskit/dev/circuit_library-3.png b/public/images/api/qiskit/dev/circuit_library-3.png deleted file mode 100644 index 7fddb6d79c5f766d34a8dc8cfbbfd003b98b7e12..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 15203 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 diff --git a/public/images/api/qiskit/dev/circuit_library-4.png b/public/images/api/qiskit/dev/circuit_library-4.png deleted file mode 100644 index 749a78266a13e3dc612282069fb86c76f0632e52..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 8323 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 diff --git a/public/images/api/qiskit/dev/providers_fake_provider-1_01.png b/public/images/api/qiskit/dev/providers_fake_provider-1_01.png index 9aba2ccbb8daf02943016f01fad82edfc1ec4213..26865a55ad59bb0b19466028caff1ca8e074eb18 100644 GIT binary patch literal 22304 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 f|IV4V3tN~6H$2WH2vRkmkHTJ2yPPX`E#4M7kN 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 literal 10953 zcmd^lcT|(>A{qpgYN7WQS_ole z6cLf$J4gwE&^rnHedf;0{`TBGXLs-J*+1?*2PFr>`@VUe@Avy@&l7FUi#(h7H(?mY zgTHi67sJ-UOOAk_xZqpIzIGaXJLPu%s@oMOYd23zS1U}z(#_f4$<5yO`aTaU*W0#E zj?$8+B#$56XXEDPd|O^h%Hf|kNIJRRlG?Ay*#;Nc=zPiOHim7{ME^L5p3e?qnAi#Y zxzl=HQR7{{ruy!sYf}qD2W*}id;R{R_UF^*3%1{T@&3|DTZ19DH+!V5j|;WUEbzks_x!T-Pf_Fv=WmkQ>( zv7zDNM9paVHZv~l?S{h=5=~1p!{d_W63@0`(em!PmX`0jtT4yk)!HwutPo~L>fqg^xWdAd zgM)*9!#PeRQ;&rG7yCrhGOVD~u!x{1I}VA7iK%T>SK9 z`|%Z9`e9$W4!{chwbB3Kmoj&sJ==0hkXOPa|1xQIX*gC~Qc{zXn^*7V%{VrL#;zjU z+u5Z!mP}nZ6|D(hN^^}@PU!PslQ)$;cK6b!r>AF^8JX}$-(@8vBs6N27NVFXGn%2{ z;o=7lobl{*dAvMJKZy4kO-__?AJvN#;|d^1xh;Pc6_RrL{#sNhQ>1rGnXI0nVIn?6 z)V90CdwOQ(wua|PLHXN5&v0}`Ce0w#Al;2M*V3UUf|Z?HA3!(^E532##;4DpXUHiX zJa|^x`kVHpOTT?AFPHV5w|5_JZ;~Z4JBvnpXf$Tw0PoMF*q0xrKnxd z<4C?bK zSh&QJ62(uSKH2tte7MY-AZ9W$D4K+pj8I%?XsGSV{P<`~W-JbBru<0nLs*g|c_U+qu3JLkOmCzd!#bMel^bl#KtJCWE z`s6E#dS+(n8D^B?u+2O?`u_g@Ax&E_RrUHYNsh4|n#G$pZ+g6W*3t{Qbr+ajFihCf z;k1$G3QRQ2GwoLBbh?_BmM6ssWzVUf`4o^A?rot(urnT-TkM>P;Ir*4>Kr z8!|q0;)DT|6}%@F*XH`>-TU`v`1ttH=yMe1~4jQ;nxcK_H7K_Z+uYYmqE-|w3n+wGqQB*WFqj;nj zSo9AJxG&Gz`b~Y>O~Mh0L=jO@yOsRVY^p*P}^H6l;& z%ey6cFgufTa*pG5VLTi-aNt#F=%BF_T)^Gky`Ab?fUE3tJ}e?~o_njX-s#hKaj^E9 z{4zE#nlmjjQ&Pn6x-bLfJ;st?HWuc~+PD51`s&rlWM4TcF5jU;Z2$h#P!VEMQsHjL zUOamE&=!CrV-9v4?O#-sAf8lEP(TU^aqlhT;M=uJja2MLKakjv44p?`U78`qmHMrS z?c1knQsC(BAb#wa&iV7_zgAa=;>d&+&8exW_EJ9zK+Qq?Xx)d$KC>h5;OE870*YQ) zDJdxk^YEnL;NT0-1(W?&=980>E|D6^1Vf%*epQ8Gq3`Za#vOsma%j)1n;-8m>)=0j z{Q=BY_t_C0e2}k_h=_=7O^lM*ks~j0@I)FqIy%O=)9{Y?x^t9=%`i_|2a(56Q9^$w$(S$zLTh z4{7yhNwRjy?m(m>#+P}jC3%fR+72_%X6W0Sh~rjjR4W#X<-WS;(&b#vQ_L)8xWRL^ z7zIEL6M%E5X=<{6pSpMdzL`^g&^CELs}BV(vVYBtvS{N`-vr9@J=LdkDeHf=`nnSu zR2co9Dh93@#)U;;gK#Q-H7(_dOE8;TO7nGlyzorSMx^ zx-uYo*@DeH$F;6v_YC4hYxaO|IHNvZok{>^-n$}8QHP<{+l~m$|1CcM7rH_LS3q1G zP6#?!VOU7{&Q&}f&lKc^4SHe1Syt@M(9_YGik<;-m}gne<;ly9Vf#TEzg?r0xN(Q*;gcr|yN^R5qxS#&T&Uxp_u@oF#h_2?KS^W3iqpTrBQ=kF zgi;_kj9`-vHOeb#3UcsN8QTiDFuXC5aT*A+c!6-d zR*Yiu3X>9iUj-;|lu2+S!fY}jTtN<)b_NG5Bn)?hJ$v><$T`KZmuiTkKPp4QS)L-g zy1I=tA`y5TkC40`#d9JIH#jsTrmSoZ9Qf&zCv|r@xlI|XwTc*~9cwbd@!Rv~VK^oB z;y};JrQY`T_Pt%-5w!rGdx?ZdPJBXw9ZZo3Mem&Y`ubN95h;LV7RkxU&|_h7d!t}A zMsE|a#f~2KJe8ZB>O$|8!Xp$a@2jm0IYhou!3#4RPx>6ZH}m3NKfR031$9(a%ND+G z-n^OMrUXQbA3jWDqh5gnq5qF3%VW7UIQ(AXYWAj0n|AKpiQ5|+D54<9`|!bo!zwBk z;~fQS-QMe=>m-NgxjBle-k%S|;fZT2J+cn%GSv~XRT3QMLiPdC9HtC0`` zLTsxe-$CAYJ`G17igYpnybynON!Q*!O-x*z?9`)-CuL@4n%GhJ0UcA4lAOC3y&%f^ z${&j#I&|@nX4DJZ25#%&)8TDKiW;D0EzyPmUa~6 zFdnInl9H0V+ryeI`LLmGBenYnhlkZk>o__2goM(A1mse3a&$>Mw{3e@R;CI7P)Y6v zx&S{s4$TEHk)R=fwqL=Msb^&L26qI9JGX7ywhZZW^`EK$INUQ<)CGATqf1Zro`(9p zM3Q$OjXQmx%a*k~m+{#6{DliCH!7aD=U4?2OrW=};PFp*_bMO7+jZop1GRY-9i2Ws z?TXj6u}K0+nFoxa#pl?uV?ad>fKA{kJ336zx&X@n<|=|WD|UO?KyQS8a)Um=>jKN* z`}ya$ASR3RVM-^xe}4d~RE-2Bp18Q^<Si}<9MFbNVPe2Y{BRWX$ zZ~LRQ^{PW#&iUc*(IGfs0_p$_4WL%x!S)<~&=L~Co@;z%kZwE}))I2azIv6$ey_DWXb%S~9>N_I7=K zBYg{YoW6YKomEvB{gHs9HaxDZP3=Aj^OCEmYrlQdb9T;RU~6Y*V2=7Z@?ZdmYv1WW z5&0E7(ztj97e92Igf?MP7tH-;s^y@rb-|mMt-H7v$dt|R_co|$Xf%zr<)RG)KHlP^ zA_ExP*n(TY@@yL}0K;k;2v*6sDD3@%JDf^Sh#WO*Sjq3E`nFIsZ^!?6SB?2^-A<)T z7vQ>fDKMwYwmLKR1WYVfu>jiTy(ZsUS4YI}Kl`Zg_DS#+RN)~(VTE_C_oAQW0^Vd? z==@IMF()`>Kbo=0@tS$_{)vf9W*3FR9EEu_5A*2K<;!lvLvUqTR}JM2S;RGe=n{OQ zR;)qAb0Jx`5$(D0js@c_8vtR-(m8tJwh_Nt-UHnTbQ?N@v4*(BE(zl}*wCWeFwko; zN7gUBd)brR=~uJQNKt1=z(kM<(BFSOJ~5H7G(8w`?8c+NA4?iTjscN9Otc$qOwO={ z2B<@;vU#`UNT{KC9dM43@B29b$qMJTs6vlI@lHn10OMu|qyunKJNYr>A%HTSR2W9m zU9RU&?%!8e$Fvlu9*Aniq}A8!c6s*rq4Ea`{|;Unf_yN}x_0;P_hOSkl>ndAa;>X% zt*sLnSCFMtFP>TQ9`tz8Un@-HEpsBSn6QTAXm#(-J~pl4`0cmfUW6Nl_)UNdv$!ot zS8+U`az$(==eda{v4Wj4hv)@dBb-(Wk)O;wMhzXP0wen4FCp zwm9xYOyv_d7@;S|8fa)#Tg?#c>}33w-Ta`iea5mY_!R^JweMe0;ob*&0UOHkmfe>Z`@v#j$9?;D8Rit8 zw8~vX z!P8^Gnga;TRDeGiwdVlw%2W~V{bzkyEr}`4x8B$UK4y8JHed+B2e8Fwfhm#La0E0} zyn1-?(7$6c_DOadS3MsP^m|k3}!P-iJq49#9asA75S)^uZF5 zFwfnLsoVsL^7QG``tq$RsP*u=AS#iE1hX6uwkOnyj=z6tbo@H3Hf^cZtSq!W%kuu2 zGiQ)sRAEmABlmK4s$#FjoJV~_LugD4bGZlvIm~Yo4oHYOGLrHgBEQEdiQ|ixh9dd4 zZ+{Q9_>HXjKN1zE8^(kez;E>R^a`1tlQT07@X10$LO$#`q^-MhCAj{r#qKn+|MbLccu+?Owx+{apVO!Dnr90;vhmLPiTfVzp`!4uIx zbLL)7Zmzz$xg@<`=_tS~VsHd1I2ihdh7_jz)cicMH+Th4zWw;|3|==}((H$uJlU~J zK3aunPHKduM7oyIoSxwTh6a$sOGQORq&Sc9_9MWnI|`gy0CsVBAS&9y!b*7_c5Hp2ES&Wdp3*Vxkw3oXO3L}t5zt}Y3P zN&>JpJP8EW+y7&>67dEsPJ}d?i8DFgK$xK%TEHfBoBn}+`0!yea19voIY-q`pFWK` z4S1iwTNES`Es+i%Mx#q}>N*Pfy>EY(p?hJyni6wL4Q3V3hTfhxUAGASu^I8xrFxQx zx{PzLDqiWd*|Kt}rv1=*To*S=C|EM%Ba*bD0Qmv*+@CC@-$3A82m6a zaYCVRF9+r*2fiL?w+^$`vv_0lD67&&n3 zX!NJC!Cf0L2@Md6xXP9mL*TXgUS5UOe0^$vnY3uOcg17X>o~B&O(-@>Nlk46{|x_k zo%;rU zUETZh9^ntg!TEaS!@UfHi~uCE82o^7@l9FV(Cw6b=NqA}$0a#2{^}2o>%LW2>)*Lk z0tpGru#$YLAWp!M>B~b^Fp2FAHHLkV-$@b z*Fd~}WrCIoVjQrd!z|2Y*U_ujJU1GO{7afMVV9TZ_n2te(`V;>89V7c9p^FD`VNFE zzJ76PU=GOPD2zIsW!c$n-2sngUSrzY+Hc>!-M6%8YLCoVP@*8k)&nW~Drek%vn$ZA z#Wj1vSpqIrsQZtzt*d*TQ7&D&JSt9h=$KDw*=&A?=c$Xd7E@z-jICHCSDCvq^P?NL zvN98Qh$w%wDrZdcqmU+eCRtg(LcUT3>M+de$l=460AB2xZ()*Mc>_=W``^_tYeIZO z6lt`CAIDGZN|IhES08=MGeE8VEeZTk@nTzzE=KDp9$%7fo zuM4OK)zKwlDjm}qxe-7Qq5z&hO3OogMO6g=Gi(Pw2O*-320JKzz$W7`EAry~#6t^Q zSWMXmWv*6I$?|9_7)q6Wmcm5I74Ru) zL1=(jP5$k-p8($IEi^W{q{Mh$zZ?iklJ5c&yzE@cE5bd$$EnxfRl;yE(oAdsH=btS z4Oh6K5u@0al9rbDF6T4U0@Q%VM7Kj142k9v@0qj*57wuG4b@Ct=q6BE^Bo3Ym-Fq} zV@q9QuXu#FT?1pk`R(cZrYhl~p+=y}@}L54f@_xg_HEhcQT|)7N@3-FS%hjN-_ul&(?y@ZnLSD5NC#KwyZRmBmR*fmA}2 zIu(VGT@+7GjfDr@%1b|XICK^3OW*qb3WqFEu<(q@cA*gd$HN2zE2h=ds$Ak~mTIiu z{F`p?;pnO%pavQcW-nJe`QJEe6}0dpL@TAR@G3BjX0X3zVJ{9tQbAk%B!!$Vw3MLE z(PxB@)dn`hy5iIphr&GS_jY+Z1F_?7PzUI-RWM+tO$v3siZx7Y7pz1m5sBD?}g zSebJa#WvqwA6sTvtc@O{vVI&=sSD9kPX047ff)#)`vw%pgWTd*^2w{_JMq27e_q-T z_~f5w4RBiTYuX03P9E?tDvUgNaP37kqmn>8qIflrl6Rp4B3@=nPs-?@cbIz+;( zlJoNofSjQ4j=fl+0ufR>Gl&0=Wtx_aeQVZfSZzHQmuv`#WIV>MA~FYZ)VRbe8*RF0 zGLHvjR_-IUeK}h1*Fyj$E}nXRK@^X8G1^=(r;yf#{?G^9P`us)tUC$vE@8^Vm?~y- z9T7m^32Gt)C^j%>p9Tf#U%vbd7Jj(Sliu9aL|%-1QCbtvISd`6IHd6<=O{|*Ai`;y z9;||zOopg}@m*mek0Mi0RbBn3dlIa|Ze{9rT0;(l*s4K>DQc784$tszaV3`?SrG_x zq4@RI*ev9HBBIJ@$u!i_d5PkzLor@wpo#3WxxXUAfws0nL&RTL$>$3o8A);I_F7L% z&st{uya_lMTa_18!2}8i{}ZWn;Kg8Qog;x}VNsRjJbRecH8nMSC6J*Vb#ih7zMTx! z2V^&k(nxqOGC|p^3)w#0CkYNa0K4`GZ#drOJn$~N+iQS_!K6%N$fd`{{ej$(K{xsI z&Q8-vF+vFtOJm;08q=EQWFvqx=WzNB2!$0ofhWDDeOMsC=Q!5=oE`Gd+`Pf90H1c_p?3HZhap&P#60H zPv|v!!P>laq_I4Zg$UH50Xg~bYjh|EsJ9_xnE-#5o^N=D=&T^YQ@X)Q^RFT6l5ELC zBSD2dpn?uQAjNY&<_*ceqyP?ukVn*=z>S5^iBe0ht-@)(%%Y10ovwjM7ytl)5V8fI z4O)1gN^?hwekz)?FgUY~hs28?BAX8ULsU5E7zv<5hPTC?sq=wKL7-<6Emr$?BO#}) z{Q_YY5Ct3d>Jo_42d6t>@Ge&E6+C) zkzI-VF1x}(1O|*E190O}wuLf)gTdmUkv`)1H9g7+2x%`tH!#&mXo?n;9#>dkq)ng+RK z@yvGx2}tgDt(5jxQe}6WuCqBnTVqX-K|+qVW}iiCeBj_gJ^=wp6Q$sgg!qvoctD~o z$~P`=I5kBETNv(GMR&7Xoa{pjy}U4y31KM%1b-ux#+YR8?}}8KI_#YcoLWM*F-XDD zE=mFN&tZtun+z?;l#&ZmKe{EekE(;GoFTx5F)qX!*t=Hyluz6~BW((RSYaC$q3Yq0 z??0DnK?hf<3C=$yhKd{7fscqB05DItX~Zg1Kbc#wJe*)&G{N8I-C1%);IYtoJD3fJ zPoSnRC@V|M_$IqFaatSa#jN{QUGJDZpRxU+9Nq{2xZco zZbBShg^j<0Vo$Irb{IB$#dMnFUhk>ozP;MFm6(-q`HgGaEY)|x*t6R^k?hVe5P;s9 zU^u|gX)bgbNUM&N>(CBe@$w-eJJP+wp}@$A#>&^fdey6K748qe^!0Le3Y*JhgZDwa z3Mz7rNrK~EQRtAs%2NVPi4ROPaS2!iGCnc8aA01i{Wu?-> z&3*6?LqHt;lyUc@mI^Bm@w7;B`;%~Eqilt{uaWcH47PO|97F0xU>5rFrDe2|Z?pWJ z#jK`G3l#$R#UA0U*MOHV&t*^OWWx$IL8rh1*?Zz02P&y}>se2FU=a9~N2H`O zcM&62xBo+wDcdm2Gyw)PRJk^AnsLcbIpK}iuRnub`oH_Kc8$|m X?k0_FRNM`JgyGL?p369M?cRR_nMM9P diff --git a/public/images/api/qiskit/dev/pulse-2.png b/public/images/api/qiskit/dev/pulse-2.png index 8610e973f40788fcf1fea05865afa3522e679834..f4122c6c55e7651dc9bcbdd05f5f18f049c943b2 100644 GIT binary patch literal 10558 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 EFBk-uVgLXD literal 10597 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 diff --git a/public/images/api/qiskit/dev/pulse-3.png b/public/images/api/qiskit/dev/pulse-3.png index 8c9b2450de22b5efcc46689f8bf6898e15934af1..1a7b2cdc195584adb381c734c8b1191114b87d29 100644 GIT binary patch literal 59510 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 I=FMaO0qfkZ9RL6T diff --git a/public/images/api/qiskit/dev/pulse-4.png b/public/images/api/qiskit/dev/pulse-4.png index d8f2f828847f04d6ea2bd7b3e90419ba756d6211..bac0d6f54d914b94b13a68fdfa0f717d71eceef5 100644 GIT binary patch literal 18900 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 dWPat4jEYsqib|wP>e2;e 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 diff --git a/public/images/api/qiskit/dev/pulse-7.png b/public/images/api/qiskit/dev/pulse-7.png index 532812ac07bea070b7dbc4c82141f83de745e68b..78f0887b1a60bff8ab86dec92bdbe2e122cc6c57 100644 GIT binary patch literal 13972 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

bYOHB9m~ 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 TK_t9G43U+(Bl$@}_u2meW+JfW literal 13655 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 tbbW_p1N^ diff --git a/public/images/api/qiskit/dev/qiskit-circuit-ControlledGate-2.png b/public/images/api/qiskit/dev/qiskit-circuit-ControlledGate-2.png index 3ea6f8198ccf7e376ba412fec64e56c792cdbe33..9cd5aae04c1aa40d268b05d0165ffeb25a6c94ff 100644 GIT binary patch literal 6891 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 IRC^flZ_!zc=Kufz literal 7028 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 diff --git a/public/images/api/qiskit/dev/qiskit-circuit-library-AndGate-1.png b/public/images/api/qiskit/dev/qiskit-circuit-library-AndGate-1.png deleted file mode 100644 index 7abcf5b2aa56dc8f331ea1ca4c445fdb419d04ab..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 13136 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 diff --git a/public/images/api/qiskit/dev/qiskit-circuit-library-BitwiseXorGate-1.png b/public/images/api/qiskit/dev/qiskit-circuit-library-BitwiseXorGate-1.png deleted file mode 100644 index 5733a7764b3ba89e66bfec887949b3d571e2d584..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 14297 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 diff --git a/public/images/api/qiskit/dev/qiskit-circuit-library-OrGate-1.png b/public/images/api/qiskit/dev/qiskit-circuit-library-OrGate-1.png deleted file mode 100644 index 47eaba972ed77115cd4928292502d6f0065a63eb..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 18708 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 diff --git a/public/images/api/qiskit/dev/qiskit-circuit-library-OrGate-2.png b/public/images/api/qiskit/dev/qiskit-circuit-library-OrGate-2.png deleted file mode 100644 index d132d4d82782ce38c549e623fd09a837c3933b2b..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 16530 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 literal 15998 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 PBlqtp%YT+Ne)&HDv%pM* diff --git a/public/images/api/qiskit/dev/qiskit-circuit-library-PhaseEstimation-1.png b/public/images/api/qiskit/dev/qiskit-circuit-library-PhaseEstimation-1.png index d9003ef4c8b4712d273b1b558c730bcc331b9595..d0e3f88f9d62e095344b7259ef2629db8fbedf4c 100644 GIT binary patch literal 12161 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 S%xLf$f>l&k$iH^y_x}Z;&}bh3 literal 12170 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

e0t7TAp!{d%t5@Bg8*AIPED)!Mu$% zLr|iCO6EI%UIk9iXZ)?oq2tH1;b!M}dB3&c+L9D4K!}#EimrkBIw_%v1bvx!BRSL_ z!KW8*_I&JiiT3T=HmZfY_w2Ek(=s%SA_F@U3kB_mYy1rXdGb((DE$Fo!#5 z3?i$P5CF@|BWzBHz!eSQn9$s?Ul^@7gcL+?oLgT0tx%9C<24`e!Ps2SEhszV$J|;i zVZhv00j9sy@vkL;be5`&Am$Jm6<3p3KX@-$y*YO28jL4J^2*bvQe$Pk3P4*4%Wi=_ zUhcl*lnqi5SZ$F;%csdCL3X1Oqp76@?idG>?>+R3ZbRbffd+*fG|<*|u3rxi4@bLy z!%W6176l+8P!MRg-MeE z+>VQZ3h2K?DDWH{JgRN&TjQmBOs$d>{EHtnaBOW(Dn|37AcY+VScWH?`udi~2iAvz z!k{ZrsISrsH(x#$Dj?ieCH*KUshzb*q%PD4e9O^XyTvitVo-U=ZraA1N8kc;9}UzroGu<$af zBXT-q0=6g?l#(9vE>KW5fw;W9=ApCYpzi1A=ke1SaZtHNiCCChGP?8c7-c_bj=5w~ zZ1dKi0n%1LR8$YbP{v~>f^FZayvd|MbCd)>fF7T@k{({wf2vZHFVF*q>I2nM77<1V4;(mvifmew04@uV?o~*L z{;gXf8CppNwY673a!fzoc}g3I4O2NM;ftG8PxM<<9rRxvTzQRH0Mdgk2}#5!CufS@ z1&UROeh^1cz+8m#k@DxWJ+Wf8*wo;?$jC#D`B4JXB6XJS1^zFA7z`+aB;VKtw07(T zCP-s1V0o>aJL~Vfc$RHJFQ?dSq|g`MoCcCtrbp|%5g+f@+rM86G?aCs_YF8*^k@W$ogm>*@1n$Mn2|#? ztM(}YO*ry%Lk&gr&=NZ`KT4QTm|?1Ct>e>&M79YE36W1YRp|`p+B!p<6h9U!i-s2r z#mw~lg0C3?238{y3Jf#f8vq$5H2rqh_W($dl^!PCD#e{SgA2Q_jMTBJ`++0bTt^&mxX9rS|IX5ej`wV&TtFuy~c8^OB; zRzaE9&MH(|MMZhGpdfYwV4*8s+6|m*{^`+*)#S;fERPG=V2lYQ~$d^jC0SVw? zWNe%bQ-R=cSlSI$RTL3js_3&4=-i_H>il3gr0~O*B*kIC8njw30SG}c4@kQk(g&RK zJgAh72k{<7P!-NDDJ*p3?KZABP~Ka)p;5Tns^bmsquMZunJH zR76=C%yGm-MOp3GvBRMMc~Y!`KVJO7myldcAovId#>TeB-Sr&L6J$IJ(eXgCgK-qC zhrl4CcyC~Cjsb{86<#-pDX5w9AS)`}aTT5a6b3oQPm}0?>Qz*IS)jnWU5rN8t^Afe&w5ZkAF$%)6V)ES3iFIh*Iwgb=Zk%WkE4)P&eBt^6uijC*Wv_Km58M zmZ6DV1~(5a#`~bKf%j4A9T^c}>ggS2iAq`>A0Irt4Vk6@WUkd&uXhLveO(yCLI@@bwN#u7N9E^T7~i9Ziuahn-f%JAZ#t zT?v|KCy2TC4cvjI@R=TPkL>k%kYo&smQdcHjwCz@$|DRQBYQ}|R^gU=oPx+2osRlf zE9c3ooggf8AhR!k9)odMdW%y)YF1Vj#iT7VY8oa@K^AGD`*izu%-OSNp*E87_Vu*~ z21k*Z5U_>1kEt|x6kV8-Ft~B!`R3LZS}UOyDA;J|oCk09Vv_);Bqkn300=&#X}K7f z8wE3@Ph^`Pgw|nhZd^>vG3D#mp#b26`2p-Dzv-Vpf2MH4sQDDz zx6i2XY*vEu9nt3b%dXbX>_?_A_dGJ2*;T)~3u)Gg9$qimjhs4lYG$CK2vf8E!vweM zFVh*!h}w$~ECmbCW_5)`wnaQ7IC8u(0{b~%<{Arv@q^D8Bqq5Dm2dzFjC^TGdifvS lsDID`yp7I4!MjsTR+6wAwOL1w6aI;)Dr;UZxOVr+{{kB2ww3?@ diff --git a/public/images/api/qiskit/dev/qiskit-visualization-plot_circuit_layout-1.png b/public/images/api/qiskit/dev/qiskit-visualization-plot_circuit_layout-1.png index 77cc1c047f4a7f2d2509ca084c2ae79ee8e6f573..73e6aaebd41bbc05b34823847bd83bd610a1d359 100644 GIT binary patch literal 10166 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%0D*b|+D`B)5_}+^ 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

$Id%i|2&yk55exzD*&g#A(h#esl2Gu?&~R9N?DL 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 literal 15297 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 oKXiWljQZ?>gb~R}Bq{|48 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 K?-$=S5Bwh+^@$?@ literal 7929 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 literal 26319 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 diff --git a/public/images/api/qiskit/dev/release_notes-1.png b/public/images/api/qiskit/dev/release_notes-1.png index ddf2ec46f72cae3ddec6f98579426aaa12c24c3b..889114d83ca9582c2968dc55e2b4f1f2d5cecafb 100644 GIT binary patch literal 6507 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 M{fQ0~scie|UxR}N{Qv*} literal 2801 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 literal 1454 zcmeAS@N?(olHy`uVBq!ia0vp^jX=DBgAGV(2k;*TQkEsI5hcO-X(i=}MX3zFi6sR& z`6W4-NeX4DMa7x6q2;_q*7A0B9Aet3I({?^A!gEV<~cvuu{ zYJM0T6WzAVPs;?mO6+Dfcqt?ymGe*D7+gNE>?c#ja4&6_vN*i=l2-Cg$g zQ;phW#o1?>0@jA@EO^Ltdt2_}{rl$|r=JU08S?L0QM6mqHx_SiZyi0oqDMzMOP_~@ zhii&(y}7-8ec78^TeEFye@$^(=nx(*?%pr=^wH7oC!c@v+Qx5+*M38FR@yvcd{@$vC~>081op1{!jI>k%%-rnl%@4hx}PCsAt_gCq?{q^UU`_JD| z^;PTf5q?(eSCe7ZaDN~ zYc9*mkggiL{SU9RPFkbfBJe1#<qWs;#W_FS8qo&)NCQcM& zcz1vQfAeYAHwlS4Di=?fHFe2H^UkgX6D>W?dMyp|jc}^y1&1^KYgO1*PW>k!e8|s*jfAA3>Z7>Z2gvB=Hcbt zdbi=swjDxOx)W+@=6rY`ap0EwZdQhK4nny_su%tnGl2>fY8EIgf0)-)t&~-Kv;8`- P>}2qC^>bP0l+XkK{V{&^ diff --git a/public/images/api/qiskit/dev/release_notes-3.png b/public/images/api/qiskit/dev/release_notes-3.png index f26d0ccf0067a42f78e27c163f8cf91e0d7d15b1..b7ee0054f41adc6b8d73fe073e8d4cf11a3ea381 100644 GIT binary patch literal 11731 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

n|<9AarWe*RJC^q1-JJP73oG{t2IT?^$ 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¬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 ar(G*uxuLY4=m#E^0S{EQRZ5hs!u|zsE-<|cq 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 N=xP~i60h9}{6EybVq5?K diff --git a/public/images/api/qiskit/dev/release_notes-8.png b/public/images/api/qiskit/dev/release_notes-8.png deleted file mode 100644 index 59b2d17abcc26f2b5948e01e8ab417b0dd23c177..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 7069 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 A$N&HU literal 24671 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 diff --git a/public/images/api/qiskit/dev/transpiler-17.png b/public/images/api/qiskit/dev/transpiler-17.png index 8f9256b1af4c7e1789708db63e96ded100433595..4ed1ff5a588b6515450ab778c0491e24aa18b7ce 100644 GIT binary patch literal 18840 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 literal 19726 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 R?~qtfQn-IR_vVA={~N3w_t5|V diff --git a/scripts/config/api-html-artifacts.json b/scripts/config/api-html-artifacts.json index d644f83a784..e50b8d08850 100644 --- a/scripts/config/api-html-artifacts.json +++ b/scripts/config/api-html-artifacts.json @@ -1,6 +1,6 @@ { "qiskit": { - "dev": "https://api.github.com/repos/Qiskit/qiskit/actions/artifacts/2129762509/zip", + "dev": "https://api.github.com/repos/Qiskit/qiskit/actions/artifacts/2083943397/zip", "1.2": "https://ibm.box.com/shared/static/nnao3s3gy1y5hyea506htupby9khrve1.zip", "1.1": "https://ibm.box.com/shared/static/bplxij6mapevjapr8ij7rluiayls982k.zip", "1.0": "https://ibm.box.com/shared/static/9mgo99x54z3rpo8irs23olqsov3uo1ly.zip", @@ -29,7 +29,7 @@ "0.19": "https://ibm.box.com/shared/static/wjoea4x5tnxd0l4lgo2v3kxnx6btxvvl.zip" }, "qiskit-ibm-runtime": { - "dev": "https://api.github.com/repos/Qiskit/qiskit-ibm-runtime/actions/artifacts/2129048975/zip", + "dev": "https://api.github.com/repos/Qiskit/qiskit-ibm-runtime/actions/artifacts/2128611480/zip", "0.32": "https://ibm.box.com/shared/static/enr0tnwaxzpvrypzjav4f1vjip3yfqcy.zip", "0.31": "https://ibm.box.com/shared/static/z19dt14je6cz69oi4knraitjglzo29w7.zip", "0.30": "https://ibm.box.com/shared/static/f950vkx3uq13o8g017bazpm4o9bcei2i.zip", diff --git a/scripts/config/historical-pages-to-latest.json b/scripts/config/historical-pages-to-latest.json index 597b2bd37d6..212b42e3bf0 100644 --- a/scripts/config/historical-pages-to-latest.json +++ b/scripts/config/historical-pages-to-latest.json @@ -18489,14 +18489,8 @@ }, "dev": { "qiskit.circuit.CommutationChecker": "/", - "qiskit.circuit.library.AndGate": "/", - "qiskit.circuit.library.BitwiseXorGate": "/", - "qiskit.circuit.library.InnerProductGate": "/", "qiskit.circuit.library.MCMTGate": "/", - "qiskit.circuit.library.OrGate": "/", "qiskit.circuit.library.quantum_volume": "/", - "qiskit.quantum_info.SparseObservable": "/", - "qiskit.transpiler.passes.RemoveIdentityEquivalent": "/", "qiskit.transpiler.passes.synthesis.hls_plugins.ACGSynthesisPermutation": "/", "qiskit.transpiler.passes.synthesis.hls_plugins.AGSynthesisClifford": "/", "qiskit.transpiler.passes.synthesis.hls_plugins.BMSynthesisClifford": "/", diff --git a/scripts/js/lib/links/ignores.ts b/scripts/js/lib/links/ignores.ts index 3e90e77a5b4..deb24874ca5 100644 --- a/scripts/js/lib/links/ignores.ts +++ b/scripts/js/lib/links/ignores.ts @@ -340,18 +340,7 @@ const FILES_TO_IGNORES__EXPECTED: FilesToIgnores = mergeFilesToIgnores( _legacyQiskitSDKIssues(), ); -const FILES_TO_IGNORES__SHOULD_FIX: FilesToIgnores = { - "public/api/qiskit/dev/objects.inv": [ - "/api/qiskit/dev/qiskit.quantum_info.SparseObservable#left", - "/api/qiskit/dev/qiskit.quantum_info.SparseObservable#minus", - "/api/qiskit/dev/qiskit.quantum_info.SparseObservable#one", - "/api/qiskit/dev/qiskit.quantum_info.SparseObservable#plus", - "/api/qiskit/dev/qiskit.quantum_info.SparseObservable#right", - "/api/qiskit/dev/qiskit.quantum_info.SparseObservable#x", - "/api/qiskit/dev/qiskit.quantum_info.SparseObservable#y", - "/api/qiskit/dev/qiskit.quantum_info.SparseObservable#z", - ], -}; +const FILES_TO_IGNORES__SHOULD_FIX: FilesToIgnores = {}; export const FILES_TO_IGNORES: FilesToIgnores = mergeFilesToIgnores( FILES_TO_IGNORES__EXPECTED,

n|<9AarWe*RJC^q1-JJP73oG{t2IT?^$ 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¬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 Pi3ZS8*Hx=fv5WW@?!bil diff --git a/public/images/api/qiskit/dev/release_notes-4.png b/public/images/api/qiskit/dev/release_notes-4.png index 2d57244a1b7f285e21b9a3771beea2103fa2362a..18be4f78c716b7fa692231f7843bfec598166172 100644 GIT binary patch literal 8695 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 diff --git a/public/images/api/qiskit/dev/release_notes-5.png b/public/images/api/qiskit/dev/release_notes-5.png index b7ee0054f41adc6b8d73fe073e8d4cf11a3ea381..0c0420e05f89b5a9c341f1e23a9d6d30b9c8e466 100644 GIT binary patch literal 7530 zcmd^^cTiJZyY{1~C_D(*P^w53Bv>FQ3K0cqQWQc71Z)r>k_ghIDkvx@Afia`0wE;y zPJ#ssy(SX6^b$fZ0m8R<-f!Od<~wK3yl3Y9>zvGFGPAR?v-eu}{ae>{?N`Qz+B{r> zTo4F^M^{JlHUzQ@1K!g6_kklBPYde7$0au{3pW#-y_@G$LdpK*3DJ{^OEfb9`600!u_2 zc&|8{q%Wj*1=a$@5CRof9jo- ze5QLoHddzE7E?fdz(lXGgS*!olhE*u6Jb3J4{iuwYv3jd0vY_X9|JiHxyu9DcapHH z7V=yfa{OujJ_rXN6>zl92>l`nEhqQfZ- zkv#)@_oS415cUdIYC!&<32jC593Q)Cm{ZDBPg5kT<0a~{>Teh`XAxd)G`RI8o|q^|Xs|GUf;E zhtk?C0=ck~WS0FG`Gy6@uBjI^O8e3Pwk!5RlUNtSwPN|*fNwUOvW`mRv-QC za^K0T5PGqi(S>C8M4)qEkbu)2GabLcC@wKjC@>8!q zJq@?aaiq{)+dRUdL-p%}Sl!zZZ%OiHgAdZ3`>>95Qc>~a^+YGJ*=_j7=BBUT+-FXD zvEw_#go|wsm*bm0@k`ur82S0Ou!m97P*hmBlm*|?#gM@QS)O~&KMj+stSRDgA< zRS0>JEiAM_QRwGu@~F}S@>LH`||^bH`nFYUvCfG>v_o|1ap}AT`<*Mlx5$N zls7l`sAi#FUhsnbYj9yl#l)D*L-8|Vie%#(H-cRsKRzlVl9!Po+2`^@q-2`1wPNMR zn#^LYw*<`okW-xfVf(OS$V8@?9V|w*5~ySuD7+F&J6%w-Wo+s9{yl=VxInUU-UzT^ zmx#uyUj6);3^$TjQ0NNW%Uv9>?XP>g4BHnS9i8#*n7=Gqh*!MR=SqBbFThEoh zdi}cdcfoySr%qV~Te3AMH8Ty3<=0{0da5!4k!eET`$XN`|%pKF7Ho}ONN6_ae`vzLq;AWyZX26-^(qvK9J;dz&l z0W4aC$FWkDdh@79)$-tH}^78V1v>wI^UHxKALuPTYl7dy~O#}iFclK_ejqkixL<^raG-hFOQH_{a zSlB*XI!>?hBw@+xW2z1N4hm;0W2o8L**bld?(gdEwSi(QcJ6`kh+g@fj&yZJ!fG7R z=5|+wi=pP3T*$R5r4ifYaq9YdFTdD$*d_Fnn-b0$ED0_3&EA}Z1fl|=nEXAwq_MG) zuCf$+0qxY9qG3SC8iXyrpWfZVc3cvap!yTiEWZV*Q)O6YHdcuc=%d*B!d)zbL(3N_xQ7y z_`6QQM?|o_wZMb5VSctozLg@r{H_k&+iQlPs(RC+RrL{!z(FPY>{ zc~W)S1$6To{sF0yHI*x+>$9?F1?5W9^6Xr(x6lhNrcu`AyC2 zw<+P0NqaYYDk|#GrNm~{p~T3@l)}REBC2jW=GHECTC3xaE{?dVsu7usEpS?nN!Ast zZTkHm;c}->=M>GX%@0SJj=!!dE;h|FOvI~okRw4+N_X`~Ha`~7X<9>)<_7O9GX`tA zC;t5TGh$u(4bzkRb|EZcd7btH6VMEI)l<7c?!VLX5js?Y?z}#0lT$6hLupPfv2;r)4!Qz{Sot2MuMjhejPZh$JYsABxZ`<43*AOGegwe`< z(a&DzV^hI>8^oU1(vN{6^z=fb-n|=jQ!VkDzt_$17#$m<20ym6jLoRLYra@+-&bdm zN0s)oZfI`Cnpym)t8*N0PK>+ga*t7%c-a$gl4UqWUw#-co|Wv6Pg3)tT2enoMn)bB z=p+=wd{yE}mU#->D8chjq^SqjL4dvl*?6|Z5lrt6!Ux^{|>y}`uv zmbD7p{$t*)o{!W?Is3JQ@5 zt`$ghU>YALGU~9^&=&^|aBArsmgcv2P(Gs|BwjSAFZDWS;zgHhKf*gLqmzGO z%W{1@2m0@{nJV%+Z8lQ=gui-2TnuTbbZAI}69{G@LTJ zSvbP}`wodfalMQ`+7e$KmhpBQ&}ho)(BBLGL694h+l7C@E#Q5Hs2T~TcfIO4Y!a+xwE8lqH)}M} zrf-(O`GwPjxhL-j8W#kTCeIw(qs`Hi8#_QsPrhKxf zge^(s3e)%10gtV1PEPM4&9&oqdG@5_x8BL~bBQL3wXQ|}jJxYsu~$a%x1H1^&+EP_&c5p&YTIjbPuJ{^7Ymb4-Fa#ig8F0?@}>iAE7FG9Uc1rbDKNPh zAlCKD1gaaASA#fU?%5WJshsF9@H-lS7_`yRT;!uZ)gVp}WUd_4MB7wAjl8c%Ep>$+ z2z@i}JInJi1j|=zJl?-D&`OAKu==OfNNK5jgQ*w(lGh|uVsUTADe-i8-1kHGS3M8x z%BmpY5Qz7o;fNN^?$fH*e(2$|xM%67@g9eiY&-cU_D{p0=gzeaNO`??_o$@kUzLdS zA&4j{&^iwO6(9nnRpL>Mef*}6}n=@8~9kw=7h`day9kA2E zC*>!vXFnSgC-htdHe#f4-t$D%5x#-B-5*1-eE+iTV%S~woHYe3OiN2Ua^ghJ{O}KX zMMWcie*QQm$0$m}b)nmnc&E8@bm=ejFxbQ2DS%XtElFx|YCff7P4QU?3BqqqT(|+u zO=v{Ks^=@wjd_6{w;t*n9wIkt>l1tG%EWM}vBdUI-6ro@6O@Xh9i#BGC#ijA9F7=j zGhxgBl^0r}QJn$gMovzSo{ml{YkB&ps3=r7?r(iJtDt-1h4StW8mGS7GzW9CD(#*7 z2LZ8d8w#r0ghZ|~iq*%OQ<84^mVPPe1lkN1B58$-2Kr`x`BD9^) zqIfzkUEd}MbhdZv7P@j7IxQJ(=Y-Z@AS)cq3(sGPdj0yZ9c)0M#LvqfRj7j@ppeGm zaZ{h-u~AL-CM260Ukj<5rM`U{BF*v?hboRscF2OEd|tUg#WtQld)L?30ca6UPEIxM zpx^78o2e-pK~6F5Grw%nf;ZBT(cY?r40ps{(LJTr7Leve7Hacn(wHP(6q~j zh(uH;JnhL=%#L!%JwT&b^}`oy?45DU{+dwSHO57wUR>tc4XyZ!KCCmF2Ce(vKN*yU zgq}K&>_9igNWL*3UteuXkkS=YeUM$Rr|)|^sAJMJLR8JSkTiCRP;(LnGyDAcGrjuB zfL7m+DljdDlSNE&p;VVkRS*nR5vn{QR7ge2Fmv*AVKSP_j!89ZN5~?>! zYL}PChrA+MRv{Y(wsoS4oi||J^bMkrWGg?_rts0wwHMEyJ9Oa@^^J|4b3`7yLPG?D`TY>4fGpMl%P%J{-vRWflJD9h zMt_YJ$G*Rejrq2_9Af3~Nh~jI|MkJDE7ey$EK~JcvO$$ijL@OZIbk$4FFPYc^U|eD zdWMF?qD?TTcmlx`Sm0i4nPIZJLRei|e*RfF0y)qS6b!2*f*nnruxH$RiTy0pK`hO- zX00MzWSiVvY54YT+$ub1c@Sm3o}*eU{iX7#9U85V4{&kmF0_k-IU^Y@LqkJ5mhqs7 z>d4orJNU_WtZDY;;Uy|(NHK z%KJ2RKSq(Be>W(YN9dE9&x*s!On00LE(ypPCHuzXK&8v8tM?B`dC%-PZ)YnNSUJ>f zIi8ifm=Yns8|r*>WJF3!OH0qd0CDYFAeCfG0{&jNedO1>t}0KQ?s+-Fu06+^2{jMc zo9lpW)b>n$Ob{{(;66Gs^5m=heXYI;mOi?``X4%c_^5yYZP2@_4;u0{l}XvQ0o-Z@ z*JTRa_s5UNcPs($9!n1J|4T4hS2yCsS;fKzL{4Br?MLF#XX%?GIrJa@DWHtmw*`;= z?mBS_4z~ra4_t6w84-`y>+bFrRC0*Sn96s*D7+H|u$Cs%QB@vb&U68W56c)XIoSSf z>PqixMzORtpRgMehQFq3cg~A3m8L6rx`B876K{MO%ESM*ElwRnmUMi$AX14NJEPm) zDt;YdhWztR5J1CwX=3P|pR&MR#$I5HA|)-)eDIz&%R^=Y2Tg}Yf;xAY?X4)89v&W6 z#`a$HTN?@yeNm!_66m`{lD4+RJ=tzt-8ANTxF=OzbsD32zu@G|#f7}IS1S{DadB~lTKy?uq&myOpXiYY*`iO1?HNuA0oxL~ z?WK&K2N-4*Hu9>rg^va>`k!vbre*5K0H><;>(?(=)kI{qSHX-&6$opDc&1NWu$Kk0 z+vL;Dc?Vmw+!9?enp~c^XqmIK8Ahizpz}Ess1uT3Z(eTAipy(>8@JxV0-}#Zg0iy& zt^$N-#ZFyvcJ}s8YjZ=$f_pE<8e`M9Hda-}T> zuy}*8V+!qQT47UX27r6t_t){1l$6SJ$$*ujWXG?;Jb7hB zz5OQ`wl^D?T2@Xax6hN-)*CcLFTaJrwP*UfRO*V;W@aAhx+_9O)qO2m;M>(Zc@Bv8 z8tjXH*%vuBemv)oKlJp##UiX0&kJ{;MnFokWy%jRak1|U{fETO13G2B>IfuQ;$KOg z2M>OSH6OZfp3gsrcVpJ9I)RAN3Hbb-;b|bu!cYlqhmEeJ0xp2;$S?He z%hpc@@tdeP8pz>am*ED~K}6Dkg>Pgwf?cT9+}3aO2fjKif8U*I(0sDz&lffq{`{!} zNVJi2iaFfVv}?^YvmsN!29+8pQMXJ5YS)f2oMr2sw^ERfk!kwqnnj=v?knpCR_*=! z_g$7|NTghR(^z5}2Lw%p_{x2A>iSjyH+>X|oy*=$rP zFqzBD0ZQHSKCUm7JYbLOob1Q~q6#s7j!(9-r)r`!p17FJ$o}>@bdtIr=zQwbDJ72? zi>AcO=2=F`)Iz%kQzQ}(Vi>PfdhJzp|A!>vLNcaEPVD4yFmI3|1F{ge7nR_8z_Bq~FkgVc^Nx3)oBZu_e#d)2=8$IG7O zr>dKQ#CtFIF7eL{9bQgQAsy!5-$)ce;U~n*sa{`H48|1rYMcq)NFmYKQi+9vuky6b#v2h2y%8lnH`gMieqD6 zT&=&n<9#-Jm68i0Bi1r00EJ7G(cl?uuZu0=-D!jQ`FVP!JEo}Y){tvX%ACc!q~Q-% zI7*r23vE56b$HZ~Hu3824Nm$gpE5(Pl6@;PLeEelQ# zc3)}#6bM0Eoy+<@fvN!^!_IW=^c8t?L7&lGq&-a|txmCl^0Hy|$c>JPwMlHN>9*}+ zpX0qcJW;f=lQrd8l^IgDx0uUx49OAX0Xshj{wB+@cOJxng;hsFVcf@guc zbN;O|;GeY$^H1|(3hP>M`~zOk`qB?VA~nIIGX8)1*Z*zL)1Gc~9J&cVBAU9l9X$7h N=xP~i60h9}{6EybVq5?K literal 11731 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