zena-sdk 0.1.4__cp38-abi3-win_amd64.whl

zena/providers/aer.py

@@ -0,0 +1,71 @@
+"""
+Aer Provider for local simulation.
+"""
+from .backend import Backend
+from .job import Job, Result
+import uuid
+
+# Import the internal execution logic from qsys
+try:
+    from qsys.runtime.execute import execute as qsys_execute
+except ImportError:
+    qsys_execute = None
+
+class StatevectorSimulator(Backend):
+    """Local statevector simulator backend."""
+    
+    @property
+    def name(self):
+        return "statevector_simulator"
+        
+    @property
+    def target(self):
+        """Return a default target for the simulator."""
+        try:
+            from qsys.backends.base import Target
+            # Simulator typically has all-to-all connectivity and standard basis
+            return Target(
+                n_qubits=32, # Theoretical limit for 8GB RAM approx
+                basis_gates={"x", "sx", "rz", "cx", "measure", "h", "y", "z", "s", "sdg", "t", "tdg", "rx", "ry", "swap"},
+                coupling_map=[] # Empty list often means all-to-all in these engines, or we can generate it
+            )
+        except ImportError:
+            return None
+        
+    def run(self, circuit, shots=1024, **kwargs):
+        """Run the circuit using qsys."""
+        if not qsys_execute:
+             raise ImportError("qsys.runtime.execute not available. Cannot run simulation.")
+             
+        # Extract the core qsys circuit
+        if not hasattr(circuit, "_core_circuit") or not circuit._core_circuit:
+             raise ValueError("Circuit has no underlying qsys circuit.")
+             
+        core_qc = circuit._core_circuit
+        
+        # Execute using qsys
+        # qsys.execute returns a dict with 'counts', 'statevector', etc.
+        # We disable the internal qsys transpiler for now to avoid 'backend.target' errors
+        # since we are not yet passing a formal qsys.Backend object.
+        res_data = qsys_execute(core_qc, shots=shots, use_transpiler=False)
+        
+        # Wrap in Result and Job
+        result = Result(res_data)
+        job_id = str(uuid.uuid4())
+        return Job(self, job_id, result)
+
+class AerProvider:
+    """Provider for Aer backends."""
+    
+    def __init__(self):
+        self._backends = {
+            "statevector_simulator": StatevectorSimulator()
+        }
+        
+    def get_backend(self, name="statevector_simulator"):
+        if name not in self._backends:
+            raise ValueError(f"Backend '{name}' not found.")
+        return self._backends[name]
+
+# Global instance
+Aer = AerProvider()

zena/providers/backend.py

@@ -0,0 +1,18 @@
+"""
+Base Backend Class.
+"""
+from abc import ABC, abstractmethod
+
+class Backend(ABC):
+    """Abstract base class for backends."""
+    
+    @abstractmethod
+    def run(self, circuit, shots=1024, **kwargs):
+        """Run a circuit on the backend."""
+        pass
+    
+    @property
+    @abstractmethod
+    def name(self):
+        """Backend name."""
+        pass

zena/providers/job.py

@@ -0,0 +1,24 @@
+"""
+Job Class to handle execution status and results.
+"""
+class Job:
+    def __init__(self, backend, job_id, result=None):
+        self._backend = backend
+        self._job_id = job_id
+        self._result = result
+        
+    def result(self):
+        """Return the result of the job."""
+        return self._result
+        
+class Result:
+    def __init__(self, backend_result_dict):
+        self._data = backend_result_dict
+        
+    def get_counts(self):
+        """Return counts from the result."""
+        return self._data.get("counts", {})
+        
+    def get_statevector(self):
+        """Return statevector from the result."""
+        return self._data.get("statevector", [])

zena/visualization/__init__.py

