https://github.com/cran/nFactors
Raw File
Tip revision: 0d077e574bae60fadd67bd0683ad4277c58f593a authored by Gilles Raiche on 10 October 2022, 11:20:07 UTC
version 2.4.1.1
Tip revision: 0d077e5
structureSimObjectMethods.Rd
% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/structureSimObjectMethods.r
\name{summary.structureSim}
\alias{summary.structureSim}
\alias{boxplot.structureSim}
\alias{is.structureSim}
\alias{plot.structureSim}
\alias{print.structureSim}
\title{Utility Functions for nScree Class Objects}
\usage{
\method{summary}{structureSim}(object, index = c(1:15),
  eigenSelect = NULL, ...)

\method{print}{structureSim}(x, index = NULL, ...)

\method{boxplot}{structureSim}(x, nFactors = NULL, eigenSelect = NULL,
  vLine = "green", xlab = "Factors", ylab = "Eigenvalues",
  main = "Eigen Box Plot", ...)

\method{plot}{structureSim}(x, nFactors = NULL, index = NULL,
  main = "Index Acuracy Plot", ...)

is.structureSim(object)
}
\arguments{
\item{object}{structureSim: an object of the class \code{structureSim}}

\item{index}{numeric: vector of the index of the selected indices}

\item{eigenSelect}{numeric: vector of the index of the selected eigenvalues}

\item{...}{variable: additionnal parameters to give to the \code{boxplot},
\code{plot}, \code{print} and \code{summary functions.}}

\item{x}{structureSim: an object of the class \code{structureSim}}

\item{nFactors}{numeric: if known, number of factors}

\item{vLine}{character: color of the vertical indicator line of the initial
number of factors in the eigen boxplot}

\item{xlab}{character: x axis label}

\item{ylab}{character: y axis label}

\item{main}{character: main title}
}
\value{
Generic functions for the \code{structureSim} class:
\item{boxplot.structureSim }{ graphic: plots an eigen boxplot }
\item{is.structureSim}{ logical: is the object of the class
\code{structureSim}? } \item{plot.structureSim }{ graphic: plots an index
acuracy plot} \item{print.structureSim }{ numeric: data.frame of statistics
about the number of components/factors to retain according to different
indices following a \code{structureSim} simulation}
\item{summary.structureSim }{ list: two data.frame, the first with the
details of the simulated eigenvalues, the second with the details of the
simulated indices}
}
\description{
Utility functions for \code{structureSim} class objects. Note that with the
\code{plot.structureSim} a dotted black vertical line shows the median
number of factors retained by all the different indices.
}
\examples{

\dontrun{
## 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")
 }

}
\references{
Raiche, G., Walls, T. A., Magis, D., Riopel, M. and Blais, J.-G. (2013). Non-graphical solutions
for Cattell's scree test. Methodology, 9(1), 23-29.
}
\seealso{
\code{\link{nFactors-package}}
}
\author{
Gilles Raiche \cr Centre sur les Applications des Modeles de
Reponses aux Items (CAMRI) \cr Universite du Quebec a Montreal\cr
\email{raiche.gilles@uqam.ca}
}
\keyword{multivariate}
back to top