From 8608fc70201a857a2bc2431f0befe4779dde53e4 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Thu, 31 Oct 2024 01:36:10 +0000 Subject: [PATCH] Sync latest dev docs --- docs/api/qiskit-ibm-runtime/dev/_toc.json | 8 + .../qiskit-ibm-runtime/dev/execution_span.mdx | 13 +- .../dev/qiskit_ibm_runtime.Estimator.mdx | 2 +- .../dev/qiskit_ibm_runtime.EstimatorV2.mdx | 12 +- .../dev/qiskit_ibm_runtime.IBMBackend.mdx | 44 +- .../dev/qiskit_ibm_runtime.RuntimeDecoder.mdx | 4 +- .../dev/qiskit_ibm_runtime.RuntimeEncoder.mdx | 4 +- .../dev/qiskit_ibm_runtime.RuntimeJob.mdx | 51 +- .../dev/qiskit_ibm_runtime.RuntimeJobV2.mdx | 49 +- .../dev/qiskit_ibm_runtime.SamplerV2.mdx | 10 + ...runtime.execution_span.DoubleSliceSpan.mdx | 128 +++ ..._runtime.execution_span.ExecutionSpans.mdx | 34 +- ...ibm_runtime.noise_learner.NoiseLearner.mdx | 14 +- ...t_ibm_runtime.options.EstimatorOptions.mdx | 13 +- ...time.options.LayerNoiseLearningOptions.mdx | 14 +- ...bm_runtime.options.NoiseLearnerOptions.mdx | 16 +- .../qiskit_ibm_runtime.options.ZneOptions.mdx | 2 +- ...ime.visualization.draw_execution_spans.mdx | 33 + ...ime.visualization.draw_layer_error_map.mdx | 2 +- .../qiskit-ibm-runtime/dev/visualization.mdx | 1 + docs/api/qiskit/dev/_toc.json | 8 + docs/api/qiskit/dev/assembler.mdx | 6 +- docs/api/qiskit/dev/circuit_library.mdx | 66 ++ docs/api/qiskit/dev/compiler.mdx | 32 +- docs/api/qiskit/dev/converters.mdx | 4 +- .../qiskit/dev/providers_fake_provider.mdx | 2 +- docs/api/qiskit/dev/pulse.mdx | 228 +++++- docs/api/qiskit/dev/qasm3.mdx | 6 +- .../dev/qiskit.circuit.QuantumCircuit.mdx | 258 +++--- .../qiskit/dev/qiskit.circuit.library.AND.mdx | 6 +- ...t.circuit.library.CDKMRippleCarryAdder.mdx | 6 +- .../dev/qiskit.circuit.library.CPhaseGate.mdx | 4 +- .../dev/qiskit.circuit.library.CRZGate.mdx | 18 +- .../dev/qiskit.circuit.library.CU1Gate.mdx | 6 +- .../dev/qiskit.circuit.library.Diagonal.mdx | 4 + .../qiskit.circuit.library.DraperQFTAdder.mdx | 4 + .../qiskit.circuit.library.EfficientSU2.mdx | 4 + ....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 | 4 + .../qiskit/dev/qiskit.circuit.library.GR.mdx | 4 + .../qiskit/dev/qiskit.circuit.library.GRX.mdx | 4 + .../qiskit/dev/qiskit.circuit.library.GRY.mdx | 4 + .../qiskit/dev/qiskit.circuit.library.GRZ.mdx | 4 + .../dev/qiskit.circuit.library.GraphState.mdx | 4 + .../qiskit.circuit.library.GroverOperator.mdx | 4 + ...ircuit.library.HRSCumulativeMultiplier.mdx | 4 + ...t.circuit.library.HiddenLinearFunction.mdx | 4 + .../qiskit/dev/qiskit.circuit.library.IQP.mdx | 10 +- .../qiskit.circuit.library.InnerProduct.mdx | 4 + ...skit.circuit.library.IntegerComparator.mdx | 4 + ...ircuit.library.LinearAmplitudeFunction.mdx | 4 + ...t.circuit.library.LinearPauliRotations.mdx | 4 + .../dev/qiskit.circuit.library.MCMT.mdx | 4 + .../dev/qiskit.circuit.library.MCMTVChain.mdx | 4 + .../dev/qiskit.circuit.library.NLocal.mdx | 4 + .../qiskit/dev/qiskit.circuit.library.OR.mdx | 4 + ...qiskit.circuit.library.PauliFeatureMap.mdx | 4 + .../qiskit.circuit.library.PauliTwoDesign.mdx | 4 + .../qiskit.circuit.library.Permutation.mdx | 4 + ...qiskit.circuit.library.PhaseEstimation.mdx | 4 + .../dev/qiskit.circuit.library.PhaseGate.mdx | 14 +- .../qiskit.circuit.library.PhaseOracle.mdx | 4 + ...kit.circuit.library.PiecewiseChebyshev.mdx | 4 + ....library.PiecewiseLinearPauliRotations.mdx | 4 + ...rary.PiecewisePolynomialPauliRotations.mdx | 4 + ...rcuit.library.PolynomialPauliRotations.mdx | 4 + .../dev/qiskit.circuit.library.QAOAAnsatz.mdx | 4 + .../qiskit/dev/qiskit.circuit.library.QFT.mdx | 4 + .../qiskit.circuit.library.QuadraticForm.mdx | 4 + .../qiskit.circuit.library.QuantumVolume.mdx | 4 + ...qiskit.circuit.library.RGQFTMultiplier.mdx | 4 + .../qiskit.circuit.library.RealAmplitudes.mdx | 4 + .../dev/qiskit.circuit.library.TwoLocal.mdx | 4 + .../dev/qiskit.circuit.library.U1Gate.mdx | 16 +- .../qiskit.circuit.library.UnitaryOverlap.mdx | 4 + ...it.circuit.library.VBERippleCarryAdder.mdx | 4 + .../qiskit.circuit.library.WeightedAdder.mdx | 4 + .../qiskit/dev/qiskit.circuit.library.XOR.mdx | 4 + .../qiskit.circuit.library.ZFeatureMap.mdx | 4 + .../qiskit.circuit.library.ZZFeatureMap.mdx | 4 + .../dev/qiskit.dagcircuit.DAGCircuit.mdx | 4 + .../dev/qiskit.dagcircuit.DAGDependency.mdx | 50 +- .../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 | 10 +- ...providers.fake_provider.Fake27QPulseV1.mdx | 12 +- ...iskit.providers.fake_provider.Fake5QV1.mdx | 10 +- ....providers.fake_provider.Fake7QPulseV1.mdx | 12 +- ...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 | 32 +- .../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.Operator.mdx | 50 +- .../qiskit/dev/qiskit.quantum_info.Pauli.mdx | 2 +- .../dev/qiskit.quantum_info.PauliList.mdx | 2 +- .../qiskit.quantum_info.SparseObservable.mdx | 762 ++++++++++++++++++ .../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 +- ....transpiler.passes.DynamicalDecoupling.mdx | 4 +- ...spiler.passes.EchoRZXWeylDecomposition.mdx | 8 +- ...t.transpiler.passes.HighLevelSynthesis.mdx | 4 +- ...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 +++ ...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 | 10 +- 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/transpiler_passes.mdx | 1 + docs/api/qiskit/dev/transpiler_preset.mdx | 42 +- public/api/qiskit-ibm-runtime/dev/objects.inv | Bin 59473 -> 59714 bytes public/api/qiskit/dev/objects.inv | Bin 73783 -> 74394 bytes .../dev/fake_provider-1_02.png | Bin 11498 -> 11564 bytes public/images/api/qiskit/dev/circuit-2.png | Bin 7538 -> 8566 bytes .../api/qiskit/dev/circuit_library-2.png | Bin 0 -> 9282 bytes .../api/qiskit/dev/circuit_library-3.png | Bin 0 -> 15203 bytes .../api/qiskit/dev/circuit_library-4.png | Bin 0 -> 9152 bytes .../dev/providers_fake_provider-1_01.png | Bin 22304 -> 22361 bytes .../dev/providers_fake_provider-1_02.png | Bin 10815 -> 10925 bytes public/images/api/qiskit/dev/pulse-2.png | Bin 10558 -> 11035 bytes public/images/api/qiskit/dev/pulse-3.png | Bin 59510 -> 59578 bytes public/images/api/qiskit/dev/pulse-4.png | Bin 18900 -> 19195 bytes public/images/api/qiskit/dev/pulse-5.png | Bin 16226 -> 16511 bytes public/images/api/qiskit/dev/pulse-6.png | Bin 11254 -> 11591 bytes public/images/api/qiskit/dev/pulse-7.png | Bin 13972 -> 14202 bytes .../dev/qiskit-circuit-ControlledGate-2.png | Bin 6891 -> 7457 bytes ...skit-circuit-library-PermutationGate-2.png | Bin 15965 -> 16167 bytes ...skit-circuit-library-PhaseEstimation-1.png | Bin 12161 -> 12193 bytes ...it-visualization-plot_circuit_layout-1.png | Bin 10166 -> 10029 bytes .../qiskit-visualization-plot_error_map-1.png | Bin 49399 -> 49188 bytes ...qiskit-visualization-timeline_drawer-1.png | Bin 16040 -> 15857 bytes ...qiskit-visualization-timeline_drawer-2.png | Bin 8323 -> 8514 bytes ...qiskit-visualization-timeline_drawer-3.png | Bin 26706 -> 27031 bytes .../images/api/qiskit/dev/release_notes-1.png | Bin 6507 -> 2801 bytes .../images/api/qiskit/dev/release_notes-2.png | Bin 13722 -> 1454 bytes .../images/api/qiskit/dev/release_notes-3.png | Bin 11731 -> 4052 bytes .../images/api/qiskit/dev/release_notes-4.png | Bin 8695 -> 13722 bytes .../images/api/qiskit/dev/release_notes-5.png | Bin 7530 -> 11731 bytes .../images/api/qiskit/dev/release_notes-6.png | Bin 7069 -> 8695 bytes .../images/api/qiskit/dev/release_notes-7.png | Bin 0 -> 7530 bytes .../images/api/qiskit/dev/release_notes-8.png | Bin 0 -> 7069 bytes .../images/api/qiskit/dev/transpiler-16.png | Bin 24838 -> 24347 bytes .../images/api/qiskit/dev/transpiler-17.png | Bin 18840 -> 19217 bytes public/images/api/qiskit/dev/transpiler-5.png | Bin 19724 -> 20188 bytes scripts/config/api-html-artifacts.json | 4 +- .../config/historical-pages-to-latest.json | 7 +- 208 files changed, 2633 insertions(+), 954 deletions(-) create mode 100644 docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.execution_span.DoubleSliceSpan.mdx create mode 100644 docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.visualization.draw_execution_spans.mdx create mode 100644 docs/api/qiskit/dev/qiskit.quantum_info.SparseObservable.mdx create mode 100644 docs/api/qiskit/dev/qiskit.transpiler.passes.RemoveIdentityEquivalent.mdx create mode 100644 public/images/api/qiskit/dev/circuit_library-2.png create mode 100644 public/images/api/qiskit/dev/circuit_library-3.png create mode 100644 public/images/api/qiskit/dev/circuit_library-4.png create mode 100644 public/images/api/qiskit/dev/release_notes-7.png create mode 100644 public/images/api/qiskit/dev/release_notes-8.png diff --git a/docs/api/qiskit-ibm-runtime/dev/_toc.json b/docs/api/qiskit-ibm-runtime/dev/_toc.json index c9033005ab9..8af1c7ff65f 100644 --- a/docs/api/qiskit-ibm-runtime/dev/_toc.json +++ b/docs/api/qiskit-ibm-runtime/dev/_toc.json @@ -90,6 +90,10 @@ "title": "Module overview", "url": "/api/qiskit-ibm-runtime/dev/execution_span" }, + { + "title": "DoubleSliceSpan", + "url": "/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.execution_span.DoubleSliceSpan" + }, { "title": "ExecutionSpan", "url": "/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.execution_span.ExecutionSpan" @@ -501,6 +505,10 @@ "title": "Module overview", "url": "/api/qiskit-ibm-runtime/dev/visualization" }, + { + "title": "draw_execution_spans", + "url": "/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.visualization.draw_execution_spans" + }, { "title": "draw_layer_error_map", "url": "/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.visualization.draw_layer_error_map" diff --git a/docs/api/qiskit-ibm-runtime/dev/execution_span.mdx b/docs/api/qiskit-ibm-runtime/dev/execution_span.mdx index 9d0cf9f8970..6f3ce48bde1 100644 --- a/docs/api/qiskit-ibm-runtime/dev/execution_span.mdx +++ b/docs/api/qiskit-ibm-runtime/dev/execution_span.mdx @@ -20,10 +20,11 @@ An [`ExecutionSpans`](qiskit_ibm_runtime.execution_span.ExecutionSpans "qiskit_i ## Classes -| | | -| ----------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`ExecutionSpan`](qiskit_ibm_runtime.execution_span.ExecutionSpan "qiskit_ibm_runtime.execution_span.ExecutionSpan")(start, stop) | Abstract parent for classes that store an execution time span for a subset of job data. | -| [`ExecutionSpans`](qiskit_ibm_runtime.execution_span.ExecutionSpans "qiskit_ibm_runtime.execution_span.ExecutionSpans")(spans) | A collection of timings for pub results. | -| [`ShapeType`](qiskit_ibm_runtime.execution_span.ShapeType "qiskit_ibm_runtime.execution_span.ShapeType") | alias of `Tuple`\[`int`, ...] | -| [`SliceSpan`](qiskit_ibm_runtime.execution_span.SliceSpan "qiskit_ibm_runtime.execution_span.SliceSpan")(start, stop, data\_slices) | An [`ExecutionSpan`](qiskit_ibm_runtime.execution_span.ExecutionSpan "qiskit_ibm_runtime.execution_span.ExecutionSpan") for data stored in a sliceable format. | +| | | +| ----------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`DoubleSliceSpan`](qiskit_ibm_runtime.execution_span.DoubleSliceSpan "qiskit_ibm_runtime.execution_span.DoubleSliceSpan")(start, stop, data\_slices) | An [`ExecutionSpan`](qiskit_ibm_runtime.execution_span.ExecutionSpan "qiskit_ibm_runtime.execution_span.ExecutionSpan") for data stored in a sliceable format. | +| [`ExecutionSpan`](qiskit_ibm_runtime.execution_span.ExecutionSpan "qiskit_ibm_runtime.execution_span.ExecutionSpan")(start, stop) | Abstract parent for classes that store an execution time span for a subset of job data. | +| [`ExecutionSpans`](qiskit_ibm_runtime.execution_span.ExecutionSpans "qiskit_ibm_runtime.execution_span.ExecutionSpans")(spans) | A collection of timings for pub results. | +| [`ShapeType`](qiskit_ibm_runtime.execution_span.ShapeType "qiskit_ibm_runtime.execution_span.ShapeType") | alias of `Tuple`\[`int`, ...] | +| [`SliceSpan`](qiskit_ibm_runtime.execution_span.SliceSpan "qiskit_ibm_runtime.execution_span.SliceSpan")(start, stop, data\_slices) | An [`ExecutionSpan`](qiskit_ibm_runtime.execution_span.ExecutionSpan "qiskit_ibm_runtime.execution_span.ExecutionSpan") for data stored in a sliceable format. | diff --git a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.Estimator.mdx b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.Estimator.mdx index adcff6a2993..685a8827417 100644 --- a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.Estimator.mdx +++ b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.Estimator.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit_ibm_runtime.Estimator # Estimator - + alias of [`EstimatorV2`](qiskit_ibm_runtime.EstimatorV2 "qiskit_ibm_runtime.estimator.EstimatorV2") diff --git a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.EstimatorV2.mdx b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.EstimatorV2.mdx index aed60da8c32..08c6f91859f 100644 --- a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.EstimatorV2.mdx +++ b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.EstimatorV2.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit_ibm_runtime.EstimatorV2 # EstimatorV2 - + Class for interacting with Qiskit Runtime Estimator primitive service. Qiskit Runtime Estimator primitive service estimates expectation values of quantum circuits and observables. @@ -97,6 +97,16 @@ python_api_name: qiskit_ibm_runtime.EstimatorV2 ## Methods + ### backend + + + Return the backend the primitive query will be run on. + + **Return type** + + BackendV1 | BackendV2 + + ### run diff --git a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.IBMBackend.mdx b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.IBMBackend.mdx index 740ed6b7de4..14359853c99 100644 --- a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.IBMBackend.mdx +++ b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.IBMBackend.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit_ibm_runtime.IBMBackend # IBMBackend - + Backend class interfacing with an IBM Quantum backend. @@ -343,7 +343,7 @@ python_api_name: qiskit_ibm_runtime.IBMBackend ### \_\_call\_\_ - + Call self as a function. **Return type** @@ -353,7 +353,7 @@ python_api_name: qiskit_ibm_runtime.IBMBackend ### acquire\_channel - + Return the acquisition channel for the given qubit. **Returns** @@ -367,7 +367,7 @@ python_api_name: qiskit_ibm_runtime.IBMBackend ### cancel\_session - + Cancel session. All pending jobs will be cancelled. **Return type** @@ -377,7 +377,7 @@ python_api_name: qiskit_ibm_runtime.IBMBackend ### check\_faulty - + Check if the input circuit uses faulty qubits or edges. **Parameters** @@ -395,7 +395,7 @@ python_api_name: qiskit_ibm_runtime.IBMBackend ### close\_session - + Close the session so new jobs will no longer be accepted, but existing queued or running jobs will run to completion. The session will be terminated once there are no more pending jobs. **Return type** @@ -405,7 +405,7 @@ python_api_name: qiskit_ibm_runtime.IBMBackend ### configuration - + Return the backend configuration. Backend configuration contains fixed information about the backend, such as its name, number of qubits, basis gates, coupling map, quantum volume, etc. @@ -435,7 +435,7 @@ python_api_name: qiskit_ibm_runtime.IBMBackend ### 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. @@ -455,7 +455,7 @@ python_api_name: qiskit_ibm_runtime.IBMBackend ### defaults - + Return the pulse defaults for the backend. The schema for default pulse configuration can be found in [Qiskit/ibm-quantum-schemas/default\_pulse\_configuration](https://github.com/Qiskit/ibm-quantum-schemas/blob/main/schemas/default_pulse_configuration_schema.json). @@ -475,7 +475,7 @@ python_api_name: qiskit_ibm_runtime.IBMBackend ### drive\_channel - + Return the drive channel for the given qubit. **Returns** @@ -489,7 +489,7 @@ python_api_name: qiskit_ibm_runtime.IBMBackend ### get\_translation\_stage\_plugin - + Return the default translation stage plugin name for IBM backends. **Return type** @@ -499,7 +499,7 @@ python_api_name: qiskit_ibm_runtime.IBMBackend ### measure\_channel - + Return the measure stimulus channel for the given qubit. **Returns** @@ -513,7 +513,7 @@ python_api_name: qiskit_ibm_runtime.IBMBackend ### open\_session - + Open session **Return type** @@ -523,7 +523,7 @@ python_api_name: qiskit_ibm_runtime.IBMBackend ### properties - + Return the backend properties, subject to optional filtering. This data describes qubits properties (such as T1 and T2), gates properties (such as gate length and error), and other general properties of the backend. @@ -573,9 +573,19 @@ python_api_name: qiskit_ibm_runtime.IBMBackend **NotImplementedError** – if the backend doesn’t support querying the qubit properties + ### refresh + + + Retrieve the newest backend configuration and refresh the current backend target. + + **Return type** + + `None` + + ### run - + Run on the backend. If a keyword specified here is also present in the `options` attribute/object, the value specified here will be used for this run. **Parameters** @@ -664,7 +674,7 @@ python_api_name: qiskit_ibm_runtime.IBMBackend ### status - + Return the backend status. @@ -686,7 +696,7 @@ python_api_name: qiskit_ibm_runtime.IBMBackend ### target\_history - + A [`qiskit.transpiler.Target`](/api/qiskit/qiskit.transpiler.Target "(in Qiskit v1.2)") object for the backend. **Return type** diff --git a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.RuntimeDecoder.mdx b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.RuntimeDecoder.mdx index 5e9bade5953..0e7e10a79fc 100644 --- a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.RuntimeDecoder.mdx +++ b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.RuntimeDecoder.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit_ibm_runtime.RuntimeDecoder # RuntimeDecoder - + JSON Decoder used by runtime service. `object_hook`, if specified, will be called with the result of every JSON object decoded and its return value will be used in place of the given `dict`. This can be used to provide custom deserializations (e.g. to support JSON-RPC class hinting). @@ -33,7 +33,7 @@ python_api_name: qiskit_ibm_runtime.RuntimeDecoder ### object\_hook - + Called to decode object. **Return type** diff --git a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.RuntimeEncoder.mdx b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.RuntimeEncoder.mdx index e656717827e..7f703310b5e 100644 --- a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.RuntimeEncoder.mdx +++ b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.RuntimeEncoder.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit_ibm_runtime.RuntimeEncoder # RuntimeEncoder - + JSON Encoder used by runtime service. Constructor for JSONEncoder, with sensible defaults. @@ -43,7 +43,7 @@ python_api_name: qiskit_ibm_runtime.RuntimeEncoder ### default - + Implement this method in a subclass such that it returns a serializable object for `o`, or calls the base implementation (to raise a `TypeError`). For example, to support arbitrary iterators, you could implement default like this: diff --git a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.RuntimeJob.mdx b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.RuntimeJob.mdx index ffd1f3aaf1d..85ce97942d9 100644 --- a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.RuntimeJob.mdx +++ b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.RuntimeJob.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit_ibm_runtime.RuntimeJob # RuntimeJob - + Representation of a runtime primitive execution. A new `RuntimeJob` instance is returned when you call `QiskitRuntimeService.run` to execute a runtime primitive, or [`QiskitRuntimeService.job`](qiskit_ibm_runtime.QiskitRuntimeService#job "qiskit_ibm_runtime.QiskitRuntimeService.job") to retrieve a previously executed job. @@ -27,7 +27,7 @@ python_api_name: qiskit_ibm_runtime.RuntimeJob print("Job failed!: {}".format(ex)) ``` - If the primitive has any interim results, you can use the `callback` parameter of the `run()` method to stream the interim results along with the final result. Alternatively, you can use the [`stream_results()`](#qiskit_ibm_runtime.RuntimeJob.stream_results "qiskit_ibm_runtime.RuntimeJob.stream_results") method to stream the results at a later time, but before the job finishes. + If the primitive has any interim results, you can use the `callback` parameter of the `run()` method to stream the interim results along with the final result. Alternatively, you can use the `stream_results()` method to stream the results at a later time, but before the job finishes. RuntimeJob constructor. @@ -256,28 +256,6 @@ python_api_name: qiskit_ibm_runtime.RuntimeJob `bool` - ### interim\_results - - - (DEPRECATED) Return the interim results of the job. - - **Parameters** - - **decoder** (`Optional`\[`Type`\[`ResultDecoder`]]) – A `ResultDecoder` subclass used to decode interim results. - - **Return type** - - `Any` - - **Returns** - - Runtime job interim results. - - **Raises** - - **RuntimeJobFailureError** – If the job failed. - - ### job\_id @@ -441,31 +419,6 @@ python_api_name: qiskit_ibm_runtime.RuntimeJob Status of this job. - ### stream\_results - - - (DEPRECATED) Start streaming job results. - - **Parameters** - - * **callback** (`Callable`) – - - Callback function to be invoked for any interim results and final result. The callback function will receive 2 positional parameters: - - > 1. Job ID - > 2. Job result. - - * **decoder** (`Optional`\[`Type`\[`ResultDecoder`]]) – A `ResultDecoder` subclass used to decode job results. - - **Raises** - - **RuntimeInvalidStateError** – If a callback function is already streaming results or if the job already finished. - - **Return type** - - `None` - - ### submit diff --git a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.RuntimeJobV2.mdx b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.RuntimeJobV2.mdx index ba4430c0ead..5250e83f9c1 100644 --- a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.RuntimeJobV2.mdx +++ b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.RuntimeJobV2.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit_ibm_runtime.RuntimeJobV2 # RuntimeJobV2 - + Representation of a runtime V2 primitive exeuction. RuntimeJob constructor. @@ -234,28 +234,6 @@ python_api_name: qiskit_ibm_runtime.RuntimeJobV2 `bool` - ### interim\_results - - - (DEPRECATED) Return the interim results of the job. - - **Parameters** - - **decoder** (`Optional`\[`Type`\[`ResultDecoder`]]) – A `ResultDecoder` subclass used to decode interim results. - - **Return type** - - `Any` - - **Returns** - - Runtime job interim results. - - **Raises** - - **RuntimeJobFailureError** – If the job failed. - - ### job\_id @@ -377,31 +355,6 @@ python_api_name: qiskit_ibm_runtime.RuntimeJobV2 Status of this job. - ### stream\_results - - - (DEPRECATED) Start streaming job results. - - **Parameters** - - * **callback** (`Callable`) – - - Callback function to be invoked for any interim results and final result. The callback function will receive 2 positional parameters: - - > 1. Job ID - > 2. Job result. - - * **decoder** (`Optional`\[`Type`\[`ResultDecoder`]]) – A `ResultDecoder` subclass used to decode job results. - - **Raises** - - **RuntimeInvalidStateError** – If a callback function is already streaming results or if the job already finished. - - **Return type** - - `None` - - ### update\_tags diff --git a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.SamplerV2.mdx b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.SamplerV2.mdx index ee08e49434a..801bad97ba4 100644 --- a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.SamplerV2.mdx +++ b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.SamplerV2.mdx @@ -65,6 +65,16 @@ python_api_name: qiskit_ibm_runtime.SamplerV2 ## Methods + ### backend + + + Return the backend the primitive query will be run on. + + **Return type** + + BackendV1 | BackendV2 + + ### run diff --git a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.execution_span.DoubleSliceSpan.mdx b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.execution_span.DoubleSliceSpan.mdx new file mode 100644 index 00000000000..8bbc2273314 --- /dev/null +++ b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.execution_span.DoubleSliceSpan.mdx @@ -0,0 +1,128 @@ +--- +title: DoubleSliceSpan +description: API reference for qiskit_ibm_runtime.execution_span.DoubleSliceSpan +in_page_toc_min_heading_level: 1 +python_api_type: class +python_api_name: qiskit_ibm_runtime.execution_span.DoubleSliceSpan +--- + +# DoubleSliceSpan + + + An [`ExecutionSpan`](qiskit_ibm_runtime.execution_span.ExecutionSpan "qiskit_ibm_runtime.execution_span.ExecutionSpan") for data stored in a sliceable format. + + This type of execution span references pub result data by assuming that it is a sliceable portion of the data where the shots are the outermost slice and the rest of the data is flattened. Therefore, for each pub dependent on this span, the constructor accepts two `slice` objects, along with the corresponding shape of the data to be sliced; in contrast to [`SliceSpan`](qiskit_ibm_runtime.execution_span.SliceSpan "qiskit_ibm_runtime.execution_span.SliceSpan"), this class does not assume that *all* shots for a particular set of parameter values are contiguous in the array of data. + + **Parameters** + + * **start** (`datetime`) – The start time of the span, in UTC. + * **stop** (`datetime`) – The stop time of the span, in UTC. + * **data\_slices** (`dict`\[`int`, `tuple`\[`Tuple`\[`int`, `...`], `slice`, `slice`]]) – A map from pub indices to `(shape_tuple, slice, slice)`. + + ## Attributes + + ### duration + + + The duration of this span, in seconds. + + **Return type** + + `float` + + + ### pub\_idxs + + + **Return type** + + `list`\[`int`] + + + ### size + + + **Return type** + + `int` + + + ### start + + + The start time of the span, in UTC. + + **Return type** + + `datetime` + + + ### stop + + + The stop time of the span, in UTC. + + **Return type** + + `datetime` + + + ## Methods + + ### contains\_pub + + + Return whether the pub with the given index has data with dependence on this span. + + **Parameters** + + **pub\_idx** (*int | Iterable\[int]*) – One or more pub indices from the original primitive call. + + **Return type** + + bool + + **Returns** + + Whether there is dependence on this span. + + + ### filter\_by\_pub + + + Return a new span whose slices are filtered to the provided pub indices. + + For example, if this span contains slice information for pubs with indices 1, 3, 4 and `[1, 4]` is provided, then the span returned by this method will contain slice information for only those two indices, but be identical otherwise. + + **Parameters** + + **pub\_idx** (*int | Iterable\[int]*) – One or more pub indices from the original primitive call. + + **Return type** + + [DoubleSliceSpan](#qiskit_ibm_runtime.execution_span.DoubleSliceSpan "qiskit_ibm_runtime.execution_span.DoubleSliceSpan") + + **Returns** + + A new filtered span. + + + ### mask + + + Return an array-valued mask specifying which parts of a pub result depend on this span. + + **Parameters** + + **pub\_idx** (`int`) – The index of the pub to return a mask for. + + **Return type** + + [`ndarray`](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray "(in NumPy v2.1)")\[`Any`, [`dtype`](https://numpy.org/doc/stable/reference/generated/numpy.dtype.html#numpy.dtype "(in NumPy v2.1)")\[[`bool`](https://numpy.org/doc/stable/reference/arrays.scalars.html#numpy.bool "(in NumPy v2.1)")]] + + **Returns** + + An array with the same shape as the pub data. + + + diff --git a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.execution_span.ExecutionSpans.mdx b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.execution_span.ExecutionSpans.mdx index a660abf081a..250fa1a6386 100644 --- a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.execution_span.ExecutionSpans.mdx +++ b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.execution_span.ExecutionSpans.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit_ibm_runtime.execution_span.ExecutionSpans # ExecutionSpans - + A collection of timings for pub results. This class is a list-like containing [`ExecutionSpan`](qiskit_ibm_runtime.execution_span.ExecutionSpan "qiskit_ibm_runtime.execution_span.ExecutionSpan")s, where each execution span represents a time window of data collection, and contains a reference to exactly which of the data were collected during the window. @@ -61,7 +61,7 @@ python_api_name: qiskit_ibm_runtime.execution_span.ExecutionSpans ### \_\_getitem\_\_ - + **Return type** [ExecutionSpan](qiskit_ibm_runtime.execution_span.ExecutionSpan "qiskit_ibm_runtime.execution_span.ExecutionSpan") | ‘ExecutionSpans @@ -69,15 +69,39 @@ python_api_name: qiskit_ibm_runtime.execution_span.ExecutionSpans ### \_\_len\_\_ - + **Return type** `int` + ### draw + + + Draw these execution spans. + + + To draw multiple sets of execution spans at once, for example coming from multiple jobs, consider calling [`draw_execution_spans()`](qiskit_ibm_runtime.visualization.draw_execution_spans "qiskit_ibm_runtime.visualization.draw_execution_spans") directly. + + + **Parameters** + + * **name** (`Optional`\[`str`]) – The name of this set of spans. + * **normalize\_y** (`bool`) – Whether to display the y-axis units as a percentage of work complete, rather than cumulative shots completed. + * **line\_width** (`int`) – The thickness of line segments. + + **Return type** + + `Figure` + + **Returns** + + A plotly figure. + + ### filter\_by\_pub - + Return a new set of spans where each one has been filtered to the specified pubs. See also :meth:\~.ExecutionSpan.filter\_by\_pub\`. @@ -93,7 +117,7 @@ python_api_name: qiskit_ibm_runtime.execution_span.ExecutionSpans ### sort - + Return the same execution spans, sorted. Sorting is done by the [`start`](qiskit_ibm_runtime.execution_span.ExecutionSpan#start "qiskit_ibm_runtime.execution_span.ExecutionSpan.start") timestamp of each execution span. diff --git a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.noise_learner.NoiseLearner.mdx b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.noise_learner.NoiseLearner.mdx index f58ee995ea9..897c6b417d4 100644 --- a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.noise_learner.NoiseLearner.mdx +++ b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.noise_learner.NoiseLearner.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit_ibm_runtime.noise_learner.NoiseLearner # NoiseLearner - + Class for executing noise learning experiments. @@ -73,7 +73,7 @@ python_api_name: qiskit_ibm_runtime.noise_learner.NoiseLearner **References** - 1. E. van den Berg, Z. Minev, A. Kandala, K. Temme, *Probabilistic error cancellation with sparse Pauli–Lindblad models on noisy quantum processors*, Nature Physics volume 19, pages1116–1121 (2023). [arXiv:2201.09866 \[quant-ph\]](https://arxiv.org/abs/2201.09866) + 1. E. van den Berg, Z. Minev, A. Kandala, K. Temme, *Probabilistic error cancellation with sparse Pauli–Lindblad models on noisy quantum processors*, Nature Physics volume 19, pages 1116–1121 (2023). [arXiv:2201.09866 \[quant-ph\]](https://arxiv.org/abs/2201.09866) ## Attributes @@ -89,6 +89,16 @@ python_api_name: qiskit_ibm_runtime.noise_learner.NoiseLearner ## Methods + ### backend + + + Return the backend the primitive query will be run on. + + **Return type** + + [`BackendV2`](/api/qiskit/qiskit.providers.BackendV2 "(in Qiskit v1.2)") + + ### run diff --git a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.options.EstimatorOptions.mdx b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.options.EstimatorOptions.mdx index b84bf338c86..7641c4b9a0a 100644 --- a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.options.EstimatorOptions.mdx +++ b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.options.EstimatorOptions.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit_ibm_runtime.options.EstimatorOptions # EstimatorOptions - + Options for V2 Estimator. ## Attributes @@ -63,17 +63,6 @@ python_api_name: qiskit_ibm_runtime.options.EstimatorOptions - ### optimization\_level - - - (DEPRECATED) How much optimization to perform on the circuits. Higher levels generate more optimized circuits, at the expense of longer processing times. - - * 0: no optimization - * 1: light optimization - - Default: 0. - - ### resilience diff --git a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.options.LayerNoiseLearningOptions.mdx b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.options.LayerNoiseLearningOptions.mdx index 02412c1e3df..c425da072e8 100644 --- a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.options.LayerNoiseLearningOptions.mdx +++ b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.options.LayerNoiseLearningOptions.mdx @@ -8,13 +8,23 @@ python_api_name: qiskit_ibm_runtime.options.LayerNoiseLearningOptions # LayerNoiseLearningOptions - + Options for learning layer noise. This is only used by V2 Estimator. These options are only used when the resilience level or options specify a technique that requires layer noise learning. + + The total number of unique circuits implemented to learn the noise of a single layer depends solely on [`layer_pair_depths`](#qiskit_ibm_runtime.options.LayerNoiseLearningOptions.layer_pair_depths "qiskit_ibm_runtime.options.LayerNoiseLearningOptions.layer_pair_depths") and [`num_randomizations`](#qiskit_ibm_runtime.options.LayerNoiseLearningOptions.num_randomizations "qiskit_ibm_runtime.options.LayerNoiseLearningOptions.num_randomizations"). For example, if `layer_pair_depths` contains six depths and `num_randomizations` is set to `32`, the noise learning stage executes a total of `6 * 9` unique circuits per layer, each one with `32` randomizations (at [`shots_per_randomization`](#qiskit_ibm_runtime.options.LayerNoiseLearningOptions.shots_per_randomization "qiskit_ibm_runtime.options.LayerNoiseLearningOptions.shots_per_randomization") each). + + The number `9` above is the number of unique circuits that need to be implemented to learn the noise for all the two-qubit subsystem in the given layer by performing local measurements. Indeed, learning the noise for a single one of these subsystems requires measuring all the `16` two-qubit Paulis on that subsystem. Taking advantage of commutation relations to measure more than one of these Paulis (for example, `XI`, `IX`, and `XX`) with a single circuit, it is possible to measure all these `16` Paulis by implementing only `9` circuits. Parallelizing these measurement tasks in the optimal way allows then measuring the `16` Paulis for all of the layer’s two-qubit subsystems with only `9` circuits. More details in Ref. \[1]. + + + **References** + + 1. E. van den Berg, Z. Minev, A. Kandala, K. Temme, *Probabilistic error cancellation with sparse Pauli–Lindblad models on noisy quantum processors*, Nature Physics volume 19, pages 1116–1121 (2023). [arXiv:2201.09866 \[quant-ph\]](https://arxiv.org/abs/2201.09866) + ## Attributes ### layer\_pair\_depths @@ -36,7 +46,7 @@ python_api_name: qiskit_ibm_runtime.options.LayerNoiseLearningOptions ### num\_randomizations - The number of random circuits to use per learning circuit configuration. A configuration is a measurement basis and depth setting. For example, if your experiment has six depths, and nine required measurement bases, then setting this value to 32 will result in a total of `32 * 9 * 6` circuits that need to be executed (at [`shots_per_randomization`](#qiskit_ibm_runtime.options.LayerNoiseLearningOptions.shots_per_randomization "qiskit_ibm_runtime.options.LayerNoiseLearningOptions.shots_per_randomization") each). + The number of random circuits to use per learning circuit configuration. A configuration is a measurement basis and depth setting. For example, if your experiment has six depths, then setting this value to 32 will result in a total of `32 * 9 * 6` circuits that need to be executed (where `9` is the number of circuits that need to be implemented to measure all the required observables, see the note in the docstring for [`LayerNoiseLearningOptions`](#qiskit_ibm_runtime.options.LayerNoiseLearningOptions "qiskit_ibm_runtime.options.LayerNoiseLearningOptions") for mode details), at [`shots_per_randomization`](#qiskit_ibm_runtime.options.LayerNoiseLearningOptions.shots_per_randomization "qiskit_ibm_runtime.options.LayerNoiseLearningOptions.shots_per_randomization") each. Default: 32. diff --git a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.options.NoiseLearnerOptions.mdx b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.options.NoiseLearnerOptions.mdx index 5ac19ec8a47..235068acef7 100644 --- a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.options.NoiseLearnerOptions.mdx +++ b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.options.NoiseLearnerOptions.mdx @@ -8,9 +8,19 @@ python_api_name: qiskit_ibm_runtime.options.NoiseLearnerOptions # NoiseLearnerOptions - + Options for [`NoiseLearner`](qiskit_ibm_runtime.noise_learner.NoiseLearner "qiskit_ibm_runtime.noise_learner.NoiseLearner"). + + The total number of unique circuits implemented to learn the noise of a single layer depends solely on [`layer_pair_depths`](#qiskit_ibm_runtime.options.NoiseLearnerOptions.layer_pair_depths "qiskit_ibm_runtime.options.NoiseLearnerOptions.layer_pair_depths") and [`num_randomizations`](#qiskit_ibm_runtime.options.NoiseLearnerOptions.num_randomizations "qiskit_ibm_runtime.options.NoiseLearnerOptions.num_randomizations"). For example, if `layer_pair_depths` contains six depths and `num_randomizations` is set to `32`, the noise learning stage executes a total of `6 * 9` unique circuits per layer, each one with `32` randomizations (at [`shots_per_randomization`](#qiskit_ibm_runtime.options.NoiseLearnerOptions.shots_per_randomization "qiskit_ibm_runtime.options.NoiseLearnerOptions.shots_per_randomization") each). + + The number `9` above is the number of unique circuits that need to be implemented to learn the noise for all the two-qubit subsystem in the given layer by performing local measurements. Indeed, learning the noise for a single one of these subsystems requires measuring all the `16` two-qubit Paulis on that subsystem. Taking advantage of commutation relations to measure more than one of these Paulis (for example, `XI`, `IX`, and `XX`) with a single circuit, it is possible to measure all these `16` Paulis by implementing only `9` circuits. Parallelizing these measurement tasks in the optimal way allows then measuring the `16` Paulis for all of the layer’s two-qubit subsystems with only `9` circuits. More details in Ref. \[1]. + + + **References** + + 1. E. van den Berg, Z. Minev, A. Kandala, K. Temme, *Probabilistic error cancellation with sparse Pauli–Lindblad models on noisy quantum processors*, Nature Physics volume 19, pages 1116–1121 (2023). [arXiv:2201.09866 \[quant-ph\]](https://arxiv.org/abs/2201.09866) + ## Attributes ### environment @@ -30,7 +40,7 @@ python_api_name: qiskit_ibm_runtime.options.NoiseLearnerOptions The circuit depths (measured in number of pairs) to use in learning experiments. - Pairs are used as the unit because we exploit the order-2 nature of our entangling gates in the noise learning implementation. A value of `3` would correspond to 6 layers of the layer of interest, for example. Default: (0, 1, 2, 4, 16, 32). + Pairs are used as the unit because we exploit the order-2 nature of our entangling gates in the noise learning implementation. For example, a value of `3` corresponds to 6 repetitions of the layer of interest. Default: (0, 1, 2, 4, 16, 32). ### max\_execution\_time @@ -50,7 +60,7 @@ python_api_name: qiskit_ibm_runtime.options.NoiseLearnerOptions The number of random circuits to use per learning circuit configuration. - A configuration is a measurement basis and depth setting. For example, if your experiment has six depths, and nine required measurement bases, then setting this value to 32 will result in a total of `32 * 9 * 6` circuits that need to be executed (at [`shots_per_randomization`](#qiskit_ibm_runtime.options.NoiseLearnerOptions.shots_per_randomization "qiskit_ibm_runtime.options.NoiseLearnerOptions.shots_per_randomization") each). Default: 32. + A configuration is a measurement basis and depth setting. For example, if your experiment has six depths, then setting this value to 32 will result in a total of `32 * 9 * 6` circuits that need to be executed (where `9` is the number of circuits that need to be implemented to measure all the required observables, see the note in the docstring for [`NoiseLearnerOptions`](#qiskit_ibm_runtime.options.NoiseLearnerOptions "qiskit_ibm_runtime.options.NoiseLearnerOptions") for mode details), at [`shots_per_randomization`](#qiskit_ibm_runtime.options.NoiseLearnerOptions.shots_per_randomization "qiskit_ibm_runtime.options.NoiseLearnerOptions.shots_per_randomization") each. ### shots\_per\_randomization diff --git a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.options.ZneOptions.mdx b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.options.ZneOptions.mdx index 178693d70fa..e91489d97ab 100644 --- a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.options.ZneOptions.mdx +++ b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.options.ZneOptions.mdx @@ -22,7 +22,7 @@ python_api_name: qiskit_ibm_runtime.options.ZneOptions 2. `pub_result.data.evs_noise_factors`, `pub_result.data.stds_noise_factors`, and `ensemble_stds_noise_factors` all have shape `(*shape, num_noise_factors)` where `num_noise_factors` is the length of `options.resilience.zne.noise_factors`. These values provide evaluations of the best-fit model at each of the noise amplifications. In the case of no twirling, both `*stds*` arrays will be equal, otherwise, `stds_noise_factors` is derived from the spread over twirling samples, whereas `ensemble_stds_noise_factors` assumes only shot noise and no drift. - Technical note: for single observables with multiple basis terms it might turn out that multiple extrapolation methods are used in *the same* expectation value, for example, `XX` gets linearly extrapolated but `XY` gets exponentially extrapolated in the observable `{"XX": 0.5, "XY": 0.5}`. Let’s call this a *hetergeneous fit*. The data from (2) is evaluated from heterogeneous fits by selecting the best fit for every individual distinct term, whereas data from (1) is evaluated from forced homogenous fits, one for each provided extrapolator. If your work requires a nuanced distinction in this regard, we presently recommend that you use single-term observables in addition to your multi-term observables. + Technical note: for single observables with multiple basis terms it might turn out that multiple extrapolation methods are used in *the same* expectation value, for example, `XX` gets linearly extrapolated but `XY` gets exponentially extrapolated in the observable `{"XX": 0.5, "XY": 0.5}`. Let’s call this a *heterogeneous fit*. The data from (2) is evaluated from heterogeneous fits by selecting the best fit for every individual distinct term, whereas data from (1) is evaluated from forced homogenous fits, one for each provided extrapolator. If your work requires a nuanced distinction in this regard, we presently recommend that you use single-term observables in addition to your multi-term observables. **Parameters** diff --git a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.visualization.draw_execution_spans.mdx b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.visualization.draw_execution_spans.mdx new file mode 100644 index 00000000000..383a364923c --- /dev/null +++ b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.visualization.draw_execution_spans.mdx @@ -0,0 +1,33 @@ +--- +title: draw_execution_spans +description: API reference for qiskit_ibm_runtime.visualization.draw_execution_spans +in_page_toc_min_heading_level: 1 +python_api_type: function +python_api_name: qiskit_ibm_runtime.visualization.draw_execution_spans +--- + + + +# draw\_execution\_spans + + + Draw one or more [`ExecutionSpans`](qiskit_ibm_runtime.execution_span.ExecutionSpans "qiskit_ibm_runtime.execution_span.ExecutionSpans") on a bar plot. + + **Parameters** + + * **spans** ([*ExecutionSpans*](qiskit_ibm_runtime.execution_span.ExecutionSpans "qiskit_ibm_runtime.execution_span.ExecutionSpans")) – One or more [`ExecutionSpans`](qiskit_ibm_runtime.execution_span.ExecutionSpans "qiskit_ibm_runtime.execution_span.ExecutionSpans"). + * **names** (*str | Iterable\[str] | None*) – Name or names to assign to respective `spans`. + * **common\_start** (*bool*) – Whether to shift all collections of spans so that their first span’s start is at $t=0$. + * **normalize\_y** (*bool*) – Whether to display the y-axis units as a percentage of work complete, rather than cumulative shots completed. + * **line\_width** (*int*) – The thickness of line segments. + * **show\_legend** (*bool*) – Whether to show a legend. By default, this choice is automatic. + + **Return type** + + PlotlyFigure + + **Returns** + + A plotly figure. + + diff --git a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.visualization.draw_layer_error_map.mdx b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.visualization.draw_layer_error_map.mdx index 1ed7b7ddc88..91a37007fd0 100644 --- a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.visualization.draw_layer_error_map.mdx +++ b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.visualization.draw_layer_error_map.mdx @@ -10,7 +10,7 @@ python_api_name: qiskit_ibm_runtime.visualization.draw_layer_error_map # draw\_layer\_error\_map - + Draw a map view of a [`LayerError`](qiskit_ibm_runtime.utils.noise_learner_result.LayerError "qiskit_ibm_runtime.utils.noise_learner_result.LayerError"). **Parameters** diff --git a/docs/api/qiskit-ibm-runtime/dev/visualization.mdx b/docs/api/qiskit-ibm-runtime/dev/visualization.mdx index 25faf46d415..e1f16ffd8ce 100644 --- a/docs/api/qiskit-ibm-runtime/dev/visualization.mdx +++ b/docs/api/qiskit-ibm-runtime/dev/visualization.mdx @@ -20,5 +20,6 @@ A suite of functions for visualizing qiskit-ibm-runtime’s objects. | | | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`draw_execution_spans`](qiskit_ibm_runtime.visualization.draw_execution_spans "qiskit_ibm_runtime.visualization.draw_execution_spans")(\*spans\[, names, ...]) | Draw one or more [`ExecutionSpans`](qiskit_ibm_runtime.execution_span.ExecutionSpans "qiskit_ibm_runtime.execution_span.ExecutionSpans") on a bar plot. | | [`draw_layer_error_map`](qiskit_ibm_runtime.visualization.draw_layer_error_map "qiskit_ibm_runtime.visualization.draw_layer_error_map")(layer\_error, embedding) | Draw a map view of a [`LayerError`](qiskit_ibm_runtime.utils.noise_learner_result.LayerError "qiskit_ibm_runtime.utils.noise_learner_result.LayerError"). | diff --git a/docs/api/qiskit/dev/_toc.json b/docs/api/qiskit/dev/_toc.json index c36b11a4dd6..876e19717bd 100644 --- a/docs/api/qiskit/dev/_toc.json +++ b/docs/api/qiskit/dev/_toc.json @@ -712,6 +712,10 @@ "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" @@ -1345,6 +1349,10 @@ "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 b0497f22cb3..71196f719ef 100644 --- a/docs/api/qiskit/dev/assembler.mdx +++ b/docs/api/qiskit/dev/assembler.mdx @@ -65,9 +65,13 @@ 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_library.mdx b/docs/api/qiskit/dev/circuit_library.mdx index 9525b9f9554..557f83cacbf 100644 --- a/docs/api/qiskit/dev/circuit_library.mdx +++ b/docs/api/qiskit/dev/circuit_library.mdx @@ -270,6 +270,72 @@ 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. diff --git a/docs/api/qiskit/dev/compiler.mdx b/docs/api/qiskit/dev/compiler.mdx index d1def25cbd3..e7c506305d2 100644 --- a/docs/api/qiskit/dev/compiler.mdx +++ b/docs/api/qiskit/dev/compiler.mdx @@ -105,9 +105,13 @@ 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 @@ -132,7 +136,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. @@ -149,6 +153,22 @@ 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 @@ -157,7 +177,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*) – 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*) – 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. * **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*) – @@ -294,9 +314,13 @@ 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 20e67af4bec..ee3f4516273 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/providers_fake_provider.mdx b/docs/api/qiskit/dev/providers_fake_provider.mdx index b4b28c45d58..13a581747a2 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 3075b754ce6..90199c0abed 100644 --- a/docs/api/qiskit/dev/pulse.mdx +++ b/docs/api/qiskit/dev/pulse.mdx @@ -68,11 +68,15 @@ 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. @@ -157,7 +161,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. @@ -166,6 +170,10 @@ 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. @@ -754,7 +762,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: @@ -777,6 +785,10 @@ 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. @@ -814,9 +826,13 @@ 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 @@ -840,11 +856,15 @@ 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 @@ -875,9 +895,13 @@ 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 @@ -901,9 +925,13 @@ 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 @@ -960,9 +988,13 @@ 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 @@ -997,7 +1029,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: @@ -1060,6 +1092,10 @@ 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. @@ -1068,13 +1104,17 @@ 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) @@ -1237,9 +1277,13 @@ 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 @@ -1260,9 +1304,13 @@ 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 @@ -1283,7 +1331,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. @@ -1300,6 +1348,10 @@ 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. @@ -1308,9 +1360,13 @@ 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 @@ -1331,9 +1387,13 @@ 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 @@ -1356,9 +1416,13 @@ 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 @@ -1379,9 +1443,13 @@ 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 @@ -1404,9 +1472,13 @@ 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 @@ -1446,13 +1518,17 @@ 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 @@ -1492,13 +1568,17 @@ 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 @@ -1544,11 +1624,15 @@ 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 @@ -1579,11 +1663,15 @@ 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 @@ -1614,11 +1702,15 @@ 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 @@ -1649,9 +1741,13 @@ 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 @@ -1695,9 +1791,13 @@ 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 @@ -1749,7 +1849,7 @@ 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"). @@ -1788,6 +1888,10 @@ 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. @@ -1804,11 +1908,15 @@ 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 @@ -1837,9 +1945,13 @@ 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 @@ -1894,9 +2006,13 @@ 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** @@ -1914,9 +2030,13 @@ 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 @@ -1944,9 +2064,13 @@ 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 @@ -1978,9 +2102,13 @@ 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. @@ -1996,11 +2124,15 @@ 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. @@ -2024,41 +2156,61 @@ 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/qasm3.mdx b/docs/api/qiskit/dev/qasm3.mdx index 67b7a26891f..dc90ccc4aa1 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. diff --git a/docs/api/qiskit/dev/qiskit.circuit.QuantumCircuit.mdx b/docs/api/qiskit/dev/qiskit.circuit.QuantumCircuit.mdx index 155d1b958bd..3b3228f39d3 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,6 +196,10 @@ 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. @@ -321,7 +325,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### \_\_init\_\_ - + Default constructor of [`QuantumCircuit`](#qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit"). **Parameters** @@ -373,7 +377,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### copy - + Copy the circuit. **Parameters** @@ -393,7 +397,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### copy\_empty\_like - + Return a copy of self with the same structure but empty. That structure includes: @@ -440,7 +444,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** @@ -465,7 +469,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** @@ -487,7 +491,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** @@ -528,7 +532,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### add\_bits - + Add Bits to the circuit. @@ -536,7 +540,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### add\_register - + Add registers. @@ -544,7 +548,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. @@ -614,7 +618,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### add\_input - + Register a variable as an input to the circuit. **Parameters** @@ -635,7 +639,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. @@ -653,7 +657,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. @@ -675,7 +679,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. @@ -734,7 +738,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### has\_register - + Test if this circuit has the register r. **Parameters** @@ -764,7 +768,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. @@ -840,7 +844,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### has\_parameter - + Check whether a parameter object exists in this circuit. **Parameters** @@ -868,7 +872,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### get\_parameter - + Retrieve a compile-time parameter that is accessible in this circuit scope by name. **Parameters** @@ -940,7 +944,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### get\_var - + Retrieve a variable that is accessible in this circuit scope by name. **Parameters** @@ -990,7 +994,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### has\_var - + Check whether a variable is accessible in this scope. **Parameters** @@ -1020,7 +1024,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"). @@ -1032,7 +1036,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** @@ -1042,7 +1046,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** @@ -1052,7 +1056,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** @@ -1095,7 +1099,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. @@ -1126,7 +1130,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### \_append - + Append an instruction to the end of the circuit, modifying the circuit in place. @@ -1168,7 +1172,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### compose - + Apply the instructions from one circuit onto specified qubits and/or clbits on another. @@ -1250,7 +1254,7 @@ 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. @@ -1394,7 +1398,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### barrier - + Apply `Barrier`. If `qargs` is empty, applies to all qubits in the circuit. **Parameters** @@ -1413,7 +1417,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. @@ -1436,7 +1440,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. @@ -1460,7 +1464,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. @@ -1483,7 +1487,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. @@ -1507,7 +1511,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. @@ -1531,7 +1535,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. @@ -1555,7 +1559,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. @@ -1579,7 +1583,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. @@ -1602,7 +1606,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. @@ -1625,7 +1629,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. @@ -1649,7 +1653,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. @@ -1672,7 +1676,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. @@ -1699,7 +1703,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. @@ -1722,7 +1726,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. @@ -1745,7 +1749,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. @@ -1768,7 +1772,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. @@ -1789,7 +1793,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** @@ -1813,7 +1817,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. @@ -1834,7 +1838,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. @@ -1854,7 +1858,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. @@ -1874,7 +1878,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. @@ -1963,7 +1967,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. @@ -1984,7 +1988,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. @@ -2063,7 +2067,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: @@ -2099,7 +2103,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. @@ -2175,7 +2179,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. @@ -2196,7 +2200,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. @@ -2217,7 +2221,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### pauli - + Apply [`PauliGate`](qiskit.circuit.library.PauliGate "qiskit.circuit.library.PauliGate"). **Parameters** @@ -2236,7 +2240,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. @@ -2331,7 +2335,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. @@ -2353,7 +2357,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. @@ -2376,7 +2380,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. @@ -2398,7 +2402,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### reset - + Reset the quantum bit(s) to their default state. **Parameters** @@ -2416,7 +2420,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. @@ -2441,7 +2445,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. @@ -2463,7 +2467,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. @@ -2485,7 +2489,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. @@ -2507,7 +2511,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. @@ -2529,7 +2533,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. @@ -2550,7 +2554,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. @@ -2572,7 +2576,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. @@ -2594,7 +2598,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. @@ -2614,7 +2618,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. @@ -2634,7 +2638,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. @@ -2661,7 +2665,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. @@ -2682,7 +2686,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. @@ -2702,7 +2706,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. @@ -2722,7 +2726,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. @@ -2742,7 +2746,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. @@ -2762,7 +2766,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. @@ -2785,7 +2789,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### unitary - + Apply unitary gate specified by `obj` to `qubits`. **Parameters** @@ -2819,7 +2823,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. @@ -2840,7 +2844,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. @@ -2860,7 +2864,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. @@ -2904,7 +2908,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### break\_loop - + Apply [`BreakLoopOp`](qiskit.circuit.BreakLoopOp "qiskit.circuit.BreakLoopOp"). @@ -2926,7 +2930,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### continue\_loop - + Apply [`ContinueLoopOp`](qiskit.circuit.ContinueLoopOp "qiskit.circuit.ContinueLoopOp"). @@ -2948,7 +2952,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. @@ -2999,7 +3003,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### if\_else - + Apply [`IfElseOp`](qiskit.circuit.IfElseOp "qiskit.circuit.IfElseOp"). @@ -3043,7 +3047,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. @@ -3097,7 +3101,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. @@ -3144,7 +3148,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. @@ -3189,7 +3193,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### to\_instruction - + Create an [`Instruction`](qiskit.circuit.Instruction "qiskit.circuit.Instruction") out of this circuit. @@ -3216,7 +3220,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. @@ -3245,7 +3249,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. @@ -3265,7 +3269,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`. @@ -3294,7 +3298,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### clear - + Clear all instructions in self. Clearing the circuits will keep the metadata and calibrations. @@ -3308,7 +3312,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.) @@ -3358,9 +3362,13 @@ 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. @@ -3375,8 +3383,12 @@ 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 @@ -3454,7 +3466,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### count\_ops - + Count each operation kind in the circuit. **Returns** @@ -3468,7 +3480,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### depth - + Return circuit depth (i.e., length of critical path). @@ -3510,7 +3522,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### get\_instructions - + Get instructions matching name. **Parameters** @@ -3528,7 +3540,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### num\_connected\_components - + How many non-entangled subcircuits can the circuit be factored to. **Parameters** @@ -3546,7 +3558,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. @@ -3558,7 +3570,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** @@ -3572,7 +3584,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** @@ -3582,7 +3594,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### size - + Returns total number of instructions in circuit. **Parameters** @@ -3600,7 +3612,7 @@ python_api_name: qiskit.circuit.QuantumCircuit #### width - + Return number of qubits plus clbits in circuit. **Returns** @@ -3618,7 +3630,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** @@ -3636,7 +3648,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 @@ -3661,7 +3673,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 @@ -3690,7 +3702,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### control - + Control this circuit on `num_ctrl_qubits` qubits. **Parameters** @@ -3715,7 +3727,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### inverse - + Invert (take adjoint of) this circuit. This is done by recursively inverting all gates. @@ -3761,7 +3773,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`. @@ -3787,7 +3799,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### repeat - + Repeat this circuit `reps` times. **Parameters** @@ -3806,7 +3818,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. @@ -3854,7 +3866,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. @@ -3954,7 +3966,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### decompose - + Call a decomposition pass on this circuit, to decompose one level (shallow decompose). **Parameters** @@ -3973,7 +3985,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. @@ -4029,7 +4041,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### cast - + Best effort to cast value to type. Otherwise, returns the value. @@ -4043,7 +4055,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. @@ -4065,7 +4077,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### cls\_instances - + Return the current number of instances of this class, useful for auto naming. @@ -4079,7 +4091,7 @@ python_api_name: qiskit.circuit.QuantumCircuit ### cls\_prefix - + Return the prefix to use for auto naming. @@ -4093,7 +4105,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.library.AND.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.AND.mdx index 0a71c11602f..d4588b9caf8 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.AND.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.AND.mdx @@ -45,6 +45,10 @@ 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 @@ -85,7 +89,7 @@ python_api_name: qiskit.circuit.library.AND ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.CDKMRippleCarryAdder.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.CDKMRippleCarryAdder.mdx index 64fc3017969..02363ba356e 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.CDKMRippleCarryAdder.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.CDKMRippleCarryAdder.mdx @@ -91,6 +91,10 @@ 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 @@ -131,7 +135,7 @@ python_api_name: qiskit.circuit.library.CDKMRippleCarryAdder ### instances - + ### layout diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.CPhaseGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.CPhaseGate.mdx index d3a0610f30a..4f41b601e1d 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.CPhaseGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.CPhaseGate.mdx @@ -21,7 +21,7 @@ python_api_name: qiskit.circuit.library.CPhaseGate ```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\lambda} +0 & 0 & 0 & e^{i\theta} \end{pmatrix} $$ diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.CRZGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.CRZGate.mdx index dc9793a8835..e4ca8d1c31f 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.CRZGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.CRZGate.mdx @@ -22,20 +22,20 @@ python_api_name: qiskit.circuit.library.CRZGate ```python q_0: ────■──── ┌───┴───┐ - q_1: ┤ Rz(λ) ├ + q_1: ┤ Rz(θ) ├ └───────┘ ``` **Matrix representation:** $$ -CRZ(\lambda)\ q_0, q_1 = -I \otimes |0\rangle\langle 0| + RZ(\lambda) \otimes |1\rangle\langle 1| = +CRZ(\theta)\ q_0, q_1 = +I \otimes |0\rangle\langle 0| + RZ(\theta) \otimes |1\rangle\langle 1| = \begin{pmatrix} 1 & 0 & 0 & 0 \\ 0 & e^{-i\frac{\lambda}{2}} & 0 & 0 \\ 0 & 0 & 1 & 0 \\ -0 & 0 & 0 & e^{i\frac{\lambda}{2}} +0 & 0 & 0 & e^{i\frac{\theta}{2}} \end{pmatrix} $$ @@ -44,19 +44,19 @@ $$ ```python ┌───────┐ - q_0: ┤ Rz(λ) ├ + q_0: ┤ Rz(θ) ├ └───┬───┘ q_1: ────■──── ``` $$ -CRZ(\lambda)\ q_1, q_0 = -|0\rangle\langle 0| \otimes I + |1\rangle\langle 1| \otimes RZ(\lambda) = +CRZ(\theta)\ q_1, q_0 = +|0\rangle\langle 0| \otimes I + |1\rangle\langle 1| \otimes RZ(\theta) = \begin{pmatrix} 1 & 0 & 0 & 0 \\ 0 & 1 & 0 & 0 \\ -0 & 0 & e^{-i\frac{\lambda}{2}} & 0 \\ -0 & 0 & 0 & e^{i\frac{\lambda}{2}} +0 & 0 & e^{-i\frac{\theta}{2}} & 0 \\ +0 & 0 & 0 & e^{i\frac{\theta}{2}} \end{pmatrix} $$ diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.CU1Gate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.CU1Gate.mdx index b8601c86075..dfa204bda39 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.CU1Gate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.CU1Gate.mdx @@ -32,20 +32,20 @@ $$ ```python q_0: ─■── - │λ + │θ q_1: ─■── ``` **Matrix representation:** $$ -CU1(\lambda) = +CU1(\theta) = I \otimes |0\rangle\langle 0| + U1 \otimes |1\rangle\langle 1| = \begin{pmatrix} 1 & 0 & 0 & 0 \\ 0 & 1 & 0 & 0 \\ 0 & 0 & 1 & 0 \\ -0 & 0 & 0 & e^{i\lambda} +0 & 0 & 0 & e^{i\theta} \end{pmatrix} $$ diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.Diagonal.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.Diagonal.mdx index 1112f7a4832..0f68a1296d4 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.Diagonal.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.Diagonal.mdx @@ -73,6 +73,10 @@ $$ 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.DraperQFTAdder.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.DraperQFTAdder.mdx index 0f643aeb6c6..b2255ff3bb7 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.DraperQFTAdder.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.DraperQFTAdder.mdx @@ -62,6 +62,10 @@ 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.EfficientSU2.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.EfficientSU2.mdx index b24dfc3f7cc..7919ddac38c 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.EfficientSU2.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.EfficientSU2.mdx @@ -88,6 +88,10 @@ 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 4d830feda4d..80ea44ddfde 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.EvolvedOperatorAnsatz.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.EvolvedOperatorAnsatz.mdx @@ -38,6 +38,10 @@ 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 527071ca50a..f93538979b8 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.ExactReciprocal.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.ExactReciprocal.mdx @@ -42,6 +42,10 @@ $$ 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 f1a11bae679..a2ddd314373 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.ExcitationPreserving.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.ExcitationPreserving.mdx @@ -107,6 +107,10 @@ $$ 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 aa0847953e7..6d95a9c20cb 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.FourierChecking.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.FourierChecking.mdx @@ -56,6 +56,10 @@ 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 e8a5c0cb19b..ca3a544c551 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.FunctionalPauliRotations.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.FunctionalPauliRotations.mdx @@ -47,6 +47,10 @@ 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 088a6bb5fa4..a01b17d72f7 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.GMS.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.GMS.mdx @@ -65,6 +65,10 @@ $$ 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 2958004a986..21560db0822 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.GR.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.GR.mdx @@ -59,6 +59,10 @@ $$ 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 e2d1a7b44e2..d9a0262bdcc 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.GRX.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.GRX.mdx @@ -58,6 +58,10 @@ $$ 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 d4198a28ea3..75d75af92ff 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.GRY.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.GRY.mdx @@ -58,6 +58,10 @@ $$ 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 ccb48f0a768..bdb24716567 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.GRZ.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.GRZ.mdx @@ -58,6 +58,10 @@ $$ 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.GraphState.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.GraphState.mdx index 80c4b610d6f..022708da62c 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.GraphState.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.GraphState.mdx @@ -63,6 +63,10 @@ $$ 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 b1a04b2ea73..0ef35556f94 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.GroverOperator.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.GroverOperator.mdx @@ -174,6 +174,10 @@ $$ 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.HRSCumulativeMultiplier.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.HRSCumulativeMultiplier.mdx index d27b95fd79b..5996017b944 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.HRSCumulativeMultiplier.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.HRSCumulativeMultiplier.mdx @@ -75,6 +75,10 @@ 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.HiddenLinearFunction.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.HiddenLinearFunction.mdx index 9a30bc2fc1f..9fd4d39501f 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.HiddenLinearFunction.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.HiddenLinearFunction.mdx @@ -65,6 +65,10 @@ $$ 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.IQP.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.IQP.mdx index 39b159c42c1..de4555a8849 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,6 +31,10 @@ 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. @@ -53,6 +57,10 @@ 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 diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.InnerProduct.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.InnerProduct.mdx index c46f6f58164..956deabba77 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.InnerProduct.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.InnerProduct.mdx @@ -64,6 +64,10 @@ $$ 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.IntegerComparator.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.IntegerComparator.mdx index 33ecf0e21c4..1d459ff0842 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.IntegerComparator.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.IntegerComparator.mdx @@ -44,6 +44,10 @@ $$ 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.LinearAmplitudeFunction.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.LinearAmplitudeFunction.mdx index dd095ab8faa..b070d04f46e 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.LinearAmplitudeFunction.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.LinearAmplitudeFunction.mdx @@ -79,6 +79,10 @@ $$ 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.LinearPauliRotations.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.LinearPauliRotations.mdx index 17e531a8b99..382793c73d8 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.LinearPauliRotations.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.LinearPauliRotations.mdx @@ -70,6 +70,10 @@ $$ 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.MCMT.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.MCMT.mdx index 6d69f20c921..f3c824c4517 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.MCMT.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.MCMT.mdx @@ -61,6 +61,10 @@ 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 diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.MCMTVChain.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.MCMTVChain.mdx index db9554ec614..59cbb36f33d 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.MCMTVChain.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.MCMTVChain.mdx @@ -72,6 +72,10 @@ 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 diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.NLocal.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.NLocal.mdx index f69c495b3cb..45aa00275e3 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.NLocal.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.NLocal.mdx @@ -74,6 +74,10 @@ 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 diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.OR.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.OR.mdx index a8a1e4ea800..53ca6630122 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.OR.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.OR.mdx @@ -45,6 +45,10 @@ 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 diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.PauliFeatureMap.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.PauliFeatureMap.mdx index 21bfd4a74a1..115a59ee5a7 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.PauliFeatureMap.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.PauliFeatureMap.mdx @@ -137,6 +137,10 @@ $$ 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.PauliTwoDesign.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.PauliTwoDesign.mdx index d46ee204bdf..b51d30115f9 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.PauliTwoDesign.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.PauliTwoDesign.mdx @@ -72,6 +72,10 @@ 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 diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.Permutation.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.Permutation.mdx index 868c618c74c..65900f85051 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.Permutation.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.Permutation.mdx @@ -47,6 +47,10 @@ 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 diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.PhaseEstimation.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.PhaseEstimation.mdx index 0a552891de7..d6e8416b8bb 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.PhaseEstimation.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.PhaseEstimation.mdx @@ -64,6 +64,10 @@ $$ 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.PhaseGate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.PhaseGate.mdx index e4b5023a515..e17d924f5fd 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.PhaseGate.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.PhaseGate.mdx @@ -21,39 +21,39 @@ python_api_name: qiskit.circuit.library.PhaseGate ```python ┌──────┐ - q_0: ┤ P(λ) ├ + q_0: ┤ P(θ) ├ └──────┘ ``` **Matrix Representation:** $$ -P(\lambda) = +P(\theta) = \begin{pmatrix} 1 & 0 \\ -0 & e^{i\lambda} +0 & e^{i\theta} \end{pmatrix} $$ **Examples:** > $$ - > P(\lambda = \pi) = Z + > P(\theta = \pi) = Z > $$ > > $$ - > P(\lambda = \pi/2) = S + > P(\theta = \pi/2) = S > $$ > > $$ - > P(\lambda = \pi/4) = T + > P(\theta = \pi/4) = T > $$ `RZGate`: This gate is equivalent to RZ up to a phase factor. > $$ - > P(\lambda) = e^{i{\lambda}/2} RZ(\lambda) + > P(\theta) = e^{i{\theta}/2} RZ(\theta) > $$ Reference for virtual Z gate implementation: [1612.00858](https://arxiv.org/abs/1612.00858) diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.PhaseOracle.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.PhaseOracle.mdx index 655223e0868..4756ae3675b 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.PhaseOracle.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.PhaseOracle.mdx @@ -41,6 +41,10 @@ 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 diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.PiecewiseChebyshev.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.PiecewiseChebyshev.mdx index 734b684fd8d..b03652ed8a0 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.PiecewiseChebyshev.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.PiecewiseChebyshev.mdx @@ -76,6 +76,10 @@ 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 diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.PiecewiseLinearPauliRotations.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.PiecewiseLinearPauliRotations.mdx index 3a9234a8dd9..a3f5126de88 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.PiecewiseLinearPauliRotations.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.PiecewiseLinearPauliRotations.mdx @@ -69,6 +69,10 @@ $$ 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.PiecewisePolynomialPauliRotations.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.PiecewisePolynomialPauliRotations.mdx index b3e37767a52..0c42e28232b 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.PiecewisePolynomialPauliRotations.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.PiecewisePolynomialPauliRotations.mdx @@ -117,6 +117,10 @@ $$ 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.PolynomialPauliRotations.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.PolynomialPauliRotations.mdx index e6df906639b..bb5a2e5104f 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.PolynomialPauliRotations.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.PolynomialPauliRotations.mdx @@ -69,6 +69,10 @@ $$ 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.QAOAAnsatz.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.QAOAAnsatz.mdx index 3af103c3618..552bf51d937 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.QAOAAnsatz.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.QAOAAnsatz.mdx @@ -42,6 +42,10 @@ 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 diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.QFT.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.QFT.mdx index 74e8c1c09f5..3f6ecadb169 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.QFT.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.QFT.mdx @@ -70,6 +70,10 @@ $$ 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.QuadraticForm.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.QuadraticForm.mdx index 255c0462554..56fa2533968 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.QuadraticForm.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.QuadraticForm.mdx @@ -66,6 +66,10 @@ $$ 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.QuantumVolume.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.QuantumVolume.mdx index 91beefcd76e..fbb144b5fe1 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.QuantumVolume.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.QuantumVolume.mdx @@ -53,6 +53,10 @@ 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 diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.RGQFTMultiplier.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.RGQFTMultiplier.mdx index 21d7c5dedbf..5cb5370b94f 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.RGQFTMultiplier.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.RGQFTMultiplier.mdx @@ -54,6 +54,10 @@ 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 diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.RealAmplitudes.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.RealAmplitudes.mdx index b82c5013a6f..bb154fed3ae 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.RealAmplitudes.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.RealAmplitudes.mdx @@ -126,6 +126,10 @@ 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 diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.TwoLocal.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.TwoLocal.mdx index 8a5aa3a2ce3..9774c98d8d7 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.TwoLocal.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.TwoLocal.mdx @@ -138,6 +138,10 @@ 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 diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.U1Gate.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.U1Gate.mdx index 140f28d161c..8de010ba105 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(\lambda) = P(\lambda)= U(0,0,\lambda) +U1(\theta) = P(\theta)= U(0,0,\theta) $$ ```python @@ -32,39 +32,39 @@ $$ ```python ┌───────┐ - q_0: ┤ U1(λ) ├ + q_0: ┤ U1(θ) ├ └───────┘ ``` **Matrix Representation:** $$ -U1(\lambda) = +U1(\theta) = \begin{pmatrix} 1 & 0 \\ -0 & e^{i\lambda} +0 & e^{i\theta} \end{pmatrix} $$ **Examples:** > $$ - > U1(\lambda = \pi) = Z + > U1(\theta = \pi) = Z > $$ > > $$ - > U1(\lambda = \pi/2) = S + > U1(\theta = \pi/2) = S > $$ > > $$ - > U1(\lambda = \pi/4) = T + > U1(\theta = \pi/4) = T > $$ `RZGate`: This gate is equivalent to RZ up to a phase factor. > $$ - > U1(\lambda) = e^{i{\lambda}/2} RZ(\lambda) + > U1(\theta) = e^{i{\theta}/2} RZ(\theta) > $$ `U3Gate`: U3 is a generalization of U2 that covers all single-qubit rotations, using two X90 pulses. diff --git a/docs/api/qiskit/dev/qiskit.circuit.library.UnitaryOverlap.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.UnitaryOverlap.mdx index 5a1512b70fe..4394d4387cb 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.UnitaryOverlap.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.UnitaryOverlap.mdx @@ -73,6 +73,10 @@ $$ 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 dceaf6a4ba7..efa9c606667 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.VBERippleCarryAdder.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.VBERippleCarryAdder.mdx @@ -63,6 +63,10 @@ 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 0377ba33f65..79c515e95e9 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.WeightedAdder.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.WeightedAdder.mdx @@ -76,6 +76,10 @@ $$ 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.XOR.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.XOR.mdx index 1387b2a2e0a..c53363d9187 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.XOR.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.XOR.mdx @@ -47,6 +47,10 @@ 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.ZFeatureMap.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.ZFeatureMap.mdx index 5c9d282b343..31a633e1a1d 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.ZFeatureMap.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.ZFeatureMap.mdx @@ -106,6 +106,10 @@ 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.ZZFeatureMap.mdx b/docs/api/qiskit/dev/qiskit.circuit.library.ZZFeatureMap.mdx index b2a5cef52fc..0041e5c9dd3 100644 --- a/docs/api/qiskit/dev/qiskit.circuit.library.ZZFeatureMap.mdx +++ b/docs/api/qiskit/dev/qiskit.circuit.library.ZZFeatureMap.mdx @@ -127,6 +127,10 @@ 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.dagcircuit.DAGCircuit.mdx b/docs/api/qiskit/dev/qiskit.dagcircuit.DAGCircuit.mdx index e5ccf09daea..fc935067d60 100644 --- a/docs/api/qiskit/dev/qiskit.dagcircuit.DAGCircuit.mdx +++ b/docs/api/qiskit/dev/qiskit.dagcircuit.DAGCircuit.mdx @@ -25,6 +25,8 @@ 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 @@ -527,6 +529,8 @@ 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 1c10e44ab97..2be78a56e98 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). @@ -45,6 +45,10 @@ 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 @@ -57,19 +61,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** @@ -81,31 +85,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** @@ -123,7 +127,7 @@ python_api_name: qiskit.dagcircuit.DAGDependency ### direct\_successors - + Direct successors id of a given node as sorted list. **Parameters** @@ -141,7 +145,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. @@ -163,7 +167,7 @@ python_api_name: qiskit.dagcircuit.DAGDependency ### get\_all\_edges - + Enumeration of all edges. **Returns** @@ -177,7 +181,7 @@ python_api_name: qiskit.dagcircuit.DAGDependency ### get\_edges - + Edge enumeration between two nodes through method get\_all\_edge\_data. **Parameters** @@ -196,7 +200,7 @@ python_api_name: qiskit.dagcircuit.DAGDependency ### get\_in\_edges - + Enumeration of all incoming edges for a given node. **Parameters** @@ -214,7 +218,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. @@ -230,7 +234,7 @@ python_api_name: qiskit.dagcircuit.DAGDependency ### get\_nodes - + **Returns** iterator over all the nodes. @@ -242,7 +246,7 @@ python_api_name: qiskit.dagcircuit.DAGDependency ### get\_out\_edges - + Enumeration of all outgoing edges for a given node. **Parameters** @@ -260,7 +264,7 @@ python_api_name: qiskit.dagcircuit.DAGDependency ### predecessors - + Predecessors id of a given node as sorted list. **Parameters** @@ -278,7 +282,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. @@ -299,13 +303,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** @@ -323,13 +327,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 79acc6c0594..368c13389ca 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 858845c859e..ad32df17e7f 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 ddf787e8eaa..7d062d39c44 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,6 +100,10 @@ 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 @@ -214,11 +218,15 @@ 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. @@ -234,13 +242,17 @@ 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)`. @@ -260,11 +272,15 @@ 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 @@ -280,11 +296,15 @@ 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 @@ -300,7 +320,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. @@ -324,7 +344,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. @@ -345,7 +365,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 7c4bd57679b..12b80c3d1b8 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,6 +69,10 @@ 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 @@ -167,93 +171,39 @@ python_api_name: qiskit.providers.BackendV2Converter ### acquire\_channel - - 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 + + + 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. + ### 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. - - **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 + + + 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. + ### drive\_channel - - 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 + + + 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. + ### measure\_channel - - 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 + + + 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. + ### 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. @@ -277,7 +227,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. @@ -298,7 +248,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 ebd3e736d0f..f356cd8a12f 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 395f4739c96..2817bf6f0e6 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,6 +71,10 @@ 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 @@ -175,11 +179,15 @@ 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. @@ -195,9 +203,13 @@ 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. @@ -209,13 +221,17 @@ 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)`. @@ -235,11 +251,15 @@ 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 @@ -255,11 +275,15 @@ 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 @@ -275,7 +299,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. @@ -299,7 +323,7 @@ python_api_name: qiskit.providers.basic_provider.BasicSimulator ### run - + Run on the backend. **Parameters** @@ -334,7 +358,7 @@ python_api_name: qiskit.providers.basic_provider.BasicSimulator ### run\_experiment - + Run an experiment (circuit) and return a single experiment result. **Parameters** @@ -372,7 +396,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 9604423e0bd..70127e66958 100644 --- a/docs/api/qiskit/dev/qiskit.providers.convert_to_target.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.convert_to_target.mdx @@ -10,16 +10,20 @@ 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") *| None*) – Backend property dictionary or `BackendProperties` - * **defaults** ([*PulseDefaults*](qiskit.providers.models.PulseDefaults "qiskit.providers.models.pulsedefaults.PulseDefaults") *| None*) – Backend pulse defaults dictionary or `PulseDefaults` + * **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` * **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 50e0153d0a6..4e2a8f9d9c9 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 d29e426d131..cac547e0c8d 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 bdf62a29a53..c4536b71279 100644 --- a/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake20QV1.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake20QV1.mdx @@ -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 d12a1da64a0..079b87d5d7b 100644 --- a/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake27QPulseV1.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake27QPulseV1.mdx @@ -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 feb233d8725..224f095a277 100644 --- a/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake5QV1.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake5QV1.mdx @@ -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 a1f0e157ae8..65b97d9002f 100644 --- a/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake7QPulseV1.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.fake_provider.Fake7QPulseV1.mdx @@ -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 fa8ced8d13d..5789717caf0 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 66b6db49e5f..70142a55d59 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 08c70cb8736..ed88013d88b 100644 --- a/docs/api/qiskit/dev/qiskit.providers.fake_provider.GenericBackendV2.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.fake_provider.GenericBackendV2.mdx @@ -8,11 +8,19 @@ 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. @@ -32,7 +40,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*) – - Instruction calibration settings, this argument supports both boolean and [`InstructionScheduleMap`](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap") as input types, and is `None` by default: + 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: 1. If `calibrate_instructions==None`, no calibrations will be added to the target. @@ -52,7 +60,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)")) – 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)")) – DEPRECATED. 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. @@ -92,6 +100,10 @@ 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 @@ -184,93 +196,39 @@ python_api_name: qiskit.providers.fake_provider.GenericBackendV2 ### acquire\_channel - - 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 + + + 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. + ### 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. - - **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 + + + 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. + ### drive\_channel - - 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 + + + 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. + ### measure\_channel - - 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 + + + 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. + ### 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. @@ -294,7 +252,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. @@ -323,7 +281,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 cf5bca5dc19..69e43c3070d 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 97065449e76..8d5f29c851b 100644 --- a/docs/api/qiskit/dev/qiskit.providers.models.PulseDefaults.mdx +++ b/docs/api/qiskit/dev/qiskit.providers.models.PulseDefaults.mdx @@ -8,11 +8,15 @@ 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 @@ -33,7 +37,7 @@ python_api_name: qiskit.providers.models.PulseDefaults ### from\_dict - + Create a new PulseDefaults object from a dictionary. **Parameters** @@ -51,7 +55,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 607aaf92e05..6651e64155a 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,6 +23,10 @@ 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 @@ -41,7 +45,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** @@ -58,7 +62,7 @@ python_api_name: qiskit.pulse.InstructionScheduleMap ### assert\_has - + Error if the given instruction is not defined. **Parameters** @@ -73,7 +77,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. @@ -96,7 +100,7 @@ python_api_name: qiskit.pulse.InstructionScheduleMap ### get\_parameters - + Return the list of parameters taken by the given instruction on the given qubits. **Parameters** @@ -115,7 +119,7 @@ python_api_name: qiskit.pulse.InstructionScheduleMap ### has - + Is the instruction defined for the given qubits? **Parameters** @@ -134,7 +138,7 @@ python_api_name: qiskit.pulse.InstructionScheduleMap ### has\_custom\_gate - + Return `True` if the map has user provided instruction. **Return type** @@ -144,7 +148,7 @@ python_api_name: qiskit.pulse.InstructionScheduleMap ### pop - + Remove and return the defined schedule for the given instruction on the given qubits. **Parameters** @@ -165,7 +169,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** @@ -185,7 +189,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** @@ -207,7 +211,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 b268ab07ce4..bde30c76cb2 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,6 +55,10 @@ 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. @@ -149,7 +153,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`. $$ @@ -170,7 +174,7 @@ $$ ### assign\_parameters - + Assign the parameters in this schedule according to the input. **Parameters** @@ -191,7 +195,7 @@ $$ ### ch\_duration - + Return the time of the end of the last instruction over the supplied channels. **Parameters** @@ -205,7 +209,7 @@ $$ ### ch\_start\_time - + Return the time of the start of the first instruction over the supplied channels. **Parameters** @@ -219,7 +223,7 @@ $$ ### ch\_stop\_time - + Return maximum start time over supplied channels. **Parameters** @@ -233,7 +237,7 @@ $$ ### draw - + Plot the schedule. **Parameters** @@ -279,7 +283,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 @@ -302,7 +306,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. @@ -323,7 +327,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. @@ -343,7 +347,7 @@ $$ ### initialize\_from - + Create new schedule object with metadata of another schedule object. **Parameters** @@ -366,7 +370,7 @@ $$ ### insert - + Return a new schedule with `schedule` inserted into `self` at `start_time`. **Parameters** @@ -383,7 +387,7 @@ $$ ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -393,7 +397,7 @@ $$ ### replace - + Return a `Schedule` with the `old` instruction replaced with a `new` instruction. The replacement matching is based on an instruction equality check. @@ -450,7 +454,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 bdcd90f161b..c39f50c23bf 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. @@ -113,6 +113,10 @@ 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. @@ -197,7 +201,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** @@ -221,7 +225,7 @@ python_api_name: qiskit.pulse.ScheduleBlock ### assign\_parameters - + Assign the parameters in this schedule according to the input. **Parameters** @@ -246,7 +250,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: @@ -304,7 +308,7 @@ python_api_name: qiskit.pulse.ScheduleBlock ### ch\_duration - + Return the time of the end of the last instruction over the supplied channels. **Parameters** @@ -318,7 +322,7 @@ python_api_name: qiskit.pulse.ScheduleBlock ### draw - + Plot the schedule. **Parameters** @@ -364,7 +368,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 @@ -389,7 +393,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`. @@ -412,7 +416,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, @@ -450,7 +454,7 @@ python_api_name: qiskit.pulse.ScheduleBlock ### initialize\_from - + Create new schedule object with metadata of another schedule object. **Parameters** @@ -473,7 +477,7 @@ python_api_name: qiskit.pulse.ScheduleBlock ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -483,7 +487,7 @@ python_api_name: qiskit.pulse.ScheduleBlock ### is\_referenced - + Return True iff the current schedule block contains reference to subroutine. **Return type** @@ -493,7 +497,7 @@ python_api_name: qiskit.pulse.ScheduleBlock ### is\_schedulable - + Return `True` if all durations are assigned. **Return type** @@ -503,7 +507,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 03625a841f7..7c5e8e7a343 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.channels.AcquireChannel.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.channels.AcquireChannel.mdx @@ -8,13 +8,17 @@ 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. @@ -49,7 +53,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 fb07411ab9a..d57f0fccda6 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.channels.ControlChannel.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.channels.ControlChannel.mdx @@ -8,13 +8,17 @@ 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. @@ -49,7 +53,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 0742a584071..94dbe661579 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.channels.DriveChannel.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.channels.DriveChannel.mdx @@ -8,13 +8,17 @@ 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. @@ -49,7 +53,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 87b7b3198f2..90ae8023803 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.channels.MeasureChannel.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.channels.MeasureChannel.mdx @@ -8,13 +8,17 @@ 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. @@ -49,7 +53,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 7076c1dc8cc..24e710e9ec0 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.channels.MemorySlot.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.channels.MemorySlot.mdx @@ -8,13 +8,17 @@ 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. @@ -49,7 +53,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 984b744781a..7434e33f68a 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.channels.RegisterSlot.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.channels.RegisterSlot.mdx @@ -8,13 +8,17 @@ 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. @@ -49,7 +53,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 915b9db81f2..accd69f6874 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 38a0f2faf79..b45367006ab 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,6 +21,10 @@ 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. @@ -127,7 +131,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** @@ -146,7 +150,7 @@ python_api_name: qiskit.pulse.instructions.Acquire ### ch\_duration - + Return duration of the supplied channels in this Instruction. **Parameters** @@ -160,7 +164,7 @@ python_api_name: qiskit.pulse.instructions.Acquire ### ch\_start\_time - + Return minimum start time for supplied channels. **Parameters** @@ -174,7 +178,7 @@ python_api_name: qiskit.pulse.instructions.Acquire ### ch\_stop\_time - + Return maximum start time for supplied channels. **Parameters** @@ -188,7 +192,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** @@ -208,7 +212,7 @@ python_api_name: qiskit.pulse.instructions.Acquire ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -218,7 +222,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 b4ad411cdaf..9b6fa81d6ff 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,6 +29,10 @@ 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. @@ -101,7 +105,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** @@ -120,7 +124,7 @@ python_api_name: qiskit.pulse.instructions.Delay ### ch\_duration - + Return duration of the supplied channels in this Instruction. **Parameters** @@ -134,7 +138,7 @@ python_api_name: qiskit.pulse.instructions.Delay ### ch\_start\_time - + Return minimum start time for supplied channels. **Parameters** @@ -148,7 +152,7 @@ python_api_name: qiskit.pulse.instructions.Delay ### ch\_stop\_time - + Return maximum start time for supplied channels. **Parameters** @@ -162,7 +166,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** @@ -182,7 +186,7 @@ python_api_name: qiskit.pulse.instructions.Delay ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -192,7 +196,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 c04a5869b68..2dcda4a0d3a 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,6 +17,10 @@ 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"). @@ -95,7 +99,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** @@ -114,7 +118,7 @@ python_api_name: qiskit.pulse.instructions.Play ### ch\_duration - + Return duration of the supplied channels in this Instruction. **Parameters** @@ -128,7 +132,7 @@ python_api_name: qiskit.pulse.instructions.Play ### ch\_start\_time - + Return minimum start time for supplied channels. **Parameters** @@ -142,7 +146,7 @@ python_api_name: qiskit.pulse.instructions.Play ### ch\_stop\_time - + Return maximum start time for supplied channels. **Parameters** @@ -156,7 +160,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** @@ -176,7 +180,7 @@ python_api_name: qiskit.pulse.instructions.Play ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -186,7 +190,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 878861462b6..e9dd828af33 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,6 +21,10 @@ 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. @@ -100,7 +104,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** @@ -119,7 +123,7 @@ python_api_name: qiskit.pulse.instructions.Reference ### ch\_duration - + Return duration of the supplied channels in this Instruction. **Parameters** @@ -133,7 +137,7 @@ python_api_name: qiskit.pulse.instructions.Reference ### ch\_start\_time - + Return minimum start time for supplied channels. **Parameters** @@ -147,7 +151,7 @@ python_api_name: qiskit.pulse.instructions.Reference ### ch\_stop\_time - + Return maximum start time for supplied channels. **Parameters** @@ -161,7 +165,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** @@ -181,7 +185,7 @@ python_api_name: qiskit.pulse.instructions.Reference ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -191,7 +195,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 51b5a649ec2..794296df5c6 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,6 +17,10 @@ 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. @@ -82,7 +86,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** @@ -101,7 +105,7 @@ python_api_name: qiskit.pulse.instructions.RelativeBarrier ### ch\_duration - + Return duration of the supplied channels in this Instruction. **Parameters** @@ -115,7 +119,7 @@ python_api_name: qiskit.pulse.instructions.RelativeBarrier ### ch\_start\_time - + Return minimum start time for supplied channels. **Parameters** @@ -129,7 +133,7 @@ python_api_name: qiskit.pulse.instructions.RelativeBarrier ### ch\_stop\_time - + Return maximum start time for supplied channels. **Parameters** @@ -143,7 +147,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** @@ -163,7 +167,7 @@ python_api_name: qiskit.pulse.instructions.RelativeBarrier ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -173,7 +177,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 88962b6e745..28a63dd8378 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,6 +25,10 @@ $$ 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. @@ -103,7 +107,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** @@ -122,7 +126,7 @@ $$ ### ch\_duration - + Return duration of the supplied channels in this Instruction. **Parameters** @@ -136,7 +140,7 @@ $$ ### ch\_start\_time - + Return minimum start time for supplied channels. **Parameters** @@ -150,7 +154,7 @@ $$ ### ch\_stop\_time - + Return maximum start time for supplied channels. **Parameters** @@ -164,7 +168,7 @@ $$ ### insert - + Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`. **Parameters** @@ -184,7 +188,7 @@ $$ ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -194,7 +198,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 d077c85dd0e..7bb64d80b6f 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,6 +23,10 @@ $$ 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. @@ -101,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** @@ -120,7 +124,7 @@ $$ ### ch\_duration - + Return duration of the supplied channels in this Instruction. **Parameters** @@ -134,7 +138,7 @@ $$ ### ch\_start\_time - + Return minimum start time for supplied channels. **Parameters** @@ -148,7 +152,7 @@ $$ ### ch\_stop\_time - + Return maximum start time for supplied channels. **Parameters** @@ -162,7 +166,7 @@ $$ ### insert - + Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`. **Parameters** @@ -182,7 +186,7 @@ $$ ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -192,7 +196,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 013e95e5fa2..9f353016445 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.instructions.ShiftFrequency.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.instructions.ShiftFrequency.mdx @@ -8,13 +8,17 @@ 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. @@ -93,7 +97,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** @@ -112,7 +116,7 @@ python_api_name: qiskit.pulse.instructions.ShiftFrequency ### ch\_duration - + Return duration of the supplied channels in this Instruction. **Parameters** @@ -126,7 +130,7 @@ python_api_name: qiskit.pulse.instructions.ShiftFrequency ### ch\_start\_time - + Return minimum start time for supplied channels. **Parameters** @@ -140,7 +144,7 @@ python_api_name: qiskit.pulse.instructions.ShiftFrequency ### ch\_stop\_time - + Return maximum start time for supplied channels. **Parameters** @@ -154,7 +158,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** @@ -174,7 +178,7 @@ python_api_name: qiskit.pulse.instructions.ShiftFrequency ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -184,7 +188,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 bc6c2256142..addbb9f6f0b 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,6 +27,10 @@ $$ 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. @@ -105,7 +109,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 +128,7 @@ $$ ### ch\_duration - + Return duration of the supplied channels in this Instruction. **Parameters** @@ -138,7 +142,7 @@ $$ ### ch\_start\_time - + Return minimum start time for supplied channels. **Parameters** @@ -152,7 +156,7 @@ $$ ### ch\_stop\_time - + Return maximum start time for supplied channels. **Parameters** @@ -166,7 +170,7 @@ $$ ### insert - + Return a new [`Schedule`](qiskit.pulse.Schedule "qiskit.pulse.Schedule") with `schedule` inserted within `self` at `start_time`. **Parameters** @@ -186,7 +190,7 @@ $$ ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -196,7 +200,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 9a004c0a1c7..3bd3d13557f 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.instructions.Snapshot.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.instructions.Snapshot.mdx @@ -8,13 +8,17 @@ 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. @@ -99,7 +103,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** @@ -118,7 +122,7 @@ python_api_name: qiskit.pulse.instructions.Snapshot ### ch\_duration - + Return duration of the supplied channels in this Instruction. **Parameters** @@ -132,7 +136,7 @@ python_api_name: qiskit.pulse.instructions.Snapshot ### ch\_start\_time - + Return minimum start time for supplied channels. **Parameters** @@ -146,7 +150,7 @@ python_api_name: qiskit.pulse.instructions.Snapshot ### ch\_stop\_time - + Return maximum start time for supplied channels. **Parameters** @@ -160,7 +164,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** @@ -180,7 +184,7 @@ python_api_name: qiskit.pulse.instructions.Snapshot ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -190,7 +194,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 32e8d8d18da..97ef4f7cc3d 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,6 +51,10 @@ 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. @@ -123,7 +127,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** @@ -142,7 +146,7 @@ python_api_name: qiskit.pulse.instructions.TimeBlockade ### ch\_duration - + Return duration of the supplied channels in this Instruction. **Parameters** @@ -156,7 +160,7 @@ python_api_name: qiskit.pulse.instructions.TimeBlockade ### ch\_start\_time - + Return minimum start time for supplied channels. **Parameters** @@ -170,7 +174,7 @@ python_api_name: qiskit.pulse.instructions.TimeBlockade ### ch\_stop\_time - + Return maximum start time for supplied channels. **Parameters** @@ -184,7 +188,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** @@ -204,7 +208,7 @@ python_api_name: qiskit.pulse.instructions.TimeBlockade ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -214,7 +218,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 c7f1645c662..1dd0e1b2571 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.library.Constant.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.library.Constant.mdx @@ -18,19 +18,9 @@ f(x) = \text{amp}\times\exp\left(i\text{angle}\right) , 0 <= x < duration f(x) = 0 , elsewhere $$ - Create new pulse instance. - - **Parameters** - - * **duration** – Pulse length in terms of the sampling period dt. - * **amp** – The magnitude of the amplitude of the square envelope. - * **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. + + 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) + ## Attributes diff --git a/docs/api/qiskit/dev/qiskit.pulse.library.Cos.mdx b/docs/api/qiskit/dev/qiskit.pulse.library.Cos.mdx index ec84a8d4658..1fe02be6a2a 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,6 +21,10 @@ $$ 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 446aec006e4..ded25c132a7 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.library.Drag.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.library.Drag.mdx @@ -32,21 +32,9 @@ $$ 2. [*F. Motzoi, J. M. Gambetta, P. Rebentrost, and F. K. Wilhelm Phys. Rev. Lett. 103, 110501 – Published 8 September 2009.*](https://link.aps.org/doi/10.1103/PhysRevLett.103.110501) - Create new pulse instance. - - **Parameters** - - * **duration** – Pulse length in terms of the sampling period dt. - * **amp** – The magnitude of the amplitude of the DRAG envelope. - * **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. + + 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) + ## Attributes diff --git a/docs/api/qiskit/dev/qiskit.pulse.library.Gaussian.mdx b/docs/api/qiskit/dev/qiskit.pulse.library.Gaussian.mdx index 3c7f4fd1473..613ea52e2b0 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.library.Gaussian.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.library.Gaussian.mdx @@ -22,20 +22,9 @@ $$ where $f'(x)$ is the gaussian waveform without lifting or amplitude scaling, and $\text{A} = \text{amp} \times \exp\left(i\times\text{angle}\right)$. - Create new pulse instance. - - **Parameters** - - * **duration** – Pulse length in terms of the sampling period dt. - * **amp** – The magnitude of the amplitude of the Gaussian envelope. - * **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. + + 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) + ## Attributes diff --git a/docs/api/qiskit/dev/qiskit.pulse.library.GaussianDeriv.mdx b/docs/api/qiskit/dev/qiskit.pulse.library.GaussianDeriv.mdx index 2346a433c3d..4d134eed37f 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,6 +22,10 @@ $$ 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 205e1c9ff87..0732ef9fee2 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.library.GaussianSquare.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.library.GaussianSquare.mdx @@ -45,26 +45,9 @@ $$ where $f'(x)$ is the gaussian square waveform without lifting or amplitude scaling, and $\text{A} = \text{amp} \times \exp\left(i\times\text{angle}\right)$. - Create new pulse instance. - - **Parameters** - - * **duration** – Pulse length in terms of the sampling period dt. - * **amp** – The magnitude of the amplitude of the Gaussian and square pulse. - * **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. + + 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) + ## Attributes diff --git a/docs/api/qiskit/dev/qiskit.pulse.library.GaussianSquareDrag.mdx b/docs/api/qiskit/dev/qiskit.pulse.library.GaussianSquareDrag.mdx index 930c341d21f..f0351feba65 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,6 +61,10 @@ $$ 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 c88940ed12b..a384e8884fd 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,6 +22,10 @@ $$ 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 d03b1d88161..84691ecb6be 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,6 +30,10 @@ $$ 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 f652ad51047..c35ebe884f7 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,6 +22,10 @@ $$ 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 7d8609a0df8..4784deb84e0 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,6 +21,10 @@ $$ 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 f7493f3758a..201b29c9103 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,6 +22,10 @@ $$ 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 ae0baa10711..b12ebdf1dca 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,6 +111,10 @@ $$ 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. @@ -182,7 +186,7 @@ $$ ### draw - + Plot the interpolated envelope of pulse. **Parameters** @@ -218,7 +222,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: @@ -243,7 +247,7 @@ $$ ### is\_parameterized - + Return True iff the instruction is parameterized. **Return type** @@ -253,7 +257,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 07cf861fb9a..288e9689f4f 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,6 +21,10 @@ $$ 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 f11e6678526..f0bded2d391 100644 --- a/docs/api/qiskit/dev/qiskit.pulse.library.Waveform.mdx +++ b/docs/api/qiskit/dev/qiskit.pulse.library.Waveform.mdx @@ -8,13 +8,17 @@ 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. @@ -58,7 +62,7 @@ python_api_name: qiskit.pulse.library.Waveform ### draw - + Plot the interpolated envelope of pulse. **Parameters** @@ -94,7 +98,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 d4761d4d48d..2920340b518 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,6 +43,10 @@ $$ $$ + + 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.Operator.mdx b/docs/api/qiskit/dev/qiskit.quantum_info.Operator.mdx index 167d2a0f464..109233caaa0 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,12 +344,26 @@ $$ ### 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. + * **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. **Returns** @@ -390,7 +404,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}$. @@ -406,7 +420,7 @@ $$ ### tensor - + Return the tensor product with another Operator. **Parameters** @@ -430,19 +444,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** @@ -452,7 +466,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 90c8a9bc54a..5951f243ebd 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 3d779304f70..4bd29238620 100644 --- a/docs/api/qiskit/dev/qiskit.quantum_info.PauliList.mdx +++ b/docs/api/qiskit/dev/qiskit.quantum_info.PauliList.mdx @@ -297,7 +297,7 @@ python_api_name: qiskit.quantum_info.PauliList ### copy - + Make a deep copy of current operator. diff --git a/docs/api/qiskit/dev/qiskit.quantum_info.SparseObservable.mdx b/docs/api/qiskit/dev/qiskit.quantum_info.SparseObservable.mdx new file mode 100644 index 00000000000..ebb8cfebd22 --- /dev/null +++ b/docs/api/qiskit/dev/qiskit.quantum_info.SparseObservable.mdx @@ -0,0 +1,762 @@ +--- +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.result.BaseReadoutMitigator.mdx b/docs/api/qiskit/dev/qiskit.result.BaseReadoutMitigator.mdx index f4ae024e3d2..1c5d64542d7 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)") - Base readout error mitigator class. + This class is DEPRECATED. 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 0108b72d335..2d206f5e7f6 100644 --- a/docs/api/qiskit/dev/qiskit.result.CorrelatedReadoutMitigator.mdx +++ b/docs/api/qiskit/dev/qiskit.result.CorrelatedReadoutMitigator.mdx @@ -8,15 +8,19 @@ python_api_name: qiskit.result.CorrelatedReadoutMitigator # CorrelatedReadoutMitigator - + Bases: [`BaseReadoutMitigator`](qiskit.result.BaseReadoutMitigator "qiskit.result.mitigation.base_readout_mitigator.BaseReadoutMitigator") - N-qubit readout error mitigator. + This class is DEPRECATED. 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. @@ -44,7 +48,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$. @@ -64,7 +68,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|$. @@ -92,7 +96,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$. @@ -112,7 +116,7 @@ python_api_name: qiskit.result.CorrelatedReadoutMitigator ### quasi\_probabilities - + Compute mitigated quasi probabilities value. **Parameters** @@ -135,7 +139,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 c6a97ca137d..d660bdb4bcc 100644 --- a/docs/api/qiskit/dev/qiskit.result.LocalReadoutMitigator.mdx +++ b/docs/api/qiskit/dev/qiskit.result.LocalReadoutMitigator.mdx @@ -8,15 +8,19 @@ python_api_name: qiskit.result.LocalReadoutMitigator # LocalReadoutMitigator - + Bases: [`BaseReadoutMitigator`](qiskit.result.BaseReadoutMitigator "qiskit.result.mitigation.base_readout_mitigator.BaseReadoutMitigator") - 1-qubit tensor product readout error mitigator. + This class is DEPRECATED. 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. @@ -45,7 +49,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$. @@ -65,7 +69,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|$. @@ -93,7 +97,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$. @@ -113,7 +117,7 @@ python_api_name: qiskit.result.LocalReadoutMitigator ### quasi\_probabilities - + Compute mitigated quasi probabilities value. **Parameters** @@ -140,7 +144,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 65465f74bb8..63345c829f0 100644 --- a/docs/api/qiskit/dev/qiskit.synthesis.unitary.aqc.ApproximateCircuit.mdx +++ b/docs/api/qiskit/dev/qiskit.synthesis.unitary.aqc.ApproximateCircuit.mdx @@ -32,6 +32,10 @@ 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 38ac8af2aba..e8148553124 100644 --- a/docs/api/qiskit/dev/qiskit.synthesis.unitary.aqc.CNOTUnitCircuit.mdx +++ b/docs/api/qiskit/dev/qiskit.synthesis.unitary.aqc.CNOTUnitCircuit.mdx @@ -38,6 +38,10 @@ 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 e47355da2ce..1e74945e710 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,11 +17,15 @@ 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** – The pulse representation of the instruction. + * **calibration** – DEPRECATED. The pulse representation of the instruction. ## Attributes @@ -37,6 +41,10 @@ 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 3cc93515e98..080057ce8ef 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,19 +242,23 @@ 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*) – 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*) – 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"). * **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]]`. @@ -279,17 +283,21 @@ 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. @@ -328,9 +336,13 @@ 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. @@ -347,7 +359,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: @@ -385,9 +397,13 @@ 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. @@ -438,13 +454,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 @@ -512,7 +528,7 @@ python_api_name: qiskit.transpiler.Target ### qargs\_for\_operation\_name - + Get the qargs for a given operation name **Parameters** @@ -530,7 +546,7 @@ python_api_name: qiskit.transpiler.Target ### timing\_constraints - + Get an `TimingConstraints` object from the target **Returns** @@ -544,11 +560,15 @@ 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 @@ -576,7 +596,7 @@ python_api_name: qiskit.transpiler.Target ### update\_instruction\_properties - + Update the property object for an instruction qarg pair already in the Target **Parameters** @@ -592,7 +612,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.DynamicalDecoupling.mdx b/docs/api/qiskit/dev/qiskit.transpiler.passes.DynamicalDecoupling.mdx index 17c89ca5ee5..8440cad6a0a 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 27c89671a00..5bf02fd9294 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,6 +17,10 @@ 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. @@ -74,7 +78,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 98108f4ceb3..bd3d8c7e691 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.PadDynamicalDecoupling.mdx b/docs/api/qiskit/dev/qiskit.transpiler.passes.PadDynamicalDecoupling.mdx index 49267e67bd4..f6349200e10 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 1f105f42594..4102e63f862 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,6 +27,10 @@ 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. @@ -74,7 +78,7 @@ python_api_name: qiskit.transpiler.passes.PulseGates ### get\_calibration - + Gets the calibrated schedule for the given instruction and qubits. **Parameters** @@ -125,7 +129,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 7a0e536c0aa..5e2bd26494b 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,6 +58,10 @@ 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 @@ -105,7 +109,7 @@ python_api_name: qiskit.transpiler.passes.RXCalibrationBuilder ### get\_calibration - + Generate RX calibration for the rotation angle specified in node\_op. **Return type** @@ -143,7 +147,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 728e56c885e..27496802bf5 100644 --- a/docs/api/qiskit/dev/qiskit.transpiler.passes.RZXCalibrationBuilder.mdx +++ b/docs/api/qiskit/dev/qiskit.transpiler.passes.RZXCalibrationBuilder.mdx @@ -8,13 +8,17 @@ 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 @@ -67,7 +71,7 @@ python_api_name: qiskit.transpiler.passes.RZXCalibrationBuilder ### get\_calibration - + Builds the calibration schedule for the RZXGate(theta) with echos. **Parameters** @@ -102,7 +106,7 @@ python_api_name: qiskit.transpiler.passes.RZXCalibrationBuilder ### rescale\_cr\_inst - + A builder macro to play stretched pulse. **Parameters** @@ -144,7 +148,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 aa53c0ad22b..b1d556b1e50 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,6 +17,10 @@ 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 @@ -69,7 +73,7 @@ python_api_name: qiskit.transpiler.passes.RZXCalibrationBuilderNoEcho ### get\_calibration - + Builds the calibration schedule for the RZXGate(theta) without echos. **Parameters** @@ -104,7 +108,7 @@ python_api_name: qiskit.transpiler.passes.RZXCalibrationBuilderNoEcho ### rescale\_cr\_inst - + A builder macro to play stretched pulse. **Parameters** @@ -146,7 +150,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 new file mode 100644 index 00000000000..41480e9aa69 --- /dev/null +++ b/docs/api/qiskit/dev/qiskit.transpiler.passes.RemoveIdentityEquivalent.mdx @@ -0,0 +1,122 @@ +--- +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.TimeUnitConversion.mdx b/docs/api/qiskit/dev/qiskit.transpiler.passes.TimeUnitConversion.mdx index f9517878384..efdac25c0f6 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 afbe3a46cd1..a84f5c577fa 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 5c49b6199fd..054f79d9c0f 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,6 +23,10 @@ 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. @@ -81,7 +85,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 c465476c512..f8008139e3e 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 bc240b45bf3..74f295a2b9a 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")) – The dag to draw. + * **dag** ([*DAGCircuit*](qiskit.dagcircuit.DAGCircuit "qiskit.dagcircuit.DAGCircuit") *or*[*DAGDependency*](qiskit.dagcircuit.DAGDependency "qiskit.dagcircuit.DAGDependency")) – 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 fc4d9ab1a58..f30c6597c52 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,9 +135,13 @@ 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. + * **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. * **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 diff --git a/docs/api/qiskit/dev/quantum_info.mdx b/docs/api/qiskit/dev/quantum_info.mdx index c4da200db3c..0a682a6ec55 100644 --- a/docs/api/qiskit/dev/quantum_info.mdx +++ b/docs/api/qiskit/dev/quantum_info.mdx @@ -20,16 +20,17 @@ 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. | -| [`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. | +| [`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. | diff --git a/docs/api/qiskit/dev/result.mdx b/docs/api/qiskit/dev/result.mdx index 1980d5c57e0..2d8c18be0b9 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")() | 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. | +| | | +| --------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- | +| [`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. | diff --git a/docs/api/qiskit/dev/scheduler.mdx b/docs/api/qiskit/dev/scheduler.mdx index 1e885240036..4317da07ca4 100644 --- a/docs/api/qiskit/dev/scheduler.mdx +++ b/docs/api/qiskit/dev/scheduler.mdx @@ -22,11 +22,15 @@ 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. @@ -36,7 +40,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: @@ -44,6 +48,10 @@ 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. @@ -68,11 +76,15 @@ 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. @@ -90,13 +102,17 @@ 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/transpiler_passes.mdx b/docs/api/qiskit/dev/transpiler_passes.mdx index a0b31083ccb..45ba72a5793 100644 --- a/docs/api/qiskit/dev/transpiler_passes.mdx +++ b/docs/api/qiskit/dev/transpiler_passes.mdx @@ -84,6 +84,7 @@ 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_preset.mdx b/docs/api/qiskit/dev/transpiler_preset.mdx index a8d60fa35d2..f8db6f4575a 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,6 +41,22 @@ 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)")) – @@ -58,7 +74,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")) – 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")) – 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. * **coupling\_map** ([*CouplingMap*](qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") *or*[*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.13)")) – @@ -237,7 +253,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** @@ -251,13 +267,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** @@ -281,7 +297,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 @@ -303,7 +319,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** @@ -329,7 +345,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 @@ -351,7 +367,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** @@ -382,15 +398,19 @@ 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")) – Mapping object that maps gate to schedule. + * **inst\_map** ([*InstructionScheduleMap*](qiskit.pulse.InstructionScheduleMap "qiskit.pulse.InstructionScheduleMap")) – DEPRECATED. 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/public/api/qiskit-ibm-runtime/dev/objects.inv b/public/api/qiskit-ibm-runtime/dev/objects.inv index e802273f965cc10d643e88e5b53cef47f65f0cc5..383dc392550d480ecdf0c288845307c2e11fd7ac 100644 GIT binary patch delta 56508 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

