Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve docstring for Statevector.evolve #9666

Merged
merged 5 commits into from
Mar 1, 2023

Conversation

garrison
Copy link
Member

Summary

I didn't realize from the generated documentation that Statevector.evolve can accept an Instruction or QuantumCircuit, not just an Operator. I only learned it once I read the source. This modifies the docstring to make it explicit.

Details and comments

I didn't realize from the generated documentation that
`Statevector.evolve` can accept an `Instruction` or `QuantumCircuit`,
not just an `Operator`.  I only learned it once I found myself
reading the source.  This modifies the docstring to make it explicit.
@garrison garrison requested review from a team and ikkoham as code owners February 25, 2023 23:08
@qiskit-bot
Copy link
Collaborator

Thank you for opening a new pull request.

Before your PR can be merged it will first need to pass continuous integration tests and be reviewed. Sometimes the review process can be slow, so please be patient.

While you're waiting, please feel free to review other open PRs. While only a subset of people are authorized to approve pull requests for merging, everyone is encouraged to review open pull requests. Doing reviews helps reduce the burden on the core team and helps make the project's code better for everyone.

One or more of the the following people are requested to review this:

@coveralls
Copy link

coveralls commented Feb 25, 2023

Pull Request Test Coverage Report for Build 4307079157

  • 0 of 0 changed or added relevant lines in 0 files are covered.
  • No unchanged relevant lines lost coverage.
  • Overall coverage increased (+0.001%) to 85.343%

Totals Coverage Status
Change from base Build 4306385105: 0.001%
Covered Lines: 67530
Relevant Lines: 79128

💛 - Coveralls

jakelishman
jakelishman previously approved these changes Feb 27, 2023
Copy link
Member

@jakelishman jakelishman left a comment

Choose a reason for hiding this comment

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

Nice, thanks Jim.

@jakelishman jakelishman added documentation Something is not clear or an error documentation stable backport potential The bug might be minimal and/or import enough to be port to stable automerge Changelog: None Do not include in changelog labels Feb 27, 2023
@@ -360,7 +360,7 @@ def evolve(self, other, qargs=None):
"""Evolve a quantum state by the operator.

Args:
other (Operator): The operator to evolve by.
other (Operator | QuantumCircuit | Instruction): The operator to evolve by.
Copy link
Member

Choose a reason for hiding this comment

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

Oh, Sphinx is actually complaining about the lookup of Instruction is ambiguous. I think if you make it circuit.Instruction it should be happy again.

Copy link
Member Author

Choose a reason for hiding this comment

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

Thanks, that worked. 🙂

@mergify mergify bot merged commit d6a8816 into Qiskit:main Mar 1, 2023
mergify bot pushed a commit that referenced this pull request Mar 1, 2023
* Improve docstring for `Statevector.evolve`

I didn't realize from the generated documentation that
`Statevector.evolve` can accept an `Instruction` or `QuantumCircuit`,
not just an `Operator`.  I only learned it once I found myself
reading the source.  This modifies the docstring to make it explicit.

* Disambiguate `Instruction`

#9666 (comment)

---------

Co-authored-by: mergify[bot] <37929162+mergify[bot]@users.noreply.github.com>
(cherry picked from commit d6a8816)
mergify bot added a commit that referenced this pull request Mar 1, 2023
* Improve docstring for `Statevector.evolve`

I didn't realize from the generated documentation that
`Statevector.evolve` can accept an `Instruction` or `QuantumCircuit`,
not just an `Operator`.  I only learned it once I found myself
reading the source.  This modifies the docstring to make it explicit.

* Disambiguate `Instruction`

#9666 (comment)

---------

Co-authored-by: mergify[bot] <37929162+mergify[bot]@users.noreply.github.com>
(cherry picked from commit d6a8816)

Co-authored-by: Jim Garrison <garrison@ibm.com>
@garrison garrison deleted the statevector-evolve-docstring branch March 2, 2023 01:49
king-p3nguin pushed a commit to king-p3nguin/qiskit-terra that referenced this pull request May 22, 2023
* Improve docstring for `Statevector.evolve`

I didn't realize from the generated documentation that
`Statevector.evolve` can accept an `Instruction` or `QuantumCircuit`,
not just an `Operator`.  I only learned it once I found myself
reading the source.  This modifies the docstring to make it explicit.

* Disambiguate `Instruction`

Qiskit#9666 (comment)

---------

Co-authored-by: mergify[bot] <37929162+mergify[bot]@users.noreply.github.com>
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 changelog documentation Something is not clear or an error documentation stable backport potential The bug might be minimal and/or import enough to be port to stable
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants