47 lines
8.5 KiB
Plaintext
47 lines
8.5 KiB
Plaintext
---
|
|
title: Migrate backend.run options to primitive options
|
|
description: Migrate backend.run options to Qiskit Runtime primitive options
|
|
|
|
|
|
in_page_toc_max_heading_level: 2
|
|
---
|
|
|
|
# Migrate options
|
|
|
|
All `backend.run` options are now available through the Qiskit Runtime primitives, but there are additional options available with the V2 primitives. See the [API reference](/api/qiskit-ibm-runtime/options) for the full list of available options. See [End-to-end examples](qiskit-runtime-examples) and [Advanced Qiskit Runtime options](/guides/runtime-options-overview) for more information about specifying V2 primitives options.
|
|
|
|
| backend.run options | V2 Primitive options | Notes |
|
|
|---------------------|-----------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|
|
|
| job_name | N/A: Use job_tags instead. | ibmq-provider only |
|
|
| job_share_level | N/A: This is no longer supported. | ibmq-provider only |
|
|
| job_tags | options.environment.job_tags | |
|
|
| experiment_id | N/A: Use job_tags instead. | ibmq-provider only |
|
|
| header | You can attach metadata to circuits. The same metadata is returned in the result metadata, under “circuit_metadata”. | |
|
|
| shots | Any of the following: <br></br>• run([(…, shots)]) <br></br>• run(…, shots=) <br></br>• options.default_shots | |
|
|
| memory | Use result.data.\<classical_register_name\>.get_counts() to get counts. <br></br>Use result.data.\<classical_register_name\>.get_bitstrings() to get per-shot measurements. | |
|
|
| qubit_lo_freq | N/A: This option only applies to `Schedule` inputs, which was removed in 2022. | |
|
|
| meas_lo_freq | N/A: This option only applies to `Schedule` inputs, which was removed in 2022. | |
|
|
| schedule_los | N/A: This option only applies to `Schedule` inputs, which was removed in 2022. | |
|
|
| meas_level | options.execution.meas_type: <br></br>• For meas_level=1 and meas_return="avg", use avg_kerneled <br></br>• For meas_level=1 and meas_return="single", use kerneled <br></br>• For meas_level=2, use classified <br></br>• meas_level=0 is no longer supported by IBM backends. | |
|
|
| meas_return | options.execution.meas_type (See above.) | |
|
|
| memory_slots | N/A: This is automatically determined by the QPU (quantum processing unit). | ibmq-provider only |
|
|
| memory_slot_size | N/A: This is automatically determined by the QPU. | ibmq-provider only |
|
|
| rep_time | N/A: Use rep_delay instead. | |
|
|
| rep_delay | options.execution.rep_delay | |
|
|
| init_qubits | options.execution.init_qubits | |
|
|
| parameter_binds | Specify parameters in PUBs. | ibmq-provider only |
|
|
| use_measure_esp | N/A: This is no longer supported by IBM backends. | |
|
|
| live_data_enabled | N/A: This feature was removed in 2022. | ibmq-provider only |
|
|
| dynamic | N/A: No longer needed. SamplerV2 automatically detects dynamic circuits. | ibm-provider only |
|
|
| init_circuit | N/A: Use init_qubits instead. | |
|
|
| init_num_resets | N/A: Use init_qubits instead. | |
|
|
| noise_model | options.simulator.noise_model | |
|
|
| seed_simulator | options.simulator.seed_simulator | |
|
|
|
|
## Algorithm tuning
|
|
|
|
One of the advantages of the primitives is that they abstract away the
|
|
circuit execution setup so that algorithm developers can focus on the
|
|
pure algorithmic components. However, sometimes, to get the most out of
|
|
an algorithm, you might want to tune certain primitive options. For details, see [Advanced runtime options.](/guides/runtime-options-overview)
|