graphica-plot 2.0.0__py3-none-any.whl

graphica/core/methods_text.py

@@ -0,0 +1,115 @@
+"""処理の履歴(provenance)を日本語の説明にする。履歴パネルと「方法」の文で表記を揃えるため、ここに1つにする。"""
+from typing import TYPE_CHECKING, Any
+
+from graphica.core.fit_models import fit_type_label
+
+if TYPE_CHECKING:
+    from graphica.core.dataset import Dataset
+    from graphica.models.project import ProjectModel
+
+
+def describe_operation(provenance: dict[str, Any] | None) -> str:
+    """1つの処理を要約した文(履歴パネルの項目にも、方法の文の1文にも使える)。"""
+    if not provenance:
+        return "不明な操作"
+    operation = provenance.get('operation')
+    params: dict[str, Any] = provenance.get('params') or {}
+
+    if operation == 'savgol':
+        return (
+            f"Savitzky-Golayフィルタ(window={params.get('window_length')}, "
+            f"polyorder={params.get('polyorder')}, deriv={params.get('deriv')})"
+        )
+    if operation and operation.startswith('baseline_'):
+        method = operation[len('baseline_'):]
+        method_label = {
+            'als': 'ALS法', 'polynomial': '多項式法',
+            'rubberband': 'ラバーバンド法', 'manual': '手動点指定',
+        }.get(method, method)
+        return f"ベースライン補正({method_label})"
+    if operation == 'normalize':
+        mode = params.get('mode', '')
+        if mode == '特定X値での強度基準':
+            return f"規格化(X={params.get('reference_x')}での値基準)"
+        return f"規格化({mode})" if mode else "規格化"
+    if operation == 'resample':
+        return f"共通X格子へのリサンプリング/補間(手法: {params.get('method')})"
+    if operation == 'arithmetic':
+        error_note = "、誤差を伝播" if params.get('error_propagated') else ""
+        return f"データセット間演算({params.get('operation_symbol')}{error_note})"
+    if operation == 'mean_sd':
+        return f"複数データセットの平均±SD生成({params.get('n_source')}件、手法: {params.get('method')})"
+    if operation == 'cumulative_integral':
+        method_labels: dict[Any, str] = {'trapezoid': '台形則', 'simpson': 'Simpson則'}
+        method_label = method_labels.get(params.get('method'), params.get('method'))
+        return f"累積積分({method_label})"
+    if operation == 'average_duplicate_x':
+        return (
+            f"重複X値の平均化({params.get('n_duplicate_groups')}グループ、"
+            f"{params.get('n_points_in')}点 → {params.get('n_points_out')}点)"
+        )
+    if operation == 'xaxis_alignment':
+        shift = params.get('shift')
+        shift_text = f"{shift:+.4g}" if isinstance(shift, (int, float)) else "不明"
+        return f"X軸アライメント(相互相関、シフト量: {shift_text})"
+    if operation == 'histogram':
+        density_text = "確率密度" if params.get('density') else "度数"
+        return f"ヒストグラム(列: {params.get('column')}、{density_text}、ビン: {params.get('bins')})"
+    if operation == 'kde':
+        return f"カーネル密度推定(列: {params.get('column')}、評価点数: {params.get('n_points')})"
+    if operation in ('curve_fit', 'batch_curve_fit'):
+        fit_type = fit_type_label(params, '不明')
+        r_squared = params.get('r_squared')
+        r2_text = f", R²={r_squared:.4f}" if isinstance(r_squared, (int, float)) else ""
+        return f"カーブフィット({fit_type}{r2_text})"
+    if operation == 'multi_peak_fit':
+        return f"多峰分離フィット({params.get('component_type', '不明')} x{params.get('n_components', '?')})"
+    if operation == '2d_slice':
+        start, end = params.get('start'), params.get('end')
+        axis_labels: dict[Any, str] = {'x': 'X軸方向', 'y': 'Y軸方向', 'distance': '斜め方向'}
+        axis_label = axis_labels.get(params.get('axis_kind'), params.get('axis_kind'))
+        if start and end:
+            return (
+                f"2Dマップからの1Dスライス抽出({axis_label}、"
+                f"始点=({start[0]:.4g}, {start[1]:.4g}), 終点=({end[0]:.4g}, {end[1]:.4g}))"
+            )
+        return f"2Dマップからの1Dスライス抽出({axis_label})"
+    return operation or "不明な操作"
+
+
+def generate_methods_text(dataset: "Dataset", project: "ProjectModel") -> str:
+    """祖先から順に辿って「方法」の文にする。元データか、親が消されていればそこで止める(循環も止める)。"""
+    chain = []
+    visited = set()
+    current: "Dataset | None" = dataset
+    while current is not None and current.provenance and current.dataset_id not in visited:
+        visited.add(current.dataset_id)
+        chain.append(current.provenance)
+        source_ids = current.provenance.get('source_dataset_ids') or []
+        if len(source_ids) != 1:
+            # 親が複数(データセット間の演算など)なら一本の文にならないので、ここで止めて親の名前を並べる
+            break
+        source_id = source_ids[0]
+        current = next((ds for ds in project.datasets if ds.dataset_id == source_id), None)
+
+    if not chain:
+        return f"「{dataset.name}」は処理履歴を持たない元データです。"
+
+    chain.reverse()  # 古い処理から順に
+    steps = [describe_operation(prov) for prov in chain]
+
+    if len(steps) == 1:
+        body = steps[0]
+    else:
+        body = "、続いて".join(steps[:-1]) + f"を行った上で、{steps[-1]}"
+
+    root_provenance = chain[0]
+    root_source_names = root_provenance.get('source_dataset_names') or []
+    if len(root_source_names) > 1:
+        origin_text = "、".join(f"「{name}」" for name in root_source_names) + "を元データとして"
+    elif root_source_names:
+        origin_text = f"元データ「{root_source_names[0]}」に対し"
+    else:
+        origin_text = ""
+
+    return f"{origin_text}{body}を実施した(出力データセット: 「{dataset.name}」)。"

