testGL: Test for Lorenz and Generalized Lorenz dominance

Description Usage Arguments Details Value Author(s) References See Also Examples

View source: R/testGL.R

Description

Statistical test procedure given by Xu (1997) to study Generalized Lorenz dominance from sample Generalized Lorenz curve estimates. Lorenz dominance from sample Lorenz curve estimates can also be studied (Beach and Davidson, 1983).

Usage

1
testGL(dataset1, dataset2, generalized = FALSE, samplesize = 10)

Arguments

dataset1

a data.frame containing variables obtained by the using setupDataset function.

dataset2

a data.frame containing variables obtained by the using setupDataset function.

generalized

logical; if TRUE the test will be applied to compare two Generalized Lorenz curves. In another case Lorenz curves will be compared.

samplesize

an integer which represents the number of Lorenz (Generalized Lorenz) curve ordinates to be estimated for comparison. The default is 10.

Details

The null hypotesis to be tested is if the Lorenz (Generalized Lorenz) curve calculated from dataset1 dominates the one calculated from dataset2.

Value

A list with the following components:

Tvalue the value of the test-statistic

p.value simulated p-value of the test-statistic Tvalue (Wolak, 1989). It is calculated only when the Tvalue falls into an inconclusive region.

decision if the Tvalue is less than the lower-bound of the critical value at the 5 percent significance level the decision is "Do not reject null hypothesis". If the Tvalue is greater than the upper-bound of the critical value at the 5 percent significance level the decision is "Reject null hypothesis". Lower and upper-bounds critical values are obtained from Kodde and Palm (1986). If Tvalue falls into an inconclusive region (between the lower- and upper-bounds) the p-value will be estimated following Wolak (1989).

Author(s)

A. Berihuete, C.D. Ramos and M.A. Sordo

References

C. M. Beach and R. Davidson (1983) Distribution-free statistical inference with Lorenz curves

D.A. Kodde and F.C. Palm (1986) Wald criteria for jointly testing equality and inequality restrictions, Econometrica, 50, 1243–1248.

F.A. Wolak (1989), Testing inequality constrains in linear econometric models, Journal of Econometrics, 41, 205–235.

K. Xu (1997) Asymptotically distribution-free statistical test for generalized Lorenz curves: An alternative approach, Journal of Income Distribution, 7(1), 45–62.

See Also

OmegaGL, setupDataset

Examples

1
2
3
4
data(eusilc2)
ATdataset1 <- setupDataset(eusilc2, country = "AT", region = "Burgenland")
ATdataset2 <- setupDataset(eusilc2, country = "AT", region = "Carinthia")
testGL(ATdataset1, ATdataset2, generalized = TRUE, samplesize = 10)

AngelBerihuete/laeken2 documentation built on May 5, 2019, 6:02 a.m.