setConstraints: setConstraints function is used to create a new or modify an...

Description Usage Arguments Details Value Author(s) See Also Examples

View source: R/setConstraints.R

Description

setConstraints function is used to create or modify a list containing the constraints for an InterMine query. These constraints can be later passed on to a query formed by setQuery function.

Usage

1
2
3
4
5
6
7
setConstraints(
  paths,
  operators,
  values,
  modifyQueryConstraints,
  m.index
)

Arguments

paths

a character vector defining in which bioterm type the value(s) of each constraint belong. One assigned to each constraint.

operators

a character vector describing the operators for each constraint.

values

a list containing the values assigned to each constraints. The path of each argument defines the type of value by which the results of the query will be filtered.

modifyQueryConstraints

an existing list query (e.g. template query) whose constraints will be modified.

m.index

a vector of integer values indicating which constraints of the list assigned to modifyQueryConstraints will be modified.

Details

It is important to note that:

1. setConstraints assigns each argument to a constraint based on the order in which they are assigned and one at a time. This means that paths, operators and values arguments must be of the same length and carefully assigned.

2. setConstraints can create a list of new constraints or modify an existing one with the arguments modifyQueryConstraints and m.index

3. only one of the constraints can be assigned with multiple values, aiming to retrieve results for multiple bioterms (genes, etc.)

4. to assign multiple bioterms in a constraint, values argument is assigned with a vector at the appropriate order: e.g.

to assign c("a", "b") to the second constraint one must use either:

values = list(first_element, c("a", "b"), ...)

or when modifying an existing list of constraints:

values = list(c("a", "b"))

m.index = 2

Value

a list containing the constraints for an InterMineR query. It can be passed to setQuery function.

Author(s)

InterMine Team

See Also

setQuery, runQuery, InterMineR-class

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
# get mine instance
im.fly = initInterMine(listMines()["FlyMine"])

# get GO_Gene template query
qGO_Gene = getTemplateQuery(im.fly, "GO_Gene")

# constraint with GO value
qGO_Gene$where[[3]]

# modify GO_Gene template query to have more than one GO values
go.constraints = setConstraints(
  values = list(c("DNA repair", "cellular response to DNA damage stimulus")),
  modifyQueryConstraints = qGO_Gene,
  m.index = 3
)

go.constraints[[3]]

# 2. Create similar query manually for Homo sapiens, using HumanMine

# get HumanMine instance
im.human = initInterMine(listMines()["HumanMine"])

# create constraints using GO terms and organism as values
hsa.go.constraints = setConstraints(
  paths = c("Gene.goAnnotation.ontologyTerm.parents.name",
            "Gene.organism.name"),
  operators = rep("=", 2),
  values = list(c("DNA repair", "cellular response to DNA damage stimulus"),
                  "Homo sapiens")
)

hsa.go.constraints

intermine/intermineR documentation built on Jan. 10, 2022, 4:24 p.m.