UMATracker Manual

DetectCenterの使いかた

DetectCenterでは、FilterGeneratorで作ったフィルタを使って、トラッキングアルゴリズムを動作させる。この工程で物体追跡を行う。作ったフィルタの精度（追跡したい物体のみが白くなっているか）がトラッキングの正確をあれする。上手く追跡出来無いなら、もう一度フィルタを作り直すか、トラッキングパラメータを見直す。又は、次の工程で、人力で追跡補正を行う。

DetectCenterの画面

DetectCenter起動画面
  1. トラッキング結果

    2. 入力した画像とトラッキング結果を表示する。

  2. トラッキングパラメータ

    3. トラッキングで使用する値を変更する。個体数や、動物の大きさを設定する。

  3. 表示点の大きさ

    4. Radiusは、表示点の大きさ。Line Widthは、軌跡の幅。of overlay数でいくつのフレームの軌跡を描画するかを決定する。これらの値は、トラッキングアルゴリズムに関係ないので、変更しても精度の向上には繋らない。

  4. Algorithms（トラッキングアルゴリズム選択）

    5. UMATrackerは、複数のトラッキングアルゴリズムを選択し、使える。ここで、Group Tracker GMM、RMOTを選択できる。デフォルトでは、Group Tracker GMMが選択されている。

  5. File(ファイル)

    6. フィルタの読込・ビデオデータの読み込み。トラッキングした座標をCSVに保存する。

動画を読み込む

DetectCenterでは、最初に動画を読み込む。

DetectCenter動画の読込

フィルタを読み込む

次に、FilterGeneratorで作ったフィルタを読み込ませる。

DetectCenterフィルタの読込

パラメータ設定

次に、トラッキングアルゴリズムを使う際に必要となる数値を設定する。何れか一つを選択し、設定すればよい。

GroupTracker GMMの設定

トラッキングアルゴリズムGroupTracker

Group Tracker GMMを選択（デフォルト）すると、上の様な画面がWindow内の"トラッキングパラメータ"の部分に表示される。

  1. #of objects

    2. 追跡したい物体の数を入力する。動画内に移っている個体数を入力すればいい。

  2. #of k-means

    3. 基本的に#of objectsと同じ数を入力する。

  3. Likelihood diff. threshold

    4. 前フレームとの形の変化度が規定数値以下の場合は同じ物体だとみなさない。ここの数値は経験(Try&Error)によって変化させる。

  4. Restart from this frame

    5. 現在のフレームからトラッキングをスタートさせる。動画の途中で、追跡したい物体が増えた場合に使用する。個体が増えたフレームで一時停止を行い、"#of object"の数値を変化させ、再び再生ボタンをおすと、上手くトラッキングしてくれる。

    現在表示しているフレーム以降でトラッキングアルゴリズムを再起動するボタン。このボタンを押したあとにトラッキングアルゴリズムを動作させた場合、それ以降のフレームに存在する既存のデータは上書きされる。

  5. Set/Reset

    6. 一番初めに、パラメータを設定した後におすボタン。

RMOTの設定

トラッキングアルゴリズムRMOT

RMOTを選択すると、上の様な画面がWindow内の"トラッキングパラメータ"の部分に表示される。

  1. #of objects

    2. GroupTracker GMMと同じ

  2. #of k-means

    3. GroupTracker GMMと同じ

  3. Window Width
  4. Window Height

    5. 物体の倍程度を囲む様に調整をおこなう。この値は、経験をつんで、変化させていく。

  5. Restart from this frame

    6. GroupTracker GMMと同じ

  6. Set/Reset

    7. GroupTracker GMMと同じ

トラッキングアルゴリズムを動かす

動かしかた

トラッキングアルゴリズムを動作させる。

1.現在"トラッキング結果"画面に表示されているフレームからトラッキングを行うなら、

  1. "Restart fomr this frame"ボタンを押しす。
  2. "再生"ボタンまたは、"Run >> Run Object Trackine"ボタンを押す。
前者の場合、トラッキングアルゴリズムを動作させながら、"トラッキング結果"画面にトラッキング点を描画しながらアルゴリズムが動作する。後者の場合、結果を見ないでトラッキングアルゴリズムが動作する。前者に比べて後者の方が早く動作する。

2.最初のフレームからトラッキングアルゴリズムを動作させたいなら、

  1. "Set/Reset"ボタンを押しす
  2. "再生"ボタンまたは、"Run >> Run Object Trackine"ボタンを押す。

トラッキング点を修正した後にトラッキングアルゴリズムを動作させる方法

"トラッキング結果"の画面に表示されているポイントは全て動かすことができる。ここで動かすのは、この後のフレームでトラキング結果を自動変更する場合である。つまり、ポイントを移動した後、トラッキングアルゴリズムを再び動作させると、上手く追跡し続けてくれるケースが存在する。その方法を記述する。

  1. 著しく移動しているポイントを修正する
  2. "Restart from this frame"ボタンを押す
  3. 動画を再生するor"Run >> Run Object Tracking"を選択
次の工程でミストラッキングを手動で修正するのだが、この工程で以上のように一部のフレームを修正することで、修正回数を減らすことができる。

以下の機能は存在しません。

個体数が変動する場合

前述したが、動画の途中で、個体数が変動する場合、トラッキングアルゴリズムは上手く動作しない(GroupTracker GMM、RMOTの場合)。これは、デフォルトのトラッキングアルゴリズムは個体数を決定した上で上手く動作するアルゴリズムだからである。

個体数の変動がおきた場合、

  1. 一時停止ボタンをおす
  2. パラメータの"#of objects"を変化させる
  3. その後再び、トラッキングアルゴリズムを動作させる

上手くトラッキングを続けられる。

トラッキング結果の保存

トラッキングアルゴリズムを動かした後は、結果を保存する。この工程をやらなければ、結果は得られない。"File >> Save to CSV"を選択し、保存したいディレクトリとファイル名をしていする。

出力結果は、CSV形式で保存される。最初の行には、x0,y0,x1,y1。次からの行には、フレームナンバー、個体ナンバー0のx座標、個体ナンバー0のy座標、個体ナンバー1のx座標、個体ナンバー1のy座標。。。が保存されている。

DetectCenterの結果保存
DetectCenterの結果CSV

失敗例と対処方法