ααLoop docs
On this page

Choose a Linnet interface

Use Rust when Linnet is part of an application or library, Python for standalone DOT-backed graph workflows, and Linnest when a Typst document owns layout and drawing. Each interface shares the half-edge model while exposing the conventions natural to its language.

Typst package

Linnest combines Typst functions with a WebAssembly plugin. Follow the Linnest workflow guide for a first drawing, then use the focused Typst API reference for its graph, layout, drawing, physics, and subgraph surfaces. The curve helpers are Kurvst re-exports and stay documented in their canonical GammaLoop guide.

Rust package

The linnet package is organized into these principal areas:

  • half_edge provides HedgeGraph, builders, the involution and edge data, subgraph types, traversal trees, and graph algorithms;
  • parser provides DOT parsing and DOT-backed graph data;
  • half_edge::layout provides layout helpers when the drawing feature is enabled;
  • permutation, tree, and union_find provide supporting algorithms and stores.

The generic graph types separate edge, vertex, and half-edge payloads from the node-storage implementation. Start with the Rust orientation, then use the revision-specific Rustdoc for complete generic bounds, implementations, and method signatures; choose a concrete storage type according to the workflow and mutation behavior you need.

Cargo features enable optional capabilities:

  • serde adds serialization traits;
  • bincode adds binary encoding support;
  • drawing enables Linnet’s layout module and its optional geometry dependency;
  • symbolica adds Symbolica interoperability.

An item shown in an all-features API reference may not be available in a default build. Check its required feature and your Cargo.toml before using it.

Layout is not rendering
Linnet can compute layout coordinates, but it does not own a supported Rust renderer. Emit DOT for interchange, use Clinnet for command-line figure batches, or use Linnest when a Typst document owns the final drawing.

Standalone Python distribution

Distribution and import have different names
Install the Python distribution linnet-py, then import linnet_py. It requires Python 3.10 or newer. It is a standalone extension and is not a symbolica.community module. Its package version is independent of the Rust linnet version. Record both versions when diagnosing compatibility between Rust and Python code.

The Python binding focuses on DOT-backed graphs and mirrors typed identifiers and subgraphs:

from linnet_py import DotGraphBuilder

builder = DotGraphBuilder()
left = builder.add_node()
right = builder.add_node()
builder.add_edge(left, right)
graph = builder.build()

print(graph.dot())

DotGraph can also parse one graph from a string or file, or a set of graphs from a string. The exported classes include Hedge, NodeIndex, EdgeIndex, Flow, Orientation, graph attribute wrappers, HedgePair, Subgraph, Cycle, OrientedCut, TraversalTree, DotGraph, and DotGraphBuilder.

Mutable statement wrappers expose mapping-like access to DOT attributes. Consult the structured Python API for their lifetime and write-through behavior, and do not assume that a copied mapping remains attached to its graph.