graphica-plot 2.0.0__py3-none-any.whl

graphica/gui/dialogs/export.py

@@ -0,0 +1,433 @@
+"""書き出しと出力のダイアログ。呼び出し側は `from graphica.gui.dialogs import X` で参照する。"""
+
+import os
+from PySide6.QtWidgets import (
+    QApplication,
+    QCheckBox,
+    QComboBox,
+    QDialog,
+    QDialogButtonBox,
+    QDoubleSpinBox,
+    QFormLayout,
+    QHBoxLayout,
+    QLabel,
+    QLineEdit,
+    QListWidget,
+    QListWidgetItem,
+    QPlainTextEdit,
+    QPushButton,
+    QSpinBox,
+    QStackedWidget,
+    QVBoxLayout,
+    QWidget,
+)
+from PySide6.QtCore import Qt
+from PySide6.QtGui import QFont, QPixmap
+from graphica.core.i18n import tr
+from graphica.gui import notify
+from graphica.gui.theme import apply_form_spacing
+from graphica.core.cvd_simulation import CVD_TYPE_LABELS
+from graphica.gui.cvd_preview import simulate_qimage
+
+
+class ExportDialog(QDialog):
+    """書き出しの大きさ・単位・解像度。プレビューを作るのは呼び出し側(PlotterApp._generate_preview)。"""
+    def __init__(self, parent=None):
+        super().__init__(parent)
+        self.setWindowTitle("プロットのエクスポート")
+
+
+        # 学術誌の段組の幅(単段 85mm / 1.5段 114mm / 2段 170mm)。高さは図ごとに違うので決めない
+        self.JOURNAL_PRESET_CUSTOM = "カスタム"
+        self.JOURNAL_PRESETS = {
+            "学術誌 単段 (85mm)": 85.0,
+            "学術誌 1.5段 (114mm)": 114.0,
+            "学術誌 2段 (170mm)": 170.0,
+        }
+        self.journal_preset_combo = QComboBox()
+        self.journal_preset_combo.addItem(self.JOURNAL_PRESET_CUSTOM)
+        self.journal_preset_combo.addItems(self.JOURNAL_PRESETS.keys())
+        self.journal_preset_combo.currentTextChanged.connect(self._on_journal_preset_changed)
+
+        self.width_spinbox = QDoubleSpinBox()
+        self.width_spinbox.setRange(1, 10000)
+        self.width_spinbox.setValue(800)
+        self.width_spinbox.setDecimals(1)     # インチ指定のため小数を許す
+
+        self.height_spinbox = QDoubleSpinBox()
+        self.height_spinbox.setRange(1, 10000)
+        self.height_spinbox.setValue(600)
+        self.height_spinbox.setDecimals(1)
+
+        # 学術誌のプリセットを選ぶとミリメートルに切り替わる
+        self.unit_combo = QComboBox()
+        # 値は日本語の元の文字(書き出しの処理がそれで単位を見分ける)。表示だけを訳す
+        for unit in ("ピクセル (px)", "インチ (in)", "センチメートル (cm)", "ミリメートル (mm)"):
+            self.unit_combo.addItem(tr(unit), unit)
+
+        self.dpi_spinbox = QSpinBox()
+        self.dpi_spinbox.setRange(50, 1200)
+        self.dpi_spinbox.setValue(300)
+        self.dpi_spinbox.setSuffix(" dpi")
+
+        self.transparent_checkbox = QCheckBox("背景を透過")
+        self.transparent_checkbox.setChecked(True)
+
+        # 既定は文字のまま(検索や編集ができる)。フォントの無い環境で化けるのを避けたいときだけパスにする。SVG だけに効く
+        self.svg_text_as_path_checkbox = QCheckBox("文字をアウトライン化する(SVG)")
+        self.svg_text_as_path_checkbox.setToolTip(
+            "SVG出力時、目盛りの数字やラベルの文字をテキスト要素ではなく"
+            "パス(輪郭線)として出力します。フォントが無い環境でも見た目が"
+            "崩れませんが、テキストとしての検索・編集はできなくなります。"
+        )
+
+        # 表示用の間引き(線は 20,000 点超、2D マップは1軸 500 点超)をしない
+        self.full_resolution_checkbox = QCheckBox("フル解像度でエクスポート(間引きなし)")
+        self.full_resolution_checkbox.setToolTip(
+            "通常、点数の多いLine(折れ線)データセットや2Dマップ(ヒートマップ/"
+            "等高線)は画面表示同様に間引いて描画されます。このチェックを入れると"
+            "間引きを無効化し、常に全データ点/全解像度でエクスポートします"
+            "(処理が遅くなる場合があります)。Scatter/Line+Scatterのマーカーは"
+            "この設定に関わらず常に全点描画されます。"
+        )
+
+        self.preview_button = QPushButton("プレビュー更新")
+        self.preview_button.setToolTip("現在の設定でプレビュー画像を生成します。")
+        
+        self.preview_label = QLabel("プレビューがここに表示されます")
+        self.preview_label.setAlignment(Qt.AlignmentFlag.AlignCenter)
+        self.preview_label.setFixedSize(400, 300)
+        self.preview_label.setFrameShape(QLabel.Shape.StyledPanel)
+
+        button_box = QDialogButtonBox(QDialogButtonBox.StandardButton.Save | 
+                                    QDialogButtonBox.StandardButton.Cancel)
+        button_box.accepted.connect(self.accept)
+        button_box.rejected.connect(self.reject)
+
+
+        form_layout = QFormLayout()
+        form_layout.addRow("サイズプリセット", self.journal_preset_combo)
+        form_layout.addRow("幅", self.width_spinbox)
+        form_layout.addRow("高さ", self.height_spinbox)
+        form_layout.addRow("単位", self.unit_combo)
+        form_layout.addRow("解像度", self.dpi_spinbox)
+        form_layout.addRow(self.transparent_checkbox)
+        form_layout.addRow(self.svg_text_as_path_checkbox)
+        form_layout.addRow(self.full_resolution_checkbox)
+
+        main_layout = QVBoxLayout()
+        main_layout.addLayout(form_layout)
+        main_layout.addWidget(self.preview_button)
+        main_layout.addWidget(self.preview_label)
+        main_layout.addWidget(button_box)
+        
+        self.setLayout(main_layout)
+
+        apply_form_spacing(self)
+
+    def _on_journal_preset_changed(self, preset_name):
+        """「カスタム」なら入力した値をそのまま残す。"""
+        if preset_name == self.JOURNAL_PRESET_CUSTOM:
+            return
+        self.unit_combo.setCurrentIndex(self.unit_combo.findData("ミリメートル (mm)"))
+        self.width_spinbox.setValue(self.JOURNAL_PRESETS[preset_name])
+
+    def get_options(self):
+        return {
+            "width": self.width_spinbox.value(),
+            "height": self.height_spinbox.value(),
+            "unit": self.unit_combo.currentData(),
+            "dpi": self.dpi_spinbox.value(),
+            "transparent": self.transparent_checkbox.isChecked(),
+            "svg_text_as_path": self.svg_text_as_path_checkbox.isChecked(),
+            "full_resolution": self.full_resolution_checkbox.isChecked(),
+        }
+
+
+class BatchExportDialog(QDialog):
+    """サブプロットごと、または複数のプロジェクトファイルをまとめて書き出す設定。書き出しは呼び出し側。"""
+
+    def __init__(self, subplot_count, parent=None, extra_formats=None):
+        """extra_formats はプラグインの書き出し形式の名前(PNG / PDF / SVG に足す)。"""
+        super().__init__(parent)
+        self.setWindowTitle("バッチエクスポート")
+        self.resize(480, 480)
+
+        layout = QVBoxLayout(self)
+
+        self.mode_combo = QComboBox()
+        self.mode_combo.addItems([
+            "現在のプロジェクトの各サブプロットを個別に書き出す",
+            "複数のプロジェクトファイルをまとめて書き出す",
+        ])
+        layout.addWidget(self.mode_combo)
+
+        self.stack = QStackedWidget()
+        layout.addWidget(self.stack, 1)
+
+        subplot_page = QWidget()
+        subplot_page_layout = QVBoxLayout(subplot_page)
+        subplot_page_layout.addWidget(QLabel("書き出すサブプロットを選択してください:"))
+        self.subplot_list = QListWidget()
+        self.subplot_list.setSelectionMode(QListWidget.SelectionMode.NoSelection)
+        for i in range(max(subplot_count, 1)):
+            item = QListWidgetItem(f"プロット {i + 1}")
+            item.setFlags(item.flags() | Qt.ItemFlag.ItemIsUserCheckable)
+            item.setCheckState(Qt.CheckState.Checked)
+            self.subplot_list.addItem(item)
+        subplot_page_layout.addWidget(self.subplot_list)
+        self.stack.addWidget(subplot_page)
+
+        files_page = QWidget()
+        files_page_layout = QVBoxLayout(files_page)
+        files_page_layout.addWidget(QLabel("書き出すプロジェクトファイル(.gra/.graphica)を追加してください:"))
+        self.project_files_list = QListWidget()
+        files_page_layout.addWidget(self.project_files_list)
+        files_button_row = QHBoxLayout()
+        add_files_button = QPushButton("追加...")
+        add_files_button.clicked.connect(self._on_add_project_files)
+        remove_files_button = QPushButton("削除")
+        remove_files_button.clicked.connect(self._on_remove_selected_project_files)
+        files_button_row.addWidget(add_files_button)
+        files_button_row.addWidget(remove_files_button)
+        files_button_row.addStretch()
+        files_page_layout.addLayout(files_button_row)
+        self.stack.addWidget(files_page)
+
+        self.mode_combo.currentIndexChanged.connect(self.stack.setCurrentIndex)
+
+        form = QFormLayout()
+
+        output_dir_row = QHBoxLayout()
+        self.output_dir_edit = QLineEdit()
+        self.output_dir_edit.setReadOnly(True)
+        browse_button = QPushButton("参照...")
+        browse_button.clicked.connect(self._on_browse_output_dir)
+        output_dir_row.addWidget(self.output_dir_edit)
+        output_dir_row.addWidget(browse_button)
+        form.addRow("出力先フォルダ", output_dir_row)
+
+        self.prefix_edit = QLineEdit("export")
+        form.addRow("ファイル名の接頭辞", self.prefix_edit)
+
+        self.format_combo = QComboBox()
+        self.format_combo.addItems(["PNG", "PDF", "SVG"])
+        if extra_formats:
+            self.format_combo.addItems(extra_formats)
+        form.addRow("形式", self.format_combo)
+
+        self.dpi_spinbox = QSpinBox()
+        self.dpi_spinbox.setRange(50, 1200)
+        self.dpi_spinbox.setValue(150)
+        self.dpi_spinbox.setSuffix(" dpi")
+        form.addRow("解像度(ラスター形式時)", self.dpi_spinbox)
+
+        self.transparent_checkbox = QCheckBox("背景を透過")
+        self.transparent_checkbox.setChecked(True)
+        form.addRow(self.transparent_checkbox)
+
+        self.svg_text_as_path_checkbox = QCheckBox("文字をアウトライン化する(SVG)")
+        self.svg_text_as_path_checkbox.setToolTip(
+            "SVG出力時、目盛りの数字やラベルの文字をパス(輪郭線)として出力します。"
+            "PNG/PDF形式には影響しません。"
+        )
+        form.addRow(self.svg_text_as_path_checkbox)
+
+        self.full_resolution_checkbox = QCheckBox("フル解像度でエクスポート(間引きなし)")
+        self.full_resolution_checkbox.setToolTip(
+            "通常、点数の多いLine(折れ線)データセットや2Dマップ(ヒートマップ/"
+            "等高線)は画面表示同様に間引いて描画されます。このチェックを入れると"
+            "間引きを無効化し、常に全データ点/全解像度でエクスポートします"
+            "(処理が遅くなる場合があります)。Scatter/Line+Scatterのマーカーは"
+            "この設定に関わらず常に全点描画されます。"
+        )
+        form.addRow(self.full_resolution_checkbox)
+
+        layout.addLayout(form)
+
+        button_box = QDialogButtonBox(QDialogButtonBox.StandardButton.Ok |
+                                    QDialogButtonBox.StandardButton.Cancel)
+        button_box.button(QDialogButtonBox.StandardButton.Ok).setText("実行")
+        button_box.accepted.connect(self.accept)
+        button_box.rejected.connect(self.reject)
+        layout.addWidget(button_box)
+
+        apply_form_spacing(self)
+
+    def _on_add_project_files(self):
+        paths, _ = notify.get_open_file_names(
+            self, "プロジェクトファイルを選択", "", "Graphica Project (*.gra *.graphica)"
+        )
+        for path in paths:
+            self.project_files_list.addItem(path)
+
+    def _on_remove_selected_project_files(self):
+        for item in self.project_files_list.selectedItems():
+            self.project_files_list.takeItem(self.project_files_list.row(item))
+
+    def _on_browse_output_dir(self):
+        directory = notify.get_existing_directory(self, "出力先フォルダを選択")
+        if directory:
+            self.output_dir_edit.setText(directory)
+
+    def get_mode(self):
+        """'subplots' か 'project_files'。"""
+        return "subplots" if self.mode_combo.currentIndex() == 0 else "project_files"
+
+    def get_selected_subplot_indices(self):
+        return [
+            i for i in range(self.subplot_list.count())
+            if self.subplot_list.item(i).checkState() == Qt.CheckState.Checked
+        ]
+
+    def get_project_file_paths(self):
+        return [self.project_files_list.item(i).text() for i in range(self.project_files_list.count())]
+
+    def get_common_options(self):
+        return {
+            'output_dir': self.output_dir_edit.text(),
+            'prefix': self.prefix_edit.text().strip() or "export",
+            'format': self.format_combo.currentText().lower(),
+            'dpi': self.dpi_spinbox.value(),
+            'transparent': self.transparent_checkbox.isChecked(),
+            'svg_text_as_path': self.svg_text_as_path_checkbox.isChecked(),
+            'full_resolution': self.full_resolution_checkbox.isChecked(),
+        }
+
+
+class CaptionGeneratorDialog(QDialog):
+    """論文用の LaTeX の \\includegraphics 一式と Word 用のキャプションを作ってコピーする。画像ファイル名は自由入力。"""
+
+    WIDTH_OPTIONS = [r'\linewidth', r'0.8\linewidth', r'0.5\linewidth', r'\textwidth']
+
+    def __init__(self, default_caption="", default_label="", parent=None):
+        super().__init__(parent)
+        self.setWindowTitle("LaTeX/Word用キャプションを生成")
+        self.resize(480, 420)
+
+        layout = QVBoxLayout(self)
+
+        form = QFormLayout()
+        self.caption_edit = QLineEdit(default_caption)
+        form.addRow("キャプション", self.caption_edit)
+
+        image_layout = QHBoxLayout()
+        self.image_name_edit = QLineEdit()
+        self.image_name_edit.setPlaceholderText("例: figure1.pdf(空欄可、後から書き換えてください)")
+        browse_button = QPushButton("参照...")
+        browse_button.clicked.connect(self._on_browse_image)
+        image_layout.addWidget(self.image_name_edit, 1)
+        image_layout.addWidget(browse_button)
+        form.addRow("画像ファイル名", image_layout)
+
+        self.label_edit = QLineEdit(default_label)
+        form.addRow("LaTeXラベル", self.label_edit)
+
+        self.width_combo = QComboBox()
+        self.width_combo.addItems(self.WIDTH_OPTIONS)
+        form.addRow("幅(\\includegraphics)", self.width_combo)
+        layout.addLayout(form)
+
+        layout.addWidget(QLabel("LaTeXプレビュー"))
+        self.latex_preview = QPlainTextEdit()
+        self.latex_preview.setReadOnly(True)
+        self.latex_preview.setFont(QFont("Consolas", 9))
+        layout.addWidget(self.latex_preview, 1)
+
+        button_layout = QHBoxLayout()
+        copy_latex_button = QPushButton("LaTeXをコピー")
+        copy_latex_button.clicked.connect(self._on_copy_latex)
+        copy_caption_button = QPushButton("キャプション文をコピー(Word用)")
+        copy_caption_button.clicked.connect(self._on_copy_caption)
+        button_layout.addWidget(copy_latex_button)
+        button_layout.addWidget(copy_caption_button)
+        button_layout.addStretch()
+        layout.addLayout(button_layout)
+
+        close_button_box = QDialogButtonBox(QDialogButtonBox.StandardButton.Close)
+        close_button_box.rejected.connect(self.reject)
+        close_button_box.button(QDialogButtonBox.StandardButton.Close).clicked.connect(self.reject)
+        layout.addWidget(close_button_box)
+
+        for widget in (self.caption_edit, self.image_name_edit, self.label_edit):
+            widget.textChanged.connect(self._update_preview)
+        self.width_combo.currentTextChanged.connect(self._update_preview)
+        self._update_preview()
+
+        apply_form_spacing(self)
+
+    def _on_browse_image(self):
+        file_path, _ = notify.get_open_file_name(
+            self, "画像ファイルを選択", "", "画像ファイル (*.pdf *.svg *.png *.eps)"
+        )
+        if file_path:
+            self.image_name_edit.setText(os.path.basename(file_path))
+
+    def _update_preview(self):
+        from graphica.core.caption_export import generate_latex_figure
+        latex_code = generate_latex_figure(
+            self.image_name_edit.text().strip(), self.caption_edit.text(),
+            self.label_edit.text().strip(), self.width_combo.currentText(),
+        )
+        self.latex_preview.setPlainText(latex_code)
+
+    def _on_copy_latex(self):
+        QApplication.clipboard().setText(self.latex_preview.toPlainText())
+
+    def _on_copy_caption(self):
+        QApplication.clipboard().setText(self.caption_edit.text())
+
+
+class CVDSimulationDialog(QDialog):
+    """色覚シミュレーションのプレビュー。呼び出し側が1回撮った画像を、モードごとに変換して見せる(グラフは描き直さない)。"""
+
+    MODE_NORMAL = "通常(変換なし)"
+
+    def __init__(self, source_image, parent=None):
+        super().__init__(parent)
+        self.setWindowTitle("色覚シミュレーションプレビュー")
+        self.resize(700, 560)
+        self._source_image = source_image
+
+        layout = QVBoxLayout(self)
+
+        form = QFormLayout()
+        self.mode_combo = QComboBox()
+        self.mode_combo.addItem(self.MODE_NORMAL, None)
+        for key, label in CVD_TYPE_LABELS.items():
+            self.mode_combo.addItem(label, key)
+        self.mode_combo.currentIndexChanged.connect(self._update_preview)
+        form.addRow("表示モード", self.mode_combo)
+        layout.addLayout(form)
+
+        self.preview_label = QLabel()
+        self.preview_label.setAlignment(Qt.AlignmentFlag.AlignCenter)
+        self.preview_label.setMinimumSize(400, 300)
+        self.preview_label.setFrameShape(QLabel.Shape.StyledPanel)
+        layout.addWidget(self.preview_label, 1)
+
+        info_label = QLabel(
+            "sRGB値への直接変換による簡易的な近似シミュレーションです。"
+            "実際の見え方を完全に再現するものではありません。"
+        )
+        info_label.setWordWrap(True)
+        layout.addWidget(info_label)
+
+        button_box = QDialogButtonBox(QDialogButtonBox.StandardButton.Close)
+        button_box.rejected.connect(self.reject)
+        button_box.button(QDialogButtonBox.StandardButton.Close).clicked.connect(self.reject)
+        layout.addWidget(button_box)
+
+        self._update_preview()
+
+    def _update_preview(self):
+        cvd_type = self.mode_combo.currentData()
+        image = self._source_image if cvd_type is None else simulate_qimage(self._source_image, cvd_type)
+        pixmap = QPixmap.fromImage(image)
+        target_width = max(self.preview_label.width(), 400)
+        target_height = max(self.preview_label.height(), 300)
+        scaled = pixmap.scaled(
+            target_width, target_height,
+            Qt.AspectRatioMode.KeepAspectRatio, Qt.TransformationMode.SmoothTransformation,
+        )
+        self.preview_label.setPixmap(scaled)

