acidgenomes.map_gene_names_to_ensembl

acidgenomes.map_gene_names_to_ensembl(genes: list[str], organism: str, *, ignore_case: bool = False, hgnc: Hgnc | None = None, ncbi: NcbiGeneInfo | None = None) → list[str]

Map gene names to Ensembl gene identifiers.

For Homo sapiens, defaults to HGNC; otherwise uses NCBI.

Parameters:

  • genes (list[str]) – Gene names (symbols) to map.

  • organism (str) – Latin organism name.

  • ignore_case (bool) – Match case-insensitively.

  • hgnc (Hgnc or None) – HGNC reference dataset (used for Homo sapiens). Downloaded via make_hgnc() if None.

  • ncbi (NcbiGeneInfo or None) – NCBI gene info reference dataset (used for other organisms, or when explicitly provided). Downloaded via make_ncbi_gene_info() if None and required.

Returns:

Ensembl gene identifiers, in the same order as genes.

Return type:

list[str]