get_taxonomy_counts: Return the count of each taxon in a taxonomy graph

In franciscolobo/TaxonSampling: Hierarchical Taxonomic Sampling for Maximized Diversity at All Levels

Description

This function evaluates the taxonomy structure from a set of input IDs and returns the count of each taxon ID with non-zero occurrences in the taxonomy graph.

Usage

get_taxonomy_counts(
  taxonomy_path = NULL,
  ids_file = NULL,
  ids_df = NULL,
  nodes = NULL,
  verbose = TRUE
)

Arguments

taxonomy_path	path to folder containing the NCBI taxonomy files (i.e., the contents of _taxdump.zip_, which can be downloaded from <ftp://ftp.ncbi.nih.gov/pub/taxonomy/> or retrieved using [retrieve_NCBI_taxonomy()]).
ids_file	path to a tab-separated file containng two two columns, with the input taxon IDs in the first column, and the corresponding sequence IDs (corresponding to the ID strings int the multifasta input file, without the ">" line starter) in the second column.
ids_df	two-column data frame with the input taxon IDs in the first column, and the corresponding sequence IDs (corresponding to the ID strings int the multifasta input file, without the ">" line starter) in the second column. Ignored if 'ids_file' is not 'NULL'.
nodes	data.frame containing the pre-processed information about the NCBI taxonomy structure. This is generated either by using [CHNOSZ::getnodes()], or as a result of a previous call to this function. If 'nodes' is not 'NULL' then 'taxonomy_path' is ignored.
verbose	logical: regulates function echoing to console.

Value

list object of class _taxonsampling_, containing:

• '$ids_df': data.frame with taxon IDs in column 1 and corresponding sequence IDs in column 2, as loaded from 'ids_file' or passed directly as input. Filtered to maintain only IDs that exist in '$nodes' and to remove duplicated IDs.

• '$nodes': data.frame containing the pre-processed information about the NCBI taxonomy structure, extracted from file _nodes.dmp_ of the taxonomy files. Filtered to keep only nodes with IDs present in '$ids_df' and with a non-zero total count.

• '$countIDs': numeric vector with the counts of the number of taxonomy nodes (of all levels) under each taxon ID.

franciscolobo/TaxonSampling documentation built on Dec. 31, 2021, 12:04 a.m.