graphica/gui/dock_layout.py

@@ -0,0 +1,176 @@
+"""ドックの配置: 組み立て、起動時の復元、名前を付けた配置の保存・読み込み・リセット。"""
+import base64
+import json
+import logging
+from PySide6.QtCore import QByteArray, Qt
+from PySide6.QtWidgets import QDockWidget, QGroupBox, QScrollArea, QVBoxLayout, QWidget
+from graphica.core.i18n import tr
+from graphica.gui import app_settings, notify
+from graphica.gui.builders.common import DOCK_LAYOUT_VERSION, EXPORT_PREVIEW_DOCK_INITIAL_HEIGHT
+from graphica.gui.export_preview_panel import ExportPreviewPanel
+from graphica.gui.provenance_panel import ProvenancePanel
+from graphica.gui.residual_panel import ResidualPanel
+
+logger = logging.getLogger(__name__)
+
+
+def arrange_property_docks(app):
+    # 「プロットのプロパティ」と「データセットのプロパティ」を1つのドックに縦に並べ、1枚のパネルに見せる。
+    # properties_dock_widget は control_dock_widget の別名(表示メニューなどがこの名前で使う)
+    app.properties_dock_widget = app.ui.control_dock_widget
+    app.ui.control_dock_widget.setWindowTitle(tr("プロパティ"))
+
+    original_control_widget = app.ui.control_dock_widget.widget()
+    plot_properties_group = QGroupBox(tr("プロットのプロパティ"))
+    plot_properties_layout = QVBoxLayout(plot_properties_group)
+    plot_properties_layout.setContentsMargins(0, 4, 0, 0)
+    if original_control_widget:
+        plot_properties_layout.addWidget(original_control_widget)
+    else:
+        logger.warning("control_dock_widget の中身が見つかりません。")
+
+    app.ui.properties_groupbox.setTitle(tr("データセットのプロパティ"))
+
+    # どちらも長いので開閉できるようにする。中身を1つずつ隠すと入れ子のレイアウトを取りこぼすので、
+    # グループボックスごと出し入れする開閉ボタンを外に付ける(見出しはボタン側だけに出す)
+    dataset_section = app._wrap_in_collapsible_section(
+        app.ui.properties_groupbox, tr("データセットのプロパティ"))
+    plot_section = app._wrap_in_collapsible_section(
+        plot_properties_group, tr("プロットのプロパティ"))
+
+    # 既定の余白だと縦スクロールバーの分だけ中身がはみ出し、横スクロールバーが出るので左右を詰める
+    merged_properties_container = QWidget()
+    merged_properties_layout = QVBoxLayout(merged_properties_container)
+    merged_properties_layout.setContentsMargins(2, 4, 2, 4)
+    merged_properties_layout.addWidget(dataset_section)
+    merged_properties_layout.addWidget(plot_section)
+    merged_properties_layout.addStretch()
+
+    merged_scroll_area = QScrollArea()
+    merged_scroll_area.setWidgetResizable(True)
+    merged_scroll_area.setHorizontalScrollBarPolicy(Qt.ScrollBarPolicy.ScrollBarAlwaysOff)
+    merged_scroll_area.setWidget(merged_properties_container)
+    app.ui.control_dock_widget.setWidget(merged_scroll_area)
+
+    # エクスポートのプレビュー。描き続けると重いので既定では隠し、表示メニューから開く
+    app.export_preview_panel = ExportPreviewPanel(app)
+    app.export_preview_dock_widget = QDockWidget(tr("エクスポートプレビュー"), app)
+    app.export_preview_dock_widget.setObjectName("ExportPreviewDockWidget")
+    app.export_preview_dock_widget.setWidget(app.export_preview_panel)
+    # 必要なときだけ見るものなので、キャンバスを狭めないよう独立した窓で開く(ドッキングもできる)
+    app.addDockWidget(Qt.DockWidgetArea.RightDockWidgetArea, app.export_preview_dock_widget)
+    app.export_preview_dock_widget.setFloating(True)
+    app.export_preview_dock_widget.hide()
+    app._export_preview_first_show = True
+
+    def _on_export_preview_visibility_changed(visible):
+        if not visible:
+            return
+        # 浮いたドックは表示されるまで大きさを持たないことがあるので、最初に表示したときに整える
+        if app._export_preview_first_show and app.export_preview_dock_widget.isFloating():
+            app._export_preview_first_show = False
+            preview_width, preview_height = 820, 680
+            app.export_preview_dock_widget.resize(preview_width, preview_height)
+            center = app.geometry().center()
+            app.export_preview_dock_widget.move(
+                center.x() - preview_width // 2, center.y() - preview_height // 2
+            )
+        app.export_preview_panel.refresh_preview()
+
+    # 選んだデータセットのフィットの残差。既定では隠し、開くときはキャンバスの下に付ける
+    app.residual_panel = ResidualPanel(app)
+    app.residual_dock_widget = QDockWidget(tr("残差プロット"), app)
+    app.residual_dock_widget.setObjectName("ResidualDockWidget")
+    app.residual_dock_widget.setWidget(app.residual_panel)
+    app.addDockWidget(Qt.DockWidgetArea.BottomDockWidgetArea, app.residual_dock_widget)
+    app.residual_dock_widget.hide()
+
+    # 選んだデータセットの処理の履歴。既定では隠す
+    app.provenance_panel = ProvenancePanel(app)
+    app.provenance_dock_widget = QDockWidget(tr("処理履歴"), app)
+    app.provenance_dock_widget.setObjectName("ProvenanceDockWidget")
+    app.provenance_dock_widget.setWidget(app.provenance_panel)
+    app.addDockWidget(Qt.DockWidgetArea.RightDockWidgetArea, app.provenance_dock_widget)
+    app.provenance_dock_widget.hide()
+
+    app.export_preview_dock_widget.visibilityChanged.connect(_on_export_preview_visibility_changed)
+
+
+def restore_dock_layout(app):
+    """前回のドック配置を戻す。タブが最終の大きさになってから呼ぶ(でないとスプリッターの位置がずれる)。"""
+    saved_layout_version = (app_settings.DOCK_LAYOUT_VERSION.read(app.settings) if app._run_startup_checks
+                            else DOCK_LAYOUT_VERSION)
+    saved_state = app_settings.WINDOW_STATE.read(app.settings) if app._run_startup_checks else None
+    state_restored = False
+    if saved_state is not None and saved_layout_version == DOCK_LAYOUT_VERSION:
+        state_restored = bool(app.restoreState(saved_state))
+
+    if not state_restored:
+        try:
+            app.resizeDocks(
+                [app.export_preview_dock_widget],
+                [EXPORT_PREVIEW_DOCK_INITIAL_HEIGHT],
+                Qt.Orientation.Vertical
+            )
+        except Exception:
+            logger.exception("resizeDocks に失敗しました")
+
+
+def load_dock_layout_presets(app):
+    """{名前: base64 の saveState}"""
+    raw = app_settings.DOCK_LAYOUT_PRESETS.read(app.settings)
+    if not isinstance(raw, str):
+        raw = "{}"
+    try:
+        presets = json.loads(raw)
+    except (TypeError, ValueError):
+        logger.warning("ドックレイアウトプリセットの読み込みに失敗しました。空として扱います。")
+        return {}
+    return presets if isinstance(presets, dict) else {}
+
+
+def save_dock_layout_presets(app, presets: dict):
+    app_settings.DOCK_LAYOUT_PRESETS.write(app.settings, json.dumps(presets))
+
+
+def on_save_dock_layout_preset(app):
+    name, ok = notify.get_text(app, "レイアウトを保存", "プリセット名:")
+    name = name.strip()
+    if not ok or not name:
+        return
+    presets = app._load_dock_layout_presets()
+    presets[name] = base64.b64encode(bytes(app.saveState())).decode('ascii')
+    app._save_dock_layout_presets(presets)
+    app.statusBar().showMessage(f"レイアウト「{name}」を保存しました", 3000)
+
+
+def populate_load_layout_menu(app):
+    """保存や削除のたびに更新しなくて済むよう、開く直前に作り直す。"""
+    app.load_layout_menu.clear()
+    presets = app._load_dock_layout_presets()
+    if not presets:
+        empty_action = app.load_layout_menu.addAction("(保存済みレイアウトはありません)")
+        empty_action.setEnabled(False)
+        return
+    for name in sorted(presets.keys()):
+        action = app.load_layout_menu.addAction(name)
+        action.triggered.connect(lambda checked=False, n=name: app._on_load_dock_layout_preset(n))
+
+
+def on_load_dock_layout_preset(app, name):
+    presets = app._load_dock_layout_presets()
+    state_b64 = presets.get(name)
+    if state_b64 is None:
+        return
+    try:
+        state_bytes = base64.b64decode(state_b64)
+    except (ValueError, TypeError):
+        notify.warning(app, "レイアウトの復元", "保存されたレイアウトデータが壊れています。")
+        return
+    if not app.restoreState(QByteArray(state_bytes)):
+        notify.warning(app, "レイアウトの復元", "レイアウトの復元に失敗しました。")
+
+
+def on_reset_dock_layout(app):
+    """組み立てた直後、配置を戻す前に控えた状態(_pristine_dock_state)に戻す。"""
+    app.restoreState(app._pristine_dock_state)