resampling

resample_df(
  df,
  key_cols,
  strat_cols = NULL,
  n = NULL,
  key_col_name = "KEY",
  replace = TRUE
)

Arguments

df

data frame

key_cols

key columns to resample on

strat_cols

columns to maintain proportion for stratification

n

number of unique sampled keys, defaults to match dataset

key_col_name

name of outputted key column. Default to "KEY"

replace

whether to stratify with replacement

Details

This function is valuable when generating a large simulated population where you goal is to create resampled sub-populations in addition to being able to maintain certain stratifications of factors like covariate distributions

A new keyed column will be created (defaults to name 'KEY') that contains the uniquely created new samples. This allows one to easily compare against the key'd columns. Eg, if you would like to see how many times a particular individual was resampled you can check the original ID column against the number of key's associated with that ID number.

Examples

library(PKPDmisc) library(dplyr, quiet = TRUE) # simple example resampling by ID maintaining Gender distribution, with 10 individuals resample_df(sd_oral_richpk, key_cols = "ID", strat_cols = "Gender", n = 10)
#> # A tibble: 120 x 10 #> KEY ID Time Amt Conc Age Weight Gender Race Dose #> <int> <int> <dbl> <int> <dbl> <dbl> <dbl> <fct> <fct> <int> #> 1 1 39 0 5000 0 49.8 64.8 Female Asian 5000 #> 2 1 39 0.25 0 6.91 49.8 64.8 Female Asian 5000 #> 3 1 39 0.5 0 14.3 49.8 64.8 Female Asian 5000 #> 4 1 39 1 0 28.3 49.8 64.8 Female Asian 5000 #> 5 1 39 2 0 48.5 49.8 64.8 Female Asian 5000 #> 6 1 39 3 0 47.1 49.8 64.8 Female Asian 5000 #> 7 1 39 4 0 46.4 49.8 64.8 Female Asian 5000 #> 8 1 39 6 0 41.0 49.8 64.8 Female Asian 5000 #> 9 1 39 8 0 37.2 49.8 64.8 Female Asian 5000 #> 10 1 39 12 0 28.6 49.8 64.8 Female Asian 5000 #> # … with 110 more rows
# for a more complex example lets resample "simulated" data with multiple replicates subset_data <- sd_oral_richpk %>% filter(ID < 20) # make 'simulated' data with 5 replicates and combine to single dataframe rep_dat <- lapply(1:5, function(x) { subset_data %>% mutate(REP = x) }) %>% bind_rows() # now when we resample we also want to maintain the ID+REP relationship as resampling # just the ID would give all rows associated for an ID with all reps, rather than # a single "unit" of ID/REP resample_df(rep_dat, key_cols = c("ID", "REP"))
#> # A tibble: 1,140 x 11 #> KEY ID Time Amt Conc Age Weight Gender Race Dose REP #> <int> <int> <dbl> <int> <dbl> <dbl> <dbl> <fct> <fct> <int> <int> #> 1 1 1 0 5000 0 56.1 94.2 Male Hispanic 5000 5 #> 2 1 1 0.25 0 8.61 56.1 94.2 Male Hispanic 5000 5 #> 3 1 1 0.5 0 19.4 56.1 94.2 Male Hispanic 5000 5 #> 4 1 1 1 0 34.0 56.1 94.2 Male Hispanic 5000 5 #> 5 1 1 2 0 30.2 56.1 94.2 Male Hispanic 5000 5 #> 6 1 1 3 0 31.3 56.1 94.2 Male Hispanic 5000 5 #> 7 1 1 4 0 25.0 56.1 94.2 Male Hispanic 5000 5 #> 8 1 1 6 0 23.4 56.1 94.2 Male Hispanic 5000 5 #> 9 1 1 8 0 23.5 56.1 94.2 Male Hispanic 5000 5 #> 10 1 1 12 0 14.7 56.1 94.2 Male Hispanic 5000 5 #> # … with 1,130 more rows
# check to see that stratification is maintained rep_dat %>% group_by(Gender) %>% tally
#> # A tibble: 2 x 2 #> Gender n #> <fct> <int> #> 1 Female 300 #> 2 Male 840
resample_df(rep_dat, key_cols=c("ID", "REP"), strat_cols="Gender") %>% group_by(Gender) %>% tally
#> # A tibble: 2 x 2 #> Gender n #> <fct> <int> #> 1 Female 300 #> 2 Male 840
rep_dat %>% group_by(Gender, Race) %>% tally
#> # A tibble: 8 x 3 #> # Groups: Gender [2] #> Gender Race n #> <fct> <fct> <int> #> 1 Female Caucasian 180 #> 2 Female Hispanic 60 #> 3 Female Other 60 #> 4 Male Asian 120 #> 5 Male Black 180 #> 6 Male Caucasian 60 #> 7 Male Hispanic 180 #> 8 Male Other 300
resample_df(rep_dat, key_cols=c("ID", "REP"), strat_cols=c("Gender", "Race")) %>% group_by(Gender, Race) %>% tally
#> # A tibble: 8 x 3 #> # Groups: Gender [2] #> Gender Race n #> <fct> <fct> <int> #> 1 Female Caucasian 180 #> 2 Female Hispanic 60 #> 3 Female Other 60 #> 4 Male Asian 120 #> 5 Male Black 180 #> 6 Male Caucasian 60 #> 7 Male Hispanic 180 #> 8 Male Other 300