compare_sequence_panel_changes: Compare within-panel sequence changes

In gp3sequences: Transparent Analysis of Ordered Categorical Sequences

Compare within-panel sequence changes

Description

Computes distance and simple structural changes between consecutive panel occasions. The output is descriptive and does not establish a causal or psychological change.

Usage

compare_sequence_panel_changes(
  panel,
  method = c("levenshtein", "lcs", "optimal_matching", "transition"),
  normalise = c("none", "max_length", "path_length"),
  indel_cost = 1,
  substitution_cost = 1,
  substitution_matrix = NULL,
  transition_smoothing = 0
)

Arguments

panel	A sequence panel.
method	Distance method supported by compute_sequence_distance().
normalise	Distance normalisation.
indel_cost, substitution_cost	Costs for optimal matching.
substitution_matrix	Optional named substitution matrix.
transition_smoothing	Smoothing for transition-profile distance.

Value

A data frame of class gp3_sequence_panel_changes.

Examples

panel_data <- data.frame(
  participant_id = rep(c("p1", "p2"), each = 8L),
  occasion = rep(rep(c(1, 2), each = 4L), times = 2L),
  sequence_id = rep(c("a", "b", "c", "d"), each = 4L),
  sequence_order = rep(1:4, times = 4L),
  state = c("A", "B", "C", "D", "A", "C", "C", "D",
            "D", "C", "B", "A", "D", "B", "B", "A")
)
compare_sequence_panel_changes(
  prepare_sequence_panel(panel_data, "participant_id", "occasion"),
  method = "lcs"
)

gp3sequences documentation built on Aug. 23, 2026, 5:10 p.m.