インシデントの検出 (Detect Incidents)

インシデントの検出

このツールは、特定時点を表すポイント、ライン、エリア、またはテーブルの時間対応レイヤーを操作します。このツールでは、トラッキングという順番に並んだフィーチャを使用して、対象となるインシデントのフィーチャを決定します。インシデントはユーザーの指定する条件によって決まります。

まず、ツールが 1 つ以上のフィールドを使用してトラッキング対応に属するフィーチャを決定します。各フィーチャの時間を使用して、トラッキング対応が順番に並べられ、インシデント条件が適用されます。インシデントの開始条件と一致するフィーチャがインシデントとしてマークされます。オプションでインシデントの終了条件を適用することもできます。終了条件が true になると、フィーチャはインシデントでなくなります。結果は、元のフィーチャ (インシデント名を表す新しい列を含む) で返され、インシデント条件と一致するフィーチャが示されます。元のフィーチャをすべて返すか、インシデントのフィーチャのみを返すことができます。

たとえば、10 分間隔でのハリケーンの GPS 計測値があるとします。GPS 計測値ごとに、ハリケーンの名前、場所、記録時刻、および風速が記録されています。これらのフィールドを使用してインシデントを作成し、計測値が風速 208 km/時を超えると [Catastrophic] というタイトルのインシデントにすることができます。終了条件を設定しないので、このインシデントはフィーチャが開始条件を満たさなくなった (風速 208 を下回った) 時点で終了します。

別の例を使用して、地域の水道の化学物質濃度を [contaminateLevel] という名前のフィールドを使用して監視するとします。推奨されるレベルは 0.01 mg/L 未満で、0.03 mg/L を超えると危険レベルであることがわかっています。値が 0.03 mg/L を超えるとインシデントとなり、汚染レベルが正常に戻るまで解除されないインシデントを検出するには、開始条件に「 contaminateLevel > 0.03」、終了条件に「 contaminateLevel < 0.01」を使用してインシデントを作成します。これにより、値が 0.03 mg/L を超えてから 0.01 未満に戻るまでのすべてのシーケンスがマーク付けされます。

インシデントの検出元のレイヤーを選択

インシデントの検出に使用するポイント、ライン、エリア、またはテーブル。入力レイヤーは時間対応でなくてはならず、特定時点を表すフィーチャと、トラックの特定に使用できる 1 つ以上のフィールドを含む必要があります。

マップからレイヤーを選択できるだけでなく、ドロップダウン リストの下部にある [レイヤーの参照] を選択し、ビッグ データ ファイル共有データセットまたはフィーチャ レイヤーのコンテンツを参照して選択することもできます。

トラックの識別に使用する 1 つ以上のフィールドの選択

トラッキング識別子を表すフィールド。1 つまたは複数のフィールドを使用して、トラックの一意の値を表すことができます。

たとえば、ハリケーンのトラックを再構築する場合は、ハリケーン名をトラック フィールドとして使用できます。

インシデントの開始を示す条件式の条件を構築

式の設定を使用して条件を追加し、インシデントの内容を決定します。指定した条件が true の場合、そのフィーチャはインシデントです。終了条件を指定しない場合、開始条件が true でなくなった時点でインシデントが終了します。

たとえば、フィールド [concentration_1] と [concentration_2] の合計が [concentration_3] を上回った時点で警告を表示するとします。このためには、条件として「 ($feature["concentration_1"] + $feature["concentration_2"]) > $feature["concentration_3"])」を適用します。

時間とともに濃度がどのように変化するかに興味があり、現在の [concentration_1] が [concentration_2] の 2 つの前の計測値よりも大きい場合に警告されたい場合は、「 $feature["concentration_1"] > $track.field["concentration_2"].history(-3,-1)」のような条件式を使用できます。

インシデントの終了を示す条件式の条件を構築

オプションで、式の設定を使用して条件を追加し、インシデントの終了を決定します。指定した終了条件が true の場合、そのフィーチャはインシデントでなくなります。終了条件を指定しない場合、開始条件が true でなくなった時点でインシデントが終了します。

たとえば、フィールド [concentration_1] と [concentration_2] の合計が [concentration_3] を上回った時点で警告を表示し、 [concentration_4] が [concentration_1] を下回った時点でインシデントを終了するとします。このためには、開始条件として「 ($feature["concentration_1"] + $feature["concentration_2"]) > ($join["income"] * .20)」を適用し、終了条件として「 ($feature["concentration_4"] < $feature["concentration_1"])」を適用します。

現在の [concentration_1] および 4 つの前の計測値の平均が 1 番目の計測値よりも大きい場合にインシデントを終了したい場合は、「 $track.field["concentration_1"].history(-5) > $track.field["concentration_1"].history(0)」のような条件式を使用できます。

出力の表示方法を選択

どの出力方法でも、元のフィーチャにフィールドが追加されます。どのフィーチャを返すのかを決定するには、次の 2 つの方法があります。

  • インシデントのみを返す - この方法では、インシデントであるフィーチャのみが返されます。インシデントとして検出されないフィーチャは返されません。
  • すべてのフィーチャを返す - これがデフォルト設定です。入力内のすべてのフィーチャが返されます。

結果レイヤー名

[マイ コンテンツ] で作成され、マップに追加されるレイヤーの名前。デフォルトの名前は、ツール名と入力レイヤー名に基づいて設定されます。レイヤーがすでに存在する場合、このツールは正常に実行されません。

[出力の保存場所] ドロップダウン ボックスを使用して、結果を保存する [マイ コンテンツ] 内のフォルダーの名前を指定できます。