graphica-plot 2.0.0__py3-none-any.whl

graphica/gui/app_settings.py

@@ -0,0 +1,119 @@
+"""アプリの設定(QSettings)のキー・型・既定値の表と、設定を開く唯一の場所。
+
+読み方は今の挙動をそのまま写している。型を指定しないキー(value_type が None)は INI 形式では真偽や数が文字列で返り、
+要素が 1 つのリストは文字列で返ることがある。どちらも読む側の扱いまで含めて挙動なので、型の有無を変えないこと。
+"""
+from dataclasses import dataclass
+from typing import Any
+
+from PySide6.QtCore import QSettings
+
+from graphica.core.i18n import DEFAULT_LANGUAGE
+
+ORGANIZATION_NAME = "Graphica"
+APPLICATION_NAME = "Graphica"
+
+DEFAULT_AUTOSAVE_INTERVAL_MIN = 5  # 0 で無効
+# これより点が多いデータセットには点ラベルを描かない(annotate が点の数だけ呼ばれて固まる)。環境設定で変えられる
+DEFAULT_POINT_LABEL_MAX_POINTS = 1000
+DEFAULT_SNAP_TO_GRID_ENABLED = False
+DEFAULT_SNAP_GRID_INTERVAL_PX = 10
+
+CANVAS_DETACHED_GEOMETRY_KEY = "canvas_detached_geometry"
+CANVAS_WAS_DETACHED_KEY = "canvas_was_detached"
+# 名前を付けて保存するドック配置(起動時に戻す直近の window_state とは別)
+DOCK_LAYOUT_PRESETS_SETTINGS_KEY = "dock_layout_presets"
+# 閉じている節のキーの JSON 配列。無い・空なら全部開く(節を足しても既定は開いたまま)
+DATASET_PROPERTY_COLLAPSED_SECTIONS_KEY = "dataset_property_collapsed_sections"
+DISABLED_PLUGINS_SETTINGS_KEY = "disabled_plugins"
+QUICK_ACCESS_SETTINGS_KEY = "quick_access_pinned_actions"
+COLOR_PALETTES_SETTINGS_KEY = "custom_color_palettes_json"
+ACTIVE_PALETTE_SETTINGS_KEY = "active_color_palette"
+RECENT_COLORS_SETTINGS_KEY = "recent_colors"
+
+_TABLE_DEFAULT = object()
+
+
+def open_settings() -> QSettings:
+    """アプリの設定を開く。QSettings を作るのはここだけ(テストはこのモジュールの QSettings を差し替えて隔離する)。"""
+    return QSettings(ORGANIZATION_NAME, APPLICATION_NAME)
+
+
+@dataclass(frozen=True)
+class Setting:
+    key: str
+    default: Any = None
+    value_type: type | None = None       # None なら型を指定せずに読む
+    export_as: type | None = None        # 設定の書き出しに入れるときの型(list は要素 1 つを直して読む)
+    export_default: Any = _TABLE_DEFAULT  # 書き出しのときだけ既定値が違うもの
+
+    def read(self, settings: QSettings, default: Any = _TABLE_DEFAULT) -> Any:
+        """default を渡すのは、読む場所によって既定値が違うところ(今の挙動)だけ。"""
+        fallback = self.default if default is _TABLE_DEFAULT else default
+        if self.value_type is None:
+            return settings.value(self.key, fallback)
+        return settings.value(self.key, fallback, type=self.value_type)
+
+    def write(self, settings: QSettings, value: Any) -> None:
+        settings.setValue(self.key, value)
+
+    def read_for_export(self, settings: QSettings) -> Any:
+        default = self.default if self.export_default is _TABLE_DEFAULT else self.export_default
+        if self.export_as is list:
+            return as_list(settings.value(self.key, default))
+        return settings.value(self.key, default, type=self.export_as)
+
+
+def as_list(value: Any) -> Any:
+    """要素 1 つのリストが文字列で返ったのを直す。空の文字列は空のリスト(設定の書き出し・最近使った色の読み方)。"""
+    if isinstance(value, str):
+        return [value] if value else []
+    return value
+
+
+def as_list_keeping_empty_string(value: Any) -> list[Any]:
+    """要素 1 つのリストが文字列で返ったのを直す(最近使ったファイル・クイックアクセスの読み方)。"""
+    if isinstance(value, str):
+        value = [value]
+    return list(value) if value else []
+
+
+LANGUAGE = Setting("language", DEFAULT_LANGUAGE, export_as=str, export_default="")
+DARK_MODE = Setting("dark_mode", False, bool, export_as=bool)
+AUTOSAVE_INTERVAL_MIN = Setting("autosave_interval_min", DEFAULT_AUTOSAVE_INTERVAL_MIN, int, export_as=int)
+AUTOSAVE_DIR = Setting("autosave_dir", "", str)
+POINT_LABEL_MAX_POINTS = Setting("point_label_max_points", DEFAULT_POINT_LABEL_MAX_POINTS, int, export_as=int)
+SNAP_TO_GRID_ENABLED = Setting("snap_to_grid_enabled", DEFAULT_SNAP_TO_GRID_ENABLED, bool, export_as=bool)
+SNAP_GRID_INTERVAL_PX = Setting("snap_grid_interval_px", DEFAULT_SNAP_GRID_INTERVAL_PX, int, export_as=int)
+CUSTOM_COLOR_PALETTES = Setting(COLOR_PALETTES_SETTINGS_KEY, "", export_as=str)
+# 画面の既定は配色パレットのダイアログの既定の名前(読む側が渡す)。書き出しでは空
+ACTIVE_COLOR_PALETTE = Setting(ACTIVE_PALETTE_SETTINGS_KEY, None, export_as=str, export_default="")
+QUICK_ACCESS_PINNED_ACTIONS = Setting(QUICK_ACCESS_SETTINGS_KEY, [], export_as=list)
+DISABLED_PLUGINS = Setting(DISABLED_PLUGINS_SETTINGS_KEY, [], export_as=list)
+
+CLEAN_EXIT = Setting("clean_exit", True, bool)
+HAS_SHOWN_WELCOME = Setting("has_shown_welcome", False, bool)
+MINIMAP_VISIBLE = Setting("minimap_visible", True, bool)
+RECENT_FILES = Setting("recent_files", [])
+RECENT_COLORS = Setting(RECENT_COLORS_SETTINGS_KEY, [])
+WINDOW_GEOMETRY = Setting("window_geometry")
+WINDOW_STATE = Setting("window_state")
+DOCK_LAYOUT_VERSION = Setting("dock_layout_version", 0, int)
+DOCK_LAYOUT_PRESETS = Setting(DOCK_LAYOUT_PRESETS_SETTINGS_KEY, "{}")
+DATASET_PROPERTY_COLLAPSED_SECTIONS = Setting(DATASET_PROPERTY_COLLAPSED_SECTIONS_KEY, "[]")
+CANVAS_WAS_DETACHED = Setting(CANVAS_WAS_DETACHED_KEY, False, bool)
+CANVAS_DETACHED_GEOMETRY = Setting(CANVAS_DETACHED_GEOMETRY_KEY)
+
+# 設定の書き出し(別の PC や研究室での共有用)に入れるもの。JSON の並びはこの順
+EXPORTED_SETTINGS: tuple[Setting, ...] = (
+    LANGUAGE, DARK_MODE, AUTOSAVE_INTERVAL_MIN, POINT_LABEL_MAX_POINTS, SNAP_TO_GRID_ENABLED, SNAP_GRID_INTERVAL_PX,
+    CUSTOM_COLOR_PALETTES, ACTIVE_COLOR_PALETTE, QUICK_ACCESS_PINNED_ACTIONS, DISABLED_PLUGINS,
+)
+
+
+def disabled_plugin_names(settings: QSettings) -> set[str]:
+    """QSettings は要素が1つのリストを文字列で返すことがあるので直す。"""
+    names = DISABLED_PLUGINS.read(settings)
+    if isinstance(names, str):
+        names = [names]
+    return set(names) if names else set()

