Learn R Programming

immer (version 0.4-0)

immer_FACETS: Wrapper to FACDOS

Description

This Function is a wrapper do the DOS version of FACETS (Linacre, 1999).

Usage

immer_FACETS(title = NULL, convergence = NULL, totalscore = NULL, facets = NULL, 
  noncenter = NULL,  arrange = NULL,entered_in_data = NULL, models = NULL, 
  inter_rater = NULL, pt_biserial = NULL, faire_score = NULL, unexpected = NULL, 
  usort = NULL, positive = NULL, labels = NULL, fileinput = NULL, data=NULL, 
  path.dosbox  =  NULL, path.facets  =  "", model.name = NULL, facetsEXE = NULL )

Arguments

title
title of the analysis
convergence
convergence criteria
totalscore
show the total score with each observation
facets
number of specified facets
noncenter
specifie the non centered facet here
arrange
control the ordering in each table/output
entered_in_data
optional specification for facets
models
model to be used in the analysis
inter_rater
Specify rater facet number for the agreemant report among raters
pt_biserial
correlation between the raw-score for each element
faire_score
intended for communicating the measures as adjusted ratings
unexpected
size of smalest standardized residual
usort
order in which the unexpected observation are listed
positive
specifie which facet is positiv oriented
labels
name of each facet, followed by a list of elements
fileinput
optional argument, if your data are stored within a separate file
data
Input of the data in long-format
path.dosbox
Path to the installed DOSBox. If NULL: the function assumed that you have purchased FACETS and would like to use this version (currently only for Windows-User)
path.facets
Path to FACDOS or FACETS if the path.dosbox is "NULL"
model.name
Name of the configuration file for FACETS
facetsEXE
optional argument to specifie specific FACETS.exe

Details

Within. the function immer_FACETS it is either possible to pass existing FACETS-Inpuitfiles or to specify the Input within the function. To run the estimation in FACETS it is necessary to provide both the path to the DosBox and FACDOS (it is recommended to use the function immer_install for the installation process). After the estimation process is finished the Exports are in the Facets folder.

References

Linacre, J. M. (1999). FACETS (Version 3.17)[Computer software]. Chicago: MESA.

See Also

Install FACDOS and DOSBox immer_install.

Examples

Run this code
################################
# 1. Example on Windows
################################
# define data generating parameters
set.seed(1997)
N <- 500  # number of persons
I <- 4    # number of items
R <- 3    # number of raters
K <- 3    # maximum score 
sigma <- 2  # standard deviation
theta <- rnorm( N , sd = sigma )  # abilities
# item intercepts
b <- outer( seq( -1.5 , 1.5 , len = I) , seq( -2 , 2 , len = K)  , "+" )
# item loadings
a <- rep(1,I)
# rater severity parameters
phi <- matrix( c(-.3 , -.2 , .5) , nrow = I , ncol = R , byrow = TRUE )
phi <- phi + rnorm( phi  , sd  =  .3 )
phi <- phi - rowMeans(phi)
# rater variability parameters
psi <- matrix( c(.1 , .4 , .8) , nrow = I , ncol = R , byrow = TRUE )
# simulate HRM data
data <- simulate_HRM( theta , a , b , phi   =  phi, psi  =  psi )

# prepare data for FACETS
data2FACETS <- function(data){
  tmp <- match(c("pid","rater"),colnames(data))
  items <- grep("I",colnames(data))
cbind(data[ , match(c("pid","rater"),
colnames(data))],gr = paste0("1-",length(items)),data[,items])
}
facets_in <- data2FACETS(data)

# Example of FACETS
mod1.a <- immer_FACETS(
  title = "Example 1 with simulated data",
  convergence = NULL,
  totalscore = "YES",
  facets = 3,
  noncenter = NULL,
  arrange = "m,N",
  entered_in_data = "2,1,1",
  models = "?$,?$,?$,R4",
  inter_rater = NULL,
  pt_biserial = NULL,
  faire_score = "Zero",
  unexpected = 2,
  usort = NULL,
  positive = 1,
  labels = c("1,Persons","1-500","2,Rater","1-3","3,Item","1-4"),
  fileinput = NULL,
  data = facets_in,
  path.dosbox  =  NULL,
  path.facets  =  "C:\\Facets",
  model.name = "Example.SD",
  facetsEXE = NULL
  )

################################
# 2. Example on Windows using existing input-files of FACETS
################################ 
data(data.immer06)

mod1b <- immer_FACETS(
  fileinput = data.immer06,
  path.facets  =  "C:\\Facets",
  model.name = "Example.SD",
  facetsEXE = NULL
  )

Run the code above in your browser using DataLab