Last data update: 2014.03.03

R: Utility Functions for nScree Class Objects
structureSimObjectMethodsR Documentation

Utility Functions for nScree Class Objects

Description

Utility functions for structureSim class objects. Note that with the plot.structureSim a dotted black vertical line shows the median number of factors retained by all the different indices.

Usage

 ## S3 method for class 'structureSim'
 boxplot(x, nFactors=NULL, eigenSelect=NULL,
                                 vLine="green", xlab="Factors",
                                 ylab="Eigenvalues", main="Eigen Box Plot", ...)
 ## S3 method for class 'structureSim'
      is(object)
 ## S3 method for class 'structureSim'
    plot(x, nFactors=NULL, index=NULL,
                                 main="Index Acuracy Plot", ...)
 ## S3 method for class 'structureSim'
   print(x, index=NULL, ...)
 ## S3 method for class 'structureSim'
 summary(object, index=c(1:15), eigenSelect=NULL, ...)
 

Arguments

eigenSelect

numeric: vector of the index of the selected eigenvalues

index

numeric: vector of the index of the selected indices

main

character: main title

nFactors

numeric: if known, number of factors

object

structureSim: an object of the class structureSim

vLine

character: color of the vertical indicator line of the initial number of factors in the eigen boxplot

x

structureSim: an object of the class structureSim

xlab

character: x axis label

ylab

character: y axis label

...

variable: additionnal parameters to give to the boxplot, plot, print and summary functions.

Value

Generic functions for the structureSim class:

boxplot.structureSim

graphic: plots an eigen boxplot

is.structureSim

logical: is the object of the class structureSim?

plot.structureSim

graphic: plots an index acuracy plot

print.structureSim

numeric: data.frame of statistics about the number of components/factors to retain according to different indices following a structureSim simulation

summary.structureSim

list: two data.frame, the first with the details of the simulated eigenvalues, the second with the details of the simulated indices

Author(s)

Gilles Raiche
Centre sur les Applications des Modeles de Reponses aux Items (CAMRI)
Universite du Quebec a Montreal
raiche.gilles@uqam.ca, http://www.er.uqam.ca/nobel/r17165/

References

Raiche, G., Riopel, M. and Blais, J.-G. (2006). Non graphical solutions for the Cattell's scree test. Paper presented at the International Annual meeting of the Psychometric Society, Montreal. [http://www.er.uqam.ca/nobel/r17165/RECHERCHE/COMMUNICATIONS/]

See Also

nFactors-package

Examples

## Not run: 
## INITIALISATION
 library(xtable)
 library(nFactors)
 nFactors  <- 3
 unique    <- 0.2
 loadings  <- 0.5
 nsubjects <- 180
 repsim    <- 10
 var       <- 36
 pmjc      <- 12
 reppar    <- 10
 zwick     <- generateStructure(var=var, mjc=nFactors, pmjc=pmjc,
                                loadings=loadings,
                                unique=unique)

## SIMULATIONS
mzwick    <-  structureSim(fload=as.matrix(zwick), reppar=reppar,
                           repsim=repsim, details=TRUE,
                           N=nsubjects, quantile=0.5)

## TEST OF structureSim METHODS
 is(mzwick)
 summary(mzwick, index=1:5, eigenSelect=1:10, digits=3)
 print(mzwick, index=1:10)
 plot(x=mzwick, index=c(1:10), cex.axis=0.7, col="red")
 boxplot(x=mzwick, nFactors=3, vLine="blue", col="red")
 
## End(Not run)
 

Results