plot.fect: Plot Method for 'fect' Objects

In fect: Fixed Effects Counterfactual Estimators

Plot Method for 'fect' Objects

Description

Visualizes results from a fect estimation.

Usage

## S3 method for class 'fect'
plot(
    x,
    type = NULL,
    restrict = "rm",
    loo = FALSE,
    highlight = NULL,
    highlight.fill = FALSE,
    plot.ci = NULL,
    show.points = TRUE,
    loess.fit = TRUE,
    show.group = NULL,
    bound = NULL,
    show.count = TRUE,
    proportion = 0.3,
    pre.periods = NULL,
    f.threshold = NULL,
    tost.threshold = NULL,
    effect.bound.ratio = FALSE,
    stats = NULL,
    stats.labs = NULL,
    raw = "none",
    vis = NULL,
    main = NULL,
    xlim = NULL,
    ylim = NULL,
    xlab = NULL,
    ylab = NULL,
    xangle = NULL,
    yangle = NULL,
    xbreaks = NULL,
    ybreaks = NULL,
    xticklabels = NULL,
    yticklabels = NULL,
    gridOff = NULL,
    legendOff = FALSE,
    legend.pos = NULL,
    legend.nrow = NULL,
    legend.labs = NULL,
    stats.pos = NULL,
    show.stats = TRUE,
    theme.bw = TRUE,
    nfactors = NULL,
    include.FE = TRUE,
    id = NULL,
    cex.main = NULL,
    cex.main.sub = NULL,
    cex.axis = NULL,
    cex.lab = NULL,
    cex.legend = NULL,
    cex.text = NULL,
    axis.adjust = FALSE,
    axis.lab = "both",
    axis.lab.gap = c(0, 0),
    shade.post = FALSE,
    start0 = FALSE,
    return.test = FALSE,
    return.data = FALSE,
    balance = NULL,
    weight = NULL,
    lcolor = NULL,
    lwidth = NULL,
    ltype = NULL,
    line.color = NULL,
    line.width = NULL,
    count = NULL,
    preset = NULL,
    connected = NULL,
    ci.outline = FALSE,
    color =  NULL,
    pre.color = NULL,
    post.color = NULL,
    est.lwidth = NULL,
    est.pointsize = NULL,
    count.color =  NULL,
    count.alpha = NULL,
    count.outline.color = NULL,
    placebo.color =  NULL,
    carryover.color =  NULL,
    carryover.rm.color = NULL,
    sens.original.color = NULL,
    sens.colors =  NULL,
    counterfactual.color =  NULL,
    counterfactual.raw.controls.color =  NULL,
    counterfactual.raw.treated.color =  NULL,
    counterfactual.linetype =  NULL,
    box.control =  NULL,
    box.treat =  NULL,
    calendar.color = NULL,
    calendar.lcolor = NULL,
    calendar.cicolor = NULL,
    heterogeneous.color = NULL,
    heterogeneous.lcolor = NULL,
    heterogeneous.cicolor = NULL,
    equiv.color =  NULL,
    status.treat.color =  NULL,
    status.control.color = NULL,
    status.missing.color =  NULL,
    status.removed.color =  NULL,
    status.placebo.color = NULL,
    status.carryover.color =  NULL,
    status.carryover.rm.color =  NULL,
    status.balanced.post.color = NULL,
    status.balanced.pre.color = NULL,
    status.background.color = NULL,
    covariate = NULL,
    covariate.labels = NULL,
    covariate.value = NULL,
    covariate.value.range = FALSE,
    relative.time = FALSE,
    pretreatment = FALSE,
    num.pretreatment = 3,
    cm = FALSE,
    legacy.style = FALSE,
    ...
)

Arguments

