Skip to content

Add Clifford operator class#3938

Merged
ajavadia merged 18 commits into
Qiskit:masterfrom
chriseclectic:symplectic/clifford
Apr 2, 2020
Merged

Add Clifford operator class#3938
ajavadia merged 18 commits into
Qiskit:masterfrom
chriseclectic:symplectic/clifford

Conversation

@chriseclectic
Copy link
Copy Markdown
Member

@chriseclectic chriseclectic commented Mar 6, 2020 •
edited
Loading

Summary

  • Start of a Clifford operator class based on the StabilizerTable class for its internal data structure.

  • Adds clifford_utils file that contains helper functions for directly updating a Clifford object with standard 1 and 2 qubit Clifford basis gates.

TODO

Implement the methods of the BaseOperator API directly as vectorized table update methods on the StabilizerTable and add unit tests.

  • Implement compose
  • Implement tensor / expand
  • Implement conjugate
  • Implement transpose
  • Implement is_unitary
  • Implement to_matrix
  • Implement to_operator
  • Add tests for Clifford class
  • Add documentation to Clifford class

@chriseclectic chriseclectic force-pushed the symplectic/clifford branch 2 times, most recently from 8dbdad2 to 561c933 Compare March 6, 2020 21:55
This was referenced Mar 8, 2020
Closed
Merged
ShellyGarion
ShellyGarion reviewed Mar 12, 2020
View reviewed changes
Comment thread qiskit/quantum_info/operators/symplectic/clifford.py Outdated
# Clifford array.

# Condition is
# table.T * [[0, 1], [1, 0]] * table = [[0, 1], [1, 0]]
Copy link
Copy Markdown
Member

@ShellyGarion ShellyGarion Mar 12, 2020 •
edited
Loading

Choose a reason for hiding this comment

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

this actually checks that the clifford table is a symplectic matrix, so perhaps this method should be called 'is_symplectic' or 'is_clifford' (and not 'is_unitary')?

@chriseclectic chriseclectic added the on hold Can not fix yet label Mar 18, 2020
@chriseclectic chriseclectic removed the on hold Can not fix yet label Mar 29, 2020
@chriseclectic chriseclectic added this to the 0.13 milestone Mar 31, 2020
@chriseclectic chriseclectic changed the title [WIP] Add Clifford operator class Add Clifford operator class Mar 31, 2020
chriseclectic and others added 8 commits March 31, 2020 14:15
@chriseclectic
Add Clifford operator class
1f324ee
@sethmerkel @chriseclectic
Add compose, tensor, expand, and is_unitary
8a6eb76 
Co-Authored-By: Christopher J. Wood <cjwood@us.ibm.com>
@chriseclectic
Add clifford conversion methods based on circuit decomposition
5427f9d 
* Added `to_circuit` method
* Added `to_gate` method
* Added `to_matrix` method
* Added `to_operator`
@ShellyGarion @chriseclectic
Add tests
50443c8 
* 1 and two qubit clifford gates
* compose, dot, tensor, expand, conjugate, transopse, is_unitary, to_operator

Co-Authored-By: Christopher J. Wood <cjwood@us.ibm.com>
Co-Authored-By: Shelly Garion <shellygarion@users.noreply.github.com>
@chriseclectic
Rename files and fix bugs
e45bd36 
test_clifford_gates -> test_clifford
clifford_append_gate -> clifford_circuits
Fix n_qubits -> num_qubits
Fix tensor order bug
Fix append 2-qubit gate tests
Speed up compose
Fix qubit order issue with subsystem compose
Add check that table is valid on clifford __init__
@chriseclectic
Add adjoint and conjugate
20e8122
@ShellyGarion @chriseclectic
add tests for compose and dot of subsystems, and for to_circuit
cd80d3a
@chriseclectic
Add Clifford class docs and reno
4e2390e
ShellyGarion
ShellyGarion reviewed Apr 1, 2020
View reviewed changes
Comment thread qiskit/quantum_info/operators/symplectic/clifford.py Outdated
ShellyGarion
ShellyGarion reviewed Apr 1, 2020
View reviewed changes
Comment thread qiskit/quantum_info/operators/symplectic/clifford.py Outdated
ShellyGarion
ShellyGarion reviewed Apr 1, 2020
View reviewed changes
Comment thread qiskit/quantum_info/operators/symplectic/clifford.py Outdated
ShellyGarion
ShellyGarion reviewed Apr 1, 2020
View reviewed changes
Comment thread qiskit/quantum_info/operators/symplectic/clifford.py Outdated
ShellyGarion
ShellyGarion reviewed Apr 1, 2020
View reviewed changes
Comment thread qiskit/quantum_info/operators/symplectic/clifford_circuits.py Outdated
ShellyGarion
ShellyGarion reviewed Apr 1, 2020
View reviewed changes
Comment thread qiskit/quantum_info/operators/symplectic/clifford_circuits.py Outdated
ShellyGarion
ShellyGarion reviewed Apr 1, 2020
View reviewed changes
Comment thread qiskit/quantum_info/operators/symplectic/clifford.py Outdated
ShellyGarion
ShellyGarion reviewed Apr 1, 2020
View reviewed changes
Comment thread releasenotes/notes/clifford-00645b805dedbb41.yaml Outdated
@ShellyGarion
Copy link
Copy Markdown
Member

