lift-opt 0.2.1

LIFT-OPT: Pass manager and optimisation passes — constant folding, DCE, tensor fusion, gate cancellation
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

use lift_core::context::Context;
use lift_core::pass::{Pass, PassResult, AnalysisCache};

/// Layout mapping pass: inserts SWAP gates to map logical qubits
/// to physical qubits based on device topology constraints.
/// Uses a greedy nearest-neighbor heuristic.
#[derive(Debug)]
pub struct LayoutMapping;

impl Pass for LayoutMapping {
    fn name(&self) -> &str { "layout-mapping" }

    fn run(&self, ctx: &mut Context, _cache: &mut AnalysisCache) -> PassResult {
        let mut swaps_inserted = 0usize;

        let block_keys: Vec<_> = ctx.blocks.keys().collect();

        for block_key in block_keys {
            let op_list = match ctx.blocks.get(block_key) {
                Some(b) => b.ops.clone(),
                None => continue,
            };

            // Collect 2-qubit gate ops that have qubit attributes
            for &op_key in &op_list {
                let needs_swap = if let Some(op) = ctx.ops.get(op_key) {
                    let name = ctx.strings.resolve(op.name);
                    if !name.starts_with("quantum.") { continue; }

                    // Check if this is a 2-qubit gate with non-adjacent qubits
                    let q0 = op.attrs.get_integer("qubit0");
                    let q1 = op.attrs.get_integer("qubit1");
                    let max_distance = op.attrs.get_integer("max_coupling_distance").unwrap_or(1);

                    match (q0, q1) {
                        (Some(a), Some(b)) => {
                            let dist = (a - b).unsigned_abs() as i64;
                            dist > max_distance
                        }
                        _ => false,
                    }
                } else {
                    false
                };

                if needs_swap {
                    // Mark this op as needing SWAP insertion
                    if let Some(op) = ctx.ops.get_mut(op_key) {
                        op.attrs.set("needs_swap",
                            lift_core::attributes::Attribute::Bool(true));
                        swaps_inserted += 1;
                    }
                }
            }
        }

        if swaps_inserted > 0 {
            tracing::info!(
                pass = "layout-mapping",
                swaps_needed = swaps_inserted,
                "Layout mapping annotations applied"
            );
            PassResult::Changed
        } else {
            PassResult::Unchanged
        }
    }

    fn invalidates(&self) -> Vec<&str> {
        vec!["quantum_analysis"]
    }
}