task_count list_by_phase#

Description#

フェーズごとのタスク数を出力します。

タスクの状態は以下の6つのカテゴリに分類されます。

never_worked.unassigned: 一度も作業していない状態かつ担当者未割り当て
never_worked.assigned: 一度も作業していない状態かつ担当者割り当て済み
worked.not_rejected: 作業中または休憩中で、まだ差し戻されていない（次のフェーズに進んでいない）
worked.rejected: 作業中または休憩中で、差し戻された（次のフェーズに進んだ）
on_hold: 保留中
complete: 完了

Examples#

基本的な使い方#

以下のコマンドで、フェーズごとのタスク数を出力します。

$ annofabcli task_count list_by_phase --project_id prj1 --output out.csv

phase	never_worked.unassigned	never_worked.assigned	worked.not_rejected	worked.rejected	on_hold	complete
annotation	10	5	8	2	1	74
inspection	0	0	12	3	0	85
acceptance	0	0	8	0	0	92

メタデータキーでグループ化#

--metadata_key でメタデータのキーを指定すると、そのキーの値でグループ化して集計します。

$ annofabcli task_count list_by_phase --project_id prj1 --metadata_key dataset_type --output out.csv

phase	metadata.dataset_type	never_worked.unassigned	never_worked.assigned	worked.not_rejected	worked.rejected	on_hold	complete
annotation	train	8	3	5	1	1	42
annotation	validation	2	2	3	1	0	32
inspection	train	0	0	8	2	0	48
inspection	validation	0	0	4	1	0	37
acceptance	train	0	0	5	0	0	53
acceptance	validation	0	0	3	0	0	39

入力データ数で集計#

--unit input_data_count を指定すると、タスク数ではなく入力データ数で集計します。

$ annofabcli task_count list_by_phase --project_id prj1 --unit input_data_count --output out.csv

phase	never_worked.unassigned	never_worked.assigned	worked.not_rejected	worked.rejected	on_hold	complete
annotation	15	8	12	3	2	110
inspection	0	0	18	5	0	127
acceptance	0	0	12	0	0	138

動画の長さ（時間）で集計#

--unit video_duration_hour を指定すると、動画プロジェクトにおいて動画の長さ（時間単位）で集計します。このオプションは動画プロジェクトでのみ使用できます。

$ annofabcli task_count list_by_phase --project_id prj1 --unit video_duration_hour --output out.csv

phase	never_worked.unassigned	never_worked.assigned	worked.not_rejected	worked.rejected	on_hold	complete
annotation	2.5	1.8	3.2	0.6	0.4	18.5
inspection	0	0	4.2	1.1	0	22.7
acceptance	0	0	2.8	0	0	27.2

作業時間の閾値を指定#

--not_worked_threshold_second を指定すると、指定した秒数以下の作業時間のタスクを「作業していない」とみなします。デフォルトは0秒です。

$ annofabcli task_count list_by_phase --project_id prj1 --not_worked_threshold_second 60 --output out.csv

この例では、60秒以下の作業時間のタスクは never_worked.assigned または never_worked.unassigned に分類されます。

Usage Details#

フェーズごとにタスク数や入力データ数などを集計し、CSV形式で出力します。

usage: annofabcli task_count list_by_phase [-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
                                           [--execute_get_tasks_api]
                                           [--temp_dir TEMP_DIR]
                                           [--not_worked_threshold_second NOT_WORKED_THRESHOLD_SECOND]
                                           [--metadata_key METADATA_KEY [METADATA_KEY ...]]
                                           [--unit {task_count,input_data_count,video_duration_hour,video_duration_minute}]
                                           [-o OUTPUT]

Named Arguments#

-p, --project_id

対象のプロジェクトのproject_idを指定します。

--execute_get_tasks_api

タスク全件ファイルをダウンロードせずに、getTasks APIを実行してタスク一覧を取得します。getTasks APIを複数回実行するので、タスク全件ファイルをダウンロードするよりも時間がかかります。

--temp_dir

指定したディレクトリに、一時ファイルをダウンロードします。

--not_worked_threshold_second

作業していないとみなす作業時間の閾値を秒単位で指定します。この値以下の作業時間のタスクは、作業していないとみなします。

Default: 0

--metadata_key

集計対象のメタデータキーを指定します。指定したキーの値でグループ化してタスク数を集計します。

--unit

Possible choices: task_count, input_data_count, video_duration_hour, video_duration_minute

集計の単位を指定します。task_count: タスク数、input_data_count: 入力データ数、video_duration_hour: 動画の長さ（時間）、video_duration_minute: 動画の長さ（分）。

Default: 'task_count'

-o, --output

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

global optional arguments#

--yes

処理中に現れる問い合わせに対して、常に yes と回答します。

--endpoint_url

Annofab WebAPIのエンドポイントを指定します。

Default: 'https://annofab.com'

--annofab_user_id

Annofabにログインする際のユーザーID

--annofab_password

Annofabにログインする際のパスワード

--annofab_pat

Annofabにログインする際のパーソナルアクセストークン

--logdir

ログファイルを保存するディレクトリを指定します。

Default: .log

--disable_log

ログを無効にします。

--debug

HTTPリクエストの内容やレスポンスのステータスコードなど、デバッグ用のログが出力されます。

オーナロールまたはアノテーションユーザーロールを持つユーザで実行してください。