graphica/core/named_colors.py

@@ -0,0 +1,126 @@
+"""
+名前付きの色の登録簿(名前1つに色1つ)。同じ物質をどのプロジェクトでも同じ色で描くためのもの。
+配色パレット(core/color_palettes.py、順序付きの色のリスト)と混ぜると、パレット管理の
+「アクティブなパレット」の意味が壊れるので、QSettings のキーから別にしている。
+"""
+import json
+import re
+from typing import Any
+
+# 並び順がポップアップの表示順なので、辞書ではなく JSON の配列で保存する。
+NAMED_COLORS_SETTINGS_KEY = "named_colors_json"
+
+MAX_NAME_LENGTH = 60
+POPUP_LIMIT = 5  # これを超えた分は「すべての登録色...」から選ぶ
+
+_HEX_RE = re.compile(r'^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$')
+
+
+class NamedColorError(ValueError):
+    """メッセージはそのまま利用者に表示する。"""
+
+
+def normalize_color(value: Any) -> str:
+    """`#rgb` / `#rrggbb` を小文字の `#rrggbb` にする。QColor を使わないのは Qt 非依存にするため。"""
+    text = (value or "").strip()
+    if not _HEX_RE.match(text):
+        raise NamedColorError(f"色コードが不正です: {value!r}(例: #1f77b4)")
+    text = text.lower()
+    if len(text) == 4:
+        text = "#" + "".join(ch * 2 for ch in text[1:])
+    return text
+
+
+def normalize_name(value: Any) -> str:
+    name = (value or "").strip()
+    if not name:
+        raise NamedColorError("登録名を入力してください。")
+    if len(name) > MAX_NAME_LENGTH:
+        raise NamedColorError(f"登録名が長すぎます({MAX_NAME_LENGTH}文字まで)。")
+    return name
+
+
+def load_named_colors(settings: Any) -> list[dict[str, str]]:
+    """壊れたエントリは1件ずつ捨てる。設定が壊れても起動できなくなるよりは、登録が一部消える方がよい。"""
+    raw = settings.value(NAMED_COLORS_SETTINGS_KEY, "")
+    if not raw:
+        return []
+    try:
+        data = json.loads(raw) if isinstance(raw, str) else raw
+    except (ValueError, TypeError):
+        return []
+    if not isinstance(data, list):
+        return []
+
+    entries = []
+    seen = set()
+    for item in data:
+        if not isinstance(item, dict):
+            continue
+        try:
+            name = normalize_name(item.get("name"))
+            color = normalize_color(item.get("color"))
+        except NamedColorError:
+            continue
+        if name in seen:
+            continue
+        seen.add(name)
+        entries.append({"name": name, "color": color})
+    return entries
+
+
+def save_named_colors(settings: Any, entries: list[dict[str, str]]) -> None:
+    payload = [{"name": e["name"], "color": e["color"]} for e in entries]
+    settings.setValue(NAMED_COLORS_SETTINGS_KEY, json.dumps(payload, ensure_ascii=False))
+
+
+def find_index_by_name(entries: list[dict[str, str]], name: str) -> int:
+    target = (name or "").strip()
+    for index, entry in enumerate(entries):
+        if entry["name"] == target:
+            return index
+    return -1
+
+
+# 編集関数はどれも、引数のリストを変えずに新しいリストを返す。
+
+
+def add_named_color(entries: list[dict[str, str]], name: object, color: object) -> list[dict[str, str]]:
+    # 名前と色が1対1でないと、名前から色が決まらないので重複は禁止。
+    name = normalize_name(name)
+    color = normalize_color(color)
+    if find_index_by_name(entries, name) != -1:
+        raise NamedColorError(f"「{name}」は既に登録されています。")
+    return list(entries) + [{"name": name, "color": color}]
+
+
+def update_named_color(entries: list[dict[str, str]], index: int, name: object, color: object) -> list[dict[str, str]]:
+    if not 0 <= index < len(entries):
+        raise NamedColorError("編集対象が選択されていません。")
+    name = normalize_name(name)
+    color = normalize_color(color)
+    existing = find_index_by_name(entries, name)
+    if existing != -1 and existing != index:
+        raise NamedColorError(f"「{name}」は既に登録されています。")
+    updated = list(entries)
+    updated[index] = {"name": name, "color": color}
+    return updated
+
+
+def remove_named_color(entries: list[dict[str, str]], index: int) -> list[dict[str, str]]:
+    if not 0 <= index < len(entries):
+        raise NamedColorError("削除対象が選択されていません。")
+    updated = list(entries)
+    del updated[index]
+    return updated
+
+
+def move_named_color(entries: list[dict[str, str]], index: int, offset: int) -> list[dict[str, str]]:
+    if not 0 <= index < len(entries):
+        raise NamedColorError("移動対象が選択されていません。")
+    new_index = index + offset
+    if not 0 <= new_index < len(entries):
+        return list(entries)
+    updated = list(entries)
+    updated.insert(new_index, updated.pop(index))
+    return updated