qubasic 0.6.4__tar.gz → 0.7.0__tar.gz

{qubasic-0.6.4 → qubasic-0.7.0}/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.7.0 (2026-06-19)
+
+### Added
+- Dynamic circuits in the standard Aer path: `MEAS q -> c` is a real mid-circuit measurement and `IF c THEN <gate>` (also `IF c == 0`, `NOT c`, and `ELSE`) compiles to a Qiskit `if_test`, so feedforward corrections run on the actual outcome without LOCC mode. The mid-circuit measurement registers are kept out of the reported histogram.
+- Algorithm primitives applied to a qubit range: `QFT`/`IQFT`, `DIFFUSE` (Grover diffusion), `MCX`/`MCZ`/`MCP` (arbitrary control count), `QADD`/`QADDC` (in-place register and constant addition mod 2^n), and `QPE` (phase estimation of a UNITARY). The QFT is least-significant-first (qubit 0 = low bit) so register reads are consistent.
+- Optimization drivers: `MINIMIZE v1, v2 -> <cost expr>` runs a dependency-free Nelder-Mead optimizer over circuit parameters (VQE/QAOA), and `GRADIENT` computes the parameter-shift gradient. The cost is any expression evaluated after each run from variables the program sets (for example via `SAVE_EXPECT`).
+- Device model for transpilation: `COUPLING linear|ring|full|<edges>` constrains two-qubit connectivity and `BASIS <gates>` restricts to a native gate set, both offline; RUN reports the routed depth and SWAP count.
+- `FIDELITY <target>` (state fidelity against a named state or amplitude list) and `TOMOGRAPHY [shots]` (density-matrix reconstruction from Pauli expectations, exact or shot-sampled).
+- `LOADQASM <file>` imports OpenQASM as an editable program (2.0 built-in; 3.0 requires the optional `qiskit_qasm3_import` package).
+- `SET_DENSITY [[...]]` injects a mixed state (density matrix) for the next run, using the density_matrix method.
+- `SAVEPNG <file> hist|bloch|circuit` saves a plot as a PNG (requires matplotlib; circuit diagrams also need pylatexenc).
+
+## 0.6.5 (2026-06-19)
+
+### Fixed
+- The Bloch sphere Y component had an inverted sign, so a qubit in |+i> was reported at -Y (and |-i> at +Y). `BLOCH`, `DRAW`, `PRINT QUBIT(n)`, and the memory-mapped Bloch-Y field (`$0100 + q*8 + 2`) were all affected, and `BLOCH` mislabeled |+i> as "|-i>". X and Z were already correct. Y now matches the standard convention (`<Y> = +2 Im(<1|rho|0>)`), verified against Qiskit expectation values.
+
 ## 0.6.4 (2026-06-19)
 
 ### Fixed

