Donor Configuration
| Key | Type/default | Contract |
|---|---|---|
schema_version |
string, 1.0 |
Config version. |
data_path |
string | Long CSV containing date, location, and Y or metric. |
date_format |
string or omitted | Explicit source date format. |
treatment_locations |
list | Treated identifiers, compared after string conversion. |
treatment_date |
string | Pre/post split; only pre-period rows are scored. |
max_donors |
integer, 10 |
Maximum complete recommendations per treated unit. |
min_correlation_threshold |
float, 0.7 |
Adds low-correlation warnings. |
max_rmse_threshold |
float or null | Adds high-RMSE warnings. |
donor_dominance_threshold |
float, 0.5 |
Adds dominance warnings for recommendation weights. |
min_excellent_donors |
integer, 3 |
Pool-summary threshold. |
min_good_donors |
integer, 5 |
Pool-summary threshold. |
mape_thresholds |
mapping | acceptable (default 30) controls high-MAPE warnings; other labels are retained compatibility settings. |
shapemap_file |
string or null | GeoPandas-readable vector file. |
shapemap_id_column |
string | Geography key in the vector file. |
output_dir |
string | Artefact directory. |
parallel |
boolean | Parallel pair scoring. |
n_jobs |
integer | Worker count; -1 uses all cores. |
The current donor stage always computes correlation, RMSE, MAPE, and DTW.
There are no active evaluation_metrics, pre_treatment_periods, min_donors,
limit_donor_pool, top_correlated_donors, acceptable_mape, or
correlation_thresholds keys.