scrapeVarCross: A Variable Name-Scraping and Indexing Function for...

In jsakaluk/dySEM: Dyadic Structural Equation Modeling

A Variable Name-Scraping and Indexing Function for cross-sectional data

Description

This function scrapes the names of indicator variables in a wide-format data set used for dyadic analyses of two latent variables (LV; X and Y), and indexes which indicators correspond to which partner, for which LV. It is used primarily to guide the syntax-writing of the other dySEM functions.

Usage

scrapeVarCross(
  dat,
  x_order = "spi",
  x_stem,
  x_delim1 = NULL,
  x_delim2 = NULL,
  x_item_num = "\\d+",
  distinguish_1 = "1",
  distinguish_2 = "2",
  y_order = NULL,
  y_stem = NULL,
  y_delim1 = NULL,
  y_delim2 = NULL,
  y_item_num = "\\d+"
)

Arguments

dat	input data frame of indicators of a particular LV
x_order	input character for order of (S)tem, (P)artner number, and (I)tem number when creating variable names. Defaults to "spi" (Qualtrics-friendly)
x_stem	input character stem of indicator variables for LV X
x_delim1	optional character to separate stem from partner number (spi) or item number (sip)
x_delim2	optional character to separate stem/partner number (spi) or stem/item number (sip) from from final element of variable name
x_item_num	defaults to scrape all items that match the stem with any digits that follow. Will be updated to allow particular range of values, to make more sub-scale friendly.
distinguish_1	input character used as the identifier for the first partner
distinguish_2	input character used as the identifier for the first partner
y_order	optional character for order of (S)tem, (P)artner number, and (I)tem number when creating variable names. Defaults to "spi" (Qualtrics-friendly). This and other Y-arguments only necessary if there is a latent Y variable to model
y_stem	optional input character stem of indicator variables for LV X
y_delim1	optional character to separate stem from partner number (spi) or item number (sip)
y_delim2	optional character to separate stem/partner number (spi) or stem/item number (sip) from from final element of variable name
y_item_num	defaults to scrape all items that match the stem with any digits that follow. Will be updated to allow particular range of values, to make more sub-scale friendly.

Value

a list, referred in short-hand as a "dvn" (dyad variable names list) containing variable names for p1, p2, # of items per LV, characters distinguishing partners, and total number of indicators

Examples

dvnx <- scrapeVarCross(dat = commitmentQ, x_order = "spi", x_stem = "sat.g", x_delim1 = ".",
x_delim2="_", distinguish_1="1", distinguish_2="2")
dvnxy <- scrapeVarCross(dat = commitmentQ, x_order = "spi", x_stem = "sat.g", x_delim1 = ".",
x_delim2="_", distinguish_1="1", distinguish_2="2",
y_order="spi", y_stem="com", y_delim1 = ".", y_delim2="_")

jsakaluk/dySEM documentation built on March 18, 2024, 1:01 p.m.