% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/extract.R
\name{hmm_states}
\alias{hmm_states}
\alias{hmm_states.default}
\alias{hmm_states.dcvar_hmm_fit}
\title{Extract HMM state information}
\usage{
hmm_states(object, ...)

\method{hmm_states}{default}(object, ...)

\method{hmm_states}{dcvar_hmm_fit}(object, ...)
}
\arguments{
\item{object}{A \code{dcvar_hmm_fit} object.}

\item{...}{Additional arguments (unused).}
}
\value{
A named list with:
\itemize{
\item \code{gamma}: T_eff x K matrix of posterior state probabilities
\item \code{viterbi}: integer vector, the Viterbi (MAP) state path decoded from
the posterior-mean emission log-likelihoods, transition matrix, and
initial state probabilities (a plug-in estimator, not a full posterior
summary of the path)
\item \code{rho_state}: list with \code{mean}, \code{lower}, \code{upper} for each state
\item \code{A}: K x K posterior mean transition matrix
\item \code{rho_hmm}: posterior-averaged rho trajectory
}
}
\description{
Returns state posteriors, Viterbi path, state-specific rho values,
and the transition matrix from an HMM copula fit.
}
