rthologs looks up cross-species gene orthologs and returns a tidy R data frame.
Installation
Install the development version from GitHub with pak. If you need
pak, run install.packages("pak") first.
pak::pak("igordot/rthologs")Load rthologs to run the examples.
Species
Use species() to list the available species and their
accepted names.
species()
#> taxon_id name name_class
#> 1 6239 Caenorhabditis elegans scientific name
#> 2 6239 Caenorhabditis elegans species name
#> 3 7227 Drosophila melanogaster scientific name
#> 4 7227 Drosophila melanogaster species name
#> 5 7227 fruit fly genbank common name
#> 6 7955 Danio rerio scientific name
#> 7 7955 Danio rerio species name
#> 8 7955 leopard danio common name
#> 9 7955 zebra danio common name
#> 10 7955 zebra fish common name
#> 11 7955 zebrafish genbank common name
#> 12 8364 Xenopus tropicalis scientific name
#> 13 8364 Xenopus tropicalis species name
#> 14 8364 tropical clawed frog genbank common name
#> 15 8364 western clawed frog common name
#> 16 9606 Homo sapiens scientific name
#> 17 9606 Homo sapiens species name
#> 18 9606 human genbank common name
#> 19 10090 Mus musculus scientific name
#> 20 10090 Mus musculus species name
#> 21 10090 house mouse genbank common name
#> 22 10090 mouse common name
#> 23 10116 Norway rat genbank common name
#> 24 10116 Rattus norvegicus scientific name
#> 25 10116 Rattus norvegicus species name
#> 26 10116 brown rat common name
#> 27 10116 rat common name
#> 28 10116 rats common name
#> 29 559292 Saccharomyces cerevisiae species name
#> 30 559292 Saccharomyces cerevisiae S288C scientific nameOrthologs
Use orthologs() to find the orthologs of a set of genes.
Give the genes, the source species of the genes, and the target
species.
result <- orthologs("TP53", source = "human", target = "mouse")
dplyr::glimpse(result)
#> Rows: 1
#> Columns: 11
#> $ input <chr> "TP53"
#> $ source_taxon_id <int> 9606
#> $ source_symbol <chr> "TP53"
#> $ source_ncbi_id <chr> "7157"
#> $ source_ensembl_id <chr> "ENSG00000141510"
#> $ target_taxon_id <int> 10090
#> $ target_symbol <chr> "Trp53"
#> $ target_ncbi_id <chr> "22059"
#> $ target_ensembl_id <chr> "ENSMUSG00000059552"
#> $ support <chr> "HGNC|Hieranoid|InParanoid|OMA|OrthoFinder|OrthoInsp…
#> $ support_n <int> 9The result is a standard data frame with one row for each input and
matching gene pair. The source_ columns identify the input
gene. The target_ columns identify the ortholog. The
support column lists the sources that support the pair and
the support_n column gives the number of these sources.
The source and target can be any two species in the package.
result <- orthologs("Trp53", source = "mouse", target = "rat")
dplyr::glimpse(result)
#> Rows: 1
#> Columns: 11
#> $ input <chr> "Trp53"
#> $ source_taxon_id <int> 10090
#> $ source_symbol <chr> "Trp53"
#> $ source_ncbi_id <chr> "22059"
#> $ source_ensembl_id <chr> "ENSMUSG00000059552"
#> $ target_taxon_id <int> 10116
#> $ target_symbol <chr> "Tp53"
#> $ target_ncbi_id <chr> "24842"
#> $ target_ensembl_id <chr> "ENSRNOG00000010756"
#> $ support <chr> "Ensembl Compara|Hieranoid|InParanoid|OMA|OrthoFinde…
#> $ support_n <int> 9Input genes
The input can be gene symbols, NCBI IDs, or Ensembl IDs. Inputs are case-sensitive and you can mix the input types in one vector.
genes <- c("TP53", "7157", "ENSG00000141510")
result <- orthologs(genes, source = "human", target = "mouse")
result[, c("input", "source_symbol", "target_symbol")]
#> input source_symbol target_symbol
#> 1 TP53 TP53 Trp53
#> 2 7157 TP53 Trp53
#> 3 ENSG00000141510 TP53 Trp53An input with no direct match can match a gene synonym. Synonyms
include previous symbols, such as CTGF for
CCN2. To use only the primary names, set
synonyms = FALSE.
Multiple matches
An input can have more than one ortholog. Each ortholog gets its own row.
genes <- c("Ptprc", "Hba-a1", "Gapdh")
result <- orthologs(genes, source = "mouse", target = "zebrafish")
result[, c("input", "target_symbol", "support_n")]
#> input target_symbol support_n
#> 1 Ptprc ptprc 8
#> 2 Hba-a1 hbae1.1 8
#> 3 Hba-a1 hbaa2 8
#> 4 Gapdh gapdh 10By default, the result includes only the best matches. To get all the
orthologs in the data, set best = FALSE.
result <- orthologs(
"Hba-a1",
source = "mouse",
target = "zebrafish",
best = FALSE
)
result[, c("input", "target_symbol", "support_n")]
#> input target_symbol support_n
#> 1 Hba-a1 hbae1.1 8
#> 2 Hba-a1 hbaa2 8
#> 3 Hba-a1 hbae4 4To keep only the pairs with more support, set
min_support.
Inputs without orthologs
By default, the result does not include inputs with no orthologs. To
keep these inputs, set orthologs_only = FALSE. Each of
these inputs then gets one row with NA in all other
columns.
genes <- c("Ptprc", "Cd34", "Fakegene")
result <- orthologs(
genes,
source = "mouse",
target = "zebrafish",
orthologs_only = FALSE
)
result[, c("input", "target_symbol")]
#> input target_symbol
#> 1 Ptprc ptprc
#> 2 Cd34 <NA>
#> 3 Fakegene <NA>Cd34 is a valid mouse gene, but the data contain no
zebrafish ortholog for it. Fakegene is not a mouse
gene.
Data
The orthologs come from the Alliance of Genome Resources (AGR). AGR combines predictions from these sources: PANTHER, SonicParanoid, OrthoFinder, Ensembl Compara, OrthoInspector, InParanoid, PhylomeDB, OMA, Hieranoid, HGNC, and ZFIN.
The package uses the AGR stringent set that includes:
- Pairs that three or more methods support, with a best match in at least one direction.
- Pairs that two methods support, with a best match in both directions.
- All pairs from HGNC or ZFIN.
The package includes the eight species that have orthologs with all other species in the data.
If you use the data, please cite AGR: Alliance of Genome Resources Consortium. Updates to the Alliance of Genome Resources central infrastructure. Genetics. 2024. doi: 10.1093/genetics/iyae049.