Translate a key for current language. Behavior: - If key exists in current language: return it. - If key missing:

Tiny bilingual helper: choose text based on current language.

在控制台输出一行文字，并根据 kind 设置颜色/样式。 kind: - "cmd" : 用户输入的命令 (>>> ...) - "info" : 提示信息 / 正常输出 - "warn" : 警告

轻量 UI 音效：只用于按钮/模式切换等交互反馈。

None/空/异常时回退 default。支持 numpy 标量、字符串数字等。

Render image.

在头像上方显示气泡文本。 - auto_hide_ms=0 表示不自动隐藏

从某个视图槽位读取参数，应用到当前控件并回到单图模式

把当前 B 扫处理结果和参数保存到第 slot_idx 个对比视图

清空当前所有画笔轨迹。

为不同材料分配颜色.

Placeholder when no data is loaded (language-aware).

1D 余弦平滑窗： - 对于 |x| < x0: 返回 0 - 对于 |x| > x1: 返回 1 - 中间 |x|∈[x0,x1]: 用 0→1 的半个 cos 过渡 - invert=True 时反转（中间段从 1 过渡到 0） 这里

把 AI 小助手贴到 console_widget 右下角。 注意： - raise_() 只在显示/首次摆放时做一次（do_raise=True）， 避免在 eventFilter 里反复 raise_() 导致 Z 序混乱。

把 numpy 标量/0-d array 解包成 Python 标量

读取当前参数 + 数据，给出一小段文字建议。 不接 LLM，完全是规则+模板。

绘制拟合曲线 【逻辑修正】： 1. 形状由 fit_v 决定 (滚轮) 2. 屏幕位置由 spin_eps 决定 (当前背景) 3. 强制锁定视图范围，防止 Matplotlib 自动缩放导致图像跳变

设置背景截图，并清空已有涂鸦。

统一管理交互模式（互斥）： - normal：A-Scan 点击可用 - fit：速度拟合（屏蔽 A-Scan / 画笔） - brush：2D 画笔（屏蔽 A-Scan / 拟合）

用 .in 中的 materials 列表填充“背景材料”下拉框。 materials: {name: {'epsr':..., ...}, ...} default_name: 期望默认选中的材料名（可为 None）

顶部按钮切换速度拟合工具：交由统一的交互模式管理。

根据当前小人位置，把气泡贴在头像上方（尽量靠右对齐）。

根据当前语言刷新界面文字

从 parse_in_file 解析得到的 info 中，收集材料和体积几何对象。 目前使用的对象类型： - box - cylinder - sphere 返回: materials : dict, name -> materia

兼容不同 PyVista 版本的点选回调.

进入 2D 画笔模式：截图 -> overlay。成功返回 True，否则 False（并负责回滚 UI）。

把参数字典压缩成几行描述，显示在四宫格下方

常用快捷键（偏保守，避免和输入框冲突）。

构造任意方向圆柱体.

在 group 中按顺序查找第一个存在的数据集

Refresh placeholder text on canvases after language/view changes.

调整 PyVista 主题外观，让比例更协调。

根据当前模式启用/关闭点选（用于文字标注），避免重复 enable 报错。

ROI：左右/上下裁剪 + 深度静音带（用于 .out/.npy 等所有输入）

根据 .in 解析结果构建一个几何真值切片（目前只支持 XZ 平面）。 参数 ---- info_fallback : dict io_module.parse_in.parse_in_file 返回的 info。 plane : str

在对比 4 图模式下导出选中的视图（图片 + 参数 JSON）

判断 (X,Y,Z) 网格点是否在 box 内。 p1, p2 为对角点，顺序不限。

判断 (X,Y,Z) 网格点是否在 cylinder 内，支持任意方向的圆柱。 p1, p2 为两端面中心坐标。

判断 (X,Y,Z) 网格点是否在 cylindrical_sector 内。 语法对应 gprMax 文档: #cylindrical_sector: c1 f1 f2 f3 f4 f5 f6 f7 str1 [c1] - axis = c1: 'x' / '

判断 (X,Y,Z) 网格点是否在 sphere 内。

加载 .npy 文件。 支持两种格式： A) dict 格式（推荐，GPR_Studio 导出）：{'data': (Nt,Nx), 'dt':..., 'dx':..., 'eps_bg':..., 'roi':...} B) 纯数组格式：直接认为是 (Nt,N

加载 gprMax .out 文件，并尽可能根据同名 .in 填充物理参数。 - 读取 /rxs/rx1/{Ez,Ey,Ex} 中的一个作为主数据； - 将数据 reshape 成 (Nt, Nx)，以列为 trace； - 读取 dt； - 若存在同名

从 JSON 文件加载参数预设并应用到控件

加载由 export_reproducible_package 导出的 .zip 可复现包。 优先读： - data/raw.npy 作为 raw_data - data/processed.npy 作为 processed_data 并恢复 met

在对比模式的某个视图里点击，弹出对应的 A-Scan

解析 gprMax .in 文本，抽取物理与几何参数。 支持的命令（常用部分）： - #title - #domain, #dx_dy_dz, #time_window, #pml_cells - #material - #box - #c

保存当前参数到 JSON 文件

修改画笔颜色，并重绘。

由 MainWindow 根据当前数据动态设置 ROI 控件范围

在控制台输出帮助信息（中英双语）。

弹出 3D 几何模型视图

把快捷键清单输出到下方控制台（不弹窗）。