This function returns a wide data set with one row for each sudden gain/loss and assigns a unique identifier to each. The data set includes variables indicating values around the period of each gain/loss, and calculates descriptives of each gain/loss.
create_bysg(
data,
sg_crit1_cutoff,
id_var_name,
sg_var_list,
tx_start_var_name,
tx_end_var_name,
sg_measure_name,
sg_crit2_pct = 0.25,
sg_crit3 = TRUE,
sg_crit3_alpha = 0.05,
sg_crit3_adjust = TRUE,
sg_crit3_critical_value = 2.776,
identify = c("sg", "sl"),
identify_sg_1to2 = FALSE
)
A wide data set with one row per sudden gain/loss.
A data set in wide format including an ID variable and variables for each measurement point.
Numeric, specifying the cut-off value to be used for the first sudden gains criterion.
The function define_crit1_cutoff
can be used to calculate a cutoff value based on the Reliable Change Index (RCI; Jacobson & Truax, 1991).
If set to NULL
the first criterion wont be applied.
String, specifying the name of the ID variable.
Vector, specifying the variable names of each measurement point sequentially.
String, specifying the variable name of the first measurement point of the intervention.
String, specifying the variable name of the last measurement point of the intervention.
String, specifying the name of the measure used to identify sudden gains/losses.
Numeric, specifying the percentage change to be used for the second sudden gains/losses criterion.
If set to NULL
the second criterion wont be applied.
If set to TRUE
the third criterion will be applied automatically adjusting the critical value for missingness.
If set to FALSE
the third criterion wont be applied.
Numeric, alpha for the student t-test (two-tailed) to determine the critical value to be used for the third criterion. Degrees of freedom are based on the number of available data in the three sessions preceding the gain and the three sessions following the gain.
Logical, specify whether critical value gets adjusted for missingness, see Lutz et al. (2013) and the documentation of this R package for further details.
This argument is set to TRUE
by default adjusting the critical value for missingness as described in the package documentation and Lutz et al. (2013):
A critical value of 2.776 is used when all three data points before and after a potential gain are available,
where one datapoint is missing either before or after a potential gain a critical value of 3.182 is used,
and where one datapoint is missing both before and after the gain a critical value of 4.303 is used (for sg_crit3_alpha = 0.05).
If set to FALSE
the critical value set in sg_crit3_critical_value
will instead be used for all comparisons, regardless of missingnes in the sequence of data points that are investigated for potential sudden gains.
Numeric, specifying the critical value to instead be used for all comparisons, regardless of missingnes in the sequence of data points that are investigated for potential sudden gains.#'
String, specifying whether to identify sudden gains ("sg"
) using identify_sg
or sudden losses ("sl"
) using identify_sl
.
The default is to identify sudden gains ("sg"
).
Logical, indicating whether to identify sudden losses from measurement point 1 to 2.
If set to TRUE, this implies that the first variable specified in sg_var_list
represents a baseline measurement point, e.g. pre-intervention assessment.
Tang, T. Z., & DeRubeis, R. J. (1999). Sudden gains and critical sessions in cognitive-behavioral therapy for depression. Journal of Consulting and Clinical Psychology, 67(6), 894–904. https://doi.org/10.1037/0022-006X.67.6.894.
# Create bypsg data set
create_bysg(data = sgdata,
sg_crit1_cutoff = 7,
id_var_name = "id",
tx_start_var_name = "bdi_s1",
tx_end_var_name = "bdi_s12",
sg_var_list = c("bdi_s1", "bdi_s2", "bdi_s3",
"bdi_s4", "bdi_s5", "bdi_s6",
"bdi_s7", "bdi_s8", "bdi_s9",
"bdi_s10", "bdi_s11", "bdi_s12"),
sg_measure_name = "bdi")
Run the code above in your browser using DataLab