altium-format 0.1.7

Core altium-cli library for reading and writing Altium Designer files.
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

// SPDX-License-Identifier: GPL-3.0-only
// SPDX-FileCopyrightText: 2026 Alexander Kiselev <alex@akiselev.com>
//
//! Power net analysis.

use crate::io::SchDoc;
use crate::records::sch::SchRecord;
use std::collections::{HashMap, HashSet};

/// Extract power net names.
pub fn power_nets(doc: &SchDoc) -> HashSet<String> {
    let mut nets = HashSet::new();

    for record in &doc.primitives {
        if let SchRecord::PowerObject(pwr) = record {
            nets.insert(pwr.text.clone());
        }
    }

    nets
}

/// Map power nets to their connection counts.
pub fn power_map(doc: &SchDoc) -> HashMap<String, usize> {
    let mut counts: HashMap<String, usize> = HashMap::new();

    for record in &doc.primitives {
        if let SchRecord::PowerObject(pwr) = record {
            *counts.entry(pwr.text.clone()).or_insert(0) += 1;
        }
    }

    counts
}

/// Type alias for power net statistics (name, connection count).
pub type PowerNetStats = Vec<(String, usize)>;

/// Separate power rails from ground nets.
#[allow(clippy::type_complexity)]
pub fn separate_power_and_ground(
    power_nets: HashMap<String, usize>,
) -> (PowerNetStats, PowerNetStats) {
    let mut rails: Vec<_> = power_nets
        .iter()
        .filter(|(name, _)| {
            !name.to_uppercase().contains("GND") && !name.to_uppercase().contains("VSS")
        })
        .map(|(name, count)| (name.clone(), *count))
        .collect();
    rails.sort_by(|a, b| b.1.cmp(&a.1));

    let mut grounds: Vec<_> = power_nets
        .iter()
        .filter(|(name, _)| {
            name.to_uppercase().contains("GND") || name.to_uppercase().contains("VSS")
        })
        .map(|(name, count)| (name.clone(), *count))
        .collect();
    grounds.sort_by(|a, b| b.1.cmp(&a.1));

    (rails, grounds)
}