`graph`

fn def graph(df: DataFrame, from_categories: String, to_categories: String, values: String, theme: Theme = Theme(WHITE, Color(UInt8(30), UInt8(100), UInt8(180), UInt8(255)), Color(UInt8(80), UInt8(80), UInt8(80), UInt8(255)), Color(UInt8(225), UInt8(225), UInt8(225), UInt8(255)), Color(UInt8(40), UInt8(40), UInt8(40), UInt8(255)), SIMD(12), SIMD(3.5), SIMD(2), Int(60), Int(20), Int(20), Int(50), True, False, False, Color(UInt8(240), UInt8(240), UInt8(240), UInt8(255)), Int(3), Color(UInt8(60), UInt8(110), UInt8(200), UInt8(255)), Color(UInt8(235), UInt8(235), UInt8(235), UInt8(255)), Color(UInt8(220), UInt8(90), UInt8(40), UInt8(255)), ColorRamp(), ColorPalette(), SIMD(3), SIMD(15), True, SIMD(1), Int(0), False, Color(UInt8(200), UInt8(60), UInt8(60), UInt8(255)), Color(UInt8(224), UInt8(224), UInt8(224), UInt8(255)), Color(UInt8(120), UInt8(120), UInt8(120), UInt8(255)), Color(UInt8(100), UInt8(100), UInt8(100), UInt8(255)), Color(UInt8(230), UInt8(230), UInt8(230), UInt8(255)), Color(UInt8(255), UInt8(255), UInt8(255), UInt8(255)), UInt8(90), UInt8(160), False, False, SIMD(0), SIMD(18), SIMD(14), Color(UInt8(110), UInt8(110), UInt8(110), UInt8(255)), SIMD(14), Color(UInt8(150), UInt8(150), UInt8(150), UInt8(255)), Color(UInt8(224), UInt8(236), UInt8(246), UInt8(200)), Color(UInt8(255), UInt8(255), UInt8(255), UInt8(255)), True, False, False, True, AxisPosition.EDGE, AxisPosition.EDGE, String("sans-serif"), True, UInt8(90), Int(5), Int(4), Int(130), Int(14), Int(8), Int(14), Int(100), Int(8), SIMD(4), OutputFormat.SVG, Tooltips.AUTO, Missing.DRAW, String("(missing)"), Int(1000), False, LineStyle.SOLID, SIMD(1.5), LineStyle.SOLID, LegendPosition.RIGHT, XAxisLabelRotation.AUTO, TickFormat.AUTO, TickFormat.AUTO), width: Int = Int(640), height: Int = Int(420), title: String = "", subtitle: String = "", x_title: String = "", y_title: String = "", layout: GraphLayout = GraphLayout.CIRCLE) -> Chart[Graph]

