信頼ゲームを作ってみる

さて，それでは信頼ゲームを作ってみましょう．そしてoTreeについてもっと詳しく理解していきましょう．

信頼ゲームとは何か，というのはこちらを御覧ください．私のお師匠さまが書いてます．

でも，概要はこんな感じ．

はじめに，プレイヤー1が10ポイント受け取ります．そしてプレイヤー2は何も受け取りません．プレイヤー1はプレイヤー2に自身の持っているポイントの一部，もしくは全部を渡すことができます．ただし，プレイヤー2が受け取る前に，その渡したポイントは3倍になります．プレイヤー2が3倍になったポイントを受け取ったら，プレイヤー2はそのうちのいくらをプレイヤー1に渡すか決定することになります．

ここでは以下の工程を経て，信頼ゲームのアプリケーションを作成していきます．

• アップグレード

• 初期アプリケーションの作成

• models.pyの定義

• templates.htmlとviews.pyの定義

• settings.pyの中のSESSION_CONFIGSの追加

• データベースのリセットと再起動

  の流れで行きます．

アップグレード

最新バージョンのoTreeを使うために，コマンドラインを開いて，以下のコードを実行しましょう

pip3 install -U otree-core
#再度インストールします．

otree resetdb
#インストールをした際にはデータベースをリセットしましょう．

初期アプリケーションの作成

cdコマンドを使って，"requirements_base.txt"のある，あなたが作ったoTreeプロジェクトフォルダに移動してください．

このディレクトリの中に，公共財ゲーム用のディレクトリを作ってあげます．

otree startapp my_trust

これによってoTreeプロジェクトフォルダの中に"my_trust"というフォルダができたことを確認してください．

model.pyの定義

最初に，アプリケーションにおけるモデルの定数を定義しましょう．初期保有額は10ポイントであり，支払額は3倍になります．

class Constants(BaseConstants):
    name_in_url = 'my_trust'
    players_per_group = 2
    num_rounds = 1

    endowment = c(10)
    multiplication_factor = 3

続いて，プレイヤーフィールドとグループフィールドを追加しましょう．ここには2つの重要なデータを用意します．"sent"としてプレイヤー1からプレイヤー2への支払額を定義し，"sent back"はプレイヤー2からプレイヤー1への支払額です．

直感的には，プレイヤーフィールドは以下のように定義するかと思われるかもしれません．

# Don't copy paste this...see below
class Player(BasePlayer):

    sent_amount = models.CurrencyField()
    sent_back_amount = models.CurrencyField()

しかし，このモデルには問題があります．"sent_amount"はプレイヤー1だけに適用されなければならず，"sent_back_amount"はプレイヤー2だけに適用されなければなりません．そして，プレイヤー1は"sent_back_amount"を呼び出せなければなりません．どのようにすれば，データモデルはより適切になるでしょうか？

これらのフィールドは"Group"レベルで定義する必要があります．

class Group(BaseGroup):

    sent_amount = models.CurrencyField()
    sent_back_amount = models.CurrencyField()

そして，プレイヤー1の支払額の選択は，自由に数字を入力できる型式ではなく，ドロップダウンメニューで選べるようにしましょう．この機能を実現するために，"currency_range"関数とともに"choice"という引数を用います．

sent_amount = models.CurrencyField(
    choices=currency_range(0, Constants.endowment, c(1)),
)

同様に，プレイヤー2の支払額の選択をドロップダウンメニューから選べるようにします．しかし，"choices"を特定することができません．なぜならば，プレイヤー1の支払額に応じてプレイヤー2の選択肢が変わるからです．後ほど，これにどのように対応するのかを示したいと思います．

それでは，Groupクラスに関数を定義しましょう．

def set_payoffs(self):
    p1 = self.get_player_by_id(1)
    p2 = self.get_player_by_id(2)
    p1.payoff = Constants.endowment - self.sent_amount + self.sent_back_amount
    p2.payoff = self.sent_amount * Constants.multiplication_factor - self.sent_back_amount

templates.htmlとviews.pyの定義

続いて，以下の3ページを定義する必要があります．

プレイヤー1の支払額を決める"Send"ページ プレイヤー2の支払額を決める"Send back"ページ 両プレイヤーが見られる"Result"ページ 各ページにゲームのインストラクションが表示されるように設定すると，どのようにゲームを進めることができるのか確認できると思うので，そのようにしましょう．

Instruction.html

各ページに表示するインストラクションを作るために，"instruction.html"を作りましょう．

{% load otree_tags staticfiles %}

<div class="instructions well well-lg">

    <h3 class="panel-sub-heading">
        インストラクション
    </h3>
<p>
    これは2人プレイヤーの信頼ゲームです．
</p>
<p>
    はじめにプレイヤーAは {{ Constants.endowment }}を受け取ります．
    プレイヤーBは何も受け取りません．
    プレイヤーAは {{ Constants.endowment }} の中からいくらをプレイヤーBに渡すかを決めます．
    プレイヤーBは，プレイヤーがAの支払額を3倍にしたポイントを受け取ります．
    プレイヤーBが3倍になったポイントを受け取ったら，プレイヤーAにいくら渡すかを決めてください．
</p>
</div>

Send.html

このページは今まで見てきたテンプレートと似ています．ただ，"

"を使うと，自動的に他のテンプレートを挿入することができます．

