cqc-quam-state 2025.12.29__py3-none-any.whl

cqc_quam_state/__init__.py

@@ -0,0 +1,9 @@
+"""CQC QuAM State management package."""
+
+from .utils import get_quam_state_path
+
+# Define QUAM_STATE_PATH that points to the installed quam_state directory
+QUAM_STATE_PATH = get_quam_state_path()
+
+# Export the variable in package namespace
+__all__ = ['QUAM_STATE_PATH']

cqc_quam_state/cli.py

@@ -0,0 +1,38 @@
+import click
+import os
+from .utils import get_quam_state_path
+
+
+@click.group()
+def cli():
+    """A CLI tool for managing CQC QuAM state."""
+    pass
+
+
+@cli.command()
+def set():
+    """Set a configuration value."""
+    click.echo("Set command called")
+    # Add your set logic here
+
+
+@cli.command()
+def info():
+    """Display information."""
+    click.echo("Info command called")
+    # Add your info logic here
+
+
+@cli.command()
+def load():
+    """Load data or configuration."""
+    # Run `cqc-quam-state load`
+    # Get QuAM state path using the utility function
+    quam_state_path = str(get_quam_state_path())
+    # print(f"QuAM state path: {type(quam_state_path)}")
+
+    click.echo(f"export QUAM_STATE_PATH={quam_state_path}")
+
+
+if __name__ == "__main__":
+    cli()

cqc_quam_state/utils.py

@@ -0,0 +1,30 @@
+"""Utility functions for CQC QuAM State."""
+
+import os
+from importlib.resources import files
+
+
+def get_quam_state_path():
+    """
+    Get the path to the QuAM state directory.
+
+    Returns:
+        str: The absolute path to the QuAM state directory.
+    """
+    try:
+        # For Python 3.9+
+        # Access quam_state as a resource within the cqc_quam_state package
+        p = files('quam_state')
+        # p = files('cqc_quam_state').joinpath('quam_state')
+        quam_state_path = str(p._paths[0])
+    except Exception as e:
+        # Fallback for older Python versions
+        # This fallback might also need adjustment if __file__ is not reliable
+        # depending on how the package is installed/used.
+        # For now, assuming it's a simple local structure.
+        libs_dir = os.path.dirname(os.path.dirname(__file__))
+        quam_state_path = os.path.join(libs_dir, 'quam_state')
+        # print(f"Warning: Using fallback path for quam_state: {quam_state_path}")
+        quam_state_path = str(quam_state_path)
+
+    return quam_state_path

cqc_quam_state-2025.12.29.data/scripts/load-cqc-quam

@@ -0,0 +1,3 @@
+#!/bin/bash
+output=$(cqc-quam-state load)
+eval $output

