boulder-opal-scale-up-sdk 1.0.5__py3-none-any.whl → 1.0.7__py3-none-any.whl

{boulder_opal_scale_up_sdk-1.0.5.dist-info → boulder_opal_scale_up_sdk-1.0.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: boulder-opal-scale-up-sdk
-Version: 1.0.5
+Version: 1.0.7
 Summary: Q-CTRL Boulder Opal Scale Up Python SDK
 License: https://q-ctrl.com/terms
 Keywords: black opal,boulder opal,fire opal,nisq,open controls,q control,q ctrl,q-control,q-ctrl,qcontrol,qctrl,quantum,quantum algorithms,quantum circuits,quantum coding,quantum coding software,quantum computing,quantum control,quantum control software,quantum control theory,quantum engineering,quantum error correction,quantum firmware,quantum fundamentals,quantum sensing,qubit,qudit
@@ -33,7 +33,7 @@ Requires-Dist: pydantic (>=2.10.4,<3.0.0)
 Requires-Dist: pydantic-settings (>=2.7.0,<3.0.0)
 Requires-Dist: python-dateutil (>=2.9.0.post0,<3.0.0)
 Requires-Dist: pyyaml (>=6.0.2,<7.0.0)
-Requires-Dist: qm-qua (==1.2.1) ; extra == "quantum-machines"
+Requires-Dist: qm-qua (==1.2.3) ; extra == "quantum-machines"
 Project-URL: Facebook, https://www.facebook.com/qctrl
 Project-URL: GitHub, https://github.com/qctrl
 Project-URL: Homepage, https://q-ctrl.com

{boulder_opal_scale_up_sdk-1.0.5.dist-info → boulder_opal_scale_up_sdk-1.0.7.dist-info}/RECORD

@@ -1,73 +1,83 @@
 boulderopalscaleupsdk/__init__.py,sha256=nD3YDqPiE52mmuUrIlDUrYSyljpMsDJvc5HsubBUSs4,592
 boulderopalscaleupsdk/agent/__init__.py,sha256=aFkAtHJDOdXA126JklxYz0ix1k4lCcLLS9DQp8zUKMk,1092
-boulderopalscaleupsdk/agent/worker.py,sha256=uQ7VxTGtx_CHeHE0n7V1_KmFpk0OwKoIZxiAtjeRiug,8703
+boulderopalscaleupsdk/agent/worker.py,sha256=mCwVMbWw2saAQKyQuozhEz9JJDwpezesItZim-5qWQ8,9176
 boulderopalscaleupsdk/common/__init__.py,sha256=vLaJ1FP36xV5eX6VD7nShqxVBm3UzsBMIK1pmSiTIag,550
-boulderopalscaleupsdk/common/dtypes.py,sha256=8YDF2SzJerA0HQ6UwyY6CU3e6_eeSC2VboA-YI7aD-A,10180
+boulderopalscaleupsdk/common/dtypes.py,sha256=vuV8iIRSzKISBJOckJTaTR0pGMSc-W1irvjEtHl0Z6g,11535
 boulderopalscaleupsdk/common/typeclasses.py,sha256=dUpM4vDNQCxVuB45LTyEWO7SuLyzUlG6mJuseM80Chw,3668
+boulderopalscaleupsdk/constants.py,sha256=2B3LrPH8bAQzzlkRYP5nyIkRT3LmfdIzzxiFKHWICPQ,682
 boulderopalscaleupsdk/device/__init__.py,sha256=vLaJ1FP36xV5eX6VD7nShqxVBm3UzsBMIK1pmSiTIag,550
 boulderopalscaleupsdk/device/common.py,sha256=NxiFdpHXd1Es2_8iqUeAqhL4R4W-POzHoWYtu13JCyo,1875
 boulderopalscaleupsdk/device/config_loader.py,sha256=kGUaUtYAREYN7grtQ9SUO3dPUqiHVUnVOQbXFZpXvtw,3414
 boulderopalscaleupsdk/device/controller/__init__.py,sha256=ePkrCbX1ORm05fS0BEQ8cx7DPxGGN6IkUoNH6eQL1DM,1136
 boulderopalscaleupsdk/device/controller/base.py,sha256=xuT4VzRulknxppiQpzYYn_TwuRNfV9wHMqjN2okA8Lw,793
-boulderopalscaleupsdk/device/controller/qblox.py,sha256=c5RXqS9z2e-6Kso_eJIznIqJMR0kqL1NJRvJboYLafE,29377
-boulderopalscaleupsdk/device/controller/quantum_machines.py,sha256=m0_zO7Cn-Ea1-ewG7qgjEnt4GXtQMvBv_oz-dnOmI9k,5320
+boulderopalscaleupsdk/device/controller/qblox.py,sha256=vDIwnrEVSGVo2gyZGd3reV7RBWF_xstV3up3ByCGHyA,29638
+boulderopalscaleupsdk/device/controller/quantum_machines.py,sha256=dkBSAqdEDADpn-qq7SkiZ-Rfnwh1NLQruqJGEW06ikU,7784
 boulderopalscaleupsdk/device/controller/resolver.py,sha256=hW5U58dmJf_IGmD4EK_bbn0XU-N9autFBFHmqbRnY2Y,3812
 boulderopalscaleupsdk/device/defcal.py,sha256=3IPmcLx89ZDv9sCPncozWA-hhnZRZK3OiOiBcAW05lI,739
 boulderopalscaleupsdk/device/device.py,sha256=smNgGtPs4xx2xyBiEtu178EiAW0ylMklv-wOSSnvoGA,2212
 boulderopalscaleupsdk/device/processor/__init__.py,sha256=YLn1UTCIX0CYfah1muLXrhujJx7sz56JZQ4Pn4DnKd0,972
-boulderopalscaleupsdk/device/processor/common.py,sha256=1ot1MbK6P1rZspX9bpfFXUSzlzr70x0GIDAVsFKcMTA,9667
+boulderopalscaleupsdk/device/processor/common.py,sha256=rF2mq6X9Zl99mMc5JOqvKZEKCnfA0uUPsrwVWRiIOUA,9661
 boulderopalscaleupsdk/device/processor/superconducting_processor.py,sha256=pt4hWdRoBD8EWYlG1HDPfumZNdRzo7Be9FDqHoRAFDw,13394
-boulderopalscaleupsdk/experiments/__init__.py,sha256=nXAkD_BQYYDbd4_ZGLWoO2NsYllJRKV1oVr0i2V1yQ0,2304
+boulderopalscaleupsdk/errors.py,sha256=iN3Y1bQ-GnSLuTCKLG3H1OTbUpW-ibFIEfT3jPuMW48,735
+boulderopalscaleupsdk/experiments/__init__.py,sha256=zozsQtxhXz1s1cNoUoJ2lQlAOAbp2ozVhquxXw3KrF8,2485
 boulderopalscaleupsdk/experiments/chi01_scan.py,sha256=vcvRbC7UyE_7UfduhcaVJEo5qJxwXQcPTjigXOKBtCc,2280
 boulderopalscaleupsdk/experiments/common.py,sha256=m-A91hOcLYHBqL9jUI4-ia_13U0-wv711aMgCyjiGqw,2535
+boulderopalscaleupsdk/experiments/cz_spectroscopy_by_bias.py,sha256=UFGe_gZ2Z2iHIc5BBuAT5brznutlWOOcT7zkx6hU32s,2937
 boulderopalscaleupsdk/experiments/drag_leakage_calibration.py,sha256=ey0g5hJBGgrtGdwtrMXGCYvd6TvgWIG63wfSJ6ahGzE,2400
 boulderopalscaleupsdk/experiments/fine_amplitude_calibration.py,sha256=3Us-C9Ss5Ks-1TYSIYToEY1hgZr2VF2CY22cgOWk530,1963
-boulderopalscaleupsdk/experiments/power_rabi.py,sha256=-0iT1KHY-HecEvjJ5nQcmWyRNd1505xfVmG_j1gqZXs,2453
-boulderopalscaleupsdk/experiments/power_rabi_ef.py,sha256=j-XoGcNXPtb-NiwwuXhqZaGl70Fh5RKsdZNFSO2hHz0,2461
+boulderopalscaleupsdk/experiments/power_rabi.py,sha256=9p76MVkj7YHvbljCrY4im_scZ19TpCMxa3p5OWPipMA,2453
+boulderopalscaleupsdk/experiments/power_rabi_ef.py,sha256=3JbPXx5d_s3h3XyU5xdB1tgZj5aaKGb3452zAjYECc8,2461
 boulderopalscaleupsdk/experiments/ramsey.py,sha256=Ym1dqAs3b3nPfNp4T3TPIMTDDMT6eBJ-CUCua9CyKl8,2192
-boulderopalscaleupsdk/experiments/readout_classifier_calibration.py,sha256=k7P1PDbpSz_KjRt4A39ilhA_Ke9IpMKAjoFqT_9RfWY,1841
+boulderopalscaleupsdk/experiments/ramsey_ef.py,sha256=l_i4s_5bw8QNI6KAoXcyYAjoMZgsfuoCluZOQR-CCaQ,2203
+boulderopalscaleupsdk/experiments/readout_classifier.py,sha256=skKl323pGH3hk_SoCSq613QOEJfUNNSrbuQshF5GXpQ,1980
+boulderopalscaleupsdk/experiments/readout_optimization.py,sha256=Rsc0G8-4vI5mLh1iYtnnzCROgivSNuAYRNUhACXaJS0,1943
 boulderopalscaleupsdk/experiments/resonator_spectroscopy.py,sha256=QMEh52zh-ZsraYn2sq7qnE0g0z0dhBsSndIepBrBzVM,2262
-boulderopalscaleupsdk/experiments/resonator_spectroscopy_by_bias.py,sha256=CCZ6AkQ_Q5zfuDpcFe-AI-SLHUUtFnxiPUwS4Y5Xo2Q,2888
+boulderopalscaleupsdk/experiments/resonator_spectroscopy_by_bias.py,sha256=UIqoXXNO1bq_4c6YMv2v__0yjuJLYsKE6MpOoRl7msE,2855
 boulderopalscaleupsdk/experiments/resonator_spectroscopy_by_power.py,sha256=jtQHeeQyshlg9_WJwwFONk6FKWRbE88zURwyihY4ZxI,2383
 boulderopalscaleupsdk/experiments/t1.py,sha256=Tia4siBGcQ2-WkKw8F5y6smwW5_h3INbKUxM1nPiufI,1635
-boulderopalscaleupsdk/experiments/t2.py,sha256=LQHwFyOLa0MiVUxRCcovGBVC32bfA7xzfBILgXq0CCs,1790
+boulderopalscaleupsdk/experiments/t2.py,sha256=gxxqQRU_BbHMU92RIdpqbQo9HbdCTfIbmrATFXfgM9s,1790
 boulderopalscaleupsdk/experiments/t2_echo.py,sha256=dgohfuliI2f3KsiyhfSMrwJjwq5r3meakEPmH-3HUAY,1804
-boulderopalscaleupsdk/experiments/transmon_anharmonicity.py,sha256=QELWV3X_sD2ZN1_JwUcS8E4ykYGSW4a7zFPpKuXbjdk,2841
+boulderopalscaleupsdk/experiments/transmon_anharmonicity.py,sha256=3Y-vk1dLUeP8Vnr38CQ_AoTi63SNqls5m6tswcMETWo,2801
 boulderopalscaleupsdk/experiments/transmon_spectroscopy.py,sha256=y6aZwW2jys5JOYqozfTKpLU5ZXlwP1AQVm73MWO-zB4,2402
 boulderopalscaleupsdk/experiments/voltage_bias_fine_tune.py,sha256=P5RuASiP3UUudLQIFWIznTuhCOK0ndj9FN9l6bHv_xU,2060
-boulderopalscaleupsdk/experiments/waveforms.py,sha256=zyzADCra9T0wphltrhfj75wB2y4qwTSvcU2mBJQNrjU,1712
+boulderopalscaleupsdk/experiments/waveforms.py,sha256=zxEQaSaJP10ZHTZS4wqXD4E-sAc-F0l5H6uBiPjibtg,2239
 boulderopalscaleupsdk/experiments/zz_ramsey.py,sha256=mpek0jKVdbOUnXb0KNYsxGTo3MnMR8SG4cYiHOA1KY4,2017
 boulderopalscaleupsdk/grpc_interceptors/__init__.py,sha256=PkdOlllLbRWycofvGCCxDY60Ydp_U0QM5l4u3Fsnno4,616
 boulderopalscaleupsdk/grpc_interceptors/auth.py,sha256=PSe_b9ckqhcb3xf1Y4jpn1TjfEWfokkarqfUHIz6HIs,4165
+boulderopalscaleupsdk/grpc_interceptors/error.py,sha256=PeEH4eFGFfRNwBw8iDuKVQo02_mItAUVehYa7AiZNqI,12067
 boulderopalscaleupsdk/plotting/__init__.py,sha256=pkdCky3YHqc3PLRy_h9puJKAO4AqSJGebb26x7XayR4,959
-boulderopalscaleupsdk/plotting/dtypes.py,sha256=Ir-aFywqHeq0cI2jHY1uexjJHYpXOZwsg5nts9tpeQc,4892
+boulderopalscaleupsdk/plotting/dtypes.py,sha256=Sh9L6nRkvw9PIMKaOEieHyLuvTRqWfDMi1h4dnqzeR0,4967
 boulderopalscaleupsdk/protobuf/v1/agent_pb2.py,sha256=r8vE_d7e5iG04UCDeV0FgxOVOSflOlwmSs2I5CotDBU,6147
 boulderopalscaleupsdk/protobuf/v1/agent_pb2.pyi,sha256=bwRNbnwbwkqx7OSE4EurVS6865zqdtqmTcRjwJNH7OI,3082
 boulderopalscaleupsdk/protobuf/v1/agent_pb2_grpc.py,sha256=gfv0Ncc6_MS38Lzj6NHYXhwJVo7qK7XYQiCsi-KTl5w,8593
-boulderopalscaleupsdk/protobuf/v1/device_pb2.py,sha256=yvgsfFYM-O3LsMlcoVah3CngYxg1djHkkaztD__PE7Q,11599
-boulderopalscaleupsdk/protobuf/v1/device_pb2.pyi,sha256=GqrIb_5V6x4yQHzbJHilS_GGnlDsyhFr_RCratS2KFc,6846
-boulderopalscaleupsdk/protobuf/v1/device_pb2_grpc.py,sha256=0CtrO8gKkcfHn7flQLFAySyOVpdDgzct_EaMMF73rUY,19445
+boulderopalscaleupsdk/protobuf/v1/device_pb2.py,sha256=ICKzowjY-s9NtzSNoHUWtIS7kZZeIANyz01GZ1MiXA8,12890
+boulderopalscaleupsdk/protobuf/v1/device_pb2.pyi,sha256=C_LamCxITi5huwM0u4Yw_7KwTE2tT8lCHjS1JE2F7Lk,8086
+boulderopalscaleupsdk/protobuf/v1/device_pb2_grpc.py,sha256=DxsxBgww66W-pV8Ba01YAKDK-zPC8KGOQOXQnO1WnMk,21122
+boulderopalscaleupsdk/protobuf/v1/job_pb2.py,sha256=awz-VTyt6lMJmf8ulW4kxSk-U_pYQOoZAyieww-RvaQ,4737
+boulderopalscaleupsdk/protobuf/v1/job_pb2.pyi,sha256=C6ygytheTgOohv3bA_CoCFh1Dvqcwwi_1dCsI93kTm4,2354
+boulderopalscaleupsdk/protobuf/v1/job_pb2_grpc.py,sha256=rwMHUYSaNT8uScrRxwEtR5niA3ghNjqJ6mzKVniBT9Q,6336
 boulderopalscaleupsdk/protobuf/v1/task_pb2.py,sha256=Sd-xzEOJkEZAFw_A0cNXVKOZ_Q71XrIkMl8OTuL9zoo,7132
 boulderopalscaleupsdk/protobuf/v1/task_pb2.pyi,sha256=o4QeMmUCT_x19eL7dlNE0LtdqJi1e9kv2gMiD7Z4pwg,6048
 boulderopalscaleupsdk/protobuf/v1/task_pb2_grpc.py,sha256=yP2FZ148RmSYFHivatCXuM13oRBDA5wBwmvhZQNBTXQ,5826
 boulderopalscaleupsdk/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-boulderopalscaleupsdk/routines/__init__.py,sha256=4oxML7Ztq7gRWtvDZW_-QUr_Svez8kKIxXIuYhT3LyU,1009
+boulderopalscaleupsdk/routines/__init__.py,sha256=4WUUHw681esSf8R3K11AAegBbrRhrD7TgOAdj1PZZq0,1081
 boulderopalscaleupsdk/routines/common.py,sha256=BvZ1DvCJDFHkauOEq8z-Mkj_mwO-1BSRLHkiTaIbJ0U,775
+boulderopalscaleupsdk/routines/coupler_discovery.py,sha256=QJuEsJ_PVlBfJzw8xHBCHwia-oE8Xj4I0og-rPZlC24,1144
 boulderopalscaleupsdk/routines/one_qubit_calibration.py,sha256=n3QifgKVcQu0Idkxj0Hk9husi3xcsoMJz7t3nTvBwEk,1018
 boulderopalscaleupsdk/routines/resonator_mapping.py,sha256=Jp7ubmP0knRaoSE6IZnww2q0tixmjZ1HG3NjvEW0Rhs,1186
 boulderopalscaleupsdk/routines/transmon_coherence.py,sha256=qwFlrDgwRdo4rWwXJoQ0pLJSKiUnzMYasK6kMHWhlHI,1074
 boulderopalscaleupsdk/routines/transmon_discovery.py,sha256=ZI-mQQSlUWhU1J_H1ie9Hz4TOK3aMxZqtfX2AgHNrKI,1453
-boulderopalscaleupsdk/routines/transmon_retuning.py,sha256=3C9iSE7D3dnPbj-RJw5pogAwS3Hs9C-9uBLQT81qeAA,1423
-boulderopalscaleupsdk/stubs/__init__.py,sha256=vLaJ1FP36xV5eX6VD7nShqxVBm3UzsBMIK1pmSiTIag,550
-boulderopalscaleupsdk/stubs/dtypes.py,sha256=VH2QqmmaSegv03KEaZBqB-REHhvk5h3GPfQgCJTAYQE,1361
-boulderopalscaleupsdk/stubs/maps.py,sha256=oSGfEOCGSAZjqDRVbHr0B7S3VnyV1pvdRBa5NqnXxuA,1087
+boulderopalscaleupsdk/routines/transmon_retuning.py,sha256=sCt__KrabNupd5dJJAcZqk6Jf026r_cN4wm1lJ3YwWs,1239
+boulderopalscaleupsdk/solutions/__init__.py,sha256=4aNTanH2A7QBvkilWYYpdeGZiUssgbqdLbP2rAyLUX4,717
+boulderopalscaleupsdk/solutions/common.py,sha256=4IxWr2sXWYms1K4c460FQ129nlljF9ryJ_oNUQkV9xQ,779
+boulderopalscaleupsdk/solutions/placeholder_solution.py,sha256=lWP9uNW_AnuPEwbHSl1psdqlYchWvfDSceF612taP9o,907
 boulderopalscaleupsdk/third_party/__init__.py,sha256=b9T2IVfz9bMenSsLQuaf4A14ySinjNnSGx68hLsFHZE,596
-boulderopalscaleupsdk/third_party/quantum_machines/__init__.py,sha256=ORD6crMw6gtoIp8dmusdwSiU4pje739fOacOfHXSOls,2541
-boulderopalscaleupsdk/third_party/quantum_machines/config.py,sha256=tQsWx_nSXSFT4fRuMzuvliplyRsB9Sy70kHqsKuTA-A,20756
+boulderopalscaleupsdk/third_party/quantum_machines/__init__.py,sha256=D-6LLQacjr4fBNb4AvF-caQtozOoKiJsv6LuMBUNHEE,3195
+boulderopalscaleupsdk/third_party/quantum_machines/config.py,sha256=LSLmZRbOa8DXqSvXKL0y8mEsNxoRHOdr3i3pYXafjdY,20656
 boulderopalscaleupsdk/third_party/quantum_machines/constants.py,sha256=5PpAi6MZ53yEinBHerY2ssi30BR37JnLBWL21irpZ8Y,870
 boulderopalscaleupsdk/utils/__init__.py,sha256=vLaJ1FP36xV5eX6VD7nShqxVBm3UzsBMIK1pmSiTIag,550
 boulderopalscaleupsdk/utils/serial_utils.py,sha256=SzvY-WFD0b8IGSh6PTv7F9y1W2IPPYmj8pY3AsX-xlM,2062
-boulder_opal_scale_up_sdk-1.0.5.dist-info/LICENSE,sha256=wqX4S5Brcwkwo750l9grSspwm0cyMsZtZEa1Vx3_WiE,36587
-boulder_opal_scale_up_sdk-1.0.5.dist-info/METADATA,sha256=6XkaUQrGLbPksehJqwigcC3NAMujG9JNeS4vWrsbCi8,2419
-boulder_opal_scale_up_sdk-1.0.5.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
-boulder_opal_scale_up_sdk-1.0.5.dist-info/RECORD,,
+boulder_opal_scale_up_sdk-1.0.7.dist-info/LICENSE,sha256=wqX4S5Brcwkwo750l9grSspwm0cyMsZtZEa1Vx3_WiE,36587
+boulder_opal_scale_up_sdk-1.0.7.dist-info/METADATA,sha256=whZcIMgfnu6Bc5e9onrhsjBWZpXurCJw79OxlvRykZE,2419
+boulder_opal_scale_up_sdk-1.0.7.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
+boulder_opal_scale_up_sdk-1.0.7.dist-info/RECORD,,

boulderopalscaleupsdk/agent/worker.py

@@ -17,6 +17,7 @@ Contains logic for agent worker.
 """
 
 import logging
+import os
 from abc import abstractmethod
 from typing import Protocol
 
@@ -28,6 +29,10 @@ from grpc import ssl_channel_credentials
 from pydantic_settings import BaseSettings, SettingsConfigDict
 
 from boulderopalscaleupsdk.common.dtypes import GrpcMetadata, JobId
+from boulderopalscaleupsdk.constants import (
+    DEFAULT_GRPC_MAX_RECEIVE_MESSAGE_LENGTH,
+    DEFAULT_GRPC_MAX_SEND_MESSAGE_LENGTH,
+)
 from boulderopalscaleupsdk.protobuf.v1 import agent_pb2, task_pb2, task_pb2_grpc
 
 LOG = logging.getLogger(__name__)
@@ -171,9 +176,17 @@ class Agent:
         Create a gRPC channel.
         """
         host = url.split(":")[0]
+        grpc_max_send_message_length = os.getenv(
+            "GRPC_MAX_SEND_MESSAGE_LENGTH",
+            DEFAULT_GRPC_MAX_SEND_MESSAGE_LENGTH,
+        )
+        grpc_max_receive_message_length = os.getenv(
+            "GRPC_MAX_RECEIVE_MESSAGE_LENGTH",
+            DEFAULT_GRPC_MAX_RECEIVE_MESSAGE_LENGTH,
+        )
         options = [
-            ("grpc.max_send_message_length", 1024 * 1024 * 50),  # 50MB
-            ("grpc.max_receive_message_length", 1024 * 1024 * 50),  # 50MB
+            ("grpc.max_send_message_length", grpc_max_send_message_length),
+            ("grpc.max_receive_message_length", grpc_max_receive_message_length),
         ]
         if host in ["localhost", "127.0.0.1", "0.0.0.0", "::"]:
             channel = grpc.insecure_channel(

boulderopalscaleupsdk/common/dtypes.py

@@ -14,7 +14,9 @@
 from __future__ import annotations
 
 import enum
-from typing import overload
+from typing import TypeAlias, overload
+
+import grpc
 
 __all__ = [
     "Duration",
@@ -31,6 +33,8 @@ from dateutil.parser import isoparse
 from pydantic import BaseModel, BeforeValidator, ConfigDict, Field, PlainSerializer, TypeAdapter
 from pydantic.dataclasses import dataclass
 
+from boulderopalscaleupsdk.plotting import Plot
+
 GrpcMetadata = list[tuple[str, str | bytes]]
 
 JobId = str
@@ -175,6 +179,9 @@ class Duration:
             return bool(self._np_rep == other._np_rep)
         return False
 
+    def __str__(self):
+        return f"{self.value} {self.unit.value}"
+
     def convert(self, unit: TimeUnit) -> Duration | InvalidDurationConversion:
         val: np.float64 = self._np_rep / np.timedelta64(1, unit)
         if val.is_integer():
@@ -316,6 +323,14 @@ class JobHistorySortOrder(enum.Enum):
     CREATED_AT_DESC = 1
     CREATED_AT_ASC = 2
 
+    @staticmethod
+    def from_int(value: int) -> JobHistorySortOrder | None:
+        match value:
+            case 1 | 2:
+                return JobHistorySortOrder(value)
+            case _:
+                return None
+
 
 class JobSummary(BaseModel):
     id: str
@@ -330,13 +345,17 @@ class JobSummary(BaseModel):
 
 class JobDataEntry(BaseModel):
     message: str
-    created_at: ISO8601DatetimeUTCLike
-    dt: str
-    elapsed_time: str
 
     class Config:
         extra = "allow"
 
+    def get_display_items(self) -> list[str | Plot]:
+        items: list[str | Plot] = [self.message]
+
+        if plots := getattr(self, "plots", []):
+            items.extend(TypeAdapter(Plot).validate_python(plot) for plot in plots)
+        return items
+
 
 class JobData(BaseModel):
     id: str
@@ -346,7 +365,32 @@ class JobData(BaseModel):
     device_name: str
     data: list[JobDataEntry]
 
+    def get_display_items(self) -> list[str | Plot]:
+        items: list[str | Plot] = []
+        message = "\n".join(
+            [
+                "JobData summary:",
+                f"  - id: {self.id}",
+                f"  - name: {self.name}",
+                f"  - session_id: {self.session_id}",
+                f"  - created_at: {self.created_at.isoformat()}",
+                f"  - device_name: {self.device_name}",
+            ],
+        )
+        items.append(message)
+
+        for job_data_entry in self.data:
+            items.extend(job_data_entry.get_display_items())
+        return items
+
 
 DEFAULT_JOB_HISTORY_PAGE = 1
 DEFAULT_JOB_HISTORY_PAGE_SIZE = 10
 DEFAULT_JOB_HISTORY_SORT_ORDER = JobHistorySortOrder.CREATED_AT_DESC
+
+SyncClientInterceptor: TypeAlias = (
+    grpc.UnaryUnaryClientInterceptor
+    | grpc.UnaryStreamClientInterceptor
+    | grpc.StreamUnaryClientInterceptor
+    | grpc.StreamStreamClientInterceptor
+)

boulderopalscaleupsdk/{stubs/__init__.py → constants.py}

@@ -10,3 +10,6 @@
 # Unless required by applicable law or agreed to in writing, software
 # distributed under the License is distributed on an "AS IS" BASIS. See the
 # License for the specific language.
+
+DEFAULT_GRPC_MAX_RECEIVE_MESSAGE_LENGTH = 1024 * 1024 * 50  # 50MB
+DEFAULT_GRPC_MAX_SEND_MESSAGE_LENGTH = 1024 * 1024 * 50  # 50MB

boulderopalscaleupsdk/device/controller/qblox.py

@@ -54,7 +54,7 @@ from dataclasses import dataclass
 from typing import Annotated, Any, ClassVar, Literal, Self, TypeVar
 
 import numpy as np
-from pydantic import BaseModel, BeforeValidator, Field, PlainSerializer, model_validator
+from pydantic import BaseModel, BeforeValidator, ConfigDict, Field, PlainSerializer, model_validator
 
 from boulderopalscaleupsdk.device.controller.base import Backend, ControllerType
 
@@ -323,7 +323,9 @@ class QBLOXControllerInfo(BaseModel):  # pragma: no cover
 # Instrument management
 # ==================================================================================================
 class SequencerParams(BaseModel):
-    nco_freq: float | None = Field(default=None)
+    model_config = ConfigDict(validate_assignment=True)
+
+    nco_freq: float | None = Field(default=None, ge=-500e6, le=500e6)
     gain_awg_path0: float | None = Field(default=None, ge=-1.0, le=1.0)
     offset_awg_path0: float | None = Field(default=None, ge=-1.0, le=1.0)
     gain_awg_path1: float | None = Field(default=None, ge=-1.0, le=1.0)
@@ -338,6 +340,8 @@ class SequencerParams(BaseModel):
 
 
 class QcmParams(BaseModel):
+    model_config = ConfigDict(validate_assignment=True)
+
     out0_offset: float | None = Field(default=None, ge=-2.5, le=2.5)
     out1_offset: float | None = Field(default=None, ge=-2.5, le=2.5)
     out2_offset: float | None = Field(default=None, ge=-2.5, le=2.5)
@@ -354,6 +358,8 @@ class QcmParams(BaseModel):
 
 
 class QcmRfParams(BaseModel):
+    model_config = ConfigDict(validate_assignment=True)
+
     out0_att: int | None = Field(default=None, ge=0, le=60, multiple_of=2)
     out1_att: int | None = Field(default=None, ge=0, le=60, multiple_of=2)
 
@@ -375,6 +381,8 @@ class QcmRfParams(BaseModel):
 
 
 class QrmRfParams(BaseModel):
+    model_config = ConfigDict(validate_assignment=True)
+
     out0_att: int | None = Field(default=None, ge=0, le=60, multiple_of=2)
 
     out0_in0_lo_freq: float | None = Field(default=None, gt=0)

boulderopalscaleupsdk/device/controller/quantum_machines.py

@@ -11,10 +11,11 @@
 # distributed under the License is distributed on an "AS IS" BASIS. See the
 # License for the specific language.
 
-from typing import Literal, Self
+from typing import Annotated, Any, Literal, Self
 
 from pydantic import (
     BaseModel,
+    BeforeValidator,
     ConfigDict,
     Field,
     field_serializer,
@@ -31,10 +32,78 @@ from boulderopalscaleupsdk.third_party.quantum_machines.constants import (
     QUA_CLOCK_CYCLE,
 )
 
-QPUPortRef = str
-OctaveRef = str
-ControllerRef = str
-ControllerPort = int
+
+class OPXPortMapping(BaseModel):
+    type: Literal["controller"] = "controller"
+    controller_id: str
+    port_id: int
+
+    def to_native_opx_port_type(self) -> qm_config.NativeOPXPortType:
+        return qm_config.NativeOPXPortType(
+            controller_id=self.controller_id,
+            port_id=self.port_id,
+        )
+
+    @staticmethod
+    def from_native_opx_port_type(
+        port_type: qm_config.NativeOPXPortType,
+    ) -> "OPXPortMapping":
+        return OPXPortMapping(
+            controller_id=port_type.controller_id,
+            port_id=port_type.port_id,
+        )
+
+
+def ensure_opx_port_mapping(value: Any) -> Any:
+    match value:
+        case OPXPortMapping():
+            return value
+        case list([str(controller_id), float(port_id)]):
+            if not port_id.is_integer():
+                raise ValueError("port_id must be an integer")
+            return OPXPortMapping(controller_id=controller_id, port_id=int(port_id))
+        case list([str(controller_id), int(port_id)]):
+            return OPXPortMapping(controller_id=controller_id, port_id=port_id)
+        case tuple((str(controller_id), float(port_id))):
+            if not port_id.is_integer():
+                raise ValueError("port_id must be an integer")
+            return OPXPortMapping(controller_id=controller_id, port_id=int(port_id))
+        case tuple((str(controller_id), int(port_id))):
+            return OPXPortMapping(controller_id=controller_id, port_id=port_id)
+        case dict({"type": "controller", "controller_id": str(), "port_id": int() | float()}):
+            return OPXPortMapping.model_validate(value)
+        case _:
+            raise ValueError("Invalid Port Mapping")
+
+
+OPXPortMappingLike = Annotated[
+    OPXPortMapping,
+    BeforeValidator(ensure_opx_port_mapping),
+]
+
+
+class OPX1000PortMapping(BaseModel):
+    type: Literal["frontend_module"] = "frontend_module"
+    controller_id: str
+    fem_id: int
+    port_id: int
+
+    def to_native_opx1000_port_type(self) -> qm_config.NativeOPX1000PortType:
+        return qm_config.NativeOPX1000PortType(
+            controller_id=self.controller_id,
+            fem_id=self.fem_id,
+            port_id=self.port_id,
+        )
+
+    @staticmethod
+    def from_native_opx1000_port_type(
+        port_type: qm_config.NativeOPX1000PortType,
+    ) -> "OPX1000PortMapping":
+        return OPX1000PortMapping(
+            controller_id=port_type.controller_id,
+            fem_id=port_type.fem_id,
+            port_id=port_type.port_id,
+        )
 
 
 class QuaProgram(BaseModel):
@@ -74,17 +143,17 @@ class OctaveConfig(qm_config.OctaveConfig121):
 
 class DrivePortConfig(BaseModel):
     port_type: Literal["drive"] = "drive"
-    port_mapping: tuple[OctaveRef, ControllerPort]
+    port_mapping: OPXPortMappingLike | OPX1000PortMapping
 
 
 class FluxPortConfig(BaseModel):
     port_type: Literal["flux"] = "flux"
-    port_mapping: tuple[ControllerRef, ControllerPort]
+    port_mapping: OPXPortMappingLike | OPX1000PortMapping
 
 
 class ReadoutPortConfig(BaseModel):
     port_type: Literal["readout"] = "readout"
-    port_mapping: tuple[OctaveRef, ControllerPort]
+    port_mapping: OPXPortMappingLike | OPX1000PortMapping
     time_of_flight: DurationNsLike
     smearing: DurationNsLike = Field(default=Duration(0, TimeUnit.NS))
 
@@ -119,22 +188,22 @@ class QuantumMachinesControllerInfo(BaseModel):
     ----------
     controller_type : Literal[ControllerType.QUANTUM_MACHINES]
         The type of controller, which is always `ControllerType.QUANTUM_MACHINES`.
-    controllers : dict[ControllerRef, OPXControllerConfig | OPX1000ControllerConfig]
-        A dictionary mapping controller references to their respective configurations.
+    controllers : dict[str, OPXControllerConfig | OPX1000ControllerConfig]
+        A dictionary mapping controller references (str) to their respective configurations.
         The configurations can be either OPXControllerConfig or OPX1000ControllerConfig.
         Derived from OPX Config.
-    octaves : dict[OctaveRef, OctaveConfig]
-        A dictionary mapping octave references to their respective configurations.
+    octaves : dict[str, OctaveConfig]
+        A dictionary mapping octave references (str) to their respective configurations.
         Derived from OPX Config.
-    port_config : dict[PortRef, DrivePortConfig | FluxPortConfig | ReadoutPortConfig]
-        A dictionary mapping port references to their respective port configurations.
+    port_config : dict[str, DrivePortConfig | FluxPortConfig | ReadoutPortConfig]
+        A dictionary mapping port references (str) to their respective port configurations.
         The configurations can be DrivePortConfig, FluxPortConfig, or ReadoutPortConfig.
         Not derived from OPX Config, this is our custom config.
     """
 
     controller_type: Literal[ControllerType.QUANTUM_MACHINES] = ControllerType.QUANTUM_MACHINES
-    controllers: dict[ControllerRef, OPXControllerConfig | OPX1000ControllerConfig] = Field(
+    controllers: dict[str, OPXControllerConfig | OPX1000ControllerConfig] = Field(
         default={},
     )
-    octaves: dict[OctaveRef, OctaveConfig] = Field(default={})
-    port_config: dict[QPUPortRef, DrivePortConfig | FluxPortConfig | ReadoutPortConfig]
+    octaves: dict[str, OctaveConfig] = Field(default={})
+    port_config: dict[str, DrivePortConfig | FluxPortConfig | ReadoutPortConfig]

boulderopalscaleupsdk/device/processor/common.py

@@ -191,8 +191,8 @@ class ComponentParameter(Generic[T]):
                 self.err_minus = None
                 self.err_plus = None
             else:
-                self.err_minus = from_float(to_float(std) / 2.0)
-                self.err_plus = from_float(to_float(std) / 2.0)
+                self.err_minus = from_float(to_float(std))
+                self.err_plus = from_float(to_float(std))
         if (
             not isinstance(calibration_thresholds, EllipsisType)
             and self.err_minus is not None
@@ -259,7 +259,7 @@ def _get_calibration_status_from_thresholds(
     confidence_interval: float,
     calibration_thresholds: CalibrationThresholds,
 ) -> CalibrationStatusT:
-    relative_uncertainty = abs(confidence_interval / value)
+    relative_uncertainty = 0.5 * abs(confidence_interval / value)
 
     if relative_uncertainty < calibration_thresholds.good:
         return "good"

boulderopalscaleupsdk/errors.py

@@ -0,0 +1,21 @@
+# Copyright 2025 Q-CTRL. All rights reserved.
+#
+# Licensed under the Q-CTRL Terms of service (the "License"). Unauthorized
+# copying or use of this file, via any medium, is strictly prohibited.
+# Proprietary and confidential. You may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+#    https://q-ctrl.com/terms
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS. See the
+# License for the specific language.
+
+
+class ScaleUpServerError(Exception):
+    """
+    Exception raised by client based on server behavior.
+    """
+
+    def __init__(self, message: str):
+        super().__init__(message)

boulderopalscaleupsdk/experiments/__init__.py

@@ -17,6 +17,7 @@ __all__ = [
     "T1",
     "T2",
     "CWSIterable",
+    "CZSpectroscopyByBias",
     "Chi01Scan",
     "ConstantWaveform",
     "DragCosineWaveform",
@@ -30,8 +31,10 @@ __all__ = [
     "PowerRabi",
     "PowerRabiEF",
     "Ramsey",
+    "RamseyEF",
     "RangeIterable",
-    "ReadoutClassifierCalibration",
+    "ReadoutClassifier",
+    "ReadoutOptimization",
     "ResonatorSpectroscopy",
     "ResonatorSpectroscopyByBias",
     "ResonatorSpectroscopyByPower",
@@ -53,12 +56,15 @@ from .common import (
     LogspaceIterable,
     RangeIterable,
 )
+from .cz_spectroscopy_by_bias import CZSpectroscopyByBias
 from .drag_leakage_calibration import DragLeakageCalibration
 from .fine_amplitude_calibration import FineAmplitudeCalibration
 from .power_rabi import PowerRabi
 from .power_rabi_ef import PowerRabiEF
 from .ramsey import Ramsey
-from .readout_classifier_calibration import ReadoutClassifierCalibration
+from .ramsey_ef import RamseyEF
+from .readout_classifier import ReadoutClassifier
+from .readout_optimization import ReadoutOptimization
 from .resonator_spectroscopy import ResonatorSpectroscopy
 from .resonator_spectroscopy_by_bias import ResonatorSpectroscopyByBias
 from .resonator_spectroscopy_by_power import ResonatorSpectroscopyByPower

boulderopalscaleupsdk/experiments/cz_spectroscopy_by_bias.py

@@ -0,0 +1,84 @@
+# Copyright 2025 Q-CTRL. All rights reserved.
+#
+# Licensed under the Q-CTRL Terms of service (the "License"). Unauthorized
+# copying or use of this file, via any medium, is strictly prohibited.
+# Proprietary and confidential. You may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+#    https://q-ctrl.com/terms
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS. See the
+# License for the specific language.
+
+from typing import Literal
+
+from pydantic import PrivateAttr
+
+from .common import Experiment
+
+DEFAULT_PREP_PADDING_NS = 16
+DEFAULT_MEASUREMENT_PADDING_NS = 16
+DEFAULT_MIN_DURATION_NS = 16
+DEFAULT_MAX_DURATION_NS = 200
+DEFAULT_TIME_STEP_NS = 8
+DEFAULT_RECYCLE_DELAY_NS = 500_000
+DEFAULT_SHOT_COUNT = 200
+
+
+class CZSpectroscopyByBias(Experiment):
+    """
+    Parameters for running a Ramsey experiment.
+
+    Parameters
+    ----------
+    control_transmon : str
+        The control transmon to target in the experiment.
+    target_transmon : str
+        The target transmon to pair with the control transmon.
+    min_vp : float
+        The minimum voltage point, in volts.
+    max_vp : float
+        The maximum voltage point, in volts.
+    num_vp : int
+        The number of voltage points to sample.
+    min_duration_ns : int
+        The minimum duration for the pulse in the experiment, in nanoseconds.
+    max_duration_ns : int
+        The maximum duration for the pulse in the experiment, in nanoseconds.
+    duration_step_ns : int
+        The step size for the duration, in nanoseconds.
+    prep_padding_ns : int
+        The padding to apply before the CZ pulse, in nanoseconds.
+    measurement_padding_ns : int
+        The padding to apply after the CZ pulse, in nanoseconds.
+    recycle_delay_ns : float
+        The delay time between consecutive shots of the experiment, in nanoseconds.
+        Defaults to 500000 ns.
+    shot_count : int,
+        The number of shots to be taken in the experiment.
+        Defaults to 200.
+    batch_analysis : bool
+        Whether to perform batch analysis on the results.
+    spectroscopy_waveform : ConstantWaveform
+        The waveform to use in the spectroscopy pulse.
+    """
+
+    _experiment_name: str = PrivateAttr("cz_spectroscopy_by_bias")
+
+    control_transmon: str
+    target_transmon: str
+    coupler: str
+    min_vp: float
+    max_vp: float
+    num_vp: int
+    coupler_flux_vp: float
+    min_duration_ns: int = DEFAULT_MIN_DURATION_NS
+    max_duration_ns: int = DEFAULT_MAX_DURATION_NS
+    duration_step_ns: int = DEFAULT_TIME_STEP_NS
+    prep_padding_ns: int = DEFAULT_PREP_PADDING_NS
+    measurement_padding_ns: int = DEFAULT_MEASUREMENT_PADDING_NS
+    recycle_delay_ns: int = DEFAULT_RECYCLE_DELAY_NS
+    shot_count: int = DEFAULT_SHOT_COUNT
+    batch_analysis: bool = False
+    update: Literal["auto", "off", "prompt"] = "auto"

boulderopalscaleupsdk/experiments/power_rabi.py

@@ -44,7 +44,7 @@ class PowerRabi(Experiment):
     shot_count : int, optional
         The number of shots to take. Defaults to 400.
     pulse_vp : float, optional
-        The voltage per pulse, in Volts. Defaults to the amplitude of the X gate.
+        The voltage per pulse, in volts. Defaults to the amplitude of the X gate.
     measure_waveform : ConstantWaveform or None, optional
         The waveform to use for the measurement pulse.
         Defaults to the measurement defcal.

boulderopalscaleupsdk/experiments/power_rabi_ef.py

@@ -44,7 +44,7 @@ class PowerRabiEF(Experiment):
     shot_count : int, optional
         The number of shots to take. Defaults to 400.
     pulse_vp : float, optional
-        The voltage per pulse, in Volts. Defaults to the amplitude of the X gate.
+        The voltage per pulse, in volts. Defaults to the amplitude of the X gate.
     measure_waveform : ConstantWaveform or None, optional
         The waveform to use for the measurement pulse.
         Defaults to the measurement defcal.