qamomile.braket.materializer

Materialize engine-neutral circuit programs as Amazon Braket circuits.

Overview¶

Classes¶

BraketMaterializer [source]¶

class BraketMaterializer

Convert verified circuit IR to an Amazon Braket circuit.

Attributes¶

• capabilities: CircuitCapabilities Declare the Amazon Braket circuit capabilities.

Methods¶

materialize¶

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

Build a Braket circuit and static-measurement metadata.

Parameters:

Returns:

MaterializedCircuit[Any] — MaterializedCircuit[Any]: Braket circuit and binding metadata.

Raises:

• EmitError — If runtime control, reset, or mid-circuit measurement remains in the program.

• ValueError — If structural circuit verification fails.

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