フロア遷移の生成 (Generate Floor Transitions) (Indoors)

サマリー

フロアを垂直に接続する遷移ライン フィーチャを作成または更新します。

選択した遷移ユニット ポリゴンを使用し、施設内のレベル間の垂直遷移ラインを生成します。 これらの遷移フィーチャと経路フィーチャを併用し、ルート検索のネットワークを生成します。

使用法

  • [入力施設フィーチャ][入力施設フィーチャ]、および [遷移ユニット フィーチャ] パラメーター値に使用するフィーチャ レイヤーまたはフィーチャクラスは、屋内データセットまたは Indoors ジオデータベースから取得できます。 [経路フィーチャ] および [ターゲット遷移] パラメーター値に使用するフィーチャ レイヤーまたはフィーチャクラスは、予備屋内ネットワーク データセットまたは Indoors ジオデータベースから取得できます。

  • [入力施設フィーチャ] パラメーター値は、施設フィーチャクラスの ArcGIS Indoors Information Model に準拠するポリゴン フィーチャ レイヤーまたはフィーチャクラスである必要があります。 入力レイヤーで選択を行うか、フィルター設定を定義することで、フロア遷移の生成を特定の施設に限定できます。 選択やフィルター設定を行わなければ、ツールは入力レイヤー上のすべての施設のすべてのレベルに対して、フロア遷移を生成します。

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

    • [遷移ユニット フィーチャ] パラメーターは、階段やエレベーターなど、遷移を生成するフロア プランのエリアを定義するために使用されます。
    • [遷移ユニット フィーチャ] パラメーター値が、階段またはエレベーター タイプの両方のスペースを表すポリゴンを含むフィーチャクラスである場合は、[階段ユニットの式][エレベーター ユニットの式] パラメーターを使用し、どのフィーチャがどの遷移スペース タイプを表すかを特定します。 Indoors Model では、USE_TYPE フィールドの値を使用できます。

  • [経路フィーチャ] パラメーター値は、PrelimPathways フィーチャクラスの Indoors Model に準拠し、ツールが処理するスペースの予備経路フィーチャを含むポリライン フィーチャ レイヤーまたはフィーチャクラスである必要があります。 ツールは、生成された遷移フィーチャをこれらの予備経路にスナップし、接続されたルート検索可能ネットワークを作成します。

  • [ターゲット遷移] パラメーター値は、PrelimTransitions フィーチャクラスの Indoors Model に準拠するポリライン フィーチャ レイヤーまたはフィーチャクラスである必要があります。 新しい遷移はここに書き込まれ、ネットワーク データセットの作成に使用されます。

  • [エレベーター遅延] パラメーターは、エレベーターの利用者が予期すべき待ち時間を考慮し、特定されたエレベーター遷移スペースに含まれる既存の [経路フィーチャ] 値に遅延の値を適用することで、ルート案内と移動時間の計算を向上します。

    • デフォルトの Indoors ネットワーク データセット テンプレートを使用する場合、予期されるエレベーター遅延を含めると、徒歩モードに比べて、車椅子モードの結果が異なることがあります。 エレベーター遅延が発生すると、階段を使う方が合計移動時間が短くなることがあるからです。

  • ツールは、各フロアの [経路フィーチャ] 値で、選択したタイプのポリゴン中心に最も近い頂点を探します。 この頂点で、レベル間に鉛直線が作成されます。 生成された [遷移] フィーチャの開始頂点と終了頂点の Z 値が、経路フィーチャの Z 値と一致します。

  • すべての出力遷移フィーチャに対し、LENGTH_3D 属性が計算されます。 階段タイプの遷移の場合、時間を 3 倍にして、階段を徒歩移動する時間を考慮に入れます。 これらの値は、必要に応じて手動で再計算できます。

    注意:

    遷移フィーチャを手動で編集した場合、ルート検索時の移動時間を正確に反映させるには、この値も再計算する必要があります。

  • 出力遷移フィーチャの場合、次の属性にデフォルト値が設定されます。

    • TRANSITION_RANK
    • TRANSITION_TYPE
    • TRAVEL_DIRECTION

    注意:

    これらの値は、ネットワーク データセットを作成する前に、必要に応じて手動で編集できます。

パラメーター

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

施設を表す入力ポリゴン フィーチャ。 Indoors Model では、これは Facilities レイヤーになります。 これらのフィーチャで表される施設のみが処理されます。

Feature Layer
遷移ユニット フィーチャ

施設内の遷移スペースを表す入力ポリゴン フィーチャ。 Indoors Model では、これは Units レイヤーになります。

Feature Layer
経路フィーチャ

予備経路を表す入力ポリライン フィーチャです。 新しい遷移フィーチャは、これらのポリライン フィーチャにスナップされます。 Indoors モデルでは、これは PrelimPathways レイヤーになります。

Feature Layer
ターゲット遷移

新しい遷移で更新される、既存のフィーチャクラスまたはレイヤー。 Indoors モデルでは、これは PrelimTransitions レイヤーになります。

Feature Layer
エレベーター遅延
(オプション)

エレベーターの平均移動時間。 エレベーターの乗り降りに伴う推定待ち時間の半分の時間です (秒単位)。 このパラメーターを使用すると、ルート検索と移動時間の計算の精度を高めることができます。 この値は、0 以上である必要があります。

Long
既存の遷移の削除
(オプション)

