statistics visualize: 折れ線グラフを生産量別に指標を変更できるようにしました。 (#1661)

yuji38kwmt · web-flow · commit cd82765ba366 · 2026-06-21T15:52:50.000+09:00
* Make cumulative line graph production volume selectable

* Add HTML documentation for cumulative line graphs and productivity metrics

- Created new HTML documentation for visualizing production volume metrics with a focus on cumulative line graphs for annotators and their productivity trends.
- Added tests for plotting production volume metrics with selectors to ensure the correct generation of HTML files.
- Updated existing test cases to reflect changes in output file names and content checks.

* 生産量種別を切り替えられる折れ線グラフの出力機能を追加し、関連するHTMLドキュメントを作成しました。

* 生産量種別をセレクトボックスで切り替えられる機能をテストに追加

* 生産量種別のセレクトボックスに対応する折れ線グラフの生成メソッドを修正し、ツールチップ列を適切に設定するテストを追加

* tooltip_columnsの名前を変更し、折れ線グラフのテストを更新

* 作業時間グラフのツールチップ列を合計作業時間と生産量あたり作業時間に分割し、関連するメソッドを追加
diff --git a/annofabcli/statistics/visualization/dataframe/cumulative_productivity.py b/annofabcli/statistics/visualization/dataframe/cumulative_productivity.py
diff --git a/annofabcli/statistics/visualization/dataframe/productivity_per_date.py b/annofabcli/statistics/visualization/dataframe/productivity_per_date.py
diff --git a/annofabcli/statistics/visualization/project_dir.py b/annofabcli/statistics/visualization/project_dir.py
@@ -141,31 +141,12 @@ def write_cumulative_line_graph(
 
         phase_name = self.get_phase_name_for_filename(phase)
 
-        obj.plot_production_volume_metrics(
-            production_volume_column="annotation_count",
-            production_volume_name="アノテーション数",
-            output_file=output_dir / f"{phase_name}者用/累積折れ線-横軸_アノテーション数-{phase_name}者用.html",
+        obj.plot_production_volume_metrics_with_selector(
+            output_file=output_dir / f"{phase_name}者用/累積折れ線-横軸_生産量-{phase_name}者用.html",
             target_user_id_list=user_id_list,
             metadata=self.metadata,
+            include_input_data_count=not minimal_output,
         )
-        for custom_production_volume in obj.custom_production_volume_list:
-            obj.plot_production_volume_metrics(
-                production_volume_column=custom_production_volume.value,
-                production_volume_name=custom_production_volume.name,
-                output_file=output_dir / f"{phase_name}者用/累積折れ線-横軸_{custom_production_volume.name}-{phase_name}者用.html",
-                target_user_id_list=user_id_list,
-                metadata=self.metadata,
-            )
-
-        if not minimal_output:
-            # アノテーション単位より大きい単位の折れ線グラフは不要かもしれないので、オプションにした
-            obj.plot_production_volume_metrics(
-                production_volume_column="input_data_count",
-                production_volume_name="入力データ数",
-                output_file=output_dir / f"{phase_name}者用/累積折れ線-横軸_入力データ数-{phase_name}者用.html",
-                target_user_id_list=user_id_list,
-                metadata=self.metadata,
-            )
 
     def write_performance_per_started_date_csv(self, obj: AbstractPhaseProductivityPerDate, phase: TaskPhase) -> None:
         """
@@ -180,28 +161,11 @@ def write_performance_line_graph_per_date(self, obj: AbstractPhaseProductivityPe
         """
         output_dir = self.project_dir / "line-graph"
         phase_name = self.get_phase_name_for_filename(phase)
-        obj.plot_production_volume_metrics(
-            production_volume_column="annotation_count",
-            production_volume_name="アノテーション",
-            output_file=output_dir / Path(f"{phase_name}者用/折れ線-横軸_{phase_name}開始日-縦軸_アノテーション単位の指標-{phase_name}者用.html"),
+        obj.plot_production_volume_metrics_with_selector(
+            output_file=output_dir / Path(f"{phase_name}者用/折れ線-横軸_{phase_name}開始日-縦軸_生産量単位の指標-{phase_name}者用.html"),
             target_user_id_list=user_id_list,
             metadata=self.metadata,
         )
-        obj.plot_production_volume_metrics(
-            production_volume_column="input_data_count",
-            production_volume_name="入力データ",
-            output_file=output_dir / Path(f"{phase_name}者用/折れ線-横軸_{phase_name}開始日-縦軸_入力データ単位の指標-{phase_name}者用.html"),
-            target_user_id_list=user_id_list,
-            metadata=self.metadata,
-        )
-        for custom_production_volume in obj.custom_production_volume_list:
-            obj.plot_production_volume_metrics(
-                production_volume_column=custom_production_volume.value,
-                production_volume_name=custom_production_volume.name,
-                output_file=output_dir / Path(f"{phase_name}者用/折れ線-横軸_{phase_name}開始日-縦軸_{custom_production_volume.name}単位の指標-{phase_name}者用.html"),
-                target_user_id_list=user_id_list,
-                metadata=self.metadata,
-            )
 
     def read_whole_performance(self) -> WholePerformance:
         """`全体の生産性と品質.csv`を読み込む。"""
diff --git a/docs/command_reference/stat_visualization/mask_user_info.rst b/docs/command_reference/stat_visualization/mask_user_info.rst
@@ -77,8 +77,8 @@ Examples
 
     masked_out
     ├── line-graph
-    │   ├── 累積折れ線-横軸_アノテーション数-教師付者用.html
-    │   └── 累積折れ線-横軸_アノテーション数-受入者用.html
+    │   ├── 累積折れ線-横軸_生産量-教師付者用.html
+    │   └── 累積折れ線-横軸_生産量-受入者用.html
     ├── scatter
     │   ├── 散布図-生産量あたり作業時間と品質の関係-教師付者用.html
     │   ├── 散布図-生産量あたり作業時間と累計作業時間の関係.html
diff --git a/docs/command_reference/stat_visualization/merge.rst b/docs/command_reference/stat_visualization/merge.rst
@@ -44,8 +44,8 @@ Examples
 
     merge_dir
     ├── line-graph
-    │   ├── 累積折れ線-横軸_アノテーション数-教師付者用.html
-    │   └── 累積折れ線-横軸_アノテーション数-受入者用.html
+    │   ├── 累積折れ線-横軸_生産量-教師付者用.html
+    │   └── 累積折れ線-横軸_生産量-受入者用.html
     ├── scatter
     │   ├── 散布図-生産量あたり作業時間と品質の関係-教師付者用.html
     │   ├── 散布図-生産量あたり作業時間と累計作業時間の関係.html
diff --git a/docs/command_reference/stat_visualization/write_graph.rst b/docs/command_reference/stat_visualization/write_graph.rst
@@ -30,21 +30,14 @@ Examples
     │   └── ヒストグラム.html
     ├── line-graph
     │   ├── 教師付者用
-    │   │   ├── 折れ線-横軸_教師付開始日-縦軸_アノテーション単位の指標-教師付者用.html
-    │   │   ├── 折れ線-横軸_教師付開始日-縦軸_入力データ単位の指標-教師付者用.html
-    │   │   ├── 累積折れ線-横軸_アノテーション数-教師付者用.html
-    │   │   ├── 累積折れ線-横軸_タスク数-教師付者用.html
-    │   │   └── 累積折れ線-横軸_入力データ数-教師付者用.html
+    │   │   ├── 折れ線-横軸_教師付開始日-縦軸_生産量単位の指標-教師付者用.html
+    │   │   └── 累積折れ線-横軸_生産量-教師付者用.html
     │   ├── 検査者用
-    │   │   ├── 折れ線-横軸_検査開始日-縦軸_アノテーション単位の指標-検査者用.html
-    │   │   ├── 折れ線-横軸_検査開始日-縦軸_入力データ単位の指標-検査者用.html
-    │   │   ├── 累積折れ線-横軸_アノテーション数-検査者用.html
-    │   │   └── 累積折れ線-横軸_入力データ数-検査者用.html
+    │   │   ├── 折れ線-横軸_検査開始日-縦軸_生産量単位の指標-検査者用.html
+    │   │   └── 累積折れ線-横軸_生産量-検査者用.html
     │   ├── 受入者用
-    │   │   ├── 折れ線-横軸_受入開始日-縦軸_アノテーション単位の指標-受入者用.html
-    │   │   ├── 折れ線-横軸_受入開始日-縦軸_入力データ単位の指標-受入者用.html
-    │   │   ├── 累積折れ線-横軸_アノテーション数-受入者用.html
-    │   │   └── 累積折れ線-横軸_入力データ数-受入者用.html
+    │   │   ├── 折れ線-横軸_受入開始日-縦軸_生産量単位の指標-受入者用.html
+    │   │   └── 累積折れ線-横軸_生産量-受入者用.html
     │   ├── 折れ線-横軸_教師付開始日-全体.html
     │   ├── 折れ線-横軸_日-全体.html
     │   ├── 累積折れ線-横軸_日-縦軸_作業時間.html
@@ -54,6 +47,8 @@ Examples
         ├── 散布図-生産量あたり作業時間と累計作業時間の関係.html
         └── 散布図-教師付者の品質と作業量の関係.html
 
+``累積折れ線-横軸_生産量-*.html`` では、生産量種別をセレクトボックスで切り替えられます。
+また、``折れ線-横軸_*開始日-縦軸_生産量単位の指標-*者用.html`` でも、生産量種別をセレクトボックスで切り替えられます。
 
 
 Usage Details
@@ -68,5 +63,3 @@ Usage Details
 See also
 =================================
 * `annofabcli statistics visualize <../statistics/visualize.html>`_
-
-
diff --git a/docs/command_reference/statistics/visualize.rst b/docs/command_reference/statistics/visualize.rst
@@ -283,9 +283,9 @@ CSVには以下の列が存在している必要があります。
     ├── project_info.json
     ├── line-graph
     │   ├── 教師付者用
-    │   │   └── 累積折れ線-横軸_アノテーション数-教師付者用.html
+    │   │   └── 累積折れ線-横軸_生産量-教師付者用.html
     │   ├── 受入者用
-    │   │   └── 累積折れ線-横軸_アノテーション数-受入者用.html
+    │   │   └── 累積折れ線-横軸_生産量-受入者用.html
     │   ├── 折れ線-横軸_教師付開始日-全体.html
     │   ├── 折れ線-横軸_日-全体.html
     │   ├── 累積折れ線-横軸_日-縦軸_作業時間.html
@@ -321,8 +321,8 @@ CSVには以下の列が存在している必要があります。
    visualize_output_rst/折れ線-横軸_日-全体_html.rst
    visualize_output_rst/累積折れ線-横軸_日-全体_html.rst
    visualize_output_rst/折れ線-横軸_教師付開始日-全体_html.rst
-   visualize_output_rst/累積折れ線-横軸_アノテーション数-phase者用_html.rst
-   visualize_output_rst/折れ線-横軸_教師付開始日-縦軸_アノテーション単位の指標-phase用.html
+   visualize_output_rst/累積折れ線-横軸_生産量-phase者用_html.rst
+   visualize_output_rst/折れ線-横軸_phase開始日-縦軸_生産量単位の指標-phase者用_html.rst
    visualize_output_rst/累積折れ線-横軸_日-縦軸_作業時間_html.rst
 
    visualize_output_rst/散布図-生産量あたり作業時間と品質の関係-教師付者用_html.rst
diff --git a/docs/command_reference/statistics/visualize/out_dir/line-graph/折れ線-横軸_教師付開始日-縦軸_生産量単位の指標-教師付者用.html b/docs/command_reference/statistics/visualize/out_dir/line-graph/折れ線-横軸_教師付開始日-縦軸_生産量単位の指標-教師付者用.html
@@ -2,7 +2,7 @@
 <html lang="en">
   <head>
     <meta charset="utf-8">
-    <title>折れ線-横軸_教師付開始日-縦軸_アノテーション単位の指標-教師付者用</title>
+    <title>折れ線-横軸_教師付開始日-縦軸_生産量単位の指標-教師付者用</title>
     <style>
       html, body {
         box-sizing: border-box;
diff --git a/docs/command_reference/statistics/visualize/out_dir/line-graph/累積折れ線-横軸_生産量-受入者用.html b/docs/command_reference/statistics/visualize/out_dir/line-graph/累積折れ線-横軸_生産量-受入者用.html
@@ -8,7 +8,7 @@
   <head>
     
       <meta charset="utf-8">
-      <title>累積折れ線-横軸_アノテーション数-受入者用</title>
+      <title>累積折れ線-横軸_生産量-受入者用</title>
       
       
         
diff --git a/docs/command_reference/statistics/visualize/out_dir/line-graph/累積折れ線-横軸_生産量-教師付者用.html b/docs/command_reference/statistics/visualize/out_dir/line-graph/累積折れ線-横軸_生産量-教師付者用.html
@@ -8,7 +8,7 @@
   <head>
     
       <meta charset="utf-8">
-      <title>累積折れ線-横軸_アノテーション数-教師付者用</title>
+      <title>累積折れ線-横軸_生産量-教師付者用</title>
       
       
         
diff --git a/docs/command_reference/statistics/visualize_output_rst/折れ線-横軸_phase開始日-縦軸_生産量単位の指標-phase者用_html.rst b/docs/command_reference/statistics/visualize_output_rst/折れ線-横軸_phase開始日-縦軸_生産量単位の指標-phase者用_html.rst
@@ -1,8 +1,9 @@
 ========================================================================================================================================================================
-line-graph/{phase}/折れ線-横軸_教師付開始日-縦軸_アノテーション単位の指標-{phase}用.html
+line-graph/{phase}/折れ線-横軸_{phase}開始日-縦軸_生産量単位の指標-{phase}用.html
 ========================================================================================================================================================================
 
-横軸がフェーズの開始日、縦軸がアノテーション単位の指標（作業時間、指摘数など）の折れ線グラフです。ユーザーごとにプロットされます。
+横軸がフェーズの開始日、縦軸が生産量単位の指標（作業時間、指摘数など）の折れ線グラフです。ユーザーごとにプロットされます。
+生産量種別をセレクトボックスで切り替えられます。
 
 フェーズごとにhtmlファイルは出力されます。
 
@@ -13,12 +14,11 @@ line-graph/{phase}/折れ線-横軸_教師付開始日-縦軸_アノテーショ
 
 .. image:: ../visualize/img/教師付開始日ごとのアノテーションあたり計測作業時間.png
 
-`累積折れ線-横軸_アノテーション数-教師付者用.htmlのサンプル <https://kurusugawa-computer.github.io/annofab-cli/command_reference/statistics/visualize/out_dir/line-graph/折れ線-横軸_教師付開始日-縦軸_アノテーション単位の指標-教師付者用.html>`_
+`折れ線-横軸_教師付開始日-縦軸_生産量単位の指標-教師付者用.htmlのサンプル <https://kurusugawa-computer.github.io/annofab-cli/command_reference/statistics/visualize/out_dir/line-graph/折れ線-横軸_教師付開始日-縦軸_生産量単位の指標-教師付者用.html>`_
 
 
 .. note::
 
     複数人で同じあタスクの同じフェーズを作業した場合、ユーザーごとの作業時間で按分した値を生産量や指摘数として算出します。
     たとえば、task1の教師付フェーズの作業にユーザーAが45分、ユーザーBが15分かかったとします。その場合、「ユーザーAはtask1を0.75個、ユーザーBはtask1を0.25個のタスクを作業した」とみなします。
     
-
diff --git a/docs/command_reference/statistics/visualize_output_rst/累積折れ線-横軸_生産量-phase者用_html.rst b/docs/command_reference/statistics/visualize_output_rst/累積折れ線-横軸_生産量-phase者用_html.rst
@@ -1,16 +1,17 @@
 ====================================================================================
-line-graph/{phase}/累積折れ線-横軸_アノテーション数-{phase}者用.html
+line-graph/{phase}/累積折れ線-横軸_生産量-{phase}者用.html
 ====================================================================================
 
-作業したタスクに含まれているアノテーション数の累積値と、作業時間などの累積値をタスクごとにプロットした折れ線グラフです。
+作業したタスクに含まれている生産量の累積値と、作業時間などの累積値をタスクごとにプロットした折れ線グラフです。
 フェーズごとにhtmlファイルは出力されます。
+生産量種別は、HTML内のセレクトボックスで切り替えられます。
 
 グラフのデータは :doc:`task-worktime-list-by-user-phase_csv` を参照しています。
 
 このグラフでは、ユーザーごとの生産性と品質の習熟傾向を確認できます。
 
 
-`累積折れ線-横軸_アノテーション数-教師付者用.htmlのサンプル <https://kurusugawa-computer.github.io/annofab-cli/command_reference/statistics/visualize/out_dir/line-graph/%E7%B4%AF%E7%A9%8D%E6%8A%98%E3%82%8C%E7%B7%9A-%E6%A8%AA%E8%BB%B8_%E3%82%A2%E3%83%8E%E3%83%86%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E6%95%B0-%E6%95%99%E5%B8%AB%E4%BB%98%E8%80%85%E7%94%A8.html>`_
+`累積折れ線-横軸_生産量-教師付者用.htmlのサンプル <https://kurusugawa-computer.github.io/annofab-cli/command_reference/statistics/visualize/out_dir/line-graph/累積折れ線-横軸_生産量-教師付者用.html>`_
 
 
 .. note::
@@ -49,4 +50,3 @@ line-graph/{phase}/累積折れ線-横軸_アノテーション数-{phase}者用
     1個のタスクに同じ内容の指摘を複数回受けた場合、本来の品質より悪く評価される場合があります。
     また軽微な指摘も重大な指摘も「同じレベルの指摘」として扱っているため、正しく品質を評価するには、指摘の中身まで確認した方が良い場合もあります。
 
-
diff --git a/tests/statistics/visualization/dataframe/test_cumulative_productivity.py b/tests/statistics/visualization/dataframe/test_cumulative_productivity.py
@@ -6,6 +6,7 @@
     InspectorCumulativeProductivity,
 )
 from annofabcli.statistics.visualization.dataframe.task_worktime_by_phase_user import TaskWorktimeByPhaseUser
+from annofabcli.statistics.visualization.model import ProductionVolumeColumn
 
 output_dir = Path("./tests/out/statistics/visualization/dataframe/cumulative_productivity")
 data_dir = Path("./tests/data/statistics")
@@ -20,6 +21,30 @@ def test_plot_production_volume_metrics(self):
         assert len(obj.df) == 2
         obj.plot_production_volume_metrics("annotation_count", "アノテーション数", output_dir / "累積折れ線-横軸_アノテーション数-教師付者用.html")
 
+    def test_plot_production_volume_metrics_with_selector(self, tmp_path: Path):
+        task_worktime_by_phase_user = TaskWorktimeByPhaseUser.from_csv(
+            data_dir / "task-worktime-by-user-phase.csv",
+            custom_production_volume_list=[
+                ProductionVolumeColumn("custom_production_volume1", "custom_生産量1"),
+                ProductionVolumeColumn("custom_production_volume2", "custom_生産量2"),
+            ],
+        )
+
+        obj = AnnotatorCumulativeProductivity.from_df_wrapper(task_worktime_by_phase_user)
+        output_file = tmp_path / "累積折れ線-横軸_生産量-教師付者用.html"
+        obj.plot_production_volume_metrics_with_selector(output_file)
+
+        html = output_file.read_text(encoding="utf-8")
+        assert '"name":"Select"' in html
+        assert "xAxisList" in html
+        assert "cumulative_annotation_count" in html
+        assert "cumulative_input_data_count" in html
+        assert "cumulative_custom_production_volume1" in html
+        assert "cumulative_custom_production_volume2" in html
+        assert '["input_data_count","@{input_data_count}"]' in html
+        assert '["custom_production_volume1","@{custom_production_volume1}"]' in html
+        assert '["custom_production_volume2","@{custom_production_volume2}"]' in html
+
 
 class TestInspectorCumulativeProductivity:
     def test_plot_production_volume_metrics(self):
diff --git a/tests/statistics/visualization/dataframe/test_productivity_per_date.py b/tests/statistics/visualization/dataframe/test_productivity_per_date.py
