Prepare 1.3.0 release #13447

raynelfss · 2024-11-15T20:11:03Z

Move loose release notes.

Summary

The following commits set the version number on stable/1.3 to 1.3.0 in preparation for the 1.3.0 final release.

Details and comments

The following commits will:

Set the version number to 1.3.0.
Consolidate any loose release notes into the releasenotes/notes/1.3/ folder.
Update the cargo dependencies.
Fix any typos, broken links, and bad references in the folder releasenotes/notes/1.3/.
Include a prelude release note for the release.

qiskit-bot · 2024-11-15T20:11:08Z

One or more of the following people are relevant to this code:

@Eric-Arellano
@abbycross
@beckykd
@Qiskit/terra-core

beckykd

Lots of good stuff! let me know if you have any questions!

releasenotes/notes/1.3/add-mcx-plugins-85e5b248692a36db.yaml

releasenotes/notes/1.3/add-more-sabre-trials-9b421f05d2f48d18.yaml

releasenotes/notes/1.3/add-qpy-v13-3b22ae33045af6c1.yaml

releasenotes/notes/1.3/clib-grover-op-cb032144e899ed0d.yaml

releasenotes/notes/1.3/add-gates-to-collect-clifford-af88dd8f7a2a4bf9.yaml

releasenotes/notes/1.3/add-mcx-plugins-85e5b248692a36db.yaml

releasenotes/notes/1.3/binary-arithmetic-gates-6cd2b1c8112febe0.yaml

raynelfss · 2024-11-19T21:12:21Z

I have checked all release notes to the best of my abilities now. @beckykd feel free to further review these. I should be posting the prelude release note sometime tomorrow.

beckykd

I think I'm through everything! Thanks for putting them all together and doing that initial edit!

releasenotes/notes/1.3/deprecate-pulse-package-07a621be1db7fa30.yaml

beckykd · 2024-11-20T21:16:12Z

releasenotes/notes/1.3/storage-var-a00a33fcf9a71f3f.yaml

I'm not sure what the term "inlined" means. Can you rephrase?
"inlined onto the base circuit"

I believe it's just mentioning how it's realigning new instructions onto a base circuit. Maybe the word re-align works better?

"Inline" is a compiler term

But also I think that note is from some prior release?

releasenotes/notes/1.3/storage-var-a00a33fcf9a71f3f.yaml

releasenotes/notes/1.3/prepare-1.3.0-7c45598775fc2bbf.yaml

mtreinish

Thanks for doing this, I've done a quick first pass through the notes but I still need to read the rendered output in sphinx to see how the complete notes read. From this first pass though I have a few concerns before I feel this is ready to merge and subsequently tagging the release.

The first is there are some notes that are already published on prior releases we need to delete those files from the stable/1.3 branch in this PR to avoid duplicating them. You can just git rm these files, but please do an audit of all the notes in the rendered output to make sure none exist on https://docs.quantum.ibm.com/api/qiskit/release-notes/1.2 or https://docs.quantum.ibm.com/api/qiskit/release-notes/1.1

The second large concern is around how we're documenting performance improvements. We are very inconsistent about how we're reporting speedups across the board. A lot of synthesis functions are called out individually as having been ported to rust and citing a speedup factor. While for the transpiler passes only some do this, the basis translator stands out prominently as being one of the few that did this. If we're going to call these out as feature notes we should be consistent and ensure we do it for all of them. Or if we feel it's not important to document them individually as a long list it is probably better to consolidate the multiple notes into a single note for passes that lists out the passes we've ported to rust and they're generally faster. We should do the same thing for synthesis functions too. Personally I think a single large note documenting all of them is better for readers than doing a lot of small notes.

A smaller thing is I feel like many release notes were not checked over for completeness or correct categorization and we should ensure this is all correct before publishing the release notes.

mtreinish · 2024-11-26T21:05:19Z

releasenotes/notes/1.3/storage-var-a00a33fcf9a71f3f.yaml

@@ -6,7 +6,7 @@ features_circuits:

    See :ref:`circuit-real-time-methods` for more in-depth discussion on all of these.