{qubasic-0.6.4/qubasic.egg-info → qubasic-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qubasic
-Version: 0.6.4
+Version: 0.7.0
 Summary: Quantum BASIC Interactive Terminal
 Author-email: "Charles C. Norton" <machineelv@gmail.com>
 License-Expression: MIT
@@ -417,6 +417,80 @@ STATS SHOW               Show mean/stddev/min/max per state
 STATS CLEAR              Reset accumulator
 ```
 
+### State comparison
+```
+FIDELITY |BELL>          State fidelity |<target|psi>|^2 vs a named state
+FIDELITY [0.707,0,0,0.707]   ...or an explicit amplitude list
+TOMOGRAPHY               Reconstruct the density matrix from Pauli expectations
+TOMOGRAPHY 2000          Statistical tomography (2000 shots per Pauli basis)
+```
+
+## Algorithm primitives
+
+Composable building blocks applied to a qubit range (`lo-hi`, a list, or all
+qubits). Qiskit-path only.
+
+```
+QFT 0-3                  Quantum Fourier transform over qubits 0..3
+IQFT 0-3                 Inverse QFT
+DIFFUSE 0-2              Grover diffusion operator (2|s><s| - I)
+MCX 0,1,2, 3             Multi-controlled X (any number of controls, last = target)
+MCZ 0,1,2                Multi-controlled Z
+MCP theta, 0,1, 2        Multi-controlled phase
+QADD 0-2, 3-5            In-place register add: A += B (mod 2^n), qubit 0 = LSB
+QADDC 5, 0-2             In-place constant add: A += 5 (mod 2^n)
+QPE 0-3 4 UGATE          Phase estimation of a UNITARY on a target register
+```
+
+## Optimization
+
+Classical drivers over circuit parameters (VQE/QAOA). Build a parametrized
+ansatz, compute a cost with `SAVE_EXPECT`, then minimize it.
+
+```
+10 RY theta, 0
+20 SAVE_EXPECT Z 0 -> cost
+MINIMIZE theta -> cost              Nelder-Mead minimization (dependency-free)
+MINIMIZE a, b -> z0 + 0.5*z1 ITERS 200   Multi-parameter; cost is any post-run expression
+GRADIENT theta -> cost             Parameter-shift gradient d(cost)/d(theta)
+```
+
+## Dynamic circuits (feedforward)
+
+In standard mode, `MEAS` is a real mid-circuit measurement and `IF` on the
+measured bit compiles to a Qiskit `if_test`, so the conditional gate runs at
+simulation time based on the actual outcome (no LOCC mode needed).
+
+```
+10 H 0
+20 MEAS 0 -> c           Mid-circuit measurement into classical bit c
+30 IF c THEN X 0         Feedforward correction (also: IF c == 0, NOT c, with ELSE)
+40 MEASURE
+```
+
+## Mixed states
+
+```
+SET_DENSITY [[0.5,0],[0,0.5]]    Inject a density matrix (uses density_matrix method)
+```
+
+## Device model
+
+Constrain transpilation to a hardware topology and native gate set, fully
+offline. After RUN, the routed depth and SWAP count are reported.
+
+```
+COUPLING linear          1D chain connectivity (also: ring, full, OFF, or 0-1, 1-2, ...)
+BASIS rz, sx, x, cx      Restrict to a native gate set (BASIS OFF to clear)
+```
+
+## Import and images
+
+```
+LOADQASM file.qasm       Import OpenQASM as an editable program (2.0 built-in; 3.0 needs qiskit_qasm3_import)
+SAVEPNG out.png hist     Save the histogram as a PNG (also: bloch, circuit; needs matplotlib)
+```
+
 ## Noise models
 
 ```

{qubasic-0.6.4 → qubasic-0.7.0}/README.md

@@ -384,6 +384,80 @@ STATS SHOW               Show mean/stddev/min/max per state
 STATS CLEAR              Reset accumulator
 ```
 
+### State comparison
+```
+FIDELITY |BELL>          State fidelity |<target|psi>|^2 vs a named state
+FIDELITY [0.707,0,0,0.707]   ...or an explicit amplitude list
+TOMOGRAPHY               Reconstruct the density matrix from Pauli expectations
+TOMOGRAPHY 2000          Statistical tomography (2000 shots per Pauli basis)
+```
+
+## Algorithm primitives
+
+Composable building blocks applied to a qubit range (`lo-hi`, a list, or all
+qubits). Qiskit-path only.
+
+```
+QFT 0-3                  Quantum Fourier transform over qubits 0..3
+IQFT 0-3                 Inverse QFT
+DIFFUSE 0-2              Grover diffusion operator (2|s><s| - I)
+MCX 0,1,2, 3             Multi-controlled X (any number of controls, last = target)
+MCZ 0,1,2                Multi-controlled Z
+MCP theta, 0,1, 2        Multi-controlled phase
+QADD 0-2, 3-5            In-place register add: A += B (mod 2^n), qubit 0 = LSB
+QADDC 5, 0-2             In-place constant add: A += 5 (mod 2^n)
+QPE 0-3 4 UGATE          Phase estimation of a UNITARY on a target register
+```
+
+## Optimization
+
+Classical drivers over circuit parameters (VQE/QAOA). Build a parametrized
+ansatz, compute a cost with `SAVE_EXPECT`, then minimize it.
+
+```
+10 RY theta, 0
+20 SAVE_EXPECT Z 0 -> cost
+MINIMIZE theta -> cost              Nelder-Mead minimization (dependency-free)
+MINIMIZE a, b -> z0 + 0.5*z1 ITERS 200   Multi-parameter; cost is any post-run expression
+GRADIENT theta -> cost             Parameter-shift gradient d(cost)/d(theta)
+```
+
+## Dynamic circuits (feedforward)
+
+In standard mode, `MEAS` is a real mid-circuit measurement and `IF` on the
+measured bit compiles to a Qiskit `if_test`, so the conditional gate runs at
+simulation time based on the actual outcome (no LOCC mode needed).
+
+```
+10 H 0
+20 MEAS 0 -> c           Mid-circuit measurement into classical bit c
+30 IF c THEN X 0         Feedforward correction (also: IF c == 0, NOT c, with ELSE)
+40 MEASURE
+```
+
+## Mixed states
+
+```
+SET_DENSITY [[0.5,0],[0,0.5]]    Inject a density matrix (uses density_matrix method)
+```
+
+## Device model
+
+Constrain transpilation to a hardware topology and native gate set, fully
+offline. After RUN, the routed depth and SWAP count are reported.
+
+```
+COUPLING linear          1D chain connectivity (also: ring, full, OFF, or 0-1, 1-2, ...)
+BASIS rz, sx, x, cx      Restrict to a native gate set (BASIS OFF to clear)
+```
+
+## Import and images
+
+```
+LOADQASM file.qasm       Import OpenQASM as an editable program (2.0 built-in; 3.0 needs qiskit_qasm3_import)
+SAVEPNG out.png hist     Save the histogram as a PNG (also: bloch, circuit; needs matplotlib)
+```
+
 ## Noise models
 
 ```

{qubasic-0.6.4 → qubasic-0.7.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qubasic"
-version = "0.6.4"
+version = "0.7.0"
 description = "Quantum BASIC Interactive Terminal"
 readme = "README.md"
 requires-python = ">=3.10"

{qubasic-0.6.4 → qubasic-0.7.0/qubasic.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qubasic
-Version: 0.6.4
+Version: 0.7.0
 Summary: Quantum BASIC Interactive Terminal
 Author-email: "Charles C. Norton" <machineelv@gmail.com>
 License-Expression: MIT
@@ -417,6 +417,80 @@ STATS SHOW               Show mean/stddev/min/max per state
 STATS CLEAR              Reset accumulator
 ```
 
+### State comparison
+```
+FIDELITY |BELL>          State fidelity |<target|psi>|^2 vs a named state
+FIDELITY [0.707,0,0,0.707]   ...or an explicit amplitude list
+TOMOGRAPHY               Reconstruct the density matrix from Pauli expectations
+TOMOGRAPHY 2000          Statistical tomography (2000 shots per Pauli basis)
+```
+
+## Algorithm primitives
+
+Composable building blocks applied to a qubit range (`lo-hi`, a list, or all
+qubits). Qiskit-path only.
+
+```
+QFT 0-3                  Quantum Fourier transform over qubits 0..3
+IQFT 0-3                 Inverse QFT
+DIFFUSE 0-2              Grover diffusion operator (2|s><s| - I)
+MCX 0,1,2, 3             Multi-controlled X (any number of controls, last = target)
+MCZ 0,1,2                Multi-controlled Z
+MCP theta, 0,1, 2        Multi-controlled phase
+QADD 0-2, 3-5            In-place register add: A += B (mod 2^n), qubit 0 = LSB
+QADDC 5, 0-2             In-place constant add: A += 5 (mod 2^n)
+QPE 0-3 4 UGATE          Phase estimation of a UNITARY on a target register
+```
+
+## Optimization
+
+Classical drivers over circuit parameters (VQE/QAOA). Build a parametrized
+ansatz, compute a cost with `SAVE_EXPECT`, then minimize it.
+
+```
+10 RY theta, 0
+20 SAVE_EXPECT Z 0 -> cost
+MINIMIZE theta -> cost              Nelder-Mead minimization (dependency-free)
+MINIMIZE a, b -> z0 + 0.5*z1 ITERS 200   Multi-parameter; cost is any post-run expression
+GRADIENT theta -> cost             Parameter-shift gradient d(cost)/d(theta)
+```
+
+## Dynamic circuits (feedforward)
+
+In standard mode, `MEAS` is a real mid-circuit measurement and `IF` on the
+measured bit compiles to a Qiskit `if_test`, so the conditional gate runs at
+simulation time based on the actual outcome (no LOCC mode needed).
+
+```
+10 H 0
+20 MEAS 0 -> c           Mid-circuit measurement into classical bit c
+30 IF c THEN X 0         Feedforward correction (also: IF c == 0, NOT c, with ELSE)
+40 MEASURE
+```
+
+## Mixed states
+
+```
+SET_DENSITY [[0.5,0],[0,0.5]]    Inject a density matrix (uses density_matrix method)
+```
+
+## Device model
+
+Constrain transpilation to a hardware topology and native gate set, fully
+offline. After RUN, the routed depth and SWAP count are reported.
+
+```
+COUPLING linear          1D chain connectivity (also: ring, full, OFF, or 0-1, 1-2, ...)
+BASIS rz, sx, x, cx      Restrict to a native gate set (BASIS OFF to clear)
+```
+
+## Import and images
+
+```
+LOADQASM file.qasm       Import OpenQASM as an editable program (2.0 built-in; 3.0 needs qiskit_qasm3_import)
+SAVEPNG out.png hist     Save the histogram as a PNG (also: bloch, circuit; needs matplotlib)
+```
+
 ## Noise models
 
 ```

{qubasic-0.6.4 → qubasic-0.7.0}/qubasic.egg-info/SOURCES.txt

@@ -15,6 +15,7 @@ qubasic.egg-info/requires.txt
 qubasic.egg-info/top_level.txt
 qubasic_core/__init__.py
 qubasic_core/__main__.py
+qubasic_core/algorithms.py
 qubasic_core/analysis.py
 qubasic_core/backend.py
 qubasic_core/classic.py

{qubasic-0.6.4 → qubasic-0.7.0}/qubasic_core/__init__.py

@@ -28,7 +28,7 @@ __all__ = [
     'GATE_TABLE', 'GATE_ALIASES',
 ]
 
-__version__ = '0.6.4'
+__version__ = '0.7.0'
 
 def __getattr__(name):
     """Lazy import heavy modules on first access."""