新しい遷移フィーチャを作成する前に、選択した遷移スペースの既存の遷移フィーチャを削除するかどうかを指定します。 このパラメーターを使用しない場合、[更新された遷移] の値には既存の遷移フィーチャと新たに作成された遷移フィーチャの両方が含まれます。

  • オン - 既存の遷移フィーチャが削除されます。 これがデフォルトです。
  • オフ - 既存の遷移フィーチャは削除されません。
Boolean
階段ユニットの式
(オプション)

階段やエスカレーターなど、ステップベースの遷移を表す [遷移ユニット フィーチャ] 値を定義する SQL 式。

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

エレベーターなど、リフトベースの遷移を表す [遷移ユニット フィーチャ] 値を定義する SQL 式です。

SQL Expression

派生した出力

ラベル説明データ タイプ
更新された遷移

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

Feature Class

arcpy.indoors.GenerateFloorTransitions(facility_features, transition_unit_features, pathway_features, target_transitions, {elevator_delay}, {delete_existing_transitions}, {stairway_unit_exp}, {elevator_unit_exp})
名前説明データ タイプ
facility_features

施設を表す入力ポリゴン フィーチャ。 Indoors Model では、これは Facilities レイヤーになります。 これらのフィーチャで表される施設のみが処理されます。

Feature Layer
transition_unit_features

施設内の遷移スペースを表す入力ポリゴン フィーチャ。 Indoors Model では、これは Units レイヤーになります。

Feature Layer
pathway_features

予備経路を表す入力ポリライン フィーチャです。 新しい遷移フィーチャは、これらのポリライン フィーチャにスナップされます。 Indoors モデルでは、これは PrelimPathways レイヤーになります。

Feature Layer
target_transitions

新しい遷移で更新される、既存のフィーチャクラスまたはレイヤー。 Indoors モデルでは、これは PrelimTransitions レイヤーになります。

Feature Layer
elevator_delay
(オプション)

エレベーターの平均移動時間。 エレベーターの乗り降りに伴う推定待ち時間の半分の時間です (秒単位)。 このパラメーターを使用すると、ルート検索と移動時間の計算の精度を高めることができます。 この値は、0 以上である必要があります。

Long
delete_existing_transitions
(オプション)

新しい遷移フィーチャを作成する前に、選択した遷移スペースの既存の遷移フィーチャを削除するかどうかを指定します。 このパラメーターを使用しない場合、updated_transitions の値には既存の遷移フィーチャと新しく作成された遷移フィーチャの両方が含まれます。

  • DELETE_FEATURES既存の遷移フィーチャが削除されます。 これがデフォルトです。
  • NO_DELETE_FEATURES既存の遷移フィーチャは削除されません。
Boolean
stairway_unit_exp
(オプション)

階段やエスカレーターなど、ステップベースの遷移を表す [遷移ユニット フィーチャ] 値を定義する SQL 式。

SQL Expression
elevator_unit_exp
(オプション)

エレベーターなど、リフトベースの遷移を表す [遷移ユニット フィーチャ] 値を定義する SQL 式です。

SQL Expression

派生した出力

名前説明データ タイプ
updated_transitions

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

Feature Class

コードのサンプル

GenerateFloorTransitions の例 1 (Python ウィンドウ)

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

# Name: Indoors_GenerateFloorTransitions_example1
# Description: Generates floor transition line features for selected unit types without delay

import arcpy

arcpy.indoors.GenerateFloorTransitions(r"C:\Indoors\ExampleCampus.gdb\Indoor\Facilities", 
                                       r"C:\Indoors\ExampleCampus.gdb\Indoor\Units", 
                                       r"C:\Indoors\ExampleCampus.gdb\PrelimIndoorNetwork\PrelimPathways", 
                                       r"C:\Indoors\ExampleCampus.gdb\PrelimIndoorNetwork\PrelimTransitions", 
                                       None, "DELETE_FEATURES", 
                                       "USE_TYPE IN ('Stairs', 'Stairway')", 
                                       "USE_TYPE IN ('Elevator', 'Elevator Cab', 'Elevator Shaft')")
GenerateFloorTransitions の例 2 (スタンドアロン スクリプト)

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

# Name: Indoors_GenerateFloorTransitions_example2
# Description: Generates floor transition line features for selected unit types 
#              and adds elevator delay

import arcpy

# Define inputs
facility_features = r"C:\Indoors\ExampleCampus.gdb\Indoor\Facilities"
transition_unit_features = r"C:\Indoors\ExampleCampus.gdb\Indoor\Units"
pathway_features = r"C:\Indoors\ExampleCampus.gdb\PrelimIndoorNetwork\PrelimPathways"
target_transitions = r"C:\Indoors\ExampleCampus.gdb\PrelimIndoorNetwork\PrelimTransitions"
elevator_delay = 20
stairway_unit_exp = "USE_TYPE IN ('Stairs', 'Stairway')"
elevator_unit_exp = "USE_TYPE IN ('Elevator', 'Elevator Cab', 'Elevator Shaft')"

# Run tool
arcpy.indoors.GenerateFloorTransitions(facility_features, 
                                       transition_unit_features, 
                                       pathway_features, target_transitions, 
                                       elevator_delay, 'NO_DELETE_FEATURES', 
                                       stairway_unit_exp, elevator_unit_exp)

環境

このツールは、ジオプロセシング環境を使用しません。

ライセンス情報

  • Basic: No
  • Standard: No
  • Advanced: 次のものが必要 ArcGIS Indoors Pro または ArcGIS Indoors Maps および 3D Analyst

関連トピック