Create an ENA network out of one or more parsed sources

parsed_sources_to_ena_network(
  x,
  unitCols,
  conversationCols = "originalSource",
  codes = x$convenience$codingLeaves,
  metadata = x$convenience$metadataVars
)

Arguments

x

The parsed source(s) as provided by rock::parse_source or rock::parse_sources.

unitCols

The columns that together define units (e.g. utterances in each source that belong together, for example because they're about the same topic).

conversationCols

The columns that together define conversations (e.g. separate sources, but can be something else, as well).

codes

The codes to include; by default, takes all codes.

metadata

The columns in the merged source dataframe that contain the metadata. By default, takes all read metadata.

Value

The result of a call to rENA::ena.plot.network().

Examples

### Get path to example source examplePath <- system.file("extdata", package="rock"); ### Parse all example sources in that directory parsedExamples <- rock::parse_sources(examplePath); ### Add something to indicate which units belong together; normally, ### these would probably be indicated using one of the identifier, ### for example the stanza identifiers, the sid's nChunks <- nrow(parsedExamples$mergedSourceDf) %/% 10; parsedExamples$mergedSourceDf$units <- c(rep(1:nChunks, each=10), rep(max(nChunks), nrow(parsedExamples$mergedSourceDf) - (10*nChunks))); ### Generate ENA plot enaPlot <- rock::parsed_sources_to_ena_network(parsedExamples, unitCols='units');
#> Error: To create ENA networks, the "rENA" package is required. Please install it using `install.packages('rENA');`.
### Show the resulting plot print(enaPlot);
#> Error in print(enaPlot): object 'enaPlot' not found