cellink.tl.external.compute_escore

cellink.tl.external.compute_escore(results_df, control_program='AllCoding', *, control_strategy=None, enrichment_col='Enrichment', se_col='Enrichment_std_error')

Compute the E-score: enrichment of a program minus the all-coding control.

E-score(program, trait) = Enrichment(program) - Enrichment(AllCoding_control) SE_E = sqrt(SE_program² + SE_control²) z_E = E-score / SE_E

Parameters:

• results_df (DataFrame) – Output of load_sclinker_heritability_results.

• control_program (str (default: 'AllCoding')) – Name of the all-coding control program.

• control_strategy (str | None (default: None)) – Strategy to use for the control (if None, matches current strategy).

• enrichment_col (str (default: 'Enrichment')) – Column names for enrichment and its standard error.

• se_col (str (default: 'Enrichment_std_error')) – Column names for enrichment and its standard error.

Return type:

DataFrame

Returns:

DataFrame with added columns E_score, E_score_se, E_score_z.