k@e)||NR~TE>Q4KOhvJuR5UD91r^mvGk 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 delta 56230 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 diff --git a/public/api/qiskit/dev/objects.inv b/public/api/qiskit/dev/objects.inv index dc01c7152d2c882f5e3e59e4f40fb1d4885baf33..09c9534f520780398a13c568a08bb0330e9648a4 100644 GIT binary patch delta 42305 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 delta 41801 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ℑ6ioP{Krmh4hJoe?BM3Am83Gys4*(57HGfTC()cwJ+<)|cNvkST)i3I{ ztkkdV6W9;dE^;y&2njKq7c+4!B#a1e#F0gK#tAms#U=4aJIV}6!d*N{3D2m&CH#P6 znQ(&$Z^8>f#1sB7I)OUdZhlZF20En?Np2JmW>~$!E457v)6fx8o$owhJfY7 z(m=3W5rl*85HBcnHWC^-i4`C^2nZ9MBMcUu2#3to=9)1dnoA>+ya1WZkkFVJ;-Hv$ zoNzF}O9H{bGecl@0&n~?k81X_I^5uAaiXcu+JZ(tQ}E{f?|-ZISlB$DHW1Qn+%$p3 znXTQhg_^uclec@5%xe6O3yUJaafBNNraO#SFv(;fJRObitoCPfk-CJzsiJGK4( zTiU2M-SLocptxo%2s2gk?R&CkX#SQU~+kQK)E<7 zs9c&Puv{)LxPLx?Gw!J{ASei*57=~jA}kA)56sE7j$IrUA4F5_$pvNzd;lielQyrp zf1sz?ld`mFf8b2Aui8^#w#|$C&!+-gH#RL$X=eM@O`%3^u;eY>;If*#?ZBcoZ@a;5 z_=Yo#)^Bjh5HKis92gKP7z~CaA`BWgEH3YV$;<6`R)1hjHn_YfI7VYecuc&d0Wz@# zA)-5Rh9J>hk%h_R5IayNHW(@si5n~v2n&~qBM+E~$PJm-#jgEVdaM;EYIHLeL=-!k zJtKT{>e2|(JrD$u<;of2$Z|*)O1fL@Xwp3Z14`#{V@k(iVWrdLk)?CF!F82qx3^`r zV+}~N5q|?93aiPQ5mYmAX-Lg^O_hhE&F2Q?hg05UpZGH^!;Xg$#ebqMzz9Txdz%%zq$bY_jesWwCV6T6 z8%_v<-*)B`W0>=vn;b;b-|G3PIPYvxK4RnluzG2L<71`2vTeMdpX4 z1x7>D;w}kK%L7S>zU#k#wIot~5@NVGZarGe@b!6fjwtqdCJg3)i)V`IfTQxz_PHyH zaGz(4K==6}iFcnHc-Z^ASQh<0f0&&>R)6d-@7p~vpUYFDDn{(vmRyu1(k%%*z-{)z zxVHV^hqK3_m=?z5^n2W$B)xhQ^UITC1ix$H$D=K8@6Gp|ESL(S`!AlzK% zcp>NdfrOn)Wrdy#1;Wo|3PaGPbHcDmv!Z@yev_QtJb#U+ywzXIcefvpa31M57693i z=T!m2&+oyK81#F?48)*Y3!^dU96u!eF0$g%?+p-~el{mU{b)K&{bX6J`h8#o?5Sw* z038Ygg4_V?t+0R_2nzyipz#7~#x4t>8O{!v!39o$3^Y0*25m+F4ANwSACyH6d|*Kejmf3L#iYQ2VnT=zF&Tp3Fln5y;C~K2mI*A*jtu5#W6_qxhIEW^U04_$ z%SIN<9aemB#uJOfi4evpVo_u=|Ld>Wb&7gpo81h({c&sqc!HXh5 z$8#J11V*Eu0c5kE^+gSTCNY}+5zTtKl9Uv;p&!B2rqf=~ zxR2aKW&|#4&_`L?(!n{6_=qGaohqZ@9)Xmk(-bwwo})t8s7lJo({TJ90W5qZF49n9i}`Q9X=}zeSeND zia(z_+`x03Vnm$7CqvDl;W6gGsNix~lBja1csLb#TJ6=JS#$Tg*k*a2V)5jfu^`Nd za_pgya;fr|ay?)LmDiO;QRQ`r8&xow#Gmgm{Gw;@q6hGdr|*(S@Az}~We?pYPuzb! z<@qphyw3A-i@(F}x8$Oj(cqJS0>jIe$B5StR=9*5S`;}Ux41#%b&e5FUVlHx(DG98 zDDy(8fb%jXvFD{P3&Zt8+P^%P$Z01ESCVzfj6M# z2pzvP9&{%J;V`+vi-w7c1b@TCV8z0O0779R2qR%)!GZ9v_nWJ-xXrMKzH@0ra$Tz? z=^Y2JVKTkYO=GNVfA?NJsC@HOG+;zcV$V$`yFD& zy~iy)`aK>{eSn7t_XHjs(I0qdf?mPH#ruXbt<=Y3lO3|3;CV=v34bik3@F1E3MP{# z44jwQjh6)ywA_)|e2M3Avdia}D)zy9X#W5&c zg2n^ z2w2%MpUks87a!;;Jb%UWtVee)J+Jc_4(UA4$(+lM3b(P@FkN3;-{}Y-=RE9HKb396Bekd~Pg>DxWjVkaAqY59q>(+h5;zdj5W;?3Nf7|k1UrxXsXqVvb+HFeG`0A5ho)<|GDM1OH`ICM^c_}o|$BtB=Df#SG? z2a7|e0>)w8pVFeqeySvGf2@UATZQ8R9JUUX2wjIH2w#VZhw$m}MHO{f{hDr@63iwY zBL;vO!j?4@!ZuMJ!Zw{1!X7skg|NpNZV1~hF+$j;lOb%g@Bp$=Q~=o|NdVbQIDp0{ z<}bSM?0;bKW82{J>)`;Z51%khOW@h_%_Afb}@BBwjtPFvHb$ z2#;2qO$Dn>f@9SN5us{x1d(bJrGdJB`uUVJW%Bdsrwpvw<5d2!Cs6?*cu_pFk3flf za;`|1AB94>cg8+o>5(W=SH-;p?`V{$57K^vb$>)k)Pv zS7d<$i-O)!69m5N(Yb=(^=?52;C1tioq*TbWgUU*vbZyFy<>I=t}oI~!F7e#F}R*A z?;Kp8*d4^{q9~iRQ9D+TFk5jDvY4ODIYB-%7f1EXmxQt5$T{NHa7P%Zvs3)YocU-d z&VMv^?9DJR*k;y(=$fhQaJtH~+uO3*@n+t$6$c>;r^%cXPBU|HIL&-XI2n$dBb*F( zgyA$h#Sf>MkA~AsV~5iW1H)-%EeNNX3Ww8mx_hJY^a+ZhsW2eOi zi-iY0hh174GG{sNIp7{IoCJqH2e_JWMn~ZF zMBF8Kz2S5YA$OK^6CtOV9fsF6yzB6KL3JWtCfuEPkwnMhB{I7hFBj@;ymUdg=$o_?`gXov=zrVNZs^;2`=M`(JECvT(Gz_;Q&;qDVPEu3)ERlH zm8!RCu99t)WJTR9aln@1`*K>;Ua79}+d2BiZ}QIZ+qrtjZ|CnGe=pmwg2+3`!Cr3#?PIXdCN3wc*O_;RiedGH7CmerwrP^`C;?&mmvbYB)}-Yrc1 zqHfDdeNbtAsuUw^A|eYMkc3uP4G*@6M+?I*;vGLA<8Cew(YUjsppCf94daM+SYStd zVTO9d6)5;4o`}1Hh)>K8;@7N5^TGC@iiR_sy0(0rq!(~R@Zfj(3uE5(g&*o(rW+4ThrW0%Z-j9wQE1+B{!$ExdrBt$=}S~c9*?2Q-zaWr<;%rNYU=ZL?a zE)2ZMjWb2uPgGusAn<*s55$3d{b4qY4^x7!pJdY z!z3YPYv6(9&=-c6;|V{=d@d~yHJ@XmfOFjAhMnUH7JLqu8G;Uf779d%Dh@}7&j`v| zHLq_QRSlzJ_ew~1n=w8%M`_6M+<1+OVSyX>XF&wVedC2P>EyDQCS7F*cidr4l*fIe z!#(Z^BktplkR3qW4^dAL_XzG1Ht9{J-cKL3Bg0=WkIC}FS~EmKSm%htRcCTS(}FJv zL(2tb$mx#Y;iWTwsZi1haMY#sL)}-nIYoUe( zD$Q)Ox+&Cn4VJtW8(da%wjEg1u5CBC4cu^s(b5er+2joh-u4X$6$A!D5)B3o4~t`- zHJ6|MD6%H4GVqma$A|%7#)oAMg@{d*M~O{m1&YUwMX};>h8r%nON@xI>15E@EIe*( z6csu)NfJFa6Az#!t*(D7^|?GX=+PmT2`s+emU*tWO_Jt$a!8x)T~_Rqo4nk9M=#UR zyNK!Wy)qRRIb=!UzU)+^szX+Ecdi<)B{^2*R@L=zf7o7;qPTy&&d+oM>H18XyyG*; ztZvV7VNs{&IKu7nOm`R^o=GOVJClQVb|!}E>P$-49FLW%N@;(aG8J&Lq>DAlj1IQk z-lcVuZSmD{(*zdhhNo_eg{MJV5S|8^7oN5Y%fi!kgdLuSJDl(|$aHub97cE=7&1H! ziYQ179vmcJ)Zv(?jT#R3!*>~Z4VfTb*!UEX;PH~hA>{Rf6G$Ojf2HUM3u7UL=1JY+j-u|8Szgc)*SI>3NeS+0lO-%a$c2aq_}~C0N18rY;A_YZ{x&Vz;YmQ#Ca(m=0ZZY!1r$28!78S(CaQ9EXp|~%STn3S z(5>Os+z5YeYN|6KjZ5YAHz$=PpaH2Q-X^1Rv}z>&-s)b{+H_P~Si{lSIy4)NIjn!t)LrP-Wa^FtHyF*GkmjN>`x}eK z6VOyN8gE0w4VkDydgFDJGQ8%FX2tg z=v4PMW^}DpV{1AX+UlCVz?xr^Ij|izi9rpr$=kYRHa!SzqStA5o2JK*mMKlZ;BDGr zX$yaEev++YtCP&(jZJl-dmB?7Y1Oo(JE1K~GQ%2@CO3fxoCE9@3^ zykZHd-itIZ!m7Ap0fi2(>Xj+5x+`2=s=R-~8(8gi2Rc@L-Hq_-uQ(Ib1QcFCGf-GU znu0>&Zw?AayC$Kq!J7q&2~`ceC(2+JL=xCa8up;3(qwJlUYZ^RH5#KUom!63q0r{j zbSt0@H9hb)q$VG{H8tscO{&S(rd>68!Hw%H*%o_Hd*YftsIXSUOdt(~W4CS_oF{*z zIY`1TEkM!+R(ehjujib{SG74RxHfZ8PX*?fE$S>s2UpYbce~i6r=*DJxMNI1_v%=A z=-`vuK_pR}COe!L(GeAUiE+z?3#7Ij2)Swq@neg2x(AcdO)z=Q2E>bxl#Kobaxhg0 zbaFaG1y1rbi=NS@NVELn?sQl)$u)l$z$hD55cZsYdZ>T0I_&Vxs>J=tnnCSZI_&Z= zeL@tM{pC-O7!_%DaYY4d8HbV8jl8s5yh#toG{+Z{G6by$rMj1+%oL7}>b3&d9-v|W zn}E1iCpI$?eSC@1EIQC>dfNiiu$L7kjdjDO52LLz73rP1AND(SuUuDiaio9UiD*ZU zR5W$Hhn??eRmrkn(UZ6o$$f?7u*W+jH3$AuJow(;h3{|aL;a$rVgENZ#e8^&j>q^M ziO7gX>eCV~Zq>lgwaJeq(|ENA;i=U9EL)u9xa678NC=Z^;OD|gjIte$ev)Dzp=3ki z7+p-c@GB|yBQAnb8|?fZJfDB!xMZf^`=#PY#OqTW3zU(R!u&9s`d#7wqRW?POY#CG z8+^eF^73UO1TY60R(|fBo?KM^=*A-%huzO))VPi{zC{blMF=Y{BwzEWnPJznW(0J> zw>Oncmfd{AKDP4-ir44MlFcyfKkPd1udp1`yill2Q?SE6=3rCx!-aqH%hwMtQFcn` z5P`)%yev-%cu1p~gc4uAh!0y!oXeLh`DHPfTpESaqhuS=FgoVA1REvWu@D70q1uJ| zv5Cp^bDC`>*tiq~xlmb!IuMftqbzzpB^%!56NtA=eqD-#ys6uU`gAzO1$j9=k)l>d z<}~4}w0VcQc;e$w?Ci+}9*e`7~u!r=%#XM%B&0KK!Z`&tr??cx;t@yxFG_?cV>y=Qt|I z*K9m?L3`xO?~h;cIi9Eqz}}(F8tht3wm3TCtZW_m#gvK`iUfb?O2Z85!#+hBj?!as z@rj1Sr+LsZSIq`WYHTvC+ew$kk{o=6U5qd8O40IhL@ak!JV{}0c~RQ9sW+k;MT>^yL}=sSj;-g^U|abTPLGl#rB_&N zCDf>tgn3Yz1^a(cb*)OUz`j+}4C+J1?(>MY;!ZjKQ$$bfR=MaPuBwAyCpmnh`y@?1 zKhrybqKsWEWWOwH*wbxUCJz{QM3U$)oTY4S277NE8uohaP|Yjq4x(2wls{dR>-Ri> zuU{Fy&HXEyzd1cxiVm+%@_;J)p=-mQPF>SHD8v`;ktTn29~m+1@yv)!92!F>w>MEv zkH(-&5ViAMd@B~-vs^NH9u<9&(9@$X`9n8yr{GL!tuV<23z& z_84t>iQJY^c&X?n07^b1#pn#j%@4btH=h}fC8BZL5oyC-&Pc0R%cE074lU;f4SP8_ zi1yvfcEx|%Z#iHed>B;P5!ZhIn+q!6?D6&#(>$OU9WO?=qs5BLfKOD-0?I^o3BUG{ z1}+*sp5AD|+Qy zYUp#*wf$_^+x|1NM;R7!%!a*1hDd_9ODTnqn45p5KxcAVLs!8ybQN4fx90>M$OiG@ z@#)BflTtX5GT?fR!4T%h5pB0te->!l+9iu^m{&)%jkY*OX9h9>(%J;DsdhZcl__b$93DfPO`6b{xJF z5D5KVf$qamlDwIt6?6}df;S~X-Scc)g!+}Aj>j}B@HTovIqts{>-hb-oJV}`*skob zyoKL7NuSP_Z^!7syYg@2y~fg~`>YR%vrK>NW_%m(RgyPyK6*OyR{n3vMa9;8c4D0D ziv3&v7$wVFx&QC_IU00*W+*|$DWkn=lHpA`3H3IaX;Sr>5k6cjr@P-S7d4(fvry2D zWp7xU1U|^+J=yJ}7{B7U>P=pJx?PRa<>gTG~Y6JV&5X8P*YtuUfz{2~88d!x@E=zSOIs;lCE_E)lCS<$fx|;V{ zTqd+WTe5c_hi&l2qXnz==1oZTi#pH110*`Iq|3(*SPp%{BF!@dgeZA!1FqMMKBYY8RZ zRUHb>2-k~KT?@^G*+Y@trK8iYz6y+k_25vig~bqiD5@{xJt9e8WhK!1aH)US(&CV9 zi|bM1d>F?VC0GCYy;Fgi@cMD9d!ZRXyBAv@kFdu+o?wstKfoUQdVW`yJMAg{-LjiS>g5LR-dINL3=2+3CW7{tiNKDc>TE5Yq6D}Jro;# z`F^?lM_;8@!u8@*uVp4M+ZBJ=V*aWBA-w~%M+dtWq8+(iQ9fK(of&#yLx%!vKy`Me zYhl&#x)%{G@}7!_L3MVf&my9D?TTof{=f;{5`R>Ns{PCmd7*oEwri34@Zm*V|JGkw zb*_D~zfQwHzjZ@^9DLhNo?^p5bD_M|HcuZ~A1<}2Ivz-PZSerjQG$PV>Q_sBcvph< z=-`DYync&OfWH@z{rely<23U(^;%Gb_+Gy#sY}bTV0Cw=+XiVTbnpggkE2~SNP8R& z+#v0CwEc6);$G-e$l_P`4bpBmTWydAx!iSwG|2B38>E5GcibQi^geupG|>HS8>E5W z2XBxLcfQMx-0)lkZpeQP$xizX(jnOh+92J+{eRcb(Qbn@FhhN8kOpR^>e4of6e)6+9&V4)SfdzS( zr*Zm<&e0E2ApBZEz167P#&@ye34bs-@B>%Pq(}O&3zFNTzlDFx-G)PfWWfWZ;LLOx zG6iQQa1a%mnHIyU&@6xlTA{voA9{smrPW}pWwyEw&syfK#el7K20ISnTIVo)P}e$( z-G+Isa~M4E>m!3*#vXm-G;lD|Ez9kPi`}vsG=S_Si~n~&Yr8>a>rD4C>};LkmIKk& zne99@ZJpCLgVlf5*=#+0ZJoW40c~Tn^j1Th22uH4PkrDUIJ$u2_UmT15e1kgcq|c+ zfi9znfD8nVAK)2iF>-*r4IVSV{p~(lfV04y5b8o&y?%MR@TV$&zOz{|@iIP>nBI<%9-}1P(wiDt{Qh`H zW5CNDH4^}1mA}x;h2*T(fLgSjz-A+E3SrmsvO|BnX9>GL8BQiGyj%xN?+8WPKhXv! zMI;_<`Nf>dM?x$fL_i13rhZRILJp^c_(A797Vwj57G5@S&xp(~zaS(mqcs~Sr{Qg( zT$d95ny?vr{Sj9_Kc`uo(uWnltNA+3ZfP{+erIW8<2;Cc%?p(0jcp=Ed{xtjx+>5P zZ{dH~O??joeYii9o$3_mNWiAPk%(U}qwra0A-Sq&>ahvOZXrpNiycmIMjvPNy_uzP z^c<%@SqGB7wl?L32bOy!ICpzee0ZV{>`LV=x#+kwN)s)oZ^(CKcgOvkGAFJd`8Tmu zC&9lV2~+1+*8Q8ZC7ymCUwY(Ft3#O>^`Czgz6I^?Zwvq7ZQ(E97XIT~!Mi_CgRKo& zVbvD~dr5)5tqF$f#i@&W0lU^ALc!l_;Jx?@+nw4LwNDo>cDfb4|89r-F5>b#Ff&=I&Va;%k2)9@ctzPWOksFook#I;9qBTdOBw52Io203~lK(O~(xL z%OmNm)HdDZMb_-e*$|G$_)K4s&*Xm>%%bGO5z2NgOips#8)8Ux+t`#dI1sx6ZT3M$ zLFoI7B$4>pU`8?e>l_vA7xp#gVF?0w0(e-=_0dkC>3gv471xg6u&Hyw5OM{=A&7LhWvrqs6B$v+tpHv#a?-u+7cgEZD)>;@kSu{ap*Qud~U`bRA6i zzoX#7|KHDxZ|m^tI3KMSxA*JY*;T0J-E{r+e)&hRqj$IWi{QGym|WkE*5OrhF}Ysf zk4LlReX!;1HrV9b zb~9nxmZb-H{ks{h==x1ZL31VTvrOUW*Ohwy* zCyOlimg%rwsL)@=Lak2d1mwwNW@CucB6^C`%|1Gu;)1;5O_9P#%$9zhRulmAvUbGi zoSq6We$C9uP}|}O!#98K(ljV;NzOM4H3wKgBNsYf+X->JvT)(Dh5is&Y2ZTLle|cG z89IPrD+?EHUa*BcQk=oSiisb2Pm&_w*VByr=tp#lX*&zVmu7y3m;AWL84e^Utt|NT zDr9cjkg{d1nFVQ3 z@syd8HA3ZSB+7r1k|)k?(gT}iwij1vTyd5rDpe^PvjFegE!m1RRsks@*4^?Uv=k_| zmyPai(7>d$EcbCGs=!K-gxjK>p$;n2$>^qptbnR?2~>57R3JsVPLD&jrl<-_z)B5ZZNr(ej~47gbQ=NRa}Q zzLIV2SE_^y8JZ;p&YsZ*D`+CE3C1?FZK5)6#IEbG``Ajp{~0XK#Xe1j^lP5&U_}n6 z7!_%jH`yl?eXQGktn5B&b{{J{{V^k6 z4C7|Abt~4Q>}ge_XzU56m%|zu%zC5aF-w1u11hk5dyVT4OQUI()%594jgQ73=pR`$ z>C>N;`cZoY(dfhC+aSjosm9CF@>soWUbuUF%3DQHxeT#*JK7uCaEeW*N_lmlaSt?Dq;EKt)xVjYbmLqElr(-K2~{nv zs#uD2T?PNvSdKNoM10$$8LdoIKo?x{H{1S6BZXMhws444g@i5Y55(S%=5raexNdZW zY1{nZi3{<6Pu;r+BQ`NMKC-ruH}$I8un>~Jfsf3Rp77;%g^~+C7bGTZegALjOqev& zr@0h!Jwcl*sjxJq|9B@Jf3D}BrNzm;7kx~^NAm8tol zNC(os6jm(TElGAmI!8E6#j8gnaXy;g|27ygfB~C-WE22(aJoAJRXwawXvMrp4LLZ{ z#m*t^Z>Hjf2xgeGSxknDw%Y;Uy%#Htl4XNfx4%U$<|sMQlCJ;;>9f}NuSm*%_)r<# zu<&q`Dxaj7YC$zd;`KplL(ntK+GkQA82(bzuNe3{b4W+LLprg1z_Pz@thJT;K&WS; z9VnQ8Z2RtzZr>dq#P8Ln8VR5Q+Xrl_NE#C@5l3sQkVs-gdc}#Mt|%B~XQooE%ujid z9)|oAZ<~FF5o_;U*<7Et_?aXG>IWUjb+F|fBJx#I?9SjB4-%IyzaGsswZF5><2B;pQP9iB-WrfAMv&tU$ZBj zLTRridLyAFA|J^l89Xp=G$17d`fP|1y!5Y9rOoeDYmzx1DA`)|``^l;6st@1iu{uo z$&eL^#a=76(vXjr<@SO$A((M*kr|=p)sCf-o~p zPjVFXK`f9W6q8-TckdbCIGds~l0jkrbRuy%9b+^u75EIt6^{wy4NB64J_Pwgfew4^ zKvH>FDUVB8+5h0UTeP#|(8S5;MyM)tJVtGi&b^qP?sTD#h4!Po(^?6Bw z2QuXyo4FYx`XOzCs_DS0$QSP#1X`>>|-*C+5bC+4c1vjgyo$e0_ze z;h9XJc70W&dYDxSn!dhtp}Yr6 zxvs6QP#9mDOPk^bd9P~^nYP4GCZ(k{m#IwpymQq%FU6X! zuP1NPjmlGI$`ytBBf+>Z@V*W+6p2F$BUx(m)22@LZzk=bG7W8i?EkW4o2@dnYBX+q zGo@J@K34a1!)+i#4a7uN6`#-P=JA}0`_;UzG_CJd95yF$rLJLf;qfdtTREl%kLUL< z$MeuQi8!7u$De2GXgs=|T`fm+w6o&4DecGnvOtN%@%^0c*XIU&I9$!zSWJ0mOi>$u zUajxv(PVl(yPH*i4)8@IGl)o|i&fVw$Sjo3TJ-w6*;3INzWzR#(QhI?kJ%uv29bLK za@CwWeL%+}?Oz#9%f$I;v6$W6FatK>7}4oZvkgmU)1!mMXgQis*VAP*eOxSS*3s)n zAHeYSqaA~1$^{`bB!Xfrwh}swg+@jHWjbEpFQe)0lx{+Q7g%(Jo}Ug;dbDBDL3(~V z4AbLawHPf|(})k%?-$YSY_(>13@k$l{V)@4ewd+H`jDkBM|U?#mFwt$ z29#)zQKQ#?UrW<=fhJP(+*p+Z`6P;l|@HtC8BINuEYLBuedpZ&;XQbUqyhU z;FlBK;A1f^Q&-c6&(pgxul%n#qiZqI2eXk#9)1{qeBq(N2i@%N9=pF+hJV*BeT)ia zjq}oDd0AOrYL*_u%1$@?=r;Q(%|2>o|8SfALz?|VGyC0b_PaFuT{HVHx7mM5v;We} z{^>URr!@PgX7=B1v;UT6|E-z*%Wd{AY4)#oYG0i<;pU{P-k(=G^25sDz6|MzY{M-W zPH3-x*uQt>2{`TvYM~|OruiPlotT!cPPOrXREh#;Rh@?;px9Xi@M&qLuTDhs4IDS6 zU?A_$7SILz0N>YN=dfH?YzAS#6y@}k|7U$O@5SbP%XoO4tm4DW+{^wMBL_vO&2ivhbvb@-}pK#-+Y5 z$*yAhz0j4O7IOl}cuSZ0{K%!E9yMc6Uryu|#q{NS z+uQ=~S8j^TJmMfcXTelDGGqqx6a!1PXLel3lgYVs9N5JpeU?x0YjyK zih9(H4SD=jI-ZBkqTI&f0IPIl$OAT&J8&Sdinc-Kq54t{5j`|QvlchQuYQtZvmYZ* z1=G~jh#B?kp2YrVma3(M&5(@+gNv&)jWJ3 z;lL#>1oj_bSfMHYdtk?4SfMHY`(VF=VZRI5?*Q1zAM+(S9%DR4S#}<6x6W6Q)669F zuz!N)i7WDd9!$234aKdLtDpye3I2VBrugrJ{RW2pCSbooV8PW!Xo~+H*cB9il`Hap zK1^`ImX8n6(_^*WfpLXu8So+hL`N`msVhSs@XsHh&_YxE_rZPy!+sR7A0e<{Q~?UW z1Xl-98z7Yd+{i>5gETR43lj|t(7q<%%$J%INcJZL?dbU}5ZqF=48V|~UaRVA#KV%I zBhDVK*U1}uRKso2-0$YaI^H`Jc588 z2RF+{AJjJx)VIOS@|zFpI|%Cg;AZ*V0~M!FC=Ti5)-7sr4_$_id$uY9VXBm?pbwvZ z)KflMKpdKZ9(8j;M;lxZFxL3AT#Zls`<7Qcr$;*-V*+|H*(@z`j~nPf;v!85N}xHc zS=8blIPwccD2x6sN z1%3Dl&K6m^Ew}Xe7!-9i;$tZ=yHVyq_xQkCWz(i1@sQ>z{XX*y;VMHb zlj5|+0X5cUX^}(R2xhO5hHwS<4vc0dp__d^p05FHOpX5WqXC`Av); zTPRmSAAZPNTGgIIC!^-zabl@Chl~@cQijgs@{12Ybg8X`y%bBlIb}I{1#(pCYQ)PD z@C!f6ANUdU`$8wdgyI}933hi294-k({?Cnh59wOpF9-LYt~GlG$S+TUc{dm}MF8Gw zOt0F-^wv%wsbW!oiv#FFa#v*vn3wg>bb@oTOP~yufgbg6;jG-v0U=Vfl`xnBT4FVe zTHHfNpNiAGAO~=+Y8JIPfDW23sSA8`Gqw8+ZDKII&{o183W7KIC&}@6kDt!@9=}4E znnq0#khf(&#BJ|P1v<7!<8zW8NQ)^HKZaMs<75ZltS+^G^5kK3KLSr3D#}&RgMSU_ zCsM74>$MjO*icJN@!tb`LR-3hXLDWd*!F;H`dZ9OME9b8N#oN2!-y1pE#@X#!dKI! z>Jqe`zJ#xQOVuT4?R$CiaJ>$iUa4Eu;yyZHE_fCI{(pfYaz*~ng9$EcQPPldeuRUT zs1R7_qMJ~Egsf{XzrjIER0u3|El(&y*2>s-Hm{#y-P$j7incpgm*I zEkaxmutDfEKk@(yt7t1>5XJo~&SKEaQ_Vn+y1BkwORf zE#@YFf;I=P2WSY7pvg_D_2`@4e0-dfaPBTuEE#W)lz&SG87^QaN zNyjDRV zQ$|lDD9+~ZO>LS=*bYt4K&GdGQx8tQBC09t(He(50PjMaD=SvUj9Y$O+I0b#=gVan z)0fLZQ{-b?v7K@aLx3SaM5U_5K=7Av_)87mQT(JB(JO5|$fZ^p zu;NWnfv$|(cMMA6zZDGFfGRbA!;u=x#vMm~IOAw%Z^*5iT4OMw#B@DSzZ;EVOwg-!vZg`3)$@adf zK}&`lfSzB5Yp}mIko%);-%L|S{I@|Z47WMjmCAq*&67n%tqR&OA5KrC5Tgl#-I=cI z*5Wn_{rKt&?E+0FpVLr_wV}3uowX5S9d6RbQ(r6d+13RiKFBLggFUD$^{9Shs%FHuroM4P0ejtiwDp@gt9(xvIjWF<=-EIGskUY zD1fYOan?$+O=12Xp3mRQZ2lgU%eI-+^VlMb^fC@+bQxN4RLfet1^vf=*7P51^dEur zVlofbiSn4%1vU@(EeK`Di61?AvhJCI*_nhee&D;?YSfUxXaW5;qk$IlP|;&0k*C{U zQx*R`z;yM@dc>$py9xpr!hV^Wg&y^=!TQk+Wp8&{Sln$-uMlLWNB?;6SPO64eC)>7 z6o@+${EXN|(oh$qffnaVWWY z5#6b77Mu9WWGjPIC<88(D|xKG3yN!LF%xKctKG$D^Kv2?9xF%Uo8WEwdeq4z7SF&; zHGMtmWSV5;6`mtaTa7q5<{0ItfO4zp>roHWAaV9TU z@B&xrG6bOD2YXzhEHi(|0x+t@y`(E#Txa}d2w<6M7HR~-#cvUW@^I}k;K$#S=iuDv zHhL7s7?P(-zY6+)Swx!!a+KO-z>B{o2mX3PTVOsk3pHZmk|*5Ji{VjX&qhPB47gEq z0AOxSaA8j}wDW>9CHlvObc0TLPEg`SlZs^kf;zz&c?CmrZNCbHdG&Haj<4l+e5vS6by0m)ZW=&Y!zA`KD!G_$> zs|#${59PhLHc+M@LoOKWq^D7>7Iy(pe;si~=naNma7EQ1gOLF9(J-*4xM!NCcr zP$pG_%tWI3@~OJo)5K!ZH3=;|esl%Xi6o}#C?nre;{t6e8>KZWFE6n|vMxS(ZFVt*Y_j$?w&dggP1HQmK}?t`N$i}ldKu?4oxoiC} z$f;h7yNSx}tpF0Ks)U{3B*FPHGaox|RaL@&F7VS4Lw;DHCjL7BzhAD-2YO_$c`e

~W*P?Z2>z3ekmKNqc@J6*N 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

(Spi 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 diff --git a/public/images/api/qiskit/dev/circuit-2.png b/public/images/api/qiskit/dev/circuit-2.png index fa7b138f2c8d0c951e3702622739c010de08a51f..6b89ab24da7b0f6a1aef585e70aea0f64f264137 100644 GIT binary patch literal 8566 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 G{J#JwxHb;} literal 7538 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 YSH&K%-mM}8&p#n0c{RBr8MC1O05v=Ba{vGU diff --git a/public/images/api/qiskit/dev/circuit_library-2.png b/public/images/api/qiskit/dev/circuit_library-2.png new file mode 100644 index 0000000000000000000000000000000000000000..5928e2ff79f1ed67825f133382c694a0fd4d923f GIT binary patch literal 9282 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 literal 0 HcmV?d00001 diff --git a/public/images/api/qiskit/dev/circuit_library-3.png b/public/images/api/qiskit/dev/circuit_library-3.png new file mode 100644 index 0000000000000000000000000000000000000000..7fddb6d79c5f766d34a8dc8cfbbfd003b98b7e12 GIT binary patch literal 15203 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 literal 0 HcmV?d00001 diff --git a/public/images/api/qiskit/dev/circuit_library-4.png b/public/images/api/qiskit/dev/circuit_library-4.png new file mode 100644 index 0000000000000000000000000000000000000000..5dfd605d4d46627f7a35e54e7cc12930479f419f GIT binary patch literal 9152 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 literal 22304 zcmeIacTiMq_bu390+e7tUO_+vi2{lQ$%rB}Ip?4VNNjSBDuRlFHc2Gs43dQg8UrFA zIY~~ElY|DzvyboleRJ>qeN%O3YU<7(cdViS>F#sR6ZT$vt+k)$s>-tDWVB=`6p9=z zcSjwCI>LlP5#^B_hyQ6Z$r^%h!Y(qpE*kb0F7Ef8%u!1BT^wxfU2LsPFS(gJIa}Fd zZtw{6@Lj!R>EhzxEW*oc_wN_**gHMsWl}!U4t@$V{`jV{Egncd1F0NT{%!{m3pwh%f-ri7i-2B z6A>3@IN`Wxr}J(`z_MLRDOONxp*P=kA-`gNe`^$b$)?)}BHXYDj5 zKKF+Yeouzw`tEL8_vA!+Z7t`2`SL}*kM{iej0~mN`Pq(CY#OD+Z>fq=KisF!pUWJ^ zKb>idjETwq_~gVwuYrA!UBz(5?h1Z%CoW#pJ;$H|V?A11gNz(Cmv)4%ijz~Z^zGYP zHD0b|m|^{vcLL#=nVEM(FLKPuQ+6F5Y)QH<^eS1D=rPNNc6+bXu&JoDspH*Xz#=G^ z(ufCf?uE2Mm^|d(eryg^I@9u*J(Jkq&{!J9o21@-)%lrH@@h!Esoevs`H~R2+$zG2iKjt_4M)itLNcsBp>&Vr6vNhPab>B;2&(YK8i!Oh-y}Z1< z(;#_}EV@#yu{2P|MOc7PBsF*aV)OHhl75CqPEcrCSY#}Jn52kh2wEDf$Te?{vhFWV zPva7&@ZWAWiFo}wsl8nlUA#%mZ~H^l24B+dV4oFG{`3UtUZ6nZ)GZuXOX#kx2dH?>G|{LWaQ-Bn}!v`Zm|@M5_uh| zvJ1<&741Uf8Wyxcxow9%em^5Y+)RVHU{7t>7+WK@$84Q&=zV_|gzifW}sPV4Y*<9j67wcZ#S#4k> zY!2ElthY(_!6)aBb6mf!hOC{K8xL(+^N*lVNqg5W<`Ua)yPWy}iAS#gex9?=d$-;Bv66vtjSgrG`md4uAn3y0a0e z=@4?ByVJnFCLKl@nb(gWKj!F_WE|}D;Ri}{;iuZ)6DP^(MKnDm2xOg*3 z$HZ6be25Hu&`ww4K^lZ8G`4nkS+r)OQ-M~}uiDAkSqtyyYopQ*3#O;S-o%Di_EC-Z z*1#z|85vpU2}Yl!V<*pBPBlf&kKzxNJYT^xu*Wny5x$!zky%2-O-W7F%GKtUjfNbh zdgWgkOZb0}q(sqEU?f^*-P2@Yu)Dd`Q*7RRrUEi}o$zVtv1^r;l`mes(th z-N}YukV~3cTgyo=%Gl*98heZ%Yl#(7Idc3|JG{~L_pkfNuijhBJp*MnQxl&a9)lg? z#1vSU44crFq2bFHIjqtcyS0J2HCrRzUbD%;8$CKEdKJOJ!3&i$30<%s1RxZi z&<5zCdhq*M85z!FHHB3r0ZCoi7A^1AR#(-`%+f4c<2XwCZM!zpqm8kRW}S0gnS>^; zLUu7R!;z5@>%M|`2oHv{KW5qz`(V%XRC_u@Jj>NDvz{L)%Z2r4ZnxftKhRf+ZVvXy35*y8-*|4~~-?kRl8#TGpnTUFSN})fv4Tu~#50Kvs!s+00Dz)0dEt z(69Dz%nl=kd+q2rtNs)T?_An>sw*Qk0=7S{P5u0735nTjDpChF4*&g6M{NdSQFC6q zrYi2e*_~f8k`rz0g@%8~EH<8MX0#`*{s{CivPMokEPb3WNeku+-ORbALbhqKPXvvk7sdeYEm zuduNp*~iJzu>+!FPnH^U?BqjpbG_huJ$ZT>?jxR=wcFEl3kPFk_l6;H@9ZoT7UJ^x z%SPG58`C&6GA!r2v+K*ZA(wXJ{r$@k~xl~+>IQdSOS$%eT{ z)^IsQ=m;L;>a39(@4=%~=(UZF2o_i(3RsKpZ>#SBqTU?5J#vPTv2cB+ZSed0 zO$epf@Nk78SR>8Nu*xGNBVC6DAt84~aT}b28JnH8+}_@f^cZ^i^3=lCFa2Yqx$qNC zTF%ro1qM#XR1|j1YHmNma^!fG3ZShC)_wS0azG32{up0`118@)99!PEY8S!(+(JV1RV@}&cyeLyMMf1NI|oS;Zjzg~H;i*f@E~7| zqKNlqp5NiVJ2@?X)|d5_{t{XBerY)?>qH6PDu~RkV|7HH9v)dpI=goN@pMb z>&`TEAAM+KR1|_0tRX<@m)pj`N?sCK=B^krHG2GefZ+|KH&{ZS3yi7etj)Kf2 z(QKu5x1eP+O!7eY!i5W7d#er2`A}R2ym*}Onlno#`Z2W!#z*~G)WOa`x6CP+ceUJV<#mD*T3YGPD?{BtVxW81sC3xoFfo|C-Q zNdUY!+1cfwtVk-y4Cj3NCg-|5)IU&uPx)()IP)>Ll@Yrd^u0$AV`QNc+nG%b%X4Oj z6@>)jV@HqvxLA@^$#`Wr?LB|l?(VKa6`x|>J+X&SX|&X?sYjvI$A;ZUwVoU&-{_EK zoP*oY0MN0}P=`<9HB0?KY zi*zp<0dtV0yBPDtj+%OZkmzefm4hlOEr{ zc^>fMSxQRER~Lml3vlU2>Uw5Lkq@32A5R8M51)Wie)jhb#KgoPl_1}Z8}xr}Kn0+P zkea-8=)vgMu7L}&X>XZnT$zLwV6zE4uIXkieuuGF)9_s`;FV-_myOo9h6FHB>x+Y( z{PzdI6O6ImBzWf>9IWi`>(3Y>JWkW2 ze%p>`jgmI26%8SFlk?WHGKZBjrYFGqI}ty3Sq-Z!MQZfSkG?T)XRxah=EkU3t9mxq6Ct(VBq7-*i z4af@(2(giIaf`D~sECh^ftodYVf0geLq-0hIT-o{_O!e8dq+lX1s4Dz^2N4<@*Io& z0+Ebxcrbd{_4O594V@d{rv6h^Me z0ws~;;a&;COW6GW_3M{vSB4Tb1497-J~Woc@I%sBHsx8Uh~!mN`uq=fP3(p~s4?Gt zsj92{7C4p+fQQG9AD=JlGiDCZycbAyGat5?)!NU-f%o^H0EUBvmO&}Gr+WJI>G@$? zMHG*bKF`brz^_o4B{PV7og1{+UYmOH;zhCF84cQFL`MUhC=wK&!S^hF32h5;#y7))2kr(dZ6fvQ!}1 zv$L@^&`JS=^UCJ}`xVxV&m8#%6@cMgJAt+0x9Vh3N|Z2KU0t2;FUjoe>;xWb!AZ0a zh?+9UaHd;qEG(A4e~r(N)Zm~@*2K&l8@s42lc;@Hdwc8gxesr#`HU4`MoTA0NqBjA z5x{F~Yz*_K4140o(bot|Qu44(yDdRHg!~fr=gdqdz&xAYJUs+Tvv9Dn$wImXR^trO z7t&uvWO2&s>R3p5dF6J4)_~^LHaDYK_UBam)jd2uuteIBaG-~)T#wkCv1J()H z4*<8>k8Prxy{%8sLWdWNW_s`jPh$NNI-!`=m}!ltH##2o16EN!Q5w97R?OqQV#b6{ zD6V&^Ioj^LGZHnkH8M4UG+E=Jo_a||oO#1}S`n}W`Xmic>2WGF*{M?q2?z97l@lcs zg5I^YdtC>CM^XloMGY1nV5_N_8Jz-w2o_#m72sup63zyc`i@?RZ73*UecJttr`Rq& zx4e%d;}y%5gf>mT1IFfc%quix=x^lO`XY04b8cl9_$^;Y@tXJztK^^j(xCI5fquxa zvQlRB#>}UuCwG8EU_rYNyXs^gk^9K9(Hzaob?K560KIk~IDyoY7O)?w{>Ib^WoG(; z@F`N#H?eg7e9=O+sSYB*+-N~sJa_uE+Rp}-iv&%_1%q#h%oaYK`Sc$3}>u6{jQqBv!_U++Uvr|LVsnN zf6;D%QLWI<3_Vmqzc+Y1`AeBs^30}R2k%p$>S3zumFp~o( z46nSLoGQ+3iEQacY>NoQg)$ms+?kk|cIGk@Be2*Mm|7d4F!gJFJhR(GVU+`;M!mbT zx4l09qbL=EXqjz4-@^NAD0W8b-HfMFR`B;ZAm5@~%>UB1lK8;I84ws0#0eveBuf^% zAMbC$fC;6$MNoQ4k7<$xoj6CZY6P_AvOFYgL$V4;42WW@;ZdN02}^@Iu|oE}Nw=Of zW(*{ash+aB?j78iQE!X#+J$t5pSa6E; zx*NNh)-94p8reF935G^SWsZ|~W0x|OqY4LSv(X zf`TjMGvYbcFlAE7RO(bt%*@PFlMhB)ZYq#n>WtJXxqSJu3s4gDP(P`XIJ&#f%)Ebm zDX=cv!^6XJwmn(@gF`Yx@IegW;^9$d^xrE2h9MsY)AaVYx7Q#1Tv;hhz8xGjA9uc) z5Pa+C@#EH$UtguuHhYx;$!Z7>g>^BXDvXP}2<4Iz_T2gN+CSfFqo^B}xUGjaoLwx{ z)-w`QuR=+#iF327{BW&`F5P+J3n_YYl&d)brJjV)mma^82p6;7k}x@l0BISH!{MNk zO^1k_3zfTmrBnKd$0RvD0GDs13%s?zQxJd*e;pL?EG})Lm13D2Jv?wvPKfU__EzeQ z#F$Hys1^}w*c59=FhWzIb68F09}1L1YFil>ckcqVmkWfvKHjfpJjAiCl6r_5ioy9S z<=jfB%AL2zW~A!xkUZ*IU0?5lr7hrp;1j!4R8$0j-aJ|5C&au=C|0ciBj>11PWzkc z>C*|?I=GOcFj7hQ;Dp&OUBCuT8li{X0VJNDYYViI&A?MeCMMeJ4DRjuK>3PW353CR zmywa_7q~+e`WZ*d`Sj;cGoVFt-B(5g2NS)Qh4W4D#vL6UKv|knJVcG{8T;l$*6yu1 zrf1OjN(L6^oL)?)IqXg`3?tP%w;2@p{{1zjcl>Br3~ntmV+jnck8Z_foda_6Qlp#t z4n*RO5$}~b2t;I*l+getfkEvqd8l$ii!`a23|DVb(lBbg+~DhP`miU*cu$G^QO@P7 zS6`A&MV?YS9VxBG#B%j&-WT)~O4T@l;fJQdR(w~A7XJL;^!$`}p;6G5ej9nER@jh9 z(TecTg@s&XX3E5PQHHM)s5Hq^Wy7L?jE02*m^XkE(SIg6+^y~$veuV#=++92+Xk(z zhaA2(TYPOG@K8FFPJiPQ31}a{ghck+y18(m;!gbmffLiyDgO8onZ)W286v;sbU#1B zB^7SpUE`L08@9?1nv1B*Xu!8#i$x7&!$*iw@`%)zbP=G{t69e6Cnl8L&bKjTTrV|G zZgeYr)}J41dPF;vdjIJP5m5kLeHdd(ATlx?LZ>kl43PN) z!vBDL6oyt(63-{zW-G`wXZnIA+oDVgUF^9yp}y1B*{pxEi4nO5N=OOvQqx9tM6=bq z)$wR-8qxlaJho-B4n_R*#)H4B1sWQfr@_I|b7!qkT6E$}z>F#S`1q7U0GEv>sv}+P z0D6->d}zqfcfCaj_;c5PO#>WYYrocedA#vWc>Er#Sp803GAqpD2Jdn5U84ldL>-Gn#OF4aX3^5{0* z(-Rc0CO*al_&=c<-kReQa(UV0W`|<79VkVEG#Scs`w!9rymqtdRFX8nVJ%JRpbdkZ z)LeGSY__wJKKvsc<`E%(-jtS}J_polD9@3A_`gD7D4V`~{(Kw6ya=FzQx%BD%>Jhf zw7)CF#Kc0-y|^SLNB^!68;Dg?!kvQ`KJBO!ia9vG@xEubeb-HUm@T83t2FyTNbbZ3 zK@{rY9VqW`zXg}_v_o36rXJrE@FCbtrL)ZS33)YPqZej7bHobBQFZ<8XNl{0SluZr zPXxhuO@Z50K`I<5c0nX$M#vR}UiR_zr8hEtv&NIy_mn(Q z0jr2J(8jlQL9ZP`&in`P^-Y{kCg)QOM-cD7blX8AC>+S*Y7uFY%u?@LJq%=Z=g z4?CC_>6SW8$s;&jz`FZdj%HHlC8$s~KYRP+$RIu*Si` z!47kIY$t_X=g3FD;`^w+eq!_2$X&>BC6TO0?_2*^*y|uA;$BI$%Q_ z2?%j;|MT(mj0|f~_MkwBhLu}*xWD3$O@s2(^2hu8KrT~wD+QD|CAd3`ae__(lx)1q z&u^!ZTn^XK0Rq5lb1@s>E>b5AwFN=hr?^8v)j0w_cxn}sJQ3%{#m zf%IK@am6C*#;m>kp?L_8-FA}&uHLryxv&bm*%;TFReRH|p8ia?nQ8eUr*?=}q7U)N zn9Q#(hP^AB4NyY8Nn3B!^LlV#Okk|ITUptYwdMd!IxsACltY!gI8Vmf=1CEY- zuyAm~+JFL6$fX+aRL%BuEYzf3ubFN)WqymT<4y|7aralp`(H;#+1sF|z?!|~e#6YE%-3ddZA6#+hnNaxq_v3nb%{wV`f$ju>w!br zCOFgZ5oQA|r((H_&vmh~_2mT{>*h9F3D=iqeE>Ml4>J=hImVR& zT8a(aJW>__XCUCa;{s?%1%tUlNwWIuS9{%~BRxeAWMl0BKQafPgaXEO9Yk(CZ0$~0 zh%SYKGZsAvB(gQkF)S&aWhOHy*qfS~sxXMiVbvVP4fVOYi;GK414$S-Dgej!z!3G6 zX73BdHa9nGn3{I@f1ti1R8h{d#i#i@cwql4*Icmw+@~FxoYRDePKrYnn%)D0mV=^9 z&4$L77A>E>e!841LPCXK1PewOn%b(@f)j9w6;A4%cANHo2Z{4E`;^0*6U;AS%7Ee; zSy6tvh0_=n|1C6SZZW7OdrL)IPpjNUgZ6@+=gzETu!8MFKJ<#Or)t=!iP18KdTYJZ zpJ!J|ufGo;`=S1_k#bv)cZj={ZsN{yE$w1(6JY7k2yFpMS7f}=+F=;oKHgCrsnBT} zOp9hG!z8t>t#gQv91-wb`>9UgqfwNGaxgcIi|a8WK#qTU>NWn9=EbSYItQbgq10O! zIk=g-b_g+FZV2wSvLvX@n?E>@fz49H^*+T#G0G|-LLCh0SFevza(gM{6YBO=%;OLHVUiE?yuif+dCIyAwahk!Lk8k~(@jW%^UYO~* zCnEgi_2lvX`ULhKS4wuL#Ks<(C02=oy*R_Acu(^JRoxY3k&1<9d~E|1$+@HJZo}&x z9=?+Iiuqa%Rq?JX?3=Rh5z*vGT%;AP=FY2pvO;mY6(^)SMRbu}XvfnCw9UUFLwx^<-*Z3T$ z4+Ac}O1P0uo0C!Bv|#rMIzvZ=z$Cb80n3c`9LWseJarsfTt zP(|hWA5I=KRB;riqOJ$#lnp&URJl%m;x&}A*-)_dj^0Azd^7%D(u*W}Qswk}9#U$< zqoB-pRyxnvN`C`EVFLnZE(CRK!Cvy=H|8+Q);M7&SMEe}i7p@vp*FJ{tu=z7?+PF~ zBJbBJkf9u(gP8C>2a$Kd+ne}XZvx>2Bkoqg=$%zQQ6Tv#Pjg;uF9*J?V-o02pH5~} zQ1ezRr`W-Ds+^O&$Srw8R*y#gr$I$f=h@a~r}!%}?$zb0Pc~blRhI7MFRtym4jOY^ zzAWw7EXkp@)R$x1m%;BhV}YloqW_#Ta#lbZRT0E1SN5FYSlt#?OJJ0-Gk`yYs_0Z-Q9vqqj2x z1%PG;@kI`HYwzgwV?bNT6Z~GLq??;rcQjd|J453|SsJH{62lxn7pWcqRlo@WHas^s zR}eE~S+Wm4Hd@imCbPlER9LX7fh-xT+6fs267c-b#&B!Epq1SbiHW@7jhfS_wXbyc zvp{+FB_3?B`K~pxIXQ9|oJfz2HOQ_C8TOCV4E3KKA#r!#qFbJKbLZV&x{7JRJax0r zJh|)Nwf%OozWgMkL$smz5cpxWS~gG1hp2FB(F^VAbM}{UylU79oUQl&GVioQkTepC zNfQz9>6XlSI>h-a?sdcNo!Llt_sAcurf-5a?X;7FeBy+iGrkBOW3KY`@mVBe5?UwF z1KqDmA`C2C8W&!4(YKA41C$2Xkec8FLTmyjC@!*}lYV*Nuc4Q2s9fS_#FiG?QY*sb zdhV~feZ9B~Oh=XLq2vIwUJnqR!1qZKmWK^sx$Hn1)&e5t3JZ(wZCQw|EFA3Y-*)yM z7oObgPffGZ_*=t#5aY#*%G&n5FLEOzBl^W=&s#1tQ8$9T z!-586RFqpIPIRZLlWz2b;{zCrRxb)v`fY#_F%YE?7Sg(h6QNJwPrZo$6PamXJ^*mO zW&yob0jsXAo@bPOta;}AA{Vc@QHCS%+1P?1DVrbfKe-oza|=hxG{wGdSUj{}9b#nN z_j5i4i3>As^gYR8_;85Pt}Ax=xRL!3Kd%iXc(kgKi(T3{3RbJn1$SatVv`kFyCP9* zW5Wc2`*-SV`p}Qw^;DPHY72>POz2O|P}e9HW(MchCUhAc)Lv0pEU^5W8(ZSr8XK`a zRwKN5b>O}|ibEAVV|M+;^#u&fsHa-r-O0y9fVSZWJ__81oB{$`lKUIsBJRt1KYr)} z^V+%7d=2Dd*b^GSM-nO_uSMeVcv^nTv9}Y2MV1|x^{z&l9#WSP|AqMuwG0PAvqPbE z1XBANC1uC-%pu2IQ{bl3gXwIG;EXE5+{oQ1y>w5{s<~ZC#`av5;S4GNLCNnnTI;=Z z{#Ln#2aYCBSB`P~8WSf_*Ca(R*VHH{`-(50>dBC)>B*nurpQ|S`VZ6Q#yewE3ZX9B z1n=iY2(%rp>RAS=21IN?#EHu=;7++TS@N@_x6)t3&INl4VcBjscmg%(5`H zY8IoYp8L$&TC;H0JY7wK!DEaFH|RFsjRppA?bomO3(B)_-+*kZJI*}f454}~pL}m^ zyiABA?xtf(YocT!_&=HFd?k59Myl zMr)^~L`_Aer47px^lCoJEQ_x7tBAmtP)T0wr~U#ZwQ8}0-*saJf=tR6qzZcZ#pIMe zKe=dh{KeSBL<%TPK&3gdxzwQofn}?IN+l#D1afRg4##& z{p(L!uX<~cCz#CsUG%GpP`hGIs$MuPt;+F|L0lh5IyaXKk@`DD!#l1{?w&pNJPO7I zPOb5(PiD?@?)Swb=+V&k$Q3lJj(g+Nam?L`fjTv)<;(o`y>L-8#{zOsZxj8fuW%Ig z?55D^x)7_m_1r4QZ$+kbGM*plJnmk3Ecn~ciOULp3Ch(s?lA3}VBMcY zh4NI$kHc+%noaoeAdI>SeF+s2NCjL*4BJ*C?qlRGpIO|qH||fg<@*Wwk3}}X6x)&Q zAF3%8d*WPoHvYlM{KtQI642rAMZY|IeT~%Kcj{4p9^CKz+6W_c`!tc!$ZjeR#<(CP zHhTWs=(5_-W5>{|WliG)C{!Hz*)F0V>DnvTdkg85by?9)tG}XhRRV|yH&q9zFNAXD zH%$)Iy?Gl!k#rS02%7S|Dw0Eai0a1%>PVnKei0f9Lyn50`dkEV=a`>UQ;6Fa+=|YB zxHfSnDQd00h7RhzWHIYidn%{N6C5X|)MU+Zf?3tTsch`6x7k1y0ZP2HCAYaazTZ~6 zv;G`fy~SE*Iop{qSv*wN-Z6Tz?gEu`0H?LGtgMb|?egvhwQRI1hI6ot=w&<99DL%u zQ%>(Je1501SV`e)v1aQxuLVdE4V^mGfHXw>-6p|)_8+>?>f4!soImc3|JUe3Fh`(J zPhCKW_#y~u&^tc!7l_dt2qjuo>VT%lNMAx6W0}igCp@ZMo#lX=GMUfq`tlA)F2*kvA zVduNxMpd=6%mOOZ1zcyo;N(GU_@<_&2rQ6|My#3z0F2my9F1)Ng8|m;?9CSg+Im9( zQmeo`MP|1G22s$r(!eZ*;CYIyQ{dQ{zJF7j+HG}0Mkzr|4^(V*Fv#WKe)PZGhUz5x z5X66$$c5|RUg0G3lFoS#J|xTf7u1Nt5ByOE5XCU=iiOo{FBDnBTiAXEqSNBs|L5Qo3t{*GRl z9%Ngn*@nFmz$*{bI2SwnY}KH=#_lV`9fsHfAVgmNmvoP~(0dDva>vHT)DxM(%>fiK zlatR^74-qJ zncDt~CqX)N;F14!mu~95zxU{CD7}sEP|~d<+{V?qh^ue+FJQ&x6&0`ccs_cu{C!(; zRs(!17*V?Ik~`s0?;|g8X$*-?iQBD!QCdhk1sFWI0u$fNK}JI zUlSj5mV#Q@^Hto_b&xR0`mf2SvKny!kwcWgH?R`VcnV81epK zQ+WAOQ(ynx=JIeZP^=43cceWc1JJ>=7XyI4fHigs5?Nl zK|fZ~nKt~xHU_l$Nv8B{ap*L8@bzT}^g1Elc<)*P8H5>!(o%o%;J??@&oM94ICJB07Ak0;!MU&GV`Z8zKw>t*`;_SIntmsA$3hF1C?T$hV)RS-^gAOH zucHOS_I>^eonnU(1}XV3r-Ym!@H>LWX|uW5kMt`c{TH#mz`?vm7~|fm{CnyRZz7D~`_Qt`tsJzpFaId-E(Xf#4s zL(hm#>iDU@RCyX&zJKoqv(pl0WqSIq`*lvn3YUdwSLu0n{x5xx>XZ27E8{HotCZ#F zV||hTy;gT%Y!|^>pfvUMOpO*|5rxSGQ@CBZJ;*;`wu#cb8CVL;tLg{#*%o$7I$Byz z@Z04Z;k3cEC1}TeJ_M*=+fdIXDlYHx$Z|JkaOFUc3lJ0Mgx-k3!i9Vwvnc^#?WQP% zwIt90vcRGG4xI78DFFeN4&t^Y*l-XBD`+bD&EJhbINXAI?WuMOmMr-HsZ*7~e{XdG zF;Gv{n-&?m`$MQis%0I@_A;a)56LNTQ4NT?fG7~38#nloV10Yd#Je}?gM=jYR0dqg zd;9x@rHaw{r!>axfNH@Ulm=ZZs=z*KLAwIfAhvb}*Vt0CMxKIg+Q9yd?pVD02-3+Q zu`|oOaPh^jUk>0~RwN=K5^T6?y)26s;<&1`beB^B@jRp)f(>V5dnS>Kg98n|L$KNH ztS27kMVt8PLFvgmBM-xNF^o!G2K=yku#LD%#RUX z(MsVexFOZm#i7cQFM`6t!uq9_Z=g8hp`;8uGw2RrN=*KUDk;c%0G?RD5O(tXRaMY( z{z#Aip_!HaEYuE&#Rh{>ynakoq}m3tzOJsVfr~vH3Jw$-q9lSK3~h7>)%h<~nkf)@ z9r)+FASgvfN6-8bUV|RMP-#rgK%_EnS+`QPvtaic)b zpxZDvJ*wdDpR4_`w9*PR{afSZWGU%S8J#%%E40|JVMT<&UGIEI{Ufb$>;K?tP5Sh$ zO=zKkoAe!if<|UVEVX;XaG~~oxL*{@v2E`x?@WV@#UzWWtxXXqG(tHmnws0%`k;RR zj2bKdl8=+5f0T-dpF#|=+{zr?ehB@e*^kN>W;7sd)p4gD;t|}lSV3{UoWw8UO z`<~Ho4TxX+>eV21^@3Bukg+oFm!-}_<2Cgckj^%s<#HZEPA@Qp^hOj88dEc|0#5VO zPLdeoS{W7mf#i~5XY_r&zh+8bjOs4@$s1Z$~T#nljwic#_UzNKwR@0O2JN9E@ZpKsFVa;SDI}Ie{339MlUf zT+LHrV1UvHV-QCmq3PgNu;Zzzse$c|r%M>BF#_n`xw2v4`A-gpaI#UmE3Dk0Y{FA{ z|H7h#i*f8$oL00OlhD*}DVckMv1O+9WQfP2H(48WVO4MlB5g*{^Jc)q!vkV0;Ir)X*vN(FMDFk>3X|d=aRT<2M`T10WWk4(0dzUY-3HJJ zsSfNb(u)G3QuJWubZdNWQc{xXZ8?~G2pdRgVg<#GIoW0B>F*t&zoh^KnZMh7EbbF5 zsLI9$Nkx)d>E?p51n3>G0tyho*KyQ@rA7#FDuLEHI_|2QnA+rMB%nuv_ z#MEfx1U)*p_{!`V-HLtps6~N*=;&y8E-=ya%0{cF!=wz+N`b8_U1-E3^&3h(0&duP zW3~e!aWHUWXNismrLrAWemMO-2CVg1#GP$#Z@;ivS0{xi*f5M-TU5nvOZot}jVhG> zD-NaKMdW!H3_Ov8$v6edSA~Rt01s`p}LOI9Vx0SG*uUxs(Pc4mrRoHp6 zU@NK}zrwTrr=`r}b_43=dsmh5L=7FCaA|7~ngQdP96Q$+KTIyI`edxF+j&a}u83sd z^mXu$`_KlBtB_wLakn-pi>vr=TS}smJOt3_7GZeUFN$vS`sBqz-iC!QVn*aV55o`PIl1Y z_H+7c;`ganE9`Od&|L8CCy_YC3$>s%8rDH{z5n z^_MSqs=CH6J{FNDB$W5N5Y(&d|Mug)(68MpV)DnTQ$|#N&%r>hx>61*wA$UfL0~Px z+^EjH30W3eN17u2rC#4viQ_<5)qGw;7!`t3@$LC{0yf&oTO0ekTU-(n#(;AGyuSp0 z)RM$V8By9jif_<dT1C>H>(|#CdPr(113~9SEu25L*`T z-piG;osq^^R;72E-%JMT$gj^_a7p--$a19B7D|6?+8_p(ugNGvO(Vs^Atp9ND+bMA znQOeX?8n9bqwM0A$MS$JT|pWj! z1vIn_JWTY>0Lw+cz(t#;2#zT={Yv@fZ`~=89oRH_QFl3P%L7TqhP_iu(61L0v06yem#%ffC$E|S9}M`+6o&>RT-Z!`O3Y9;rfNZ?xKDj zka>uYEE<@lRf9xS#~KLI(bp;|c}Pf0B0(UFV4ih!HvbVO=KL=RTDAx5(j|3zyE)w0|8Qk|n%-aar;@1P!Rv&C0+0p}JFOe9LTGU| z$V*VdT@n(iICG>NWO#VM#oDt~At511dkVN`q0hFYTH(ZtJCKq7Ef)+AT6jaZAcW4y z*jTQR`V;`F;8sFxX<6zhY&T9pTp(wraMCe*%5Sl}CC9nKMN@# z0v1{EnqQwzx+$6Z|9m5hDZP`V8Mn*)VC?YXO$YM}tu`}Hd=9o}z|Vr%&|RP<5b3&x zV*x0#sOowkc$MC>j&_nP$jwDFs#Jy~>t?MX?RmgOMPX#2j=GhuYDjY7pZWn`Jo27O zYP%})HvKE_lx^3+b9wKmY0J{SQNJ$`*lx4y-t48F(z-m>9p~%8$0_6|qV|WUho%}J z=$wEdmcPIGdyrrm7F55?t1G}YZhJRbG{t10E$q&GnPdge44I>NZEY>$ayDvSC$8&3 zV1KZqt82%^1^0#eWNyvg)0)snq2!tIN+QnX#OL>?ECgd+Hy8C_jQ?%Mq?nqYPjNS% z&muouPJi~kPF=i0>yCh(!Cq2EC`JM07yvE3;+sDn2yT_2P~PuF&ZCl~X9sFSDSX#o z`wd}}D5L3ngN&ZT&gAaqX&=44HS8C1mlBf!4N6oJsJcJp0CiAqZits_cBZk>e4}mo zY@Y_l4q?OGeC8+A6QazBdd;BUH=FA+(kH2UJsuLo?|qP1`E39@t*5-VJ)m?iT=G9jPWH1A=SUOGJc$D>@ld!{y9&m3AiPh z@$qqU+UX-n*8ezfp#=;m%9D|{1AkQL`GQai5H;Qz{0TU6}$|9fGM|s|3-Rmp(i;uRe`ev+9qbfuNVnC z79h*~tP@5K9^vlGzmmcEfpm1iHtT_sfZj+uQkH}$=QUz;W>b!92iG6cawER_i_@*bkv7fcrrD z%Tg7%!r2l$qyg6p;%~%778VvFHXrC~Z|dpMLO3*V3L!TIB3?T3`4$MY1fv^xRl333 zk5o7vSBL_-cEMwS&?VsiGpGQSRvlj8bWe-D36MB)rUybfccg1t1yUuw*aqG)0zf*v zISY7gq%P$lMa3C|;S!qgY|Ftv%FfN*a*H~d9e@W=ixFVMhG)+agTpLPbsmW48d}N_ zbPvtL;=k&SAn!j_a`?+}DO8*j-PF=tf-%`NDpkUnkIFO;FEu5~(;EnN?*|wS{bB)^$4Jzt)2t9@MgUuS0TU7>_f&!tk z^5UDnn(YT%$DXn57Pc%^2xzQ7JAQ>h6i9Ih>PRWF@iSZ{%A|w+EOcc&h1PGx{Q=f! z)G6xzn~FAqE9xLy#V+CFB{Y6cij?JWrQEMsU?_p&1z84gG=vR3mKqNB0Kqfr!PHYY zLV_dZzWDwOp6=w5=>D!SxD)W@4Lc(`OkgIE5zHwRh;^SEdTJKCRBsgf`dv?VX`l@= z8aN*>U~myzR!f37ZfIVn|N6y~S(l+buN2J6(9HLH)5tBe}zw39T5fXo} zlMBsL8F=s>?SO^&=iHoUYI+p#!B%xgjDF56_zt@f`PI(Txn>$Q_yC}rT3X5nHpdF+ zA|$6FPr)!1#m=9Wv5YG*dcL&0(s|3(I#R5159&CiO$eyNEI8N#hO)7(O$GQJ&M+sn zyR2~1l%vaOhbk>002 zdy0t<31n@FE1#8O$<~{^Htc6$_GWk4vhR}>@v{y8zKpFJCwE>k-~O)8`-efcs}J*T zOwJR%X1T&@)cumOw*Anp9x zZaMK4w_4G}zO3_EBQl1uCsuH`d*Xf#)SYKKs`WKRCIsk0urr7tee+}|Pli`iR6zF^ z5_r&9WQ1_bRSJ-Kb2KtTp?kMQx}hJuzkq3yV8?y~ArpqY2ehj6>fER^5r9?QkX}&4 zodQO3AX;64dPN+=PeU(&TaGQ!M;$0gIKV?QU%%|nDM?)_k~PAkFE8iqjxtQew&a*p zMBSe`8t@`XBi4ZW^nonzE!cq8gDKCCaBr~?Pg}Qocf?Xcs&aZ6|+~&8ytz6|~2MS`!GXKEH(-}Zjr%#_E4ciE-1c0I&lr^|*O9*;! zo)GirwwN2TNUIuzll224-Y~Lqs>iLX?rzOZ0a|HGccn4&xv3=1nr-?m1`_t%88hf+*8} z&SP_)d0~7Ex`>kapyenh4p@@`F$xNbC>GE}X{_lkUd)3?C5Hvw^eWm5d~+ePR>ADxeqog@K#`mMz#aAwdVshuM#G<_6(l>-qr%pWgWR~ z6h%1SN0E}4US52B@B2rTv*$&74NjnvIH3p6(S8dpFf~w zVl@+ZjRuZoz+PwjISp+$>F^+wmf)h>*&RJB0No8ya-e$y;e3pJR%JjHmhX&AcnuB& zWkjJzjs!rwVSpNugO(7+HI~Y0(5_+*i3qUdHtK0i*d--RK>k4vxDxQ&^T63SyE+!( za5t~drTA?xm0qUn(JA?QKYf=K24d*a@>ycdTZ5Yno%3afT_q|T8Z{zAOmN`SUm;Y) znrhKqeCMQS;P5>M)IaBU6hWy1|Nj5uKmT_=>hwTTeD~0fydzH)Sqo?xy5|SBz10aAp}AVz0C7@&OLYTo%_d`HM3@Btut%6A-a<<-}`>g^Lu{feWb6e!L^ll zD}o?gSk3bW2*L?3IS9XPhF={A+biIgyvKzr9)>PAJ@D7uY!IDm9*3+*t{^4l^p7`4y13nvI;6Xy4KDJ#tEQlFJjtU|`u^axLwEmj7TS18?M1rB*o_dcA=~QL7iTUu zISrj?f1UenOTUz`wcG9dOOA~jU9O6JwOL*38IGO$ z>2#y=TzSrL|Bs|AwEDGA?aW#{sjRRvPh1;8-X9b2+6y;_6XbxO8+O2tj6pF znyUxV0@-{R$tU*oT;9*Y2uw_g{0BIl}=e(Nq`0>`kp&|SBd^=(? z_T|xx;^HeBp#m+r*Q=V7G`QhYnnd+yyeWx^hsWFARn-yUn>TXA^XSB>SiE@g!gnMg z*vQm0qp#0;ae29>>7CudFTJkEjvdpyaN)uzy`n-lPK7i!=7?=X$0#W+Q90f zvZrgLvhwqd;1c=cGRPTitd352WpBf1OO_B8Hi-9x^uGHTz*Q6nUd9czfe zcW1!Piyc1v(bG_7O@1Tc@??vN6{EAnog7CGS`XmbfAV~pFT1fJL9M`l(G6>W!$om! z*ub-M=V7d32P3a)NSGClL{_Y%=tiHuHmqGNxdXv{`1Vp*=H~Z( zT)fhnug~GqSc$#E3{s8+B1Uo2mqZ#Ie=&^|a#K z{TLbLTF=Rz4^KJGH%J~Ux@+cKa=~w&wc75pVe__zx$%w)ukJT4?RII*{$m#X{@*9H0*P2p1GP?aHluaX2CMR7< zxB{*1!D_@=c$gRd*ehuiyq$mdpMS=)nKb5u1I}+t`k0}BqBX3;W4rh5OD7U{Qfm;z zd`o+i{5^nHWZy&hLAV1~{%2lla8R+6rJi1q@gMK^j|0%S#$1J6{Vyys#te^=muB76i!;i1pe#sk8NuKiETWTtsDM=N>b1N~a&Qs1xN`5pi-ZvDVkG zv*A%66BgFkC9K;#)n7F@IM|}avjK5kwS9R6dG_pCl)QWD9tj-A#bsimpsqSxjQ#aU zs3tKnDTxQ3%+se&BgA(h1m@*8+Yk{E5fmK~6BEf%axUFU7u3~9?`#ohfXY3DRR~zh z9~~WSPSX>lxqbNXK~z-Kz95PNDUQuA(MGmx=hMgG+G&=RL9mdPA{Q&D2)S-=HPw|~ zZqJd1gdqE6xV#n?dwbQ~!h*zgKvt9J9}vKE;6N6?qE~umrWVnINh%Tr9E}T@d+iYO z>eW7rV%M|F^AnNDvYxLGNlEDm>&1p)Hf`Q4die0U19HwrYHIf|-xwa%H8t7*Y-G=! zyLNfbj$8u3)gn4m7)LK?XgG8fIxPVr3SnWuj5ej!^Q>F-_4RqojhP0lEe;bgf`Wpd ztEwF8W0e6J!Z7Ud4ii95BVS*NcnuMQ;+}wjKzo^Ak%Ji)i&gMncq^6GIH8hCpbQ}7dH01sLr ztGItV^g8qFizCG3x)?==PY-ugfBW|1^{HDJnN5w)pa1F9S^T5G(!&FNT49lq!r0M< zgnQ`LO!k}&4-3;I`p&Z?0Q~`U(+dkP6L;^}kwCVf+Aq(Ilbv8M(BZLZ(y7&|>X+x#>4dO^^7V0c7?7IA5o zkp$z!VP>c{Gb`&Q2I?pi*56*@p5|Z%BM+ATB7|S@XogRf;kk2nr)Or2EiEOnTYvja z|Hh4ES*P~or6pf%WBl2B1O5F;7F4g2LV%+9{;E*s!c;#o*}01%a`dQrTU(n#&{`=b z1KP&q*`M15Rm@vjS`@q|<1ycWq$FvC4tcxvPu(bjVk;i>w%6lp9i%79_64mC2hDcS z*IH#}tt>6c=-NNr-4u1|Rvk~x(!#$0Z1UqDS{E;_ zw5~z{Qo0@A9P#d^+;mAQ*}6BRh`JFe*7EZW@}S8lN!YqaB17L_C*|dxgi6c=fX>a$ z#Q{zV1TI`N*%_G(fX`-inJN3uKF8?9Dw#gnD;0qm92h{q_;F}x(Vz^1G_)2#SJ9K< z0l~6OoSaBXN=gI6!)XN$G|EuLY@@dC|un6<(H}o&_gQo$4x4L=e|!oq@lsO7U!pD0y*KS9SXoNHaQL{0P2wd)< zqqKJGwr!=>uc5<4m6XhP9ldDFf}0>5kXA%KRaJ?ps8|{_{r0|+TQ!?NAl%#wstp%n zHo@UN*LJJRZCX!D>sRM_D9G419~VQ_pr;Ik_9;fiHP ziT`wDa%QF|T;JHp=$M?GNmHuMON>sGH1_l7&kDY?BSm$vdnWG8-`+EGD#)hqZZhU8 z*2|QXq9P?y_2S6&D$5s%`GKpxJbU-n0AY)b)e%zU+YV@#k)EzuUS3W=Err1(`$%m? z2wq=F9Px>X=L}OX+Rc5lB1TA<9mV<%$Ka*$EOX`gPWRgGR7^^8@-ZQy&un*irm~Jd z4`Qd;Y-2~qY_GAO32>v>Mp99CW_?%%)vt-fB*tjO7uB3*?oPG(Ni11PfyLIbUgDY2FH8wR_FyZ4Fxw$_)gC14(>KhmkxAQ9`gG|C2z;u=I z7}2-6aiduB*8Sk%EMV2ub#-1&%n(JEKI}yZpZsC$XlKbg^{4w1qNDj@>W1~voZic=5a%dlGM+skTC#xQ_u>tDN;fL;lv+SjHg!w4Hxpuod4 zrjac`woMnzlsjxZc>H(+`(_8{FzDs za56=foDUyACSsJ=7W(N6nmsjYx9HHsS}%q5P#rkf+nWHs!Dv#b3K3K)NIMi6_F8(M zg}HBRZ=dN<=JMum(11(^1Diacw?e0Z67v5nQx+tB^*uq1+~iO90Wj2Z=0X5YSe<+b zVtdGWUG@yj(YX@Ojqz3$fpnkWd!9&@yAFd+crWAXfD|*yRPt8jR$cU^%a|`j?NSNTi%Kvm7aD(U_nXJPZ2RZeg;Q)ya<_#p-aUKnhH{HhM2+Z3aG? z@4+y@v$lg4I#RTm5VZ0jr^eskzZq!sri~km-AzDh?eFA8psl+~Cg9@9yC(mO;!Z9#{ZKL(uBLWh;AKSN*03zTpZTU&Crg>MS@B zfuFy>{*?s(}GrMLFoEjb(me$ zB7vZl+ZOOmITdRZOJ9Z%p0yK}v7smgiB|B`y0?XUt=$K_p78MSe_wl1r`wauBpkb7 z=5mfD$;_p!CFa-I`wE*D>pzXHja4>-4@8}`d5m&NC>49uIndT_g8KOTgMb}C2~|sT z^GL~XEV@XhA%Zez6#0P-Q~rL_tMZ8Ia$EguQ{0+SFt?zW@|J_Z*98Pfb7g9pgg&3*v+p*%PrUF% z`r5~ht7tubvH21znDc0t@Mr2+&ghKFVPN!Okz&4T35kU@|*8yMV08*?J)lA3gfvH&HepQ-e0yi4!Mk zyP%F-@7>%&h+7@Ig`;|rQ1_^XMzfNsC@;4J=G~+r7?4~g;FtYxUp$OpgoGGvx8hpv zZu%n(x>|9f)bQ-tv&3X@x&oFMX&``_Q7Z-h{axFp4G3Y#z2+VvHek+_3#j$_Dt(;< z)D<=yl$*c5G_Zr!zP%Ma1Kh}&1AT?U97lzOK;mJ!xVTWQh{*s`4V4~LFIYt9r}0ou z7W~bZJvzv$1wT-(k7MzvS;fcu_171NRNgg@=cy%~TXYoT9+|^|yNc`ZYT7Ei7UJSD980U!LyA zfh1HdiwO(c4P>Y|kW41Gf>ngULM?*<*a9rn$k^ut!TkpM|h0Dk>nWXfS2WIY=(_a^BOf@xWJr zFk|e#K0h=)If?qF79Co^e0wW{Ek4u&?*WYpP1pz?BL;iz+BMLqO|2v|3+6LEd4n|F z81#)oSl~pB>6eo7{pOwFr515FED(&yl(aNz>yyWi4X$5Lnqzf|Wr&=H-e7>F7nPKZ zz_7>K4Ap|S8>_27u(!9zV0(LeN4v|YdGFp?bWr+36pcWX0;$&|D&Se!fJ3Oe17qq% zvj?}frshLg=gtwF6cBMwPfxO+1-J(BpFW-ESMt^u5)vXNgP~Bv@UX9mkjNyF!ZF|^ zraREc?d1Vf2eYZEDNzXt;D)hUlPfXCPjwv2Yni(2aN*{~NcdT}l=K{Lr@uP)Vr@p00RBn@|^k}2=J z4k)-zH>CpM?aXPHO9yrVZ*0jjfnBha$$@zW&JXGn0MhQ>xij&9AViv)U-2yAzcHa~ z-(ix&oNQEF$t?hFgQ_5h3S-xZ2 zNtyzf+Lzqi@+`f3H+hb?8)sx>$d&^{wwD7EM2MSC7c@y(nJp=R3til|#DyRWUbN3b zfOS2VsHER^9)7$(^Z#G|ukM4BuB+?Y&D-`JOluMWgA9VEpB6hCSbri7smZCS)xEB^ zpwPV{t;LoOlCI>Q0}%(-W77t1rK@;(k|d12dz-n4;M1d!fS<6WYM)c=x5IP1w*f8X zJ5wtMW~T#Qq%e{Dd2+azNhTCJG1)llvIrzsU@6Y+x$kv<2a^B$e=u!bs5QA<0Si<{ zQ<~VxlLp+%v(JGdj7z4qSg0&&8yFjh^KB0f_#AI>7>U=>#A1Iu+;L<#50A~S@6iD; zEO4Q#K#rvW4rSDd>kqnw+N^<7jdm2}4AsZwKqf$Axi!?e{*Dx)e6q2z5p|z`eL86G z?%fzH2+_t}dP)fm4f=1y@~VD?FcYOSAwzXBS>Wq;nD1!c#fdmZLNEm?l|4bXBBB5W z+B*Y!&wc27ZV9DTO)$!z-C_b##+~a<#roPZ@5vhv%PzDz!T|9dc%k93G;7Bm`B4eC zqWdRul`8K(WPbbZ0cGF(Sns~yyWlS8cx*N-H4F@Vdl@BdN95(@ydHzrlq>>C z`t*$8n&riVz+8hoZW{{ZFuQ!0$BTG&?6`(ET@ZExLyfhwedE$qGQ>ZoRIl+o>b89M zaZ%(u5Y=}#YYm`zRaPd|P>VxYxQdmB9NAQFb_@TzsQKw`)=q+KR@X+t-=;At!->*% zjTq&nktDDz($Aec=SZ&O^QvGJ-Iw#H`W-BIrb3`^%6A$cl1E^UP0!Cqrrk13y?vSw zoxEV3)`oL{uE~G1gD@c`By<5d7dft`riN$VKHKXTbjnwzwE@vfOgnxvXQf&@Hg~Gz z2McJ8{FHvbkWFofjn!hj6|c#o{)SIaPuGW;QWq_M1Q@VsgiugWkW&|hO)1{^ z=f5R1Z}|gk&k2rvu$jFhkRRsd{(HPhjwP>xM|y;m%VQsimQcS*Qg;pP$3id9->-fn z3ZWt2A5x|9;H{z&9g7Hx>}9(#vhVm+LZJ)Y8NZ)4kdYRfNBv9oj*4^w_iWF}r8C?( zEouo!J;Xm~d`JL(Pp z@tfYj#Dojphjdp!8W@(za9zxs)t^nwt`zM^=!FdMak&JPu5?lH_yC#)WDYQKui_uQ z_YB=ZknNf4aG}*mRb($Lc!T+D2LORq4r;zgSWt{WJHDlU+M~f8wGC45GQas&$Ok=W z7I+Z|<@gmmo(Bg9!`w%c7@&vL8pqr7-F`U~PiAUmFgNq#{XZc4K`n9tpMf1d-mh*C zPD6Tx_HJoe*|_BA%d-iCuWn-st_6Yf*WAzmj`?ORN~olLrf;C5C#QTV6KG2sRD8R+ zO-_EG)t*2js?5;9gS>J zj0IuFE9V?t%TpL4xV})eG@6w&JKLnk1bf!x`wRf-a9ohH-ZfG>G!P2LsMbXt)`{|E zGCZ|exO)+(Nmy_Z_0#3Eg19|L5T~zetIGv8HG4?rCFog;D3t)pQQhctR6=@1w%Vf+ zvYzUyQPA2<+_UiyHW4-%2?=LoV`HOE-%dnHI)sbWtUO%vpq@W^`T(L1RNaGTcl6>b zv_b9HRu*yP{v{8#^V{PyBv`PaYk$_hdAFUQo&3$Vqqx zTrWd)m7!M+HDZD9N&#yVvbHRsl%0(1)Ox}jw@R8^iT}AyIOcHM#UsMTt}28dC5)({ z068)0*rJ8rmC}|PAAcrPb*;EH$I1n!PVq{)t*>C`edOv($d7HIqR~hkd|)&TYiu;| zoanZII!XQ#!r#HtBcSfe`r5?0=!p}TAf9>|85xP$KVP!$GFrLb(!Fe8WtF44zF3bd z_0C1RB5=hU%>;o(5|b$uip!Xe-&CmbNPavfuQoNjEoGrKR}1aBwJ)*7E?SJ zM34r+9j)>5G`T+ty&q9@WW1 z!||-*;-50ACrhYmMf5-_yI*kq z=fnOFd1TfH$c0Gh>Bk(v+HZv{_8MT-O)z#^`#wJ*fp*VINcg~VYnM<*9H-$Rj6H0` zQl;RUYfCA3H_XNqZC^%8q+@zETWO)^9%VSzPa4iuNZ|4{L0>ij$a&N&&ws6|(qJ$c z@IVWw-}h(;Mm^YVEVkIK+EPwJw24a1@{nmOk!#{^Al#K-{eG`$O$} zppQ^lp|AfOhW)0@S$yzrg9|+p|y@a9O71vPx9@+uwH`9r^zH)K+e88aO{G zP+7Fnde!yPE^a3Pb$iefTe-NxD=I2bI*c9~ndoHeF05khkrfJc?6M#4B$C<=jibf)Y$|804@;;mKu8Q0d$cm2uZKVwnTJT23JBL zEhQr@{gpe~lRB#)3h>o2DVvhW9f6mTi0q-6T+VDycNO`RNQpm#-*S{Q-lFI3t zzayY&Y;2771De9`+cy#g?Mg<|a>1aLTp&putIO9N4kAB$RM%%z3xG<(d8JX9G$xP) zTU%QXfM*Kc`msZY&ceKV2M>%5D1(M85Q9T@zze(yZElzbjQ4jo;0o-+f$O>a!aeg0 z3I&%_HW!7)tatBnqNlNd2pNGz&!*B>>sZscP09<3aIVP8YJ##jgANJ6G7XXiwRNbv zeGBIqu^Nb*^#Z4Np`HM!tN~4xd}f9UmYLD(KkuRWGz<^iyPMBo z>XXsRKqt~DlR3y}E3e3UtRkHOBGtxp8d@-*x)%-3Z}sfi|_TPYq`>Ajf{kDx0@-fEThx zEtK+%EpR&FEnp@ZozyguA$kL$zXo7@Z-Ksw3~ zA3l5z)w>2~eo#P2LVDv&`G$^|@Te$zs3B7rlex~+aal1rIT~xH z8J{vRHE|}8gjRTPBTMp%iXG?~IdJ@~KY#jk1&HlsUEPppJcUZW4S%WRtFSoUVu4a# z&c2cW$?_;v3xt*pPDNcqOGi)dYPfeabv_|ARUJG%^hxKuT0?#8wmcg+r|}k+tHvGG z5ZrnJdHaIBE;x=eHco*E!)ofqUPJikY{DZpw-q5D&VKoLd+$5760je=Jv4zn^9E=@ zBINiPU|)fvI`Hdmw*5LL*k=gT?|<$j5PX1eXHC$9WfE#4M7kN z?A1$}2=W`eWeeD{34Zh(=_bJs8CNBJS1p{StH%vz3q)!ydj5qAq`7aN?T zxQL91*y$tIuC7ilvZA66|6Cw~bG8yas>a?0H`(fR)xZTocBr9$+3+6Ejw6UbCic>w z+MdzV6rbxIZn3qq^gnlsiRyda`SUlW4IJ{yTfT2pdXKGb%}nMs{}et^(k9U{m0c84 zs20^>ezHuu(AMZLOD%&?Sp%$XpXlI5t%hA+^5X;U9?0FPv^>q1W#v+NE1F$Vx}Q8h zJFXGkzrw7FYZ`L;Izyq;;_(>i(hoM$sl3_*m?dwP~o_&qs@FhPIpWP?}s zT?n_vty_uSi4y;@fI6$LO?;mgii5@t8Zw)FRU0C7;vBS z%-y|vcVxUQ5|Fk939_E~QQRysBBG1He79nB-Z^vzsV`zTVa z-OJwm=-9Di7%UqboA>zZz`c9+xO9!>7!|9D5LM)TmO?RMVPQ7)p#p-!!W{)RZQPY6 zNPtWPn>D82j~=5IEj`FunJ(_vU1u>x%bVZ=Z9_vrVgo<1A!&H{R%4uET!%rf9oD?J-w3+Z`&(-L93U%c4);Ne5tmN!a-#EOb@Oy&%p*f2uCRQ`Cs-5VZn@BaPCxw(I+MoLUv!IgZX zqdT+5*zs^Eze@P{BH2_A=6dn_Q&HQ`FOJU9*IB$vdL~{<9uzmCva<3*|2nhZo0?U; z&}9`T>9!)gyB{|EH(G7ypDTlI%#sr6#fi2ngaxP!yZ$OaLgLpLIlG1N7Q;&KLdS~P zPszA94{iVsnw2+X-P1HQob>NQixd8KGlc_al=AYLcTn>wO^WN+$)@;9Vfg}ypEGh6 z&+`5F;X|rbQ|xL_KP#C_aqSxH0m8zkL%8umvWXVSpXpk|A!R-M`DNMsS2>655(~4# z2;ZvONhJREN~_GhgYcX?F2PIndAQ^M;ce!IasHR$;gS=c*;bz$* zF*|~S_`i93^Dr!0i23wh#u@hiNw7;b*c>o5WiP|SDQr@qPmu6kc2ZJOs+({HAedYk zi}O&Ve|~v^7{ zc?$4_v^FBT*eKP1m4KFdcekP2baw}{;`8UL`}XaVG-yPS0!$-qcQsT+SV)LVi`_D= zY9+bMje4TtEm~mI1El2#RjZR3ajt8bnWtfgm*TV2(_8088u+n?WnHg1JHI`P>&vXK zSH@}v^UCktwd*z1Rd1!brY0dhBcsrcEP{PIB6d+nCoDZZy}+u87prMz7XOfoFB|sd zVFh1(!d_n9Yz4nn>yJymghWS5SsFlQ zePd&og#jUv#bh)zHL3R$Ik@l%9Y222hfZ?~EQ0;akHJ_|%G}bkv%@hTKYbF!U@lR~ zIUX}ow?6OG(bl$}>8m6po^|N99&di#UE~lYC@6@*?%K8MNl=iEqhq!Y>Hhr<9b~dy z?eoI~OkmCHXU}%{Eq3S$iim_`+$P(x?3;Ep159aaX&uKtdHPfft}DDfbeW#_kmFGD z+qYuVJ;myT_96!(4&HP6US3|Z?o$zoGwe35t_8Z8`h$I7RS=T2cKTa%tftEK4Xm}Ir3sH+fG7bX&xrhDw#l2vKuNy*9SiHVmsZrn&n zbf4}P;OAE|Dza~RyyqkatD&Ls93SN8;V z+xG2RzP=T@+1JzZt(uext4q@v@$pCeWi-E4wh2+V}jGRsw7$qNJ-^|%Q)s-I>8|&XS`@W`z!dDdg zC_3-Ukonr)zrkogRd`Xn&1me|XndFPZxLr5BH>|1oJ)tDOGBfhGgs!vs4T{e$I08+ z`noy|qKGm270Luh64SjgMoy1_cC(9toC1=P9pSvtp=gm5{s0vjztw_I&kiQQ(x9bx z^ypE;GS@U8Mt+k*M)^#Y5wvJ+YG+oV)8K_F=rGm%5)35Qd(oDT$5F}_2~E`2qy{f? zBK%L1WVs3;Wc=(dc>RaY{QtKw8$j#+`}6QZkNv!%VdN5x;?v^5Sen*?U!($|&2S8N z{9Fnh9UWs=BfzlEY-4KUAao*jFXrxmn!%FsAy_)Cv9B?e@;tEO2wt7*N4u8#L|RHL zVS!nP|CW2>!2JLKUcd$_-})?{{9#T6@w`*ZW(K`KQo*n6bVDoO`tlXkXlaeX!ND>4 z6gO%o07TojJoA69Jt8Tola`i7sET7NS!Xc-5=U>}KnuZ>2k{?&d@}aOC_1R)v$n{K z#C<}#-e?lZ+RC9+SjhdhlcJ2VsHu|$Y*Kl_KZuZ1A+|r zn#8bqP9zZ}Eb8}G&eaRe&D(hv=@(ePynF8+KbFsb`L&q1c%jRfnre)!j#lzt8kUyH zefV`h3rkD1;}Jy4IS?eeDMK8&@|>sTut)D;OPwi!F)WG&zUnN^BkMf;sK}9$4oIa; zIPq6R{P*uS;mJ+h457q?oV_~@`+fsr7-d~rM z$zlm@6WZs`S9=k!z=P@N>z@J+jx8IFv*wN`J#_4%^m15G2iXA5@<;Bh}E*1vim^A!4Yi@qNt;nILx3>QC=jOgj zA82YA?6$32H7;DZ+nHsQGC66B)wH+Iyl~+{fj`rm?tk&&4h1vGB0h;7YhTg#mptwW_Mm5C6Dk5G^Vo3qt!298e(ucTQwu-(=kwDM>qIIQ0EH zO!5_n-jWu-%o{Zi(=s#vf}IwEDRk)3y|uw!7&ZXC(SEis-hsWa$!jqbtuVtB%On^@4xwKt(X4rgIMvZ!h0x zaqkzuM4ULxg;b;^`CEEZqg!}9-8Kz?Dj^L&URREhzI~yiql5PG{(e!DOuL*)-55EK z&Hy&{0_acZ);)Rh3KTAF&)P^48xk<@C5ha!wDk6U1{9Fu&zMFf)7sivJE(BKg_bL@ zk0YgUv48}UK1=q6xPFtat}Yr=r1S) z7+JSg717E>@JM`IU^njM0^EC29U?2fAOpf4tlLueMJ`Zr!?tcK7B?gZ$8#n5;v%3Js7P zgv2**j`=NhSwR~m4+Se`!@su-flC!IR`GUc^B(ncum8NaX+j;p8shBi{8Mpk14;~o zT~uFRP>)^%!Fai%Xtx=_H8ekPb5atn1S=D=E0+vGTGSg|1TG~yyQ*0Yd|wmgHh%gr z6-uX@x&EJZ8B@D925jc@z4r3uOMonB(H@Gt2M?y1RC@m{^(h|xZaAS+r>=q61gi+` z$w1t{U6TQq@k;)7q?qC!)tO_OL(MLy-F29$Vq`l5G)o{P-c{&w6?MN`V_y7v+Kki5u@XKqJk_&CShI-hjk^v~y=0 za6X|LiHa{6jUTK&5d&8UNl0jeUi+y!A3fRv!oJHu5J4IvNtBJ((?Ed>9y@jcRGary zUaf1BJbfHWhE-QvS6{CQ%!VpH^08SnfVez<@gUY&E>6t)r8co?h=qy7+%p&}X0=yH6BkYHctd84N06EL5+i zt!;V{uAjzK?}H5paVg@OhWPvvw3k)?d~YBTf*ZDV6$ zEGp8kUVQ}XGt-9y-kqMBic%nctV4G}3+xLZA!mUPT_u2zy7$nbjNabsbpNeex2EUh zkfF6={P=jp#l#lC#z`wF(I=qIjpO$}&I3wlsHz5G1VlvC4$HZ>e+oK8spURvA5mXl zUx4dZz-ofeAnEzT44jAw=tzVrQXs#qtf7!@rqc`&DhPA|y;20-W!~OpOH*A5z=V_u zWv&y)0Dn6&^r#CHZG=Q<5vhKRrS1Zo5QaX;06_r(jX(dqgGn0^1Hjx=eI4p|t~ ziAHAvZq!@LedgwUFa-+m>;Bl-%DC3n)&k)0K*_O$_wV2D<>Si<6VjUmB~3`I@?(Hg zd)3r;_5nlR#>NJf@|--G|c~6(3Mvol%wLMLe}sm|qq;WfEkpcM*{)22GB>{_$!n+6%!A0CMU< z%S6fP;QI%JL~zp|1O}S6)bSyR7Amp9K<;>J(Vz{+f=0q+blSi^>iDn5cXee`h1Y!O zt5<1&-x;t#^lY&@fs!9MJmC+R8~_fDi6Ipn8B1^9=Hc0BNXI{ zzkd~F#4|>euBWAyaC_*Jz=;!=f&R1wN%f^df>GXZLHsfjKt^r7x#7AWpO7 zsN~jG&C=^4@COBc*4m1Ki}S)Ft9gzI?4cFiZ*TY6V^}BZR))^xKw?p07mdCsy3?RlQNeJ7vViU`}6C@J+H&`ctM~v2Br4L=#$tf2c1lJB7y}GxV`|)!NBYjBqf#r5G zVnk3}Uui;9DsV|qY=tB%DKT-p&u2!*+B%go;`M>(6H;ZWQ0CB6#9{cnfM42W^ck>$ z45(7HT|tX=U5^O@uLNbOwB5J2R=6(<&GV9SD}(AL+FIClK_v`GFt z$Ep>}jhi>y0nva&Ko`so=z|MX({)3Ce_=-YjT<*!1Gh-7u0CI`VzU>9fjuoD1KSp| z3o11F1NJ^+F&>#|S}BI0rO#@Q%9zp`-=0Rpfld@K8efUmqG@jjM5t5`*l2M=f`X{`Yy=TPF4+7!*RR`~yTx`@c;$~cNoQ`|b3z|i zG5Zks%Psh_(qbzstK#u~Rg>~?Mt9ePgGkgl*78s{2~UdkU$p@@tc1^_^g3z+LHoAP z{3<@??KAqysy)j{iau1;+>;XLpRO8p)&}f!LLziE0Z78ZgCK)O)`2h^Ot`2F`x3AD z(TVvcMY7yXh0D95iMA9WAep37nk63bB{m}NjeRjM+0J1VZ*Lp%rIptqnQ!7 ztAav8=roTu#pUQ^=+1TzJ}I1%dA)y%k2T1r4c`L(7#eAMuZ$2OXE*_hR_oxwgYLw! zmmm}y-kyd~!xmCu?~yP)-{j)B^|dkY;g?r_g)5IAx3sA%W`P4DBp`qVWm8mop{W<9 zeHG&Sh4F;o$q$eBj5%!IvZWc=rGxqn6Lf!3T$<#)mj?q2&1*R;S4N}2y=y)meC`cc zpAh5L(RRx_!;;Q*51zcSsoD~FaO-48Mj-@paPq(~$xHyx+AL3 zR^d>AZ+5ZE=>|<>-zZVsHPY9Q(qFk2ua4lR|~R?rO#%R|8#KE(owtDh;d`iVtLvg-2S@8-9{IQ41;x^*f*lpFDqFR305(_wW!`&|nA?_j`*1xTEzpx8RW z=JkJ9^h(@n5^BR6s>=a(8pyz6$FhkNLBF5505Ne3uvXX6F9#{EZK|kff?yIHbX$*C z9HUfb5RZ%|m%?&9${gtC4EhY2#OxuZRaKcl=4<&h`W3;yqIl!>{RQJHxV*ePRApSc zbbk{kPbxgSj#RJHy)yUdbRf&nS#A3&yxfUhM-)4IAPSZQ9}EyH&u~<(>;bo&dnRyo z6x}PAy6vDAopB6^#f_#Ubp8A){Q(A0o(0_&?O5ok4VZ%ZL8tLoRY-8Gc=J&dY@pq>%;493 z&?)eqOiNjq%5Oqb`Qq{~o8Uv=hlT)nEb@J}y+=>86af%rL9lHHIgKtbtt>e4LIt^y z52oKO@TQ>49GV($N$7-tAQPmF;YnaAI3rI_&!?t|HDpFZLqmR<$BZKfpF%Hs@S``F zPuBJGlgE#3T2KN2SLZ_Y-rK%^#h}W!)D1R~5md48lFLV;kDW-#hUQDGMbmX1Irph% z@ZjCxaK$Oml8}Ugd7uUI3{Jx&4-CLb4*M6VT?F=~HW=m51keB-#*~ihuj;P!DOOnf zaS^rsXkv%HkQs6*>FLU70i(g|-Mhbmv#J6QqX|H~Fs8WPMVmYKy`eJ3+#vjGtUR@9 za3;p1uf=qIRZrNstbMfp959fs$4K)AU|O!|VIA-Y+d%tfSu}*BkkAdC2X*oqBhDmz zG%;n~z(K?A06Ve}%tx4iEVQ!>6VJhoG4ejTESB*6jM|DfK1Dqaj;_HWC|A7CYw#HZ zIS-=<78)Cy4aX4*9Vy+T%6M6{M^};H;Da%k+XpBtw2cD>w8PeoDiLdfIcz#Ga@VKN`w1QoFmPJej~PFt^e!( zQTU_|1R_wfUVTHev$JrhiA>;ELD7OZnWY}50I5?)KWj-UN^qXjbY=!UR0YHaTv-X{ z;j5~z#FQGsg+nm%KdRYDN=m``F;ws`KzFpAXiY-P3CNBs zbCF!W{`R`cC`w0rOaWCVCnsIuNJAWbIYeC{4Ui%=KE68nXSw_$tew$2k;sTelFCP2 zUERsyx)7M5;&M#R>_{I*d{vGf7-ZQP$*-tL+OMeU|NI{!N&&hl;`C$SPheabP)hE^ r?{5EaX!j$)OwEo|ZTxR3=5aiNsfiHJkyn9q7D2E|YL~JvnBDzfybSss diff --git a/public/images/api/qiskit/dev/pulse-2.png b/public/images/api/qiskit/dev/pulse-2.png index f4122c6c55e7651dc9bcbdd05f5f18f049c943b2..6a216166a1e114127dc092387e2661164da97290 100644 GIT binary patch literal 11035 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 EFBk-uVgLXD diff --git a/public/images/api/qiskit/dev/pulse-3.png b/public/images/api/qiskit/dev/pulse-3.png index 1a7b2cdc195584adb381c734c8b1191114b87d29..52399023d436e6f6f21517400866b5df8361bfcc 100644 GIT binary patch literal 59578 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 literal 59510 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 literal 18900 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 bKk4F@Zg)#%aQi;;S@BC(FD9SAdGG%KMShXl literal 16226 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 CfqQKL literal 11254 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 literal 13972 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

bYOHB9m~ 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 TK_t9G43U+(Bl$@}_u2meW+JfW 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 9cd5aae04c1aa40d268b05d0165ffeb25a6c94ff..8ccc88064c26c1f5284f216d704a93e1e7c38590 100644 GIT binary patch literal 7457 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 IRC^flZ_!zc=Kufz diff --git a/public/images/api/qiskit/dev/qiskit-circuit-library-PermutationGate-2.png b/public/images/api/qiskit/dev/qiskit-circuit-library-PermutationGate-2.png index 339ba528a1c03c3f2f94cf1be9717b5861d5a8f0..a66d9ae0f6065cd962261cc7cb9c7a85050122d0 100644 GIT binary patch literal 16167 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

YGoxCW?IvK^I~2#_*AxFa#H-~Dd<2l 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 Z>1-1&7nQntJses`loiz#^5smP{SOIi)NB9% literal 15965 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 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 d0e3f88f9d62e095344b7259ef2629db8fbedf4c..ae45366cc2660df4cde1e553ea433923ab34079b 100644 GIT binary patch literal 12193 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 z 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 S%xLf$f>l&k$iH^y_x}Z;&}bh3 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 73e6aaebd41bbc05b34823847bd83bd610a1d359..baddbcfb85091e86ae9138d654100cb94d73a01e 100644 GIT binary patch literal 10029 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 Y1!DdA?A6-~Y+VB>%d5*(%9scL4>E)s7XSbN literal 10166 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

E%l8R%Fx%TMr)L*uwm4(2ja+U{L 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 G=l==NSDD@b literal 49399 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 bV;#~Ib5AvF9xkdue@01(%Zp{-)A#vbzQp%k literal 16040 zcmeHubyQSs`|co$N{EG&z$=23fC`8rp&}q4-CfchLzjX2f`E=7N_Pzm(jAJ3fPlnM zLx_|NAkq!z-uS-X?|0TY--+*>KhC$-amf;A_I~ygcU;$X-}_HxMHwn`267Y%MJ0Rp zjw%Xu&=`dx2|PjupL};Y{T%+e?k1(}rsinj=3(Muj#4mjbFy=Ev$Hn+!`|KkEaM;A-}bBd(>FvwA-yE?8Y6s02aLlWTe{5%RJP9uBg zmbz!`+>nPSjrs20Ua#!=IOR?@vg4*dUZA)q9;sdoysP7^MWUi3AN*`L5Y7AS zcr+(xFl!khIRX=bKk3ee6~BKAEC@p(D@CE|?jOAL`?Cw@14;IOyF^byx&KRG(-Gs} z-`$f&k?#LyeB}V$?~h)csQdlPo9F+3C=}}d@72CF{LhTxUPq0ekC&HM)5wU?g9i_? z^-6IkPo2u;!}c{dU)vv{hc)nlb-drIPXC;HoVcH^v$M1J_CjN^_lga+g}bES$}!}! zK=ct~V-aCt;g#tw85$nV?#b4eT)wI3$Vlh?QRL#E;twUxwzRh5A0DD``~LAL9%n!x zy5Mwl=no@TB#!q})?douJ7BJ~wK})5vo_K~An3VQ8eo=**gRstWkPXT!FMj6vHjt+ zL-bx4M_)Gk^kaFtO9V}fAfsYPb*$NtE-x?FjMA_(H$S_7-OTa2IyVv$lISbu!K<_V zDO_slcQKUp%2RD|cv$$5b0br>a?(Q=7nh5;<;B03%pQ&+V^7vEcL@#+#g{pcxlMkd z@3*_^x6~@ETV(Z;m6f%~WkSx&+gsOQlI9;PJVQb$_vL)JXtG=+xAlj|M=`1OPpNIc zCfB(l$WJMHLkZV&(Tgi8_7ej0O5= z*)e#?{s+caEb8j63`;O$<_Cr}qntG;l|16+2zR|Aw_^vw%{{Glm1rVgSr%qqK`s}@ zt_lfsFZZ}=Mm>l*NJ5$OGKxQeYU_SWYiR`rYueHpwKhrGJgZ8`+S%IiZ*DeWrH8u$ zANI_xXr*vZjko1d9xwglJ!|}7#ilvmFueKc5G|XEh&4;&h!~Ev^r*sjtox5C%sDGO zCoy4;rZ1C)b2=HnrKoFgJHOm~s%h-APUDQEWmUwh_PyK4#laD7H?%gRLk9qZV0NXAStuU-k+baSSqre?xPc(3+bqQ^g)(}=3l{PCne*+NaYJJxkFc;7cn3KZ z6>o=#XqfqD3%X6W-nGrS@s|e(bJuBcUL)ZF0+PHRQUu@mZ_Q-BvtqWU$C!M6p&--d z&AqaviSZs>nd#*b71hUMwW8R(&hpYJek`sr;xF2+oe^o{Z=`M_47Ei3GH-n! zSJ6=W(1!b7$rrmg_ci>6{?v_i-DQ6rk7e)aCoGI8r={!um!x8%p7$ojVIy6|C5K5O zX$%X~q6e3rbIV-)nlUzzdE2u{ggRl&vpva3)4Hj)a{56OhDNnIAKgHTk~>R6$<`C- zObJzk7yG=vSjUGMVc%jryO;IIrLZkbPxF%hj?mG%Szk1kQDhUg_PFIEKU zqKzBTOf!#|Yy}eyZ%j;1Wwk!d_qOX7%$UPcZznH09_v(+SvzA}o6$zV&xZ)ZPbr&0 z?0Z+ivG&={Qr|ZpQgn%1?PG4gq9S{R$WV2y^I!R~%g%PL8)Q$i9kn6T$6A?p*MIYp#8n}CCTX>)WMqP+57hM*M{(o$FtSga9h+h86vA`Qq;*;`ocWbMl-;Q0G9rew^RkTZT zgMInSsllo@hbLGcK6*4UHkQ)e-F<-IKDX(5LZ@;F*APN$3l_P!vZAr}b4a7s-;Y

$Id%i|2&yk55exzD*&g#A(h#esl2Gu?&~R9N?DL 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 diff --git a/public/images/api/qiskit/dev/qiskit-visualization-timeline_drawer-2.png b/public/images/api/qiskit/dev/qiskit-visualization-timeline_drawer-2.png index 0b753b1abce1e4e4453e547d605066bdc0070b39..9bf21ae74557f5ab715d6a8dc46678d937421bc5 100644 GIT binary patch literal 8514 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 ahjS(yXp>s7P2KbNBUMGMN2L!fL;nTs_Xr~Z literal 8323 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 K?-$=S5Bwh+^@$?@ diff --git a/public/images/api/qiskit/dev/qiskit-visualization-timeline_drawer-3.png b/public/images/api/qiskit/dev/qiskit-visualization-timeline_drawer-3.png index 2faf303b6ea2322a7606fa7ca29be6d93ed072aa..8266d8e79743f1491ade9920b02e26ba863dea49 100644 GIT binary patch literal 27031 zcmeFZcT`htzbzU-EP(i`APNF1O}c`BQWd0x-U3o1QlvMjq1r$}K|>Qlm7V~R-isj8 zq!W-1QWKi=nsA@^z2DyZ?z8Vcf1JDT-Dixmh7Q(PS@o&&H|P94Z?!d*&(bi{Kp>E_ zP?d+e5Xgzg5C}!^>675dFL#D_;Lkk|#YY}`E;b(C7Vg#%4GRxfM;8xAyC>JYtlgj4 zxj2go-4hZKxMu6&;rdKcSlH=bP7rc&e=2-klWG{;QO$y@alA!3R5(FUwHI=O1#Xl@9}-6p%ZVAo$?z*Q>M7#c+sbUQF+75wF`;2 zuY_2f25$g1O-nCNiht~Ku~N|e*$a+3-|&w^cdz`PL;t5F$R+S!*CxWgRe3HACE}=6f8ZfWb5Q4oI46ySy^eg%)!T}dMRA7uC8t;h!cYWsLpGGGnpuc^4_?|^V zvnll45CMk~_WOZ`VHj9gFy^(0;c{wfYP)Z5&Lb9*yh*+Lqa}9f0|WYp^}d_)!@DaJ zwWAi34%pf(5$pCGa5!Al487i zHLnvT0WVv5K}|c5sm5d^aOtqjdAuq&=$M2y$WQ3EKlLm=e z&VA&bnn>V0`EFCvCvM%;c6Kh9?@GcvTj44mx^vpM{`H2gzvodde7A0C8(?6&?9q}oj$ECFW(3o(oOg+dW!tc3mn1EUuGvGRNuaRtE!^XlltK0*0}eincHpL z)YM}xE-tg}%B3MJwmpU)+%{MKHBG{8%Mi_E>0Iz2sS+tqLi8nJ^StvMO0!EGyu8o{ z4;~nrso6FDoATY*-0Yuii}Kw2ZK07YZG^PC98%@Af(C_?3&R-D(9q~=YDOf8Ib@Aj zdo%f-1#JlY3$eKCm?G|!z-N$W3xBhX^;#Xvo$o|3`3h!I$br!t0&!)dyljfh&d&ZG z!HS842O2@4P?31`gVpM_64z;Y#fJ}VacG#kxA)LW`DDRb{js^PukViK=Eg>Je0=Wm zvLjU2z#vvcRMfh7Sje|dxNc8=eSIC70b0mnS}2=trTg4KnUjehYHZ9@BSqFsA(Xy! zlC+176^0ko1sq<&m8T9&Kcy$XO4kF(%MRwduBq+Oyy% zK%SiInZuox{^D*~Os-xw+O*Q0{&29s45Q5E`_QD^S;+Y>(s)hkL_L%TdYd2do0Z8t^_X2x2HFxJQo zWl)b&dGZaXf8rN7>|40?huu#K$gtt2`9j}#iHBD3s*@Ka1g2-&3!1c+U zmFyZT(Kp9nverf%Azqxj_UE+5=#Lz`91EsqClkL}u3ZUj3Aw%!vF)xS2JRT_a8-68 z_uW<5SKp}fDD>L%%&HBvq}N}O+b|6y-(vjJc;71*Vlxu+1}%6G`PR z={qTMNiJ}EO@qRrXS_}IsDi<1G0&ivngv30RZqIQq7K*Iw&z|DfR3;~#XWzY!au!L z=kN4PL@&Hr8ay=h=hZixoWajIDL?62FaInQp;K@e%+twKjp2k654QDQo;;g~m;hr0 zzqGU|=;pOwu1jdGwy+MJzB05bhe+#O(afJo8MzoFZxF7W))be}&!*>SjHHyQ-9CJC zF3DtUa;(}48GH2zhOaal5#4jbo#xvUde}UjJ-LgnarwY^HR8*uTcN*L*Zc>nCWCP3 zHMN49=OCue-*fm>wZdYuy;DQfBLrig3HjC6)4LFjD~<3~$DLF(beL(RB?VV9$0-#+LC_(g8XXoa4xw(}B4z>zIg^~K%nyj8ngBp{8hxvM4s864At}BGx z1mDANSP;!wnWBQ^9pZ-4Y@X4N3I2=dJx*DQ`72j5hHx)4B50<6Tn=A%AaQdjHoI%{ zGmO8YMt1e~kGi1kbr}K?w{%c=d{>Ou`?@KjyyKe8&o9Nbottu<{Y6cq9@6*BWml64 zj|wBWJ!+I0i5(0+UB?0l6FB?WXKQciY@rz86PChQcxty7R>xl{Y)tTyn4lqSMry}! zriX85W`0akS2^mJzQe(c=AI^lxx5W}m2|)wvwL(jgNiUoN>vkPCgRi>h$(FAX{9R4SUhgke^3X(V)JF2HUID>FjH4%`Y}^Y`&VB z`dh`5Rk9=S$6FaW`*oCzXN#Hxqj702XKsJM8YXZdblHinspmWPbBQ0$!`hmYw?tLc zlWpsHyFng2r)tOP6PA^qo1e7jW&JeEc9!R!h=~v>erTrGS2aQk9j~SDd3SZqlOYTH z9awKTLmund`IJDi4$?Vf+;Y1<*cVj`!7jQ;4Zd7FI#BYy1L%vQ%RJCx~S z-%Yqe*mQgs5_lQAQ95GRyEGnc)@qkvkaA6|#_p9Qz5fClyQvzWSXO7^U0{=)jXoS)7-H%Yk+@sq z&Jpc%;#TXzM`bo0Fj@Ti^=s=pi_2n{)Y`!Q<^tCLF@-_Caps2)e{C=JHq~_!D=gu2 z0WSxN5f}4i)=?tvrcpH63s$`Ak#aO#yz{MIp7|p^qze1TITO`*3Yn^3maLl6>7lV& zu-c;Yh#I5rjvcAGnQ?n&0}ZxI64b^4TUH$=r5vlDE|7Lk&A*L)7G``X7x2?lrB3$7 z%MSil0zbZyC*)GG(bN7YPZIMHhZuN9%qD%0lURZpax9YT?ulE-Sr&bB7|SF&>TvL; z1gi22q=0?0`!YH~@Hm}i)z6T09cCpGKa0PZgOHHU@$%OAz)Ahe0JiXeeK9n?DcWP_ zi-Ee|ed`+p3^bBQXmmGXO-{Q%Su5AE`K0^iZ(Y=Jjev=B8NCzlSm?zV7B4-kQ4-DR zTrb>^Z)V+#cI9@$MNWL<60*%vM`^>zI?LQApu0`I|6{(|02&@$bJX76*@X7;uFWd> z)-So$@%cujIizCZ>i+2Dx0^|yUg)d7diAQcqeJZ!{ngfTm&v+t+VrffEc@Qiijw|& zUutS=an;@~Vzxc^!;>EuHzzVw%wJq{Ho*8Hr003 zI4HNwL|&+T4e@w7Msl((dK1lj+5Wh$f>o=hw}I9!D14%uUt&Ri>cU^fW+8%Fc<9qv zcHL&!9OeBqu5WDGPnH8ctB#5MW%=XI!4WI(dKYx^x#I6UZj9)tGq=j*;k~z-(}*rF zaS=5cW6-U9`zyj3mb619?3;(VI$WjSA$K)(d5g2nN;hg%t9A7F*HZa)1^0^TU$0x9 zMv~BI4d>d`0wzd-fhoGWuc&ily<$hHFn#Z@hUg0*8XB+i?EkD7?s2r|b|`tvZ+8`@ zuKuoe9H6(^r6tUpH>VHFPM&49-CZ3&Ce+Bv%F?Gl6*z<6!TRBBZH^^{WcKC#c7L%a z4CUK%4AY_5jMfWDqa;l(o2-rxX+_j0u1XjbV7qtna4*kFViL6)@?P{T?n2sX5%uM~Ir5RH`J_$;U`;g0k zrNz95ISh{0$#CrFakh2#XZz5e2oAz`PnraNJ#T31`ydk`fiEvDhGF{^HqKNWjh`$Q z6{WEND$~+^pKHPP_&A>&`)_*0x8-#DQbCalUL_b`MclW(xymOS8@@>sM7UC#%W8 zo9pk)$1Ak;Xg(qIKRgzOzjquoYkHF9a5!xFS~ked?uxm>sf$lmN{t$c3D1*0Sb%0;_^s`x(N9LPw$1EeQ!4KJ5A6_&$baY^s zJp*bXzg>)egft#KD;WEWiB|VyCTZK%9;-%mXXoDg9E;M z!|VOov$IzF2M46uYWXX7e>dLxrIW72d;7MId-=`sqvnqsAr`g+=ZZbJWuPxv#`myY zIt&6f#jCmfn#JD78H_DnlCL=XUMu>pnMfLy<7^AoS=R>DoDT8Nt=VTyIx??4+s(rf z)p(YQO_b4EotHq|k+i3=Afh{f=%S@bIr`GbBPRf@a#)vQCXH`V9u{8-ad-5U{N%ba zF5=P3p6(MOkb-{oLw`=6UN>eceCgnFNE*A`mE5fiQS{`#g<;GY$nhiXM;g>2xIUL9 z8+ch#XKeOd)SAw=O#p7S;EX*^LiM)ZNj_1*X=IBJ;#8|#Mp)O?3ID>B8q;Rh$*d22 z8ez-KiOshhi{|ETuK#GZ>zbfQBS5iR;5DsL24dn*~aBq{uqFsHn(evFG|(R>=X2AV8hO0LCJUM{A^fWu&yjBKn71Z;73r z%vO)WNU1}dbIrO^0C9ULjDIN&v`nYFmGIh2>H|NL-n}z&kG_- zKUXbxSf9km(<|8N0PAZEsv zh^9i3vQy^Y8Mq$-HZv`6%WB1JGj}j({RO98zhQ5?%3HncLmntHVe;S|Ws^PrFj7da zuh1gy{K4F)1mp3c(45Uv+nE<`A|_+7+WqEp(4C_@YHJfFzl}x2O_IUGW8%E8Z*_IF z={kF5y$f<{so~!)_1v#kRg>g^s%k~_qm4MMyf(G>6PT1Exf4gSw=!t^%Pv@+v)>P; z(l1WbZCiSty(D?C3&X& zp|Ls>WCIX&4a!JKLv(g!En5_>vy}hk5I;-WNo#(59fFm$47(qIotP+kh*@RhfuF;0 zwmFJ8C`C@&lkk^2e-^5q6JIucoRS{6_t4oU93l8=@e2_Z*o_W&=;T}N*Ipg$>C%qa z=l!|Vn3KL1xzhJdBRnP{i7QA;Sd12vHRmmjb)8K8T(Nv(S82h|T0DMh0^1?xG0U;P zqdZWnBcmL6y-#jB0f;o~x0 z79-*YTW2Dh2Q_SptIi(kr^rmIR2u|j93-*xeOb#Ym(E=N!64|r!fpMOlfT6N*|x7u zWi30taUhGP)aB;yy~)9@!7w`}rjFyOG}@MJzrdIq1g`^SGW>{GGfwM-*P|2j^nD)@ zVFkvt#rBxMsnT(rb=3>qXacApYBzb<(S)1YUloWeFkvt(OvfS?7c2jj%FaSQu zHiFKpF?9->@`TaW9KDEaws5iyu~~kU37DoON2G?iwFBBK)uMl&I% zqkh1(eDKu)$IAseAfmnx?aA@4LJaUGRM(tuFr5S~H!LiSPk&E0y2v3~aBwrtXKvpl zhRJ>XQomS-$m|7hO{QM{2X(`^V22Zcxww(-{>3p_;DNrbwQ>jnYbij?6IVP@^!qY6 zQI!dU>YOe}y*YmR@f7o=;v$FYz@!Uzl?`f-6gXI3J*`M3->$)v5Zm$LwfFcQl@@h{ zx=j?#6N=ABo@(6>8|{0uqvqMBSv6zF`zzXj3<+L}O3PyGH#0j?aQ(zB*Z3L{*>*I0 z;9N+B^JVU+J}CzOIGS_eY4kYVuu3vZ(ICbg+pTSsB5fG=+~IV%YeQzAa~^L~(~V~$ zw0dT{>fF{t^f2>J$6Tm8xgXM&O^Y?Ts+lY;0O>L}8-F!$A$GU>WA*FxY{--&X;9iT zFPT6PaeY56KCq`8Mi3tW57@sTDqvh93St4Rmk+5C>vjSVQ*6cA?d|uxD&Pgcrum(L z^N54900J?U8`I_7t^aW#U?Tp|nrLcx4ix4Uj>qJ)04@9uLKdCCJ=;z{{{BtB4`OJO!R5R ze!@^fj_|F%T4a_mQ^_kCDzn5{T}5ZA@ae^gxHk2oo6{fSFdg@GMAXB^ja?g%Nl*I{ znqCQmx4p^gmAIiR%|TpeA~&z&V*6$)e`%#g$bwru?8UT(HZQvF@11 z8|regmbUM8AS`*~ZIV>BT+JSUlY?ok<`X=(q=Qb)P)<<9i8u@uz``#HT9q2ZY7w45 z3V{K3O(Z_dn@@Y=%#Z-(r?@x_Dn;DxFpZrSM`}AKWjDXU6ux}4TW72&lTu9RTKsZj zsrbwHph0+T@@{XZ7Rp0}l&aSq6E&ap<6F3cKl_`fy~^Oh(VB-dd7#RMPOrYu4_h9q z)HAF0f~lyy`TY5FGzx`roB5s#*x6>|Pzx1aA)3bp)R8;Ba2XRBtDvLaa?29CHQgkQ zyWE)2NM?hzjO*n!1w9R6)NJfx80_GRdB$4>gB-hj6eqN}K723?E(_B|)QtUDMPKPv zKewHj!_3G$8tG@zAl;lShkkw$ExCO_igs_*Gk?Ie8sc#)nTZv$*Z)oj7M;w%ueEmn zZ2VOdfd$i@z#!I%gHre6KF?#+DTd1iO3X-TFY{08k#DRwT1-q-{0$7;==G3ox=p!seo+iFAxPL;TiYk2iayC& zZvI;`d+Ad}Y{@vS%yO6ZT(Oo<81{r0E|5%-Htmh*r$U z3&O?CW@#`~E^+)Kqi$tkt%i;9i@{FzbdJ&3n^H1R3$f9h{(vY3(>kv-?5?gDRl_#7 z*yv}`TxXii4o^>B*V`aax&VZYu(xk@Qe*>`r^7jMxq8YV*5n^F*41L1T#S1)P#ktJ z>$UC6t4+nD-ybG zG`kmn<5yInTCTQCaX#{*mgWPC$Liff%FR70`@W~3NV+RUp9EFaWiZiOn}$bh_td`M z^PaOtdEDq#s1*Md2pOus=odI}R46#N0@w6bbn5vXse9+~kvPoWwV3|sNG@K`nIQY5 zfZoX{Ctzs-iWJf9;+=2u!_CWKe>TOvII7yxSTT}O2uOb4+jDLPR%ak3h^R#siR#h9 zP&giyvo6eO5mb|vgryo?_{aRU!Es@i-rsmAVv(qa9!tes(p=_733gA|G!HybeJhtm zfps2gV*id&e~mES8|iFsQ;+i49-@T|q0$#r*XSUo4*_rdt+|<(gF`{gVem(}u!us(pOi3=9#9=4u4|FP5|GBV&FsF-ZklDN=cDkuJSxr_HN7^~H}r?XVsj zxtxXP3%4}qTBb{Fk8L@tcB%+`sefF5>wWbxzu=L}XKtA?D9_B!5>b(Z3!22TYv_J( zkBE4jSxZb{g||12qX#|x7^~*tJ3-m*4`NoHhj~m#HA>X`Xj4_yNviZ%qEr`_63U z_M0hj)*YRLX@a!0Fq65EafactdP;e;*|w*7E;e=JW6{CU`2&^^b(?SzWH+Daw)|pB zRD2ddSvj!!o4)%oF{n`3$|^#`?rpZ`Vw|F)do94g_ZsDE{-U6x`HPLMASdT0P#LhT zhh=lBc(>-w4jx&2Mxe|W`E!#8AxE_@=hj&BzRGa_+~vtm>IXwzZ);r?wwR)+u2c*(1bt0XpFDA9%d-43&^9+^MuXbS z0MziWtPkxP4BlIP=^|$M*1^n!-_!Rs0vpgNvMl-B<0&7?kDGfYKU@zTohGjDE%(B) z9ZS@~7*Eif?)e%zha%sLJyv}S$W$;!;2WM(?eDCNmUmCPfw6)U3WN=(k3%2bCd`y> zYbd`}le`Y4p{={?eT0RlNPACf-sj*cb-yblA#Ac9boJ2N!7DIR*swlVZ~atE5{egP zp=aZju;J(n`ZED%QxQ@-u5yO=X>?+sd39v|(6ikig8H>Ay8^uqo2$5D;zEw%$|_LP zex1V?#|SUgeq^D=Mb>+NIVcM<4QQd}y^#@%j&sq^nMu5k&kOBBR8}t^LA3Qjvrt7I zz2Kn1)#=uvwnj&W(L?y_`zK5T3lEpySwWFN>1p!PO1XAe=b(Y(F1Ot)d1#%LJd`Y! za@QX|mM@FeU*mRqbjx5or2AuNHg+&TRw;xI#69ph(2EWEyKnJ|51TQ*bT>7lF$Hr| z^p{5hgu#5&B|+ninU=`Wq36TZ-q4^W^KI=X!s<*E;BB8=9P^uA2K zHhG}MQagj}N09i0)?b;&2ZScC$SJQZ?Z$*w!yLSY^tZChN9E=)48|tg=n}mj^YM}? z7cd5;E;=exF~^UNNkiRR6OHE)>l4BQH~QQ(l9QANZ{8y&D%JG=u<+Yj4kQdL3dyXe z*d0hUec=@rR_2*GS8*qJeZ4y-WjHTd;F8%%*MQB9b1|HmiE?REG@e4E;`d0O0uza! z5_Xx>^E-~UN=NCnAC7CrIj&952}9feW}B`}rqUR~%8QKxUg9!FXA(s2s64kQWzgMk zbkGE(Q;F9^f5Pz-(P2kl^rY{be?vOCioFQ9OsO|=n>v@_ZA3&Yr{`kNgNrET(z0ZP31GhlM)d1u`{x*JD}&hy$nu`3ST{Y4zK}TA#|%lmdEzxr|M4S1Vwv-f^(gpqW7&N+ zn9HEy%4$NYK|nf#sCBAH{{^4zi7uoJ7=*Wqer)oDhU6&!+&8pQEULRpqg+%S%Ui38}i z%;JtYpFUj%E)iQGs*-cJ=iL}SsD?a9RO+8P0kGLk% z!pR@7&Nns)uaQmy@pB5B4~OogbHb`CPr4k8CO;nxe~a7uyScmJfry#SLtG}lc7LQ4 zGo(CR8NX3>fKjyC^*=mz-uV2ny;T*r$-b+NW%6G+_F^;Vz&DPFTz`I^{+N@up*jx? zr(F0(V+j`tee6QOovoD+ayx!|4y%9V_;=8e48JN9<)>eVzEr`Yp1!VVddGv5zywj_ zw)Ga^`6%j(D)sKnHa>2qMP_Kg75O>1G?P|SIHC4|OQJxQ&0LdXb|0=|@w$=*uM5yy zuU`WcP>8tDWgY;La45L{`-#ndfm%P8ul+twWzv90;uBtLTpO!N6af3}Ux=G>JJ^At z!MQa)K|Gj7lCNgNij`WI=hHUCghNPYvUhl8@Qo$;-+sO{CQUJ%_4H~;(R6E{8E`--InLnb!Gmf!KK^SQi}(rLr| zpYNc|~Hc^|!hUe-{efQ>b!$PmO zefXB2Lt#1z7??h@UQ~(ix=$zjsBWc^UC}`d%%`)=-m9Zua(`6oz#7j2@T%CxmjhL# z`u_^?bM7a5(C?ntGY2yDgrfcwk_NoRJHKZh3x{bMpr!Lje1`e2o!N_ZWgjpp9P6DL zw3~^ujEVO$H<%O&bL@xb9};)j&HhkuR~YG`-07*22Ri77e;A(;SptWIgduQ=G2e5~ z0Is5JCb+-O>gsCIBZ08@?`sL0!y6g3@K^1v{P9#@#8-$0*dKKY&&=;REvz!lY4i)>AbruDhv?#-y(h z*5Rs$zLiGIcikc>)mbUspb4mnglS~aq`+HcM zu0*nlhY1wvFqrztO2yh3GPuczVs$_0CjqYG`}j?xzvn7NQoCT@_q z#_I4}>g{>Pl@heL{a17Ko#yEqS42b!XUMU#O8@DJ&8ZvUe(zj- z%4*u@gVH0GOl+I<<7p~pN>XrH-{*WOC;{z&*S>zu1oqOm{$=>1S4={dBGB_rQ65Jv z*Q~RR3j84jZXqwwPx(^YGZ!i*v^ikwcxTC&S)F%(EU?Y|4GGyM1a8K?ubisF&I<2? zGIE?1&VuJd_MZMb{^m59%mN$PRP<-(zs?`|UvT@%$|{H{{E4NdnHeZF5ap}>hs2C& zJMX!<3?smDkWXSb2niwgA3EyBw&vJE+Pws7uKjBC#*&U%Wuu^L|S z%0lH#XwBcxy{pmqK=?`s2Gdab0&-I5qwj>qFt5Oa6Mrsj*L2gH_np|Cq6CVF4NyFQ zc>Frg0E0Hf767{$AMk&2>#cWbsFTKx^A@Ne6`JPe1hLVtFojQ__BNl!u!F#9zds}XpW>H)LIH{PuQ~Ms1l0Eb zKAVO7skq}$?Tpfl_1*89%86ThWGg8wS67itBR+ZZ z8F-R2ftQ(Atkia1fLWYZFm{UxqKe+jh&tGAppo%kV%gZGj|Cyp$=y$nCsPu=H2DMf zA95UO8mK&eC2&b%+io|frk1kAts6;sxZLw4<%Ya{o1-|!RNHzS=ld>j_&ABPjWC^$ zLQP^bQCY*I!sB;gGRCqVFg<_WzU~g2pIhVXr6iZ-E8A-uFU*rh;eHY3M~^?ll1xe# z=N<~akPe;a4&3th|(p6=)lg- z{+?B8khBLJxPyzm>7_1{vVaj;MlZFhyXu*XSF%H*_1&O6oKTCeOiVGvr6Hbfvx@%i zR%rg!h>p$HQu5_ZEUy$lDL7ZDdtZPQLka5R5-8tadFWWsvAnrddKb8!}siR z=1EfC2DON78po86AJhESY7M((b`vQnDZ?^Oo;#MV^j%%TG-i+|do=cSni zxL7Xeu&+^jS6g(a*E&68c_~Zons|5L*Qime;^C6O-JuaTpVASD3Nz#uF2OtIgS!$k z`V({Z?xlzisAdHaBNy-Ld=dvxrMpu~i;Yxsj&J2Mg#%041bA(DIQo*5cKWyl@DuDuvpc!Qn8Ab6ScC( zves7FX!}Q0o^}ZA4zX@H&8!*`aL0Gu^6wCef3RXBZWyr{erh?=uYQUjig@;uPYgW) zMSA#!w#39l6%>m4@rsG+Ft!g4gj2~HCaE%IX#oQ7^*r%6TBKNa&S~2)KTPn>`g9E6 z47>AM`JXPA0%8!-*HqPLZSJPWys3RcU}^=D^^S?ph@<%Uvu+txHMRc6*R*rw{J>~BXLE7i z14g24(530xx{obi=cI`ni5nec6b^bVb<>|b1F|ytuUh86U}28nKQ9e&6`}kmJpONX zNWzdQcuCFCF%P5m=Yw>41q6NoI{@D;%6|&2mno>?Iy!Fi3U|yBM93$lsyvcDYczJ2 ztQXS(jgfC9uR4PG7pIBP%R=(+(R4NvD6|LkgSScqM(wNEEALv@D^1)Bctoo zhlO(qo=*aT=};K{ucfcN>s;eAEDfx)Z=I$EKi_YQO8S)r4*b!h!TsltC|v$o%}su6 zM~q}iU8*y0tC;O?ES<%$%W|0o9T3O#JA7i9p7GI&T_qaXXxbLzXQ zAHe{P1`|KcnKL^2`qA#so{2e+-HicO@}CaS{qaBO)%AT%jj1R5Oo2pbzAl);3VxC` z#N0sK4kGoCU(uc92hab!$y>NldXfJKk6B)5y7sYh)hu-pjI`iE$ba6d31i}QB zTS}{Oj1pi2@A^FaJg`UphYD7I`DCDpV`)Y+LPcp^)0Yx5h4rs}F@WhjZM|T%n16g$ z=u0PfrLChDnXOi*HT>Kuz@Pj|Bk}|lYK^W8>^X1S9e+Bic^Msr%2!g)1p1>y7`gZN4He{T?132iwi2mESHO>=8&SYXavM7h-Q_5oc@ zlz1AVTJ-;_vKHdDuGhRgCa}$7Xt3lZSY?$Wc%vHsotwyLo;AWXs(!q4#na{9BMFIm zErW9|Mgq=gz1$d?;M~j1ymD*TpvdbAmx>kN=01%<22M;UTa18VNp^zj!IKkoG`A32 zwi*d{pvlR}BQ?Io&Q*ABR$2c?)*xL8Nz(iKV*q^SFK){N(v$!c5kLx{Kb$nWrM?d3 z*&6(fquHVDmte_Wti+Gs*&HTE9_8AUI>&P653grRkLBB&l@Ha|h5T6d08yB^Cx2;g`daBg?z2#aOZtjL z7k_hB=AGj5(Gu@mG9Om*gA=3+{tcwB9`OCaY_W*2-TRMEsOO%)Z~;U+!mM{)uT27X z^Gmd`z;}@#6b~J;AqZFFj{O>iGIm+s-6&QSS_=S;#5A8bA&^8dRpXS7A0U z6N`?eph#Sk38)LWnuJDiIlRgZjVSS7L}%?~WTeD(e!*AE*%K#!iV`O0sB0z5>vyh> zKXw^HcL^GAxqrU&Fr~l8WKuV&-DzVR_6O$(O5rqybJb-8SA2L(RUZjlBIlg|r$OKP zOv}nr!}55wApk!6BaxSH%Yy_peH)uB#Llvj747!C&4+!8`_M~q9`ZKK$oY^X~zrX!dZbZ)Yb*SOBVQqp5F732xt1oU4Nw}vhNt0k5#^r3$; z6uC7LGT4KTbgI2pin_h)jm@pyt-OlcV%7elf^g~l4=DQQ07z|o2DboCyt|_ag=4#SAIoCGV z%s-$ja(J8@D{>Ev`$FHVr*tzwULILs2mT8(?z|#ua}#*iK${c%QrrAQCr-$$1R#+c z)oRE#f&J(XA!HqhN0W;v7zZ+xm^9!A?{xbvMkA9`uXH4ruL%QrafPtmoAEkwQN8gt zR2N|r7D#f6@8U}78iFf%p&dgsC}geYrk!zbE2t9c?d9vdYDXe^`ZW4WHsZ8A)t1r> z^F+I2vzHUq=Vr})G}^m5bOGvi6i3x|I;|)XsymB4e$R@7wBGzlVyV|v^ZcE&&T*Up zrSoQ78Hpb`xw5|FYhQEB+N^8W@~tcfFl3ztRM6&`&e*r!lbLKBk5%I%Sf%VcVg>0( zf!##NPaUMR(z8iFvJ%@1dCCu1(AEPgh^fiw2q=_K#caRxbAo>UV8$E&-2t2SR<{Y(tztXkcPWqJ*+){d5 zID1q%4i1Jsc;WY$`X7TRxb)+ou|sM&v=7x}kgKz;iOd+4k}k+g^mv~%td<-97R-5B z=2w4L67;KX1rR{cerGMzFeW~R&jnL&4|7cWhd$xzSO40M3UYJbzhm?I9nPrrp+oV{ z`oLkQ>)}yC*QBkhi;NXALr>KDb=a5MPdC0M=W~iXkL7%S&%!S*zJu-3pMINgX$$^kyjCVIbBM3v%S`IXHg0+kcI^po*h$`o!nGCjEyLC1-m6gA}F4J#M4E zdn5R{TD-cht484MKQLHTJnPy&@bKOEwp(-t4*=o-o9hjw2Ji=L|2r+N5RbypHf(c= zix1+s$nSnXm*LW-dBO!(Mu3;e2S5t$J5T^~R-ZiG1A^WA1OO9AJ{}VC`o#S*c|3!IeTJS$hUgete4m?9~-|izY+O1lSZO?y! z+3VN#GmgsbTkznpBj)Ekf-+UQg4QrF4_PjQy21Maw}r}74g~mSW1(eB`z^YBqhh5PJ{Xb{cuTa-GT*s5C`pHk zb`JycjJE&(cNBAUf3k=p^6frPCL74?03V$V#Nlmxe+yfkif)pm=Rm%RM8M%nd9#5U zqNdvM-q8*Pq#^=q_yJI5Y0HUpwcGVysmq3+dAv+Mt_WqTT#>0gnz{h=%$|-s&j6 z6k`}>b9ygDm)sb*jO7VNiUID`2Q>^iz(R;`SxJ#v?(S+EXz55E0^~7f?dP@kq||i! z3I(19SKMV_2+d4rwE3^A#?Xy6UWU)nhs8u}2QR3M`~gmKOkM{L!` zN_wt-XncXrIey=bQD_R>@j~qg;Q&n&9UIRX)s_*+nyj7b@X<4GF8 zo-(iu?FLOPMpwu!q{g;VIIDF#2N#~{fE|6H~s|_&m>lF6loOsTsCxmcOm>g@#b6| zNtW`~T&vlPAkWw!n~BkmHU6zL^6N@AMQTRa-^QkjoMm{utnX?nr`>FZ0e#Edyfr^5 z((>53vkSX5N09L3Bc&ES6SWp~Z2zIDmn^6S0;<{(x}h)SEWFp}-T_I#VYhG_v6@^7 zNZN_yKx9Ti=PBNzU$1*pS((QQlyFiG_b;BAx zI^@So_b(Ir(kZa5&$ZIk45`|hP_AcR%Z82E|~|w0+dj=?0ZN8Hbq>4 zIlG4O-kUDYt5KYpPqP*mCS&oY8+d;rpj!d^&oHHD0Ny|8ja2GBhI`gw2(xlpaQu!2 zf6%^uc?lb$S#s0S7ZA<*KqBMhl@eAPz87CK?6@QTzrZ_li~Qf1m9(P?Dxyr@Rj(dvt0Kaks{$(!!2v zUx?)#@{d$3upE+oI=BT4H(}ULV#&YV&e!)KS2J@EQPO?5e}D#Y%1b}>o~6w-JrD$- zL&UV>vUcq!*HEl~ygE@#a@+vW8b9=^fAXF`C_W!JI~zz9yR>!4jKAq3PH4Hek14QA zGfNf6>55*2r8#QU-ko}e%k{80_|w%V&SCjP`C$_VV8Mi+@)z07b45tgJAt(QU|QP% z8ne6SnTnI2-qlZ(pU>0+g?AOmv*w-J6NT*yGU5qBid+si+uPSp0Ac zYLU-|ray@ojsw0cNNl6lz}^g7e$vDDtHmJ|R+(VB!Mp#63YcDA48^;}oOyQ2c4mUB zy{)saMQf#U*{P5MGK94s?`o5pB|N2k_4+mA12I=drG|#*<>lod5qTxDwx$N8$C_j; zeKoxt_!P)UqEirvqGkVti{~A$IP)ttcP8uNyJzc1Crf`-`pG`?1e7UHvCq#(Ar#2d zk6o#YZ94fjWHoHs%Kc-J5eP=#Nx&>G{NI`70wJ&#&MClATm342`i56!FEs244U&_K zb#q|N;l;m@#<1lNsln}v#V6_XJ`}jjy1JgJrx_M8ax`@Qv#8e)Z!t4xPgu45~U5AI!8`nm@>wbX>qV6a#t86fW=b8UI9XR#!Or}kWuuX z=zPEB$e}jOXtM-2J$!mcfs!eK;@ZUDBoOQ{7(W>v-8$sFK9azH~#sA;04|SCTT-A znJHgHfaTeL(*OUHI!=A$4?rVuPZUba$iOmH8Eg0FQ3XP0GFz92i^;2FfW@`i!1@55 zgn?cbmzp%WxCS!)ff9GpFLN{kt6zbIz|6Ykj%z>;>~etPcohs_QSyRGvv_>2Y78Hq zytIS7{0oc_E!RNhvxPhUd#*9U@ClOCGe9}gJAna3%;v{svJ}q7#)j5TdjW#%g&uBT zUH~3aeX!UNcrQj~W;9rDg<&Bx^@JMGxIW#s)c?OKyYg_T*Y{nWmUFcDcG@hJPE@oY z*~(TaCsYzjlu33OBs*iy=@gxi8kGtmNyZjsU#4;>MI?-MBqC!=_8Dfr_uILCzw7t! zudA-BtH#WH-p}(s&wbzT^W2|w3l)4iaVDSyO()Ul5GJhXvt9@F^xit>Fzu`F-`Di> zC=Jr)eU&CJ;&3>m7Xu;&jvcR!9zV8!X6&O8nfo*?@UVlnh$+O~0}56BQy5dsfPC0O z7sB4j3h=2O|KjQviL+Eow-Pf#1sa^qVBo|X>r2Ea&MJ1&=RMv@y(y+s?BNJ)-l1>_ z74iyq_ovY1?qybE(7(RW>%3n;z_tw=_O9FGdCbEjdzbvuE8RWZdB?s}o3jt*wR=bF zMXXPUWm#Wu9K8|8Yj!yn<6jda3JW!F%}Yo~@b62C8c?u>vCfC9%cX5qqsO}=joxDD zJwiv2&t+#S=;-KBvHC=$MnO_`s*^!KbaFD3>PJx2WMyR!5f3Qo2+fCRW$uS~ePLwP z!$*gX95DmnAax9eXGS=KXoMZn?Z`+Qw@6S7xQiXEtgO7RWOr?&w6vFC#;?4*eD@d@ zbOW{N>Ap;spb+{*+O1nFAtLAJEBvylzD!gn4NQp;Jf>AiVd?CI<@j(11&tb96ffM| zWI2<^j#xVqbLiWM$9RM}ZvBMXuOE|**ohI^OuXQ0u%v4(<~&tw-~8uGcemrr)QEiP z{?l&QUS@f&XUJivgo?9i>FgE1bv_p_nqX>3+4|LdG|PTP+p#}4CAt2YgV7*{r5JGE z@EomH>n~qJG4=J$$BgO9RjZQZ&lG-rb5r{J#Dx6&cNJbe1~n!r?wK75C1VT%li3vd z8H}5n!Hz7~tz)RRrz=9IafOj)!bvN?gHT;>HM=xI8MDnYkMZ)8UGkHAwqTYoxx?bQ zd(%X{iIMp7<;#Ps?JpXe$qwRDZQA_%)1%sSoa<#1gJyYAgI%#coSlI*T41Na=c4L{^2t_^jDlXcM7j4|k_#K|W%$;?v8&*0mJRPP7K2h~B(^pBwYpcq{pD zF*Vn=RjsRfyaHkM5iBFEtu0_sbE&QNhm>+%n!g(v9+W##JNjHPvtyCydgUtnXIX*M z-wkv14GfgvJ{E>sw9>3VcH`lFmp-Oj<{iZptxr>9Nq|qR`i1=%s3upQjt7)#C4%#D3Ge#zI@YjH27?$?iuj7%&p z)7Vpav3MO<84}o}%GW69a>5#l^+- z#eNsDfna9mRR@XVjJw&?Hdq+86Mru#HBSd?UMCyHc^}l5y~1EHfMm8A85!kJTTdWq zJi+cCtlhkE<9-~>Fin!Lqh0Hfkk1mnV;i;RQon%6A(_gltDBGZ)+l5c?v--~+@wu^ zi845Pv{9`iFj0-;t1IMp2**DCCA#N1QCorp(+;$e@->)eFI08oq!F(~whE;88|Y`r zFw&VdB^wUuCL=#z-D{}rR9|0T2GY%cf`Wpa*%`5$58sWK{{8wJ`)5wg*>)DizFFDN zo~@FS%3QC738~2rHrW7T!K&1jN07k}F>v9V^tm4rLwc(2C8FEsjpCBQ_9C_*V6sMa zuQ6F>pYqeE08+LxPDo1xynY_9KNAHu6`#EoQW!^%@qjMy(;BZgvB-6~C!y>ZAMILLsU5pa z{&UM*b=jqD?d{=}ky|ueTCs(Gt2Ac?m4q_)J0ZC_tW|e^(Nsz+8hN=$N(}Ca6~9Z- zx@&vBb(U2i|A%3L>VICmco$^;=*&1IP04_Xft?7}vj_C_B;dbDxo~El!CX;MQE5%h zwm0wJ=el9}1rCR@jdsIf@lI!Fr*({m&wGyjXis&pj17EA$WBGq;!^!(x_4`0cH7*o zw(lCP(NTDux=-JG?5lAXtQwUtVr89W9tKB12@)8;RbCAbS9u?+;n0SLmS9Nv+gFDg zXPrA}Q+0PI-WE;<ZwA1tJv9k8|c1*44-BYp)6AC6-c!6MMnxxJed9?*8ikV#q zLDeAspjua}8%xC^$JwsUw<}x^)l)YbVPJz>RDl|D7U-hv358X9GbUyr?A^X!%>GRV zq`Y7ivu*z_IijZ*Z2b7JxD6~>@C_md%A_Dr8S>jNO;qiwdGq@9 zYtG|y<<}Ubfsq)QtkdwWNA^#KmBt!2@W5hG(UYjj-9tmJ9TUByBTZR0B1@N=;RAt4 z)&`deb4U_dwSK)k1QWbRQ|sm6U?#HA;n@Q>VQZLuBF#KuY|L}h=FLo`IDZ(9cH@K> zF?z4so@}4D@835zKXWiE4fNx;7vs)u?tAs{iOJ)`ANa$pOxPWgJx^j;22iNojvdTM z$1+3K7g@a61o#ETITL%=sr=fiWhPvFmsE7Q5P;&`nwx&<(xow2pE@-?wJr}jBD-5; zlsDVUPu8LEH#HA`_A5|jn4;VXmXYDkmwmWqqWXnUiB1561XPWIhspRqy6C*n`H-NyXq~3-F?85ZP*MFOWdO6vIX&o-GB7YGbdfAmd`=ez1wub8pvMYJLSO>!fhi8abfsKfU9Vle zdZVbQi1?ghZJ16UAD7eQWUq*f?y+iO`muaZ`%QI@LY8ifsDcN4l@)@@30ya@Z#&>N) z#7(FsAB|N4*$v0RkR%$Am67>umEAaPjvb{Xv+q5eoSgJfm%{PSV$o`DssIkIp2M8> zCxAgWA3PXhzSI3B+vAHt7r@s}cp2HwfJEz|ScX4+s@V0<-z&&2y0gPF4F039)P29j zX9dmrC!%*a7?!(P_-X-CfNDw@MQ|Fx;9e7qXLbTjmsM9+nU& zEyKTkbGP|goABfBsLztY#`)|K^4?QGzTxOWk$@epN-2LxBM~K95Aj6v|A3+zj!j@r>1lCN*qg_@c=7%Cn;DvkCYk}t9lX+Kg{NXR0eL!LY5iLDIXWOzpmg0Zrure+wnh&aKMsfPRI zlsvi*CHjwZgBzSx$btirNdSbG(zGXm?!vK)#So{#adC0RIN`PdIMlPSxL*>1N-GKU zt%Rsp3dht$h@BNM3<+p%Jw8uZK`srxv685;dSBk&4u`E@Z_%b?Oaoum(^}wnF+`4aSXlIt!5`wkeVlW;; zk+bk!2THGv7l|-XRuj(kFQ8zOvIs#OZ>C3z>HB?z9wor2@nmR&Gy$JPRf?18Bb;cQ+c0`0L>wbn_to57>4CtN zv%NY(WAImE{|5`P9jCIp8NC|FNWAg>JOO{npY3S4hrX_tK#7hHYTx;Z? z73gFw8klr_AG5pg%NySFzHHd%Qq&@yijsY zfv$F#Ki$h1133H9Q;be2nLZSQT54YVV}y;RhW9`%IAS^oMG9)im3fUeKTR)8ECG4gdHVYo=a%OwGJTyP zQjJJU7p%5*|+19AEWTfr)AC)U

FMn2lCJqL^MwNbC^Zupb0^qKh&QUN3R-h$ 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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 889114d83ca9582c2968dc55e2b4f1f2d5cecafb..ddf2ec46f72cae3ddec6f98579426aaa12c24c3b 100644 GIT binary patch literal 2801 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 M{fQ0~scie|UxR}N{Qv*} diff --git a/public/images/api/qiskit/dev/release_notes-2.png b/public/images/api/qiskit/dev/release_notes-2.png index 2d57244a1b7f285e21b9a3771beea2103fa2362a..538867ce5e92aefb2262965632d931d28b4a12d9 100644 GIT binary patch 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{&^ literal 13722 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 diff --git a/public/images/api/qiskit/dev/release_notes-3.png b/public/images/api/qiskit/dev/release_notes-3.png index b7ee0054f41adc6b8d73fe073e8d4cf11a3ea381..57ae430d20a91425c4bf83cd31665e989bfc8641 100644 GIT binary patch literal 4052 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

n|<9AarWe*RJC^q1-JJP73oG{t2IT?^$ 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¬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 literal 8695 zcmeI2c{tQ>zsE-<|cq z3$A`g4+3Gy2aj_H_Jdax_}pONlf0X%iJLy^iJQkm7i);tLpQV|%FWTv>a@GHi>n>V z`5IIndiBz2TQ@hfs{#z>^tT^?qFiiXBHDZVz%Mz7RyTEpKsdE`A1nbLZ_Yv>B9GyB zZW?&T(+7Oq492UO3+*pO-#@+u-2;CnWnQl(zVFrKl^bTKZ$x=^?~!D$bX00)2}sNG zbbCrT=5O+a#OEN%=3UUKVXvclII3Pt)JPL@WncHcPd9iX(N{zc?vH%G!HBR-=Y;8}abOjogjq zt%YwsSGej}4ULSl350&y)$3pH8=M*EH$euAHa*0!C{G|ZIpB@0{ntwb*_F1n3;J7{QN@M9SL!?`R6MX90n;*%;d(>-I;+1c5}F5?qfZ$_dvJ`kW+1L=^l9cK7WY*lwTB{k$>C>5@;9&cnTvH>Qhhe+&mSfJQ z&Ev-xU@-iP>C>kOg6HSJz`*5Z3A`<>J1aXkxBJzRv$@dEhKGa{QkR$Ac=`CmuU|KB zYHF$+eWw`TqLZMIwwLXY?eNziKBK8bHg0R$VOe`J$Z53Ny?Jo4Xhk|lRajrlCf$jDuRT{y@mE_ z`f$xg%5~zNn5d{NwJo6y6}C3uk+iv*$9!R{haMjvpW2`%^%mQ8El;L|)7BS85moMa zd-m*+vTi;G*R!(v6az(O(`fdr`}ZTv7fMEJWhdMxH<<-jda*;KBAal3<`zX0Yh`7% z{Nrr+1!d)$z8!ymf5GdX1^c;$bM3m)r#x!664*I7{1l3RqprV5z6CR_@vYF%)GTox zP_VIu>zSDR!NbEN`hnNntjyUkN!d@zXVr0qM${Z_3^#UhDU?AC&cruKKllO(diip4 zez=~`*oU48s&Oa9M$zrWDQdhvv4M1G;CuA$1|#MeYhs-V3u;Ph{jSDbc@ir#efo8E zb#2r`A-5ksd?<`Bs@@&PSttyyqhqY6r&px-$iN`#Q%Z^$yriTA46JK&W!li#IHPK= z#tc@yjIDH=8tEyucW^K?H=l8Ll9rZsUUPaM7nk#N^m|3|fLoUqsn9yCEnYrFSjqdx zlOnsHe_Uz)`Li1o#6Wh+$B%w0aF^RoZ`*w{9UL4CI@{J<({z+!y|To7eojke*LjUA zxROSxE^2dMFb*nTJj!T~x-3Uvuv(^9w3}iuB^Lf0)}Z)T=w#z?rPV(aJZ5KBy-&2+ zfug%76Q_0m{(W&Mw1-B_DY0q@J-2p3$G7L+APU@2!co(EkDbT&UxY%9K#4qQi|?~F zMIsXli;ARO#?)=dh1M<0vsH8Aii&2>pFfXP_N(NRM5KZmt*Ea4{oAB$+N{FGI%iW; z&(1FEYkfVEB$$Ycj?TIpE{vsxC|P(8vl4rHO3PEmCMLwCrArJk=2N2wn*;?(r6|%| zl48!QGKy{QDhvna>PX%;lk}-$STBh=+Ud6Ovo5EvcDU^vIWE@e5AQYetnCyTTwm0L zvW=qqOb5==|6)KuKx>>VUMrb+`N*TXK-S%^wL7}53>}B*p1jJf*{T!OZAX)&BiG`# zw|!S;2dWJ53u2tS-gQA7{GxCfv(f2CGESu3H&k&R%|})l=_qfcdauyZz>iLUuu1$S zfhT;@#Qm(2ZhtSbLe+3_ak-SAYMt`+Y;nMLsv2{H4@NI6)wbxn2j;94MS;RKw6&cL z4@>bP$_Bl2zyxEq=w+H%_u2j|5@POn*R`$YLOvJPfTHK3Bb#sJYb?dA{U9 z-5xmedM(hibTC-lX-#!?T~*Z}?RdH59mZB!dG+L^?KqWMg{0g)<(HbB-7_F9a^}n} zYinz$6SX}FCyGNwfno&>+r>YU5WBv_aMcD4`MqQk^0(qTMQU1ErxHqrI z`ujHpu#C+W*R60n&15lnL_~z3lqf-IfpZ9YKie~Ku zHgt68u1s|`lC7(btN0U^o-%hB(J?XUK#iORDh-E+hhwii3SL4S%i8H5{FQQ7+GEyS zqPhCXfb{2Z3(pnx#yqCaQ?0~s`T?K>kz<1$h7PwhvupWg7M)Cj7~cVnaDc_g`uOq2 z#fulAbd}9t;miH5?cfVI3k!?)#0MKUCSxr}|NLD1WmMbCgGbF1&x?x6;cq%L*S%l^ zYn*0L?TtZO)7L^GS_7)`Y96T-wdBsvud#X9qFa|n8XCD(whP21BnAX|wzikrqj5Ou zYD2@pg9p7gr!tWFbA?|^2o#f`p+a4E_tMnw{K6_5W049ztGU5kC(?oX4Y;-|A%J?Y z@|L!PvJse_gzO#tD&?wS$*_*2hI~oaS&wl(d3 z>B3;Ed1j)>rUVWbtw#T@tLJP?YzGNmE^;RY!8RhMeYrev_Qi5z+GuxH7qMMc`d;*$ zlHKjduE7)Q8-2?mHj&*$AvQKVdxV|?wvv{-XoP221#aVcEV%T?IW%jWSMQ24wjB{` zOQK+%bl42pJ^AWbk2|WlsL(AGwHV%IbiLQ8hL^Tma~Za6%g=@LIVa@+V3w!e|D~|4 z!pv6X<}^0R^ig?nM3CoW&>B})gzRkR+V|C&A$FE_E0_Ift^)@Tbu0$G_NGzP#Qn%r z(ndH8Gv8ID;9l6@cRoJ@Da$>VKR3{?uM*#5x%z-o(Q=?ea34RK>mYdF3lFZ&7al}Q zf})(|d(QHUFW} zv!3s0S~}inQQ7QX6j5wFs&r?ohe(|IX}nS!)1g$j)0+ni7(~CYM|F=(VLSuz-NRZk zA@#!&Tk;TYi3>F!e>Y8GQ@80wZ{p*h))4gCtG8oCr(WOnzW|4}*H>Bu1eD`Fz%U?h zZlPKJ4VSOn@LMIC#y{>GSYZST8}2j(ES$+{f%Ib|B9fb%HF8?s4>$v8z!I%JdFz5U zJDOnym7GZ%<5pjUK&4h8cc+4A`)xSI9_{O;0AS*lOS*k@!@_A4RUj z<&!=M@0+OMqsMU%`E_70@&o1V;mQ&j>(twm@+*UT&hyJtGUqQM}nq)26fmBJe(n+w8v|lM9jxurI-w34q{CV%Kuo5XxfgMpnxpVh!3x(3J!kjR2 ze$T-VRo9E89{W2qX~#;zvC9*2s8TzhhK7dFw{J03%*LZwX(_2(EwUi5aI(s|{{BqA z$ypCXb$)-p`CD7nf%03u`z|^sk_T+I=S8v{E!p_S1d@^U(sNDY*wk-VUSr1=37-f* zv6V*o=6%_Wdsu+nyu!k>ojvn}+}wLg-plU|RLs}Ea=|10%LR2(J@y6LrYy7^l49Hj5S3f3LZQcb!|tnf)`mtl8taI@N9>1`H0G% zQ&+wy26GCWfj2ib{VI4^e<}a_+TnkVEh%-pLPB`}*UGji1&@Oa3`RcF%MAaMuSzO8 zA4OYc{>tq0ar<1E-%#^>M~2QE!iRElEZ?%G>u+G9E&5CX`cx-&?!jHWoViP%WX`9A zE9(J2+#&=!dgMrQVc}I==@PYF6WbDD;^kEV*e?F=1LLEoPEoQMNbHhtW!3>G%(TQl z8rU&l(9Y4py_fa7gvmJfXC^VXsS5tvo<)%|q_6)8RMI;v!en=!^)0sJO1{G!6Zc@< z0Sq1OFvb(@DLjgMni>>Jn)CHaTY7rW?M+MJACt#}FeN@!qHsNTclVqZ63WUJrlzL5 z1W_a@A)yIyi8feWRYd=9B=%*cjB+`rLvzNx$_Q_fH!@-c`jjnTrpoacGqwjd#w4F+0`HaMqsAj)J5H;vGIPtIJz-{fO5l+7gZh~G%s`9{>I+4?-x-zQb z_qPB1X#nhIQ1qtEyYfp00F*&nOG`~HFSe|7g9Fo*os|_)Kits}#&2EJ*InUi6DICN zI;AF4`^b=TC8f`LQV!^F)I#GirTHWQ((2mxYppdNt~%9)kK?T>+01kYR_wOd7up&b zTWiJu@j!1X!Au(kg@ibOvWUHE9a_{5nv&b{QwH7l1R;8+|P>-HY$t z%YA*wSNPbm)bet<1i7bQ!-#bTzXk$V+FF{LH$L497+46ZQDDCPdRuWi5$-2d9PpAj zj`TQp?~kFy>mnj`UR}@APhR)b1$GTsHDfm8C(yu_Tdl0Uj5P{=Yp#~E#X1~&H4|0N zry^B2{%-!_*4muS9|f%Ya6uETaT#7q{k60Ezm&ivC0l7czQWh`{NM7%;XRLk@EsMi zTtDLRrvgKqi^zEu5{ziyv_q&f<)@hqVYyJ2%i6n|CT3oCTzntoc+k+Ef5(L~8fcHp zf1i^1jdt~M*lYVW)C=p!k24DkJ8$!rgbz4VW#gV5x`9qsE?(rwh1Q>~{c3J%nzgv- z!kv5Y8Qv=M@LxRfce3~w&sti5hlq-e%`PaojG>bZJqEopLPJB32?}PL7CkXV4r0dp zY?7P|nQz{30yl-xm4@`IqP>0rb13CLV=_KAX1g%bfGBnRz|PJtg`pV$zh?jK)e$4y zZ*gwn=I(FYgHA4{LuUAC;x>$6et+wvf}47{%1-%g^_oR%l8Pm&dL^c1Q9nc5ZfT;G z&yejSi)`Nt_L@zb?ZnRy8tUpDZ3&9J$Bv1@E9Yvqy30_O@T<`Bd@(OCFYlcVs47)H0z+_^_TW~qW#Rk9(y9URI zf`YmzB65?b&N>Y!X|_(1a;%b1>8{;f7;Ti0mp6@*Ma9(L51?$a?A?DsRP;^=_o>oy z#L(vVBRE`YMur5S{Dp-DEogXXsGgf!am~iWiQQYOa;JBK4C&a>qbVR>vIS1u8I@C7 zY6SGad960N^!s_`10^NW;umcx?K!&&G==#;DiDI5wBdi+&>uPOYi?jZR+yVvuFgAt z)3|1zJy{&{`@Ur9a+8Z@0;mSb7#ui(300MvQcg#b5M{$BycmglX) z;Nakj0jA4efkc-BKI+dvBD3nEgmJzj(FdiAKx6|*!IcJ6f#cp4%hb)`ulyFCH$fsK zIlB&S2pC%@j3k0pW8;j1DJUSoFugXEq!`Zp26AO0626u>5xw>T|cUHI95)&4IXdy-jD z0+NqBXfhJ0(*aJ-?s$3EVi4u+=D1>Fs$d9+q9<=ZefnfzV)EM&y}N~ylaphw*}Nl@ zm)6!$#LG9{20SDCDPn5_c8xsTS& zR}!tBTculZj!?fmeJJLiTliP9*RJVHNK7=hz`|q?RC!Dfcu+77>doQ-$NRP;?yd;c$VQB596fgr z?Unfc{SYBN{~{Z=umONsP}{`1XqIxpV0OukG3rcVEP9iWI6Ta2rej=Js-#zH9>I542%^hz%#j#!ft}s(imE9w-x4SvOpgF zW4H3xNz32Ai>7k^sWIioA(H2^2c`?ie$?|&-z>f%#4YsAoiKh=WMHGHn3ySY&$C0{ zbwwawF6`s~_g#81lOVO~=}5i}60{5uhUB!c5GIzVx^_i9@Wl(v=v!IZDdu_zQ7oD3 zK>lTICtLGW3bnH|7(EiZTJNL;v}?n-Slw6)D#o#}gov9lEmfnTkz6b+lh9g(%$PIpY#gw@O%mlWyh5Qb?l?Bx*Kr-=fv@>T|l`!N$t>yA$R7( z1wSd;_w}4r0Xg(XK-7kMdLxdCE@Q8P4+)Vb6drN~PAh<8g_JOUSayDX+xV3s&2*h@ z{-B`X;@|DUJgEU%+St}7Rra;Obq@G%(Gi7@UqdYjnJd%1IRt_^*nji74fA~9w=9pI zVw&8%d9(S)j}B1##{dyk`>Y|5d_!k4HEsM)BXrflY(i2z~RW z8|J^j!Jwl8^g;SWHoZt_oj}W-G~#E0w0b%8vTbfXKdS}RB-jOI zi+qUUK9~htQT31D32u;(5-qPUV=GTFc9YfG#@%nDj-qPde%^P@OpfG!!t>u!`j7tRU%A@Xy0@!MGygVVQz=A+ivJ^fbuY_`jVAX4Bw=Ts3mLX<=l ztAnl8gB8;>kC8w5j&H8t4b;?v zfn-a2Ej|Xdr3#J}47Ii2xz9Ro>vPj1JZPGEeFds1A>5rxUEh7&1|S_rIu`RA5pYd$}M&&(G#h|4!4y zc-yoqBeSbgyWwS~$U~6wKRLIdzsMExY?`Nz6>^#V|1bY-4w{*J=TGU??qwz)1^fW>#56hhUi5$T*M+9%5&dX#f#)B3 zS+laTw5x5Cmb>Hb+1YJrcMy>Cd?-!FF~{weLp&6>u*eG!4_DRJwsa*zoKvEKk-Zan z5rKGm!35Wju28*z=1C%LK~$EGh%6F2^oFh%5JkZZmmjXZJR9rhX>1Bd1qBE1t(W)Z z*VKGnr$t;zhwJ)J+m7vTOqx_r_JrcL+;&xOwHZ(GRwCBoHSKsu?JoA}OWpd#a$^MZ zc(ZS_HCMtoE77f6xj%nCFE>slQKb1+MPKHa+0BkUxb(vXrobLk6(66ban}CV9}@8V z=o%UuIqhZ|`1*V71J;@f(Ty9Hn^UziPo6|KH#d(vOfD457jWI9G|3%Q_Yp7nk~2mD+W4icT6eQV@ea*qUXmozthi{*Ic0*HNr1hGlG~(Nj%H zDedY#3GRVaYtwr%-w90 zcTcD$OEVgEIf_d?lQ7BX=ro0zS69Z zQm@HNi=}ZlJUu<#dAWPU3i+0TU%lM4$LOXcnM9oV0<&&S>grHVf$!>27{rN zW;g3qJ=oMZ{Z>`MHlQ6D8Ew_tnuK2LTDP?8J1mttpxzulf4X-$r1oBZ+z<(JZLJ{2 zz(=d8smWB*LWPZut-`475-~9`-R;{VshJxY z8Og^Ynj9H9tT{08YNS9z!@VSl$Dy_MtKC z!>ks=tT&ve@<8x-cL*Dyb@X#rM_o5uz85R0omjC7pvHFu4|V+}HolgMh7XsUDNMT~ zlbB~q>h7{yjWQlWxPm7NFQ&wgj*1%jnKoeboh%nWI5af6&1j&>`-t8~*c)AO?fUim z#})c_Sy&X{siHc?Pfw0rmO6>CJG*YPZVlzt^!>ZNiK%H_V#&v#n^}eAF&(FgDQ)S= zIFIn_>|9{|MAeoa3Q@#F^Ad4;hg}NRW3cQxS-5&Uxu_p#jUOrPzmX-4sMEzi^J$fP=`RQ&wJH z>9(am?R$D0wMj)rrc-j@Wu=-zk{bP%ZQ!-Lr>E6up%w&L^~aB2w1-iZba%@&o}kw* zUA{atUT&7OG}jr$5T5C}F~Pg#yRl|fJA`uVx|H}zvk|?| z?Gn0E=0W=-raIs0d^2AM*G&zfEHoNzIg~Ar>Q8&gctf_xc(Rql!5F*HRB2#iKdYWx znwv}e9q)YI?kyMMi_+V>yTkA9h*r3)sZ$91G;|t2cjr7kI=B3kTav8Ww1>1OMcCjx z0eSy?Td>Qw795-LGV%BC-@_JgWA46ksSZtdy1mrZd!)}VaXevTt{d#*o`LZ$%3l** z#2ne$7u=nrS5Q#!_xD%x3^L^?e*3lnNf#Itu40~4un$hb2zUkQt-RVIXF1<8tg(QP;qvyI5|0J=HEIR(J-K+ zrInhlb76nr#c*?yNleFplFoNF{=sh#W~b#(k+bKyjq}@86ctk;jnp_Vo_|~Gyc$kT zclU03Z|NT0HDTZG^z^&LH*az)8&z0=NQ(uW@p z^lA>LS#Kg=PHw{F=`NY-f=$+eoK-t@dkE=-xa4f3Mv3)_g!Gnoj@RUf=*jD;De2|} z_lWGb>omdseP?o~YaA9ho_~KD!<_4SxNSng=PVU&^&k^9Ra+j-V!+J8!ovJu_O%j? zqBul?%=`xh+I7x(%=!(vup^ZS0z?m{-BQ$x98<)7i`2q$pEmCPd@6|UA{%kpoea-( zJF%}$Z?!V0xS%^!YAorp{&gU$6tde`go03BpU{zIy;e*@0@ZZ1$<;ctivxxc{+fw=WJ4)K)qh5>F7 zUchVIhvHA4rYftb^n~K1UVVtg9oKq23k!>~$qiFUoTtBGFANY?X+Chb7>TIBU0?Q_ z+T;gL3b{fq@EWM+d4F) zGF|Ux*Z)8tvFRUo5t02J!u_OOvyJN&M2KJ58K5q8^=u%4{KCTSzu{0^S~^g@SQo(a zT6qTI;hX=J+T{#OHL(*91oGE^TZnE1i^GbJyqHRy`u_l}*MHzLQEVB(L+$O2l$msO z|1*4TZEYU=<7R5Qy4HVTZ)~e=wbjx7#@|B55ZVX zRrT55w@hzn(1mEB=JN&Fj9h_$0*?sk+$FRmH@81cGyvA$z?D^PLIV7=PlH-pANM5jYkc|g1)>l) zKY{i|U;v8sKCAm7)wpeNeP9Y{C(OPW+#(=mx3Na<}-Mds0cGJ%v zKW5Y#JPsC%^Ba19PqM=6&~anBUIUIJWi@&=TC7)qg)%B(eIO4m{=3>&13sp`eS0NF zhzZw)j)i5+;1sRl{r!*gb#P*(v5bt&E~Nj}`mLrR*Z?IpH9WAdWCsQYqJlnEmfBO8 z;D%?y(z0rObulO~Z~&%n5sA!kSsS%j|5^%fjGC-28NZ5?s%_SnJW^27lppaxK_(mo z%Q*t_T%h3s&x1|KO3E;}fFsVRVLI=VLnNQuX5!$`Q022P*W{B0w17`0YMpYZExKb_ z;{`pr%CGH-#QFVaMx4GM$cEFxlqBG;%%D-M`smT`0s;aYwo^Rvi9AYo?%YvpcU>J6 z2P*A{#2%HLT)ek7wzfWAE+Z}N5Sk{%apm&EG_?YCI&N<4jP%~UBMm2^W}BO-JI|1& zl$4a{`y85pY>1~g%QRf;giI8_%fX@AC$RI@v^P=9=KW7zLPEl6ubm$4TF0z9*A3JZ zB?X22d-L0!XDWd8Vbd~jaaB!Ber#%p;@fuiEK!B~r-Y`XjR#c^OCO)&Z`n8CMNi3-YbNJcGvxD_nIFMqb696QQ3P{Hj~*q$UcpUHdf1FTIs>jBAvBk z-SP49pwLiT#V1l_RWTkV(bV{)JW^%Ic=BA+o#mbaCpnPFz#CEF;mSyp&k^C_qzt5% zSBa*cT#hadr+2`)Z%!9DEVQfD{l$%nTbN(e7?gi-tWE0bRN(+yp-hu;qT0?NYa>S? zMcv3KoqALjVb5}&kWv+{0KC$8(lVw>4NDN%Ki}}+AvS=`xq zcAES@lO1-l#I>vMtA+3W5wNwE)SM+g(69=Z;V6s%8o+Gvq{o_TEEm!%mc-=e{`v zsfjX^;AHn@67SRFgT462g&`xBHrI!|<=fFie6QYozaZ{Ec5?o!9Eb;(&>s-yv*i

n|<9AarWe*RJC^q1-JJP73oG{t2IT?^$ zpFc~TJ%64-SlEDsge0o-RZPrH;eg6iIg#Ig|J`Gwa%>ksOKrku{VOXZk1sI zt3gr(Wd$hZG@->I1#v{;?X9`N_f##MklDFsy~;ffHjDcE`}sO@GBaybsfz<4Hp_EQ zXF@#Y(q69ei@T`GASkG(Jkl0J#%((cShReTb*Pg&QMA?$if+^dp~yr^1`&BkihOWqU5o^yzYBZ7ye8ULI5ic(S+%&M#( z1L9TQVAM>7N5!5Cx$UV`z3T?;HF*&HEkv+=CqR}Y1^DCI`vSXU+w+jaZhZf7?%_Y4 z%U^uc$$JJ-A@JYw4H8Hv2m(}Ac6K}kp2)qY*zCFPT0b~A2>kuaKKf#W!_6nH+MpcE}ygKah~hw3eW6!eS~J+3Zl+aF_(JD%-qpuzVRzl6H`&mrXK0_ zR<9mb+DV7|I2}kemN^tqug<&*%+`C-$Z5=d{!izyg$Sk-yc*A!*@-wcH(i~;#R6+* z#^=c9R}%N4hUY9RW3!pAQ-dY^4|qW)t8iSBfm{s4=lAH}-Z9?i7#&A}BXSQ5E%rNR2y)xIsSg16-w`BNuGj&=HSPhv(;X>|AM zSGk9dXirA%uZQCzOmOY_x7I)Rzd#BNwN2G2EI+H(SlMVc!G6r!V=2)?;c2L^Gu0%@ zxGf5r>^L<5G-(0RzUdZWTMl_rn1UW({;UL=<{VK21M?ToA$=Vkk|4ID!W6ou9~r~H`)#mMX2zqne_>IVe(;Su)oPcou65=!`Hp`@EV*Bf=b6+2a2@UO`Wk)2 z>`s|7Mp1AYO#O}zb#6(74U*GbD zVI6UCe@I$6z(Yww-rD!?-v=eB8bClX-011Hw=$5?J{A=hmse>uW;u{94l%`Qc~N8` zLk>a1zde1w=;u}miu~rxfP$Ip42yISX{EH8(nflC#IWJklzgUT= ztPdX)fq+Je_3E9$rzGvrDpH3%ES4b|_AAd%CByxQ8PsVZ;6c2$P?OA>44%(D5VzwSuHK*wJ+{9**z05{`D|LQ zMt=<;Nc+Q69C6$tTz2p@|L<1fS9)(JdWCwzVa)1iuEy+%#7n!)sb^uc>OABGSlf}` zb^RUn;o+gh*AIrIkaq6gyH`N;0`vxjz;i_~SWBNI@}wOf9jw7?(zCE=KmY~@4U4oc ztAlNCWAHfmI?p)IwVnmg(Szg0U>FyXZZ6H3?l|@lm^0~gIga;>MI8ydKW0yOL`yIy zTxZesvv(y83=A59m$vs@wnVik2m($pNZ~b5mG7wm1r-Q|F&`d_idr>*ungO*Ssn^yzIF1cG|r)c-(nopa`rKUW$8a?I%A6PP76Gno8u~uAPJZQBGOHN8kD&pDM?)jN5BaYyn1a7QY zFD)${nW4OKBO8n$h+^h*t^N~@p4C_i1|#@B4Gldj>p&K=baJD!x7W6Ng-P4p-Mk89V)S0u5`$-lDt0Vkj~^Jl)UFPrD{- zDUNVFc^ta4R=Ccn_od{-tXHqL%jzN_q1#dG)Gh5(2C<_5z^0i6CbxleU`Z&3Q3^Wm zt|);IrEO?v7|&%BFWW~8)C>*Nl$DiH4OiUZm$7)kD46mE$Kz8q4jGWQV6E+S8Jv_o5}%(i z>RRfGS^E@ty;qMWLn0*KIWmA6j3eEP7cagxP!K(PwtDDARsps2_4e6}@j%)8(l5^u z3`SuDh8#Ix)i*?g+Xb8@=nO!qKYSUTwJ5W2XBf#NUc@rdQVe%{cM^!)QP8F4Ss1r+uyvjv1}hOc8zj| zi@8M-Jb$bd2gmgOg9i+E?mSxP2-5&nqwjm{0#4g1s58#!K>y1(=^?rSFFUT*7OGn% z#BLUZtr@>?nRjm5nO#~Uu1tQ5iZ2WnXAX(TIFDpZlFF-W_T+ckw00N-( z%1|2=1~idc=cgYF8etVAP=ON=)JvGoE0WS>H}Ah)q*t#Fk+k#kXT=mD@5E{_(BjaP zwTX64KGU^B3TDf1FN7&d*{71cCoSY`jE?p@R4@l!j4f?J-7Xc(`?Z$e@vu+~%WP?D z%V49myMxjbG>Qd!B_j;Qc^uqnyD?q5nv$U~BrGZV+{1&Ok+FM8c(~`woc&4wmCrkB zq-|hbjWTs+!F`mr;pfk}$3!R***PDG2=#zrjr$W;u+K-M7&I!3I|%S8_*6SWDO7ZI zb)yXS!-UYeATjblm=_pJ9$-XAl&3u1lTv(HgNaaYzb5uz>@}pZ~zKb3^u15cD@C`{Ir~$YEVXF zqtjbswGev?SyrunG>w%pb~Is#liLr%CRPnVkf_~tN{)_Rb_8@k+N@WALX#TgQ&I-D zr}Uj?@YRk!ANpEkeAwx=-Et^l@yTlWvTHT_OrK8czOmPf17RQnfGNU{nMOczuP$$Td>E z&*;bSYviVK$9|_-lN=03M z>s{+7hEXb}r&D&OyQ7!G2&{u*LptZ|X&*e0gc9RlPMdA|7Cy!9A=$x7sE?rwVe#wc z61CGx=iHNuXXe40&RT!N`60zGIByBjy-88%{bgY<=e{U0#pc9rbK88{7dJN*wC4ee zn;l*8<}OaEiy;opH&X#Y!HVxELg>9=vfa58IU8BQB9>DJX@it*m(7_Ka#VrNk@K*P zH@{WyCr$BMO#wtI9XMOuCY2uahR@$#dufnz=np!a_;Jzn0vPOvjP=NJG@doS?-TAl*hE*2K$AH{RK7vX>`x@y}i!%qVP=5>ooM#u||GX zFMoM^tE+iXTjXB3E`T^_#ZvLlqocKr>RGN|m@J74XwJYe1PL5Oo$233U3zAw7}g;I zr}MwF_C9Dbl0s-;yb+B3@23HB1nD&FYdz9~Lu3lK!!<yu`WXiwnqB$96lSrOvZ=F4b(tJfY2$% z>G}u?|EJIed94k(0ZEa1QoS&cH1>5T5C)HeOZS8n)2@44*_+lyA ziog?h)%V_01NpQuRjYDOGBgsp0LI_@(O~N&-@bj5nFP=UKUhxYRs7=8lEn$;5Npnj zD@}z;Lh=R+-Y#q6reu?gdqZ`MT5}S+IEAQae&aEi zucZ90g;-B^GW$tVK7=0m=A-GYE6Adrwy7@d2u!g|*E;j8Sw9oE`F1S-8acQ1*N4aG zvF6dYBNRlHOgj*X?Sxe6AfcJVsJOkPLc|}})jeh9=B`$b<8fV&g%XG{Z4Lup72!b5 zoG91{6UN?e+@KWJgf2R^o)$X0Ab7@BCVsrY&g}1 z<>R~UWOl&%U*L{lKd4z+=Kr$O&+#1od~P-IbB=k#XKm!3_RFKursW5ah@q39KZuw? zRadt#gp8XWfbipMe5=e)m1I-Z)gF6qik%W+8nQ#En5n3srv>ss9{2+U0U3j1J%4me z$_~-g>^BB(P-fjZ)@889VmG)hpvSsx$4FsHxxh2qjcLY+gTBMo{;<^u$l`QB9qZ;I z_ovfaUB=10H`87B_&1Za4`ao&xvI=B<0GqD>BA-c{`^B z&n7^UV&LV~0t;0IKE%)n19=!uY<_>OnxHTadYwMR#H>Z(>qNOUp+(R5#ywPa;NCS~ zR>hAw*`RBzwb7`o7I)rEo$ZdNE@&I<&LeGyRu>I!+mYHtR5LfBT!RkxK~r&@N~LYL zT¬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 N=xP~i60h9}{6EybVq5?K diff --git a/public/images/api/qiskit/dev/release_notes-6.png b/public/images/api/qiskit/dev/release_notes-6.png index 59b2d17abcc26f2b5948e01e8ab417b0dd23c177..18be4f78c716b7fa692231f7843bfec598166172 100644 GIT binary patch literal 8695 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 N=xP~i60h9}{6EybVq5?K literal 0 HcmV?d00001 diff --git a/public/images/api/qiskit/dev/release_notes-8.png b/public/images/api/qiskit/dev/release_notes-8.png new file mode 100644 index 0000000000000000000000000000000000000000..59b2d17abcc26f2b5948e01e8ab417b0dd23c177 GIT binary patch literal 7069 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 ZjAA-p(|v=T0IFv*Ic;&O#K7g&zW``}D@6bR literal 24838 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 A$N&HU diff --git a/public/images/api/qiskit/dev/transpiler-17.png b/public/images/api/qiskit/dev/transpiler-17.png index 4ed1ff5a588b6515450ab778c0491e24aa18b7ce..99aded57e9479638f93f0da8527240382f64253f 100644 GIT binary patch literal 19217 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�ytqGa%&hsXy#kEZ+aNkNxm7~bSOQLpBIFQJKM<2i z^}(Li`^Ea#G$}BWS=dJ5b^3?_5u`-M&3Gt?E}EKE~F1GBw5WO>A$2ozd?Jx0v4 zs?2UK9uOO=hzPcL=&_$=`6A!qaJl-yR=ej7@T-Ajve3ku(+$Y#DtaLI;R^)+PEH!2 zJ0VXd0ic+L4UGdJjbKoyhLY5RcBv|-AMbA3v_=W3LtXg>c4oV=8Uhe0Zgr(7^vZHp zCIYPnbE-HXy_uLLGhp>}&XZ>lS`J;BZK$h|`H!MIhaE?=fRxQ=?j)qbqXm)+6~+Hra^HT_^9`+$Z9kjj{l^B?z0Uq zLFWS*00*}05#TOChac~d8v@o8R;sXEeNctiQDONWfefMb@xc@1L@9!U69Pp$A-2{5 zl|ahS447eq`UiSQPV&9?@rX_`*O`QHk0r1Wi0y3w^^*W;NWK}~n*hAk4B$MnD$)TL z(jfEprwi=4GlE}s6ite#Uj)KP2CV>R3f-n&=*eQWcL%`v8u><( zeki6SXlXzP@VPVe^i~>d<>lqUclyJ=8A`ohoISDP{fkFbbYym@G+%|LeArUk z9;f>CM}K~EW&*@70vKi4tiHuQfiGX~&W3#FGi>R|R{q_G#vkTJXz#+6d+#1-yDk>W z4+2ID=qiGA`QR?M{09LgQ#qhK+#m$NVt1{=q)~w}*;?z@H%Zc)dl#Cv_hNdX@IHiD zPRfSfnr8sg`zm<_tIW*KE;m?Y(FKZJNK{l7qDVm+XliZ_W;{tJtby=0h$==j1nL_o zDsVy_z!X$nIB$T1dUTRj5W`uy9t1q@@uyyS$g$P?cuvrPZ|?S)8i6p4OocO|DOT!s(tZUf1_M~Bt?Q-SDJg`DX|05Bw?T~#2mq80U_TvCq zEjYPd-`Q9!9u-{F1wG~zo$zddXLtgLT+oFJsD~r&D$uqw$nXCU7DaDk3&I(on!BVT z>u*%Bh?gyqd!ebdHIy-BQKl1eQ8#Rk6vJMuBewL{C!_qEMbN%zdVzK#Kv`c#+*q$( zDc!s0k94OX-4&2b28}u_5Zqf_vdTebOI+X7Pd7c6q zhjfnMZw{QqFOTXXVhp4(x5mNz!9~O*tpip3>;kwdIGoF?)d$*>3k+vGIc5$HJ`;0> zP)p--bgR325e5rp5b!B#o-q`<3A>>AD&-MW4Hju}jD6KAG-X1|C!iscVpF1BWDvv# z5fA%+a{Yo|-S{yZge8IyVfOvAcNs)9xa3*UplCa|$U}r7-XCz6e3=vp(ke2)1}ZXV z)#fcoR-A>eai)lNR0xL{5c&%8t6j^P%V_x74F>Sgs3>=(ga-hq5`mr0`Lbp!ii_7s z_0BIW+#feqRRTrG9#{zrFRv;hqDqOi1Ed9<+A~t=8WmOyP#&3%XQZOD8byZ9TV9eH0i>E z1S4{^{o;TsLJ=|t0bLojyo-Z7K~8i2bvAynw{V9F0n zk5<519AwLMI2bZpVA+|7<|dH@Weyj{ejfm;*c_5hQ(`={=FLU`Od>D(kaWOb+pzmN zCSlQ^Cxy^*=(uByvLHTtfYybEg(U-`gMzKQPdesk)b=6mrtS12(2WN2jROI>6$0Ud z$o;Mm!*4w%j!17N{gR|2i7?#?oE1NxLL<4rpz$m~^6oS_&1%m%ZH)_?c`>&ykZS>(%-+LgS%$*dem33=~5X2rxOehbus{vhv3+BiF`NTMwT8FE7Oc(*OVf literal 18840 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 literal 19724 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 diff --git a/scripts/config/api-html-artifacts.json b/scripts/config/api-html-artifacts.json index 1d1c508b001..0106aaa8287 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/2083943397/zip", + "dev": "https://api.github.com/repos/Qiskit/qiskit/actions/artifacts/2125351091/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/2082018988/zip", + "dev": "https://api.github.com/repos/Qiskit/qiskit-ibm-runtime/actions/artifacts/2125352727/zip", "0.31": "https://ibm.box.com/shared/static/z19dt14je6cz69oi4knraitjglzo29w7.zip", "0.30": "https://ibm.box.com/shared/static/f950vkx3uq13o8g017bazpm4o9bcei2i.zip", "0.29": "https://ibm.box.com/shared/static/9n6xf8gkh24xpft2e7zrwgme7jzkh6nu.zip", diff --git a/scripts/config/historical-pages-to-latest.json b/scripts/config/historical-pages-to-latest.json index 519c8265483..15432e52a6d 100644 --- a/scripts/config/historical-pages-to-latest.json +++ b/scripts/config/historical-pages-to-latest.json @@ -18491,6 +18491,8 @@ "qiskit.circuit.CommutationChecker": "/", "qiskit.circuit.library.MCMTGate": "/", "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": "/", @@ -19220,7 +19222,10 @@ "qiskit_ibm_runtime.fake_provider.FakeWashington": "/", "qiskit_ibm_runtime.fake_provider.FakeYorktown": "/" }, - "dev": {} + "dev": { + "qiskit_ibm_runtime.execution_span.DoubleSliceSpan": "/", + "qiskit_ibm_runtime.visualization.draw_execution_spans": "/" + } }, "qiskit-ibm-transpiler": { "0.3": {