Resolve gene symbols to formal species-specific symbols — resolve_gene

Resolves human or mouse gene names using Bioconductor organism annotation packages when available, with a deterministic case-normalized fallback when formal annotation is unavailable or a symbol has no database match.

Usage

resolve_gene_symbols(
  genes,
  species = NULL,
  ref_genome = NULL,
  use_annotation = TRUE,
  allow_heuristic = TRUE
)

Arguments

genes: Character vector of gene names or identifiers.
species: Species name, either `"human"` or `"mouse"`.
ref_genome: Optional reference genome such as `"hg38"` or `"mm10"`. Used to infer `species` when `species` is `NULL`.
use_annotation: Logical; use AnnotationDbi and organism annotation packages when available.
allow_heuristic: Logical; use case-normalized fallback for unmatched symbols or when annotation packages are unavailable.

Value

A data frame with one row per input gene and columns describing the canonical symbol, matching key, match source, and ambiguity status.