summary.PerFit: Summary method for objects of class "PerFit"

Description Usage Arguments Details Author(s) See Also Examples

View source: R/SummaryPerFit.R

Description

Summary method for objects of class "PerFit".

Usage

1
2
3
4
5
6
7
## S3 method for class 'PerFit'
summary(object, cutoff.obj=NULL, 
        ModelFit="NonParametric", Nreps=1000, 
        IP=object$IP, IRT.PModel=object$IRT.PModel, Ability=object$Ability,
        Ability.PModel=object$Ability.PModel, mu=0, sigma=1, 
        Blvl = 0.05, Breps = 1000, CIlvl = 0.95, 
        UDlvl = NA, ...)

Arguments

object

Object of class "PerFit".

cutoff.obj

Object of class "PerFit.cutoff".

ModelFit

Method required to compute model-fitting item score patterns. The options available are "NonParametric" (default) and "Parametric".

Nreps

Number of model-fitting item score patterns generated. Default is 1000.

IP

Matrix with previously estimated item parameters. Default is object$IP.

IRT.PModel

Parametric IRT model (required if "ModelFit=Parametric" or if the person fit statistic is parametric). Default is object$IRT.PModel.

Ability

Matrix with previously estimated item parameters. Default is object$Ability.

Ability.PModel

Method to use in order to estimate the latent ability parameters (required if "ModelFit=Parametric" or if the person fit statistic is parametric). Default is object$Ability.PModel.

mu

Mean of the apriori distribution. Only used when method="BM". Default is 0.

sigma

Standard deviation of the apriori distribution. Only used when method="BM". Default is 1.

Blvl

Significance level for bootstrap distribution (value between 0 and 1). Default is 0.05.

Breps

Number of bootstrap resamples. Default is 1000.

UDlvl

User-defined cutoff level.

CIlvl

Level of bootstrap percentile confidence interval for the cutoff statistic.

...

Additional arguments to be passed to summary.

Details

For a given object of class PerFit, this function prints: The PFS used, the cutoff value, the tail of the distribution of the person-fit statistic associated to misfit, the proportion of flagged respondents in the sample, and their row indices.

Author(s)

Jorge N. Tendeiro tendeiro@hiroshima-u.ac.jp

See Also

cutoff, flagged.resp, plot.PerFit, summary.PerFit

Examples

1
2
3
4
5
6
7
# Load the inadequacy scale data (dichotomous item scores):
data(InadequacyData)

# Compute the ZU3 scores:
ZU3.out <- ZU3(InadequacyData)

summary(ZU3.out)

Example output

Loading required package: ltm
Loading required package: MASS
Loading required package: msm
Loading required package: polycor
Loading required package: mirt
Loading required package: stats4
Loading required package: lattice

Attaching package: 'mirt'

The following object is masked from 'package:ltm':

    Science

Warning message:
no DISPLAY variable so Tk is not available 

PFS = ZU3
Cutoff = 2.1535 (SE = 0.1787).
Tail = upper.
Proportion of flagged respondents = 0.0521.
(N.B.: The cutoff varies each time cutoff() is run due to bootstrapping.)

Identified respondents - 42 in total:
    3 6 13 16 30 46 47 49 78 92 104 116 118 120 127 137 138 167 177 193 202 205 235 239 278 282 283 286 367 369 374 397 416 423 424 445 450 523 634 742 750 774 

PerFit documentation built on Feb. 22, 2021, 9:11 a.m.