biomartr (version 0.1.0)

organismAttributes: Retrieve Biomart Attributes for an Organism

Description

In addition to the organismBM function, this function returns all available attributes that can be accessed through different marts and datasets for a given query organism.

Usage

organismAttributes(organism, update = FALSE, topic = NULL)

Arguments

organism

a character string specifying the scientific name of a query organism.

update

a logical value specifying whether or not the local listMart.txt, listDatasets.txt, and listAttributes_organism.txt files shall be updated by remote access to BioMart.

topic

a character string specifying a topic (category) of attributes, e.g. topic = "id".

Value

a data.frame storing corresponding attribute names, description, datasets, and marts.

Details

For a given query organism, this function retrieves all available attributes that can be accessed through different marts and datasets.

Sometimes the same attribute names correspond to different datasets and marts causing problems when using getMarts. The approach introduced by this function provides (again) a organism centric way of accessing organism specific attributes.

The topic argument allows the user to search for specific attribute topics/categories for faster filtering.

References

http://biomart.org/

Mapping identifiers for the integration of genomic datasets with the R/Bioconductor package biomaRt. Steffen Durinck, Paul T. Spellman, Ewan Birney and Wolfgang Huber, Nature Protocols 4, 1184-1191 (2009).

BioMart and Bioconductor: a powerful link between biological databases and microarray data analysis. Steffen Durinck, Yves Moreau, Arek Kasprzyk, Sean Davis, Bart De Moor, Alvis Brazma and Wolfgang Huber, Bioinformatics 21, 3439-3440 (2005).

See Also

organismFilters, organismBM, biomart, listAttributes

Examples

## Not run: 
# 
# # return available attributes for "Homo sapiens"
# head(organismAttributes("Homo sapiens"), 20)
# 
# # search for attribute topic "id" 
# head(organismAttributes("Homo sapiens", topic = "id"), 20)
# 
# # search for attribute topic "homolog" 
# head(organismAttributes("Homo sapiens", topic = "homolog"), 20)
# 
# ## End(Not run)