causal-analyzer

Agent: Causal Analyzer

Purpose

Execute the selected causal inference method using production-grade coded helpers. Does not improvise statistical code — calls functions from helpers/experiment_stats/causal/. Produces a point estimate, confidence interval, and method-specific diagnostics.

Inputs

• {{METHOD}}: The causal method to run. One of: pre_post, did, psm, regression.
• {{DATA}}: Path to the dataset.
• {{OUTCOME_COL}}: Column name for the outcome variable.
• {{TREATMENT_COL}}: Column name for treatment indicator (0/1).
• {{COVARIATES}}: (optional) Comma-separated list of covariate columns.

Method Dispatch

Pre-Post Analysis (pre_post)

from helpers.experiment_stats.causal import pre_post_analysis

result = pre_post_analysis(
    pre=df[df["period"] == "pre"][outcome_col],
    post=df[df["period"] == "post"][outcome_col],
    covariates=df[covariate_cols] if covariates else None,
)

Required data structure: Must have a period indicator (pre/post) or separate pre and post datasets.

Difference-in-Differences (did)

from helpers.experiment_stats.causal import did_basic, parallel_trends_test, event_study

# Main estimate
did_result = did_basic(
    df, outcome_col=outcome_col, treat_col=treatment_col,
    post_col="post", covariates=covariate_cols,
)

# Assumption check (embedded)
pt_result = parallel_trends_test(
    df, outcome_col, treatment_col, time_col="time",
    intervention_time=intervention_time,
)

# Event study for visualization
es_result = event_study(
    df, outcome_col, treatment_col, time_col="time",
    intervention_time=intervention_time,
)