Skip to content

Generate individual vectors of the types supported by vroom

Usage

gen_character(n, min = 5, max = 25, values = c(letters, LETTERS, 0:9), ...)

gen_double(n, f = stats::rnorm, ...)

gen_number(n, f = stats::rnorm, ...)

gen_integer(n, min = 1L, max = .Machine$integer.max, prob = NULL, ...)

gen_factor(
  n,
  levels = NULL,
  ordered = FALSE,
  num_levels = gen_integer(1L, 1L, 25L),
  ...
)

gen_time(n, min = 0, max = hms::hms(days = 1), fractional = FALSE, ...)

gen_date(n, min = as.Date("2001-01-01"), max = as.Date("2021-01-01"), ...)

gen_datetime(
  n,
  min = as.POSIXct("2001-01-01"),
  max = as.POSIXct("2021-01-01"),
  tz = "UTC",
  ...
)

gen_logical(n, ...)

gen_name(n)

Arguments

n

The size of the vector to generate

min

The minimum range for the vector

max

The maximum range for the vector

values

The explicit values to use.

...

Additional arguments passed to internal generation functions

f

The random function to use.

prob

a vector of probability weights for obtaining the elements of the vector being sampled.

levels

The explicit levels to use, if NULL random levels are generated using gen_name().

ordered

Should the factors be ordered factors?

num_levels

The number of factor levels to generate

fractional

Whether to generate times with fractional seconds

tz

The timezone to use for dates

Examples

# characters
gen_character(4)
#> [1] "JVP97TXeQ2ejYK1HtZCW5" "vHyeVU4FwpT5z29vdWwpQ"
#> [3] "UAU6qPnZ"              "01bEHCVgBXU"          

# factors
gen_factor(4)
#> [1] uptight_yak          broad_capybara       right_hyena         
#> [4] miniature_hartebeest
#> 17 Levels: broad_capybara agreeable_mink petite_deer ... empty_starfish

# logical
gen_logical(4)
#> [1] FALSE FALSE  TRUE FALSE

# numbers
gen_double(4)
#> [1] -2.1559919  1.2189333  0.3008837  1.2101631
gen_integer(4)
#> [1] 1812413698  215080157  446571473  211506290

# temporal data
gen_time(4)
#> 04:16:02
#> 15:04:33
#> 15:49:14
#> 01:58:49
gen_date(4)
#> [1] "2002-08-16" "2006-08-16" "2013-12-10" "2020-01-09"
gen_datetime(4)
#> [1] "2008-07-03 03:11:32 UTC" "2014-03-16 04:30:15 UTC"
#> [3] "2008-07-19 17:56:12 UTC" "2006-06-11 10:43:18 UTC"