optpolicy_main.OptimalPolicy.solvefair

OptimalPolicy.solvefair(data_df, data_title: str = '')

Solve for optimal allocation rule with fairness adjustments.

Follows the suggestions of Bearth, Lechner, Muny, Mareckova (2025, arXiV). It has the same syntax and is used in the same way as the solve method.

Parameters

• data_df (DataFrame) – Input data to train particular allocation algorithm.

• data_title (String, optional) – This string is used as title in outputs. The default is ‘’.

Returns

results_all_dict – Contains the results. This dictionary has the following structure: ‘allocation_df’ : DataFrame

data_df with optimal allocation appended.

’result_dic’Dictionary

Contains additional information about trained allocation rule. Only complete when keyword _int_with_output is True.

’outpath’Path

Location of directory in which output is saved.

Return type

Dictionary.