# pertRates: Calculates perturbation rates of overall data set and... In SynthTools: Tools and Tests for Experiments with Partially Synthetic Data Sets

## Description

This function will calculate the overall perturbation rate of an imputed data set and for specific variables requested.

## Usage

 `1` ```pertRates(obs_data, new_data, imp_vars, desc = FALSE, sig = 4) ```

## Arguments

 `obs_data` The original dataset to which the next will be compared, of the type "data.frame". `new_data` The fully or partially synthetic data set to be compared to the observed data, of the type "data.frame". `imp_vars` The variable or a vector of variables which were imputed and are to be used in the overall perturbation rate calculation. `desc` Whether or not the variable perturbation rates should be output in descending rate order. Defaults to FALSE. `sig` The number of significant digits desired for the overall perturbation rate. Defaults to 4.

## Details

A record in a data set is considered "perturbed" when at least one value in the record is different from the observed data. The overall perturbation rate is therefore the number of records that are found to be perturbed over the number of records in a data set.

The variable perturbation rate is simply the rate at which the values for a given variable are different from those in the observed data set.

This function was developed with the intention of making the job of researching synthetic data utility a bit easier by quickly calculating perturbation rates.

## Value

Returns the overall perturbation rate of the synthetic data set and the specific variable perturbation rates in percentages, rounded to 0.1. The function will also output in list format with the following components:

 `overall` The overall perturbation rate. `variable` A vector of variable perturbation rates.

## Examples

 ```1 2 3 4``` ```#PPA is observed data set, PPAps2 is a partially synthetic data set derived from the observed data. #age17plus, marriage, and vet are three categorical variables within these data sets. pertRates(PPA, PPAps2, c("age17plus", "marriage", "vet")) ```

SynthTools documentation built on March 13, 2020, 1:33 a.m.