topola 0.1.0

Work-in-progress free and open-source topological (rubberband) router and autorouter for printed circuit boards (PCBs)
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
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105

// SPDX-FileCopyrightText: 2026 Topola contributors
//
// SPDX-License-Identifier: MIT OR Apache-2.0

use std::ops::ControlFlow;

use derive_getters::Getters;

use crate::{
    AutoplacerSchedule, Interactor, Vector2,
    autoplacer::Jostler,
    board::{
        Board,
        interactors::{BoardMasterInteractor, SelectInteractor},
    },
    layout::LayerId,
    selections::PersistableSelection,
};

#[derive(Getters)]
pub struct JostlerMasterInteractor {
    board_master: BoardMasterInteractor,
    jostler: Jostler,
    prev_pointer: Option<Vector2<i64>>,
}

impl JostlerMasterInteractor {
    pub fn new(board: &mut Board, board_master: BoardMasterInteractor) -> Self {
        let selection = board_master.selection().components.clone();

        Self {
            board_master,
            jostler: Jostler::new(
                board,
                selection,
                AutoplacerSchedule {
                    initial_temperature: 500.0,
                    temperature_common_ratio: 0.95,
                    initial_std_dev: 500.0,
                    std_dev_common_ratio: 0.995,
                    max_steps: 3000,
                },
            ),
            prev_pointer: None,
        }
    }

    pub fn selection(&self) -> &PersistableSelection {
        self.board_master.selection()
    }

    pub fn select_interactor(&self) -> &Option<SelectInteractor> {
        self.board_master.select_interactor()
    }
}

impl Interactor for JostlerMasterInteractor {
    fn step(&mut self, board: &mut Board) -> ControlFlow<()> {
        crate::profile_function!();

        self.jostler.step(board);
        ControlFlow::Continue(())
    }

    fn press(&mut self, board: &mut Board, layer: LayerId, pointer: Vector2<i64>) {
        self.board_master.press(board, layer, pointer);
    }

    fn hold(&mut self, board: &mut Board, layer: LayerId, pointer: Vector2<i64>) {
        if let Some(prev_pointer) = self.prev_pointer {
            if pointer != prev_pointer {
                self.jostler.abort(board);
                self.jostler = Jostler::new(
                    board,
                    self.board_master.selection().components.clone(),
                    AutoplacerSchedule {
                        initial_temperature: 500.0,
                        temperature_common_ratio: 0.95,
                        initial_std_dev: 500.0,
                        std_dev_common_ratio: 0.995,
                        max_steps: 300,
                    },
                );
            }
        }

        self.prev_pointer = Some(pointer);

        //self.jostler.hold(board, layer, pointer);
        self.board_master.hold(board, layer, pointer);
    }

    fn release(
        &mut self,
        board: &mut Board,
        layer: LayerId,
        pointer: Vector2<i64>,
    ) -> ControlFlow<()> {
        self.board_master.release(board, layer, pointer)
    }

    fn abort(&mut self, board: &mut Board) {
        self.board_master.abort(board);
    }
}