% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/alm_bmi_index.R
\name{alm_bmi_index}
\alias{alm_bmi_index}
\title{Appendicular Lean Mass to BMI Index}
\usage{
alm_bmi_index(
  data,
  col_map = NULL,
  na_action = c("keep", "omit", "error", "ignore", "warn"),
  verbose = TRUE
)
}
\arguments{
\item{data}{A data.frame or tibble with ALM, BMI, and sex columns.}

\item{col_map}{Named list with:
\itemize{
\item alm: appendicular lean mass column name (kg)
\item bmi: body mass index column name (kg/m^2)
\item sex: sex column name ("Male"/"Female" or m/f; case-insensitive)
}}

\item{na_action}{One of c("keep","omit","error","ignore","warn").}

\item{verbose}{Logical; if TRUE (default), emits progress messages.}
}
\value{
A tibble with:
\itemize{
\item alm_bmi_ratio   (numeric)
\item low_muscle_mass (logical; TRUE if below sex-specific cut-point;
NA if sex unknown or ratio NA)
}
}
\description{
Calculates the ratio of appendicular lean mass (ALM) to body mass index (BMI),
and flags low muscle mass based on FNIH Sarcopenia Project cut-points.
}
\details{
ALM/BMI reflects muscle mass relative to body size. FNIH cut-points:
\itemize{
\item Men:    ALM/BMI < 0.789
\item Women:  ALM/BMI < 0.512
}

ALM should be in kilograms and BMI in kg/m^2.
}
\examples{
df <- data.frame(ALM_kg = c(7.2, 5.8, 6.5), BMI = c(24, 28, 22),
                 Sex = c("male", "female", "male"))
alm_bmi_index(df)
}
\references{
\insertRef{mclean2014fnih}{HealthMarkers}
}
