graphica-plot 2.0.0__py3-none-any.whl

graphica/gui/mathtext_preview.py

@@ -0,0 +1,168 @@
+"""タイトルと軸ラベルのテキスト(mathtext を含む)を、グラフと同じ matplotlib の描画で QPixmap にする。"""
+import re
+
+import numpy as np
+from matplotlib.backends.backend_agg import FigureCanvasAgg
+from matplotlib.figure import Figure
+from PySide6.QtCore import Qt
+from PySide6.QtGui import QImage, QPixmap
+from PySide6.QtWidgets import QLabel
+
+# 描いた範囲だけを後で切り取るので大きめでよい。ただし幅を超えた文字は切れ、縮小の判定を誤るので余裕を持たせる
+_CANVAS_SIZE_INCHES = (10.0, 0.6)
+_CROP_PADDING_PX = 3
+
+# 日本語を描けるフォントの候補。matplotlib の既定(DejaVu Sans)には日本語が無い。Qt の UI 用の名前
+# ("Yu Gothic UI")は matplotlib では見つからないので使わない。先頭から順にグリフのあるフォントが使われ、
+# 無い名前は飛ばされるので OS ごとの候補を並べる(Yu Gothic などは Windows、Hiragino は macOS、Noto は Linux)。
+# グラフ本体の既定フォント(main_window の PLOT_DEFAULT_FONT_FAMILIES)と注釈(rendering/annotations.py)もこれを使う。
+# $...$ を含む文字列の数式の外の文字は、候補の先頭 1 つで描かれる(families_for_text)。mathtext.fontset は
+# プロセス全体の設定で、変えると全部の描画に効くので触らない。
+JP_CAPABLE_FONT_FAMILIES = [
+    "DejaVu Sans", "Yu Gothic", "Hiragino Sans", "Hiragino Kaku Gothic ProN",
+    "Meiryo", "MS Gothic", "Noto Sans CJK JP",
+]
+
+_CJK_PATTERN = re.compile(r"[\u3000-\u30ff\u3400-\u9fff\uf900-\ufaff\uff00-\uffef]")
+# 数式の外の文字を描ける日本語の字体(DejaVu Sans は日本語を持たない)
+_JAPANESE_FONT_FAMILIES = [f for f in JP_CAPABLE_FONT_FAMILIES if f != "DejaVu Sans"]
+
+
+def _has_mathtext(text):
+    """エスケープしていない $ が 2 つ以上あれば、matplotlib はその文字列を数式として描く。"""
+    return len(re.findall(r"(?<!\\)\$", text)) >= 2
+
+
+def families_for_text(text, families):
+    """数式を含む文字列では、matplotlib は数式の外の文字を字体の候補の先頭 1 つだけで描く(ほかの候補に頼らない)。
+    日本語と数式を混ぜたときだけ、日本語の字体を先頭に置いて □ にならないようにする。それ以外は families のまま。"""
+    if not text or not _CJK_PATTERN.search(text) or not _has_mathtext(text):
+        return families
+    if isinstance(families, str):
+        families = [families]
+    families = list(families or [])
+    if families and families[0].lower() in {f.lower() for f in _JAPANESE_FONT_FAMILIES}:
+        return families
+    return _JAPANESE_FONT_FAMILIES + [f for f in families if f not in _JAPANESE_FONT_FAMILIES]
+
+
+def families_for_texts(texts, families):
+    """凡例のように 1 つの字体で複数の文字列を描くとき。どれかが日本語と数式を混ぜていれば、その並びにする。"""
+    for text in texts:
+        adjusted = families_for_text(text, families)
+        if adjusted is not families:
+            return adjusted
+    return families
+
+
+def font_kwargs_for_text(text, font_kwargs):
+    """ax.set_title(text, **font_kwargs) などに渡す字体の辞書を、families_for_text() に合わせて返す(元は変えない)。"""
+    family = font_kwargs.get('family') if font_kwargs else None
+    adjusted = families_for_text(text, family)
+    if adjusted is family:
+        return font_kwargs
+    return dict(font_kwargs, family=adjusted)
+
+
+# これより小さくすると読めないので、そこからは pixmap ごと縮める
+_MIN_FONTSIZE = 7
+
+
+def render_mathtext_to_pixmap(text, color="#000000", fontsize=13, dpi=150, max_width_px=None):
+    """描いた範囲だけを切り取った QPixmap。
+
+    mathtext の構文が壊れていれば、$ をエスケープして文字のまま描く(入力の邪魔をしない)。
+    max_width_px を超えればフォントを小さくし、下限でも収まらなければ pixmap を縮める。
+    """
+    pixmap = _render_once(text, color, fontsize, dpi)
+    if max_width_px and pixmap.width() > max_width_px > 0:
+        # 幅はフォントサイズにほぼ比例するので、比例で縮めて1回だけ描き直す
+        scaled_fontsize = max(_MIN_FONTSIZE, fontsize * (max_width_px / pixmap.width()) * 0.95)
+        pixmap = _render_once(text, color, scaled_fontsize, dpi)
+        if pixmap.width() > max_width_px > 0:
+            pixmap = pixmap.scaledToWidth(
+                max_width_px, Qt.TransformationMode.SmoothTransformation
+            )
+    return pixmap
+
+
+def _render_once(text, color, fontsize, dpi):
+    fig = Figure(figsize=_CANVAS_SIZE_INCHES, dpi=dpi)
+    canvas = FigureCanvasAgg(fig)
+    fig.patch.set_alpha(0.0)
+    display_text = text if text else " "
+    try:
+        fig.text(0.01, 0.5, display_text, fontsize=fontsize, color=color,
+                  family=families_for_text(display_text, JP_CAPABLE_FONT_FAMILIES), va='center', ha='left')
+        canvas.draw()
+    except ValueError:  # mathtext の構文エラー。$ をそのまま文字として描き直す
+        fig = Figure(figsize=_CANVAS_SIZE_INCHES, dpi=dpi)
+        canvas = FigureCanvasAgg(fig)
+        fig.patch.set_alpha(0.0)
+        fig.text(0.01, 0.5, display_text.replace("$", "\\$"), fontsize=fontsize,
+                  color=color, family=JP_CAPABLE_FONT_FAMILIES, va='center', ha='left')
+        canvas.draw()
+
+    buf = np.asarray(canvas.buffer_rgba())
+    cropped = _crop_to_content(buf)
+    cropped = np.ascontiguousarray(cropped)
+    height, width, _ = cropped.shape
+    image = QImage(cropped.data, width, height, width * 4, QImage.Format.Format_RGBA8888)
+    # QImage は cropped の配列を参照しているだけなので、関数を抜けると宙に浮く。copy() する
+    return QPixmap.fromImage(image.copy())
+
+
+class FitWidthPixmapLabel(QLabel):
+    """set_natural_pixmap() で渡した等倍の pixmap を、ラベルの幅に収まるよう縮めて出す。
+
+    描く時点の width() は、非表示のタブなどでは確定していないので、resizeEvent で合わせ直す。
+    """
+
+    def __init__(self, parent=None):
+        super().__init__(parent)
+        self._natural_pixmap = None
+
+    def set_natural_pixmap(self, pixmap):
+        self._natural_pixmap = pixmap
+        self._apply_fitted_pixmap()
+
+    def _apply_fitted_pixmap(self):
+        if self._natural_pixmap is None or self._natural_pixmap.isNull():
+            return
+        # QSS の枠と余白を除いた contentsRect() に合わせる(でないと端が欠ける)。
+        # 幅だけでなく高さもはみ出していれば、はみ出した方に合わせて縮める。
+        available_rect = self.contentsRect()
+        available_width = available_rect.width()
+        available_height = available_rect.height()
+        natural = self._natural_pixmap
+        if (available_width > 0 and natural.width() > available_width) or (
+            available_height > 0 and natural.height() > available_height
+        ):
+            fitted = natural.scaled(
+                max(available_width, 1), max(available_height, 1),
+                Qt.AspectRatioMode.KeepAspectRatio, Qt.TransformationMode.SmoothTransformation,
+            )
+        else:
+            fitted = natural
+        super().setPixmap(fitted)
+
+    def resizeEvent(self, event):
+        super().resizeEvent(event)
+        self._apply_fitted_pixmap()
+
+
+def _crop_to_content(rgba_array):
+    """不透明なピクセルの外接矩形(と少しの余白)で切り取る。"""
+    alpha = rgba_array[:, :, 3]
+    rows = np.any(alpha > 0, axis=1)
+    cols = np.any(alpha > 0, axis=0)
+    if not rows.any() or not cols.any():
+        return rgba_array[:1, :1]
+
+    row_indices = np.where(rows)[0]
+    col_indices = np.where(cols)[0]
+    row_min = max(0, row_indices[0] - _CROP_PADDING_PX)
+    row_max = min(rgba_array.shape[0] - 1, row_indices[-1] + _CROP_PADDING_PX)
+    col_min = max(0, col_indices[0] - _CROP_PADDING_PX)
+    col_max = min(rgba_array.shape[1] - 1, col_indices[-1] + _CROP_PADDING_PX)
+    return rgba_array[row_min:row_max + 1, col_min:col_max + 1]