ShellyGarion commented Apr 1, 2020

There are a few basic methods that were not tested:
to_dict, from_dict, to_matrix, to_instruction, from_instruction.

@chriseclectic
Copy link
Copy Markdown
Member Author

chriseclectic commented Apr 1, 2020

@ShellyGarion I've added some tests for the methods you mentioned

ShellyGarion
ShellyGarion previously approved these changes Apr 1, 2020
View reviewed changes
This was referenced Apr 1, 2020
Merged
Merged
ajavadia
ajavadia reviewed Apr 1, 2020
View reviewed changes
Comment thread qiskit/quantum_info/operators/symplectic/clifford_circuits.py Outdated
Comment thread qiskit/quantum_info/operators/symplectic/clifford_circuits.py Outdated
Comment thread qiskit/quantum_info/operators/symplectic/clifford_circuits.py Outdated
Comment thread qiskit/quantum_info/operators/symplectic/clifford.py
Comment thread qiskit/quantum_info/operators/symplectic/clifford.py Outdated
return self.to_circuit().to_gate()

@staticmethod
def from_instruction(instruction):
Copy link
Copy Markdown
Member

@ajavadia ajavadia Apr 1, 2020

Choose a reason for hiding this comment

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

I'd call this from_circuit to be consistent with (future!) plans to unify things under the banner of circuits.

Copy link
Copy Markdown
Member

@ajavadia ajavadia Apr 1, 2020

Choose a reason for hiding this comment

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

also there are probably other instances of this function in other parts of quantum_info. they should all just talk about converting to/from that object and circuits. One side is simulation and the other is synthesis.

Copy link
Copy Markdown
Member Author

@chriseclectic chriseclectic Apr 1, 2020 •
edited
Loading

Choose a reason for hiding this comment

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

Most of the operators / states have a from instruction that I could change to from_circuit. Will have to add deprecation warnings to from_instruction for Statevector and DensityMatrix. It might be easier to change them all in a single PR after this is merged.

ajavadia
ajavadia approved these changes Apr 2, 2020
View reviewed changes
Copy link
Copy Markdown
Member

@ajavadia ajavadia left a comment

Choose a reason for hiding this comment

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

thanks for addressing the comments, looks good

@ajavadia ajavadia merged commit 48e3699 into Qiskit:master Apr 2, 2020
@chriseclectic chriseclectic added the Changelog: Added Add an "Added" entry in the GitHub Release changelog. label Apr 2, 2020
@chriseclectic chriseclectic deleted the symplectic/clifford branch April 15, 2020 14:49
This was referenced Apr 19, 2020
Closed
Closed
faisaldebouni pushed a commit to faisaldebouni/qiskit-terra that referenced this pull request Aug 5, 2020
@chriseclectic @sethmerkel @ShellyGarion
Add Clifford operator class (Qiskit#3938)
968259d 
* Add Clifford operator class

* Add compose, tensor, expand, and is_unitary

Co-Authored-By: Christopher J. Wood <cjwood@us.ibm.com>

* Add tests

* 1 and two qubit clifford gates
* compose, dot, tensor, expand, conjugate, transopse, is_unitary, to_operator

Co-Authored-By: Christopher J. Wood <cjwood@us.ibm.com>
Co-Authored-By: Shelly Garion <shellygarion@users.noreply.github.com>

* Add clifford conversion methods based on circuit decomposition

* Added `to_circuit` method
* Added `to_gate` method
* Added `to_matrix` method
* Added `to_operator`

* Rename files and fix bugs

test_clifford_gates -> test_clifford
clifford_append_gate -> clifford_circuits
Fix n_qubits -> num_qubits
Fix tensor order bug
Fix append 2-qubit gate tests
Speed up compose
Fix qubit order issue with subsystem compose
Add check that table is valid on clifford __init__

* Add adjoint and conjugate

* add tests for compose and dot of subsystems, and for to_circuit

* Add Clifford class docs and reno

* Linting and doc fox

* Review comments

* Add tests for to_matrix, to_instruction

* Add to_dict/from_dict tests

* Add underscore to private clifford funcs

* Rename `append_gate` to `_append_circuit`

* Rename from_instruction to from_circuit

* lint

* move decompose_clifford  to synethsis

Co-authored-by: sethmerkel <49210444+sethmerkel@users.noreply.github.com>
Co-authored-by: Shelly Garion <46566946+ShellyGarion@users.noreply.github.com>
Co-authored-by: Shelly Garion <shellygarion@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@ajavadia ajavadia ajavadia approved these changes

@ShellyGarion ShellyGarion ShellyGarion left review comments

@1ucian0 1ucian0 Awaiting requested review from 1ucian0

@ewinston ewinston Awaiting requested review from ewinston

@kdk kdk Awaiting requested review from kdk

@mtreinish mtreinish Awaiting requested review from mtreinish

Assignees

@ShellyGarion ShellyGarion

Labels

Changelog: Added Add an "Added" entry in the GitHub Release changelog.

Projects

None yet

Milestone

0.13

Development

Successfully merging this pull request may close these issues.

4 participants

@chriseclectic @ShellyGarion @ajavadia @sethmerkel