R/data-hai.R

In cograph: Analysis and Visualization of Complex Networks

#' Human-AI Interaction Coding Sequences
#'
#' Coded sequences of human-AI programming interactions from 34 projects
#' across 429 sessions. Actions are coded at two granularity levels
#' (broad categories vs fine-grained codes) and split by actor
#' (Human, AI, or both combined). Each row is one session (project +
#' session_id); columns T1, T2, ... hold the sequential actions.
#' \code{NA} indicates the session ended before that time step.
#'
#' @format
#' \describe{
#'   \item{coding}{429 x 164 data.frame. Human actions by category
#'     (9 states: Command, Correct, Frustrate, Inquire, Interrupt,
#'     Refine, Request, Specify, Verify).}
#'   \item{coding_detailed}{429 x 164 data.frame. Human actions by
#'     fine-grained code (15 states: Accept, Arguing, Ask, Command,
#'     Context, Correction, Direct, Frustration, Interrupt, Refinement,
#'     Reject, Request, Specification, Thinking, Verification).}
#'   \item{ai_coding}{428 x 138 data.frame. AI actions by category
#'     (8 states: Ask, Delegate, Execute, Explain, Investigate, Plan,
#'     Repair, Report).}
#'   \item{ai_detailed}{428 x 138 data.frame. AI actions by fine-grained
#'     code (18 states: Acknowledge, Apologize, Ask, Comply, Delegate,
#'     Diagnose, Escape, Execute, Explain, Hedge, Investigate, Plan,
#'     Refuse, Report, Retry, Scaffold, Suggest, Warn).}
#'   \item{human_ai}{429 x 302 data.frame. Both actors combined, by
#'     category (17 states).}
#'   \item{human_ai_detailed}{429 x 302 data.frame. Both actors combined,
#'     by fine-grained code (32 states).}
#' }
#'
#' @return A \code{data.frame} where each row is one session. The first
#'   columns identify the session; the remaining columns (T1, T2, ...) hold
#'   the sequential action codes, with \code{NA} indicating the session ended
#'   before that time step.  Six variants are provided: \code{coding} (human
#'   actions by category, 9 states), \code{coding_detailed} (human actions by
#'   fine-grained code, 15 states), \code{ai_coding} (AI actions by category,
#'   8 states), \code{ai_detailed} (AI actions by fine-grained code, 18 states),
#'   \code{human_ai} (both actors by category, 17 states), and
#'   \code{human_ai_detailed} (both actors by fine-grained code, 32 states).
#'
#' @source Human-AI programming interaction study, 34 projects, 429 sessions.
#' @name hai_datasets
#' @aliases coding coding_detailed ai_coding ai_detailed human_ai human_ai_detailed
#'
#' @examples
#' data(coding)
#' head(coding[, 1:6])
#' dim(coding)
NULL

#' @rdname hai_datasets
"coding"

#' @rdname hai_datasets
"coding_detailed"

#' @rdname hai_datasets
"ai_coding"

#' @rdname hai_datasets
"ai_detailed"

#' @rdname hai_datasets
"human_ai"

#' @rdname hai_datasets
"human_ai_detailed"