This note file needs to be deleted it was already released in 1.1.0.

mtreinish · 2024-11-26T21:06:52Z

releasenotes/notes/1.3/prepare-1.3.0-7c45598775fc2bbf.yaml

+    Qiskit version 1.3.0 brings in major performance and quality improvements
+    for the transpiler. The minimum required Python version is now 3.9.


What are the quality improvements?

With this, I was mainly referring to the refactoring of the circuit library and the many additions to the synthesis transpiler passes and plugins, all of which were aimed at better performance and quality of the transpiler. But I can change this if you believe it is not the best way of putting it.

mtreinish · 2024-11-26T21:19:24Z

releasenotes/notes/1.3/prepare-1.3.0-7c45598775fc2bbf.yaml

+    Qiskit version 1.3.0 brings in major performance and quality improvements
+    for the transpiler. The minimum required Python version is now 3.9.


I'd probably move this to the end since it's more just a secondary FYI and not a headline thing.

releasenotes/notes/1.3/prepare-1.3.0-7c45598775fc2bbf.yaml

mtreinish · 2024-11-26T21:22:48Z

releasenotes/notes/1.3/prepare-1.3.0-7c45598775fc2bbf.yaml

+      * The deprecation of the Qiskit pulse module and all of its related components. 
+        The pulse module and its functionality will be part of `Qiskit Dynamics <https://github.com/qiskit-community/qiskit-dynamics>`_.


Typically I wouldn't highlight this in the prelude. We have the full release notes and a dedicated deprecation section for this. The prelude is really just for the most important changes in the release and a deprecation normally doesn't fall into this in my opinion. The removal in 2.0 probably would though (although those release notes are going to be huge).

releasenotes/notes/1.3/backend-sampler-v2-level1-dc13af460cd38454.yaml

mtreinish · 2024-11-26T21:52:22Z

releasenotes/notes/1.3/backend-sampler-v2-level1-dc13af460cd38454.yaml

    in the run options, the results from the backend will be treated as level 1
-    results rather as bit arrays (the level 2 format).
+    results instead of bit arrays (the level 2 format).
 upgrade:


Is this really an upgrade note of a fix note? If it's an upgrade note we should explain the rationale behind the change, and also change the category to upgrade_primitives.

releasenotes/notes/1.3/add-qpy-v13-3b22ae33045af6c1.yaml

releasenotes/notes/1.3/deprecate-basic-simulator-configuration-9d782925196993e9.yaml

mtreinish

Thanks for updating things. I started with the updated prelude, it is looking much better. Just have some small wording suggestions or missing details in suggestions

releasenotes/notes/1.3/prepare-1.3.0-7c45598775fc2bbf.yaml

mtreinish · 2024-11-27T16:40:04Z

releasenotes/notes/1.3/prepare-1.3.0-7c45598775fc2bbf.yaml

+        improvements to the :class:`.HighLevelSynthesis` transpiler pass, which can now take
+        into account idle auxiliary qubits to find the best available decomposition for a given gate.
+
+      * The minimum supported Python version is now 3.9 as Python 3.8 went end of life in 2024-10. Official support for Python 3.13 support was also added in this release.


This is missing a newline, probably from the web editor I used for my previous suggestions. Manually adding one line like this should fix the build error.

Suggested change

* The minimum supported Python version is now 3.9 as Python 3.8 went end of life in 2024-10. Official support for Python 3.13 support was also added in this release.

* The minimum supported Python version is now 3.9 as Python 3.8 went end of life in 2024-10. Official support for Python 3.13 support was also added in this release.

- Move loose release notes.

Co-authored-by: Rebecca Dimock <[email protected]>

Co-authored-by: Julien Gacon <[email protected]>

Co-authored-by: Rebecca Dimock <[email protected]> Co-authored-by: Julien Gacon <[email protected]> Co-authored-by: Elena Peña Tapia <[email protected]>

Co-authored-by: Rebecca Dimock <[email protected]>

Co-authored-by: Rebecca Dimock <[email protected]> Co-authored-by: Julien Gacon <[email protected]>

Co-authored-by: Rebecca Dimock <[email protected]>

