Assemble an instrument — panel_instrument • LLMRpanel

Combines survey items and records the option-order randomization used during administration.

Usage

panel_instrument(items, randomize = "option_order")

Arguments

items: A list of panel_items, or a single item. Item identifiers must be unique.
randomize: "option_order" by default. Choice options are permuted for each response. A Likert scale retains its supplied order or is reversed, each with probability one-half. Use character(0) to retain the supplied option order.

Value

A panel_instrument object containing items and randomize.

Details

Each persona-item pair is administered as an independent request. The model does not receive earlier items or responses. "item_order" is therefore refused.

Administration records the displayed options in option_order. item_position is the item's fixed, 1-based position in the instrument. Likert scores use the supplied scale order, including when the displayed scale is reversed.

Examples

panel_instrument(list(
  item_likert("trust", "The city council acts in the public interest."),
  item_open("reason", "What would improve the city council's work?")
))

panel_instrument(
  item_choice("fund", "Choose an investment.", c("transit", "roads")),
  randomize = character(0)
)