```
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "README-"
)
```

This package has been designed to provide functions which enable the construction of adjacency matrices, from a specified string of characters. It contains functions to generate an empty adjacency matrix (with each unique substring as a row name or column name) from a given list of strings. This is useful when performing social network anaylsis. In this current release, the strings are bidirectional, meaning it doesnâ€™t matter where two unique substrings occur in the string.

The output matrices can be used directly with packages such as `igraph()`

Generating large matrices is computationally intensive and may take a while.

`string_in = c('apples, pears, bananas', 'apples, bananas', 'apples, pears')`

`blank_matrix = generate_adj_matrix(string_in)`

`string_2_matrix(blank_matrix, string_in)`

`install.packages('String2AdjMatrix')`

`devtools::install_github('tomdrake\String2AdjMatrix')`

Requires `stringr`

This package comprises three functions; `generate_adj_matrix`

, `string_2_matrix`

and `string_2_matrix_x`

.

`generate_adj_matrix()`

Generates an adjacency matrix from a given string. Detects unique values and generates a blank matrix with colnames and rownames of each unique value in supplied string.

The `string_data`

argument is the string from which the unique values and matrix will be generated.

`string_2_matrix()`

Iteratively applies `string_2_matrix_x()`

to each column of a matrix. Use to generate an entire adjacency matrix.

The `new_matrix`

element of the function should be either the matrix generated by `generate_adj_matrix()`

or an empty data matrix of equal number of rows and columns. These should have unique values specified as the row names and column names.

The `supplied_string`

element refers to the string in which the search is to be performed. i.e `list = c('apples, pears, bananas', 'apples, bananas', 'apples, pears')`

Generating large matrices is computationally intensive and may take a while.

`string_2_matrix_x()`

This function takes a specified column in a matrix and identifies how many times that substring appears with each row name for a given set of strings. Use to generate one column of adjacency data. Also used iteratively as part of `string_2_matrix()`

The `new_matrix`

element of the function should be either the matrix generated by `generate_adj_matrix()`

or an empty data matrix of equal number of rows and columns. These should have unique values specified as the row names and column names.

The `supplied_string`

element refers to the string in which the search is to be performed. i.e `list = c('apples, pears, bananas', 'apples, bananas', 'apples, pears')`

The `coord_x`

argument specifies the number column for which to convert. i.e. `coord_x = 1`

is the first column of a data matrix, `coord_x = 12`

is the twelfth column of a data matrix.