# エージェント集合操作（基本操作）

## add

エージェント集合型変数にエージェントを追加する。

**add**(agt)

- **agt** - 追加するエージェント。

※「[集合型変数].[関数名]」の形で用いる<br>※Python標準の関数です。詳しくはPython公式ドキュメントを参照してください。<br><https://docs.python.org/ja/3/library/stdtypes.html#set>

```
# エージェント集合peopleにエージェントtaroを追加する
people.add(taro)
```

## clear

エージェント集合型変数の中身をクリアする。

**clear**()

※「[集合型変数].[関数名]」の形で用いる<br>※Python標準の関数です。詳しくはPython公式ドキュメントを参照してください。<br><https://docs.python.org/ja/3/library/stdtypes.html#set>

```
# エージェント集合peopleの中身をクリアする
people.clear()
```

## copy

エージェント集合型変数をコピーする。

**copy**()

※「[集合型変数].[関数名]」の形で用いる<br>※Python標準の関数です。詳しくはPython公式ドキュメントを参照してください。<br><https://docs.python.org/ja/3/library/stdtypes.html#set>

```
# エージェント集合peopleをコピーしてpeople2を作成する
people2 = people.copy()
```

## count_agt

引数の指定に当てはまるエージェントの数を取得する。

**count_agt**(agttype=None, space=None, layer=None, only_alive=False)

- **agttype** - 指定するエージェント種別。指定しない場合は全てのエージェント種別。
- **space** - 指定する空間。指定しない場合は全ての空間。
- **layer** - 指定するレイヤ。指定しない場合は全てのレイヤ。
- **only_alive** - killフラグが立っていないエージェントのみを指定するかどうか。初期値はFalse。
※killフラグはkill_agt関数によって立てられる

```
# エージェント種別personのエージェント数を取得する
n = count_agt(agttype=Universe.city.person)
n = count_agt(agttype=Universe.city.person, only_alive=True)  # killフラグが立っていないエージェント数を取得する
```



## count_agtset

エージェント集合型変数が保持しているエージェント数を取得する。

**count_agtset**(agtset)

```
# エージェント集合peopleのエージェント数を取得する
n = count_agtset(people)
```



## discard

エージェント集合型変数から、指定したエージェントを削除する。

**discard**(agt)

※「[集合型変数].[関数名]」の形で用いる<br>※Python標準の関数です。詳しくはPython公式ドキュメントを参照してください。<br><https://docs.python.org/ja/3/library/stdtypes.html#set>

```
# エージェント集合peopleからエージェントtaroを削除する
people.discard(taro)
```

## randchoice

エージェント集合からランダムに1つのエージェントを取り出す。

**randchoice**(agtset)

```
# エージェント集合peopleからランダムに1つのエージェントを取り出し変数oneに格納する
one = randchoice(people)
```



## randsample

エージェント集合からランダムに重複なく複数のエージェントを取り出す

**randsample**(agtset, num)

- **agtset** - 対象とするエージェント集合
- **num** - 取り出すエージェントの個数

```
# エージェント集合peopleからランダムに2つのエージェントを取り出し変数pairに格納する
pair = randsample(people)
```