% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/nmfkc.net.R
\name{nmfkc.net.rank}
\alias{nmfkc.net.rank}
\title{Rank selection for nmfkc.net (concise diagnostics)}
\usage{
nmfkc.net.rank(
  Y,
  rank = 1:5,
  type = c("tri", "bi", "signed"),
  detail = c("full", "fast"),
  plot = TRUE,
  ...
)
}
\arguments{
\item{Y}{Symmetric (network) observation matrix.}

\item{rank}{Integer vector of ranks to evaluate.}

\item{type}{One of \code{"tri"}, \code{"bi"}, \code{"signed"}.}

\item{detail}{\code{"full"} (default) also runs element-wise CV
(\code{sigma.ecv}); \code{"fast"} skips it (plots r.squared and
eff.rank only, and recommends the R-squared elbow).}

\item{plot}{Logical; draw the diagnostics plot (default \code{TRUE}).}

\item{...}{Passed on to \code{\link{nmfkc.net}} and
\code{\link{nmfkc.net.ecv}} (e.g.\ \code{nstart}, \code{maxit},
\code{nfolds}, \code{seed}).}
}
\value{
A list with \code{rank.best} (ECV minimum, or the R-squared
elbow under \code{detail = "fast"}) and \code{criteria} (data
frame: \code{rank}, \code{effective.rank}, \code{effective.rank.ratio},
\code{r.squared}, \code{sigma.ecv}).
}
\description{
Fits \code{\link{nmfkc.net}} across a range of ranks and reports the
three rank-selection criteria -- \code{r.squared}, the effective rank
(utilization), and the element-wise CV error \code{sigma.ecv} -- with
the same concise diagnostics plot as \code{\link{nmfkc.rank}}.
}
\examples{
\donttest{
Y <- matrix(c(0,1,1,0,0,0, 1,0,1,0,0,0, 1,1,0,1,0,0,
              0,0,1,0,1,1, 0,0,0,1,0,1, 0,0,0,1,1,0), 6, 6)
nmfkc.net.rank(Y, rank = 1:3, type = "tri", nstart = 5, nfolds = 3)
}
}
\references{
Roy, O., & Vetterli, M. (2007).  The effective rank: A measure of
effective dimensionality.  \emph{Proc. EUSIPCO}, 606--610.
(\code{effective.rank})
Wold, S. (1978).  Cross-validatory estimation of the number of
components in factor and principal components models.
\emph{Technometrics}, 20(4), 397--405. (\code{sigma.ecv})
}
\seealso{
\code{\link{nmfkc.net}}, \code{\link{nmfkc.net.ecv}},
\code{\link{nmfkc.rank}}
}
