トップへ戻る

Indoor ネットワーク フィーチャの生成 (Generate Indoor Network Features) (Indoors)

このトピックの内容

  1. サマリー
  2. 使用法
  3. パラメーター
  4. 環境
  5. ライセンス情報

サマリー

1 つ以上の施設の選択したレベルに屋内経路とフロア遷移を生成します。 このツールは、1 回の実行のあいだにルート検索可能な屋内ネットワークの水平方向の経路と垂直方向のフロア遷移を生成できます。

使用法

  • [入力レベル フィーチャ] パラメーター値は、Levels フィーチャクラスの ArcGIS Indoors Information Model に準拠するフィーチャ レイヤーまたはフィーチャクラスの必要があります。

    • 特定の施設またはレベルに対して経路を生成するには、先に [属性検索 (Select Layer By Attribute)] ツールを使用して対応するレベル フィーチャを選択してから、このツールを実行します。
    • フィーチャクラスまたはフィーチャ レイヤーに選択範囲が指定されていないなら、ツールはすべてのフィーチャの経路を生成します。

  • [入力ユニット フィーチャ] パラメーターの値は、Units フィーチャクラスの Indoors モデルに準拠するフィーチャ レイヤーまたはフィーチャクラスの必要があります。

  • [入力障害物フィーチャ] パラメーターの値は、経路の生成をブロックする壁、窓、柱などの通行不可能なフィーチャを表すフィーチャ レイヤーまたはフィーチャクラスの必要があります。

    • このパラメーターに使用される入力には LEVEL_ID フィールドが含まれているか、フロア対応として構成されたマップ レイヤーの必要があります。
    • オプションの [障害物の式] パラメーターを使用して、[入力障害物フィーチャ] パラメーターの値からフィーチャのサブセットを定義する SQL 式を構成し、経路の生成をブロックする壁、窓、柱などのバリアを定義する属性値を選択できます。

  • [ターゲット屋内経路] パラメーターの値は、Pathways フィーチャクラスの Indoors モデルに準拠するフィーチャ レイヤーまたはフィーチャクラスの必要があります。

    • [ターゲット屋内経路] パラメーターの値に [入力レベル フィーチャ] パラメーターの値で定義されたレベルの既存の経路が含まれているなら、ツールは既存の経路を上書きします。

  • オプションの [ターゲット フロア遷移] パラメーターの値は、Transitions フィーチャクラスの Indoors モデルに準拠する既存のフィーチャ レイヤーまたはフィーチャクラスの必要があります。 このパラメーターにターゲット遷移レイヤーが指定されていなければ、このツールは水平方向の経路フィーチャのみを作成します。

    • [ターゲット フロア遷移] パラメーターで指定されたレイヤーに、[入力レベル フィーチャ] パラメーターの値で定義されたレベルの既存の遷移が含まれているなら、ツールは既存の経路を上書きします。
    • ツールで作成された遷移フィーチャの頂点は、ネットワークが接続されていることを保証するため、経路フィーチャにスナップされます。
    • 遷移を作成するには、入力レベル フィーチャに最低 2 つのレベル フィーチャが含まれている必要があります。
    • 遷移を指定するときは、[階段ユニットの式] パラメーター、[エレベーターの式] パラメーター、または両方の値を指定する必要があります。

  • [経路の生成方法] パラメーターには、ツールが経路フィーチャをどのように作成するかを示す、次のオプションを指定します:

    • [ユニバーサル循環ネットワーク] - 水平方向の経路は、ユニバーサル循環ネットワーク アルゴリズムを使用して作成されます。このアルゴリズムは歩行パターンをより正確に模しており、主に 90 度の角度で構成されていない、または一定の回転があるような建物に適しています。 遷移フィーチャは、入力遷移が指定されたときにも作成されます。
    • [遷移のみ] - 既存の経路があるなら、このオプションを使用してフロア間に垂直方向の遷移を作成し、既存の経路にスナップできます。

  • オプションの [ルート検索可能な位置] パラメーターの値は、ユニットの重心に加えて、経路が生成される対象の点を表す点フィーチャ レイヤーまたはフィーチャクラスの必要があります。 検索可能な位置が指定されていなければ、ツールはユニットの重心への経路のみを生成します。

  • オプションの [障害物バッファー] パラメーターは、経路を定義するときバリアの周囲にどれだけのバッファーを作成するかを定義します。 障害物バッファーを使用するときは、次の点を考慮してください:

    • 障害物バッファーが低いほど、障害物 (壁など) の近くに経路フィーチャが作成されます。
    • 障害物バッファーは、ユニット間の経路の接続性を保証するため、最も狭い入口の幅の半分を最大とします。
    • バッファー内に検索可能な位置がある場合、ツールはそれらの位置にルーティングしません。

  • オプションの [エレベーター遅延] パラメーターを使用して、エレベーターでフロア間を遷移するときのエレベーター待ち時間を秒単位で定義します。

  • [検索範囲] パラメーターを使用して、経路を生成するとき特定の検索可能な位置から経路で接続されるべき、近くの検索可能な位置を特定します。 検索範囲を定義するときは、次の点を考慮してください:

    • 検索範囲を増やすと、生成される経路も増えます。
    • 大きな空き地や長い廊下では、検索範囲を大きくすることで経路の接続性を保証できます。
    • 検索範囲が大きいと、ツールの実行時間が長くなります。

  • このツールは、並列処理ファクター環境を優先します。 この環境が設定されていなければ、デフォルトは利用可能なコア数の 50% です。 この環境が 100 に設定されると完全な並列処理が有効になり、ツールはコンピューターのすべての論理コアに作業の分散を試みます。 この環境を 0 に設定すると、並列処理は無効になります。 ファクターを 1 ～ 99 に指定すると、ツールは数式 (並列処理ファクター / 100 * 論理コア) の小数部を切り上げた整数を適用して、使用する論理コアの割合を決定します。 この数式の結果が 0 または 1 の場合、並列処理は有効化されません。

