Output Schemas — GeoSC Documentation

Donor Artefact Schemas

Mon, 01 Jan 0001 00:00:00 +0000

donor_eval_results.csv Each row is a treated-candidate donor pair. Maintained columns include treatment and donor IDs; composite, fit, correlation, and seasonality scores; design-stage recommendation weight and role; rank; quality labels; warnings; metric failure reasons; correlation and its p-value; RMSE, percentage RMSE, MAPE, DTW; and metrics_complete. Score normalisation and ranking occur within each treated geography. Cross- treatment score values are therefore not a common absolute scale.

Inference Result Schemas

Mon, 01 Jan 0001 00:00:00 +0000

geolift_results.json Schema 1.0 contains the primary unscaled result: Field Contract status ok, partial, or failed. estimand att_unscaled. att Average post-period treated-minus-counterfactual effect in outcome units. p_value Two-sided in-space placebo p-value for the average effect. p_value_method in_space_placebo. n_placebos, max_n_placebos, possible_placebos, p_value_placebo_mode, placebo_seed, p_value_granularity Finite reference-set metadata. ci_lower, ci_upper, ci, ci_source Unscaled SparseSC placebo interval or explicit unavailability. se / se_available No estimator-provided standard error is claimed. se_approx_from_ci Optional normal approximation from interval width; not a sampling SE. significance_available, significant Detection availability and p_value < alpha flag. analysis_window Launch, cooldown, and measurement metadata. assumption_status, assumption_required, assumption_checks_completed Gate summary. warnings, errors, caveats Interpretation controls. geolift_diagnostics.json Contains pre-period RMS effect and p-value, scaled post-effect diagnostics, period effects, fitted donor-weight summaries, synthetic-control availability, assumption state, analysis window, and warnings/errors. Scaled effects are not interchangeable with the unscaled top-level ATT and interval.

Pipeline Report Schema

Mon, 01 Jan 0001 00:00:00 +0000

The pipeline writes geolift_pipeline_report.md and geolift_pipeline_report.html. Each identifies the three config paths and summarises available stage artefacts. The power section reports grid-based MDE by duration at configured target_power and excludes rows where valid is false. The donor section lists the five highest composite-score rows per treatment from the CSV. The inference section reports available ATT, p-value, interval, and assumption status. These reports are convenience summaries. They do not contain the full data validation, power failure diagnostics, donor pool quality JSON, assumption checks, or sensitivity evidence. Audit and interpret the source artefacts.

Power Analysis Results Schema

Mon, 01 Jan 0001 00:00:00 +0000

power_analysis_results.csv has one row per effect-size and duration pair. Field Meaning schema_version Row contract version (1.0). target_power CLI planning threshold copied from YAML. effect_size, duration, alpha Simulated grid and detection threshold. power n_significant / n_successful. power_ci_lower, power_ci_upper Wilson interval using alpha as the interval tail setting. n_simulations, n_successful, n_significant, n_failed Monte Carlo counts. failure_rate, failure_rate_threshold, valid Failure diagnostics. valid does not validate DGP plausibility. random_seed, simulation_seed, placebo_seed_root, placebo_seed_strategy Reproducibility metadata. dgp_rank, dgp_explained_var, dgp_factor_dynamics Fitted DGP metadata. requested_max_n_pl, possible_placebos, effective_max_n_pl, p_value_placebo_mode Placebo support. dgp_backend, generation_backend, seeded_reproducibility_mode Execution metadata. effect_pattern, effect_baseline, effect_full_absolute, effect_baseline_definition Injection contract. detection_rule, power_denominator Explicit detection and denominator labels. warnings Semicolon-delimited row warnings. Direct calls to SparseSCPowerCalculator.calculate_power() do not add the CLI’s target_power column; target power affects MDE selection, not simulation.