def create_value_dict(data_agg,
                      super_star_avg_prices_2_agents,
                      super_star_avg_prices_3_agents
                      ):
    """
    A function to create a comprehensive dictionary with all
    values that we need to create the plot.

    Args:
        data_agg (DataFrame): DataFrame with experimental results
        super_star_avg_prices_2_agents (array): Average prices of super star markets upon convergence
                                                   (2 firm market).
        super_star_avg_prices_3_agents (array): Average prices of super star markets upon convergence
                                                   (3 firm market).
    Returns:
        dict: Dictionary with values for plotting
    """
    # To make the plotting easier, we write the data into a structured dict
    plotting_dict = {}

    # First the fully human markets
    plotting_dict['Humans'] = {}
    plotting_dict['Humans']['means'] = {}
    plotting_dict['Humans']['std'] = {}

    # Loop over all super games
    for sg in range(1,4):
        # Create subset of data for current sg
        current_subset_sg = data_agg.loc[data_agg['super_game'] == sg]

        # get means and std
        plotting_dict['Humans']['means'][sg] = list()
        plotting_dict['Humans']['means'][sg].extend(
            [current_subset_sg.loc[current_subset_sg['treatment'] == '2H0A']['winning_price'].mean(),
             current_subset_sg.loc[current_subset_sg['treatment'] == '3H0A']['winning_price'].mean()]
        )
        plotting_dict['Humans']['std'][sg] = list()
        plotting_dict['Humans']['std'][sg].extend(
            [current_subset_sg.loc[current_subset_sg['treatment'] == '2H0A']['winning_price'].std(),
             current_subset_sg.loc[current_subset_sg['treatment'] == '3H0A']['winning_price'].std()]
        )

    # Now the algorithm markets
    plotting_dict['Algorithm'] = {}
    plotting_dict['Algorithm']['means'] = list()
    plotting_dict['Algorithm']['means'].extend(
        [super_star_avg_prices_2_agents.mean(),
         super_star_avg_prices_3_agents.mean()]
    )
    plotting_dict['Algorithm']['std'] = list()
    plotting_dict['Algorithm']['std'].extend(
        [super_star_avg_prices_2_agents.std(),
         super_star_avg_prices_3_agents.std()]
    )

    return plotting_dict