@@ -0,0 +1,28 @@
+def plot_histogram(data, title=None):
+    """
+    Plot a histogram of counts.
+    
+    Args:
+        data (dict): Counts dictionary (e.g., {'00': 500, '11': 500})
+        title (str): Optional title for the plot.
+    """
+    if title:
+        print(f"\n--- {title} ---")
+    else:
+        print("\n--- Histogram ---")
+        
+    if not data:
+        print("Empty data.")
+        return
+
+    max_val = max(data.values())
+    total = sum(data.values())
+    
+    # Sort keys for consistent display
+    for key in sorted(data.keys()):
+        val = data[key]
+        percentage = (val / total) * 100
+        bar_length = int((val / max_val) * 20)
+        bar = "█" * bar_length
+        print(f"{key:5s} | {bar:<20} | {val:4d} ({percentage:>5.1f}%)")
+    print("-" * 45)

zena_sdk-0.1.4.dist-info/METADATA

@@ -0,0 +1,70 @@
+Metadata-Version: 2.4
+Name: zena-sdk
+Version: 0.1.4
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Dist: numpy>=1.20
+Summary: A high-level Python SDK for the Zena Quantum Simulator, including core Rust engine.
+Author-email: Zena Team <info@zena.quantum>
+License: Apache-2.0
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+
+# Zena SDK
+
+**Zena SDK** is a high-level Python library for creating and simulating quantum circuits, designed with a familiar API for users of Qiskit. It serves as the user-facing layer for the powerful Zena Quantum Simulator engine.
+
+## Installation
+
+```bash
+pip install zena-sdk
+```
+
+*(Note: Requires valid `qsys` and `simulator_statevector` backend installations)*
+
+## Basic Usage
+
+Zena SDK allows you to build circuits using `QuantumRegister`, `ClassicalRegister`, and `QuantumCircuit` in a way that feels completely natural.
+
+```python
+from zena import QuantumCircuit, execute, Aer
+
+# 1. Create a Quantum Circuit
+qc = QuantumCircuit(2, 2)
+qc.h(0)
+qc.cx(0, 1)
+qc.measure([0, 1], [0, 1])
+
+# 2. visualizae
+print(qc.draw())
+
+# 3. Choose a Backend
+backend = Aer.get_backend('statevector_simulator')
+
+# 4. Execute
+job = execute(qc, backend, shots=1024)
+result = job.result()
+
+# 5. Get Results
+print("Counts:", result.get_counts())
+```
+
+## Features
+
+- **Familiar API**: Drop-in conceptual replacement for basic Qiskit circuits.
+- **High Performance**: Powered by a Rust-based statevector simulator.
+- **Visualizations**: Built-in methods for circuit drawing and result plotting.
+- **Extensible**: Modular architecture allowing for future backend plugins.
+
+## Architecture
+
+Zena SDK (`zena`) sits on top of the Core Engine (`qsys`).
+
+- **Base Layer**: `qsys` (Intermediate Representation & Composer)
+- **Simulation Layer**: `simulator_statevector` (Rust-based capabilities)
+- **User Layer**: `zena` (High-level Circuit & Provider API)
+

zena_sdk-0.1.4.dist-info/RECORD

