cqlib-core 0.1.0-beta.1

The high-performance core foundation for the CQLib quantum computing ecosystem.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

// This code is part of Cqlib.
//
// (C) Copyright China Telecom Quantum Group 2026
//
// This code is licensed under the Apache License, Version 2.0. You may
// obtain a copy of this license in the LICENSE.txt file in the root directory
// of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
//
// Any modifications or derivative works of this code must retain this
// copyright notice, and modified files need to carry a notice indicating
// that they have been altered from the originals.

//! Local cost model for numeric block resynthesis.

use super::commutation::OperationView;
use crate::circuit::{Instruction, ParameterValue, ValueInstruction, ValueOperation};
use crate::compile::CompilerError;
use crate::compile::transform::decompose::unitary::{
    TargetAwareSynthesisCost, TwoQubitSynthesisTarget, TwoQubitUnitaryDecomposeBasis,
    target_aware_cost_of_value_operations,
};

/// Local cost used to accept only strictly improving resynthesis patches.
pub(crate) type ResynthesisCost = TargetAwareSynthesisCost;

pub(crate) fn cost_of_source_value_operations(
    operations: &[ValueOperation],
    target: &TwoQubitSynthesisTarget,
) -> Result<ResynthesisCost, CompilerError> {
    let mut cost = target_aware_cost_of_value_operations(
        operations,
        target,
        TwoQubitUnitaryDecomposeBasis::PauliRotations,
    )?;
    // Backend preference orders equivalent synthesis candidates only. Source
    // operations must not receive a synthetic backend advantage.
    cost.backend_order = 0;
    Ok(cost)
}

pub(crate) fn value_operations_of_source_ops(
    ops: &[&OperationView<'_>],
) -> Result<Vec<ValueOperation>, CompilerError> {
    ops.iter()
        .map(|view| {
            let Instruction::Standard(gate) = view.operation.instruction else {
                return Err(CompilerError::InvariantViolation(
                    "resynthesis cost requested for non-standard operation".to_string(),
                ));
            };
            let params = view
                .params
                .iter()
                .map(|parameter| parameter.evaluate(&None))
                .collect::<Result<Vec<_>, _>>()
                .map_err(|_| {
                    CompilerError::InvariantViolation(
                        "resynthesis cost requested for symbolic operation".to_string(),
                    )
                })?;
            Ok(ValueOperation {
                instruction: ValueInstruction::from_instruction(Instruction::Standard(gate)),
                qubits: view.operation.qubits.clone(),
                params: params.into_iter().map(ParameterValue::Fixed).collect(),
                label: view.operation.label.clone(),
            })
        })
        .collect()
}

#[cfg(test)]
#[path = "cost_test.rs"]
mod cost_test;