refAuthors: Get Author Names
In LimaRAF/TreeCo: An R Package to Manage TreeCo Database

refAuthors

R Documentation

Get Author Names

Description

Function to extract and tabulate the names of authors based on a list of reference IDs and the TreeCo standard reference table

Usage

refAuthors(
  ref.ids = NULL,
  ref.data = NULL,
  ids.coluna = "refID",
  auth.coluna = "author",
  adv.coluna = "advisor",
  fuzzy = FALSE,
  max.dist = 0.025
)

Arguments

`ref.ids`	a vector with the list of TreeCo refIDs
`ref.data`	the data frame with TreeCo reference database
`ids.coluna`	the name of the column in 'ref.data' containing the TreeCo refIDs. Defaults to 'refID'.
`auth.coluna`	the name of the column in 'ref.data' containing the author names. Defaults to 'author'.
`adv.coluna`	the name of the column in 'ref.data' containing the advisor name in the case of thesis and dissertations. Defaults to 'advisor'.
`fuzzy`	logical. Should authors with different but close spelling be put together (may take time for large lists of authors). Defaults to FALSE.
`max.dist`	numerical. The maximum distance between strings to put authors names together.

Details

If the argument 'ref.IDs' is empty, all references in 'ref.data' will be used to get the count of author names

Distances between authors names are performed using the 'stringdistmatrix()' function from package stringdist and using the method 'jw' (i.e. Jaro-Winkler) for for distance calculation. For large selections of references, this may take a while.