Objects can be created and set with the setAnnotationParams
function. Object are created by calling without any arguments
setAnnotationParams(), which will open an interactive
interface. Depending on the value of "many.graphics" option, a
graphical of a text-based menu will open (the text interface can be
forced by setting the graphics argument to FALSE:
setAnnotationParams(graphics = FALSE)). The menu will allow to
select the species of interest first and the type of features (ENSEMBL
gene identifier, Entrez id, ...) second. The species that are available are those for which ENSEMBL data is
available in Biomart and have a set of attributes of interest
available. The compatible identifiers for downstream queries are then
automatically filtered and displayed for user selection.
It is also possible to pass a parameter inputs, a character
vector of length 2 containing a pattern uniquely matching the species
of interest (in position 1) and a patterns uniquely matching the
feature types (in position 2). If the matches are not unique, an error
will be thrown.
A new instance of the AnnotationParams will be created
to enable easy and automatic query of the Mart instance. The
instance is invisibly returned and stored in a global variable in the
pRoloc package's private environment for automatic retrieval. If
a variable containing an AnnotationParams instance is already
available, it can be set globally by passing it as argument to the
setAnnotationParams function. Globally set
AnnotationParams instances can be accessed with the
getAnnotationParams function.
See the pRoloc-theta vignette for details.