makeGeneToSymbol: Make a GeneToSymbol object

makeGeneToSymbolR Documentation

Make a GeneToSymbol object

Description

Make a GeneToSymbol object

Usage

makeGeneToSymbolFromEnsembl(
  organism,
  genomeBuild = NULL,
  release = NULL,
  ignoreVersion = FALSE,
  format = c("makeUnique", "1:1", "unmodified")
)

makeGeneToSymbolFromEnsDb(
  object,
  ignoreVersion = FALSE,
  format = c("makeUnique", "1:1", "unmodified")
)

makeGeneToSymbolFromGff(
  file,
  ignoreVersion = FALSE,
  format = c("makeUnique", "1:1", "unmodified")
)

Arguments

organism

character(1). Full Latin organism name (e.g. "Homo sapiens").

genomeBuild

character(1). Ensembl genome build assembly name (e.g. "GRCh38"). If set NULL, defaults to the most recent build available. Note: don't pass in UCSC build IDs (e.g. "hg38").

release

integer(1). Ensembl release version (e.g. 100). We recommend setting this value if possible, for improved reproducibility. When left unset, the latest release available via AnnotationHub/ensembldb is used. Note that the latest version available can vary, depending on the versions of AnnotationHub and ensembldb in use.

ignoreVersion

logical(1). Ignore identifier (e.g. transcript, gene) versions. When applicable, the identifier containing version numbers will be stored in txIdVersion and geneIdVersion, and the variants without versions will be stored in txId, txIdNoVersion, geneId, and geneIdNoVersion.

format

character(1). Formatting method to apply:

  • "makeUnique": Recommended. Apply make.unique to the geneName column. Gene names are made unique, while the identifiers remain unmodified. NA gene names will be renamed to "unannotated".

  • "1:1": For gene names that map to multiple gene identifiers, select only the first annotated gene identifier. Incomplete elements with NA gene name will be removed will be removed with an internal complete.cases call.

  • "unmodified": Return geneId and geneName columns unmodified, in long format. Incomplete elements with NA gene name will be removed with an internal complete.cases call.

object

Object.

file

character(1). File path.

Value

GeneToSymbol.

Functions

  • makeGeneToSymbolFromEnsembl(): Make a GeneToSymbol object from Ensembl using an AnnotationHub lookup.

  • makeGeneToSymbolFromEnsDb(): Make a GeneToSymbol object from an EnsDb object or annotation package.

  • makeGeneToSymbolFromGff(): Make a GeneToSymbol object from a GFF file.

GFF/GTF file

Remote URLs and compressed files are supported.

Note

Updated 2021-08-03.

Examples

## makeGeneToSymbolFromEnsembl ====
x <- makeGeneToSymbolFromEnsembl(
    organism = "Homo sapiens",
    ignoreVersion = FALSE
)
print(x)

## makeGeneToSymbolFromEnsDb ====
## > if (goalie::isInstalled("EnsDb.Hsapiens.v75")) {
## >     x <- makeGeneToSymbolFromEnsDb("EnsDb.Hsapiens.v75")
## >     print(x)
## > }

## makeGeneToSymbolFromGff ====
## > file <- AcidBase::pasteUrl(
## >     "ftp.ensembl.org",
## >     "pub",
## >     "release-102",
## >     "gtf",
## >     "homo_sapiens",
## >     "Homo_sapiens.GRCh38.102.gtf.gz",
## >     protocol = "ftp"
## > )
## > x <- makeGeneToSymbolFromGff(
## >     file = file,
## >     ignoreVersion = FALSE
## > )
## > print(x)

acidgenomics/r-acidgenomes documentation built on Jan. 12, 2024, 4:06 a.m.