% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/TOPHITS.R
\name{TOPHITS}
\alias{TOPHITS}
\title{TOPHITS: Tensor HITS Algorithm}
\usage{
TOPHITS(x, R = 2L, max_iter = 100L, tol = 1e-08)
}
\arguments{
\item{x}{An rTensor Tensor object (2-mode or 3-mode)}

\item{R}{Integer or integer vector specifying the number of components per mode.
If scalar, same rank is used for all modes.}

\item{max_iter}{Maximum iterations for Tucker decomposition (default: 100)}

\item{tol}{Convergence tolerance (default: 1e-8)}
}
\value{
A list with components:
  \describe{
    \item{scores}{List of score matrices, one per mode (each n_i x R_i).
      For symmetric tensors, a single matrix.}
    \item{core}{Core tensor from Tucker decomposition}
    \item{rankings}{List of integer vectors giving node rankings per mode
      (ordered by dominant score)}
    \item{decomp}{Full Tucker decomposition result from rTensor}
  }
}
\description{
Computes hub and authority scores for higher-order link analysis using
Tucker decomposition of a tensor. Generalization of HITS (Hyperlink-Induced
Topic Search) to tensors.
}
\details{
For a 3-mode tensor \eqn{T \in R^{I \times J \times K}},
TOPHITS computes Tucker decomposition \eqn{T \approx C \times_1 U_1 \times_2 U_2 \times_3 U_3}
and derives hub/authority scores from the factor matrices.

For a symmetric tensor (all modes equal), a single set of scores is returned.
}
\examples{
library(rTensor)
# Create a 3-mode tensor
arr <- array(abs(rnorm(125)), dim = c(5, 5, 5))
tnsr <- as.tensor(arr)
result <- TOPHITS(tnsr, R = 2)
result$rankings
}
\references{
Kolda, T. G., & Bader, B. W. (2006).
The TOPHITS Model for Higher-Order Web Link Analysis.
Workshop on Link Analysis, Counterterrorism and Security.
}
