Skip to content

Improve ConsolidateBlocks documentation#15890

Open
mtreinish wants to merge 4 commits into
Qiskit:mainfrom
mtreinish:cons-block-docs
Open

Improve ConsolidateBlocks documentation#15890
mtreinish wants to merge 4 commits into
Qiskit:mainfrom
mtreinish:cons-block-docs

Conversation

@mtreinish
Copy link
Copy Markdown
Member

Summary

The consolidate blocks transpiler pass was lacking concrete documentation on it's operation. Especially for how it iteracted with other passes and specific property set fields. This commit aims to close that gap and explicitly document how the pass behaves, both in the expected current configuration as well as the still supported legacy operation modes.

Details and comments

The consolidate blocks transpiler pass was lacking concrete
documentation on it's operation. Especially for how it iteracted with
other passes and specific property set fields. This commit aims to close
that gap and explicitly document how the pass behaves, both in the
expected current configuration as well as the still supported legacy
operation modes.
@mtreinish mtreinish requested a review from a team as a code owner March 27, 2026 11:36
@qiskit-bot
Copy link
Copy Markdown
Collaborator

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

  • @Qiskit/terra-core

@mtreinish mtreinish removed their assignment Mar 27, 2026
@mtreinish mtreinish added documentation Something is not clear or an error documentation stable backport potential Make Mergify open a backport PR to the most recent stable branch on merge. mod: transpiler Issues and PRs related to Transpiler Changelog: None Do not include in the GitHub Release changelog. labels Mar 27, 2026
@ShellyGarion ShellyGarion linked an issue Mar 29, 2026 that may be closed by this pull request
Comment thread qiskit/transpiler/passes/optimization/consolidate_blocks.py Outdated
Comment thread qiskit/transpiler/passes/optimization/consolidate_blocks.py Outdated
Comment thread qiskit/transpiler/passes/optimization/consolidate_blocks.py Outdated
mtreinish and others added 2 commits May 29, 2026 20:04
Co-authored-by: Shelly Garion <46566946+ShellyGarion@users.noreply.github.com>
Co-authored-by: Matthew Treinish <mtreinish@kortar.org>
@mtreinish mtreinish requested a review from ShellyGarion May 30, 2026 00:04
@coveralls
Copy link
Copy Markdown

Coverage Report for CI Build 26668505362

Coverage decreased (-0.002%) to 87.554%

Details

  • Coverage decreased (-0.002%) from the base build.
  • Patch coverage: No coverable lines changed in this PR.
  • 17 coverage regressions across 3 files.

Uncovered Changes

No uncovered changes found.

Coverage Regressions

17 previously-covered lines in 3 files lost coverage.

File Lines Losing Coverage Coverage
crates/qasm2/src/parse.rs 12 97.15%
crates/qasm2/src/lex.rs 4 92.29%
crates/circuit/src/parameter/symbol_expr.rs 1 73.84%

Coverage Stats

Coverage Status
Relevant Lines: 123920
Covered Lines: 108497
Line Coverage: 87.55%
Coverage Strength: 965236.53 hits per line

💛 - Coveralls

@mtreinish mtreinish added this to the 2.4.2 milestone May 30, 2026
Copy link
Copy Markdown
Member

@ShellyGarion ShellyGarion left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. @Cryoris - do you have any comments or could we merge this?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Changelog: None Do not include in the GitHub Release changelog. documentation Something is not clear or an error documentation mod: transpiler Issues and PRs related to Transpiler stable backport potential Make Mergify open a backport PR to the most recent stable branch on merge.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document runs vs blocks in ConsolidateBlocks logic

6 participants