cluster_gen_separate: Generate cluster samples with individual questionnaires

In lsasim: Functions to Facilitate the Simulation of Large Scale Assessment Data

Generate cluster samples with individual questionnaires

Description

This is a sub-function of cluster_gen that performs cluster sampling, with the twist that each cluster level has its own questionnaire.

Usage

cluster_gen_separate(
  n_levels,
  n,
  N,
  sum_pop,
  calc_weights,
  sampling_method,
  cluster_labels,
  resp_labels,
  collapse,
  n_X,
  n_W,
  cat_prop,
  c_mean,
  sigma,
  cor_matrix,
  rho,
  theta,
  whitelist,
  verbose,
  ...
)

Arguments

n_levels	number of cluster levels
n	numeric vector or list with the number of sampled observations (clusters or subjects) on each level
N	population size of each sampled cluster element on each level. Either a numeric vector or a list of numeric vectors. If N is a list, it must have the same length as n and each element of N must have the same length as the corresponding element of n
sum_pop	total population at each level (sampled or not)
calc_weights	if TRUE, sampling weights are calculated
sampling_method	can be "SRS" for Simple Random Sampling, "PPS" for Probabilities Proportional to Size, "mixed" to use PPS for schools and SRS otherwise, or a vector with the sampling method for each level
cluster_labels	character vector with the names of each cluster level
resp_labels	character vector with the names of the questionnaire respondents on each level
collapse	if TRUE, function output contains only one data frame with all answers. It can also be "none", "partial" and "full" for finer control on 3+ levels
n_X	list of n_X per cluster level
n_W	list of n_W per cluster level
cat_prop	list of cumulative proportions for each item. If theta = TRUE, the first element of cat_prop must be a scalar 1, which corresponds to the theta.
c_mean	vector of means for the continuous variables or list of vectors for the continuous variables for each level
sigma	vector of standard deviations for the continuous variables or list of vectors for the continuous variables for each level
cor_matrix	Correlation matrix between all variables (except weights)
rho	intraclass correlation (scalar, vector or list, as appropriate)
theta	if TRUE, the first continuous variable will be labeled 'theta'. Otherwise, it will be labeled 'q1'.
whitelist	used when n = select(...), determines which PSUs get to generate questionnaires
verbose	if TRUE, prints output messages
...	Additional parameters to be passed to questionnaire_gen()

See Also

cluster_gen() cluster_gen_together()

lsasim documentation built on April 3, 2025, 5:57 p.m.