QASM Conversion

API reference for functions that convert between quantum programs (QProg) and the OpenQASM 2.0 intermediate representation format.

convert_qasm_string_to_qprog

Parses an OpenQASM 2.0 instruction-set string and returns the corresponding quantum program.

Signature

convert_qasm_string_to_qprog(
    qasm_str: str,
) -> QProg

Parameters

Parameter	Type	Description
qasm_str	str	An OpenQASM 2.0 instruction-set string to be converted.

Returns

The converted QProg quantum program.

Examples

from pyqpanda3.intermediate_compiler import convert_qasm_string_to_qprog

qasm_str = """
OPENQASM 2.0;
include "qelib1.inc";
qreg q[2];
creg c[2];
h q[0];
cx q[0],q[1];
measure q[0] -> c[0];
measure q[1] -> c[1];
"""
prog = convert_qasm_string_to_qprog(qasm_str)

convert_qasm_file_to_qprog

Reads an OpenQASM 2.0 file and returns the corresponding quantum program.

Signature

convert_qasm_file_to_qprog(
    qasm_filepath: str,
) -> QProg

Parameters

Parameter	Type	Description
qasm_filepath	str	Path to a file containing OpenQASM 2.0 instruction-set text.

Returns

The converted QProg quantum program.

Examples

from pyqpanda3.intermediate_compiler import convert_qasm_file_to_qprog

prog = convert_qasm_file_to_qprog("/path/to/circuit.qasm")

convert_qprog_to_qasm

Converts a quantum program to an OpenQASM 2.0 string representation.

Signature

convert_qprog_to_qasm(
    prog: QProg,
    precision: int = 8,
) -> str

Parameters

Parameter	Type	Description
prog	QProg	The quantum program to convert.
precision	int	Number of decimal places for floating-point gate parameters. Must be a non-negative integer. Defaults to 8.

Returns

The OpenQASM 2.0 instruction-set string representing the quantum program.

Examples

from pyqpanda3.intermediate_compiler import convert_qprog_to_qasm
from pyqpanda3.core import QProg, H, CNOT

prog = QProg() << H(0) << CNOT(0, 1)
qasm_str = convert_qprog_to_qasm(prog, precision=6)
print(qasm_str)

See Also

• OriginIR Conversion -- Convert to/from OriginIR format