task visualize_video_duration#
Description#
タスクの動画長の分布をヒストグラムで可視化します。 タスクごとに1件として数えます。同じ入力データを2タスクが参照する場合は2件として数えます。タスク未使用の入力データは含めません。
動画長が不明なタスクは除外し、除外件数をHTMLに表示します。 対象0件の場合もHTMLを出力します。横軸は動画長、縦軸はタスク数です。
Examples#
$ annofabcli task visualize_video_duration --project_id prj1 --output out.html
$ annofabcli task visualize_video_duration --project_id prj1 --task_id task1 task2 \
--time_unit minute --bin_width 60 --output out2.html
--task_json_file と --input_data_json_file を指定すると、--project_id を省略できます。
1タスクに入力データが1件ある動画タスクを対象にします。それ以外はエラーになります。
--from_date と --to_date は入力データの更新日で絞り込みます。
更新日時に記載されたタイムゾーンの日付で比較し、指定日当日を含みます。
--bin_width は横軸の表示単位にかかわらず秒で指定します。
出力結果#
出力HTMLの例 を参照してください。
10秒の入力データを2タスクが参照し、未使用の20秒の入力データがある例です。
10秒のタスクが2件として表示され、未使用の20秒の入力データは集計対象に含まれません。
関連コマンド#
一覧の取得には task list_video_duration を使用してください。
旧コマンド statistics visualize_video_duration は非推奨です。
旧コマンドは入力データ単位で集計するため、タスク未使用の入力データも含め、共有する入力データを1回数えます。
新コマンドはタスク単位で集計するため、未使用の入力データを含めず、共有する入力データをタスクごとに数えます。
新コマンドでは不明な動画長を除外し、--to_date は指定日全体を含みます。
Usage Details#
タスクごとの動画の長さをヒストグラムで可視化します。同じ入力データもタスクごとに数えます。
usage: annofabcli task visualize_video_duration [-h] [--yes]
[--endpoint_url ENDPOINT_URL]
[--annofab_user_id ANNOFAB_USER_ID]
[--annofab_password ANNOFAB_PASSWORD]
[--annofab_pat ANNOFAB_PAT]
[--logdir LOGDIR]
[--disable_log] [--debug]
[-p PROJECT_ID]
[--input_data_json_file INPUT_DATA_JSON_FILE]
[--task_json_file TASK_JSON_FILE]
[--latest]
[--temp_dir TEMP_DIR]
[-t TASK_ID [TASK_ID ...]]
-o OUTPUT
[-i INPUT_DATA_ID [INPUT_DATA_ID ...]]
[--time_unit {second,minute}]
[--bin_width BIN_WIDTH]
[--from_date FROM_DATE]
[--to_date TO_DATE]
Named Arguments#
- -p, --project_id
対象の動画プロジェクトID。必要なJSONファイルをすべて指定した場合は省略できます。
- --input_data_json_file
input_data downloadで取得した入力データのJSONファイル。
- --task_json_file
task downloadで取得したタスクのJSONファイル。
- --latest
入力データ情報とタスク情報の最新版を取得します。数分待つ場合があります。
- --temp_dir
JSONファイルをダウンロードするディレクトリ。
- -t, --task_id
対象タスクID。file://でID一覧ファイルを指定できます。 ファイルを読み込む場合は、ファイル指定を1個だけ渡してください。直接指定する値や別のファイル指定とは併用できません。
- -o, --output
出力先HTMLファイル。
- -i, --input_data_id
対象入力データID。file://でID一覧ファイルを指定できます。 ファイルを読み込む場合は、ファイル指定を1個だけ渡してください。直接指定する値や別のファイル指定とは併用できません。
- --time_unit
Possible choices: second, minute
横軸の時間単位。
Default:
'second'- --bin_width
ビンの幅(秒)。省略すると20個のビンを使用します。正の値を指定してください。
- --from_date
この日以降に更新された入力データを対象にします(YYYY-MM-DD、当日を含む)。
- --to_date
この日以前に更新された入力データを対象にします(YYYY-MM-DD、当日を含む)。
common options (after the subcommand)#
- --yes
処理中に現れる問い合わせに対して、常に
yesと回答します。- --endpoint_url
Annofab WebAPIのエンドポイントを指定します。
- --annofab_user_id
Annofabにログインする際のユーザーID
- --annofab_password
Annofabにログインする際のパスワード
- --annofab_pat
Annofabにログインする際のパーソナルアクセストークン
- --logdir
ログファイルを保存するディレクトリを指定します。
Default:
.log- --disable_log
ログを無効にします。
- --debug
HTTPリクエストの内容やレスポンスのステータスコードなど、デバッグ用のログが出力されます。
オーナロールまたはアノテーションユーザロールを持つユーザで実行してください。
必要なローカルファイルを指定し、--project_id を省略した場合は、Annofabへの認証を行いません。
--project_id を指定した場合は、プロジェクトの確認と権限チェックのため認証します。