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 を指定した場合は、プロジェクトの確認と権限チェックのため認証します。