graphica/gui/menu_bar.py

@@ -0,0 +1,320 @@
+"""
+メニューバーの中身の一覧表と、それを組み立てる関数。
+
+項目は PlotterApp のメソッド名で呼び先を指す。コマンドパレット・クイックアクセス・ショートカット一覧は
+メニューを辿って項目を集め、そのパス(「ファイル > エクスポート > 印刷(&R)...」)を識別子として保存するので、
+文字列を変えると保存済みのピン留めが外れる。
+
+PySide6 は、Python 側の参照が無くなった QMenu・menuAction・QAction を後から回収することがある
+(メニューを辿ったとたん "already deleted" になる)。組み立てたものはすべて app._menu_keepalive に持たせる。
+"""
+from dataclasses import dataclass
+from typing import Callable, Optional
+
+from PySide6.QtGui import QAction, QKeySequence
+from PySide6.QtWidgets import QApplication
+
+from graphica.core.i18n import tr
+from graphica.core.version import APP_NAME
+from graphica.gui.theme import apply_theme
+
+
+@dataclass(frozen=True)
+class Item:
+    """
+    メニューの1項目。slot は triggered(checkable なら toggled)に繋ぐメソッド名。
+    attr を指定すると app にその名前で持たせる(ほかの場所から有効/無効やチェックを変えるもの)。
+    checked は初めのチェック状態を持つ app の属性の点区切りの名前。after は作った後に呼ぶメソッド名。
+    """
+    text: str
+    slot: str
+    shortcut: object = None
+    attr: Optional[str] = None
+    checked: Optional[str] = None
+    after: Optional[str] = None
+
+
+@dataclass(frozen=True)
+class Submenu:
+    """on_show は開くたびに中身を作り直すメソッド名。fill_now なら作った時点でも一度呼ぶ。"""
+    text: str
+    items: tuple = ()
+    attr: Optional[str] = None
+    action_attr: Optional[str] = None
+    on_show: Optional[str] = None
+    fill_now: bool = False
+    after: Optional[str] = None
+
+
+@dataclass(frozen=True)
+class DockToggle:
+    """ドックの表示切り替え(ドック自身の toggleViewAction)。dock は app からの点区切りの名前。"""
+    dock: str
+    text: str
+
+
+@dataclass(frozen=True)
+class Call:
+    """メニューとは別に、この位置で呼ぶ app のメソッド(組み立ての順番に意味があるもの)。"""
+    method: str
+
+
+@dataclass(frozen=True)
+class Custom:
+    """表で書けない項目。build(app, menu, keep) が menu に足す。"""
+    build: Callable
+
+
+SEPARATOR = object()
+
+
+@dataclass(frozen=True)
+class TopMenu:
+    text: str
+    attr: str
+    items: tuple = ()
+    action_attr: Optional[str] = None
+    on_show: Optional[str] = None
+    fill_now: bool = False
+
+
+def _add_undo_redo(app, menu, keep):
+    undo_action = app.undo_stack.createUndoAction(app, tr("元に戻す"))
+    undo_action.setShortcut(QKeySequence.StandardKey.Undo)
+    menu.addAction(undo_action)
+    redo_action = app.undo_stack.createRedoAction(app, tr("やり直し"))
+    redo_action.setShortcut(QKeySequence.StandardKey.Redo)
+    menu.addAction(redo_action)
+    keep.extend([undo_action, redo_action])
+
+
+def _add_command_palette(app, menu, keep):
+    # ウィンドウにも足して、メニューを開いていなくてもショートカットが効くようにする
+    app.command_palette_action = QAction(tr("コマンドパレット(&K)..."), app)
+    app.command_palette_action.setShortcut(QKeySequence("Ctrl+Shift+P"))
+    app.command_palette_action.triggered.connect(app._on_show_command_palette)
+    app.addAction(app.command_palette_action)
+    menu.addAction(app.command_palette_action)
+
+
+FILE_MENU = TopMenu("ファイル(&F)", "_file_menu", (
+    # Ctrl+O は「プロジェクトを開く」のもの
+    Item("データファイルを開く(&D)...", "_on_add_dataset", attr="open_data_file_action"),
+    SEPARATOR,
+    Item("プロジェクトを開く(&O)...", "_on_load_project", QKeySequence.StandardKey.Open, attr="open_project_action"),
+    Item("上書き保存(&P)", "_on_save_project", QKeySequence.StandardKey.Save, attr="save_project_action"),
+    Item("名前を付けて保存(&A)...", "_on_save_project_as", QKeySequence.StandardKey.SaveAs,
+         attr="save_project_as_action"),
+    Item("クリップボードから貼り付け(&V)...", "_on_paste_data_from_clipboard"),
+    Item("フォルダから一括インポート(&F)...", "_on_import_folder"),
+    Submenu("最近使ったファイル", attr="recent_files_menu", action_attr="_recent_files_menu_action",
+            after="_update_recent_files_menu"),
+    Item("スタートアップ画面(&W)...", "_on_show_startup_screen"),
+    SEPARATOR,
+    Item("書式テンプレートを保存(&T)...", "_on_save_plot_template"),
+    Item("書式テンプレートを適用(&A)...", "_on_load_plot_template"),
+    SEPARATOR,
+    Submenu("エクスポート", attr="_export_menu", action_attr="_export_menu_action", items=(
+        # Ctrl+Shift+S は「名前を付けて保存」のもの(同じキーが2つあると Qt はどちらも発火させない)
+        Item("名前を付けてエクスポート(&S)...", "_on_export_plot", attr="save_action"),
+        # Ctrl+C は文字のコピーとぶつかるので割り当てない
+        Item("グラフをコピー(&C)", "_on_copy_plot_to_clipboard"),
+        Item("印刷(&R)...", "_on_print_plot", QKeySequence.StandardKey.Print, attr="print_action"),
+        Item("バッチエクスポート(&B)...", "_on_batch_export"),
+        Item("Pythonスクリプトとしてエクスポート...", "_on_export_python_script"),
+        Item("LaTeX/Word用キャプションを生成...", "_on_generate_caption"),
+        Item("実験レポートを生成 (HTML/PDF)...", "_on_generate_report"),
+    )),
+    SEPARATOR,
+    Item("オートセーブ間隔を設定(&I)...", "_on_configure_autosave_interval", attr="autosave_interval_action",
+         after="_update_autosave_menu_text"),
+    Item("自動バックアップ履歴から復元(&H)...", "_on_show_autosave_history"),
+    SEPARATOR,
+    Item("設定・スタイルをエクスポート(&X)...", "_on_export_settings"),
+    Item("設定・スタイルをインポート(&M)...", "_on_import_settings"),
+))
+
+EDIT_MENU = TopMenu("編集(&E)", "_edit_menu", (
+    Custom(_add_undo_redo),
+    SEPARATOR,
+    Item("環境設定(&P)...", "_on_show_preferences"),
+    Custom(_add_command_palette),
+))
+
+# 右クリックと同じ中身を開くたびに作る(片方だけに項目を足さないため)
+DATASET_MENU = TopMenu("データセット(&D)", "_dataset_menu", action_attr="_dataset_menu_action",
+                       on_show="_populate_dataset_menu", fill_now=True)
+
+VIEW_MENU = TopMenu("表示(&V)", "_view_menu", (
+    DockToggle("ui.control_dock_widget", "プロパティパネル"),
+    DockToggle("export_preview_dock_widget", "エクスポートプレビュー"),
+    DockToggle("residual_dock_widget", "残差プロット"),
+    DockToggle("provenance_dock_widget", "処理履歴"),
+    Item("ミニマップ(レンジスライダー)", "_on_toggle_minimap", attr="minimap_action", checked="minimap_visible"),
+    Item("キャンバスを別ウィンドウに切り離す", "_on_toggle_canvas_detached", attr="canvas_detach_action",
+         checked="canvas_detached"),
+    Item("パネルラベルを自動表示 ((a)(b)(c)...)", "_on_toggle_panel_labels", attr="panel_labels_action",
+         checked="project.panel_labels_enabled"),
+    Item("色覚シミュレーションプレビュー...", "_on_show_cvd_simulation", attr="cvd_simulation_action"),
+    Submenu("ドックレイアウト", attr="_dock_layout_menu", action_attr="_dock_layout_menu_action", items=(
+        Item("現在のレイアウトを保存...", "_on_save_dock_layout_preset", attr="_save_layout_action"),
+        Submenu("レイアウトを読み込み", attr="load_layout_menu", action_attr="_load_layout_menu_action",
+                on_show="_populate_load_layout_menu"),
+        SEPARATOR,
+        Item("既定のレイアウトにリセット", "_on_reset_dock_layout", attr="_reset_layout_action"),
+    )),
+    # クイックアクセスのツールバーはここで作る(表示メニューの項目と同じ順番で組み立てる必要がある)
+    Call("_create_quick_access_toolbar"),
+    SEPARATOR,
+    Item("ダークモード", "_on_toggle_dark_mode", attr="dark_mode_action", checked="canvas.dark_mode"),
+))
+
+HELP_MENU = TopMenu("ヘルプ(&H)", "_help_menu", (
+    Item("mathtext リファレンス...", "_on_show_help"),
+    Item("列計算機能 リファレンス...", "_on_show_calc_help"),
+    Item("キーボードショートカット一覧...", "_on_show_shortcuts"),
+    SEPARATOR,
+    Item("診断情報をエクスポート...", "_on_export_diagnostic_bundle"),
+    Item("アップデートを確認...", "_on_check_for_update"),
+    SEPARATOR,
+    Item("{app} について...", "_on_show_about"),
+))
+
+
+def _resolve(app, dotted):
+    obj = app
+    for part in dotted.split('.'):
+        obj = getattr(obj, part)
+    return obj
+
+
+def _set_attr(app, name, value):
+    if name:
+        setattr(app, name, value)
+
+
+def _add_items(app, menu, items, keep):
+    for item in items:
+        if item is SEPARATOR:
+            menu.addSeparator()
+        elif isinstance(item, Item):
+            action = menu.addAction(tr(item.text).format(app=APP_NAME) if '{app}' in item.text else tr(item.text))
+            if item.shortcut is not None:
+                action.setShortcut(item.shortcut)
+            slot = getattr(app, item.slot)
+            if item.checked is not None:
+                action.setCheckable(True)
+                action.setChecked(_resolve(app, item.checked))
+                action.toggled.connect(slot)
+            else:
+                action.triggered.connect(slot)
+            keep.append(action)
+            _set_attr(app, item.attr, action)
+            if item.after:
+                getattr(app, item.after)()
+        elif isinstance(item, Submenu):
+            submenu = menu.addMenu(tr(item.text))
+            _hold_menu(app, submenu, item.attr, item.action_attr, keep)
+            _add_items(app, submenu, item.items, keep)
+            _connect_on_show(app, submenu, item.on_show, item.fill_now)
+            if item.after:
+                getattr(app, item.after)()
+        elif isinstance(item, DockToggle):
+            action = _resolve(app, item.dock).toggleViewAction()
+            action.setText(tr(item.text))
+            menu.addAction(action)
+            keep.append(action)
+        elif isinstance(item, Call):
+            getattr(app, item.method)()
+        elif isinstance(item, Custom):
+            item.build(app, menu, keep)
+        else:
+            raise TypeError(f"メニューの一覧表に知らない要素があります: {item!r}")
+
+
+def _hold_menu(app, menu, attr, action_attr, keep):
+    # QMenu だけでなく、開くための menuAction も持つ(こちらが回収されるとメニューごと消える)
+    keep.extend([menu, menu.menuAction()])
+    _set_attr(app, attr, menu)
+    _set_attr(app, action_attr, menu.menuAction())
+
+
+def _connect_on_show(app, menu, on_show, fill_now):
+    if on_show:
+        menu.aboutToShow.connect(getattr(app, on_show))
+        if fill_now:
+            getattr(app, on_show)()
+
+
+def _add_top_menu(app, menu_bar, top, keep):
+    menu = menu_bar.addMenu(tr(top.text))
+    _hold_menu(app, menu, top.attr, top.action_attr, keep)
+    _add_items(app, menu, top.items, keep)
+    _connect_on_show(app, menu, top.on_show, top.fill_now)
+    return menu
+
+
+def _add_plugin_menu(app, menu_bar, keep):
+    """プラグインがメニュー項目・データ処理・解析・パネルのどれかを登録しているときだけ作る。"""
+    api = app.plugin_api
+    processors = api.get_processors()
+    analyzers = api.get_analyzers()
+    if not (api.menu_actions or processors or analyzers or app._plugin_panel_docks):
+        return
+    plugin_menu = menu_bar.addMenu(tr("プラグイン(&P)"))
+    _hold_menu(app, plugin_menu, "_plugin_menu", None, keep)
+    for menu_action in api.menu_actions:
+        action = plugin_menu.addAction(menu_action.text)
+        if menu_action.shortcut:
+            action.setShortcut(QKeySequence(menu_action.shortcut))
+        action.triggered.connect(lambda checked=False, ma=menu_action: app._run_plugin_menu_action(ma))
+        keep.append(action)
+
+    if processors:
+        if api.menu_actions:
+            plugin_menu.addSeparator()
+        processing_menu = plugin_menu.addMenu(tr("データ処理"))
+        _hold_menu(app, processing_menu, None, None, keep)
+        by_category = {}
+        for proc in processors:
+            by_category.setdefault(proc.category, []).append(proc)
+        for category in sorted(by_category.keys()):
+            category_menu = processing_menu.addMenu(category)
+            _hold_menu(app, category_menu, None, None, keep)
+            for proc in sorted(by_category[category], key=lambda p: p.name):
+                action = category_menu.addAction(proc.name)
+                action.triggered.connect(lambda checked=False, p=proc: app.plugin_runs.run_processor(p))
+                keep.append(action)
+
+    if analyzers:
+        if api.menu_actions or processors:
+            plugin_menu.addSeparator()
+        analysis_menu = plugin_menu.addMenu(tr("解析"))
+        _hold_menu(app, analysis_menu, None, None, keep)
+        for analyzer in sorted(analyzers, key=lambda a: a.name):
+            action = analysis_menu.addAction(analyzer.name)
+            action.triggered.connect(lambda checked=False, a=analyzer: app.plugin_runs.run_analyzer(a))
+            keep.append(action)
+
+    if app._plugin_panel_docks:
+        if api.menu_actions or processors or analyzers:
+            plugin_menu.addSeparator()
+        panel_menu = plugin_menu.addMenu(tr("パネル"))
+        _hold_menu(app, panel_menu, None, None, keep)
+        for name in sorted(app._plugin_panel_docks.keys()):
+            action = app._plugin_panel_docks[name].toggleViewAction()
+            panel_menu.addAction(action)
+            keep.append(action)
+
+
+def build_menu_bar(app):
+    """app のメニューバーを一覧表から組み立てる。__init__ から1回だけ呼ぶ。"""
+    keep = []
+    app._menu_keepalive = keep
+    menu_bar = app.menuBar()
+    for top in (FILE_MENU, EDIT_MENU, DATASET_MENU, VIEW_MENU):
+        _add_top_menu(app, menu_bar, top, keep)
+    # アプリ全体のスタイル(Fusion)とテーマを当て直す(何度呼んでも同じ)
+    apply_theme(QApplication.instance(), app.canvas.dark_mode)
+    _add_plugin_menu(app, menu_bar, keep)
+    _add_top_menu(app, menu_bar, HELP_MENU, keep)

