Wrapper to FACDOS
immer_FACETS.RdThis 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
specified 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 agreement 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 smallest standardized residual
- usort
order in which the unexpected observation are listed
- positive
specifies which facet is positively 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 input files 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.
See also
Install FACDOS and DOSBox immer_install.
Examples
if (FALSE) {
################################
# 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 <- immer::immer_hrm_simulate( 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::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::immer_FACETS(
fileinput=data.immer06,
path.facets="C:\\Facets",
model.name="Example.SD",
facetsEXE=NULL
)
}