パラメーター

ダイアログPython

ラベル説明データ タイプ
入力レベル フィーチャ

レベルのフィーチャを含むフィーチャクラスまたはレイヤー。 Indoors モデルでは、これは Levels レイヤーになります。 このツールは、レイヤーに適用された選択とフィルター設定を使用します。

Feature Layer
入力ユニット フィーチャ

ユニット フィーチャを含むフィーチャクラスまたはレイヤー。 Indoors Model では、これは Units レイヤーになります。

Feature Layer
入力障害物フィーチャ

通過不可能な壁、窓、柱などのフィーチャを表すポリライン フィーチャを含むフィーチャクラスまたはレイヤー。 障害物フィーチャ レイヤーは LEVEL_ID フィールドを含むか、マップ内でフロア対応として定義される必要があります。

Feature Layer
ターゲット屋内経路

生成された経路フィーチャが作成されるフィーチャクラスまたはフィーチャ レイヤー。 Indoors モデルでは、Pathways レイヤーになります。

Feature Layer
ターゲット屋内遷移
(オプション)

フロア間の垂直方向の遷移、たとえば階段やエレベーターなどを表す、生成された遷移フィーチャが作成されるフィーチャクラスまたはフィーチャ レイヤー。 Indoors Model では、これは Transitions レイヤーになります。

Feature Layer
障害物の式
(オプション)

[入力障害物フィーチャ] パラメーターから、どのフィーチャのサブセットが、経路で通過できないバリアなのかを定義する SQL 式。 これには壁、ウィンドウ、柱などのフィーチャが含まれます。

SQL Expression
ルート検索可能な位置
(オプション)

これらの位置への経路も生成することを指定します。 このパラメーターは、入力としてポイント フィーチャ レイヤーを受け付けます。

Feature Layer
経路の生成方法
(オプション)

屋内経路の生成に使用される方法を指定します。

  • ユニバーサル循環ネットワーク—水平方向の経路は、ユニバーサル循環ネットワーク アルゴリズムを使用して作成され、このアルゴリズムは歩行パターンをより正確に模しています。 この方法は、主に 90 度の角度で構成されていない、または一定の回転があるような建物に適しています。 入力遷移が指定されたときも、遷移フィーチャは作成されます。
  • 遷移のみ—既存の経路があるなら、このオプションはフロア間に垂直方向の遷移を作成し、既存の経路にスナップします。
