Generate Random PI Names or Tokens — generate_pi

Generates random synthetic principal investigator (PI) names, full names, or cryptographic pseudonym tokens (`PI_...`).

Usage

generate_pi_names(
  n = 1,
  format = c("synthetic", "token", "full_name"),
  prefix = "PI_",
  n_chars = 16,
  rename_fn = NULL,
  seed = NULL,
  exclude = character(),
  allow_collisions = FALSE
)

Arguments

n: Integer, number of names to generate (default 1).
format: Character, either `"synthetic"` (realistic surnames), `"full_name"` (synthetic first and last name), or `"token"` (cryptographic hash tokens). Aliases `"surname"` and `"full"` are also accepted.
prefix: Character, prefix when format is `"token"` (default `"PI_"`).
n_chars: Integer, number of hex characters from the hash digest when `format = "token"` (default 16).
rename_fn: Optional function to rename or format generated tokens/names.
seed: Optional integer, random seed for reproducibility.
exclude: Character vector of surnames or names (case-insensitive) to omit.
allow_collisions: Logical, default FALSE. If TRUE, allows short tokens with n_chars < 6.

Value

A character vector of length `n` (or a single character string if `n = 1`).

Examples

generate_pi_names(1)
#> [1] "Reyes"
generate_pi_names(3, format = "full_name")
#> [1] "Gregory Russell" "Joyce Herrera"   "Brooklyn Powell"
generate_pi_names(3, format = "token")
#> [1] "PI_29f2fb4df7e23e1e" "PI_c5c4d47fe820e373" "PI_139e048acd58cf7c"
generate_pi_names(3, format = "token", n_chars = 8)
#> [1] "PI_b1e9bae1" "PI_dc70539c" "PI_f6070fbb"