x	A fitted fect object.
type	Plot type. Options include: "gap", "equiv" (equivalence test), "status" (treatment status), "exit" (exiting treatment effects), "factors", "loadings", "calendar" (ATT by calendar time), "box" (individual effects distribution), "counterfactual", "sens" (sensitivity analysis plot, e.g., for Rambachan & Roth bounds), "sens_es" (event-study style sensitivity plot), or "cumul" (cumulative effect plot). Default is context-dependent (e.g., "gap", or "equiv" if loo=TRUE).
restrict	For sensitivity plots (type = "sens" or type = "sens_es"). Specifies the type of restriction: "rm" (restriction on M, for relative magnitude bounds) or "sm" (smoothness restriction, for bounds based on second differences). Default is "rm".
loo	Logical; if TRUE (default is FALSE), use leave-one-out estimates for pre-treatment periods in equivalence tests or gap plots.
highlight	Controls which test-period types receive the colored-glyph treatment in placebo / carryover plots. Accepts: NULL (default): auto — highlight every test type that ran at fit time (placebo, carryover, carryover.rm). TRUE: same as NULL but explicit. FALSE: no highlighting; all periods render as plain pre/post circles. A character subset of c("placebo", "carryover", "carryover.rm"): highlight only the named test types; other test periods render as plain circles. For example, highlight = "placebo" on a fit with both placeboTest = TRUE and carryoverTest = TRUE draws orange triangles at placebo periods but renders carryover periods as ordinary post-treatment circles.
highlight.fill	Logical. If TRUE, draws a lightened-tone background rectangle behind each highlighted period (in the same hue as the period's accent glyph). If FALSE (the default), only the colored glyph is drawn. The glyph alone is usually sufficient signal that a period belongs to a test window, and the glyph-only look survives grayscale printing without surprise. Set TRUE for slide / talk figures where the rectangle helps locate the window for a remote audience.
plot.ci	Specifies the confidence interval to be plotted. Options include: "0.9", "0.95", or "none". Default is NULL, which is context-dependent (e.g., "0.95" for gap plots, "0.9" for equivalence plots, "none" if no CIs are available in the fect object).
show.points	Logical; if TRUE (default), shows point estimates on event study style plots (e.g., gap, equiv, exit plots).
show.group	Optional character string or NULL (default); if specified, plots results for a particular subgroup defined in the fect call.
bound	Which bounds to display in bounding/equivalence tests: "none" (default for most plots), "min" (minimal effect bound), "equiv" (equivalence range), or "both" (default for type="equiv").
show.count	Logical; if TRUE (default), shows a histogram of observation counts (number of treated units) in relevant plots like gap, calendar, or box plots.
proportion	Numeric (0 to 1); for event study plots, restricts plotted time points to those where the number of treated units is at least this fraction of the maximum number of treated units observed across all periods. Default is 0.3.
pre.periods	Optional numeric vector; specifies pre-treatment periods to be used for bounding and equivalence tests. Default is NULL, which uses the pre-treatment periods defined in the fect object.
f.threshold	Numeric or NULL (default); F-test threshold for equivalence checks. If NULL, uses the value from the fect object.
tost.threshold	Numeric or NULL (default); threshold for TOST-based equivalence checks (e.g., for pre-trend, placebo, or carryover tests). If NULL, uses the value from the fect object.
effect.bound.ratio	Logical; if TRUE (default is FALSE), shows the ratio of ATT to the minimal bound in equivalence plots.
stats	Character vector or NULL (default); specifies which test statistics to display on the plot (e.g., "F.p", "equiv.p", "placebo.p"). Default is context-dependent based on plot type and tests performed.
stats.labs	Character vector or NULL (default); custom labels for the displayed statistics. Must match the length of stats.
raw	For type = "counterfactual" plot: "none" (default; shows average treated and counterfactual lines), "band" (shows 5-95% quantile band for raw control/treated data), or "all" (shows all raw control/treated unit trajectories).
vis	(Deprecated) Formerly controlled line display for placebo/carryover tests. This is now handled by highlight and internal logic.
main	Character string or NULL (default); main plot title. If NULL, a default title is used based on the plot type.
xlim	Numeric vector of length 2 or NULL (default); specifies x-axis limits.
ylim	Numeric vector of length 2 or NULL (default); specifies y-axis limits.
xlab	Character string or NULL (default); x-axis label. If NULL, a default label is used based on the plot type.
ylab	Character string or NULL (default); y-axis label. If NULL, a default label is used based on the plot type.
xangle	Numeric or NULL (default); angle (in degrees) for x-axis tick labels.
yangle	Numeric or NULL (default); angle (in degrees) for y-axis tick labels.
xbreaks	Numeric vector or NULL (default); positions of major ticks on the x-axis.
ybreaks	Numeric vector or NULL (default); positions of major ticks on the y-axis.
xticklabels	Character vector or NULL (default); custom labels for the x-axis ticks. Primarily used in status plots.
yticklabels	Character vector or NULL (default); custom labels for the y-axis ticks. Primarily used in status plots.
gridOff	Logical or NULL (default). If TRUE, removes major and minor grid lines. If NULL (which defaults to FALSE internally for this argument), the grid is off for most plots but on for type = "status" (where it forms tile outlines).
legendOff	Logical; if TRUE (default is FALSE), hides the legend.
legend.pos	Character string or NULL (default); position of the legend (e.g., "bottom", "top", "right", "left", "none", or c(x,y) coordinates). Default is typically "bottom".
legend.nrow	Integer or NULL (default); number of rows in the legend.
legend.labs	Character vector or NULL (default); custom legend labels.
stats.pos	Numeric vector of length 2 or NULL (default); (x,y) coordinates for displaying the text of test statistics on the plot.
show.stats	Logical; if TRUE (default), displays test statistics on the plot if stats is not "none".
theme.bw	Logical; if TRUE (default), uses a black-and-white ggplot2 theme (theme_bw()). If FALSE and no preset is specified, uses theme_grey().
nfactors	Integer or NULL (default); number of factors to plot when type is "factors" or "loadings". Defaults to min(r.cv, 4), where r.cv is the number of estimated factors.
include.FE	Logical; if TRUE (default), includes fixed effects as additional "factors" in factor/loading plots if applicable (i.e., if unit or time fixed effects were estimated as part of the factor model).
id	Character vector or NULL (default); when specified, plots only the chosen unit(s). For counterfactual plots (type="counterfactual"), only one ID is typically supported for individual unit display; otherwise, averages are shown.
cex.main	Numeric or NULL (default); font size multiplier for the main plot title. Base size is 16pt.
cex.main.sub	Numeric or NULL (default); font size multiplier for a possible subtitle. Base size is 16pt.
cex.axis	Numeric or NULL (default); font size multiplier for axis tick labels. Base size is 15pt.
cex.lab	Numeric or NULL (default); font size multiplier for axis labels. Base size is 15pt.
cex.legend	Numeric or NULL (default); font size multiplier for legend text. Base size is 15pt.
cex.text	Numeric or NULL (default); font size multiplier for text annotations on the plot (e.g., statistics values). Base size is 5pt.
axis.adjust	Logical; if TRUE (default is FALSE), attempts to adjust axis labels for plots with many time points (e.g., by rotating x-axis labels).
axis.lab	Controls axis labeling in type="status" plots. Options: "both" (default), "time", "unit", or "off".
axis.lab.gap	Numeric vector of length 1 or 2; gap spacing for axis labels in type="status" plots (sets frequency of labels). Default is c(0, 0) (label every tick).
shade.post	Logical; if FALSE (default). If TRUE, shades post-treatment periods in certain plots. For counterfactual plots, if NULL (the default for the argument is FALSE), it effectively becomes TRUE internally unless explicitly set to FALSE.
start0	Logical; if TRUE (default is FALSE), re-indexes the first post-treatment period as 0 in event-time plots (gap, equiv, exit). The period before treatment becomes -1.
return.test	Logical; if TRUE (default is FALSE), returns a list containing the plot object and relevant test statistics instead of just the plot.
return.data	Logical; if TRUE (default is FALSE), returns a data frame with the data used to construct the plot instead of returning a plot object. If return.test=TRUE as well, returns a list with data and test.out.
balance	Logical or NULL (default); if TRUE, uses a "balance sample" (if available from the fect object, e.g., from setting balanced.sample = TRUE in fect) for plotting.
weight	Logical or NULL (default); if TRUE, applies weighting (if available from the fect object, e.g., from providing weights in fect) to the estimates being plotted.
lcolor	Character vector of length 1 or 2, or NULL (default). If NULL, uses a default color (e.g., "#AAAAAA70" if theme.bw=TRUE, else "white" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
lwidth	Numeric vector of length 1 or 2, or NULL (default). If NULL, uses a default width (e.g., 1.5 if theme.bw=TRUE, else 2 for the base style). The preset argument may define a different width. Specifying this argument directly overrides any preset or base style setting.
ltype	Character vector of length 1 or 2, or NULL (default). If NULL, uses a default linetype (e.g., c("solid", "solid") for the base style). The preset argument may define a different linetype (e.g., preset="vibrant" uses c("solid", "dashed")). Specifying this argument directly overrides any preset or base style setting.
line.color	(Deprecated) Use color for main estimate lines or lcolor for reference lines instead.
line.width	(Deprecated) Use est.lwidth for main estimate lines or lwidth for reference lines instead.
count	(Deprecated) Use show.count to control visibility and count.color, count.alpha, count.outline.color for appearance.
preset	A character string specifying a color and style preset: NULL (default, uses a base style, often with theme_bw if theme.bw=TRUE), "vibrant", or "grayscale". This sets a group of defaults for many plot elements. Individual appearance arguments (like color, lcolor, etc.) can override settings from a preset or the base style.
connected	Logical or NULL (default). For event study type plots (e.g., type="gap"), if TRUE, connects points with lines; if FALSE, shows point-ranges. If NULL, defaults to FALSE for the base style, and TRUE if preset = "vibrant".
ci.outline	Logical; if FALSE (default). For event study plots where CIs are shown as ribbons, if TRUE, adds an outline to the CI ribbon.
color	Character string or NULL (default). If NULL, uses a default color for main plot lines/points (e.g., "black" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
pre.color	Character string or NULL (default). Color for pre-treatment period estimates. If NULL, uses the value of color.
post.color	Character string or NULL (default). Color for post-treatment period estimates. If NULL, uses the value of color.
est.lwidth	Numeric or NULL; line width for the main estimate line in event study plots. If NULL (default), the width is determined based on connected and show.points (e.g., '0.6' for point-ranges with the base style, '0.7' for connected points with markers with the base style). The preset argument may influence this default. Specifying a numeric value directly overrides any other setting.
est.pointsize	Numeric or NULL; size of points for the main estimate in event study plots. If NULL (default), the size is determined based on connected and show.points (e.g., '2' for point-ranges with the base style, '1.2' for connected points with markers with the base style). The preset argument may influence this default. Specifying a numeric value directly overrides any other setting.
count.color	Character string or NULL (default). If NULL, uses a default color for count bars (e.g., "grey70" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
count.alpha	Numeric (0-1) or NULL (default). If NULL, uses a default alpha for count bars (e.g., 0.4 for the base style). The preset argument may define a different alpha. Specifying this argument directly overrides any preset or base style setting.
count.outline.color	Character string or NULL (default). If NULL, uses a default outline color for count bars (e.g., "grey69" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
placebo.color	Character string or NULL (default). If NULL, uses a default color for placebo elements (e.g., "blue" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
carryover.color	Character string or NULL (default). If NULL, uses a default color for carryover elements (e.g., "red" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
carryover.rm.color	Character string or NULL (default). If NULL, uses a default color for removed carryover elements (e.g., "blue" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
sens.original.color	Character string or NULL (default). If NULL, uses a default color for original estimates in sensitivity plots (e.g., "darkblue" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
sens.colors	Vector of colors or NULL (default). If NULL, uses a default palette for sensitivity bounds (e.g., c("#218C23","#FF34B4","#FF521B","#2B59C3") for the base style). The preset argument may define a different palette. Specifying this argument directly overrides any preset or base style setting.
counterfactual.color	Character string or NULL (default). If NULL, uses a default color for counterfactual lines (e.g., "steelblue" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
counterfactual.raw.controls.color	Character string or NULL (default). If NULL, uses a default color for raw control lines (e.g., "#4682B420" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
counterfactual.raw.treated.color	Character string or NULL (default). If NULL, uses a default color for raw treated lines (e.g., "#77777750" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
counterfactual.linetype	Character string or NULL (default). If NULL, uses a default linetype for counterfactual lines (e.g., "longdash" for the base style). The preset argument may define a different linetype. Specifying this argument directly overrides any preset or base style setting.
box.control	Character string or NULL (default). If NULL, uses a default fill color for control boxplots (e.g., "skyblue" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
box.treat	Character string or NULL (default). If NULL, uses a default fill color for treated boxplots (e.g., "pink" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
calendar.color	Character string or NULL (default). If NULL, uses a default color for fitted lines in calendar plots (e.g., "skyblue" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
calendar.lcolor	Character string or NULL (default). If NULL, uses a default color for average ATT lines in calendar plots (e.g., "red" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
calendar.cicolor	Character string or NULL (default). If NULL, uses a default color for CI in calendar plots (e.g., "red" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
heterogeneous.color	Character string or NULL (default). If NULL, uses a default color for fitted lines in heterogeneous plots (e.g., "red" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
heterogeneous.lcolor	Character string or NULL (default). If NULL, uses a default color for average ATT lines in heterogeneous plots (e.g., "red" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
heterogeneous.cicolor	Character string or NULL (default). If NULL, uses a default color for CI in heterogeneous plots (e.g., "red" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
equiv.color	Character string or NULL (default). If NULL, uses a default color for equivalence bounds (e.g., "red" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
status.treat.color	Character string or NULL (default). If NULL, uses a default color for treated status (e.g., "#06266F" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
status.control.color	Character string or NULL (default). If NULL, uses a default color for control status (e.g., "#B0C4DE" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
status.missing.color	Character string or NULL (default). If NULL, uses a default color for missing status (e.g., "#FFFFFF" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
status.removed.color	Character string or NULL (default). If NULL, uses a default color for removed status (e.g., "#A9A9A9" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
status.placebo.color	Character string or NULL (default). If NULL, uses a default color for placebo status (e.g., "#66C2A5" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
status.carryover.color	Character string or NULL (default). If NULL, uses a default color for carryover status (e.g., "#E78AC3" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
status.carryover.rm.color	Character string or NULL (default). If NULL, uses a default color for removed carryover status (e.g., "#ffc425" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
status.balanced.post.color	Character string or NULL (default). If NULL, uses a default color for balanced post-treatment status (e.g., "#00852B" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
status.balanced.pre.color	Character string or NULL (default). If NULL, uses a default color for balanced pre-treatment status (e.g., "#A5CA18" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
status.background.color	Character string or NULL (default). If NULL, uses a default background color for status plots (e.g., "gray90" for the base style). The preset argument may define a different color. Specifying this argument directly overrides any preset or base style setting.
covariate	Character string or NULL (default). If NULL, uses a default covariate for heterogeneous plots (e.g., "X" for the base style). The preset argument may define a different covariate. Specifying this argument directly overrides any preset or base style setting.
covariate.labels	Character vector or NULL (default). If NULL, uses a default covariate labels for heterogeneous plots (e.g., "X1" for the base style). The preset argument may define a different covariate labels. Specifying this argument directly overrides any preset or base style setting.
covariate.value	Numeric or NULL (default); a specific covariate value at which to evaluate the HTE plot. If NULL, the full range is used.
covariate.value.range	Logical; if TRUE, plots HTE over the range of covariate values. Default is FALSE.
relative.time	Logical; if TRUE, uses relative time (time since treatment) on the x-axis for HTE plots. Default is FALSE.
pretreatment	Logical; if TRUE, restricts HTE analysis to pre-treatment periods only. Default is FALSE.
num.pretreatment	Integer; number of pre-treatment periods to include when pretreatment = TRUE. Default is 3.
cm	Logical; if TRUE, plots causal moderation estimates instead of effect modification estimates for HTE plots. Requires the fect object to have been estimated with cm = TRUE. Default is FALSE.
legacy.style	Logical; if TRUE, reproduces the pre-2.3.1 visual defaults (bold centered title, larger axis text, solid treatment-onset line, blue placebo triangles, no peach highlight rectangle) regardless of the value of theme.bw. If FALSE (the default) and theme.bw = TRUE, the modern v2.3.1 visual recipe is used. Pass legacy.style = TRUE for byte-identical reproduction of figures rendered under earlier fect versions.
loess.fit	Logical; if TRUE (default), overlays a LOESS smoothing curve on HTE scatter plots.
...	Additional graphical parameters passed to internal plotting routines, primarily those accepted by esplot for event study style plots (gap, equiv, exit, sens_es, cumul).

Details

plot.fect generates various visualizations for objects estimated via fect. Depending on the selected type, it can show treatment-effect dynamics ("gap", "exit", "cumul"), equivalence test outcomes ("equiv"), factor/loadings for factor models ("factors", "loadings"), raw vs. counterfactual trajectories ("counterfactual"), treatment status ("status"), effects by calendar time ("calendar"), distribution of individual effects ("box"), or sensitivity analysis results ("sens", "sens_es"). The preset argument allows for quick customization of plot aesthetics using predefined color schemes. Many individual color and style parameters can be set to further customize the appearance, and these will override any settings from a preset or the base style. The function heavily relies on ggplot2 for plotting and esplot for event-study style visualizations.

Value

By default, a ggplot2 object representing the plot.

If return.data=TRUE, returns a list containing:

p	The ggplot2 object.
data	A named list of data frames containing the data used to construct each layer of the plot (no extra all-NA columns are added).

If return.test=TRUE as well, the list also contains:

test.out

A list or data frame containing relevant test statistics (such as F-tests, equivalence p-values, placebo test p-values, etc.), if applicable to the plot type and options chosen.

If return.test=TRUE and return.data=FALSE, returns a list containing p and test.out.

Author(s)

Licheng Liu, Ye Wang, Yiqing Xu, Ziyi Liu, Rivka Lipkovitz

References

Xu, Y. (2017). Generalized Synthetic Control Method: Causal Inference with Interactive Fixed Effects Models. Political Analysis, 25(1), 57–76.

Liu, L., Wang, Y., & Xu, Y. (2022). A Practical Guide to Counterfactual Estimators for Causal Inference with Time-Series Cross-Sectional Data. American Journal of Political Science, 66(1), 220-237. (Provides context for esplot which is used internally for many plot types)

Rambachan, A., & Roth, J. (2023). A More Credible Approach to Parallel Trends. Review of Economic Studies, 90(5), 2555-2591. (Provides context for sensitivity analysis plots like type="sens" and type="sens_es")

Examples

library(fect)
# For CRAN checks, use a small number of bootstraps
# In practice, use a larger number (e.g., nboots = 200 or more)
if(requireNamespace("ggplot2") && requireNamespace("ggrepel")) {
  data(simdata)
  # Estimate with fixed effects method
  out.fect <- fect(
    Y ~ D + X1 + X2,
    data = simdata,
    index = c("id","time"),
    method = "fe",
    force = "two-way",
    se = TRUE,
    parallel = FALSE,
    nboots = 5 # nboots low for example
  )

  # Default gap plot
  plot(out.fect, main = "Estimated ATT (FEct)", ylab = "Effect of D on Y")

  # Gap plot with vibrant preset and custom line color
  # plot(out.fect, preset = "vibrant", color = "darkgreen",
  #      main = "Estimated ATT (Vibrant Preset, Custom Line)")

  # Counterfactual plot for the first treated unit
  # Need to know the ID of a treated unit. Let's find one.
  treated_ids <- unique(simdata$id[simdata$D == 1])
  if (length(treated_ids) > 0) {
    plot(out.fect, type = "counterfactual", id = treated_ids[1],
         main = paste("Counterfactual for Unit", treated_ids[1]))
  }

  # Status plot
  plot(out.fect, type = "status")

  # Cumulative effect plot (if est.eff is available from fect call)
  # This example might not have it by default, but showing how to call
  # out.fect.cumul <- fect(Y ~ D, data = simdata, index = c("id","time"), method = "fe",
  #                        cumulative = TRUE, se = TRUE, parallel = FALSE, nboots = 5)
  # if (exists("out.fect.cumul")) {
  #   plot(out.fect.cumul, type = "cumul", main = "Cumulative ATT")
  # }

  # Example for sensitivity plot (requires IFE/GSYNTH method and sensitivity analysis)
  # \donttest{
  #   out.ife <- fect(Y ~ D, data = simdata, index = c("id","time"),
  #                   method = "ife", se = TRUE, r = 2,
  #                   sensitivity.analysis = TRUE, sensitivity.plot = FALSE, # run analysis
  #                   parallel = FALSE, nboots = 5) # nboots low for example
  #   if (!is.null(out.ife$sensitivity.rm)) {
  #     plot(out.ife, type = "sens", restrict = "rm",
  #          main = "Sensitivity Analysis (Relative Magnitude)")
  #     plot(out.ife, type = "sens_es", restrict = "rm",
  #          main = "Event-Study Sensitivity (Relative Magnitude)")
  #   }
  # }
}

fect documentation built on April 30, 2026, 9:06 a.m.