netfacs_extract {NetFACS}

Extract results from a netfacs object

Description

Extract results from a netfacs object.

Usage

netfacs_extract(
  netfacs.data,
  combination.size = NULL,
  significance = 1,
  min.count = 0,
  min.prob = 0
)

netfacs.extract(
  netfacs.data,
  combination.size = NULL,
  significance = 1,
  min.count = 0,
  min.prob = 0
)

Arguments

netfacs.data

An object of class netfacs.

combination.size

Numeric, denoting the combination size(s) that should be extracted. If NULL (default), all combination sizes are returned.

significance

Numeric value between 0 and 1, determining the p-value below which combinations are considered to be dissimilar enough from the null distribution.

min.count

Numeric, denoting the minimum number of times an element combination occurred.

min.prob

Numeric value between 0 and 1, denoting the minimum probability an element combination occurred to be displayed.

Value

Function returns a tibble data.frame that contains the results of the netfacs object. By default, returns all results for all observed combinations, but can optionally pre-filter results.

Examples

### how do angry facial expressions differ from non-angry ones?
data(emotions_set)
angry.face <- netfacs(
  data = emotions_set[[1]],
  condition = emotions_set[[2]]$emotion,
  test.condition = "anger",
  ran.trials = 10,
  combination.size = 2
)

netfacs_extract(angry.face)