synamine.viz¶

Visualization functions for process models and statistics charts.

viz ¶

High-level visualization API.

view_variant_trie(
    trie: VariantTrie,
    label_strategy: str = "auto",
    pct_reference: str = "absolute",
) -> None

Display a variant trie dendrogram interactively.

PARAMETER	DESCRIPTION
`trie`	The trie to visualize. TYPE: `VariantTrie`
`label_strategy`	How to handle label collisions: `"auto"`, `"truncate"`, or `"hide"`. TYPE: `str` DEFAULT: `'auto'`
`pct_reference`	What edge percentages are relative to: `"absolute"` (root) or `"relative"` (parent node). TYPE: `str` DEFAULT: `'absolute'`

view_dfg(dfg: DirectlyFollowsGraph) -> None

Display a DFG interactively.

view_petri_net(net: PetriNet) -> None

Display a Petri Net interactively.

view_process_tree(tree: ProcessTree) -> None

Display a Process Tree interactively.

save_visualization(
    model: VariantTrie
    | DirectlyFollowsGraph
    | PetriNet
    | ProcessTree,
    path: str,
    **kwargs: Any,
) -> None

Save a model visualization to file.

PARAMETER	DESCRIPTION
`model`	The model to visualize. TYPE: `VariantTrie \| DirectlyFollowsGraph \| PetriNet \| ProcessTree`
`path`	Output file path. Format is inferred from extension (.png, .svg, .pdf). TYPE: `str`
`**kwargs`	Additional options forwarded to the renderer. For `VariantTrie`: `label_strategy` controls label collision handling (`"auto"`, `"truncate"`, `"hide"`). TYPE: `Any` DEFAULT: `{}`

plot_activity_frequencies(
    log: EventLog, *, path: str | None = None
) -> Figure | None

Plot activity frequency bar chart.

plot_case_durations(
    log: EventLog, *, path: str | None = None
) -> Figure | None

Plot case duration histogram.

plot_case_lengths(
    log: EventLog, *, path: str | None = None
) -> Figure | None

Plot case length histogram.

plot_start_end_activities(
    log: EventLog, *, path: str | None = None
) -> Figure | None

Plot start and end activity bar chart.

plot_variant_frequencies(
    log: EventLog,
    *,
    path: str | None = None,
    top_k: int = 10,
) -> Figure | None

Plot top-k variant frequency bar chart.

plot_cases_over_time(
    log: EventLog,
    *,
    path: str | None = None,
    freq: str = "W",
) -> Figure | None

Plot cases over time line chart.