search_nodes: Query nodes

View source: R/search_nodes.R

search_nodesR Documentation

Query nodes

Description

Search for networks by querying the nodes table. If the query is a character string, then all character columns in the table are searched and the entries for which at least one partial match was found are returned. Alternatively, a named list can be used to look for an exact match in a specific column (see Details section)

Usage

search_nodes(query, verbose = TRUE, ...)

Arguments

query

either a character string including a single keyword or a named list containing a custom query (see details section below). Note that if an empty character string is passed, then all datasets available are returned.

verbose

a logical. Should extra information be reported on progress?

...

further arguments to be passed to httr::GET().

Details

Names of the list should match one of the column names within the table. For the networks table, those are:

  • id: unique identifier of the nodes;

  • original_name: taxonomic name as in the original publication;

  • node_level: either population, taxon or individual;

  • network_id: Mangal network identifier.

Note that for lists with more than one element, only the first element is used, the others are ignored. An example is provided below.

Value

An object of class mgSearchNodes, which basically is a data.frame object including taxa that are matching the query and corresponding information. All networks in which taxa are involved are also attached to the data.frame.

References

See Also

search_taxonomy()

Examples


 res_acer <- search_nodes("Acer")
 res_926 <- search_nodes(list(network_id = 926))


rmangal documentation built on March 31, 2023, 10:27 p.m.