Evaluate Donors
Run donor evaluation on pre-treatment data after applying substantive eligibility exclusions.
The evaluator aligns each treatment-donor pair by time, then calculates Pearson correlation and its p-value, root mean squared error (RMSE), percentage RMSE, mean absolute percentage error (MAPE), and normalised dynamic time-warping (DTW) distance. It normalises metrics within each treated geography, combines them using adaptive weights, and ranks complete rows.
Review:
overlap_count,treatment_coverage, anddonor_coveragebefore scores;metrics_completeandmetric_failure_reasons;correlation,rmse,mape, anddtw, not onlycomposite_score;warning_flags, quality bands, concentration, and effective donor count;- maps only as a geographic diagnostic, not as proof of comparability.
selected_weight is normalised from positive composite scores among the
recommended donors. Its role is design_stage_recommendation_weight; it is not
a fitted SparseSC counterfactual weight.
The evaluator’s output is a screening artefact. If it changes the donor pool, filter the canonical panel and rerun power and inference. To render maps, see Use Shapemaps.
DTW standardises each pair’s finite, timestamp-aligned overlap using its own mean and population standard deviation. FastDTW uses scalar absolute local cost, a fixed approximation search radius of one, and divides the resulting distance by the overlap count. Constant series become zero vectors. The radius controls the approximation neighbourhood around a recursively estimated path; it does not bound the displacement between aligned dates.
Version 0.4.0 replaces the history-dependent approximation radius. This can
change DTW, composite rankings, recommendation weights and seasonality_score
(which aliases normalised DTW). Regenerate recommendations and inspect the
underlying metrics. Backend and radius are recorded in quality JSON; rankings
are screening outputs and have no calibrated acceptance guarantee.