一、介绍

Petgraph 是一个开源的图数据结构库，提供了非常丰富的图形类型和算法，并且支持将图形以 Graphviz 格式输出，还允许你为图的节点和边赋予任意类型的数据，从而能够灵活地处理和表示复杂的数据关系。

Petgraph 支持边的方向性，即用户可以创建有向图和无向图，以满足不同场景下的需求。可以说 Petgraph 为开发者提供了强大的工具，以便在软件工程、数据分析和科学计算等领域中有效地处理和分析图结构数据。

二、核心部分

数据结构：Petgraph 库提供了四种不同风格的图实现，每种都针对不同的应用需求进行了特别优化。这些图实现在功能和性能之间提供了多样化的选择，使得开发者可以根据自己的具体需求，如数据处理的复杂性或对性能的要求，来选择最合适的图结构。

图遍历算法：库中内置了深度优先遍历（DFS）和广度优先遍历（BFS）等基本图遍历算法。这些算法是图分析的基础，能够帮助开发者探索和理解图中的结构和关系，对于图的搜索和问题解决非常关键。

丰富的图算法：不仅提供了基础的图遍历功能，还有一系列常用的图算法，如寻找最短路径的寻路算法等。这些算法能够应用于多种场景，例如网络分析、交通网络规划和社交网络分析等，极大地扩展了图数据结构的应用范围。

三、安装

安装非常简单，运行这个命令即可：

cargo add petgraph

四、示例

1.例子1
我们试图创建了一个空的无向图 graph，然后添加了三个节点，并保存了它们的索引。接着添加了两条边，连接了这些节点。最后使用 node_indices() 和 edge_indices() 方法遍历图中的节点和边，并打印它们的信息。

use petgraph::graph::{Graph};

fn main() {
    // 创建一个无向图
    let mut graph = Graph::<&str, &str>::new();

    // 添加节点并保存节点索引
    let a = graph.add_node("Node A");
    let b = graph.add_node("Node B");
    let c = graph.add_node("Node C");

    // 添加边
    graph.add_edge(a, b, "Edge AB");
    graph.add_edge(b, c, "Edge BC");

    // 遍历并打印图的节点和边
    for node in graph.node_indices() {
        println!("Node {}: {}", node.index(), graph[node]);
    }

    for edge in graph.edge_indices() {
        let (source, target) = graph.edge_endpoints(edge).unwrap();
        println!(
            "Edge from {} to {}: {}",
            source.index(),
            target.index(),
            graph[edge]
        );
    }
}

这样就一个简单的 petgraph 库用法示例了，可以根据自己的需求来创建、修改和操作图，以满足不同的应用场景。
2.例子2
这个使用 Dijkstra 算法计算从图中的每个节点到其他节点的最短路径时，输出的结果包括了从每个节点到其他节点的最短路径和对应的权重。

use petgraph::graph::{Graph, NodeIndex};
use petgraph::algo;

fn main() {
    // 创建一个有向图
    let mut graph = Graph::<(), i32>::new();

    // 添加节点并保存节点索引
    let nodes = graph.extend_with_edges(&[
        (0, 1), (0, 2), (0, 3), (1, 4), (1, 5), (2, 5), (2, 6), (3, 6), (4, 7), (5, 7), (6, 7)
    ]);

    // 对每个节点执行 Dijkstra 算法，并打印结果
    for start in graph.node_indices() {
        println!("Shortest path from node {:?}", start.index());

        // 使用 Dijkstra 算法找到从起始节点到其他节点的最短路径
        let result = algo::dijkstra(&graph, start, None, |e| *e.weight());

        // 打印最短路径
        for (node, weight) in result {
            if weight < std::i32::MAX {
                println!("  -> Node {:?}, Weight: {:?}", node.index(), weight);
            } else {
                println!("  -> Node {:?}, Weight: Infinity", node.index());
            }
        }
    }
}

运行结果：

可以看到 petgraph 其实几乎满足我们大部分的的应用场景的，感兴趣可以去使用了。