task list_video_duration#

Description#

タスクごとの動画長を出力します。入力データを共有するタスクも、それぞれ1件として出力します。 タスクで使われていない入力データは出力しません。

task list と同じく、タスクの属性は phase 、 phase_stage 、 status で出力します。 video_duration_second の単位は秒です。 入力データが見つからない場合や動画長が不明な場合は、JSONでは null 、CSVでは空欄になります。 JSONはタスクごとの平坦なオブジェクトの配列で、欠損時もキーを省略しません。 0件の場合はCSVのヘッダーのみ、JSONでは [] を出力します。 1タスクに入力データが1件ある動画タスクを対象にします。それ以外はエラーになります。

Examples#

$ annofabcli task list_video_duration --project_id prj1 --output out.csv
$ annofabcli task list_video_duration --task_json_file task.json --input_data_json_file input_data.json \
    --task_id task1 task2 --format pretty_json --output out.json

出力結果#

out.csv#

project_id

task_id

phase

phase_stage

status

input_data_id

input_data_name

video_duration_second

input_data_updated_datetime

project1

task1

acceptance

1

complete

video1

video1.mp4

10.0

2024-10-04T09:18:02.416+09:00

project1

task2

annotation

1

not_started

missing

[
  {
    "project_id": "project1",
    "task_id": "task1",
    "phase": "acceptance",
    "phase_stage": 1,
    "status": "complete",
    "input_data_id": "video1",
    "input_data_name": "video1.mp4",
    "video_duration_second": 10.0,
    "input_data_updated_datetime": "2024-10-04T09:18:02.416+09:00"
  },
  {
    "project_id": "project1",
    "task_id": "task2",
    "phase": "annotation",
    "phase_stage": 1,
    "status": "not_started",
    "input_data_id": "missing",
    "input_data_name": null,
    "video_duration_second": null,
    "input_data_updated_datetime": null
  }
]

分布の表示には task visualize_video_duration を使用してください。

旧コマンドからの移行#

statistics list_video_duration は非推奨です。 旧コマンドの task_phase 、 task_phase_stage 、 task_status は、 新コマンドでは phase 、 phase_stage 、 status になります。 旧コマンドは不明な動画長を0で出力しますが、新コマンドでは欠損値として出力します。 input_data_updated_datetime は新コマンドでは常にJSONに含まれます。

Usage Details#

各タスクの動画の長さを出力します。

usage: annofabcli task list_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 ...]]
                                           [-f {csv,json,pretty_json}]
                                           [-o OUTPUT]

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個だけ渡してください。直接指定する値や別のファイル指定とは併用できません。

-f, --format

Possible choices: csv, json, pretty_json

出力フォーマットを指定します。

Default: 'csv'

-o, --output

出力先のファイルパスを指定します。未指定の場合は、標準出力に出力されます。

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