benford.analysis (version 0.1.3)

benford: Benford Analysis of a dataset

Description

This function validates a dataset using Benford's Law. Its main purposes are to find out where the dataset deviates from Benford's Law and to identify suspicious data that need further verification.

For a more complete example, see the package help at benford.analysis.

Usage

benford(data, number.of.digits = 2, sign = "positive", discrete=TRUE, round=3)

Arguments

data

a numeric vector.

number.of.digits

how many first digits to analyse .

sign

The default value for sign is "positive" and it analyzes only data greater than zero. There are also the options "negative" and "both" that will analyze only negative values or both positive and negative values of the data, respectively. For large datase

discrete

most real data - like population numbers or accounting data - are discrete, so the default is TRUE. This paramater sets rounding to the differences of the ordered data to avoid floating point number errors in the second order distribution, that usually o

round

it defines the number of digits that the rounding will use if discrete = TRUE.

Value

• An object of class Benford containing the results of the analysis. It is a list of eight objects, namely:
• info
  general information, including

  • data.name: the name of the data used.
  • n: the number of observations used.
  • n.second.order: the number of observations used for second order analysis.
  • number.of.digits: the number of first digits analysed.
• data
  a data frame with:

  • lines.used: the original lines of the dataset.
  • data.used: the data used.
  • data.mantissa: the log data's mantissa.
  • data.digits: the first digits of the data.
• s.o.data
  a data frame with:

  • data.second.order: the differences of the ordered data.
  • data.second.order.digits: the first digits of the second order analysis.
• bfd
  a data frame with:

  • digits: the groups of digits analysed.
  • data.dist: the distribution of the first digits of the data.
  • data.second.order.dist: the distribution of the first digits of the second order analysis.
  • benford.dist: the theoretical benford distribution.
  • data.second.order.dist.freq: the frequency distribution of the first digits of the second order analysis.
  • data.dist.freq: the frequency distribution of the first digits of the data.
  • benford.dist.freq: the theoretical benford frequency distribution.
  • benford.so.dist.freq: the theoretical benford frequency distribution of the second order analysis.
  • data.summation: the summation of the data values grouped by first digits.
  • abs.excess.summation: the absolute excess summation of the data values grouped by first digits.
  • difference: the difference between the data and benford frequencies.
  • squared.diff: the chi-squared difference between data and benford frequencies.
  • absolute.diff: the absolute difference between data and benford frequencies.
• mantissa
  a data frame with:

  • mean.mantissa: the mean of the mantissa.
  • var.mantissa: the variance of the mantissa.
  • ek.mantissa: the excess kurtosis of the mantissa.
  • sk.mantissa: the skewness of the mantissa.
• MAD
  the mean absolute deviation.
• distortion.factor
  the distortion factor
• stats
  list of "htest" class statistics:

  • chisq: Pearson's Chi-squared test.
  • mantissa.arc.test: Mantissa Arc Test.

Examples

data(corporate.payment) #loads data
bfd.cp <- benford(corporate.payment$Amount) #generates benford object
bfd.cp #prints
plot(bfd.cp) #plots