Package {fairlieR}

Fairlie Decomposition for Binary Outcomes

Description

Performs the Fairlie decomposition for nonlinear models (logit models). This function breaks down the difference in average outcomes between two groups into the part explained by group differences in observable characteristics and the unexplained part (Fairlie 1999 https://doi.org/10.1086/209914; Fairlie 2005 https://doi.org/10.3233/JEM-2005-0259). Supports multiple reference coefficient weighting schemes.

Usage

fairlieR(
  formula,
  data,
  group,
  base_group = 0,
  reference = 0,
  reps = 100,
  ro = FALSE,
  seed = NULL,
  plot = FALSE,
  plot_color = c("#1F77B4", "#BDC3C7"),
  plot_show_title = TRUE,
  plot_show_subtitle = TRUE,
  verbose = TRUE
)

Arguments

Value

A data frame containing the decomposition results.

Author(s)

Xinyan Bu

References

• Fairlie, Robert W. (1999). The Absence of the African-American Owned Business: An Analysis of the Dynamics of Self-Employment. Journal of Labor Economics 17(1): 80-108. DOI:10.1086/209914.

• Fairlie, Robert W. (2003). An Extension of the Blinder-Oaxaca Decomposition Technique to Logit and Probit Models. Economic Growth Center, Yale University Discussion Paper No. 873. https://ideas.repec.org/p/egc/wpaper/873.html.

• Fairlie, Robert W. (2005). An extension of the Blinder-Oaxaca decomposition technique to logit and probit models. Journal of Economic and Social Measurement 30: 305-316. DOI:10.3233/JEM-2005-0259.

• OAXACA R. Male-Female Wage Differentials in Urban Labor Markets (J/OL). International Economic Review, 1973, 14(3): 693. DOI:10.2307/2525981.

• BLINDER A S. Wage Discrimination: Reduced Form and Structural Estimates on JSTOR (EB/OL). (1973) (Accessed: 2025-11-04). https://www.jstor.org/stable/144855.

• REIMERS CW. EconPapers: Labor Market Discrimination against Hispanic and Black Men (EB/OL). (1983) (Accessed: 2025-11-05). https://econpapers.repec.org/article/tprrestat/v_3a65_3ay_3a1983_3ai_3a4_3ap_3a570-79.htm.

• COTTON J. On the Decomposition of Wage Differentials (J). The Review of Economics and Statistics, 1988, 70(2): 236-243.

• NEUMARK. EconPapers: Employers’ Discriminatory Behavior and the Estimation of Wage Discrimination (EB/OL). (1988) (Accessed: 2025-11-05). https://econpapers.repec.org/article/uwpjhriss/v_3a23_3ay_3a1988_3ai_3a3_3ap_3a279-295.htm.

• Hlavac, Marek (2022). oaxaca: Blinder-Oaxaca Decomposition in R.

• Jann, B. (2006). fairlie: Stata module to generate nonlinear decomposition of binary outcome differentials.

Examples

# Load the embedded Stata example dataset
data("homecomp")

# Filter the data exactly as in the Stata example: if white==1|black==1
df_subset <- subset(homecomp, white == 1 | black == 1)

# Align factor levels and establish baselines
df_subset$educ_factor <- as.factor(
   ifelse(df_subset$college == 1, "College",
   ifelse(df_subset$somecol == 1, "SomeCol",
   ifelse(df_subset$hsgrad == 1, "HSGrad", "DropOut")))
)
df_subset$educ_factor <- relevel(df_subset$educ_factor, ref = "DropOut")

df_subset$marstat_factor <- as.factor(
   ifelse(df_subset$married == 1, "Married",
   ifelse(df_subset$prevmar == 1, "PrevMar", "Single"))
)
df_subset$marstat_factor <- relevel(df_subset$marstat_factor, ref = "Single")

# Run the native R Fairlie decomposition with visualization enabled
result <- fairlieR(homecomp ~ female + age + educ_factor + marstat_factor,
                   data = df_subset,
                   group = "black",
                   base_group = 0,
                   reference = -2,
                   reps = 100,
                   plot = TRUE)

Home Ownership Data from Stata

Description

An example dataset from Stata's fairlie module used to demonstrate the decomposition.

Usage

homecomp

Format

A data frame containing variables for home ownership, gender, age, education, and marital status.

Source

http://fmwww.bc.edu/RePEc/bocode/h/homecomp.dta