graphica/gui/axis_bindings.py

@@ -0,0 +1,173 @@
+"""軸の設定(core/axis_settings.py のキー)と画面の欄の対応表。欄を 1 つ足すときは表に 1 行足す。
+
+表の順は戻す順。集めた辞書のキーの順は AXIS_SETTING_DEFAULTS の順(保存形式)にそろえる。
+"""
+from PySide6.QtGui import QFont
+
+from graphica.core.unit_conversion import X_AXIS_UNIT_CHOICES
+from graphica.gui.binding import Binding, check, choice, index, item_data, number, shown_text, text
+from graphica.gui.canvas import MINOR_TICK_LENGTH_AUTO
+
+_CHANGED = ('_on_axis_setting_changed',)
+
+# 欄を持たず操作から直接書き込まれるキー。集めるときは今の軸の設定から引き継ぐ(辞書は丸ごと入れ替わるので)
+CARRIED_AXIS_KEYS = ('annotations', 'legend_order', 'free_rect', 'legend_position')
+
+# 戻す間は信号を止めるが、値は持たない欄
+AXIS_BUTTONS = (
+    'ui.tick_font_button', 'ui.tick_color_button', 'ui.axis_label_font_button', 'ui.axis_label_color_button',
+    'legend_font_button', 'legend_color_button', 'ui.spine_color_button',
+)
+
+
+def qfont_from_family_props(font_props: dict) -> QFont:
+    """'family' は候補のリストか、古いプロジェクトでは1つの名前。QFont(list) は無いので setFamilies() を使う。"""
+    family = font_props.get('family', 'Sans Serif')
+    if isinstance(family, (list, tuple)):
+        font = QFont()
+        if family:
+            font.setFamilies(list(family))
+        return font
+    return QFont(family)
+
+
+def _font(key, attribute, size_only_when_given=False):
+    """フォントは持ち主の属性に QFont で持つ。凡例は保存にサイズが無ければ QFont の既定のサイズのまま。"""
+    def read(owner, _widget):
+        return owner._font_props_to_dict(getattr(owner, attribute))
+
+    def write(owner, _widget, props):
+        setattr(owner, attribute, qfont_from_family_props(props))
+        font = getattr(owner, attribute)
+        if not size_only_when_given or 'size' in props:
+            font.setPointSize(props.get('size', 10))
+        font.setBold(props.get('weight') == 'bold')
+        font.setItalic(props.get('style') == 'italic')
+    return Binding(key, None, read, write)
+
+
+def _attribute(key, attribute):
+    return Binding(key, None, lambda owner, _w: getattr(owner, attribute),
+                   lambda owner, _w, value: setattr(owner, attribute, value))
+
+
+def _width(key, widget, attribute):
+    """線の太さは描画が持ち主の属性から読むので、欄と一緒に属性にも入れる。"""
+    def write(owner, spinbox, value):
+        setattr(owner, attribute, value)
+        spinbox.setValue(getattr(owner, attribute))
+    return Binding(key, widget, lambda _o, w: w.value(), write, 'valueChanged', _CHANGED)
+
+
+def _grid_linestyle(key, widget):
+    return Binding(key, widget, lambda owner, w: owner._grid_linestyle_code(w.currentIndex()),
+                   lambda owner, w, value: w.setCurrentIndex(owner._grid_linestyle_index(value)),
+                   'currentIndexChanged', _CHANGED)
+
+
+def _minor_tick_length(key, widget):
+    """負値(スピンボックスの「自動」)は -1 に正規化して保存する。"""
+    def read(_owner, spinbox):
+        return spinbox.value() if spinbox.value() >= 0 else -1
+
+    def write(_owner, spinbox, value):
+        spinbox.setValue(MINOR_TICK_LENGTH_AUTO if value is None or value < 0 else value)
+    return Binding(key, widget, read, write, 'valueChanged', _CHANGED)
+
+
+def _axis_rows(axis):
+    """X と Y で同じ並びの行。autoscale・目盛りの方式・補助目盛りの表示・対数は、見え方を切り替える処理もつなぐ。"""
+    ui = f'ui.{axis}'
+    return (
+        check(f'{axis}_autoscale', f'{ui}_autoscale_checkbox', _CHANGED + (f'_on_{axis}_autoscale_changed',)),
+        number(f'{axis}_min', f'{ui}_min_spinbox', _CHANGED),
+        number(f'{axis}_max', f'{ui}_max_spinbox', _CHANGED),
+        check(f'{axis}_log', f'{ui}_log_checkbox', _CHANGED + (f'_on_{axis}_minor_tick_visibility_changed',)),
+        check(f'{axis}_invert', f'{ui}_invert_checkbox', _CHANGED),
+        index(f'{axis}_major_tick_mode', f'{ui}_major_tick_mode_combo', _CHANGED + (f'_on_{axis}_tick_mode_changed',)),
+        number(f'{axis}_major_tick_interval', f'{ui}_major_tick_interval_spinbox', _CHANGED),
+        check(f'{axis}_minor_ticks_visible', f'{ui}_minor_ticks_visible_checkbox',
+              _CHANGED + (f'_on_{axis}_minor_tick_visibility_changed',)),
+        number(f'{axis}_minor_tick_interval', f'{ui}_minor_tick_interval_spinbox', _CHANGED),
+        # 対数軸のときだけ効く
+        item_data(f'{axis}_log_minor_subs', f'{axis}_log_minor_subs_combo', _CHANGED),
+        check(f'{axis}_log_minor_labels', f'{axis}_log_minor_labels_checkbox', _CHANGED),
+        index(f'{axis}_tick_format_mode', f'{axis}_tick_format_combo', _CHANGED),
+        number(f'{axis}_tick_decimals', f'{axis}_tick_decimals_spinbox', _CHANGED),
+    )
+
+
+def _grid_rows(axis, which):
+    name = f'{axis}_{which}_grid'
+    return (
+        _grid_linestyle(f'{name}_linestyle', f'{name}_linestyle_combo'),
+        number(f'{name}_width', f'{name}_width_spinbox', _CHANGED),
+        number(f'{name}_alpha', f'{name}_alpha_spinbox', _CHANGED),
+    )
+
+
+AXIS_BINDINGS = (
+    text('title', 'ui.title_text_edit', _CHANGED),
+    text('x_label', 'ui.x_label_text_edit', _CHANGED),
+    text('y_label', 'ui.y_label_text_edit', _CHANGED),
+    check('x_label_visible', 'x_label_visible_checkbox', _CHANGED),
+    check('y_label_visible', 'y_label_visible_checkbox', _CHANGED),
+    text('y2_label', 'y2_label_text_edit', _CHANGED),
+
+    *_axis_rows('x'),
+    choice('x_secondary_axis_source_unit', 'x_secondary_axis_source_unit_combo', X_AXIS_UNIT_CHOICES, _CHANGED),
+    choice('x_secondary_axis_target_unit', 'x_secondary_axis_target_unit_combo', X_AXIS_UNIT_CHOICES, _CHANGED),
+
+    *_axis_rows('y'),
+
+    check('legend_visible', 'ui.legend_visible_checkbox', _CHANGED + ('_on_legend_visibility_changed',)),
+    # ドラッグした位置を消してから書き戻すので、ほかの欄と違う処理につなぐ
+    shown_text('legend_loc', 'legend_loc_combo', ('_on_legend_loc_changed',)),
+    # グリッドのチェックは補助グリッドと詳細の欄の有効/無効も切り替える
+    check('grid_visible', 'ui.grid_visible_checkbox', _CHANGED + ('_on_grid_visibility_changed',)),
+    check('minor_grid_visible', 'ui.minor_grid_visible_checkbox', _CHANGED + ('_on_grid_visibility_changed',)),
+
+    *_grid_rows('x', 'major'),
+    *_grid_rows('x', 'minor'),
+    *_grid_rows('y', 'major'),
+    *_grid_rows('y', 'minor'),
+    shown_text('major_tick_direction', 'major_tick_direction_combo', _CHANGED),
+    shown_text('minor_tick_direction', 'minor_tick_direction_combo', _CHANGED),
+    shown_text('major_tick_direction_y2', 'major_tick_direction_y2_combo', _CHANGED),
+    shown_text('minor_tick_direction_y2', 'minor_tick_direction_y2_combo', _CHANGED),
+    check('x_ticks_visible', 'x_ticks_visible_checkbox', _CHANGED),
+    check('x_tick_labels_visible', 'x_tick_labels_visible_checkbox', _CHANGED),
+    check('y_ticks_visible', 'y_ticks_visible_checkbox', _CHANGED),
+    check('y_tick_labels_visible', 'y_tick_labels_visible_checkbox', _CHANGED),
+
+    _font('tick_font', '_tick_font'),
+    _font('axis_label_font', '_axis_label_font'),
+    _font('legend_font', '_legend_font', size_only_when_given=True),
+    _attribute('tick_color', '_tick_color'),
+    _width('tick_width', 'ui.tick_width_spinbox', '_tick_width'),
+    number('major_tick_length', 'major_tick_length_spinbox', _CHANGED),
+    _minor_tick_length('minor_tick_length', 'minor_tick_length_spinbox'),
+    _attribute('axis_label_color', '_axis_label_color'),
+    _attribute('legend_color', '_legend_color'),
+    _width('spine_width', 'ui.spine_width_spinbox', '_spine_width'),
+    _attribute('spine_color', '_spine_color'),
+
+    # 2Dマップが無い軸では効かない
+    check('colorbar_enabled', 'colorbar_enabled_checkbox', _CHANGED),
+    item_data('colorbar_position', 'colorbar_position_combo', _CHANGED),
+    number('colorbar_width_fraction', 'colorbar_width_spinbox', _CHANGED),
+    text('colorbar_label', 'colorbar_label_edit', _CHANGED),
+
+    # 第 2 Y 軸。見え方(有効・無効)の切り替えもつなぐ
+    # 範囲を欄に入れてから設定を集め直す(_on_y2_autoscale_changed が最後に _on_axis_setting_changed を呼ぶ)。
+    # 先に描き直すと、欄の古い値で範囲が決まってしまい、今の範囲を入れられない
+    check('y2_autoscale', 'y2_autoscale_checkbox', ('_on_y2_autoscale_changed',)),
+    number('y2_min', 'y2_min_spinbox', _CHANGED),
+    number('y2_max', 'y2_max_spinbox', _CHANGED),
+    check('y2_log', 'y2_log_checkbox', _CHANGED + ('_on_y2_axis_state_changed',)),
+    check('y2_invert', 'y2_invert_checkbox', _CHANGED),
+    index('y2_major_tick_mode', 'y2_major_tick_mode_combo', _CHANGED + ('_on_y2_axis_state_changed',)),
+    number('y2_major_tick_interval', 'y2_major_tick_interval_spinbox', _CHANGED),
+    check('y2_minor_ticks_visible', 'y2_minor_ticks_visible_checkbox', _CHANGED + ('_on_y2_axis_state_changed',)),
+    number('y2_minor_tick_interval', 'y2_minor_tick_interval_spinbox', _CHANGED),
+)