String
階段ユニットの式
(オプション)

入力ユニット レイヤーで、階段やエスカレーターなど、歩行ベースの遷移を表すフィーチャを定義する SQL 条件式。

SQL Expression
エレベーターの式
(オプション)

入力ユニット レイヤーで、エレベーターなどリフト ベースの遷移を表すフィーチャを定義する SQL 条件式。

SQL Expression
エレベーター遅延
(オプション)

エレベーターの乗客が乗り降り待ちに費やすと想定される、平均エレベーター遷移時間を秒単位で指定します。 このパラメーターを使用すると、ルート検索と移動時間の計算の精度を高めることができます。

この値は、0 以上である必要があります。

Double
障害物バッファー
(オプション)

バリアとして定義される障害物フィーチャに適用される、バッファー距離。

Linear Unit
検索範囲
(オプション)

特定のポイントから、検索可能な位置を検索する距離。 範囲を大きくすると、より多くの経路が生成されます。 大きな空き地や長い廊下では、経路を生成するための検索範囲を広げる必要があります。

Linear Unit

派生した出力

ラベル説明データ タイプ
更新された経路

更新された [ターゲット屋内経路] レイヤー。

Feature Layer
更新されたターゲット遷移

更新された [ターゲット屋内遷移] レイヤー。

Feature Layer

arcpy.indoors.GenerateIndoorNetworkFeatures(in_level_features, in_unit_features, in_obstacle_features, target_indoor_pathways, {target_floor_transitions}, {obstacle_expression}, {routable_locations}, {generation_method}, {stairway_unit_exp}, {elevator_unit_exp}, {elevator_delay}, {obstacle_buffer}, {search_radius})
名前説明データ タイプ
in_level_features

レベルのフィーチャを含むフィーチャクラスまたはレイヤー。 Indoors モデルでは、これは Levels レイヤーになります。 このツールは、レイヤーに適用された選択とフィルター設定を使用します。

Feature Layer
in_unit_features

ユニット フィーチャを含むフィーチャクラスまたはレイヤー。 Indoors Model では、これは Units レイヤーになります。

Feature Layer
in_obstacle_features

通過不可能な壁、窓、柱などのフィーチャを表すポリライン フィーチャを含むフィーチャクラスまたはレイヤー。 障害物フィーチャ レイヤーは LEVEL_ID フィールドを含むか、マップ内でフロア対応として定義される必要があります。

Feature Layer
target_indoor_pathways

生成された経路フィーチャが作成されるフィーチャクラスまたはフィーチャ レイヤー。 Indoors モデルでは、Pathways レイヤーになります。

Feature Layer
target_floor_transitions
(オプション)

フロア間の垂直方向の遷移、たとえば階段やエレベーターなどを表す、生成された遷移フィーチャが作成されるフィーチャクラスまたはフィーチャ レイヤー。 Indoors Model では、これは Transitions レイヤーになります。

Feature Layer
obstacle_expression
(オプション)

in_obstacle_features パラメーターから、どのフィーチャのサブセットが、経路で通過できないバリアなのかを定義する SQL 式。 これには壁、ウィンドウ、柱などのフィーチャが含まれます。

SQL Expression
routable_locations
[routable_locations,...]
(オプション)

これらの位置への経路も生成することを指定します。 このパラメーターは、入力としてポイント フィーチャ レイヤーを受け付けます。

Feature Layer
generation_method
(オプション)

屋内経路の生成に使用される方法を指定します。

  • UCN—水平方向の経路は、ユニバーサル循環ネットワーク アルゴリズムを使用して作成され、このアルゴリズムは歩行パターンをより正確に模しています。 この方法は、主に 90 度の角度で構成されていない、または一定の回転があるような建物に適しています。 入力遷移が指定されたときも、遷移フィーチャは作成されます。
  • TRANSITIONS_ONLY—既存の経路があるなら、このオプションはフロア間に垂直方向の遷移を作成し、既存の経路にスナップします。
String
stairway_unit_exp
(オプション)

入力ユニット レイヤーで、階段やエスカレーターなど、歩行ベースの遷移を表すフィーチャを定義する SQL 条件式。