graphica/gui/minimap_widget.py

@@ -0,0 +1,151 @@
+"""グラフの下の小さな全体図。ドラッグで選んだ範囲を range_selected で知らせる(軸に当てるのは呼び出し側)。
+
+メインのキャンバスとは別の Figure なので、redraw_all() では描き直されない。データが変わったら refresh() を呼ぶこと。
+"""
+import logging
+
+import numpy as np
+from matplotlib.backends.backend_qtagg import FigureCanvasQTAgg as FigureCanvas
+from matplotlib.figure import Figure
+from matplotlib.widgets import SpanSelector
+from PySide6.QtCore import Signal
+
+from graphica.core.analysis import calculate_lttb_downsample
+from graphica.core.dataset import COLOR_BY_COLUMN_PLOT_TYPE
+
+logger = logging.getLogger(__name__)
+
+# 点で描く種類。Line+Scatter は線が主なので含めない
+MINIMAP_POINT_PLOT_TYPES = frozenset({'Scatter', 'Density Scatter', COLOR_BY_COLUMN_PLOT_TYPE})
+
+MINIMAP_HEIGHT_PX = 70
+
+# 間引く。SpanSelector の背景は全体を描いた画像で、refresh() のたびに作り直すので、点が多いとドラッグが重くなる。
+# 幅が数百 px しかないので、canvas の LTTB より少ない点でよい
+MINIMAP_DOWNSAMPLE_THRESHOLD = 2000
+MINIMAP_DOWNSAMPLE_TARGET_POINTS = 500
+
+# gui/canvas.py の配色と揃える
+DARK_FIGURE_FACECOLOR = '#2b2b2b'
+# 周りのパネルと同じ寒色寄りの色味で、少しだけ暗くして一段くぼんだ領域に見せる
+DARK_AXES_FACECOLOR = '#0E1114'
+DARK_LINE_COLOR = '#8ab4f8'
+DARK_SPAN_COLOR = '#8ab4f8'
+LIGHT_FIGURE_FACECOLOR = '#ffffff'
+LIGHT_AXES_FACECOLOR = '#E3E6EB'
+LIGHT_LINE_COLOR = '#1a73e8'
+LIGHT_SPAN_COLOR = '#1a73e8'
+
+
+class MinimapWidget(FigureCanvas):
+    range_selected = Signal(float, float)
+
+    def __init__(self, parent=None, dpi=100):
+        self.fig = Figure(figsize=(5, 0.7), dpi=dpi)
+        super().__init__(self.fig)
+        self.setParent(parent)
+        self.setFixedHeight(MINIMAP_HEIGHT_PX)
+
+        self.ax = self.fig.add_subplot(111)
+        self.dark_mode = False
+        self._span_selector = None
+
+        self._configure_axes_style()
+        self._create_span_selector()
+        self._apply_theme_colors()
+
+
+    def _configure_axes_style(self):
+        self.ax.set_yticks([])
+        self.ax.tick_params(axis='x', labelsize=6)
+        for spine in ('top', 'right', 'left'):
+            self.ax.spines[spine].set_visible(False)
+        self.fig.subplots_adjust(left=0.02, right=0.98, top=0.92, bottom=0.28)
+
+    def _create_span_selector(self):
+        """SpanSelector を作り直す(ax.cla() が選択の矩形も消すので、refresh() のたびに)。
+
+        古いものの接続は切る。matplotlib は cla() でも切らないので、残すと溜まって range_selected が重複して出る。
+        """
+        if getattr(self, '_span_selector', None) is not None:
+            self._span_selector.disconnect_events()
+        span_color = DARK_SPAN_COLOR if self.dark_mode else LIGHT_SPAN_COLOR
+        self._span_selector = SpanSelector(
+            self.ax,
+            self._on_select,
+            'horizontal',
+            useblit=True,
+            props=dict(alpha=0.3, facecolor=span_color),
+            interactive=True,
+            drag_from_anywhere=True,
+        )
+
+    def _apply_theme_colors(self):
+        fig_face = DARK_FIGURE_FACECOLOR if self.dark_mode else LIGHT_FIGURE_FACECOLOR
+        axes_face = DARK_AXES_FACECOLOR if self.dark_mode else LIGHT_AXES_FACECOLOR
+        self.fig.set_facecolor(fig_face)
+        self.ax.set_facecolor(axes_face)
+
+    def _on_select(self, xmin, xmax):
+        if xmin == xmax:
+            # クリックだけ(ドラッグなし)は選択とみなさない
+            return
+        self.range_selected.emit(xmin, xmax)
+
+    @staticmethod
+    def _downsample_for_overview(x, y):
+        """点を減らす。X が昇順なら LTTB、そうでなければ等間隔に間引く(LTTB は昇順が前提)。"""
+        n = len(x)
+        if n <= MINIMAP_DOWNSAMPLE_THRESHOLD:
+            return x, y
+        if np.all(np.diff(x) >= 0):
+            idx = calculate_lttb_downsample(x, y, MINIMAP_DOWNSAMPLE_TARGET_POINTS)
+        else:
+            step = max(1, n // MINIMAP_DOWNSAMPLE_TARGET_POINTS)
+            idx = np.arange(0, n, step)
+        return x[idx], y[idx]
+
+
+    def refresh(self, datasets, dark_mode=False):
+        """各データセットの X/Y を薄い線か点で重ねるだけの簡単な全体図にする。"""
+        self.dark_mode = dark_mode
+        self.ax.cla()
+        self._configure_axes_style()
+        self._apply_theme_colors()
+
+        line_color = DARK_LINE_COLOR if dark_mode else LIGHT_LINE_COLOR
+        has_data = False
+        for ds in datasets:
+            # メインと同じく隠した系列は出さない
+            if not getattr(ds, 'visible', True):
+                continue
+            # 2D マップの x/y は測定点の列なので、線にすると意味が無い。描かない
+            if getattr(ds, 'data_kind', '1d') == '2d_grid':
+                continue
+            try:
+                x = ds.x_data
+                y = ds.y_data
+            except Exception:
+                logger.debug("ミニマップ用のデータを取り出せません: %s", ds.name, exc_info=True)
+                continue
+            if x is None or len(x) == 0:
+                continue
+            try:
+                x, y = self._downsample_for_overview(x, y)
+                if getattr(ds, 'plot_type', 'Line') in MINIMAP_POINT_PLOT_TYPES:
+                    # 点の種類は点で描く(線にするとピーク検出の結果がピーク同士を結ぶ線になる)
+                    self.ax.plot(x, y, linestyle='None', marker='o', markersize=1.8,
+                                 color=line_color, alpha=0.8)
+                else:
+                    self.ax.plot(x, y, color=line_color, linewidth=0.7, alpha=0.6)
+                has_data = True
+            except Exception:
+                # 全体図なので、描けなくても止めない
+                logger.debug("ミニマップへのデータセット描画に失敗しました", exc_info=True)
+
+        if has_data:
+            self.ax.relim()
+            self.ax.autoscale_view()
+
+        self._create_span_selector()
+        self.draw_idle()