Qbraid

Fixed

- Fixed type annotations for constraint parameters to support nested lists and mixed types, such as list[list[str]] and list[list[Union[str, int]]] in qbraid/runtime/schemas/experiment.py.([859](https://github.com/qBraid/qBraid/pull/859)) [[1]](diffhunk://#diff-a7087c56dd9323acc4777f8bc0bfab64908f18a93e9e6e6fa8abdb663da8fbfaL236-R244) [[2]](diffhunk://diff-a7087c56dd9323acc4777f8bc0bfab64908f18a93e9e6e6fa8abdb663da8fbfaL259-R266)
- Updates to tests: Modified the test_qubo_solve_params_model function to reflect the updated types for the constraint parameters in tests/runtime/test_schemas.py.

Added

- Added `p` to `z` gate name mapping to `openqasm3_to_ionq` conversion ([854](https://github.com/qBraid/qBraid/pull/854))
- Added `preflight` parameter to the `submit` method and to the `RuntimeJobModel` class ([856](https://github.com/qBraid/qBraid/pull/856))
- Added remote test for native IonQ runtime ([856](https://github.com/qBraid/qBraid/pull/856))
- Added `distribute_counts` function to adjust probabilistic counts ensuring the total equals the number of shots. ([858](https://github.com/qBraid/qBraid/pull/858))
- Added support for controlled gates in `openqasm3_to_ionq` conversion ([858](https://github.com/qBraid/qBraid/pull/858)):

text
cx, cy, cz, crx, cry, crz, ch, ccnot, cs, csi, ct, cti, cv, cvi


Improved / Modified

- Unit tests that require the `pyqir` dependency are now automatically skipped if pyqir is not installed. ([846](https://github.com/qBraid/qBraid/pull/846))
- Renamed the function `replace_gate_name` to `replace_gate_names` and updated its implementation to accept a dictionary of gate name mappings instead of individual old and new gate names. (`qbraid/passes/qasm/compat.py`) ([854](https://github.com/qBraid/qBraid/pull/854))
- Updated the `IonQDevice.transform` method to replace gate names in the input using the newly defined `IONQ_GATE_MAP` before loading and transforming the program ([855](https://github.com/qBraid/qBraid/pull/855))
- Updated gate naming conventions in `IONQ_QIS_GATES` list for consistency with [IonQ supported gates API](https://docs.ionq.com/api-reference/v0.3/writing-quantum-programs#supported-gates) ([856](https://github.com/qBraid/qBraid/pull/856))
- Updated the `rebase` function to include `gate_mappings` and `case_sensitive` parameters for gate name replacement.([856](https://github.com/qBraid/qBraid/pull/856))
- Updated the `rebase` function to handle gate mappings with predicates. ([858](https://github.com/qBraid/qBraid/pull/858))
- Refactored gate mappings and added validation for gate parameters and qubit counts in `openqasm3_to_ionq` conversion ([858](https://github.com/qBraid/qBraid/pull/858))
- Integrated `distribute_counts` function in `convert_to_counts` method in `IonQJob` ([858](https://github.com/qBraid/qBraid/pull/858))

Fixed

- Fixed `nec_vector_annealer` remote test by generalizing solutions (results) check ([852](https://github.com/qBraid/qBraid/pull/852))

Added

- Added "new" classes to the relevant runtime module scopes ([843](https://github.com/qBraid/qBraid/pull/843)):

- `qbraid.schemas`: `AhsExperimentMetadata` model, `USD` and `Credits` classes
- `qbraid.runtime`: `ValidationLevel` enum
- `qbraid.runtime.native`: Device-specific `ResultData` subclasses

- Added `plot_runtime_conversion_scheme` function to visualize the conversion graph and the target program types for a specific device. This enhancement clarifies which program types are available as input when submitting a quantum job to a particular device. See usage example below. ([845](https://github.com/qBraid/qBraid/pull/845))

python
from qbraid.runtime import QbraidProvider
from qbraid.visualization import plot_runtime_conversion_scheme

provider = QbraidProvider()

device = provider.get_device("qbraid_qir_simulator")

device.update_scheme(max_path_depth=1)

plot_runtime_conversion_scheme(device, legend=True)


- Display seed in bottom left corner of conversion graph if `plot_conversion_graph` called with `legend=True` ([849](https://github.com/qBraid/qBraid/pull/849))

Improved / Modified

- Made remote tests for `QbraidDevice("nec_vector_annealer")` more robust ([843](https://github.com/qBraid/qBraid/pull/843))
- Updated doc string & improved type hinting of `qbraid.load_program` ([849](https://github.com/qBraid/qBraid/pull/849))

Fixed

- Resolved an issue where passing `bloqade.builder.assign.BatchAssign` to `QbraidDevice("quera_aquila")` caused the transpile step to incorrectly wrap its output list in another list, leading to errors in `QuantumDevice.validate` and `QuantumDevice.to_ir`. The native `QbraidDevice` class now adapts when the transpile input is a single object but the output is a list, properly iterating through the sub-batch for final submission. ([843](https://github.com/qBraid/qBraid/pull/843))

Added

- Added support for specifying different `quera_qasm_simulator` backends in the `QbraidDevice.run` method using the "backend" keyword argument (e.g., "cirq", "cirq-gpu") ([836](https://github.com/qBraid/qBraid/pull/836))
- Add native runtime support for AHS experiment types, specifically for QuEra Aquila device ([837](https://github.com/qBraid/qBraid/pull/837))
- Added `QbraidJob.queue_position()` method ([838](https://github.com/qBraid/qBraid/pull/838))

Improved / Modified

- Enhanced type hinting for the `Result.data` property by leveraging a custom `typing.TypeVar`, enabling automatic adaptation to the specific `ResultData` subclass being accessed. ([836](https://github.com/qBraid/qBraid/pull/836))
- Improved type annotations and updated runtime test cases / structure ([837](https://github.com/qBraid/qBraid/pull/837))
- Updated validators for `AhsExperimentMetadata` pydantic model/schema ([838](https://github.com/qBraid/qBraid/pull/838))

Improved / Modified

- `OQCDevice.transform()` method now removes "include" statements from qasm strings, as they are not supported by the OQC cloud. ([831](https://github.com/qBraid/qBraid/pull/831))
- Extended `OQCDevice.get_next_window()` to fallback and attempt to extract next (or current) start window from `OQCClient.get_qpu_execution_estimates()` if `OQCClient.get_next_window()` raises an exception (e.g. for non-AWS windows). Now can return next widow `datetime` for Toshiko QPU. ([831](https://github.com/qBraid/qBraid/pull/831))
- Updated `OQCDevice.submit()` to so that we no longer explicitly set the `CompilerConfig` defaults and rather leave optional arguments as `None` if not provided. ([831](https://github.com/qBraid/qBraid/pull/831))

Removed

- Removed `qbraid.passes.compat.rename_qasm_registers()`. Function did not work properly, and is no longer even needed for OQC runtime as submission format is now `qasm3`, not `qasm2`. ([831](https://github.com/qBraid/qBraid/pull/831))

Added

- Registered "qubo" coefficients program type under `qbraid.programs.typer.QuboCoefficientsDict` ([820](https://github.com/qBraid/qBraid/pull/820))
- Added option to create a `ConversionGraph` using only specific nodes ([822](https://github.com/qBraid/qBraid/pull/822))
- Added option to include all registered program types in `ConversionGraph`, even if they don't have any supported conversions ([822](https://github.com/qBraid/qBraid/pull/822))
- Added method that maps all nodes in a `ConversionGraph` to their corresponding `ExperimentType` ([822](https://github.com/qBraid/qBraid/pull/822))
- Added option to `ConversionGraph` while only showing nodes matching given `ExperimentType` value(s) ([822](https://github.com/qBraid/qBraid/pull/822))

python
from qbraid import ConversionGraph, ExperimentType

graph = ConversionGraph(nodes=["qasm2", "qasm3", "qubo"], include_isolated=True)

for alias, exp_type in graph.get_node_experiment_types().items():
print(alias, exp_type.value)

graph.plot(experiment_type=ExperimentType.GATE_MODEL)


- Added conditional for OQC device `OFFLINE` status when unavailable + outside live window ([826](https://github.com/qBraid/qBraid/pull/826))
- Added units for OQC device pricing (USD) ([826](https://github.com/qBraid/qBraid/pull/826))

Improved / Modified

- Separated runtime device `transform` and `to_ir` logic into separate steps ([819](https://github.com/qBraid/qBraid/pull/819))
- Updated runtime validation step to handle program batches and not re-warn for device-related checks ([819](https://github.com/qBraid/qBraid/pull/819))
- Updated runtime device transpile method and target profile to allow for lists of `ProgramSpec` ([819](https://github.com/qBraid/qBraid/pull/819))
- Updated native runtime logic for NEC vector annealer to support "qubo" program spec type. Offset argument / attribute removed from `qbraid.programs.annealing.Problem`. `QbraidDevice.run` flow now derives "offset" paramater from `params` argument (of type `QuboSolveParams`, now required). This allows a more straightfoward procedure (with more visiblity) when submitting programs from `pyqubo.Module`. See code example below. ([820](https://github.com/qBraid/qBraid/pull/820))

python
from qbraid import QbraidProvider
from qbraid.runtime.schemas import QuboSolveParams

s1, s2, s3, s4 = [pyqubo.Spin(f"s{i}") for i in range(1, 5)]
H = (4 * s1 + 2 * s2 + 7 * s3 + s4) ** 2
model = H.compile()
qubo, offset = model.to_qubo()

params = QuboSolveParams(offset=offset)

provider = QbraidProvider()

device = provider.get_device("nec_vector_annealer")

job = device.run(qubo, params=params)


- IonQ multicircuit jobs and input data format field added explicitly ([825](https://github.com/qBraid/qBraid/pull/825))
- OQC provider url + timeout params added to `__init__`, and target profile updates to include new device metadata fields returned by `OQCClient`, particularly in relation to Toshiko QPU ([825](https://github.com/qBraid/qBraid/pull/825))
- Updated `random_circuit` function to use transpiler to consider all possible random circuit generators package funcs starting from the one with the closest conversion path to the specified target package. Reverses the logic of `ConversionGraph.get_sorted_closest_targets` with new function `ConversionGraph.get_sorted_closest_sources()` ([829](https://github.com/qBraid/qBraid/pull/829))

Fixed

- Fixed `qasm2_to_qasm3()` conversion error cause by `qbraid/transpiler/conversions/qasm2/qelib_qasm3.qasm` not being included in `MANIFEST.in` ([825](https://github.com/qBraid/qBraid/pull/825))
- Fixed docs CSS so stable/latest words show up (previously white and blended into the background so weren't visible) ([826](https://github.com/qBraid/qBraid/pull/826))

Dependencies

- Updated `pyqasm` optional dependency to `0.0.3` ([824](https://github.com/qBraid/qBraid/pull/824))
- Updated `oqc-qcass-client` optional dependnecy to `3.11.0` ([826](https://github.com/qBraid/qBraid/pull/826))

Added

- Updates for interfacing with IonQ devices from `QbraidProvider` including error mitigation field (to support `debias` parameter) for run method and basis gates set included in target profile ([817](https://github.com/qBraid/qBraid/pull/817))

Improved / Modified

- Updated examples submodule and added note to contributing doc about how to do so ([817](https://github.com/qBraid/qBraid/pull/817))