Release Notes - Pre-release versions¶
Pre-Release 27.1.0b1¶
Release date 19.11.2026
Requires: LabOne 26.10
Supports: Applications Library 27.1.0b1
DSL¶
- Functionality Added
acquisition_typetoacquire(). It overrides the acquisition type of the real-time loop for that acquisition. On ZQCS, this allows experiments to mix acquisition types, for example, starting with active reset (AcquisitionType.DISCRIMINATION) followed by integration acquisitions and ending with aRAWacquisition of calibration traces. This feature is not supported on SHFQA, SHFSG, HDAWG or UHFQA devices.
OpenQASM¶
- Functionality Improved the OpenQASM importer's error messages for unsupported statements and expressions.
- Functionality The built-in OpenQASM 3 parser no longer crashes the Python process on very deeply nested programs, and rejects a statement that nests deeper than 256 levels with an error. It also parses short programs faster and reports the errors of large malformed programs much faster.
- Functionality The built-in OpenQASM 3 parser now releases the Python GIL while it parses a program, so other Python threads keep running in the meantime.
- Documentation Added an overview page of the OpenQASM support with a short example of running a Qiskit circuit, and a tutorial, Running Qiskit Circuits with LabOne Q, which takes a Qiskit circuit to measurement results and shows parameterized circuits and physical qubits.
Compiler¶
- Functionality Experiments that reserve many signals, such as those built from quantum operations, now compile faster and use less memory, because the compiler no longer adds an operation for each reserved signal.
- Functionality In chunking error messages, we now refer to the "sweep length" as the "number of sweep iterations". This is to clarify that chunking rules refer to the "length" of sweeps with respect to the number of sweep iterations, rather than the length in time.
- Functionality Added support for chunking multiple sibling sweeps (sweeps in the same parent section) in a real-time experiment, if they have the same number of iterations and the same
auto_chunkingandchunk_countsettings. - Bug Fix Fixed a bug where strict timing mode was being ignored inside
casesections. - Bug Fix Fixed a bug where a near-time sweep of an oscillator frequency with complex values raised a
PanicException. It now raises "Oscillator frequency must be a real number (integer or float)." - Bug Fix Fixed a bug where setting the frequency of local oscillators belonging to signals mapped to HDAWG and UHFQA instruments to 0 resulted in a compilation error. Setting any other value continues to give an error, as these instruments do not contain upconverters.
Controller¶
- Functionality The controller service now gives each client an experiment queue of its own. It still runs one experiment at a time, taking the next one from each client in turn, so a long queue of one client no longer delays the others. Each client's experiments run in the order the client submitted them. Remote clients identify themselves with the
X-LabOneQ-Client-Idrequest header. An experiment whose client never connects for its near-time callbacks now delays only that client's experiments. - Functionality Raw-acquisition results now report the sampling rate of their
"samples"axis in the newsampling_rateattribute ofAcquiredResult. The value isNonefor other acquisition types and for results loaded from serialized files saved by LabOne Q 26.10.x or earlier. - Functionality An error confined to one near-time step no longer stops the experiment. If a near-time callback raises, if the results of a step cannot be read or processed, or if the instruments report errors after a step, LabOne Q records the error on its step, runs the remaining steps and keeps their results. Previously each of these errors stopped the run. An error before anything has been submitted to the instruments, from a near-time callback or otherwise, still stops the run immediately. If the first step reached no instrument, the error that stopped the run ends with "Execution stopped." and the errors of the step's chunks follow it.
Session.runstill raises aLabOneQControllerExceptiononce the run has ended, listing every error under "Error(s) occurred during experiment execution:", andsession.resultsholds the data of the other steps. Each entry ofResults.execution_errorsgives the near-time loop indices of its step, followed by the chunk index if the error concerns a single chunk. An error that stopped the run comes first. To stop a sweep from a near-time callback, callcontext.abort_execution(). - Bug Fix Fixed a bug where
Session.run()rejected valid arguments of a near-time callback that is registered both on the LabOne Q controller service and in the session. - Bug Fix Fixed a bug where the controller service refused experiments from a client of another LabOne Q version with "LabOne Q version mismatch". It now accepts any client at or above its minimum client version.
- Bug Fix Fixed a bug where, if a QCCS readout instrument returned fewer results than the experiment acquires, LabOne Q only logged "Results for job id(s) ... are missing." and returned the results with the missing values set to NaN. LabOne Q now records the missing results as errors in
Results.execution_errors, andSession.runraises. - Bug Fix Fixed a bug where, if a
Sessionwas connected to a LabOne Q controller service and the experiment called a near-time callback that is registered neither in the session nor on the service, the run could wait 60 seconds and then fail. The call now fails immediately.
Serializer¶
- Functionality
save,to_jsonandto_dictnow accept aSweepParameterorLinearSweepParameteron its own. Before, they raised "No serializer available for object of type laboneq.dsl.parameter.SweepParameter." unless the parameter was part of anExperimentorCalibration. - Bug Fix Fixed a bug where saving an experiment failed with
AttributeError: 'str' object has no attribute 'uid'when theplay_afterof a section listed sections by UID.
Applications Library¶
-
Functionality Breaking change: The single-qubit randomized benchmarking experiment and its analysis moved out of
contribinto the core of the Applications Library, and no longer need Qiskit. Import them fromlaboneq_applications.experiments.single_qubit_rbandlaboneq_applications.analysis.single_qubit_rbinstead oflaboneq_applications.contrib.experiments.single_qubit_randomized_benchmarkingandlaboneq_applications.contrib.analysis.single_qubit_randomized_benchmarking. The experiment workflow is namedsingle_qubit_rbinstead ofsingle_qubit_randomized_benchmarking. The experiment also changed in the following ways:- It draws its Clifford sequences itself and implements each Clifford with the fewest pulses, so the same
seedgives different sequences than before. Each qubit plays its own random sequences instead of the same ones, and every sequence ends right before the measurement. - Its
gate_mapaccepts only the gatessx,xandrz, of which it needssxandrz. Remove other gates, such as"id", from yourgate_map. - It plays its Clifford gates on the transition that the
transitionoption sets. Withtransition="ef", it used to prepare the e state and then play the gates on the ge transition. The quantum operations ofgate_mapnow take the transition as the keyword argumenttransition; add it to custom operations. - It resets the qubits actively before every Clifford sequence and calibration trace when the
active_resetoption is set, like the other tune-up experiments. It used to ignore the option. generate_clifford_sequencestakes the qubits as its first argument, returns the sequences per qubit UID, the form thatcreate_experimenttakes, and no longer takesoptions.- The plot of the analysis shows the average fidelity of the Clifford gates,
(1 + p) / 2, as "Clifford fidelity". It used to show the depolarizing parameterpof the fitted decay as "gate fidelity", which understated the fidelity. - Functionality Added the
chunk_countandauto_chunkingexperiment options, with the same defaults and behavior as indsl.sweep.chunk_countsplits the real-time sweep into that number of chunks.auto_chunkinglets the compiler split the sweep into as many chunks as needed to stay within the instruments' resource limits, usingchunk_countas the initial guess. - Functionality The
extract_sampling_ratetask of the time-traces analysis workflow now reads the sampling rate from thesampling_rateattribute of the acquired raw traces, instead of deriving it from their length andreadout_integration_length. Breaking change: It raises an error if the results do not provide a sampling rate, unless thesampling_rateoption is set. - Functionality Breaking change: The
rxandryoperations ofTunableTransmonOperationsnow wrap the angle to [-π, π] on the "ge" transition and to [-2π, 2π] on any other.rx(q, 3 * np.pi / 2)plays the pulse ofrx(q, -np.pi / 2)instead of 1.5 times the π pulse amplitude, and a swept angle that passes π changes the sign of the amplitude there. Passamplitudeto choose the amplitude yourself. - Functionality Breaking change: The coupled-transmon demo platform moved out of
contribto the tunable-coupler QPU type. Import it fromlaboneq_applications.qpu_types.tunable_coupler.demo_platform_coupled_transmonsinstead oflaboneq_applications.contrib.qpu_types.demo_platform_coupled_transmons. -
Functionality Breaking change: The two-qubit randomized benchmarking experiments
two_qubit_rbandtwo_qubit_irbmoved out ofcontriband no longer need Qiskit. Import them fromlaboneq_applications.experimentsinstead oflaboneq_applications.contrib.experiments.two_qubit, and their analyses fromlaboneq_applications.analysisinstead oflaboneq_applications.contrib.analysis.two_qubit. Their tasks,gate_mapand the results of the interleaved analysis changed; see their API reference. They also changed in the following ways: -
Each qubit pair plays its own random Clifford sequences, so the pairs must not share qubits.
two_qubit_rbused to play the same sequences on every pair, andtwo_qubit_irbplayed only the first pair. - Both analyses take the qubit pairs as UIDs only.
- The workflow of
two_qubit_irbis namedtwo_qubit_irbinstead oftwo_qubit_coupler_irband takesTuneUpWorkflowOptionsinstead ofTwoQubitCouplerIRBWorkflowOptions. Its analysis workflow is namedanalysis_workflow, as in the other experiments, so look up its results asresult.tasks["analysis_workflow"]instead ofresult.tasks["two qubit IRB analysis workflow"]. - A folder store saves the qubit pairs of their tasks. For
two_qubit_rb, it used to log a warning instead, since it cannot save nested lists of quantum elements. - They raise an error for the
eftransition.two_qubit_rbused to prepare the e state and then play its gates on the ge transition. - They raise an error unless the
averaging_modeandacquisition_typeoptions areSINGLE_SHOTandDISCRIMINATION. With other values, thetwo_qubit_rbanalysis used to return wrong populations without an error. - They reset the qubits actively before every sequence when the
active_resetoption is set.two_qubit_rbused to ignore the option, andtwo_qubit_irbtook theadd_resetoption instead. - The
two_qubit_rbanalysis averages single-shot data over the shots of each sequence. It used to average over the sequences when there were as many shots as sequences. - The plot of the
two_qubit_rbanalysis shows the average fidelity of the two-qubit Clifford gates,1 - 3/4 (1 - α), as "Clifford fidelity". It used to show the depolarizing parameterαof the fitted decay as "fidelity", which understated the fidelity. - Functionality Added a
transitionoption to the qubit spectroscopy experiment and analysis to support e-f transition measurements. Added atransitionargument to thequbit_spectroscopy_drivequantum operation. - Bug Fix Fixed a bug where, in
evaluate_experimenttasks, the amplitude Rabi, lifetime measurement, Hahn echo, Ramsey, and time Rabi experiment workflows did not automatically evaluate the parameter of the transition selected with thetransitionoption. In addition, amplitude fine experiment workflows now automatically evaluate the parameter that they update. - Documentation Added the how-to guide Single-Qubit Randomized Benchmarking, which runs the single-qubit randomized benchmarking experiment of the Applications Library.
- Documentation Added the how-to guides Two-Qubit Randomized Benchmarking and Two-Qubit Interleaved Randomized Benchmarking, which run the two-qubit randomized benchmarking experiments of the Applications Library.
- Documentation The how-to guide One- and Two-Qubit Randomized Benchmarking in LabOne Q with Qiskit now generates its sequences with Qiskit alone instead of Qiskit Experiments, runs the two-qubit sequences with the CZ gate of tunable couplers, and also runs the randomized benchmarking experiment of the Applications Library.
- Removal Breaking change: In the bosonic
swap_calibration,snap_calibrationandwigner_tomography_demonstratorexperiments,chunk_count=0no longer enables auto-chunking; instead setauto_chunking=True. TheTuneupExperiment2QOptionsclass of the two-qubitcontribexperiments has been removed; instead useTuneupExperimentOptions, which now providesauto_chunking. - Removal Breaking change: Renamed the
resonator_spectroscopy_amplitude_qfluxexperiment workflow toresonator_spectroscopy_qflux, consistent withqubit_spectroscopy_qflux. - Removal Breaking change: The Applications Library no longer depends on Qiskit or Qiskit Experiments, which brought IBM's cloud SDKs into every installation. Its randomized benchmarking experiments generate their Clifford sequences themselves. To keep using Qiskit with LabOne Q, for example to export OpenQASM programs, install it yourself with
pip install qiskit. - Removal Support for Python 3.10 has been dropped. The Applications Library now requires Python 3.11 or newer.
- It draws its Clifford sequences itself and implements each Clifford with the fewest pulses, so the same
General¶
- Removal Support for Python 3.10 has been dropped. LabOne Q now requires Python 3.11 or newer.
Pre-Release 26.10.0b4¶
Release date 16.10.2026
Requires: LabOne 26.7
Supports: Applications Library 26.10.0b4
DSL¶
- Bug Fix Fixed a bug where type checkers rejected imports such as
from laboneq.dsl.enums import AveragingMode. The public names oflaboneq.dsl.enumsare now declared in__all__. - Removal The
QPU.measure_section_lengthmethod has been removed. The functionality has been moved to implementations ofQuantumOperationsfor qubit types where this property is meaningful. - Removal The
QuantumElement.loadandQuantumElement.savemethods have been removed after deprecation in version 2.43.0. Instead usesave(q, filename)andload(filename)fromlaboneq.serializers. - Removal The
user_definedattribute inTransmonParametershas been removed after deprecation in version 2.58.0. Use thecustomattribute from theQuantumParametersparent class instead. Quantum elements and quantum parameters serialized earlier still load; theiruser_definedentries are moved intocustom.
OpenQASM¶
- Functionality LabOne Q now parses OpenQASM 3 programs with a faster parser built into the wheels. It accepts language versions 3.0 to 3.2 and rejects a construct newer than the version a program declares. Source installs from GitHub fall back to the
openqasm3andopenpulsepackages, andLABONEQ_OPENQASM_PARSERforces eitherbuiltinoropenpulse.
Compiler¶
- Functionality The QCCS resource usage report logged at compile time now lists, for each near-time step, only the AWGs whose program changes in that step, so its rows add up to the reported total. It no longer repeats every AWG in every step.
- Bug Fix Fixed a bug where an experiment with a
matchon a near-time sweep parameter failed to compile when the cases used different near-time sweep parameters. - Bug Fix Fixed a bug where a near-time step that returns to an earlier real-time program ran the previous step's program instead, e.g., in an outer near-time sweep around an inner one. Fixed
CompiledExperiment.estimated_runtimefor near-time sweeps. - Bug Fix Fixed a bug where an intermittent
module 'zhinst' has no attribute 'core'error occurred in the first compilation in a Python process.
Controller¶
- Removal The
use_async_apiargument ofSession.connecthas been removed after deprecation in version 2.52.0. It has had no effect since then.
Applications Library¶
- Functionality Added the
ac_stark_vs_powerexperiment workflow and its analysis workflow (laboneq_applications.contrib.experiments.ac_stark_shift_vs_powerandlaboneq_applications.contrib.analysis.ac_stark_shift_vs_power). In this experiment, qubit spectroscopy is performed while the amplitude of an off-resonant qubit drive is varied, which causes a shift in the qubit frequency. By fitting the relationship between the frequency shift and the amplitude, we can determine the qubit frequency with greater precision. - Functionality The single-qubit randomized benchmarking experiment no longer routes its Clifford sequences through OpenQASM. Parsing the OpenQASM text back was the largest cost of building the experiment, and dropping it makes
create_experimentabout ten times faster. Theexperiment_workflowinterface and the pulses it produces are unchanged; inside it,create_sq_rb_qasmis nowgenerate_clifford_sequencesand returns the gates themselves,create_experimenttakes them asclifford_sequences, andadd_qasm_operationsandget_gate_mapare gone, the latter becausegenerate_clifford_sequencesnow applies the default gate map itself. - Functionality Experiments now accept a 1D sweep for a single quantum element passed in a list, such as
[q0], the same as for a bare quantum element. - Functionality Breaking change: The power and voltage range quantum element parameters now default to
Noneinstead of a fixed value. These ranges are instrument specific, so the library no longer imposes a default: when a parameter isNone, the range configured on the instrument is used. - Functionality Added a coupled-transmon demo platform,
laboneq_applications.contrib.qpu_types.demo_platform_coupled_transmons, which builds tunable transmon qubits connected in a chain by tunable couplers, including the QPU topology edges required by the coupler-mediated two-qubit gates and experiments. - Functionality Added a qubit-driven flavor to the tunable-coupler CZ gate:
CzParametersgained an optionalcontrol_pulsedescribing a parametric flux drive on the qubit, andTunableCouplerOperationsgained theiswapanddischarge_couplerquantum operations, with the accompanyingIswapParameters. - Functionality Added a two-qubit interleaved randomized benchmarking workflow (
two_qubit_coupler_irb), inlaboneq_applications.contrib.experiments.two_qubit.two_qubit_irbwith its analysis workflow inlaboneq_applications.contrib.analysis.two_qubit.two_qubit_irb. - Functionality Added the
coupler_flux_rangeparameter toTunableCouplerParameters, which controls the output range for the flux control line. - Functionality Added the
qubit_spectroscopy_qfluxexperiment workflow and its analysis workflow (laboneq_applications.contrib.experiments.qubit_spectroscopy_qfluxandlaboneq_applications.contrib.analysis.qubit_spectroscopy_qflux), which sweep the qubit drive frequency against the amplitude of a flux pulse applied to the qubit flux line, in order to map out the flux dependence of the qubit transition frequency. - Functionality Added the
resonator_spectroscopy_amplitude_qfluxexperiment workflow (laboneq_applications.contrib.experiments.resonator_spectroscopy_amplitude_qflux), which sweeps the readout frequency against the amplitude of a flux pulse applied to the qubit flux line. The workflow accepts multiple qubits, which are swept in parallel. Since the experiment sweeps the frequency of the hardware oscillator of the readout line, parallel execution is only possible for qubits whose measure lines use distinct QA channels. - Functionality Added the
update_qpu_edgestask, which updates the parameters of QPU topology edges. It behaves likeupdate_qpu, but accepts the edge keys as strings of the form"tag:source_node_uid:target_node_uid"instead of tuples, so that analysis tasks can return edge parameters in a form the logbook stores can serialize. - Functionality Added the chevron, JAZZ and phase-correction calibration workflows for the qubit-driven CZ gate, in
laboneq_applications.contrib.experiments.two_qubitandlaboneq_applications.contrib.analysis.two_qubit. - Functionality The resonator spectroscopy experiment workflows (
resonator_spectroscopyandresonator_spectroscopy_amplitude) now accept multiple qubits, whose readout frequencies are swept in parallel. Since these experiments sweep the frequency of the hardware oscillator of the readout line, parallel execution is only possible for qubits whose measure lines use distinct QA channels. The workflows raise a clear error when two of the requested qubits share a QA channel. The formerqubitargument of these workflows (and of the resonator spectroscopy analysis workflow) is deprecated: it still works and raises aFutureWarning; usequbitsinstead. - Functionality
TunableTransmonOperationsnow has the operationflux_pulse, which plays a pulse on the qubit flux line. The pulse parameters come from the new qubit parameterflux_pulse, a constant pulse by default. - Bug Fix Fixed a bug where
TunableCouplerandBosonicQubitalways applied a 0 Hz local oscillator andPortMode.LFto theirflux/swap_drivelines. Breaking change: For a line driven by an SG channel, set the newflux_on_sg_channel/swap_drive_on_sg_channelparameter toTrue; leave itFalsefor a line on a baseband channel. - Bug Fix Fixed a bug where the measurement QNDness experiment workflow led to an error when
do_analysiswas set toFalse. - Bug Fix Fixed a bug where the name for the signal propagation delay experiment workflow was unspecified.
- Bug Fix Fixed a bug where the resonator photons time-resolved
contribexperiment incorrectly used qubits instead of validated qubits in thecreate_experimenttask. - Bug Fix Fixed a bug where the TWPA
calibrate_cancellationexperiment selected the wrong readout local oscillator frequency. The readout local oscillator frequency is now set based on the pump frequency. - Bug Fix Fixed a bug where the
set_readout_amplitudequantum operation of the tunable transmons marked the whole experiment calibration, instead of the calibration of the measure line, when guarding against being called twice on the same signal. As a result, setting the readout amplitude of a second qubit in the same experiment raised aRuntimeError. The guard is now per measure line, so the readout amplitude of several qubits can be set in one experiment. - Documentation Added a how-to guide on calibrating a CZ gate with tunable couplers.
- Documentation Improved the memory spectroscopy how-to guide and added five how-to guides for bosonic qubit experiments: Displacement Calibration, Selective Transmon Rx Calibration, SWAP Calibration, Wigner Tomography, and SNAP Calibration.
- Deprecation The validation and conversion functions in
laboneq_applications.core.validationhave been deprecated. Uselaboneq_applications.conversioninstead. - Deprecation The Applications Library is now developed and released together with LabOne Q, and its version always matches the LabOne Q version. Its release notes are part of the LabOne Q release notes. The
laboneq-applicationsrepository on GitHub receives its source code and its release notes with each release, and installing the package withpip install laboneq-applicationsis unchanged. The branches of that repository now follow those of the LabOne Q repository: releases go tomain, and patch releases torelease-X.Ybranches such asrelease-26.10. It no longer getsrelease-X.Y.Xbranches or a branch for each beta release.
General¶
- Deprecation Support for Python 3.10 is deprecated and will be removed in the stable release v27.01. Please upgrade to Python 3.11 or later.
Pre-Release 26.10.0b3¶
Release date 25.09.2026
Requires: LabOne 26.7
Requires: ZQCS Host Software nightly-20260923 (when using ZQCS)
Supports: Applications Library 26.10.0b1
DSL¶
- Functionality Added a cache for multiple dispatching of quantum operations, which results in noticeably faster build times for experiments that call many quantum operations. For example, a randomized benchmarking sequence built from quantum operations builds up to 1.8 times faster, and a batch of OpenQASM programs about 1.2 times faster.
- Bug Fix Fixed a bug where building DSL sections on worker threads failed with
AttributeError: '_thread._local' object has no attribute 'active_contexts'. This affected experiment construction parallelized across threads, where each worker opens a section with an explicituidand the main thread assembles the finished sections into the experiment.
Compiler¶
- Bug Fix Fixed a bug where a swept amplitude or swept
increment_oscillator_phasewas applied twice per sweep step on a compressible pulse. The sweep then drifted away from the requested values, and the tail of each pulse played at the wrong amplitude or phase. This affects amplitude andincrement_oscillator_phasesweeps on the HDAWG, andincrement_oscillator_phasesweeps on the SHFSG. - Bug Fix Fixed a bug where specifying a local oscillator on an unsupported channel type was silently ignored. This now raises a compiler error.
Controller¶
- Functionality Added a
run_experimentfunction to the remote controllers, which submits the experiment and serves its near-time callbacks over the WebSocket callback channel. - Functionality When a
Sessionis connected to a LabOne Q controller service (i.e., theDeviceSetupcarries the reserved controller-service server entry),run()now serves the session's registered near-time callbacks from the client process instead of rejecting them.
Tutorials¶
- Bug Fix Fixed a bug where one of the single-qubit Clifford gates would never be part of the randomly generated Clifford gate sequence returned by
generate_play_rb_pulsesin the randomized benchmarking tutorial notebook.
Applications Library¶
- There is no Applications Library beta release accompanying this pre-release. The next Applications Library release will be the stable 26.10.0.
General¶
- Deprecation Getting the laboneq package version via
laboneq._version.get_versionhas been deprecated and will be removed in the future. Uselaboneq.__version__instead.
Pre-Release 26.10.0b2¶
Release date 11.09.2026
Requires: LabOne 26.7
Requires: ZQCS Host Software 26.9.0b1 (when using ZQCS)
Supports: Applications Library 26.10.0b1
DSL¶
- Bug Fix Fixed a bug where
DeviceSetupsilently swapped I and Q for HDAWG and UHFQA IQ signal connections whose ports list the Q channel before the I channel. Such connections are now rejected. - Removal Removed the deprecated
instrument_listsection of the device setup descriptor and the correspondinginstrument_listargument ofDeviceSetup.from_dicts(). Useinstrumentsinstead; the contents are unchanged. A descriptor that only hasinstrument_listnow fails with'instruments' section is mandatory in the setup descriptor.
OpenQASM¶
- Bug Fix Fixed a bug where
OpenQASMTranspiler.section()added the program's quantum operations to an enclosing DSL context, such asexp.section(), leading to duplicated sections or dropped operations, such as delays.
Compiler¶
- Bug Fix Fixed a bug where sections that span signals with different sample rates were padded to the sequencer grid: mixing HDAWG and UHFQA signals in one section inserted gaps of up to 13.3 ns between pulses and stretched the section to match. Timings in existing experiments may shift accordingly. Sections containing acquisitions, triggers or sweeps, or with
on_system_grid=True, are unaffected. - Removal Removed the deprecated
HDAWG_FORCE_COMMAND_TABLE,SHFSG_FORCE_COMMAND_TABLE,SHFQA_MIN_PLAYWAVE_HINTandSHFQA_MIN_PLAYZERO_HINTcompiler settings. The options had no effect and therefore have no replacement functionality. - Removal Removed the deprecated
CompiledExperiment.experiment_dictattribute. It has been deprecated since version 2.14.0 and was alwaysNonefor a freshly compiled experiment. UseCompiledExperiment.experimentinstead.
Controller¶
- Bug Fix Fixed a bug where, on Python 3.10 and 3.11, canceling an experiment while the controller waited for its client callback channel to attach could be silently ignored, causing experiment execution to hang.
- Documentation Fixed stale documentation links to
zhinst-toolkitthat pointed to removeddocs.zhinst.comresources.
Serializer¶
- Bug Fix Fixed a bug where
CompiledExperimentserialization failed withModuleNotFoundError: No module named 'xarray'when the optionalxarraydependency is not installed. -
Removal
CompiledExperimentnow contains the compiler's output bytes and is serialized into a Python object view when the.scheduled_experimentattribute is accessed.The deprecated
laboneq.dsl.serialization.Serializernow delegates tolaboneq.serializersfor compiled experiments, so it reads and writes the same format. -
Removal Removed serialization support for
xarray.DataArrayandxarray.Datasetobjects, which existed only in the deprecated legacy serializer.AcquiredResult.to_xarray()andAcquiredResults.to_xarray()are unaffected.
Contrib¶
- Removal Removed empty package
laboneq.contrib.example_helpers.descriptors.
Applications Library¶
- There is no Applications Library beta release accompanying this pre-release. The next Applications Library release will be the stable 26.10.0.
Pre-Release 26.10.0b1¶
Release date 13.08.2026
Requires: LabOne 26.7
Requires: ZQCS Host Software 26.8.0b2 (when using ZQCS)
Supports: Applications Library 26.10.0b1
DSL¶
- Functionality
DeviceSetup.add_connections()now lets aSignalConnection's entire ports spec be a single, already-defined logical signal (given as its uid/path string or aLogicalSignalobject), resolving to the raw port(s) that signal is already connected to. This makes it easy to multiplex an additional signal onto an existing port without repeating its raw port ID by hand.
Compiler¶
- Bug Fix Fixed a bug where an HDAWG sequence whose distinct waveforms exceed the FPGA waveform-start memory would silently produce misaligned output. LabOne Q now detects this and raises a resource-limitation error; when automatic chunking is enabled, the chunk count is increased to resolve it.
- Removal Removed deprecated methods
CompiledExperiment.replace_pulseandCompiledExperiment.replace_phase_increment. Instead, modify the experiment by putting the new pulse and/or phase increment in there and recompile the experiment. NOTE: the methodsRuntimeContext.replace_pulseandRuntimeContext.replace_phase_incrementare preserved and can still be used to apply replacements in NT callbacks (these methods leave the compiled experiment unchanged). - Removal Removed deprecated properties:
CompiledExperiment.src,CompiledExperiment.waves,CompiledExperiment.recipe,CompiledExperiment.wave_indices,CompiledExperiment.command_tables, andCompiledExperiment.schedule. We no longer support these as top-level properties ofCompiledExperiment. As an end user, you are not supposed to depend on this; however, for debugging or learning purposes you can still access the same information through the artifacts in the compiled experiment. -
Removal Removed support for arbitrary Python objects as pulse parameter values and near-time callback arguments.
Such values were supported back when nothing serialized the experiment between compilation and execution by the Controller: the compiler pickled them internally to carry them to the pulse sampler or near-time callback that consumes them, and the pickled bytes never left the process. They were never compatible with serialization, though: opaque Python types have always failed once a JSON serialization step was involved, such as saving the experiment.
They are now rejected up front, when the experiment is compiled, with a
LabOneQException. The set of supported value types therefore no longer depends on whether the experiment gets serialized, and the compiler no longer pickles anything.The supported value types for
pulse_parametersand for the arguments ofExperiment.callare:int,float,complex,str,bytes,bool,None,SweepParameterorLinearSweepParameter- lists of the above
- dictionaries of the above with
strkeys
The lists and dictionaries may be nested and need not have homogeneous value types. A sweep parameter, however, must be the pulse parameter or callback argument value itself: nested inside a list or dictionary it is not resolved, and reaches the pulse sampler or near-time callback as the sweep parameter object rather than the value of the current sweep step.
Note that JSON-like data is already covered: nested lists and
str-keyed dictionaries of the types above can be passed as is. To pass a value of any other type, convert it to a supported one:- NumPy arrays: pass
array.tolist(), orarray.tobytes()and rebuild the array withnumpy.frombuffer, which preserves thedtypeexactly and stays compact for long arrays. - Anything else (a
set, adatetime, an instance of your own class, ...): serialize the value tobytesyourself and deserialize it inside the pulse sampler or near-time callback that consumes it.
import numpy as np from laboneq.simple import pulse_library @pulse_library.register_pulse_functional def my_pulse(x, **kwargs): coefficients = np.frombuffer( kwargs["coefficients"], dtype=np.float64 ) # bytes -> ndarray return np.polyval(coefficients, x) coefficients = np.array([0.1, -0.5, 1.0]) exp.play(signal="drive", pulse=my_pulse("p", coefficients=coefficients.tobytes()))
Serializer¶
- Bug Fix Fixed a bug where JSON serialization of
CompiledExperimentfailed when usingOutputRoutewith an undefinedphase_shift.
Installation and Imports¶
- Functionality LabOne Q now declares a
zqcsextra that installs the correct version of the ZQCS backend package. - Functionality Improved
laboneq.simpleimport time by changing some eager package imports to lazy ones. - Bug Fix Fixed a bug where two installed distributions providing the same backend would either register the backend twice or report a confusing missing-module warning. LabOne Q now fails to import, naming both distributions so you can uninstall the obsolete one.
Applications Library¶
- Documentation Added a new page Deployment to the user manual explaining our recommended way to work with the Applications Library repository.
- Documentation Fixed mistakes and inconsistencies in experiment docstring code examples.
- Documentation Updated the Qiskit VQE example notebook to remove the usage of the deprecated method
CompiledExperiment.replace_pulse, and to demonstrate a more explicit parameter update process.
Pre-Release 26.7.0b6¶
Release date 16.07.2026
Requires: LabOne 26.4
Requires: ZQCS Host Software 26.7.0b3 (when using ZQCS)
Supports: Applications Library 26.7.0b6
Controller¶
- Bug Fix Fixed a bug where outputs on different AWG cores of a single HDAWG were not synchronized (e.g. channels 1 and 3 out of sync).
Applications Library¶
- Bug Fix The behavior of
numpy.linalg.eigchanged in version2.5.0of numpy (https://numpy.org/doc/stable/release/2.5.0-notes.html#linalg-eig-and-linalg-eigvals-now-always-return-complex-arrays). The code was updated to handle the change.
Pre-Release 26.7.0b5¶
Release date 02.07.2026
Requires: LabOne 26.4
Supports: Applications Library 26.7.0b5
DSL¶
- Bug Fix Fixed a bug where runtime type validation for FIR precompensation coefficients failed with NumPy 2.5.
Compiler¶
- Bug Fix Fixed a bug where a compiler error occurred in experiments with near-time sweeps and a static SHFPPC configuration.
Automation¶
- Functionality The automation web viewer now implements CSRF protection by rejecting state-changing requests (non-GET/HEAD) whose Origin or Referer header does not match the request host, and rejecting those sending neither.
Serializer¶
- Bug Fix Fixed a bug where deserialization of compiled experiments that use an SHFPCC device with null amplifier pump parameters would fail.
- Bug Fix Fixed a bug where attempting to serialize an experiment containing
reset_oscillator_phasewould raise an error.ResetOscillatorPhaseoperations are now correctly serialized and deserialized. - Bug Fix Fixed a bug where a single-shot result of the form
np.array(X + jY)was deserialized asnp.array([X + jY]).
Pre-Release 26.7.0b4¶
Release date 18.06.2026
Requires: LabOne 26.4
Supports: Applications Library 26.7.0b4
DSL¶
-
Functionality Added an option for the caller of a quantum operation to override the pulse name used by
create_pulse.The
create_pulsefunction used inside many quantum operations allows the implementation of the quantum operation to directly supply a pulse name, which is used to identify the kind of pulse and as part of the pulse UID.However, a user may wish to generate different pulse objects even when using the same quantum operations. For example, in an experiment with M measure operations, a user may wish to replace a specific subset of those measurements with new pulses.
To enable this,
create_pulsenow accepts a new special key named name in the dictionary of pulse options. This allows the user to override the supplied name by passing, for example,qop.measure(q, handle, readout_pulse={"name": "my-special-tag"})when calling a quantum operation.
Compiler¶
- Functionality Removed
FIRCompensation.strict. When waveform memory is exhausted and pulse merging occurred (due to FIR precompensation tail or overlapping pulses), the error now includes a note identifying the merged pulses and their combined size. - Bug Fix Fixed a bug where automute was not correctly applied when multiplexing output.
Controller¶
- Functionality Changed the device setup compatibility verification between compilation and execution. Experiments compiled with previous versions of LabOne Q may need recompilation.
- Bug Fix Fixed a bug where "zi:fw:19" execution errors occurred with (auto-)chunking on HDAWG.
Pre-Release 26.7.0b3¶
Release date 05.06.2026
Requires: LabOne 26.4
Supports: Applications Library 26.7.0b3
DSL¶
- Documentation Added reference documentation for
for_eachandsweep_range.
Compiler¶
- Bug Fix Fixed a bug where explicitly setting
PortMode.RFon a QA channel had no effect and the hardware used the LF path instead.
Controller¶
- Bug Fix Fixed a bug where a timeout error could occur during experiments using pipelined execution (chunked) with large result sizes. The timeout calculation now accounts for the GW-to-FW result transfer time, which was previously unaccounted for and could cause premature timeouts on experiments with many jobs and long readout blocks.
Automation¶
- Functionality Added a
skip_passedargument/attribute to theAutomationLayerclass that makes it possible to skip running passed nodes.
Applications Library¶
- Functionality Added the following experiment and analysis workflows to
contrib, useful for two-qubit tune-up: single-qubit phase correction for parametric CZ calibration (para_cz_corr_sq_phases_tc), parametric CZ flux frequency vs amplitude calibration (para_cz_flux_freq_vs_amp_tc), parametric CZ flux frequency vs duration calibration (para_cz_flux_freq_vs_dur_tc), parametric CZ pulse-duration calibration (para_cz_flux_pulse_dur_tc), parametric CZ frequency vs RZ phase (para_cz_freq_vs_phase), two-qubit randomized benchmarking (two_qubit_rb). To achieve this, we added the necessary parameters (CzParameters), operations (TunableCouplerOperationswithczmethod), and pulses (modulated_flux) for the tunable coupler. - Breaking change: Changed the
nameof the ZZ coupling strength experiment workflow fromzz_coupling_strength_exptozz_coupling_strength. - Functionality Added the bosonic qubit type, quantum operations, and demo platform, along with a selection of experiments, including: displacement calibration, memory spectroscopy, selective transmon Rx calibration, SNAP gate calibration, SWAP gate calibration, and Wigner tomography.
-
Functionality Updated the VQE example to use QPU, QuantumOperations, and OpenQASMTranspiler.
Previously the VQE example used
GateStoreandexp_from_qasm_listwhich are deprecated interfaces to the LabOne QOpenQASMTranspiler. TheGateStoreis replaced with aQPUand aQuantumOperationsclass.exp_from_qasm_listis replaced by callingOpenQASMTranspiler.batch_experimentdirectly instead. -
Removal Removed the deprecated
update_qubitstask (useupdate_qpuinstead) and the deprecatedtemporary_modifytask (usetemporary_qpuinstead).
Pre-Release 26.7.0b2¶
Release date 22.05.2026
Requires: LabOne 26.4
Supports: Applications Library 26.7.0b2
DSL¶
- Functionality Added the
quantum_element_uidsproperty to theQPUclass, which returns the list of quantum element UIDs in the QPU. - Functionality Added
reset_oscillator_phasetolaboneq.simple.dslnamespace. This function existed already but was not directly exposed. It resets the phase of the oscillator associated with a given logical signal. - Documentation Added documentation and unit tests for the list of real-time sweepable parameters vs near-time only parameters.
Compiler¶
- Functionality The compiler now raises an exception when an SHF oscillator intermediate frequency (IF) has an absolute value >= 1 GHz. SHF instruments do not support IF frequencies in this range.
- Bug Fix Fixed a bug where compilation would fail when a chunked sweep contained both the driving parameter and the derived parameter.
- Bug Fix Fixed a bug where differences in comments produced excessively long, uncompressed SeqC.
- Bug Fix Fixed a bug where a minor rounding error biased phase increments by up to +0.3 µrad.
- Removal Removed
LabOneQInstrumentortraces:laboneq.compiler.scheduleandlaboneq.compiler.generate-code. Capturing compiler traces from Python now requireslaboneq.instrumentation.tracing.laboneq_tracing().
Automation¶
- Functionality Added error tracking and visualization for failed layer executions. The exceptions from
run_layer_executableare recorded via a new AutomationStatus.ERROR status and error attribute, with errored nodes blinking yellow-to-red in the web viewer and displaying the error message in the info panel on click. - Functionality Multiple automation web viewers can now run simultaneously. Each
start_web_viewercall launches an independent server on its own port for a separateAutomationinstance. - Functionality Improved the "Node results" image discovery for nodes with multiple quantum elements by searching for the target quantum element UID in the results image file names if the node key string is not found.
- Bug Fix Fixed a bug in the automation web viewer, where the "Node results" section of the node info panel sometimes displayed the results of the previously-clicked node.
Workflows¶
- Bug Fix Fixed a bug where passing workflow OptionBuilder options directly to a task called outside a workflow context raised a ValueError.
Serializer¶
-
Functionality Updated the Experiment serializer to support a richer set of values as pulse parameters.
Previously the Experiment serializer supported only a limited basic set of pulse parameter types:
- float, int, str, bool, complex
- SweepParameter, LinearSweepParameter
- list[SweepParameter], list[LinearSweepParameter]
This set of types proved too restrictive for some use cases.
Now the Experiment serializer supports an extended set of types for pulse parameters:
- int, float, complex, str, bytes, bool, None, SweepParameter or LinearSweepParameter
- lists of the above
- dictionaries of the above with str keys
The lists and dictionaries may be nested and need not have homogeneous element types.
The previous Experiment serializer format was version 4. The new format is version 5.
Applications Library¶
- Removal Removed support for
qubit/qubits/parametric_amplifierarguments of typeQuantumElement/QuantumElements/TWPAin experiment workflows. Removed support forquantum_elementsarguments of typeQuantumElementsin thetemporary_quantum_elements_from_qputask. Please pass the quantum element UIDs instead of the quantum element instances.
Pre-Release 26.7.0b1¶
Release date 08.05.2026
Requires: LabOne 26.4
Supports: Applications Library 26.7.0b1
Compiler¶
- Functionality Changed exception type from
RuntimeErrortoLabOneQExceptionwhen an invalid device combination is provided.
Controller¶
- Bug Fix Fixed a bug where the assignment vector calculation for multi-state discrimination on SHFQA was incorrect. The calculation is now delegated to zhinst-utils.
- Removal Removed device setup hot-reloading.
Workflows¶
- Functionality Improved the performance of the automation web viewer so that it runs smoothly with up to 200 quantum elements per layer. The front end has been simplified and all transitions are now entirely done natively by the browser.
Pre-Release 26.4.0b5¶
Release date 09.04.2026
Requires: LabOne 26.1
Supports: Applications Library 26.4.0b5
Functionality¶
- Added
SectionTimingMode.STRICTfor sections and acquire loops. When enabled, the compiler raises an error if any timing value (section length, pulse length, repetition time) requires padding to fit the required grid, rather than silently padding.RepetitionMode.AUTOis incompatible with strict mode and also raises an error. - The
inject_resultspathsrun experiment option is now of typelist[Path | str], i.e. a list of paths to serializedResultsobjects. If multiple file paths are provided, then theResultsobjects are combined. - Renamed controller API endpoints to match new naming scheme, added stubs for sync controller API.
Bug Fixes¶
- Fixed a bug where pulse replacements did not persist over near-time steps in situations where, besides the replacement(s), the near-time loop is used to sweep some pulse properties as well (the pulse being replaced, or another one).
- Fixed a bug where near-time pulse replacement replaced the wrong waveform if the pulse being replaced was in different positions in different near-time steps (can happen when matching against the near-time loop index and defining structurally different entries for different cases).
- Fixed a bug where delay compensation for input latency on SHFQA when using LRT was inaccurate. Users are advised to update their integration kernel estimations as this change affects signal latency.
- Fixed a bug where auto chunking, when chunking was not necessary, produced a different compilation result than when auto chunking was not enabled.
Applications Library¶
-
The functionality to determine the length of the measure section on
laboneq.dsl.quantum.QPUwas not compatible with all types of qubits. It only worked with tunable transmons.To avoid confusion and bugs with other types of qubits, the functionality has been moved to
TunableTransmonOperations.measure_section_length.The method on
laboneq.dsl.quantum.QPUwill be deprecated and removed in a future releases.
Deprecation Notices¶
- Deprecated the methods
CompiledExperiment.replace_pulseandCompiledExperiment.replace_phase_increment. NOTE: the methodsRuntimeContext.replace_pulseandRuntimeContext.replace_phase_incrementare not deprecated and can still be used to apply replacements in NT callbacks (these methods leave the compiled experiment unchanged). - Deprecated
QPU.measure_section_length. The method is only meaningful for certain types of qubits, so it will be moved to the implementations ofQuantumOperationsin thelaboneq-applicationsrepository instead.
Pre-Release 26.4.0b4¶
Release date 27.03.2026
Requires: LabOne 26.1
Supports: Applications Library 26.4.0b4
Bug Fixes¶
- Fixed a bug where acquisition delay was not compensated in LRT mode. Users no longer need to manually add a port delay offset to the acquire signal when using long readout.
- Fixed a bug where hold-off errors from a previous experiment could cause subsequent experiments to crash.
- Fixed a bug where match-case against a near-time sweep parameter always executed the first case only.
- Fixed a bug in the Applications Library where several analysis methods did not properly support experiment results with multiple shots.
Applications Library¶
- Added the
result_handleargument to thecalibration_traces_rotation.calculate_qubit_population_2dfunction, useful for storing multiple measurement outcomes per qubit.
Pre-Release 26.4.0b3¶
Release date 13.03.2026
Requires: LabOne 26.1
Supports: Applications Library 26.4.0b3
Functionality¶
- Added a new attribute
result_propertiesforCompiledExperimentthat for each result handle contains information about the result array (the shape and the axis names). - Added support for injecting serialized experiment results into workflows via the
inject_resultsoption, enabling reuse of previously recorded runs for emulation or testing.
Bug Fixes¶
- Fixed a bug where
attrsattributes were incorrectly labeled as bothclass-attributeandinstance-attributein the documentation. - Fixed a bug where
axis_namein experiment results contained names of internal derived parameters. - Fixed a bug where near-time frequency sweep of QA acquire oscillator with hardware modulation did not work on SHFQA devices with the LRT option without requiring spectroscopy acquisition type.
- Fixed a bug where loops using SW oscillators were incorrectly compressed (re-rolled), causing all sweep iterations to reuse the same pre-computed waveform regardless of the accumulated oscillator phase.
- Fixed a bug in the
temporary_qpufunction, where quantum elements and topology edges were not being copied correctly.
Documentation¶
- Updated the code examples in the reference documentation for the
amplitude_fineexperiment.
Applications Library¶
-
Breaking change For the following non-
contribexperiments, theevaluation_parametersargument has been added to replace theevaluation_parameter,evaluation_parameter_thresholds, andevaluation_fit_r2_thresholdsarguments:amplitude_fine,ampltiude_rabi,qubit_spectroscopy, andramsey.For the following non-
contribexperiments, theevaluation_parametersargument, as well as a templateevaluate_experimenttask, has been added:dispersive_shift,drag_q_scaling,echo,lifetime_measurement,resonator_spectroscopy, andtime_traces.For the following
contribexperiments, theevaluation_parametersargument, as well as a templateevaluate_experimenttask, has been added:calibrate_cancellation,scan_pump_parameters,signal_propagation_delay,time_rabi, andzz_coupling_strength_exp.Consequently, all experiments with an
update_qputask now also have anevaluate_experimenttask and anevaluation_parametersargument.For all experiments, all arguments apart from
session,qpu, andqubit/qubits/parametric_amplifierare now keyword arguments.
Pre-Release 26.4.0b2¶
Release date 27.02.2026
Requires: LabOne 26.1
Supports: Applications Library 26.4.0b2
Functionality¶
- Near-time Callbacks now receive an object implementing
RuntimeContextas their first argument instead of aSession. No changes are required to existing callback function definitions except when they use the accessors to experiment data, calibrations, connection state, or the device setup. In these cases, the required data must be submitted via the function arguments. It is still recommended to rename the parameter fromsessiontoruntime_contextand update the type hint, if present. - Long readout pulses on SHFQA devices are now automatically compressed without requiring the
can_compressparameter when using hardware with long readout time support. ModulationType.AUTOon QA devices in integration mode now resolves toHARDWAREonly when the device has the LRT option and the acquisition length exceeds 2 µs; shorter acquisitions default toSOFTWAREto avoid silent phase-averaging errors and NCO limitations. Long acquisitions (> 2 µs) without LRT now raise a compile-time error. Spectroscopy mode is unchanged and always resolves toHARDWARE.- Refactored the abstract base classes for the LabOne Q Automation framework (currently in beta), due to be officially released in v26.04.
Bug Fixes¶
- Fixed a bug where UHFQA AWG status check failed after AWG ready logic change in 26.1.0.
- Fixed a bug where hardware modulation was not applied when using a short readout on SHFQA with an LTR option.
- Fixed a bug where stale SHFQA integration kernel downsampling factor persists across sequential experiment runs within the same session.
- Fixed a bug where deserialization of a compiled experiment that uses local feedback would fail.
- Fixed a bug where deserialization of a scheduled experiment with RAW acquisition would fail.
Documentation¶
- Fix inaccurate description of the
add_resetargument tobatch_experiment. The argument adds a reset operation not an active reset operation. Whether the reset is active or passive is determined by the implementation provided by the quantum operations of the QPU.
Deprecation Notices¶
- Deprecated the legacy serializer provided by
laboneq.dsl.serializationandlaboneq.core.serialization. These will be removed in LabOne Q 26.7. Uselaboneq.serializersinstead.
Applications Library¶
- The
TunableTransmondemo_platform(n_qubits)andtunable_transmon_setup(n_qubits)functions were extended to support arbitrary numbers of qubits. Previously they supported at most six. The SHFQC and HDAWG instrument names and addresses in the setup were made unique by appending a count to them. - Refactored the workflow automation subclasses for the LabOne Q Automation framework (currently in beta), due to be officially released in v26.04.
Pre-Release 26.4.0b1¶
Release date 13.02.2026
Requires: LabOne 26.1
Supports: Applications Library 26.4.0b1
Functionality¶
Sessionnow supports automatic system profile fetching and caching when connecting to hardware. Use the newsystem_profileparameter in theSessionconstructor to explicitly provide a profile, or let it auto-load from cache when needed.- Ported event list generation (required for Pulse Sheet Viewer) from Python to Rust for improved performance.
- Added the abstract base classes for the LabOne Q Automation framework (currently in beta), due to be officially released in v26.04.
Bug Fixes¶
- Fixed a bug where a read timeout occurred when running LRT after non-LRT, due to LabOne Q enabling MSD by default even for two states for non-LRT experiments. MSD is now explicitly disabled for LRT.
- Fixed a bug where hardware modulation was not applied when using a short readout on SHFQA with the LRT option.
- Fixed a bug where
OutputSimulatordid not properly decompress long readout (LRT) waveforms on SHFQA, so that simulated output did not match the full hardware playback. - Fixed a bug where SHFQA in Spectroscopy mode did not play a readout pulse if
can_compress=Trueis passes to a readout pulse while LRT option is being used. - Fixed a bug where PSV crashed if a zero-length trigger was present.
- Fixed a bug where automatic measure section length in QPU did not take readout pulse into account.
- Fixed a bug where creating an experiment in a different thread than where LabOne Q was originally imported caused a crash.
Removals from the Codebase¶
- Removed the deprecated
DataStoreclass and associated SQLite-based data storage functionality.
Documentation¶
- Added TWPA quantum element to the reference documentation index.
- Fixed the link to the contribution guideline in the readme.
Applications Library¶
- Added the workflow automation subclasses for the LabOne Q Automation framework (currently in beta), due to be officially released in v26.04.
- Breaking change Edited the signature of Qubit Spectroscopy, Amplitude Rabi, and Ramsey experiment workflows, such that workflow parameters are keyword only. The remaining workflows will be updated in time for the official LabOne Q Automation release in v26.04.
- Added the
evaluate_experimenttask to the Qubit Spectroscopy, Amplitude Rabi, and Ramsey experiment workflows. The remaining workflows will be updated in time for the official LabOne Q Automation release in v26.04. - Added a new
"continuous"option for specifying kernel pulses for acquire and measurement integration kernels onTunableTransmons. The new option causes the hardware to integrate for the entire integration length, weighting all samples equally. This is useful for performing very long integrations where the pulse samples would not fit into the device memory.
Pre-Release 26.1.0b4¶
Release date 16.01.2026
Requires: LabOne 25.10
Supports: Applications Library 26.1.0b4
Functionality¶
- Extended auto chunking to handle sweeps limited by the maximum number of acquired results. When a sweep exceeds the instrument's result memory capacity, it can now automatically be split into smaller chunks, each acquiring fewer results to fit within the hardware limit.
- Calculate result shapes at compile time and make them available via
compiled_experiment.scheduled_experiment.result_shape_info.shapes. - Breaking change Transpose the last two dimensions of the shape of RAW acquisition results in case of multiple handles with the same name - before:
(..., handle, samples), after:(..., samples, handle). This brings the axis corresponding to the multiple handles to the same location as for the case of non-RAW acquisition. - Implemented Ramsey spectroscopy experiment under
laboneq.testing.experiments.
Bug Fixes¶
- Fixed a bug where the compiler would output unnecessary log warnings about dropping the imaginary part of a waveform on RF signals.
- Fixed a bug where result shaping failed (array broadcasting error) in case of multiple different handles on the same signal and inside different case blocks.
- Fixed a bug where acquisition commands inside match-case blocks produced incorrect result shapes and contents: an extra dimension was added, with actual results placed at the beginning of the array and the remainder filled with
NaNs. - Breaking change Fixed a bug where result type was incorrect when there is only a single acquisition for a handle in the entire experiment. Before:
np.complex128, After:np.ndarray. - Fixed a bug where referencing an invalid section in
play_afterin a right-aligned section did not raise an error. - Fixed a bug where
FolderStorededuplication treated numpy arrays that containNaNs as unequal to themselves, storing them repeatedly. - Fixed a bug where type validation did not support
TypeAliasTypefrom Python 3.12+ and numpy 2.4+. - Fixed a bug where a minimum width for the Lorentzian fit in the fitting helper functions was not set, sometimes causing division by zero errors.
Documentation¶
- Added the Subsampling Techniques for Achieving Waveform Precision in Picoseconds tutorial and support code to perform subsampling delay adjustments.
Deprecation Notice¶
- The
qubits/qubit/parametric_amplifierargument of typeQuantumElementsis deprecated for all experiment workflows in v26.1.0 and will no longer be supported in v26.4.0. Please pass an argument of typelist[str] | strinstead, i.e., the quantum element UIDs instead of the quantum element instances. Thetemporary_parameterspositional argument was added to the followingcontribexperiment workflows:amplitude_rabi_chevron,signal_propagation_delay,single_qubit_randomized_benchmarking,spin_locking,time_rabi, andtime_rabi_chevron. This is a breaking change if calling these experiment workflows with theoptionspositional argument.
Pre-Release 26.1.0b3¶
Release date 19.12.2025
Requires: LabOne 25.10
Supports: Applications Library 26.1.0b3
Functionality¶
- Added type hint validation for signal calibration objects using typeguard. Assigning a value of the incorrect type to a calibration object will now immediately raise a TypeError rather than failing during compilation or execution.
- Improved unused sweep parameter detection. The compiler will now raise an error whenever the experiment or device setup contains a sweep parameter that is not registered in any sweep, excluding derived sweep parameters where registering the parent is sufficient
Bug Fixes¶
- Fixed a bug where the HDAWG would not start if previously used cores were now unused.
- Fixed a bug where the local event loop was pinned to the thread instead of the session, preventing the same session from being invoked from multiple threads, even when concurrent calls were properly synchronized by the user.
- Fixed a bug where execution would time out when reading large amounts of data, particularly in single-shot mode and over slow connections.
- Fixed a potential memory overflow issue: data from unused integrators was accumulating until the end of the experiment.
- Fixed a bug where the Pipeliner was not executing when SHFQC was present in the setup but not used in the chunked experiment.
- Fixed a bug where the
playcommand withoutpulseandmarkersdid not work when the markerwaveformwas a sampled pulse. - Fixed a bug where registration of derived parameters in near-time execution loops failed.
- Fixed a bug (introduced in v2.61.0) that prevented standalone HDAWG cores from synchronizing properly.
- Fixed a bug in the
FolderStoreserializer to support dictionaries ofQuantumElementandQuantumParameterobjects whose keys are tuples of strings, as explained in the FolderStore serializer documentation. Without this, supplying temporary topology edge parameters totemporary_qpuwould fail to save thetemporary_parameterspassed, because edges are passed as tuples of the form(tag, q0.uid, q1.uid). For example,("coupler", "q0", "q1"). With this change,temporary_parametersare saved correctly. - Fixed a bug where using the first internal-only channel with the RTR option triggered a false exception.
- Fixed a bug where a SYNCIGNORED error occurred in standalone SHFQC when running a non-chunked experiment right after a chunked one in the same session.
- Fixed a bug where the error message was unclear when feedback acquisition or measure line 'port_delay' calibration was swept.
Documentation¶
- Updated the FolderStore documentation to clarify that only dicts of QuantumElement
or QuantumParameters whose keys are strings or tuples of strings may be serialized
by the
FolderStoreserializer.
Applications Library¶
- Breaking change Changed
calibrate_cancellationworkflow to set pump cancellation attenuation and phase to 0.0 when cancellation is off - Support using SG channels for flux lines in
TunableTransmonQubitand inTunableCoupler
Pre-Release 26.1.0b2¶
Release date 04.12.2025
Requires: LabOne 25.10
Supports: Applications Library 26.1.0b2
Functionality¶
- Added type hint validation for signal calibration objects using typeguard. Assigning an value of the incorrect type to a calibration object will now immediately raise a
TypeErrorrather than failing during compilation or execution.
Bug Fixes¶
- Fixed a bug where
ModulationType.AUTOincorrectly forced SOFTWARE modulation for INTEGRATION acquisitions even when the long readout time option (LRT) is available.ModulationType.AUTOnow resolves to HARDWARE modulation when LRT is available on the targeted instrument. - Fixed issue where section triggers were not shown in Pulse Sheet Viewer.
- Fixed the serialization of the
auto_chunkingparameter ofExperimentsweeps. Previously this parameter was not serialized. Experiments saved before this version of LabOne Q are treated as thoughauto_chunkingwas set toFalse.
Documentation¶
- Extended the example notebook for the benchmarking package to also display data from 2-qubit RB and to show fractional time spent in different compilation steps.
Pre-Release 26.1.0b1¶
Release date 20.11.2025
Requires: LabOne 25.10
Supports: Applications Library 26.1.0b1
Functionality¶
-
Added the function
add_signalto thebuild_experimentDSL built-ins. This function is a wrapper forExperiment.add_signaland allows the user to add a signal with or without an experiment context. -
Removed restriction where a single sweep parameter could not drive multiple hardware
Oscillatorfrequencies. Now a single sweep parameter can be used across multiple different oscillators.
Bug Fixes¶
- Fixed a bug where acquire pulses were missing in Pulse Sheet Viewer when multiple kernels were used.
Documentation¶
-
Added the Time-Resolved Photon Number experiment together with a How-to Guide.
-
Updated the Ramsey example for spin qubits in the Spin Qubit Pulse Sequences with the HDAWG How-to Guide.
-
Corrected the repetition settings in the Amplitude Calibration with Error Amplification How-to Guide.
Applications Library¶
- Added the ZZ Coupling Characterization experiment together with a How-to Guide.