Co-authored-by: Elena Peña Tapia <[email protected]>

Co-authored-by: Matthew Treinish <[email protected]>

…-9d782925196993e9.yaml

Co-authored-by: Julien Gacon <[email protected]>

Co-authored-by: Julien Gacon <[email protected]> Co-authored-by: Alexander Ivrii <[email protected]>

Co-authored-by: Matthew Treinish <[email protected]>

mtreinish · 2024-11-27T19:22:07Z

releasenotes/notes/1.1/fix-apply-layout-duplicate-negative-indices-cf5517921fe52706.yaml

Just a reminder to delete this file instead of moving it.

mtreinish · 2024-11-27T19:22:30Z

releasenotes/notes/1.1/fix-swap-router-layout-f28cf0a2de7976a8.yaml

Just a reminder to delete this file instead of moving it.

mtreinish · 2024-11-27T19:22:40Z

releasenotes/notes/1.1/fix-symbolic-unit-scaling-c3eb4d9be674dfd6.yaml

Just a reminder to delete this file instead of moving it.

mtreinish · 2024-11-27T19:22:46Z

releasenotes/notes/1.1/parallel-check-8186a8f074774a1f.yaml

Just a reminder to delete this file instead of moving it.

mtreinish · 2024-11-27T19:22:51Z

releasenotes/notes/1.1/plot-circuit-layout-5935646107893c12.yaml

Just a reminder to delete this file instead of moving it.

mtreinish · 2024-11-27T19:33:34Z

releasenotes/notes/1.3/backend-sampler-v2-level1-dc13af460cd38454.yaml

-    results rather as bit arrays (the level 2 format).
-upgrade:
+    results instead of bit arrays (the level 2 format).
+upgrade_primitives:


For this note I would add a sentence to the end of this like:

If you were previously relying on this behavior you can manually clear the metadata before calling :meth:`.BackendSamplerV2.run` by calling `circuit.metadata.clear()`.

mtreinish · 2024-11-27T19:35:16Z

releasenotes/notes/1.3/clib-grover-op-cb032144e899ed0d.yaml

+    :class:`.GroverOperator`, but does not require you to choose the implementation of the
+    multi-controlled X gate, but instead lets the compiler determine the optimal decomposition.
+    Additionally, it does not wrap the circuit into an opaque gate and is 
+    faster because fewer decompositions are required for transpilation.

    Example::


You can use a plot directive here so the circuit is actually shown in the release note. You just need to change the print(grover_op.draw()) to grover_op.draw("mpl")

mtreinish · 2024-11-27T19:37:29Z

releasenotes/notes/1.3/deprecate-basic-simulator-configuration-9d782925196993e9.yaml

@@ -25,8 +25,8 @@ deprecations_providers:
      backend.configuration().memory             No representation      
      backend.configuration().max_shots          No representation      

-    (*) Note that ``backend.target.operation_names`` includes ``basis_gates`` and additional 
+    (*) Note that :meth:`.Backend.target.operation_names` includes ``basis_gates`` and additional 


