Decomposition using a prcalc object with three-step.

Description

Decomposition using a prcalc object with three-step.

Usage

decompose3(x, ...)

## S3 method for class 'prcalc'
decompose3(x, special = NULL, alpha = 2, ...)

Arguments

x a prcalc object.
ignored
special a character. names of special district.
alpha Default is 2.

Value

a prcalc_decomposition object.

References

  • Yuta, Kamahara, Junichiro Wada, and Yuko Kasuya. 2021. "Malapportionment in space and time: Decompose it!" Electoral Studies. 71: 102301.

See Also

decompose, decompose2

decompose

Examples

library(PRcalc)

data(nz_district)

nz_1949 <- nz_district |>
  subset(year == 1949) |>
  as_prcalc(l1   = "region",
            l2   = "district",
            p    = "electorates",
            q    = "magnitude",
            type = "nested")

decompose3(nz_1949, special = "Maori")
alpha = 2 
alpha-divergence          Special  Reapportionment    Redistricting 
    6.037171e-02     6.536250e-03     3.606409e-06     5.383185e-02 

Note: "alha-divergence" is sum of "Special", "Reapportionment" and "Redisticting" terms.