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

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

use std::ops::Add;

use derive_more::From;
use num_traits::{Signed, Zero};
use serde::{Deserialize, Serialize};

use crate::{
    Vector2,
    compass::{CompassDirection, PrincipalWind},
};

#[derive(Clone, Copy, Debug, Deserialize, Eq, From, Ord, PartialEq, PartialOrd, Serialize)]
pub enum OrthogonalOrientation {
    Horizontal,
    Vertical,
}

#[derive(Clone, Copy, Debug, Deserialize, Eq, From, Ord, PartialEq, PartialOrd, Serialize)]
pub enum Orientation {
    Horizontal,
    Vertical,
    Oblique,
}

impl Orientation {
    pub fn principal_wind<T>(self, vector: Vector2<T>) -> Option<PrincipalWind>
    where
        T: Copy + Add<Output = T> + PartialOrd + Signed + Zero,
    {
        match self {
            Self::Horizontal => {
                if vector.x.is_zero() {
                    None
                } else if vector.x > T::zero() {
                    Some(PrincipalWind::East)
                } else {
                    Some(PrincipalWind::West)
                }
            }
            Self::Vertical => {
                if vector.y.is_zero() {
                    None
                } else if vector.y < T::zero() {
                    Some(PrincipalWind::North)
                } else {
                    Some(PrincipalWind::South)
                }
            }
            Self::Oblique => {
                if vector.x.is_zero() && vector.y.is_zero() {
                    None
                } else {
                    Some(PrincipalWind::nearest_from_vector(vector))
                }
            }
        }
    }
}