% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/leslie_disaggregate.R
\name{leslie_disaggregate}
\alias{leslie_disaggregate}
\title{Disaggregate a Leslie matrix population model to a compatible dimensionality}
\usage{
leslie_disaggregate(A, m)
}
\arguments{
\item{A}{A Leslie matrix (checked with \code{\link{is_leslie}}). A length-1 positive numeric
is treated as a 1x1 Leslie matrix.}

\item{m}{Target aggregated dimensionality (positive integer).}
}
\value{
A Leslie matrix of dimensionality \eqn{n_{new} \times n_{new}},
  where \eqn{n_{new} = \mathrm{LCM}(n, m)}.
}
\description{
Expands an \eqn{n \times n} Leslie matrix \code{A} to an
\eqn{n_{new} \times n_{new}} Leslie matrix, where
\eqn{n_{new} = \mathrm{LCM}(n, m)}.
}
\details{
Disaggregation is required when aggregating a Leslie model to dimensionality \code{m}
whenever \code{m} does not divide \code{n} evenly. The expanded matrix introduces a finer
age structure that is compatible with both dimensionalities.

Each original age class is subdivided into
\eqn{n_{new} / n} sub-classes. Fertility rates from original age class \eqn{i}
are placed at the end of the corresponding block, deterministic aging within blocks
is represented by ones on the subdiagonal, and original survival probabilities are
inserted at block boundaries.
}
\examples{
L <- matrix(c(
  0, 2, 1,
  0.6, 0, 0,
  0, 0.7, 0
), nrow = 3, byrow = TRUE)
leslie_disaggregate(L, m = 2)

}
\references{
Hinrichsen, R. A. (2023). Aggregation of Leslie matrix models with application to
ten diverse animal species. \emph{Population Ecology}, 65(3), 146-166.
\doi{10.1002/1438-390X.12149}

Hinrichsen, R. A., Yokomizo, H., & Salguero-Gómez, R. (2026). From theory to
application: Elasticity-consistent aggregation of Leslie matrix population
models for comparative demography. \emph{bioRxiv}, preprint.
\doi{10.64898/2026.02.04.703802}
}
