query: Query the AnnotationHub metadata

Description

Queries the AnnotationHub metadata with one or more name-value pairs.

Usage

query(..., cols = c("Title", "Species", "TaxonomyId", "Genome", "SourceUrl", "Description", "Tags", "RDataClass", "Notes"), returntype = "json")

Arguments

...

One or more fields to query, with values. Field names should come from getAllKeytypes. Must include BiocVersion and RDataDateAdded. See examples.

cols

Which columns to return. "all" will return all columns (many are only useful to AnnotationHub for housekeeping purposes).

returntype

How to return the result. See Value section.

Value

If returntype is "json", a WebResult containing a JSON object representing the matching metadata records is returned. If returntype is data, an R list is returned.

Endpoint

/ah///query/Genome/hg19/TaxonomyId/9606

To specify an argument (such as cold) multiple times, use one of the following forms:

/ah///query/Genome/hg19/cols/Title/cols/Description

/ah///query/Genome/hg19/cols/Title,Description

Example: http://annotationhub.bioconductor.org/ah/2.13/2013-06-26/query/Genome/hg19/TaxonomyId/9606

Examples

Run this code

query(BiocVersion="2.13", RDataDateAdded="2013-06-26",
    Genome="hg19", TaxonomyId="9606")
query(BiocVersion="2.13", RDataDateAdded="2013-06-26",
    Genome="hg19", TaxonomyId="9606", cols=c("Title", "Description"))