EdgSocCMap {cogmapr}

Aggregation of the relationships identified in a serie of Individual Cognitive Maps

Description

This function will produce a data frame that contains all relationships of a serie of Individual Cognitive Maps. The weights of these relationships are calculated.

Usage

EdgSocCMap(
  project,
  min.weight = 1,
  filters = NULL,
  units = "all",
  weighted.icm = FALSE
)

Arguments

project

A QDA project, a list as generated by the ProjectCMap function.

min.weight

A integer that will determine the minimum (>=) weight of relationships that will be taken into account. Relationships with a lower weight (<) will not be shown. Default is set to 1 (i.e. all relationships are shown).

filters

A list of named strings that will filter the relationships showed in the SCM. e.g. =list(coding_class = "A_coding_class", document_part = "A_document_part")=. To date, these filters are linked to the nature of relationships.

units

A string vector giving the names of the units (i.e. classes linked to documents) that will be include in the SCM. It is a second type of filter.

weighted.icm

A boolean. If FALSE, the weight of the relationships in the ICM will be fixed to 1.

Details

The function can be used to produce a data frame that contains only the relation with a minimum weight or that concerns only a type of agents.

Value

A data frame with four or five variables : ##'

$edge

The name of the relationship, of the generic form x~y

$FACTOR

If used, the factor the parameter variable]. This variable contains then the levels of the factor defined in the parameter group used as subset criteria

$weight

The weight of each relationship

$from

The number of the vertex at the origin of the relationship

$to

The number of the vertex at the end of the relationship

Examples

project_name <- "a_new_project"
main_path <- paste0(system.file("testdata", package = "cogmapr"), '/')
my.project <- ProjectCMap(main_path, project_name)

EdgSocCMap(my.project)
EdgSocCMap(my.project)
EdgSocCMap(my.project, min.weight=3)
EdgSocCMap(my.project, min.weight=6, weighted.icm=TRUE)