# 空間エージェント関数（エージェント集合生成）

## make_agtset_around_own

連続空間上で指定した視野の範囲内にいるエージェントの集合を返す。

**make_agtset_around_own**(distance, include_self, agttype=None)


- **distance** - 視野の広さ。
- **include_self** - Falseのときエージェント集合に自分を含まず、Trueのとき含む。
- **agttype** - 集める対象とするエージェント種別。初期値はNoneで、このとき全てのエージェント種別を対象とする。

※基本的に、空間エージェントのルールエディタ内で「self.[関数名]」の形で用いる<br>※連続空間でのみ使用可能。

```
# 自分から距離5以内のエージェントを全て取得する（自分を含まない）
# （空間エージェントのルールエディタに記述）
neighbors = self.make_agtset_around_own(5, False)

# 自分から距離3以内のUniverse.hiroba.hitoエージェントを取得する（自分を含む）
# （空間エージェントのルールエディタに記述）
neighbors = self.make_agtset_around_own(5, True, agttype=Universe.hiroba.hito)
```

<!--

| 例外処理               | 空間チェック：ArtisocCloudIllegalUseOfFunctionError   →エージェントの属する空間が連続空間でない場合エラーを返す      引数の型チェック：ArtisocCloudTypeError   →ただしagttype引数に空間エージェントでないUniverse直下のAgt型が渡された場合はここで例外を投げず、下記のArtisocCloudNotSpaceAgtErrorを返す      エージェントの種別チェック：ArtisocCloudNotSpaceAgtError   →agttype引数に空間エージェントでないUniverse直下のAgt型を指定したときエラー      エージェントの空間チェック：ArtisocCloudDifferentSpaceAgtError   agttype引数に自分と同じ同じ空間にないエージェントを指定したらエラー |
| ---------------------- | ------------------------------------------------------------ |
| 実装箇所               | SpaceAgt                                                     |
| artisoc4で対応する関数 | MakeAllAgtSetAroundOwn   MakeOneAgtSetAroundOwn              |
| artisoc4との差異       | 引数、戻り値など                                             |
| 動作条件               | 連続空間上にいるagt   （格子空間では使えない）               |
| 備考                   | generalfunctionのmake_agtset_around_positionを呼ぶ           |

-->

## make_agtset_around_own_sqgrid

四角格子空間上で、指定した視野の範囲内にいるエージェントの集合を返す。

**make_agtset_around_own_sqgrid**(distance, include_self, agttype=None, manhattan=False)

- **distance** - 視野の広さ。
- **include_self** - Falseのときエージェント集合に自分を含まず、Trueのとき含む。
- **agttype** - 集める対象とするエージェント種別。初期値はNoneで、このとき全てのエージェント種別を対象とする。
- **manhattan** - Falseのときは視野をチェビシェフ距離で、Trueのときはマンハッタン距離で定義する。初期値はFalse。

※基本的に、空間エージェントのルールエディタ内で「self.[関数名]」の形で用いる
```
# 自分から距離5以内のエージェントを全て取得する（自分を含まない）
# （空間エージェントのルールエディタに記述）
neighbors = self.make_agtset_around_own(5, False)

# 自分から距離3以内のUniverse.hiroba.hitoエージェントを取得する（自分を含む）
# （空間エージェントのルールエディタに記述）
neighbors = self.make_agtset_around_own(5, True, agttype=Universe.hiroba.hito)
```

<!--

| 関数名                 | make_agtset_around_own_hexgrid                               |
| ---------------------- | ------------------------------------------------------------ |
| 引数                   | view:視野(integer)   own=false:自分自身を含むかどうか(boolean)   agttype=None:エージェント種別(AgtType) |
| 戻り値                 | set                                                          |
| 説明                   | エージェント自身の周りにいるエージェントのエージェント集合型変数を返す |
| 使用例                 |                                                              |
| 例外処理               | 空間チェック：ArtisocCloudIllegalUseOfFunctionError   →エージェントの属する空間が六角格子空間でない場合エラーを返す      引数の型チェック：ArtisocCloudTypeError   →ただしagttype引数に空間エージェントでないUniverse直下のAgt型が渡された場合はここで例外を投げず、下記のArtisocCloudNotSpaceAgtErrorを返す      エージェントの種別チェック：ArtisocCloudNotSpaceAgtError   →agttype引数に空間エージェントでないUniverse直下のAgt型を指定したときエラー      エージェントの空間チェック：ArtisocCloudDifferentSpaceAgtError   agttype引数に自分と同じ同じ空間にないエージェントを指定したらエラー |
| 実装箇所               | SpaceAgt                                                     |
| artisoc4で対応する関数 | MakeAllAgtSetAroundOwnCell   MakeOneAgtSetAroundOwnCell      |
| artisoc4との差異       | 引数、戻り値など  六角格子専用にする                         |
| 動作条件               | 六角格子空間上にいるagt                                      |
| 備考                   | 内部でgeneralfunctionのmake_agtset_around_position_sqgridを呼ぶ |

-->