cqc_quam_state-2025.12.29.dist-info/METADATA

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: cqc-quam-state
+Version: 2025.12.29
+Summary: Add your description here
+Author-email: JUNIQ Software Team <info-juniq@fz-juelich.de>
+License: MIT
+Project-URL: Homepage, https://gitlab.jsc.fz-juelich.de/qip/cqc/cqc-quam-state
+Project-URL: Repository, https://gitlab.jsc.fz-juelich.de/qip/cqc/cqc-quam-state
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0.0
+
+# CQC QUAM State
+
+A command-line tool for managing CQC QuAM (Quantum Abstract Machine) state configuration.
+
+## Overview
+
+This package provides access to calibrated quantum device configurations and state files. It includes:
+
+- Pre-calibrated QuAM state files (JSON format)
+- CLI tools for managing and loading state configurations
+- Environment variable management for QuAM state paths
+
+To quickly set the `QUAM_STATE_PATH` environment variable to the current calibrated state (after installing and activating the environment):
+
+```bash
+source load-cqc-quam
+```
+
+**Note**: The package version follows the format `YYYY.MM.DD[.X]` where `YYYY.MM.DD` indicates the date of the last calibration, and the optional `.X` is a sub-version for multiple releases on the same day.
+
+## Installation
+
+Install the package using `uv` (recommended) or `pip`. Make sure to use the latest version to get the most recent calibration data:
+
+### Using uv (recommended)
+
+```bash
+uv venv
+source .venv/bin/activate
+uv pip install cqc-quam-state==2025.6.4.1
+```
+
+### Using pip
+
+```bash
+pip install cqc-quam-state==2025.6.4.1
+```
+
+### Installing the latest version
+
+To install the most recent calibration data, check for the latest version:
+
+```bash
+# Find the latest version
+pip index versions cqc-quam-state
+
+# Install the latest version (e.g., if there are multiple releases today)
+pip install cqc-quam-state==2025.6.4.3
+```
+
+## Usage
+
+### Quick Start
+
+The simplest way to use this package is to source the provided script, which sets the `QUAM_STATE_PATH` environment variable:
+
+```bash
+source load-cqc-quam
+```
+
+This will set `QUAM_STATE_PATH` to point to the current calibrated state files included in the package.
+
+### CLI Commands
+
+The package also provides a `cqc-quam-state` CLI tool for more advanced usage:
+
+#### Get Help
+
+```bash
+cqc-quam-state --help
+```
+
+#### Available Commands
+
+- **`info`**: Display information about the current state
+- **`load`**: Output the export command for setting `QUAM_STATE_PATH` (used by the `load-cqc-quam` script)
+- **`set`**: Set configuration values (placeholder for future functionality)
+
+#### Examples
+
+Display current state information:
+
+```bash
+cqc-quam-state info
+```
+
+Get the export command for the QuAM state path:
+
+```bash
+cqc-quam-state load
+```
+
+Set configuration values:
+
+```bash
+cqc-quam-state set
+```
+(In development, the idea is to set the IP address and port of the OPX and octave and the calibration db dynamically here)
+
+## State Files
+
+The package includes pre-calibrated state files in the `quam_state/` directory:
+
+- **`state.json`**: Main QuAM state configuration containing octave settings, RF outputs, and calibration parameters
+- **`wiring.json`**: Wiring configuration for the quantum device setup
+
+These files are automatically included when you install the package and can be accessed via the `QUAM_STATE_PATH` environment variable.
+
+## Version Information
+
+The package uses a date-based versioning system with optional sub-versions:
+
+### Version Format: `YYYY.MM.DD[.X]`
+
+- **`YYYY.MM.DD`**: The calibration date ( generated from `date +"%Y.%-m.%-d"`)
+- **`.X`**: Optional sub-version for multiple releases on the same day
+
+### Version Examples
+
+- **`2025.6.4`**: First release on June 4, 2025
+- **`2025.6.4.1`**: Second release on June 4, 2025 (updated calibration)
+- **`2025.6.4.2`**: Third release on June 4, 2025
+- **`2025.6.5`**: First release on June 5, 2025
+
+## Troubleshooting
+
+### Environment Variable Not Set
+
+If the `QUAM_STATE_PATH` environment variable is not set after sourcing the script:
+
+1. Ensure you're in the correct virtual environment
+2. Verify the package is installed: `pip show cqc-quam-state`
+3. Try running the load command directly: `cqc-quam-state load`
+
+### Package Not Found
+
+If you get import errors:
+
+1. Check if the package is installed: `pip list | grep cqc-quam-state`
+2. Ensure you're using the correct Python environment
+3. Try reinstalling: `pip install --force-reinstall cqc-quam-state`
+
+
+## License
+
+This project is licensed under the MIT License.

cqc_quam_state-2025.12.29.dist-info/RECORD

@@ -0,0 +1,12 @@
+cqc_quam_state/__init__.py,sha256=0MjJ6b67H2tQAZMJ17GBsIRNEZHnXmwENIjY3nTNa4c,271
+cqc_quam_state/cli.py,sha256=maXhyYtURun-cPHgnG6GzyVEAIbcD6Nu0a7NpcTe9i8,768
+cqc_quam_state/utils.py,sha256=jA8Mln8O7teERC07waVicuzNM5oxlwTZ6bNZBsKD8s0,1056
+cqc_quam_state-2025.12.29.data/scripts/load-cqc-quam,sha256=FawIyEdTIuHaUl9Uuqhp4tApqtRiBFBld3NgVcduHR4,55
+quam_state/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+quam_state/state.json,sha256=LLq9g5hyZu3S2EI1TJ7Yg5TRWrPqty_Pj7DgvR9QeaE,72471
+quam_state/wiring.json,sha256=CuS9OeiALkgF30nUJQbA-dGwCbXtkIK5-LX2MxmQXVI,4700
+cqc_quam_state-2025.12.29.dist-info/METADATA,sha256=I6mSh4aDQS0_6CQXuhPMK0kGwzieX8sbFOuaPe9UWAw,4703
+cqc_quam_state-2025.12.29.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+cqc_quam_state-2025.12.29.dist-info/entry_points.txt,sha256=yDPN6kPOJ_FVj0GG1MrOZrkhHwS0dB0Nibg9_gxEaeI,58
+cqc_quam_state-2025.12.29.dist-info/top_level.txt,sha256=3vvwgdiiqaeIb21EtYfkY064frn0mOkC0X9bRjzg7UU,26
+cqc_quam_state-2025.12.29.dist-info/RECORD,,

cqc_quam_state-2025.12.29.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

cqc_quam_state-2025.12.29.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+cqc-quam-state = cqc_quam_state.cli:cli

cqc_quam_state-2025.12.29.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+cqc_quam_state
+quam_state