{% extends "global/Page.html" %}
{% load staticfiles otree_tags %}

{% block title %}
    Trust Game: Your Choice
{% endblock %}

{% block content %}

    {% include 'my_trust/Instructions.html' %}

    <p>
    あなたはプレイヤーAです．あなたは {{Constants.endowment}}を持っています．
    </p>

    {% formfield group.sent_amount with label="プレイヤーBに何ポイント渡しますか？" %}

    {% next_button %}

{% endblock %}

続いて，"views.py"を定義します．

class Send(Page):

    form_model = models.Group
    form_fields = ['sent_amount']

    def is_displayed(self):
        return self.player.id_in_group == 1

テンプレート内の"

"はview.py内の"form_model"および"form_fields"と一致している必要があります．

また，"is.displayed()"を使って，"Send.html"がプレイヤー1のみに表示されるようにします．プレイヤー2は"Send.html"を表示しないようにする必要があります．

SendBack.html

続いて，プレイヤー2はお金をプレイヤー1に支払う画面を用意します．以下がテンプレートです．

{% extends "global/Page.html" %}
{% load staticfiles otree_tags %}

{% block title %}
    Trust Game: Your Choice
{% endblock %}

{% block content %}

    {% include 'my_trust/Instructions.html' %}

    <p>
        あなたはプレイヤーBです． プレイヤーAはあなたに {{group.sent_amount}}を渡す決定をしました．
        and you received {{tripled_amount}}.
    </p>

    {% formfield group.sent_back_amount with label="あなたはいくらをプレイヤーAに渡しますか？" %}

    {% next_button %}

{% endblock %}

以下をviews.pyに記入しなければいけません．

3倍にしたポイント示す変数"tripled_amount"をテンプレートに通すために，"vars_for_template()"を使います．Djangoはテンプレート上では直接計算をすることはありません．したがって，この数値はPython上で計算をする必要があり，テンプレートに渡してあげる必要があります． プレイヤー1の決定にしたがって，ドロップダウンメニューに動的に変化させるために"sent_back_amount_choices"を定義します．これは"{field_name}_choices"と呼ばれるものです．

class SendBack(Page):

    form_model = models.Group
    form_fields = ['sent_back_amount']

    def is_displayed(self):
        return self.player.id_in_group == 2

    def vars_for_template(self):
        return {
            'tripled_amount': self.group.sent_amount * Constants.multiplication_factor
        }

    def sent_back_amount_choices(self):
        return currency_range(
            c(0),
            self.group.sent_amount * Constants.multiplication_factor,
            c(1)
        )

Results.html

結果のページはプレイヤーAとプレイヤーBで少し違いがあります．そこで，今のプレイヤーの"id_in_group"によって条件わけをするために，Djangoで用いられている"

"文を使います．

{% extends "global/Page.html" %}
{% load staticfiles otree_tags %}

{% block title %}
    Results
{% endblock %}

{% block content %}

{% if player.id_in_group == 1 %}
    <p>
        あなたはプレイヤーBに {{ group.sent_amount }}を渡しました．
        プレイヤーBはあなたに {{group.sent_back_amount}}を渡しました．
    </p>
{% else %}
    <p>
        プレイヤーAはあなたに {{ group.sent_amount }}を渡しました．
        あなたはプレイヤーAに {{group.sent_back_amount}}を渡しました．
    </p>

{% endif %}

    <p>
    したがって，あなたの利得は {{ player.payoff }}です．
    </p>

    {% include 'my_trust/Instructions.html' %}

{% endblock %}

views.pyでは，単純に以下のように定義します．

class Results(Page):
    pass

待機画面とページ遷移

このゲームでは，2つの待機画面が必要となります．

プレイヤー2はプレイヤー1が支払額を決めるのを待つ必要があります． プレイヤー1はプレイヤー2が支払額を決めるのを待つ必要があります． お互いに決定したあと，利得を計算する必要があります．したがって，"after_all_players_arrive"を使う必要があります．

そこで，これらのページを以下の通り定義します．

class WaitForP1(WaitPage):
    pass

class ResultsWaitPage(WaitPage):

    def after_all_players_arrive(self):
        self.group.set_payoffs()

そして，ページ遷移を以下のように定義します．

page_sequence = [
    Send,
    WaitForP1,
    SendBack,
    ResultsWaitPage,
    Results,
]

settings.pyの中のSESSION_CONFIGSの追加

{
    'name': 'my_trust',
    'display_name': "My Trust Game (simple version from tutorial)",
    'num_demo_participants': 2,
    'app_sequence': ['my_trust'],
},

データベースのリセットと再起動

コマンドラインに以下の通り入力してデータベースをリセットします．

otree resetdb
otree runserver

起動したら，http://127.0.0.1:8000にアクセスしてください．

resetdbは新しいアプリケーションを入れたり，models.pyに変更を加えた場合には必ず実施する必要があります．

これは，models.pyは新たにSQLデータベースを作り直す必要があるためです．

ただし，resetdbをするとデータベースが全てリセットされてしまうので，その前にデータを保存しておく必要があります．実用的なレベルで言えば，csvファイルでダウンロードしておくと良いでしょう．

本家本元のURL（このページを翻訳＋αをしています）：

http://otree.readthedocs.io/en/latest/tutorial/part2.html