In ropensci/charlatan: Make Fake Data

charlatan

knitr::opts_chunk$set(
  comment = "#>",
  collapse = TRUE,
  warning = FALSE,
  message = FALSE
)

charlatan makes fake data, inspired from and borrowing some code from Python's faker

Make fake data for:

• person names
• jobs
• phone numbers
• colors: names, hex, rgb
• credit cards
• DOIs
• numbers in range and from distributions
• gene sequences
• geographic coordinates
• emails
• URIs, URLs, and their parts
• IP addresses
• more coming ...

Possible use cases for charlatan:

• Students in a classroom setting learning any task that needs a dataset.
• People doing simulations/modeling that need some fake data
• Generate fake dataset of users for a database before actual users exist
• Complete missing spots in a dataset
• Generate fake data to replace sensitive real data with before public release
• Create a random set of colors for visualization
• Generate random coordinates for a map
• Get a set of randomly generated DOIs (Digital Object Identifiers) to assign to fake scholarly artifacts
• Generate fake taxonomic names for a biological dataset
• Get a set of fake sequences to use to test code/software that uses sequence data

Reasons to use charlatan:

• Lite weight, few dependencies
• Relatively comprehensive types of data, and more being added
• Comprehensive set of languages supported, more being added
• Useful R features such as creating entire fake data.frame's

Installation

cran version

install.packages("charlatan")

dev version

devtools::install_github("ropensci/charlatan")

library("charlatan")

high level function

... for all fake data operations

x <- fraudster()
x$job()
x$name()
x$color_name()

locale support

Adding more locales through time, e.g.,

Locale support for job data

ch_job(locale = "en_US", n = 3)
ch_job(locale = "fr_FR", n = 3)
ch_job(locale = "hr_HR", n = 3)
ch_job(locale = "uk_UA", n = 3)
ch_job(locale = "zh_TW", n = 3)

For colors:

ch_color_name(locale = "en_US", n = 3)
ch_color_name(locale = "uk_UA", n = 3)

More coming soon ...

generate a dataset

ch_generate()

ch_generate('job', 'phone_number', n = 30)

person name

ch_name()

ch_name(10)

phone number

ch_phone_number()

ch_phone_number(10)

job

ch_job()

ch_job(10)

credit cards

ch_credit_card_provider()
ch_credit_card_provider(n = 4)

ch_credit_card_number()
ch_credit_card_number(n = 10)

ch_credit_card_security_code()
ch_credit_card_security_code(10)

Usage in the wild

• eacton/R-Utility-Belt-ggplot2

Contributors

• Scott Chamberlain
• Kyle Voytovich
• Martin Pedersen

similar art

• wakefield
• ids
• rcorpora
• synthpop

Meta

• Please report any issues or bugs.
• License: MIT
• Get citation information for charlatan in R doing citation(package = 'charlatan')
• Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

ropensci/charlatan documentation built on Jan. 28, 2020, 12:13 a.m.