graph() over named columns of a dataframe_mojo DataFrame (#743). Each argument names a column instead of holding the values.

See Plot.encode_frame() for how columns are read and what a column with missing values does.

Args:

df (DataFrame): The frame to read.
from_categories (String): The string column for this channel.
to_categories (String): The string column for this channel.
values (String): The numeric column for this channel.
theme (Theme): See the list overload.
width (Int): See the list overload.
height (Int): See the list overload.
title (String): See the list overload.
subtitle (String): See the list overload.
x_title (String): See the list overload.
y_title (String): See the list overload.
layout (GraphLayout): See the list overload.

Returns:

Chart[Graph]: The finished chart – unrendered.

Raises:

Error: A named column is missing, has the wrong dtype for its channel, or has missing values.

fn def graph[dtype: DType](from_categories: List[String], to_categories: List[String], values: List[Scalar[dtype]], theme: Theme = Theme(WHITE, Color(UInt8(30), UInt8(100), UInt8(180), UInt8(255)), Color(UInt8(80), UInt8(80), UInt8(80), UInt8(255)), Color(UInt8(225), UInt8(225), UInt8(225), UInt8(255)), Color(UInt8(40), UInt8(40), UInt8(40), UInt8(255)), SIMD(12), SIMD(3.5), SIMD(2), Int(60), Int(20), Int(20), Int(50), True, False, False, Color(UInt8(240), UInt8(240), UInt8(240), UInt8(255)), Int(3), Color(UInt8(60), UInt8(110), UInt8(200), UInt8(255)), Color(UInt8(235), UInt8(235), UInt8(235), UInt8(255)), Color(UInt8(220), UInt8(90), UInt8(40), UInt8(255)), ColorRamp(), ColorPalette(), SIMD(3), SIMD(15), True, SIMD(1), Int(0), False, Color(UInt8(200), UInt8(60), UInt8(60), UInt8(255)), Color(UInt8(224), UInt8(224), UInt8(224), UInt8(255)), Color(UInt8(120), UInt8(120), UInt8(120), UInt8(255)), Color(UInt8(100), UInt8(100), UInt8(100), UInt8(255)), Color(UInt8(230), UInt8(230), UInt8(230), UInt8(255)), Color(UInt8(255), UInt8(255), UInt8(255), UInt8(255)), UInt8(90), UInt8(160), False, False, SIMD(0), SIMD(18), SIMD(14), Color(UInt8(110), UInt8(110), UInt8(110), UInt8(255)), SIMD(14), Color(UInt8(150), UInt8(150), UInt8(150), UInt8(255)), Color(UInt8(224), UInt8(236), UInt8(246), UInt8(200)), Color(UInt8(255), UInt8(255), UInt8(255), UInt8(255)), True, False, False, True, AxisPosition.EDGE, AxisPosition.EDGE, String("sans-serif"), True, UInt8(90), Int(5), Int(4), Int(130), Int(14), Int(8), Int(14), Int(100), Int(8), SIMD(4), OutputFormat.SVG, Tooltips.AUTO, Missing.DRAW, String("(missing)"), Int(1000), False, LineStyle.SOLID, SIMD(1.5), LineStyle.SOLID, LegendPosition.RIGHT, XAxisLabelRotation.AUTO, TickFormat.AUTO, TickFormat.AUTO), width: Int = Int(640), height: Int = Int(420), title: String = "", subtitle: String = "", x_title: String = "", y_title: String = "", layout: GraphLayout = GraphLayout.CIRCLE) -> Chart[Graph]

A network graph: nodes connected by edges, for visualizing relationships without the ordering constraints an arc diagram or chord diagram impose.

Mark.GRAPH: Mark.CHORD’s edge list (Plot.encode_chord()) drawn as nodes joined by straight lines – evenly spaced around a circle by default, or with layout=GraphLayout.FORCE placed by a force-directed layout that gathers connected nodes together (#157). See _render_graph.

Example:

from dataviz import graph
from dataviz import save

def main() raises:
    # Illustrative weekly pallet movements through a distribution network.
    var origin: List[String] = [
        "North Plant", "South Plant", "North Plant", "South Plant",
        "Central Hub", "Central Hub", "Coastal Hub", "Coastal Hub",
        "Metro DC", "Metro DC", "Regional DC", "Regional DC",
    ]
    var destination: List[String] = [
        "Central Hub", "Central Hub", "Coastal Hub", "Coastal Hub",
        "Metro DC", "Regional DC", "Metro DC", "Port DC",
        "City Stores", "Airport Stores", "Town Stores", "Rural Stores",
    ]
    var pallets: List[Int] = [
        420, 360, 190, 240, 310, 270, 225, 180, 205, 95, 175, 120,
    ]

    var c = graph(
        origin,
        destination,
        pallets,
        title="Illustrative Weekly Distribution Network",
    )
    save(c, "docs/src/examples/out_graph.svg")

Parameters:

dtype (DType)

Args:

from_categories (List[String]): Each edge’s source node, one entry per row.
to_categories (List[String]): Each edge’s destination node, one entry per row (paired with from_categories[i]).
values (List[Scalar[dtype]]): Each edge’s magnitude, sizing its connecting line; must be non-negative.
theme (Theme): Full styling knobs beyond this function’s own parameters (colors, margins, fonts, gridlines, …) – see Theme’s docstring.
width (Int): Pixel width of the returned Plot (.size()).
height (Int): Pixel height of the returned Plot (.size()).
title (String): The chart’s title, shown above the plot.
subtitle (String): A secondary line shown under the title.
x_title (String): The x-axis caption.
y_title (String): The y-axis caption.
layout (GraphLayout): Where the nodes go: GraphLayout.CIRCLE (the default) or GraphLayout.FORCE.

Returns:

Chart[Graph]: The finished chart – unrendered. Call save(plot, path) to write it (any of .svg/.png/.bmp), or render(plot)/render_svg(plot) for the explicit two-step.

Raises: