simplifyResult {InterMineR}R Documentation

Convert multiple values of a column into Comma-separated character strings

Description

This function converts the values of a column variable within a dataset into comma-separated, character strings. The process is achieved by using another column of the same dataset as index.

Usage

simplifyResult(
  dataset,
  index_column,
  values_column,
  returnInDataframe = FALSE
)

Arguments

dataset

a data.frame containing the data

index_column

a character string or a numeric/integer value indicating the column which will be used as index.

values_column

a character string or a numeric/integer value indicating the column whose values will be converted into comma-separated, character strings.

returnInDataframe

a logical value indicating whether to return only the converted columns or to append the character strings to the dataset.

Value

If returnInDataframe argument is set to FALSE then a data.frame is returned with the unique values of the index column and the character strings of the values_column that correspond to each.

If returnInDataframe argument is set to TRUE then the original dataset is returned containing an extra column in which the character strings of the values_column have been appended.

Author(s)

InterMine Team

Examples

# get HumanMine
im.human = initInterMine(listMines()["HumanMine"])
  
# get template query for retrieving GOTerms for specific genes
qGene_GO = getTemplateQuery(im.human, "Gene_GO")

# retrieve GOTerms for four different genes
rGene_GO = list(NULL)
for(i in seq(length(c("PPARG", "RPL5", "RPL11", "TP53")))){
  
  g = c("PPARG", "RPL5", "RPL11", "TP53")[i]
  qGene_GO$where[[1]]$value = g
  rGene_GO[[i]] = runQuery(im.human, qGene_GO)
  
}

# rbind results to data.frame
rGene_GO = do.call(rbind, rGene_GO)

# return simplified GOTerms results for each Gene
simplify_GOTerms = simplifyResult(
  dataset = rGene_GO,
  index_column = "Gene.symbol",
  values_column = "Gene.goAnnotation.ontologyTerm.identifier",
  returnInDataframe = FALSE
)

# return simplified GOTerms results for each Gene, within the original data.frame
simplify_GOTerms.2 = simplifyResult(
  dataset = rGene_GO,
  index_column = "Gene.symbol",
  values_column = "Gene.goAnnotation.ontologyTerm.identifier",
  returnInDataframe = TRUE
)
[Package InterMineR version 1.10.0 Index]