Optimal ALlocation Queues for Discrete Problems, allocation Amount, Value. This version of the function is adpated specially for Nygaard, Sorensen, and Wang (2021) for the optimal allocation of stimulus checks, and is based on ffp_opt_anlyz_rhgin_dis().

ffp_nsw_opt_anlyz_rhgin_dis(
  ar_rho,
  fl_teacher_increase_number,
  df_input_il,
  bl_df_alloc_il = FALSE,
  bl_return_V = TRUE,
  bl_return_allQ_V = FALSE,
  bl_return_inner_V = FALSE,
  svr_rho = "rho",
  svr_rho_val = "rho_val",
  svr_id_i = "id_i",
  svr_id_il = "id_il",
  svr_D_max_i = "D_max_i",
  svr_D_il = "D_il",
  svr_D_star_i = "D_star_i",
  svr_F_star_i = "F_star_i",
  svr_EH_star_i = "EH_star_i",
  svr_inpalc = "Q_il",
  svr_D_Wbin_il = "D_Wbin_il",
  svr_A_il = "A_il",
  svr_alpha_il = "alpha_il",
  svr_beta_i = "beta_i",
  svr_betameasure_i = "vmassbeta_i",
  svr_measure_i = "mass_i",
  svr_mass_cumu_il = "mass_cumu_il",
  svr_expout = "opti_exp_outcome",
  svr_V_star_Q_il = "V_star_Q_il",
  st_idcol_prefix = "sid_"
)

Arguments

fl_teacher_increase_number

is the amount of resources (in measure if svr_measure_i is not NA) available for allocation.

bl_df_alloc_il

boolean if true this will output a matrix where each column is a different i individual and each row is a position along the queue, and each cell is the level of allocation for individual i when the overall allocation queue is up to the current queue position.

svr_beta_i

string variable name for planner bias, used for allocation problem, generating the queue.

svr_betameasure_i

string variable name for the weight considerating both mass and beta jointly, can not simply multiply beta and measure together. Suppose two people, beta is 0.5 for each person. And then we have 0.5 mass for each person, simply multiplying the two together genreates 0.5x0.5 vs 0.5x0.5, don't sum up to the existing total mass even. This is used for welfare function

svr_measure_i

string variable name for mass for this type of recipient, default NA mass of recipient is the measure of recipient of this type in the population. This measure does not impact relative ranking optimal allocation across types, but determines how much to push individual types further along the allocation queue back. used for mass at each queue point

Author

Fan Wang, http://fanwangecon.github.io