deteqt 0.1.3

Python client for DeteQT metrology and quantum-chip diagnostics on InfluxDB v2.

deteqt

Python client for DeteQT metrology and quantum-chip diagnostics on InfluxDB v2.

Documentation

• Main website
• Usage
• API reference

Install

# Create and activate a virtual environment
uv venv deteqt-env --python 313
source deteqt-env/bin/activate  # Linux/macOS
# .\deteqt-env\Scripts\activate  # Windows

# Install from PyPI
uv pip install deteqt

# Verify
uv run --active python -c "import deteqt; print(deteqt.__version__)"

If you cloned this repository for local development:

uv pip install -e . --group all

Configure settings

from deteqt import write_settings_file

settings_path = write_settings_file(
    url="https://deteqt.duckdns.org",
    org="YOUR_ORG",
    bucket="YOUR_BUCKET",
    token="YOUR_WRITE_TOKEN",
)
print(settings_path)  # settings.toml

This creates settings.toml in your current working directory.

You can also create it manually:

url = "https://deteqt.duckdns.org"
org = "YOUR_ORG"
bucket = "YOUR_BUCKET"
token = "YOUR_WRITE_TOKEN"

Write one point

from deteqt import TUID, write_point

run_tuid: TUID = TUID("20260213-143319-249-01d39d")

summary = write_point(
    qoi="frequency",
    value=1.01,
    uncertainty=0.01,
    tuid=run_tuid,
    element="q1",
    label="f01",
    unit="GHz",
    element_label="qubit-01",
    device_id="chip-a",
    run_id="run-001",
    cycle_id="cycle-01",
    condition="4K",
    extra_tags={
        "area_of_interest": "sweetspot",
        "long_label": "Q1 frequency",
    },
    extra_fields={
        "temperature_mK": 12.3,
        "passed_qc": True,
    },
)
print(summary)  # {'records_written': 1}

Write batch (with optional extras)

from deteqt import write_batch

summary = write_batch(
    [
        {
            "qoi": "frequency",
            "value": 1.01,
            "uncertainty": 0.01,
            "run_id": "run-001",
            "cycle_id": "cycle-01",
            "extra_tags": {
                "area_of_interest": "sweetspot",
                "long_label": "Q1 frequency",
            },
            "extra_fields": {"temperature_mK": 12.3},
        },
        {
            "qoi": "phase",
            "value": 0.12,
            "run_id": "run-001",
            "extra_tags"": {
                "area_of_interest": "sweetspot",
                "long_label": "Q1 frequency",
            },
            "extra_fields": {"passed_qc": True},
        },
    ]
)

Common schema policy

Use these common keys across all integrations:

• measurement: qoi
• tags: element, label, unit, element_label, device_id, run_id, cycle_id, condition
• fields: value, uncertainty, tuid

Partner-specific keys area_of_interest and long_label are treated as optional extra tags.

If your settings file is elsewhere, pass settings_path=".../settings.toml".