Skip to contents

One row per logged message, in order, with what the records say about how the speaker came to have the floor. No model is called. The System roster row is left out.

Usage

fg_turns(x)

Arguments

x

A focus_group_result, a focus_group_arms object, a FocusGroup, or the list that FocusGroup$run_arms() returns, as for summarize_focus_group().

Value

A data frame with segment ("session", or "prefix" and the arm names; an arm's rows start after the branch point), message_id, item, round, phase, speaker_id, handle, is_moderator, injected, visibility ("shared" or "participants"), verbatim, words, rule (the routing rule that chose a participant turn), candidates and excluded (list-columns from the routing record), trigger_message_id, link, and linked_message_id.

Results made before guide items and handles were recorded take item from round (or, for an imported transcript without rounds, start a new item at each moderator message, with item 0 before the first) and handle from speaker_id.

Details

link is "addressed" when the moderator's preceding line named the participant, "called_on" when the moderator called on a participant who had been silent, and otherwise "sequence": the message simply follows the one before it, which says nothing about whom it answers. For the first two, linked_message_id is the moderator's line (the routing record's trigger_message_id); for "sequence", the previous message.

Examples

transcript <- data.frame(
  speaker = c("Moderator", "Ana", "Ben", "Moderator", "Ana"),
  text = c("What should change?", "Longer evening hours.",
           "More weekend staff.", "Ana, why evenings?",
           "I work days.")
)
fg_turns(focus_group_from_transcript(transcript))
#>   segment message_id item round    phase speaker_id    handle is_moderator
#> 1 session          1    1     1 imported  Moderator Moderator         TRUE
#> 2 session          2    1     1 imported        Ana       Ana        FALSE
#> 3 session          3    1     1 imported        Ben       Ben        FALSE
#> 4 session          4    2     2 imported  Moderator Moderator         TRUE
#> 5 session          5    2     2 imported        Ana       Ana        FALSE
#>   injected visibility verbatim words rule candidates excluded
#> 1    FALSE     shared    FALSE     3 <NA>                    
#> 2    FALSE     shared    FALSE     3 <NA>                    
#> 3    FALSE     shared    FALSE     3 <NA>                    
#> 4    FALSE     shared    FALSE     3 <NA>                    
#> 5    FALSE     shared    FALSE     3 <NA>                    
#>   trigger_message_id     link linked_message_id
#> 1                 NA sequence                NA
#> 2                 NA sequence                 1
#> 3                 NA sequence                 2
#> 4                 NA sequence                 3
#> 5                 NA sequence                 4