% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/nmfkc.signed.R
\name{nmfkc.signed.rank}
\alias{nmfkc.signed.rank}
\title{Rank selection for nmfkc.signed (concise diagnostics)}
\usage{
nmfkc.signed.rank(
  Y,
  A,
  rank = 1:5,
  detail = c("full", "fast"),
  plot = TRUE,
  ...
)
}
\arguments{
\item{Y}{Observation matrix (may contain negative entries).}

\item{A}{Covariate matrix (may be signed).}

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

\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.signed}} and
\code{nmfkc.signed.ecv} (e.g.\ \code{maxit}, \code{nfolds},
\code{seed}).}
}
\value{
A list with \code{rank.best} and \code{criteria}
(\code{rank}, \code{effective.rank}, \code{effective.rank.ratio},
\code{r.squared}, \code{sigma.ecv}).
}
\description{
Fits \code{\link{nmfkc.signed}} across a range of ranks and reports
\code{r.squared}, the effective rank, and the element-wise CV error
\code{sigma.ecv}, with the same concise plot as
\code{\link{nmfkc.rank}}.
}
\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.signed}}, \code{\link{nmfkc.rank}}
}
