uniqc.circuit_builder.normalize module

Shared circuit input normalization.

Provides the AnyQuantumCircuit type alias and normalize_circuit_input() used by compile, simulators, and task-manager modules so that every public entry point accepts the same set of input types.

uniqc.circuit_builder.normalize.AnyQuantumCircuit

Accepted input types for circuit-oriented APIs. A Circuit object, an OriginIR string, or an OpenQASM 2.0 string.

alias of Circuit | str

class uniqc.circuit_builder.normalize.NormalizedCircuit(circuit, type, original_input=None)[source]

Bases: object

Result of normalize_circuit_input().

Variables:

  • circuit (Circuit) – The unified uniqc.Circuit object.

  • type (str) – Detected input format: "circuit", "originir", "qasm", or "qiskit".

  • original_input (Any) – The raw input value, retained so callers can round-trip.

Parameters:

  • circuit (Any)

  • type (str)

  • original_input (Any)

circuit: Any
original_input: Any = None
type: str
uniqc.circuit_builder.normalize.normalize_circuit_input(circuit)[source]

Auto-detect input type and convert to uniqc.Circuit.

Accepted input types:

  • uniqc.Circuit — returned as-is.

  • str — parsed as OriginIR or OpenQASM 2.0.

  • qiskit.QuantumCircuit — exported via qiskit.qasm2.dumps() then parsed.

  • pyqpanda3.QProg — converted via OriginIR round-trip.

Parameters:

circuit (Any) – Circuit in any supported format.

Returns:

Dataclass with .circuit, .type, and .original_input fields.

Return type:

NormalizedCircuit

uniqc.circuit_builder.normalize.normalize_to_circuit(input)[source]

Convert AnyQuantumCircuit to a Circuit object.

Parameters:

input (AnyQuantumCircuit)

Return type:

Circuit

uniqc.circuit_builder.normalize.resolve_output_format(output_format, type)[source]

Resolve the output format string to a canonical name.

Parameters:

  • output_format (str) – User-specified format: "originir", "qasm", "circuit", or "auto". "auto" returns the same format as the input type.

  • type (str) – Detected input format from normalize_circuit_input().

Returns:

Canonical format: "originir" or "qasm".

Return type:

str