simulate_sequence_batches: Simulate repeated sequence datasets

View source: R/experiments.R

simulate_sequence_batchesR Documentation

Simulate repeated sequence datasets

Description

Calls simulate_sequences() repetitions times and stacks the results, so each dataset is drawn from its own transition system rather than from a shared one.

Usage

simulate_sequence_batches(repetitions = 1L, ..., seed = NULL)

Arguments

repetitions

Number of datasets. A single positive whole number, defaulting to 1.

...

Arguments passed to simulate_sequences().

seed

Optional base seed. A single number, or NULL (the default). Dataset i uses seed + i - 1.

Value

A simulab_sim base data.frame in long form, one row per dataset, sequence and position, with the column dataset followed by the columns simulate_sequences() returns (id, period and state). Components: transitions, the generating transition probabilities, one row per dataset and from/to pair with columns dataset, from, to and probability; and initial_probabilities, one row per dataset and state with columns dataset, state and probability.

Examples

result <- simulate_sequence_batches(
  repetitions = 3, n = 20, n_states = 3, chain_length = 10, seed = 1
)
head(result)

simulab documentation built on Oct. 15, 2026, 5:08 p.m.