removeElements: Check the effect of removing indicators or aggregates

Description Usage Arguments Details Value See Also Examples

View source: R/coin_audit_tools.R

Description

This is an analysis function for seeing what happens when elements of the composite indicator are removed. This can help with "what if" experiments and acts as different measure of the influence of each indicator or aggregate.

Usage

1
removeElements(COIN, aglev, isel, quietly = FALSE)

Arguments

COIN

The COIN, which must be constructed up to and including the aggregation step.

aglev

The level at which to remove elements. For example, aglev = 1 would check the effect of removing each indicator, one at a time. aglev = 2 would check the effect of removing each of the aggregation groups above the indicator level, one at a time.

isel

A character string indicating the indicator or aggregate code to extract from each iteration. I.e. normally this would be set to the index code to compare the ranks of the index upon removing each indicator or aggregate. But it can be any code that is present in .$Data$Aggregated.

quietly

Logical: if FALSE (default) will output to the console an indication of progress. Might be useful when iterating over many indicators. Otherwise set to TRUE to shut this up.

Details

One way of looking at indicator "importance" in a composite indicator is via correlations. A different way is to see what happens if we remove the indicator completely from the framework. If removing an indicator or a whole aggregation of indicators results in very little rank change, it is one indication that perhaps it is not necessary to include it. Emphasis on one: there may be many other things to take into account.

This function works by successively setting the weight of each indicator or aggregate to zero. If the analysis is performed at the indicator level, it creates a copy of the COIN, sets the weight of the first indicator to zero, regenerates the results, and compares to the nominal results (results when no weights are set to zero). It repeats this for each indicator in turn, such that each time one indicator is set to zero weights, and the others retain their original weights. The output is a series of tables comparing scores and ranks (see Value).

Note that "removing the indicator" here means more precisely "setting its weight to zero". In most cases the first implies the second, but check that the aggregation method that you are using satisfies this relationship. For example, if the aggregation method does not use any weights, then setting the weight to zero will have no effect.

Value

A list with elements as follows:

See Also

Examples

1
2
3
4
5
6
7
8
# check the effect of removing ASEM sub-pillars, one at a time
# First build ASEM index
ASEM <- build_ASEM()
# now run check at sub-index level (level 3), on index scores/ranks
CheckPillars <- removeElements(ASEM, 3, "Index")
# summary by pillar
CheckPillars$MeanAbsDiff
# have a look at the rest of the output list to see more details.

COINr documentation built on Nov. 30, 2021, 9:06 a.m.