Skip to content

Quantum Machine Manager API

qm.quantum_machines_manager.QuantumMachinesManager

PARAMETER DESCRIPTION
host

Host where to find the QM orchestrator. If None, local settings are used

TYPE: string DEFAULT: None

port

Port where to find the QM orchestrator. If None, local settings are used

TYPE: Optional[int] DEFAULT: None

clear_all_job_results

Deletes all data from all previous jobs

close

Closes the Quantum machine manager

close_all_quantum_machines

Closes ALL open quantum machines

get_controllers

Returns a list of all the controllers that are available

get_qm

Gets an open quantum machine object with the given machine id

PARAMETER DESCRIPTION
machine_id

The id of the open quantum machine to get

TYPE: str

RETURNS DESCRIPTION
QuantumMachine

A quantum machine obj that can be used to execute programs

list_open_quantum_machines

Return a list of open quantum machines. (Returns only the ids, use get_qm(...) to get the machine object)

RETURNS DESCRIPTION
List[str]

The ids list

open_qm

Opens a new quantum machine. A quantum machine can use multiple OPXes, and a single OPX can also be used by multiple quantum machines as long as they do not share the same physical resources (input/output ports) as defined in the config.

PARAMETER DESCRIPTION
config

The config that will be used by the quantum machine

TYPE: DictQuaConfig

close_other_machines

When set to true (default) any open quantum machines will be closed. This simplifies the workflow, but does not enable opening more than one quantum machine.

TYPE: bool DEFAULT: True

validate_with_protobuf

Validates config with protobuf instead of marshmallow. It is usually faster when working with large configs. Defaults to False.

TYPE: bool DEFAULT: False

RETURNS DESCRIPTION
QuantumMachine

A quantum machine obj that can be used to execute programs

open_qm_from_file

Opens a new quantum machine with config taken from a file on the local file system

PARAMETER DESCRIPTION
filename

The path to the file that contains the config

TYPE: str

close_other_machines

Flag whether to close all other running machines

TYPE: bool DEFAULT: True

RETURNS DESCRIPTION
QuantumMachine

A quantum machine obj that can be used to execute programs

perform_healthcheck

Perform a health check against the QM server.

PARAMETER DESCRIPTION
strict

Will raise an exception if health check failed

TYPE: bool DEFAULT: True

reset_data_processing

Stops current data processing for ALL running jobs

simulate

Simulate the outputs of a deterministic QUA program.

The following example shows a simple execution of the simulator, where the associated config object is omitted for brevity.

Example
from qm.qua import *
from qm import SimulationConfig, QuantumMachinesManager

qmm = QuantumMachinesManager()

with program() as prog:
    play('pulse1', 'qe1')

job = qmm.simulate(config, prog, SimulationConfig(duration=100))
PARAMETER DESCRIPTION
config

A QM config

TYPE: DictQuaConfig

program

A QUA program() object to execute

TYPE: Program

simulate

A SimulationConfig configuration object

TYPE: SimulationConfig

compiler_options

additional parameters to pass to execute

TYPE: Optional[CompilerOptionArguments] DEFAULT: None

strict

a deprecated option for the compiler

TYPE: Optional[bool] DEFAULT: None

flags

deprecated way to provide flags to the compiler

TYPE: Optional[List[str]] DEFAULT: None

RETURNS DESCRIPTION
SimulatedJob

a QmJob object (see QM Job API).

validate_qua_config

Validates a qua config based on the connected server's capabilities and returns True if the config is correct.

PARAMETER DESCRIPTION
qua_config

A python dict containing the qua config to validate

TYPE: DictQuaConfig

version

RETURNS DESCRIPTION
Version

A dictionary with the qm-qua and QOP versions

version_dict

RETURNS DESCRIPTION
Version

A dictionary with the qm-qua and QOP versions