sia-script 0.8.3__tar.gz → 0.8.4__tar.gz

{sia_script-0.8.3/sia_script.egg-info → sia_script-0.8.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sia-script
-Version: 0.8.3
+Version: 0.8.4
 Summary: SIA — Simplified Integrated Architecture: SiaNTT, SIA-ELS (ABAP interpreter), the HDQS server client, and hdqs_engine (offline statevector quantum simulator — no server or API token required)
 Author-email: Sia Software Innovations Private Limited <info@siasoftwareinnovations.com>
 License: # PROPRIETARY SOFTWARE LICENSE

{sia_script-0.8.3 → sia_script-0.8.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sia-script"
-version = "0.8.3"
+version = "0.8.4"
 description = "SIA — Simplified Integrated Architecture: SiaNTT, SIA-ELS (ABAP interpreter), the HDQS server client, and hdqs_engine (offline statevector quantum simulator — no server or API token required)"
 authors = [
     { name = "Sia Software Innovations Private Limited", email = "info@siasoftwareinnovations.com" }

{sia_script-0.8.3 → sia_script-0.8.4}/sia/__init__.py

@@ -174,6 +174,7 @@ try:
         random_state,
         partial_trace,  # Partial trace utility
         to_numpy,       # backend array -> numpy (works without PyTorch)
+        to_tensor,      # numpy/list -> torch tensor on a given device
         is_tensor,
 
         # Noise channel factories (CPTP-verified as of engine v0.4.0)

{sia_script-0.8.3 → sia_script-0.8.4}/sia/hdqs_engine.py

@@ -1259,6 +1259,83 @@ class HDQS:
         return (f"HDQS(num_qubits={self.num_qubits}, mode={mode}, "
                 f"backend={self.backend}, device={self._device})")
 
+    # -- display helpers ------------------------------------------------------
+
+    @staticmethod
+    def fmt_amp(a: complex, tol: float = 1e-10) -> str:
+        """Format one complex amplitude in physics notation a+bi
+        (not Python's a+bj).
+
+        Examples
+        --------
+        >>> HDQS.fmt_amp(0.707107+0j)         '0.707107'
+        >>> HDQS.fmt_amp(0+0.707107j)         '0.707107i'
+        >>> HDQS.fmt_amp(0.5+0.5j)            '0.5000+0.5000i'
+        >>> HDQS.fmt_amp(-0.5+0.5j)           '-0.5000+0.5000i'
+        """
+        r, i = float(a.real), float(a.imag)
+        r_zero = abs(r) < tol
+        i_zero = abs(i) < tol
+        if r_zero and i_zero:
+            return "0"
+        if i_zero:
+            return f"{r:.6g}"
+        if r_zero:
+            return f"{i:.6g}i"
+        sign = "+" if i >= 0 else "-"
+        return f"{r:.6g}{sign}{abs(i):.6g}i"
+
+    def show_state(self, label: Optional[str] = None,
+                   tol: float = 1e-9, show_zeros: bool = False) -> "HDQS":
+        """Print the statevector as a State | Amplitude | Probability table.
+
+        Amplitudes are in physics notation a+bi (not Python's a+bj).
+        Returns self so it can be inserted into a gate chain without
+        interrupting it.
+
+        Args:
+            label:      heading printed above the table (default: repr(self)).
+            tol:        amplitudes with |a| < tol are treated as zero and
+                        omitted unless show_zeros=True.
+            show_zeros: if True, include all basis states even when P=0.
+
+        Examples
+        --------
+        >>> HDQS(1).h(0).show_state("H|0⟩")
+        H|0⟩
+        State    Amplitude           Prob
+        ────────────────────────────────
+        |0⟩      0.707+0.000i       50.0%
+        |1⟩      0.707+0.000i       50.0%
+
+        >>> HDQS(1).h(0).s(0).show_state("S|+⟩")
+        S|+⟩
+        State    Amplitude           Prob
+        ────────────────────────────────
+        |0⟩      0.707+0.000i       50.0%
+        |1⟩      0.000+0.707i       50.0%
+        """
+        if label is None:
+            label = repr(self)
+        sv = self.state
+        if sv is None:
+            print(f"{label}\n[mixed state — show_state requires a pure state]\n")
+            return self
+        sv_np = to_numpy(sv)
+        n = self.num_qubits
+        print(label)
+        print(f"{'State':<8} {'Amplitude':>18} {'Prob':>8}")
+        print("─" * 37)
+        for idx, a in enumerate(sv_np):
+            prob = abs(a) ** 2
+            if prob < tol ** 2 and not show_zeros:
+                continue
+            ket = f"|{idx:0{n}b}⟩"
+            amp = f"{a.real:.3f}{a.imag:+.3f}i"
+            print(f"{ket:<8} {amp:>18} {prob*100:>7.1f}%")
+        print()
+        return self
+
 
 StatevectorEngine = HDQS  # legacy alias
 
@@ -2022,6 +2099,7 @@ __all__ = [
     "qaoa_maxcut", "qaoa_state", "maxcut_expectation",
     # Protocols
     "bb84", "e91", "qss",
+    # (fmt_amp and show_state are methods on HDQS — access as HDQS.fmt_amp / q.show_state)
     # PyTorch (optional)
     "QuantumLayer",
     # Backend flags

{sia_script-0.8.3 → sia_script-0.8.4/sia_script.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sia-script
-Version: 0.8.3
+Version: 0.8.4
 Summary: SIA — Simplified Integrated Architecture: SiaNTT, SIA-ELS (ABAP interpreter), the HDQS server client, and hdqs_engine (offline statevector quantum simulator — no server or API token required)
 Author-email: Sia Software Innovations Private Limited <info@siasoftwareinnovations.com>
 License: # PROPRIETARY SOFTWARE LICENSE