concordance: Qualitative examination of evidence
In idiolect: Forensic Authorship Analysis

concordance

R Documentation

Qualitative examination of evidence

Description

This function uses quanteda::kwic() to return a concordance for a search pattern. The function takes as input three datasets and a pattern and returns a data frame with the hits labelled for authorship.

Usage

concordance(
  q.data,
  k.data,
  reference.data,
  search,
  token.type = "word",
  window = 5,
  case_insensitive = TRUE
)

Arguments

`q.data`	A `quanteda` corpus object, such as the output of `create_corpus()`.
`k.data`	A `quanteda` corpus object, such as the output of `create_corpus()`.
`reference.data`	A `quanteda` corpus object, such as the output of `create_corpus()`. This is optional.
`search`	A string. It can be any sequence of characters and it also accepts the use of * as a wildcard.
`token.type`	Choice between "word" (default), which searches for word or punctuation mark tokens, or "character", which instead uses a single character search.
`window`	The number of context items to be displayed around the keyword (a `quanteda::kwic()` parameter).
`case_insensitive`	Logical; if TRUE, ignore case (a `quanteda::kwic()` parameter).

Value

The function returns a data frame containing the concordances for the search pattern.

Examples

concordance(enron.sample[1], enron.sample[2], enron.sample[3:49], "wants to", token.type = "word")

#using wildcards
concordance(enron.sample[1], enron.sample[2], enron.sample[3:49], "want * to", token.type = "word")

#searching character sequences with wildcards
concordance(enron.sample[1], enron.sample[2], enron.sample[3:49], "help*", token.type = "character")

idiolect documentation built on Sept. 11, 2024, 5:34 p.m.