% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/fetch.R
\name{get_lineage_by_id}
\alias{get_lineage_by_id}
\title{Retrieve the full taxonomic lineage of a taxon}
\usage{
get_lineage_by_id(taxon_id, clean = TRUE, verbose = FALSE)
}
\arguments{
\item{taxon_id}{A numeric or character string giving the Taxonomicon ID.
Obtain this with \code{\link[=get_taxonomicon_id]{get_taxonomicon_id()}}.}

\item{clean}{Logical. If \code{TRUE} (default), removes philosophical root nodes
above \code{Biota} (i.e., Natura, actualia, Mundus, naturalia) and strips
dagger and superscript markers from names.}

\item{verbose}{Logical. If \code{TRUE}, prints status messages. Default \code{FALSE}.}
}
\value{
A character vector of clade names from root to tip, or \code{NULL} if
retrieval fails.
}
\description{
Given a Taxonomicon numeric ID, retrieves and parses the complete
hierarchical lineage from root (Natura) to the taxon itself. The lineage
is returned as a character vector ordered from root to tip.
}
\details{
Lineage data is sourced from The Taxonomicon, which is based on
Systema Naturae 2000 (Brands, S.J., 1989 onwards). Lineage resolution varies
among taxonomic groups and may change when the source classification is
updated. Because hierarchy distances depend on lineage depth, analyses
should record the retrieval date and package version.
}
\examples{
\donttest{
id <- get_taxonomicon_id("Tyrannosaurus")
lin <- get_lineage_by_id(id)
print(lin)
}
}
\seealso{
\code{\link[=get_lineage]{get_lineage()}}, \code{\link[=taxo_distance]{taxo_distance()}}
}
