qubasic 0.6.5__tar.gz → 0.8.0__tar.gz

{qubasic-0.6.5 → qubasic-0.8.0}/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.8.0 (2026-06-19)
+
+### Added
+- Partial measurement: `MEASURE 0, 2` measures a subset of qubits and reports the histogram over just those qubits (the bare `MEASURE` still measures all).
+- Process tomography: `PTOMOGRAPHY` reconstructs the circuit's Pauli Transfer Matrix (the unitary, or the full noisy channel via the superoperator when a noise model is active), and reports the trace-preserving and unital flags plus the average gate fidelity to the identity. Limited to <= 2 qubits.
+- Randomized benchmarking: `RB [max_length] [samples]` runs single-qubit RB over the 24-element Clifford group (each sequence ends with its recovery Clifford), fits the survival decay `p(m) = A f^m + B`, and reports the decay `f` and the error per Clifford `(1 - f)/2`. Reflects the active noise model.
+
+## 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

{qubasic-0.6.5/qubasic.egg-info → qubasic-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qubasic
-Version: 0.6.5
+Version: 0.8.0
 Summary: Quantum BASIC Interactive Terminal
 Author-email: "Charles C. Norton" <machineelv@gmail.com>
 License-Expression: MIT
@@ -417,6 +417,89 @@ STATS SHOW               Show mean/stddev/min/max per state
 STATS CLEAR              Reset accumulator
 ```
 
+### Characterization
+```
+FIDELITY |BELL>          State fidelity |<target|psi>|^2 vs a named state
+FIDELITY [0.707,0,0,0.707]   ...or an explicit amplitude list
+TOMOGRAPHY               State tomography: reconstruct rho from Pauli expectations
+TOMOGRAPHY 2000          Statistical tomography (2000 shots per Pauli basis)
+PTOMOGRAPHY              Process tomography: reconstruct the Pauli Transfer Matrix (<=2 qubits)
+RB                       Single-qubit randomized benchmarking (fits decay -> error/Clifford)
+RB 64 12                 Sequence lengths up to 64, 12 random sequences each
+```
+
+### Partial measurement
+```
+MEASURE                  Measure all qubits (the default)
+MEASURE 0, 2             Measure only qubits 0 and 2; histogram is over that subset
+```
+
+## 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.5 → qubasic-0.8.0}/README.md

@@ -384,6 +384,89 @@ STATS SHOW               Show mean/stddev/min/max per state
 STATS CLEAR              Reset accumulator
 ```
 
+### Characterization
+```
+FIDELITY |BELL>          State fidelity |<target|psi>|^2 vs a named state
+FIDELITY [0.707,0,0,0.707]   ...or an explicit amplitude list
+TOMOGRAPHY               State tomography: reconstruct rho from Pauli expectations
+TOMOGRAPHY 2000          Statistical tomography (2000 shots per Pauli basis)
+PTOMOGRAPHY              Process tomography: reconstruct the Pauli Transfer Matrix (<=2 qubits)
+RB                       Single-qubit randomized benchmarking (fits decay -> error/Clifford)
+RB 64 12                 Sequence lengths up to 64, 12 random sequences each
+```
+
+### Partial measurement
+```
+MEASURE                  Measure all qubits (the default)
+MEASURE 0, 2             Measure only qubits 0 and 2; histogram is over that subset
+```
+
+## 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.5 → qubasic-0.8.0}/pyproject.toml

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

{qubasic-0.6.5 → qubasic-0.8.0/qubasic.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qubasic
-Version: 0.6.5
+Version: 0.8.0
 Summary: Quantum BASIC Interactive Terminal
 Author-email: "Charles C. Norton" <machineelv@gmail.com>
 License-Expression: MIT
@@ -417,6 +417,89 @@ STATS SHOW               Show mean/stddev/min/max per state
 STATS CLEAR              Reset accumulator
 ```
 
+### Characterization
+```
+FIDELITY |BELL>          State fidelity |<target|psi>|^2 vs a named state
+FIDELITY [0.707,0,0,0.707]   ...or an explicit amplitude list
+TOMOGRAPHY               State tomography: reconstruct rho from Pauli expectations
+TOMOGRAPHY 2000          Statistical tomography (2000 shots per Pauli basis)
+PTOMOGRAPHY              Process tomography: reconstruct the Pauli Transfer Matrix (<=2 qubits)
+RB                       Single-qubit randomized benchmarking (fits decay -> error/Clifford)
+RB 64 12                 Sequence lengths up to 64, 12 random sequences each
+```
+
+### Partial measurement
+```
+MEASURE                  Measure all qubits (the default)
+MEASURE 0, 2             Measure only qubits 0 and 2; histogram is over that subset
+```
+
+## 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.5 → qubasic-0.8.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.5 → qubasic-0.8.0}/qubasic_core/__init__.py

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