Struct StatsModelsGraph 

pub struct StatsModelsGraph {
    pub name: String,
    pub description: String,
    pub nodes: Vec<StatsModelsNode>,
    pub edges: Vec<StatsModelsEdge>,
    /* private fields */
}

Rooted directed acyclic graph representing a BIDS-StatsModel specification.

A StatsModelsGraph is loaded from a JSON file conforming to the BIDS-StatsModels specification. It contains analysis nodes at different levels of the BIDS hierarchy (run, session, subject, dataset) connected by edges that define how contrasts and data flow between levels.

Lifecycle

1. Load — Parse from JSON file or value via from_file() or from_json()
2. Validate — Check structure via validate()
3. Load data — Populate nodes with variables from a layout via load_collections()
4. Execute — Run the analysis pipeline via run()
5. Export — Generate DOT graph via write_graph()

Corresponds to PyBIDS’ StatsModelsGraph class.

Fields

name: String

description: String

nodes: Vec<StatsModelsNode>

edges: Vec<StatsModelsEdge>

Implementations

impl StatsModelsGraph

pub fn from_json(model_json: &Value) -> Result<Self>

Load from a JSON model spec (path or parsed value).

pub fn from_file(path: &Path) -> Result<Self>

Load from a file path.

pub fn validate(&self) -> Result<()>

Validate the model structure.

pub fn get_node(&self, name: &str) -> Option<&StatsModelsNode>

Get a node by name.

pub fn root_node(&self) -> &StatsModelsNode

Get the root node.

pub fn load_collections(&mut self, layout: &BidsLayout)

Load collections from a layout into all nodes.

pub fn write_graph(&self) -> String

Write graph structure as a DOT file (text-based graphviz).

pub fn render_graph(&self, output_path: &Path, format: &str) -> Result<()>

Render graph to a file using the dot command (requires graphviz installed).

pub fn run(&self) -> Vec<StatsModelsNodeOutput>

Run the entire graph recursively.

Trait Implementations

impl Debug for StatsModelsGraph

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.