qamomile.qiskit.materializer

Materialize engine-neutral circuit programs as Qiskit circuits.

Overview¶

Classes¶

EmitError [source]¶

class EmitError(QamomileCompileError)

Report an engine failure to emit one semantic operation.

Parameters:

Example:

Correct — identify the unsupported operation at its target boundary::

    raise EmitError(
        "HUGR cannot emit a symbolic gate power",
        operation="ControlledUOperation",
    )

Incorrect — silently dropping an unsupported operation can change the
compiled program's meaning::

    if not target_supports(operation):
        return

Constructor¶

def __init__(self, message: str, operation: str | None = None)

Initialize an engine emission diagnosis.

Parameters:

Attributes¶

• operation

GateKind [source]¶

class GateKind(Enum)

Classification of gates for emission.

Attributes¶

• CH

• CP

• CRX

• CRY

• CRZ

• CX

• CY

• CZ

• H

• MEASURE

• P

• RX

• RY

• RZ

• RZZ

• S

• SDG

• SWAP

• T

• TDG

• TOFFOLI

• X

• Y

• Z

QiskitMaterializer [source]¶

class QiskitMaterializer

Convert target-legal circuit code-generation IR to QuantumCircuit.

Root and runtime-control-flow phases are retained in Qiskit’s native QuantumCircuit.global_phase metadata on the corresponding circuit or block.

Attributes¶

• capabilities: CircuitCapabilities Declare Qiskit’s circuit-IR capabilities.

Methods¶

materialize¶

def materialize(
    self,
    program: CircuitProgram,
    parameter_names: tuple[str, ...] = (),
) -> MaterializedCircuit[Any]

Build and return a Qiskit circuit with scoped phase metadata.

Parameters:

Returns:

MaterializedCircuit[Any] — MaterializedCircuit[Any]: Qiskit circuit and parameter mapping.

Raises:

• EmitError — If an instruction cannot be represented by Qiskit.

• ValueError — If circuit IR verification fails.