# Sessions

oTreeにおいて，sessionとは，複数のプレイヤーが参加している一連のタスク，もしくはゲームのことを指します．以下はsessionの一例です．

> 多数の参加者が実験室に集まり，公共財ゲームを以下のような質問文による実験を実施します．参加者は10.00ユーロを参加費として受け取り，さらにゲームの結果に応じて報酬を受け取ります．

### Subsessions

sessionは複数のsubsessionの集まりです．つまり，subsessionとは，sessionを形作るセクション，もしくはモジュールということです．例えば，公共財ゲームの後にアンケートを実施するとすれば，公共財ゲームはsubsessionの1つ目であり，アンケートはsubsessionの2つ目，ということができます．それぞれのsubsessionは複数の"page"からなります．例えば，公共財ゲームのsubsessionの中に4ページあり，アンケートのsubsessionの中に2ページあるイメージです．

例えば，複数期繰り返すゲームであれば，各期をsubsessionとしてみなすことができます．

### Groups

各subsessionはプレイヤーのグループに分けることができます．例えば，30人プレイヤーのsubsessionがあれば，2人組を15グループに分けることができます．

※グループはsubsessionの間でシャッフルすることができます．

### Object hierarchy

oTreeには以下のような階層性があります．

```
Session
       Subsession
          Group
               Player
                 Page
```

* sessionとは，subsessionの集合です．
* subsessionには複数のgroupを含んでいます．
* groupには，複数のプレイヤーを含んでいます．
* 各プレイヤーは複数のページで進めていきます．

### Participant

oTreeにおいては，"player"と"participant"は違うものです．"player"と"participant"の関係は，sessionとsubsessionの関係と同じようなものです．

playerは特定のsubsessionにおけるparticipantの呼び方です．playerはparticipantが果たす一時的な役のようなものです．あるparticipantは最初のsubsessionでplayer2に割り振られた後に，次のsubsessionではplayer1に割り振られると言ったようなものです．

### What is "self"?

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に移動します．

### Self: extended examples

以下にはいくつかのコードの例を紹介します．

```
class Session(...) # this class is defined in oTree-core
    def example(self):

        # current session object
        self

        self.config

        # child objects
        self.get_subsessions()
        self.get_participants()

class Participant(...) # this class is defined in oTree-core
    def example(self):

        # current participant object
        self

        # parent objects
        self.session

        # child objects
        self.get_players()
```

そして，`models.py`は以下の通りです．

```
class Subsession(BaseSubsession):
    def example(self):

        # current subsession object
        self

        # parent objects
        self.session

        # child objects
        self.get_groups()
        self.get_players()

        # accessing previous Subsession objects
        self.in_previous_rounds()
        self.in_all_rounds()

class Group(BaseGroup):
    def example(self):

        # current group object
        self

        # parent objects
        self.session
        self.subsession

        # child objects
        self.get_players()

class Player(BasePlayer):

    def example(self):

        # current player object
        self

        # method you defined on the current object
        self.my_custom_method()

        # parent objects
        self.session
        self.subsession
        self.group
        self.participant

        self.session.config

        # accessing previous player objects
        self.in_previous_rounds()

        # equivalent to self.in_previous_rounds() + [self]
        self.in_all_rounds()
```

最後に，`views.py`は以下の通りです．

```
class MyPage(Page):
    def example(self):

       # current page object
       self

       # parent objects
        self.session
        self.subsession
       self.group
        self.player
         self.participant
         self.session.config
```

<https://otree.readthedocs.io/en/latest/conceptual_overview.html>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://akrgt.gitbook.io/otree-jp/na/sessions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.