Compute Contract economic deviation across the crisis indicator

The indicator reveals whether there has been an increase in the deviation of the contract actual execution economic value from its initial awarded value, with reference to contracts belonging to relevant economic market.

Motivation

The red flag considers at risk companies/contracting authorities whose contracts undergo a significant increase of their economic deviation ratio - i.e., ratio between actual amount paid and awarded economic value - across the crisis.

Scoring rule

The computation procedure returns 1 - p-value of the involved test (so that high values of the indicator correspond to high levels of corruption risk). When computing the composite, it will be dichotomised to 1 if statistical test is significant, and 0 otherwise (see normalise()).

Main target unit

This indicator targets companies and contracting authorities.

Usage

ind_3(
  data,
  award_value,
  sums_paid,
  stat_unit,
  emergency_name,
  publication_date,
  test_type,
  cpvs,
  ...
)

Arguments

data: a dataframe containing the data to use for computing the indicator.
award_value: name of the variable in data containing the award value of each contract.
sums_paid: name of the variable in data containing the contract actual execution economic value (i.e., amount paid by the contracting authority).
stat_unit: name of the variable in data containing the target unit ID (in this case, company or contracting authority).
emergency_name: string specifying the name of the emergency to consider. Examples could include "Coronavirus" or "Terremoto Centro Italia 2016-2017".
publication_date: name of the variable in data containing the publication date of each contract.
test_type: string specifying the statistical test to use for computing the indicator. Available options are "wilcoxon" and "ks" (Kolmogorov-Smirnov test).
cpvs: character vector of CPV divisions (first two digits of CPV code) on which data are filtered out. Note: a panel of experts have already chosen which CPV divisions are most affected by which emergency.
...: other parameters to pass to generate_indicator_schema(), such as country_name (default: Italy).

Value

indicator schema as from generate_indicator_schema().

Examples

if (FALSE) {
if (interactive()) {
  ind_3(
    data = mock_data_core,
    publication_date = data_pubblicazione,
    award_value = importo_lotto,
    sums_paid = importo_finale,
    stat_unit = cf_amministrazione_appaltante,
    emergency_name = "coronavirus",
    test_type = "wilcoxon"
  )
}
}