qubitclient-control

Files (1)

• SKILL.md

SKILL.md (first lines)

## API Reference

### Client Initialization

```python
# Using CtrlTaskName
from qubitclient.ctrl import QubitCtrlClient, CtrlTaskName
client = QubitCtrlClient()

# Using MCPClient directly
from qubitclient.ctrl import MCPClient
mcp = MCPClient(mcpServers=None)
```

### Task Names (CtrlTaskName)

- `S21` - S21 cavity frequency measurement
- `DRAG` - DRAG anti-crossing point measurement
- `DELTA` - Frequency offset calibration
- `OPTPIPULSE` - Optimal π-pulse measurement
- `POWERSHIFT` - Power shift curve measurement
- `RABI` - Rabi oscillation measurement
- `RAMSEY` - Ramsey interference measurement
- `S21VSFLUX` - S21 vs Flux measurement
- `SINGLESHOT` - Single-shot measurement
- `SPECTRUM` - Frequency spectrum analysis
- `SPECTRUM_2D` - 2D spectrum measurement
- `T1` - T1 relaxation time measurement

### Task Parameters and Examples

#### S21 - S21 Cavity Frequency Measurement

```python
from qubitclient.ctrl import QubitCtrlClient, CtrlTaskName

client = QubitCtrlClient()

result = client.run(
    task_type=CtrlTaskName.S21,
    qubits=["Q0", "Q1"],
    frequency_start=-40e6,      # -40 MHz
    frequency_end=40e6,         # +40 MHz
    frequency_sample_num=101,
    state=[0]                   # qubit state
)

# Result format:
# {
#   "data": {
#     "Q0": {
#       "frequency": [...],
#       "s21_real": [...],
#       "s21_imag": [...]
#     }
#   },
#   "parameters": {...}
# }
```

#### DRAG - DRAG Anti-crossing Point Measurement

```python
from qubitclient.ctrl import QubitCtrlClient, CtrlTaskName

result = client.run(
    task_type=CtrlTaskName.DRAG,
    qubits=["Q0"],
    lamb=[0.0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1.0],
    stage=1,
    N_repeat=1,
    pulsePair=[0, 1],
    signal="population"         # or "iq_avg"
)

# Result format:
# {
#   "data": {
#     "Q0": {
#       "lamb": [...],
#       "population": [...],
#       "optimal_lamb": 0.5
#     }
#   }
# }
```

#### RABI - Rabi Oscillation Measurement

```python
from qubitclient.ctrl import QubitCtrlClient, CtrlTaskName

result = client.run(
    task_type=CtrlTaskName.RABI,
    qubits=["Q0"],
    drive_amp=np.linspace(0.1, 1.0, 50).tolist(),  # amplitude sweep
    width=30e-9,              # pulse width 30ns
    signal="iq_avg"           # or "population"
)
```

#### RAMSEY - Ramsey Interference Measurement

```python
from qubitclient.ctrl import QubitCtrlClient, CtrlTaskName

result = client.run(
    task_type=CtrlTaskName.RAMSEY,
    qubits=["Q0"],
    delta=20e6,               # detuning 20 MHz
    delay=10e-6,              # max delay 10 us
    stage=1,
    scale=15,
    signal="population"
)
```

#### T1 - T1 Relaxation Time Measurement

From yaqiangsun/QubitClient, MIT.

More from yaqiangsun/QubitClient