graphica/gui/binding.py

@@ -0,0 +1,135 @@
+"""画面の欄と設定の辞書のキーの対応(バインディング)を表で持ち、集める・戻す・信号を止める・つなぐを表から行う。
+
+表の順が戻す順になる。戻す順は値に効く(スピンボックスの範囲による丸め、途中の例外でどこまで入ったか)ので、
+行を並べ替えるときは戻したあとの欄の値が変わらないことを確かめる。
+"""
+from dataclasses import dataclass
+from typing import Any, Callable
+
+
+@dataclass(frozen=True)
+class Binding:
+    key: str
+    # 持ち主からの属性の道筋("ui.x_min_spinbox")。None は欄を持たず持ち主の属性に持つもの(フォントと色)
+    widget: str | None
+    # 欄から値を読む。None は戻すだけの欄(変更は専用の処理が受ける)
+    read: Callable[[Any, Any], Any] | None
+    write: Callable[[Any, Any, Any], None]
+    # 変更の信号の名前。None ならここではつながない
+    signal: str | None = None
+    # 信号につなぐ持ち主のメソッドの道筋("property_panel.on_x")か WATCH。つないだ順に呼ばれる
+    slots: tuple[Any, ...] = ()
+    # 保存元から値を取り出す。None ならキーで引く
+    load: Callable[[Any], Any] | None = None
+
+
+# slots に置くと、Binder.connect に渡した watch(signal, widget) でつなぐ
+WATCH = object()
+
+
+def text(key, widget, slots):
+    return Binding(key, widget, lambda _o, w: w.text(), lambda _o, w, v: w.setText(v), 'textChanged', slots)
+
+
+def check(key, widget, slots, signal='stateChanged'):
+    return Binding(key, widget, lambda _o, w: w.isChecked(), lambda _o, w, v: w.setChecked(v), signal, slots)
+
+
+def number(key, widget, slots):
+    return Binding(key, widget, lambda _o, w: w.value(), lambda _o, w, v: w.setValue(v), 'valueChanged', slots)
+
+
+def index(key, widget, slots):
+    return Binding(key, widget, lambda _o, w: w.currentIndex(), lambda _o, w, v: w.setCurrentIndex(v),
+                   'currentIndexChanged', slots)
+
+
+def shown_text(key, widget, slots):
+    return Binding(key, widget, lambda _o, w: w.currentText(), lambda _o, w, v: w.setCurrentText(v),
+                   'currentTextChanged', slots)
+
+
+def item_data(key, widget, slots):
+    """選択肢に持たせたデータ。見つからない値は先頭の選択肢にする。"""
+    def write(_owner, combo, value):
+        found = combo.findData(value)
+        combo.setCurrentIndex(found if found != -1 else 0)
+    return Binding(key, widget, lambda _o, w: w.currentData(), write, 'currentIndexChanged', slots)
+
+
+def found_text(key, widget, slots):
+    """選択肢の文字。見つからない値は先頭の選択肢にする。"""
+    def write(_owner, combo, value):
+        found = combo.findText(value)
+        combo.setCurrentIndex(found if found != -1 else 0)
+    return Binding(key, widget, lambda _o, w: w.currentText(), write, 'currentTextChanged', slots)
+
+
+def choice(key, widget, choices, slots):
+    """選択肢の番号と choices の値の対応。見つからない値は先頭の選択肢にする。"""
+    def write(_owner, combo, value):
+        combo.setCurrentIndex(choices.index(value) if value in choices else 0)
+    return Binding(key, widget, lambda _o, w: choices[w.currentIndex()], write, 'currentIndexChanged', slots)
+
+
+def resolve(owner, path):
+    obj = owner
+    for part in path.split('.'):
+        obj = getattr(obj, part)
+    return obj
+
+
+class Binder:
+    """持ち主(PlotterApp)と表から、集める・戻す・止める・つなぐを行う。欄は組み立ての途中で差し替わるので毎回引く。"""
+
+    def __init__(self, owner, bindings, also_blocked=()):
+        self._owner = owner
+        self._bindings = tuple(bindings)
+        # 表に無いが、戻す間は信号を止める欄(フォントと色のボタン)
+        self._also_blocked = tuple(also_blocked)
+
+    @property
+    def bindings(self):
+        return self._bindings
+
+    def _widget(self, binding):
+        return None if binding.widget is None else resolve(self._owner, binding.widget)
+
+    def gather(self):
+        return {b.key: b.read(self._owner, self._widget(b)) for b in self._bindings}
+
+    def binding_for(self, widget):
+        """欄から値を読む行のうち、その欄のもの。無ければ None。"""
+        for binding in self._bindings:
+            if binding.read is not None and binding.widget is not None and self._widget(binding) is widget:
+                return binding
+        return None
+
+    def read(self, binding):
+        return binding.read(self._owner, self._widget(binding))
+
+    def restore(self, source, lookup):
+        """source の値を表の順に戻す(行に load が無ければ lookup(source, key) で引く)。
+        例外はそのまま上げる(そこまでに入れた欄はそのまま残る)。"""
+        for binding in self._bindings:
+            value = binding.load(source) if binding.load is not None else lookup(source, binding.key)
+            binding.write(self._owner, self._widget(binding), value)
+
+    def block_signals(self, block):
+        for binding in self._bindings:
+            if binding.widget is not None:
+                self._widget(binding).blockSignals(block)
+        for path in self._also_blocked:
+            resolve(self._owner, path).blockSignals(block)
+
+    def connect(self, watch=None):
+        for binding in self._bindings:
+            if binding.signal is None:
+                continue
+            widget = self._widget(binding)
+            signal = getattr(widget, binding.signal)
+            for slot in binding.slots:
+                if slot is WATCH:
+                    watch(signal, widget)
+                else:
+                    signal.connect(resolve(self._owner, slot))

graphica/gui/builders/__init__.py

@@ -0,0 +1 @@
+"""PlotterApp の画面をパネルごとに組み立てる関数。"""