縮尺を設定すると、移動距離を実際の長さ（mm、cm、m）で出力できます。分析オプションの1つで、設定しなくても解析はできます。
縮尺を設定しない場合、移動距離は動画の画面上のピクセル数で出力されます。ピクセル数はカメラの位置や画角によって変わるため、別の日に撮影した動画どうしや、他の研究室のデータとは比べられません。論文や学会で移動距離を報告する場合は、縮尺を設定してください。
縮尺の仕組み
動画に写っている、長さが分かっているもの（装置の一辺、置いておいた定規など）に線を引き、その実際の長さを入力します。Be-Chaseは、画面上の線の長さと入力した長さの比から、1ピクセルが実際の何cmにあたるかを求め、移動距離を換算します。
たとえば、長さ30cmの装置の一辺に線を引くと、その線が画面上で何ピクセルあったかをもとに換算の比率が決まります。
基準にするものの選び方
換算の精度は、基準にするもので決まります。
なるべく長いものを選ぶ
線の端をどこに置くかには、どうしても数ピクセルのずれが出ます。短いものを基準にすると、そのずれが換算に大きく響きます。装置の一辺や直径など、画面の中でなるべく長く写っているものを選んでください。
ターゲットが動く面と同じ高さにあるものを選ぶ
カメラからの距離が違うと、同じ長さでも写る大きさが変わります。床面の寸法を基準にするのが確実です。装置の壁の上端などは、床より高い位置にあるため、床の上を動くターゲットの移動距離とはずれが出ます。
端がはっきり見えるものを選ぶ
線の始点と終点を正確に置けるものを選んでください。
設定の手順
1. 設定画面を開く
解析設定トップの「分析オプション設定」を押し、「縮尺」を選びます。
2. 基準にするものが写っているフレームを出す
再生ボタンやシークバーで、基準にするものがはっきり見えるフレームを表示します。
3. 線を引く
基準にするものの一方の端から、もう一方の端までドラッグして線を引きます。
画面を開いた時点で線を引ける状態になっているので、すぐにドラッグして構いません。
引き直したいときは、もう一度ドラッグします。前の線は消え、新しい線に置き換わります。引ける線は1本だけです。線の端だけを動かして調整する機能はないので、ずれたときは引き直してください。
線を引いている途中に、ポインタが動画の範囲の外へ出ても、その時点では確定しません。線はポインタの動きに追従しながら動画の端で止まり、外へははみ出しません。ボタンを離すと、動画の外で離した場合でも、その位置で確定します。
4. 実際の長さを入力する
「数値」に、線を引いたものの実際の長さを入力します。小数も入力できます（例：12.5）。
5. 単位を選ぶ
「単位」で、入力した数値の単位を選びます。mm、cm、m から選んでください。一覧の先頭にある pixel は、実際の長さに換算しない場合の単位です。pixel を選んだ場合、数値は使われません。「数値」の欄は入力できなくなり、引いた線の長さ（ピクセル数）が表示されます。数値を入れなくても保存できます。
6. 保存する
「設定する」を押します。保存されると、分析オプション設定の画面に戻ります。
一度保存した縮尺は、もう一度この画面を開くと、線・数値・単位がそのまま表示されます。
線を消す・縮尺を削除する
「縮尺の基準線をクリアする」（スマートフォンでは「クリア」）は線だけを、「設定クリア」は線・数値・単位を画面上から消します。どちらも保存されている縮尺は変わりません。線を消したあとは、そのまま動画の上でドラッグすれば、もう一度引けます。
保存されている縮尺を削除するには、「保存済みの設定を削除」を押し、確認で「削除する」を選びます。縮尺を保存しているときだけ表示されます。削除すると、移動距離はピクセル数での出力に戻ります。
保存できないとき
入力が足りない場合は、画面にその内容が表示されます。
| 表示 | 原因 |
|---|---|
| 縮尺の基準線が引かれていません。動画の上をドラッグして、基準線を引いてください。 | 線が引かれていません |
| 縮尺の基準線に長さがありません。動画の上をドラッグして、基準線を引き直してください。 | クリックしただけで、線に長さがありません |
| 縮尺の数値が入っていないか、数値ではありません。基準線の長さを数値で入力してください。 | 数値が空欄か、数値ではない文字が入っています |
| 縮尺の数値に0以下は使えません。0より大きい数値を入力してください。 | 0やマイナスの数値が入っています |
線についての表示（表の上の2つ）は画面の上部に、数値についての表示（表の下の2つ）は「数値」「単位」の欄の下に表示されます。単位が pixel のときは数値を使わないため、数値についての表示は出ません。
保存できなかった場合も、引いた線や入力した数値、選んだ単位はそのまま残ります。足りないところだけ直して、もう一度「設定する」を押してください。
そのほかの症状の対処は、うまくいかないとき（トラブルシューティング）にまとめています。
縮尺で変わるもの・変わらないもの
縮尺で mm・cm・m を選ぶと、結果ファイル trace_result.csv の長さの値が実際の長さに換算され、列名の単位の表記が変わります。たとえば cm を選んだ場合、target1(pixel) が target1(cm) になります。pixel を選んだ場合や縮尺を設定していない場合は (pixel) のままです。
換算されるのは、次の値です。
- 全体の総移動距離
- チェックエリアごとの移動距離
- チェックエリアへの出入りごとの移動距離
- 回転行動の半径・軌跡の長さの実寸値（詳細記録の単位付き列
radius(cm)・path_length(cm)と、概要のAverage Radius (cm)など） - 速さの可視化の画像の目盛り（
cm/sなど）
次のものは、縮尺を設定しても変わりません。
- 時間の値（秒）
- 回転行動の
radius_px、path_length_px、Average Radius (px)（ピクセルのまま出力されます） - 停止や回転を判定する基準
- 速さの可視化以外の画像ファイル（軌跡、ヒートマップなど）
- 座標データ（Standardプランの
trace_result_all_0.5s、Proプラン（提供開始前）のtrace_result_all）の座標は、ピクセルのまま出力されます
trace_result.csv の冒頭の Scale の行には、縮尺の係数が Scale,0.1,cm/pixel の形で入ります（1ピクセルが0.1cm、の意味）。pixel を選んだ場合や縮尺を設定していない場合は Scale,1,pixel/pixel です。ピクセルのまま出力される値は、縮尺で mm・cm・m を選んでいれば、この係数を掛けると実際の長さになります。
各値の意味は解析結果の見方で説明しています。
解析のあとで縮尺を変えたいとき
縮尺は、ターゲットの追跡そのものには影響しません。そのため、解析のあとで縮尺を設定し直したい場合は、追跡をやり直さずに条件を変えて分析し直す（再分析）で変更できます（ご契約のプランで再分析が利用できる場合）。