Creates a Graphviz DOT script that visualizes the structural network estimated by nmf.sem. The resulting diagram displays:

  • endogenous observed variables (\(Y_1\)),

  • exogenous observed variables (\(Y_2\)),

  • latent factors (\(F_1\), ..., \(F_Q\)),

together with the non-negative path coefficients whose magnitudes exceed a user-specified threshold.

Directed edges represent estimated relationships:

  • \(Y_2 \rightarrow F_q\): entries of C2 (exogenous loadings),

  • \(F_q \rightarrow Y_1\): rows of X (factor-to-endogenous mappings),

  • \(Y_1 \rightarrow F_q\): entries of C1 (feedback paths).

Edge widths are scaled by coefficient magnitude, and nodes are placed in optional visual clusters. Only variables participating in edges above the threshold are displayed, while latent factors are always shown.

nmf.sem.DOT(
  result,
  weight_scale = 5,
  weight_scale_y2f = weight_scale,
  weight_scale_fy1 = weight_scale,
  weight_scale_feedback = weight_scale,
  threshold = 0.01,
  rankdir = "LR",
  fill = TRUE,
  cluster.box = c("normal", "faint", "invisible", "none"),
  cluster.labels = NULL
)

Arguments

result

A list returned by nmf.sem, containing matrices X, C1, and C2.

weight_scale

Base scaling factor for edge widths.

weight_scale_y2f

Optional override for scaling edges \(Y_2 \rightarrow F_q\). Defaults to weight_scale.

weight_scale_fy1

Optional override for scaling edges \(F_q \rightarrow Y_1\). Defaults to weight_scale.

weight_scale_feedback

Optional override for scaling feedback edges \(Y_1 \rightarrow F_q\). Defaults to weight_scale.

threshold

Minimum coefficient value needed for an edge to be drawn.

rankdir

Graphviz rank direction (e.g., "LR", "TB").

fill

Logical; whether to use filled node shapes.

cluster.box

Character string controlling the visibility and style of cluster frames around Y2, factors, and Y1 blocks. One of "normal", "faint", "invisible", "none".

cluster.labels

Optional character vector of length 3 giving custom labels for the Y2, factor, and Y1 clusters.

Value

A character string representing a valid Graphviz DOT script.