SQL Expression
elevator_unit_exp
(オプション)

入力ユニット レイヤーで、エレベーターなどリフト ベースの遷移を表すフィーチャを定義する SQL 条件式。

SQL Expression
elevator_delay
(オプション)

エレベーターの乗客が乗り降り待ちに費やすと想定される、平均エレベーター遷移時間を秒単位で指定します。 このパラメーターを使用すると、ルート検索と移動時間の計算の精度を高めることができます。

この値は、0 以上である必要があります。

Double
obstacle_buffer
(オプション)

バリアとして定義される障害物フィーチャに適用される、バッファー距離。

Linear Unit
search_radius
(オプション)

特定のポイントから、検索可能な位置を検索する距離。 範囲を大きくすると、より多くの経路が生成されます。 大きな空き地や長い廊下では、経路を生成するための検索範囲を広げる必要があります。

Linear Unit

派生した出力

名前説明データ タイプ
updated_pathways

更新された target_indoor_pathways レイヤー。

Feature Layer
updated_transitions

更新された target_floor_transitions レイヤー。

Feature Layer

コードのサンプル

GenerateIndoorNetworkFeatures の例 (Python ウィンドウ)

次の Python スクリプトは、イミディエイト モードで GenerateIndoorNetworkFeatures 関数を使用する方法を示しています。

import arcpy
arcpy.indoors.GenerateIndoorNetworkFeatures(r"C:\Indoors.gdb\Indoors\Levels",
                                 r"C:\Indoors.gdb\Indoors\Units",
                                 r"C:\Indoors.gdb\Indoors\Details",
                                 r"C:\Indoors.gdb\Network\Pathways",
                                 r"C:\Indoors.gdb\Network\Transitions",
                                 "USE_TYPE = 'Interior Wall'", "Occupants", 
                                 r"C:\Data.gdb\RoutableLocationPoints",
                                 "UCN",
                                 "USE_TYPE = 'Stairway'", "USE_TYPE = 'Elevator'", "",
                                 '0.5 Meters', '5 Meters'
                                 )
GenerateIndoorNetworkFeatures の例 2 (スタンドアロン スクリプト)

次のスタンドアロン スクリプトで、GenerateIndoorNetworkFeatures 関数を使用する方法を示します。

#Name: Indoors_GenerateIndoorNetworkFeatures_example2.py
#Description: Generates indoor pathways on selected levels in one or more facilities.

import arcpy

# Set Local Variables
in_level_features=r"C:\data\Indoors.gdb\Indoors\Levels",
in_unit_features=r"C:\data\Indoors.gdb\Indoors\Units",
in_obstacle_features=r"C:\data\Indoors.gdb\Indoors\Details",
target_indoor_pathways=r"C:\data\Indoors.gdb\Network\Pathways",
target_transitions=r"C:\data\Indoors.gdb\Network\Transitions",
obstacle_expression="USE_TYPE = 'Interior Wall'",
routable_locations="Occupants",
generation_method="UCN"
stairway_unit_exp="USE_TYPE = 'Stairway'",
elevator_unit_exp="USE_TYPE = 'Elevator'",
elevator_delay="15"
obstacle_buffer="0.4 Meters",
search_radius="10 Meters"

#Call the function
arcpy.indoors.GenerateIndoorNetworkFeatures(
    in_level_features,
    in_unit_features,
    in_obstacle_features,
    target_indoor_pathways,
    target_floor_transitions,
    obstacle_expression,
    routable_locations,
    generation_method,
    stairway_unit_exp,
    elevator_unit_exp,
    elevator_delay,
    obstacle_buffer,
    search_radius,
)

環境

並列処理ファクター

ライセンス情報

  • Basic: No
  • Standard: No
  • Advanced: 次のものが必要 ArcGIS Indoors Pro または ArcGIS Indoors Maps

関連トピック

  • Indoors ツールボックスの概要
  • Indoors ネットワーク ツールセットの概要
  • Indoor ネットワークの作成
  • ジオプロセシング ツールの検索

このトピックへのフィードバック

このトピックの内容
  1. サマリー
  2. 使用法
  3. パラメーター
  4. 環境
  5. ライセンス情報