Sessions
oTreeにおいて，sessionとは，複数のプレイヤーが参加している一連のタスク，もしくはゲームのことを指します．以下はsessionの一例です．
多数の参加者が実験室に集まり，公共財ゲームを以下のような質問文による実験を実施します．参加者は10.00ユーロを参加費として受け取り，さらにゲームの結果に応じて報酬を受け取ります．
sessionは複数のsubsessionの集まりです．つまり，subsessionとは，sessionを形作るセクション，もしくはモジュールということです．例えば，公共財ゲームの後にアンケートを実施するとすれば，公共財ゲームはsubsessionの1つ目であり，アンケートはsubsessionの2つ目，ということができます．それぞれのsubsessionは複数の"page"からなります．例えば，公共財ゲームのsubsessionの中に4ページあり，アンケートのsubsessionの中に2ページあるイメージです．
例えば，複数期繰り返すゲームであれば，各期をsubsessionとしてみなすことができます．
各subsessionはプレイヤーのグループに分けることができます．例えば，30人プレイヤーのsubsessionがあれば，2人組を15グループに分けることができます．
※グループはsubsessionの間でシャッフルすることができます．
oTreeには以下のような階層性があります．
SessionSubsessionGroupPlayerPage
sessionとは，subsessionの集合です．
subsessionには複数のgroupを含んでいます．
groupには，複数のプレイヤーを含んでいます．
各プレイヤーは複数のページで進めていきます．
oTreeにおいては，"player"と"participant"は違うものです．"player"と"participant"の関係は，sessionとsubsessionの関係と同じようなものです．
playerは特定のsubsessionにおけるparticipantの呼び方です．playerはparticipantが果たす一時的な役のようなものです．あるparticipantは最初のsubsessionでplayer2に割り振られた後に，次のsubsessionではplayer1に割り振られると言ったようなものです．
Pythonにおいて，selfは現在あなたが使用しているクラスのインスタンスを示しています．もし，今までにselfがある文脈においてどのような役割を果たしているのかわからなければ，classの名前を見つけるまでスクロールアップしてください．
以下の例では，selfはplayerオブジェクトを反映しています．
class Player(object):def my_method(self):return self.my_field
次の例では，selfはGroupオブジェクトを反映しています．
class Group(object):def my_method(self):return self.my_field
selfは概念的には，meという言葉と同様の意味です．あなたはあなた自身をmeと呼んでいますが，他の人はあなたのことをあなたの名前で呼んでいます．そして，あなたの友達がmeという言葉を言った時には，あなたがmeという言葉を言った時とは違うことを意味しています．
例えば，もしあなたがplayerクラスにいる場合，そのplayerのpayoffはself.payoffとして示すことができます．（なぜならば，selfはplayerを意味しているからです）．しかし，もしあなたがviews.pyの中にあるPageクラスにいる場合，同じことを意味するには，self.player.payoffになります．ポインタはpageからplayerに移動します．
以下にはいくつかのコードの例を紹介します．
class Session(...) # this class is defined in oTree-coredef example(self):# current session objectselfself.config# child objectsself.get_subsessions()self.get_participants()class Participant(...) # this class is defined in oTree-coredef example(self):# current participant objectself# parent objectsself.session# child objectsself.get_players()
そして，models.pyは以下の通りです．
class Subsession(BaseSubsession):def example(self):# current subsession objectself# parent objectsself.session# child objectsself.get_groups()self.get_players()# accessing previous Subsession objectsself.in_previous_rounds()self.in_all_rounds()class Group(BaseGroup):def example(self):# current group objectself# parent objectsself.sessionself.subsession# child objectsself.get_players()class Player(BasePlayer):def example(self):# current player objectself# method you defined on the current objectself.my_custom_method()# parent objectsself.sessionself.subsessionself.groupself.participantself.session.config# accessing previous player objectsself.in_previous_rounds()# equivalent to self.in_previous_rounds() + [self]self.in_all_rounds()
最後に，views.pyは以下の通りです．
class MyPage(Page):def example(self):# current page objectself# parent objectsself.sessionself.subsessionself.groupself.playerself.participantself.session.config
https://otree.readthedocs.io/en/latest/conceptual_overview.html
