Skip to contents

Prepare GO databases

Source: R/PrepareDBAnnotation.R
PrepareGO.Rd

Prepare Gene Ontology annotations and semantic-similarity data, reusing the common cache and species/identifier conversion pipeline.

Usage

PrepareGO(
  species = c("Homo_sapiens", "Mus_musculus"),
  db = c("GO", "GO_BP", "GO_CC", "GO_MF"),
  db_IDtypes = c("symbol", "entrez_id", "ensembl_id"),
  db_version = "latest",
  db_update = FALSE,
  data_dir = NULL,
  convert_species = TRUE,
  Ensembl_version = NULL,
  mirror = NULL,
  biomart = NULL,
  max_tries = 5,
  verbose = TRUE,
  ...
)

Arguments

species

"Homo_sapiens" or "Mus_musculus".

db

Character vector selecting "GO", "GO_BP", "GO_CC" or "GO_MF".

db_IDtypes

Gene ID types to include.

db_version

Database version to retrieve.

db_update

Force a refresh. FALSE loads the cache when available.

data_dir

Directory or named list of local source files. Searches data_dir/<db>/ then data_dir. Named lists override a path, e.g. list(MSigDB = "~/db/msigdb").

convert_species

Use a species-converted database when the annotation is missing for species.

Ensembl_version

Ensembl version. NULL uses the latest.

mirror

Specify an Ensembl mirror to connect to. The valid options here are "www", "uswest", "useast", "asia".

biomart

BioMart database that you want to connect to. Possible options include "ensembl", "protists_mart", "fungi_mart", and "plants_mart".

max_tries

The maximum number of attempts to connect with the BioMart service.

verbose

Whether to print the message. Default is TRUE.

...

Passed to helper functions.

Value

A named species list containing the selected databases. Annotation entries contain TERM2GENE, TERM2NAME and version; GO entries may include semData.

See also

PrepareDB, ListDB

Examples

if (FALSE) { # \dontrun{
databases <- PrepareGO(species = "Homo_sapiens", db = "GO_BP")
names(databases[["Homo_sapiens"]])
} # }