% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/chain_structure.R
\name{summary.chain_structure}
\alias{summary.chain_structure}
\title{Tidy per-state summary of a \code{chain_structure}}
\usage{
\method{summary}{chain_structure}(object, ...)
}
\arguments{
\item{object}{A \code{chain_structure} object.}

\item{...}{Ignored.}
}
\value{
A \code{data.frame} with one row per state. Columns described above.
}
\description{
Returns a single data.frame with one row per state, combining every
per-state metric \code{chain_structure()} computes. Always includes
\code{state}, \code{classification}, \code{period}, \code{return_probability} (the
diagonal of the hitting matrix) and \code{persistence} (the diagonal of
the transition matrix); adds \code{sojourn} whenever it is finite, the
chain's \code{stationary_probability} when irreducible, and absorption
columns when the chain has any absorbing states.
}
\details{
Columns are ordered for readability: identifiers first, classification
second, dynamic per-state metrics last.
}
