% 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). The depth of lineages
in The Taxonomicon substantially exceeds that of other programmatic sources
such as the Open Tree of Life, particularly for well-studied clades such
as Dinosauria, where intermediate clades at the level of superfamilies,
tribes, and named subclades are fully resolved.
}
\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()}}
}
