# common.py
from otree.api import Page, ExtraModel
from otree.api import BaseConstants
from otree.api import models, widgets
import json
import random
# %% Constants
class CommonConstants(BaseConstants):
Instructions_general_path = "_templates/global/Instructions.html"
Instructions_practice_1 = "_templates/global/Instructions_Practice_1.html"
Part_II_Instructions_template = "_templates/global/Part_II_Instructions_template.html"
Instructions_pgg = "_templates/global/Instructions_pgg.html"
Round_length = 6000 # legacy; use Economy_round_length / Practice_round_length below
Economy_round_length = 45 # seconds per quiz part in economy rounds
Practice_round_length = 90 # seconds per quiz part in practice rounds
Submit_freeze_duration = 5 # seconds page is frozen before first answer can be confirmed
Interstitial_length = 3 # seconds for interstitial auto-advance
Timer_text = "Time left to complete this part:"
Economy_num_rounds = 10
Completion_fee = 10 # TODO: adjust completion fee
Bonus_max = 20 # TODO: adjust maximum bonus
Bonus_max_practice = 1.00
Practice_ECs = 5
RavensQuiz_template_path = "_templates/global/RavensQuiz.html"
AnalogyQuiz_template_path = "_templates/global/AnalogyQuiz.html"
MathQuiz_template_path = "_templates/global/MathQuiz.html"
Interstitial_template_path = "_templates/global/Interstitial.html"
# \u2500\u2500 Economy \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
Economy_pie = 500 # fixed pie size (ECs) competed over each round
Welfare_check = 50 # flat bonus added to weighted score in Welfare State
PGG_Commons = 300 # starting tokens in the common pool each round
PGG_investible = 100 # tokens each player can invest in the common pool each round
Pgg_lower_bound = 200
Pgg_upper_bound = 400
PGG_Guess_ECs = 500
# \u2500\u2500 Multipliers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
M_high = 7 # high-performer (Excessive Meritocracy / Aristocracy)
M_medium = 5 # medium-performer (all treatments as base)
M_low = 3 # low-performer (Excessive Meritocracy / Aristocracy)
# \u2500\u2500 Treatment names \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
TREATMENTS = ['Perfect_Meritocracy', 'Excessive_Meritocracy', 'Welfare_State', 'Aristocracy']
# \u2500\u2500 Treatment explanation texts (shown on Part_II_Instructions) \u2500\u2500\u2500\u2500
Explanation_Perfect_Meritocracy = (
'You have been placed in a group with two other participants. The three of you form a Group.
'
'Each round, all three members compete over a pot of 500 ECs. '
'Your share of the pot depends on how well you perform relative to the others in your group.
'
'All three members of your Group are treated identically — '
'your share is determined purely by how many questions you answer correctly compared to the other two members.
'
)
Explanation_Excessive_Meritocracy = (
'You have been placed in a group with two other participants. The three of you form a Group.
'
'Each round, all three members compete over a pot of 500 ECs. '
'Your share depends on your score and your multiplier.
'
'Multipliers were assigned based on relative performance in the practice rounds: '
'the top performer received ×7, '
'the middle performer ×5, '
'and the bottom performer ×3.
'
'Your personal multiplier is shown below.
'
)
Explanation_Welfare_State = (
'You have been placed in a group with two other participants. The three of you form a Group.
'
'Each round, all three members compete over a pot of 500 ECs. '
'Your share depends on your score.
'
'The score is calculated as performance in the round plus the average performance of the three players.'
)
Explanation_Aristocracy = (
'You have been placed in a group with two other participants. The three of you form a Group.
'
'Each round, all three members compete over a pot of 500 ECs. '
'Your share depends on your score and your multiplier.
'
'Multipliers were assigned randomly among the three members of your Group: '
'one member received ×7, one ×5, and one ×3.
'
'Your personal multiplier is shown below.
'
)
Welfare_check_text = '
+ 50 points (flat bonus added to every member\'s score)'
# Welfare_check_text = '
+ average number of correct answers in your group (the same is added to every member\'s score)'
EC_exchange_rate = 100 # 100 EC = 1 EUR
# ── Part II: Social Cohesion ──────────────────────────────────────────────
Solidarity_EC = 100 # windfall for each of the 2 lucky players
Stag_win_EC = 100 # payoff if ALL 3 choose Stag
Hare_safe_EC = 40 # payoff for choosing Hare (regardless of others)
Dictator_EC = 100 # proposer endowment per ultimatum game (×2 games)
Trust_EC = 50 # sender endowment per trust game (×2 games)
PGG2_Commons = 100 # one-shot anonymous PGG endowment
# ── Part II: instruction template paths ──────────────────────────────────
Instructions_solidarity = "_templates/global/Instructions_solidarity.html"
Instructions_staghunt = "_templates/global/Instructions_staghunt.html"
Instructions_ultimatum = "_templates/global/Instructions_ultimatum.html"
Instructions_trust = "_templates/global/Instructions_trust.html"
Instructions_pgg2 = "_templates/global/Instructions_pgg2.html"
# %% ExtraModel: cross-session treatment counter
class TreatmentCounter(ExtraModel):
"""Persistent DB table tracking how many groups have been assigned to each
treatment across ALL sessions. Survives session resets as long as the DB
is not wiped with 'otree resetdb'."""
treatment = models.StringField()
count = models.IntegerField(initial=0)
def get_treatment_counts():
"""Return {treatment: count} for all four treatments.
Reads ALL rows (no field filtering — ExtraModel only supports relational
filter args), builds a dict in Python, and fills missing treatments with 0."""
all_rows = TreatmentCounter.filter() # no args → returns every row
existing = {row.treatment: row.count for row in all_rows}
return {t: existing.get(t, 0) for t in CommonConstants.TREATMENTS}
def _set_treatment_count(treatment, new_count):
"""Delete any existing row for this treatment and insert a fresh one.
ExtraModel has no update(); delete+create is the standard pattern."""
for row in TreatmentCounter.filter():
if row.treatment == treatment:
row.delete()
TreatmentCounter.create(treatment=treatment, count=new_count)
def assign_treatment_balanced():
"""Pick the least-used treatment globally (break ties randomly),
increment its persistent counter, and return the treatment name."""
counts = get_treatment_counts()
min_count = min(counts.values())
candidates = [t for t, c in counts.items() if c == min_count]
chosen = random.choice(candidates)
_set_treatment_count(chosen, counts[chosen] + 1)
return chosen
# %% Payoff helper
def compute_pie_share(player_score, player_multiplier,
group_scores, group_multipliers,
treatment, welfare_check=50, economy_pie=500):
"""
Compute this player's EC payoff from the economy pie for one round.
weighted_i = score_i * multiplier_i
Welfare State: weighted_i += welfare_check (applied to every member)
payoff = (weighted_self / sum(weighted_all)) * economy_pie
Returns (player_payoff_ECs, player_weighted_score, total_weighted_score).
"""
weighted = [s * m for s, m in zip(group_scores, group_multipliers)]
if treatment == 'Welfare_State':
avg_weighted = sum(weighted) / len(weighted)
weighted = [w + avg_weighted for w in weighted] #this adds to each person's score the average score of the three.
total = sum(weighted)
player_w = player_score * player_multiplier
if treatment == 'Welfare_State':
player_w += avg_weighted
payoff = (player_w / total) * economy_pie if total > 0 else 0.0
return payoff, player_w, total
# %% Pages
class MyBasePage(Page):
form_model = 'player'
form_fields = []
@staticmethod
def vars_for_template(player):
return {
'hidden_fields': [],
'Instructions': player.session.config.get('Instructions_general_path'),
'Instructions_part_II': player.session.config.get('Part_II_Instructions_template'),
'Treatment' : player.participant.Treatment
}