qutip_qip.qasm

Functions

circuit_to_qasm_str(qc)	Return QASM output of circuit object as string
print_qasm(qc)	Print QASM output of circuit object.
read_qasm(qasm_input[, mode, version, strmode])	Read OpenQASM intermediate representation (https://github.com/Qiskit/openqasm) and return a QubitCircuit and state inputs as specified in the QASM file.
save_qasm(qc, file_loc)	Save QASM output of circuit object to file.

class qutip_qip.qasm.QasmOutput(version: str = '2.0')

Bases: object

Class for QASM export.

Parameters:

version: str, optional

OpenQASM version, currently must be “2.0” necessarily.

is_defined(gate_name: str) → bool

Check if QASM gate definition exists for QuTiP gate.

Parameters:

gate_name: str

QuTiP gate name.

output(line: str = '', n: int = 0) → None

Pipe QASM output string to QasmOutput’s lines variable.

Parameters:

line: str, optional

string to be appended to QASM output.

n: int, optional

number of blank lines to be appended to QASM output.

qasm_name(gate_name: str) → str | None

Return QASM gate name for corresponding QuTiP gate.

Parameters:

gate_name: str

QuTiP gate name.

qutip_qip.qasm.circuit_to_qasm_str(qc: QubitCircuit) → str

Return QASM output of circuit object as string

Parameters:

qcQubitCircuit

circuit object to produce QASM output for.

Returns:

output: str

string corresponding to QASM output.

qutip_qip.qasm.print_qasm(qc: QubitCircuit) → None

Print QASM output of circuit object.

Parameters:

qcQubitCircuit

circuit object to produce QASM output for.

qutip_qip.qasm.read_qasm(qasm_input: str, mode: str = 'default', version: str = '2.0', strmode: bool = False) → QubitCircuit

Read OpenQASM intermediate representation (https://github.com/Qiskit/openqasm) and return a QubitCircuit and state inputs as specified in the QASM file.

Parameters:

qasm_inputstr

File location or String Input for QASM file to be imported. In case of string input, the parameter strmode must be True.

modestr

Parsing mode for the qasm file. - “default”: For predefined gates in qutip-qip, use the predefined version, otherwise use the custom gate defined in qelib1.inc. The predefined gate can usually be further processed (e.g. decomposed) within qutip-qip. - “predefined_only”: Use only the predefined gates in qutip-qip. - “external_only”: Use only the gate defined in qelib1.inc, except for CX and QASMU gate.

versionstr

QASM version of the QASM file. Only version 2.0 is currently supported.

strmodebool

if specified as True, indicates that qasm_input is in string format rather than from file.

Returns:

qcQubitCircuit

Returns a QubitCircuit object specified in the QASM file.

qutip_qip.qasm.save_qasm(qc: QubitCircuit, file_loc: str) → None

Save QASM output of circuit object to file.

Parameters:

qcQubitCircuit

circuit object to produce QASM output for.

file_locstr

File path where the qasm output needs to be saved.