pyqrack-cpu 1.67.0__py3-none-macosx_13_0_x86_64.whl → 1.68.0__py3-none-macosx_13_0_x86_64.whl

pyqrack/qrack_simulator.py

@@ -2132,9 +2132,7 @@ class QrackSimulator:
     def decompose(self, q):
         """Decompose system
 
-        Decompose the given qubit out of the system.
-        Warning: The qubit subsystem state must be separable, or the behavior
-        of this method is undefined.
+        Factorize a set of contiguous bits with minimal fidelity loss.
 
         Args:
             q: qubit id
@@ -2144,7 +2142,7 @@ class QrackSimulator:
             RuntimeError: QrackSimulator with isTensorNetwork=True option cannot decompose()! (Turn off just this option, in the constructor.)
 
         Returns:
-            State of the systems.
+            Decomposed subsystem simulator.
         """
         if self.is_tensor_network:
             raise RuntimeError(
@@ -2161,10 +2159,8 @@ class QrackSimulator:
     def dispose(self, q):
         """Dispose qubits
 
-        Minimally decompose a set of contiguous bits from the separably
-        composed unit, and discard the separable bits.
-        Warning: The qubit subsystem state must be separable, or the behavior
-        of this method is undefined.
+        Factorize a set of contiguous bits with minimal fidelity loss,
+        and discard the separable bits.
 
         Args:
             q: qubit
@@ -2172,9 +2168,6 @@ class QrackSimulator:
         Raises:
             RuntimeError: QrackSimulator raised an exception.
             RuntimeError: QrackSimulator with isTensorNetwork=True option cannot dispose()! (Turn off just this option, in the constructor.)
-
-        Returns:
-            State of the systems.
         """
         if self.is_tensor_network:
             raise RuntimeError(
@@ -2334,6 +2327,30 @@ class QrackSimulator:
             r |= _r[w]
         return r
 
+    def highest_n_prob_perm(self, n):
+        """Get the top n permutations (bit strings) with the highest probability
+
+        Returns the top n highest-probability bit strings in the Hilbert space
+
+        Raises:
+            RuntimeError: QrackSimulator raised an exception.
+
+        Returns:
+            Top n highest probability dimension indices
+        """
+        num_q = self.num_qubits()
+        num_words = (num_q + 63) // 64
+        _r = (ctypes.c_ulonglong * (num_words * n))()
+        Qrack.qrack_lib.HighestProbAllN(self.sid, n, _r)
+        self._throw_if_error()
+        r = [0] * n
+        for i in range(n):
+            r[i] = 0
+            for w in range(num_words):
+                r[i] <<= 64
+                r[i] |= _r[(i * num_words) + w]
+        return r
+
     def prob_all(self, q):
         """Probabilities of all subset permutations
 

pyqrack/qrack_system/qrack_system.py

@@ -161,6 +161,9 @@ class QrackSystem:
         self.qrack_lib.HighestProbAll.restype = None
         self.qrack_lib.HighestProbAll.argtypes = [c_ulonglong, POINTER(c_ulonglong)]
 
+        self.qrack_lib.HighestProbAllN.restype = None
+        self.qrack_lib.HighestProbAllN.argtypes = [c_ulonglong, c_ulonglong, POINTER(c_ulonglong)]
+
         self.qrack_lib.ProbAll.restype = None
         if self.fppow == 5:
             self.qrack_lib.ProbAll.argtypes = [

{pyqrack_cpu-1.67.0.dist-info → pyqrack_cpu-1.68.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pyqrack-cpu
-Version: 1.67.0
+Version: 1.68.0
 Summary: pyqrack - Pure Python vm6502q/qrack Wrapper
 Home-page: https://github.com/vm6502q/pyqrack
 Author: Daniel Strano

{pyqrack_cpu-1.67.0.dist-info → pyqrack_cpu-1.68.0.dist-info}/RECORD

@@ -5,19 +5,19 @@ pyqrack/qrack_ace_backend.py,sha256=Prw1NhVVt0csbHiJeW8MJI9rl1P1YS63sXM5quoNPrI,
 pyqrack/qrack_circuit.py,sha256=vDCKGbcEHJDFUKprjCpWgit8lXFnMrPimKHURD2_Hj4,19538
 pyqrack/qrack_neuron.py,sha256=UiJdjAGB6usjAGHWSosSFCUUeIkhh3MtZbsaxfsIsNw,9043
 pyqrack/qrack_neuron_torch_layer.py,sha256=Bs5BLC2GFevfSpo_jSJ2AZl-hfDRJmzlGN9pFw1CtoQ,6160
-pyqrack/qrack_simulator.py,sha256=EoYBDgonRy9jYSTUVyBWXGnvvT2sOiwNX9KfJo1YRHQ,145471
+pyqrack/qrack_simulator.py,sha256=Ji1djQcZ6AFk5K3H6Y6TKQ6DNjnOh0XoClwlPYm2j90,145981
 pyqrack/qrack_stabilizer.py,sha256=O-7VJ9Vw4h25PK_kesSjIqHXGSo8lLrQLIyGgmzG7Co,2124
 pyqrack/quimb_circuit_type.py,sha256=Sk-Tmn38kUYmAkJJ75btWuhYZyTXOOezmowFhfdiGDc,621
 pyqrack/qrack_system/__init__.py,sha256=-oZ9dsb1hixsnrkUJRY_C5DzQ_l6MtifF_Z465BgqV4,334
-pyqrack/qrack_system/qrack_system.py,sha256=7Vluae5m-PeVrn8eg8b_wibU7AMMo4lwntcTbi0wfBU,43530
+pyqrack/qrack_system/qrack_system.py,sha256=qWtnWAIUdTlz7xavsEj8krd_3cVv_36KHex5jn-6kKs,43684
 pyqrack/qrack_system/qrack_cl_precompile/qrack_cl_precompile,sha256=8xQYqoFTKIl-5v6ZkqmbWp14Eowkl8ty2vNF2shC5hU,35040
-pyqrack/qrack_system/qrack_lib/libqrack_pinvoke.9.26.0.dylib,sha256=2bXnkRTahWbxvnElZVk3Unqa0rpIVod6wbl9LsiBVjI,3187952
-pyqrack/qrack_system/qrack_lib/libqrack_pinvoke.dylib,sha256=2bXnkRTahWbxvnElZVk3Unqa0rpIVod6wbl9LsiBVjI,3187952
+pyqrack/qrack_system/qrack_lib/libqrack_pinvoke.9.27.0.dylib,sha256=OZmauubMX0Kqt9Lp0A0E49MZjjbztzkw3myVqc76Pvg,3188872
+pyqrack/qrack_system/qrack_lib/libqrack_pinvoke.dylib,sha256=OZmauubMX0Kqt9Lp0A0E49MZjjbztzkw3myVqc76Pvg,3188872
 pyqrack/stats/__init__.py,sha256=Hla85my2fY_roR9lIjGBVpEG7ySOTMwjWa8D6-kgCnY,276
 pyqrack/stats/load_quantized_data.py,sha256=z12u9F7Nt3P-i44nY1xxvso_klS6WIHS3iqq7R2_lqE,1184
 pyqrack/stats/quantize_by_range.py,sha256=UM0_7jJDdQ7g30cR3UQAxkbzkqrmsy1oUfqg0h11FUY,2270
-pyqrack_cpu-1.67.0.dist-info/LICENSE,sha256=HxB-7SaWTuewAk1nz-3_3FUD6QhgX73kNT_taKVUTq8,1069
-pyqrack_cpu-1.67.0.dist-info/METADATA,sha256=aZdJ5zIjlJHt7nn4QnAOyI6PaB8_sRCjx9RjwiPN1Ds,5951
-pyqrack_cpu-1.67.0.dist-info/WHEEL,sha256=nZx8s83OrgdDmpcWX-8FgI0sEAjdQimt4SdYsdcCaC8,107
-pyqrack_cpu-1.67.0.dist-info/top_level.txt,sha256=YE_3q9JTGRLMilNg2tGP1y7uU-Dx8PDao2OhwoIbv8E,8
-pyqrack_cpu-1.67.0.dist-info/RECORD,,
+pyqrack_cpu-1.68.0.dist-info/LICENSE,sha256=HxB-7SaWTuewAk1nz-3_3FUD6QhgX73kNT_taKVUTq8,1069
+pyqrack_cpu-1.68.0.dist-info/METADATA,sha256=tNL45jTt-xMrtouv1z5hm6FKAzCZ1Nn4e_nGdnxPMKs,5951
+pyqrack_cpu-1.68.0.dist-info/WHEEL,sha256=nZx8s83OrgdDmpcWX-8FgI0sEAjdQimt4SdYsdcCaC8,107
+pyqrack_cpu-1.68.0.dist-info/top_level.txt,sha256=YE_3q9JTGRLMilNg2tGP1y7uU-Dx8PDao2OhwoIbv8E,8
+pyqrack_cpu-1.68.0.dist-info/RECORD,,