This isn't correct and won't resolve correctly. It would be ``:attr:` instead of meth because target is an attribute of backend. But sphinx won't be able to resolve this because target isn't a path it can find as it's an instance attribute. This was probably more correct before.

mtreinish · 2024-11-27T19:39:12Z

releasenotes/notes/1.3/oxidize-transpiler-passes-16f2f1c57612e74a.yaml

@@ -0,0 +1,53 @@
+---
+features_transpiler:
+  - |


Thanks for consolidating these into a single note. I think you just need to unify the language here. We should just list out the passes that were ported and say they're faster in general. We don't need any of the specific details for each pass.

mtreinish · 2024-11-27T19:39:51Z

releasenotes/notes/1.3/oxidize-transpiler-passes-16f2f1c57612e74a.yaml

+    * The :class:`.ConsolidateBlocks` pass will now run the equivalent of the
+      :class:`.Collect2qBlocks` pass internally if it was not run in a pass
+      manager prior to the pass. Previously, 
+      :class:`.Collect2qBlocks` or :class:`.Collect1qRuns` had to be run before
+      :class:`.ConsolidateBlocks` for :class:`.ConsolidateBlocks` to do
+      anything. By doing the collection internally, the overhead from the pass
+      is reduced. If :class:`.Collect2qBlocks` or :class:`.Collect1qRuns` are
+      run prior to :class:`.ConsolidateBlocks,` the collected runs by those
+      passes from the property set are used and there is no change in behavior
+      for the pass. The pass now runs up to 3x faster than it did with Python.


Except for the last sentence this should be a separate note like it was before. This was documenting the new feature of the pass to run standalone without any of the collection passes.

raynelfss added on hold Can not fix yet Changelog: None Do not include in changelog labels Nov 15, 2024

raynelfss added this to the 1.3.0 milestone Nov 15, 2024

raynelfss requested a review from a team as a code owner November 15, 2024 20:11

beckykd approved these changes Nov 18, 2024

View reviewed changes

Cryoris reviewed Nov 19, 2024

View reviewed changes

raynelfss force-pushed the prepare-1.3 branch from 2c63b31 to bdd938a Compare November 19, 2024 20:56

raynelfss added the ci: test wheels Run the wheel-build scripts as an additional CI run for this PR label Nov 20, 2024

beckykd reviewed Nov 20, 2024

View reviewed changes

raynelfss force-pushed the prepare-1.3 branch 2 times, most recently from 6dffa85 to b1e08f8 Compare November 25, 2024 16:11

ElePT reviewed Nov 26, 2024

View reviewed changes

releasenotes/notes/1.3/prepare-1.3.0-7c45598775fc2bbf.yaml Outdated Show resolved Hide resolved

raynelfss removed the on hold Can not fix yet label Nov 26, 2024

mtreinish mentioned this pull request Nov 26, 2024

Fix InverseCancellation to run in classical blocks #13454

Merged

mtreinish requested changes Nov 26, 2024

View reviewed changes

raynelfss force-pushed the prepare-1.3 branch from 5669ca3 to bbe57f2 Compare November 27, 2024 05:05

ElePT reviewed Nov 27, 2024

View reviewed changes

releasenotes/notes/1.3/deprecate-basic-simulator-configuration-9d782925196993e9.yaml Outdated Show resolved Hide resolved

raynelfss force-pushed the prepare-1.3 branch from 743ff0e to 98324b7 Compare November 27, 2024 14:46

mtreinish reviewed Nov 27, 2024

View reviewed changes

releasenotes/notes/1.3/prepare-1.3.0-7c45598775fc2bbf.yaml Outdated Show resolved Hide resolved

releasenotes/notes/1.3/prepare-1.3.0-7c45598775fc2bbf.yaml Outdated Show resolved Hide resolved

releasenotes/notes/1.3/prepare-1.3.0-7c45598775fc2bbf.yaml Outdated Show resolved Hide resolved

mtreinish reviewed Nov 27, 2024

View reviewed changes

raynelfss and others added 8 commits November 27, 2024 14:18

Initial: Change version to 3.0

54c79dc

- Move loose release notes.

Update cargo dependencies in Cargo.lock

7182a27

1st round (to be rebased)

618ec15

Apply suggestions from code review

8aa81db

Co-authored-by: Rebecca Dimock <[email protected]>

Apply suggestions from code review

a35e090

Co-authored-by: Julien Gacon <[email protected]>

Check for typos in any release notes.

5d874ad

Co-authored-by: Rebecca Dimock <[email protected]> Co-authored-by: Julien Gacon <[email protected]> Co-authored-by: Elena Peña Tapia <[email protected]>

Add missing release note for Qiskit#13237

dc2491a

Move new missing release note to 1.3 folder

6c06b60

raynelfss and others added 20 commits November 27, 2024 14:18

Apply suggestions from code review

db2fe35

Co-authored-by: Rebecca Dimock <[email protected]>

Apply code suggestions from code review

6cb31f3

Co-authored-by: Rebecca Dimock <[email protected]> Co-authored-by: Julien Gacon <[email protected]>

More code review comments

52acb47

Co-authored-by: Rebecca Dimock <[email protected]>

Add prelude note

69cb13f

Fix: Incorrent indentation of prelude release note.

491a023

Fix: Spelling errors and broken links.

a363273

Move release note to 1.3 folder

eeb9d3c

Update prepare-1.3.0-7c45598775fc2bbf.yaml

75cd4f3

Co-authored-by: Elena Peña Tapia <[email protected]>

Move release notes from 1.1, 1.2 into their respective folders.

4b6289a

Apply suggestions from code review

b9f2bc1

Co-authored-by: Matthew Treinish <[email protected]>

Apply suggestions from code review

89977c3

Co-authored-by: Matthew Treinish <[email protected]>

More review comments

d02a12f

Co-authored-by: Matthew Treinish <[email protected]>

Move latest release note

2bb25b3

Fix a couple of sphinx formatting errors

e3bb6bf

Change wording on prelude

364be17

Update releasenotes/notes/1.3/deprecate-basic-simulator-configuration…

12f895c

…-9d782925196993e9.yaml

Update releasenotes/notes/1.3/pauli-evo-plugins-612850146c3f7d49.yaml

f5ed24d

Co-authored-by: Julien Gacon <[email protected]>

More corrections on release notes

c3a993b

Co-authored-by: Julien Gacon <[email protected]> Co-authored-by: Alexander Ivrii <[email protected]>

Apply suggestions to prelude note

d3d3085

Co-authored-by: Matthew Treinish <[email protected]>

Consolidate transpiler pass port related release notes

eae5da2

raynelfss force-pushed the prepare-1.3 branch from a0b7460 to eae5da2 Compare November 27, 2024 19:18

raynelfss added 2 commits November 27, 2024 14:20

Move in new release note

1acf8c7

Modify new release note

b7a7955

mtreinish reviewed Nov 27, 2024

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Prepare 1.3.0 release #13447

Prepare 1.3.0 release #13447

raynelfss commented Nov 15, 2024 •

edited

Loading

qiskit-bot commented Nov 15, 2024

beckykd left a comment

raynelfss commented Nov 19, 2024

beckykd left a comment

beckykd Nov 20, 2024

raynelfss Nov 21, 2024

jakelishman Nov 21, 2024

jakelishman Nov 21, 2024

mtreinish left a comment

mtreinish Nov 26, 2024

mtreinish Nov 26, 2024

raynelfss Nov 27, 2024

mtreinish Nov 26, 2024

mtreinish Nov 26, 2024

mtreinish Nov 26, 2024

mtreinish left a comment

mtreinish Nov 27, 2024

mtreinish Nov 27, 2024

mtreinish Nov 27, 2024

mtreinish Nov 27, 2024

mtreinish Nov 27, 2024

mtreinish Nov 27, 2024

mtreinish Nov 27, 2024

mtreinish Nov 27, 2024

mtreinish Nov 27, 2024

mtreinish Nov 27, 2024

mtreinish Nov 27, 2024

		@@ -6,7 +6,7 @@ features_circuits:

		See :ref:`circuit-real-time-methods` for more in-depth discussion on all of these.

		Qiskit version 1.3.0 brings in major performance and quality improvements
		for the transpiler. The minimum required Python version is now 3.9.

		* The deprecation of the Qiskit pulse module and all of its related components.
		The pulse module and its functionality will be part of `Qiskit Dynamics <https://github.com/qiskit-community/qiskit-dynamics>`_.

	* The minimum supported Python version is now 3.9 as Python 3.8 went end of life in 2024-10. Official support for Python 3.13 support was also added in this release.
	* The minimum supported Python version is now 3.9 as Python 3.8 went end of life in 2024-10. Official support for Python 3.13 support was also added in this release.

Prepare 1.3.0 release #13447

Are you sure you want to change the base?

Prepare 1.3.0 release #13447

Conversation

raynelfss commented Nov 15, 2024 • edited Loading

Summary

Details and comments

qiskit-bot commented Nov 15, 2024

beckykd left a comment

Choose a reason for hiding this comment

raynelfss commented Nov 19, 2024

beckykd left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

mtreinish left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

mtreinish left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

raynelfss commented Nov 15, 2024 •

edited

Loading