@@ -0,0 +1,76 @@
+qsys\__init__.py,sha256=Q8yVST9Ov7MJiIYOxpNoTLYg9IZoisuadosaM4mgZ28,698
+qsys\__pycache__\__init__.cpython-313.pyc,sha256=xskCS2TiRCQgx6U4SOzFRUZu8-Wq5nCHUY6NytsxMZg,889
+qsys\backends\base.py,sha256=6gnUHBXGIADGRFRzQXT1MSYs_IS-7BrhmUvrzHA3w3k,1017
+qsys\backends\local5q.py,sha256=oFME6sErOOjiHkQ3nN4zG4S3H05XK4JF69RnTyrcIJY,284
+qsys\circuit\__init__.py,sha256=TCOP6J2PgFXEbRFDRQUAD5lKP0Y2yW3GbTBT8fPKvU4,505
+qsys\circuit\__pycache__\__init__.cpython-313.pyc,sha256=OZK4IsPHo2NlgstYdj1T0A5fSitBk_8FtkeX5HpBErI,421
+qsys\circuit\__pycache__\quantum_circuit.cpython-313.pyc,sha256=2K6CVIjd79rNnr9roghGxznmAAWSq41jkAIQZQCODHY,5575
+qsys\circuit\quantum_circuit.py,sha256=-KfDygGkHzNce0qv42AuDxXyO-Sme1OUeal5aqRiHaA,4017
+qsys\cli\__init__.py,sha256=y_HHgHnDAi_oBmHJgRwVFEZHr3J_uR6vbUFr6D05twE,45
+qsys\cli\io_cli.py,sha256=bprn2Oqawkamu0glb-8NOds0f7fwKLk_9r0x579rSoY,1168
+qsys\errors\__init__.py,sha256=1mGayUVji7TG6sl_I8iI4OifDOrwvXtVx8htVcmqrnQ,530
+qsys\errors\__pycache__\__init__.cpython-313.pyc,sha256=w3YiS4JCkvf0iJjr0kDoBA8ko9oDOxZ8xcDuwSoph2k,1384
+qsys\io\__init__.py,sha256=R-8apoTeewML6-fuGVu1CAUYJEESKK9GfBacSJV2Vk4,753
+qsys\io\json_io.py,sha256=RQqNHDMQPueovJPBuADHULRcA6mS1w4vfIVRnlnXm4M,2786
+qsys\io\text_io.py,sha256=uxH_I8G_4Z7ih1vp2Xj-O8qzM-PlRfNbL19rTQGFz7I,2330
+qsys\ir\__init__.py,sha256=Sb-7WnlilyjGbvuqjVh4YXFvJRDorLHAUOq8F9SuO5o,13
+qsys\ir\__pycache__\__init__.cpython-313.pyc,sha256=BfnKq-GWCg-SZ2_-yzIuxBiHTqpI22BNQdgya11H1k0,174
+qsys\ir\__pycache__\types.cpython-313.pyc,sha256=Wf7YP-9kDj31iCTZHTuhSc-PsMfm9gUK-iKj6mdBS-8,728
+qsys\ir\from_payload.py,sha256=jQuj7EnrJ23ShjRlvTiKPDDpf0KpxqXvD5K_VBJ5IMU,863
+qsys\ir\types.py,sha256=2EwKGhHAitUDMvD8uRIz8kgHXWfBMFa_w7vQZC1M_Tg,253
+qsys\logging.py,sha256=SvShsBSUI1yQaenGXvMN7x9nievG4Oyiz9zD9rkqzfU,405
+qsys\runtime\__init__.py,sha256=via8B-K-M_rByn58t_ZE-og_WnQvkOq8SbgQKCrjccE,127
+qsys\runtime\__pycache__\__init__.cpython-313.pyc,sha256=6EW6OsMIrziybVGBZx-rYXufYECVOlNy-4_Bkq1j9Hg,282
+qsys\runtime\__pycache__\execute.cpython-313.pyc,sha256=4EDGp42dEe0YGDOw-RkAQVJ19Y_l08w034pDNXIkDPo,5644
+qsys\runtime\execute.py,sha256=5tr4f7i4Sl8KAbwZCfmlQqXmqXk9yah8N0cnZiQtUO4,5622
+qsys\target.py,sha256=iEQ0gNeMDNgR8mRIcghnmDTQE8xsDNyJhc9NM-qQOKc,1488
+qsys\targets.py,sha256=wsVx0ifXeiJBpwXlZ3c0a3dIfHtrGuHEw8BsYrstQ2o,1416
+qsys\transpiler\__init__.py,sha256=yV3OqTd_eHXVeNETCr3f7Dj2nPleLKeeybqf2pjGvic,281
+qsys\transpiler\basis.py,sha256=NcMA-QbFgNV9FOUjIfmEGVq7LydChUXKQxvyZhdIEgc,1311
+qsys\transpiler\opt1q.py,sha256=Hv6NwvNIinWsprjjzW_9YSNAS67tGYANNVTof8mo8y0,3465
+qsys\transpiler\passes.py,sha256=DXWTeA4Wmp-Ock2WPs23_uJTfiPJB1zkgfgcWxMTzrA,1761
+qsys\transpiler\routing.py,sha256=cZJaqAlxESt7J3oqGsRAPgnD7Y5inZQ3OtlpkxwW3aA,5077
+qsys\transpiler\validate.py,sha256=Wga14FVrkPhll4bFThVs9YqQSt8jScWxh3L61d9ow1c,4509
+qsys\viz\__init__.py,sha256=-rCy5Sx04Bi7XnH-GzEJ8yzHAQ6rlN66aPdV8FhQg5w,14
+qsys\viz\text_drawer.py,sha256=zvX3BXSAFNj8z6qsfkzmfzONvjf2hMw1mNzD-gMQqJQ,3124
+simulator_statevector\__init__.py,sha256=IBnMkXProb3w8uTTrGN7mOHoWuKdKqTTd3MtM8hizmk,167
+simulator_statevector\__pycache__\__init__.cpython-313.pyc,sha256=hralv5IC7Xwp5WcYygjKu7WPfw47tFpPP6naDg0Btik,453
+simulator_statevector\simulator_statevector.pyd,sha256=gWZeYTOA4uXfcbD_JcnptrTqthWVtcCQLdSQ0K9Wj0Q,413696
+zena\__init__.py,sha256=slBf_rnfNiZw6NkdBNSZklC_aIh0HqM_GnlxWrMFJvU,229
+zena\__pycache__\__init__.cpython-312.pyc,sha256=gmoIlCjIw-33uHDlHp0P1q6ESTF7fVjcg_y515g6j1Q,453
+zena\__pycache__\__init__.cpython-313.pyc,sha256=vD9LD8qeCxcpwZ63XOfqzK00aWnKv4zbTHMoiabzdMA,475
+zena\__pycache__\execute.cpython-312.pyc,sha256=HreVKRUBtwJ5l9dqe9hWSMZTeMOolBkq2usu0rPTNQg,1279
+zena\__pycache__\execute.cpython-313.pyc,sha256=RCy2Sc9hCGIfEeOiESgOAIUobCYdTUzKBxysq_l4mBU,1270
+zena\circuit\__init__.py,sha256=wKzKOy3wPaNvgKShbRYzFlrRi_lz_3_MyQ925oDqCFE,101
+zena\circuit\__pycache__\__init__.cpython-312.pyc,sha256=V6oE5KqcOwpwBmQK6JnGBe04XyK8a56EZ_TV6jWoPPg,294
+zena\circuit\__pycache__\__init__.cpython-313.pyc,sha256=i31-QGuxJSsf4NCaJw518EM10NLbxRL27Kr6bNem3AU,316
+zena\circuit\__pycache__\quantum_circuit.cpython-312.pyc,sha256=M9bWOFOEWcvn18Th0PFnUgxa5_hyUIosxsFb9qW6fZg,10738
+zena\circuit\__pycache__\quantum_circuit.cpython-313.pyc,sha256=fnXHoTIi1uIFLmqixzEu0_kDRYIaF89SXc4q0jqohY8,11053
+zena\circuit\__pycache__\register.cpython-312.pyc,sha256=NgYTgrv0hoQb83D19_82_JqgyEoWhTUfPCUaA-9MVhI,2169
+zena\circuit\__pycache__\register.cpython-313.pyc,sha256=In5PqL7J4NlQRvZ61DmbmJc95HFgbtY5IPvFCYetx-0,2306
+zena\circuit\quantum_circuit.py,sha256=fNM_6K-jlo3Yy7eWceK6JOFkQ0dQdvzEMkE4gAKdTn0,8061
+zena\circuit\register.py,sha256=t23-L8hXAgsRD2l5o-99e9gccl8ylP_rLQ1UgHAMWA4,832
+zena\compiler\__init__.py,sha256=-5S58DzhjB0TrgSZ-kSvIj7rn8Mmcil2x3lFQxeN_sY,2768
+zena\compiler\__pycache__\__init__.cpython-312.pyc,sha256=-XwVatyhncgMa-6Mcnt9sTJ7KnlggeCCjAl6Ncu6INI,2008
+zena\compiler\__pycache__\__init__.cpython-313.pyc,sha256=1j-XrkDrCN7d1jazLYgFhvU3zgOTbvsvup7B--lRJus,2061
+zena\dist\zena_sdk-0.1.0-py3-none-any.whl,sha256=j6iMq5DgcWpkOfpnyh01VK2sklxfLyR9CdeP08yzcLo,1816
+zena\dist\zena_sdk-0.1.0.tar.gz,sha256=K5CUHhTQFtkYDspGxIozIP7Wco41pl47_QR16JKY954,6856
+zena\execute.py,sha256=LC46PiqI5FK6zjAATAahNOrUwdR-58xc5xUSIt4gdm8,1224
+zena\providers\__init__.py,sha256=dgwMU16it9iBjddjtycVrEw6FHx0QzlJwcLTnYhBRTc,51
+zena\providers\__pycache__\__init__.cpython-312.pyc,sha256=ieurVL6n2kmhid9ZrrTlbSB1q2MUGvocAUBzojz-Dsg,368
+zena\providers\__pycache__\__init__.cpython-313.pyc,sha256=-EKKVqQ1s27HONJnajO4OONLCXKM9y5zqVUWQvlaXPw,448
+zena\providers\__pycache__\aer.cpython-312.pyc,sha256=gL_rE1hf4WpmO0gw8_vA5yS6KiE7GzZArAogsUqAZWc,2888
+zena\providers\__pycache__\aer.cpython-313.pyc,sha256=qWlxB4qePUzkc8oUZD9nguy4etTDP95AZKLDau8KuOQ,3023
+zena\providers\__pycache__\backend.cpython-312.pyc,sha256=QGc1vU5dl2BoV6VAoi8MrR8tWJHp2wL8Yl_IgzoS--0,868
+zena\providers\__pycache__\backend.cpython-313.pyc,sha256=s2TKwxydXorl7H_IOnjSDTLRlx-kria-D8tiA7j9DUA,950
+zena\providers\__pycache__\job.cpython-312.pyc,sha256=Lzb6NTwSwNodrqJt2LZOBvH9B2e60wSxM2IPxNu5-Sg,1587
+zena\providers\__pycache__\job.cpython-313.pyc,sha256=wjd1CEv78ieo47j1TNbtq_z0cbxHsDa6iVKUNodMUXc,1681
+zena\providers\aer.py,sha256=2jrOVdBtIqCpxacH5u1VhTGX5EEHEMFIfqERmaFinig,2479
+zena\providers\backend.py,sha256=MYce8srKEhKy5uePkVwTO9Jsop614mcEV3bzzWe6FSo,361
+zena\providers\job.py,sha256=MmC3iaddumNFlWH1Q6RuQ0zqquknR7R_3uWFLASYhbY,690
+zena\visualization\__init__.py,sha256=zWzuaFe8je_apkMUWOszoP6yaY-8f7zGNDc4AnvVsqs,770
+zena\visualization\__pycache__\__init__.cpython-312.pyc,sha256=ZcOaCFOCJ6CVrgcuH17NcqggV3DU19EpUeYrEyhZosQ,1306
+zena\visualization\__pycache__\__init__.cpython-313.pyc,sha256=WbYdhyHlopFthHiCnXRbwRf2EKxvu0dws-rv3dtoW1w,1311
+zena_sdk-0.1.4.dist-info\METADATA,sha256=eNyEKeuj1zMneJwM8sydYAczk12v7l3sti9o7kuh2Kg,2166
+zena_sdk-0.1.4.dist-info\WHEEL,sha256=gPqN4EsdiAyGvmfrYy_ONrF276O8o0hPitI2CKZrEFA,95
+zena_sdk-0.1.4.dist-info\RECORD,,

zena_sdk-0.1.4.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.11.5)
+Root-Is-Purelib: false
+Tag: cp38-abi3-win_amd64