ml_replicate: Replicate records in a reference sample based on its fitted...
In mlfit: Iterative Proportional Fitting Algorithms for Nested Structures

Description Usage Arguments Value References Examples

View source: R/ml_replicate.R

This function replicates each entry in a reference sample based on its fitted weights. This is useful if the result of multiple replication algorithms are compared to each other, or to generate a full synthetic population based on the result of a ml_fit object. Note that, all individual and group ids of the synthetic population are not the same as those in the original reference sample, and the total number of groups replicated is always very close to or equal the sum of the fitted group weights.

ml_replicate(
  ml_fit,
  algorithm = c("pp", "trs", "round"),
  verbose = FALSE,
  .keep_original_ids = FALSE
)

`ml_fit`	A `ml_fit` object created by the `ml_fit()` family.
`algorithm`	Replication algorithm to use. "trs" is the 'Truncate, replicate, sample' integerisation algorithm proposed by Lovelace et al. (2013), "pp" is weighted sampling with replacement, and "round" is just simple rounding.
`verbose`	If `TRUE`, print diagnostic output.
`.keep_original_ids`	If `TRUE`, the original individual and group ids of the reference sample will be kept with suffix '_old'.

The function returns a replicated sample in data.frame in the format used in the reference sample of the input ml_fit object.

1
2
3

 Lovelace, R., & Ballas, D. (2013). ‘Truncate, replicate, sample’:
     A method for creating integer weights for spatial microsimulation.
     Computers, Environment and Urban Systems, 41, 1-11.

path <- toy_example("Tiny")
fit <- ml_fit(ml_problem = readRDS(path), algorithm = "entropy_o")
syn_pop <- ml_replicate(fit, algorithm = "trs")
syn_pop