项目管理

谛耳的项目保存的是您对一次分析的配置:Pool 中每个阶段的每个节点,以及它们的全部参数。它是一份设置文档,而不是数据容器 — 测量文件和计算结果都保存在项目之外。本页说明项目里究竟存了什么、如何保存与打开、结果写到哪里,以及把项目迁移到另一台电脑时该怎么处理。

分析项目文件

主分析窗口的项目是一份 Pool 工程,以 JSON 格式保存,扩展名为 .json。保存对话框中的文件类型为 Pool Project JSON (*.json),默认文件名为 PoolProject.json,建议改成有含义的名字,例如 GearboxRunUp_OrderAnalysis.json。

文件是带缩进的 UTF-8 纯文本,可读、可比对、可纳入版本管理,也可以随报告或测试规程一并归档。
体积很小,通常只有几 KB,因为里面只有设置。
不含任何测量采样点,也不含任何计算结果。打开项目本身不会产生结果 — 数据由您提供, 再运行流水线。

结构工作台(EMA / OMA / ODS)有自己的项目文件,扩展名是 .vlproj。它是另一套工作区的另一种格式,详见下文两种项目文件的区别。

项目里保存了什么

写入项目文件	不写入项目文件
各阶段的每个 Pool 节点:类型、显示名称、启用状态	测量数据本身 — 文件里只会记录路径
每个节点的完整参数:FFT 长度、窗函数、重叠、平均、计权、频率与阶次范围、导出目标等	计算结果、图表、数据查看器与标记编辑器会话,以及已打开的工作区标签页
运行结束后由哪个 Destination 节点驱动显示	窗口与面板布局、图表缩放、坐标轴范围、光标和彩图色标
属性面板的展开状态	Source 树中勾选了哪些通道 — 这属于运行期状态
项目名称、内部标识,以及用于格式迁移的架构版本号	标记编辑器设定的时间窗 — 同样只是运行期状态
源文件路径,打开项目时会据此重新载入	传感器库、软件设置与授权信息,这些按用户保存,不随项目走

打开项目时会按记录的路径把测量文件重新载入 Source 面板。保存之后被移动或删除的文件会被报出并跳过 — 这些请自行拖放,或用插入 → 源(添加 HDF)…重新添加。

保存项目

在 Pool 中搭建好分析,并至少运行一次确认无误。
选择文件 → 保存项目...,或点击工具栏的保存图标。若当前会话此前已保存过或是从文件打开的,则直接写回该路径;否则弹出另存为对话框。
文件 → 工程另存为…(或工具栏的另存为图标)总会询问保存位置。对话框会定位到当前项目所在文件夹并沿用其文件名,便于把多个变体并排保存。
事件日志会显示 Saved: <路径>。保存后的文件即成为当前项目,下次直接保存就写入该文件。

保存失败不会弹窗,而是在事件日志中以 Save failed: <原因> 提示。若保存到只读文件夹或已断开的网络盘,请先看事件日志再判断文件是否真的写出。

流水线运行期间这两条命令均不可用,请等待运行结束后再保存。

打开项目

选择文件 → 打开项目...,或点击工具栏的打开图标,选择一个 .json 项目文件。
程序切换到分析工作区,并按文件重建 Pool:所有阶段、所有节点、所有参数。属性面板恢复到保存时的展开状态。
Source 面板按项目记录的测量文件重新填充。事件日志显示 Loaded: <路径>。
按 F5 运行。若有文件没能找到,先把它补回 Source 阶段。

打开项目会立即替换当前 Pool,且不会询问。程序没有"未保存更改"提示。打开另一个项目之前,请先保存当前会话。

若文件已被移动或删除,事件日志会显示 Open failed: file not found: <路径>;文件损坏或类型不符则显示 Open failed: <原因>。两种情况下当前会话都保持不变。

新建会话

工具栏最左侧的新建图标会丢弃当前会话并建立全新的工作区:空 Pool、无源文件、无打开的文档、无撤销历史。

菜单中没有"文件 → 新建项目"这一项;工具栏的新建按钮也不会二次确认、不会先行保存任何内容。使用前请先保存您的工作。

若希望新会话不是从零开始,而是从一套已备好的分析开始,请改用文件 → 从模板新建…。该命令会先询问是否保存当前会话 — 详见项目模板。

结果写到哪里

结果不属于项目文件的内容。流水线运行产生结果后,谛耳会自动写出一份结果包:

项目	行为
文件夹	`C:\Vlisten Analysis Results`,不存在时自动创建
文件名	`<源名>_Analysis_<yyyyMMdd_HHmmss>_<标识>.dpres`; 无法确定源文件时前缀为 `Pipeline`
该文件夹不可写时	改写入按用户保存的备用文件夹,避免因权限问题丢失一次运行结果
打开文件夹	文件 → 打开结果文件夹,在运行菜单中也有同一命令
复用结果包	"分析结果"侧栏会列出这些结果包;把 `.dpres` 文件拖入数据查看器即可重新载入其中的曲线

这份自动写出的结果包属于结果归档,不是项目自动保存。它保存的是计算出的曲线,不含 Pool 配置,也无法还原一次会话。只有保存项目才能保留您的分析设置。

Destination 节点还会按节点中配置的路径写出各自的导出件 — HDF、ATFX、LDSF、CSV、图片与报告。这些路径属于项目内容;格式说明参见导入与导出。

两种项目文件的区别

谛耳有两个彼此独立的工作区,各自有自己的项目格式,两者不能混用。

	分析项目	结构工作台项目
扩展名	`.json`	`.vlproj`
所属工作区	主分析窗口、Pool 流水线	结构工作台(EMA / OMA / ODS)
命令入口	文件 → 打开项目... / 保存项目... / 工程另存为…	结构工作台内部的"新建项目 / 打开项目 / 保存项目"按钮
保存内容	Pool 各阶段与节点,及全部分析参数	当前模块、几何文件、测试数据文件及其类型、曲线拟合算法与模型阶次设置、频率/阻尼/稳定性容差、选中的极点、MAC 矩阵与验证版式
是否进入"文件 → 最近"	是	否 — 结构工作台不维护最近列表
重新打开是否恢复数据	是,会重新载入记录的源文件	是,会按保存的绝对路径重新加载几何与测试数据文件,前提是文件仍在原位

两边都不会校验您选中的文件类型。通过文件 → 打开项目...去打开一个 .vlproj 不会给出明确报错,只会得到一个空的 Pool。请把两类项目分文件夹存放,并以扩展名区分。

结构工作台的批量报告与模态跟踪工具也会成批读取 .vlproj:可一次多选若干项目文件,比较其中保存的模态。

扩展名	含义	使用方式
`.json`	分析项目	文件 → 打开/保存项目
`.vppj`	分析模板:与项目同一套流水线,但抽掉了文件路径	文件 → 从模板新建… / 存为模板…,参见项目模板
`.vlproj`	结构工作台项目	结构工作台自己的项目按钮
`.dpres`	运行后写出的结果包	在"分析结果"侧栏中列出,拖入数据查看器即可重新载入
`.hppj`	由第三方软件生成的外部池工程文件	作为某一个特定分析节点的参数,在该节点的属性中选择。它不是可通过文件菜单打开的项目,也不会成为当前项目。

把项目迁移到另一台电脑

项目文件中的所有路径都是绝对路径。弄清哪些路径真正起作用,迁移就很直接:

把项目文件和测量数据一起复制到目标机器。若还需要此前的数值,请一并复制结果包与导出件。
打开项目。无论数据现在放在哪里,Pool 与全部分析参数都会照常恢复 — 这一步不依赖任何路径。
把 Source 面板指向新位置。项目会按记录的路径重新载入,因此在数据已换位置的机器上这些条目会被报为找不到;请从新位置拖放补齐。
检查带路径的节点。导出目标、引用的结果文件,以及外部池工程路径仍保留着原来的绝对路径。请逐个选中这类节点,在属性中改成新路径。
运行流水线,确认输出确实落在预期位置。

谛耳没有"打包工程"命令,也没有对丢失文件的批量重新链接功能。单独一个项目文件并不是一次测量会话的可移植归档;节点中残留的旧路径必须逐个修正。

可以降低迁移工作量的几种做法:

把项目文件与该次测量的数据放在同一个文件夹,让两者始终成对移动。
若多台机器共用同一网络位置,请在各台机器上映射为相同的盘符,绝对路径便无需修改即可继续有效。
在自己的命名习惯上保持规整,例如统一使用 D:\Tests\<项目>\<工况>\,这样项目在机器之间移动时最多只需改一处明显的路径。
如果需要传递的只是方法而不是数据,请发送模板而不是项目。模板保存时会清除路径,正是为此设计 — 参见项目模板。
项目文件是可读的 JSON。若确实有大量节点的路径同时改变,在打开项目之前用文本编辑器统一替换是可行的做法 — 请在副本上操作。

文件菜单速查

命令	作用
打开项目...	载入 `.json` 项目,替换当前 Pool
保存项目...	写回当前项目路径,尚未保存过则询问位置
工程另存为…	总是询问保存位置
最近	最近保存或打开过的十个项目
从模板新建… / 存为模板…	模板命令,详见项目模板
导出 Deepsona → HDF / LDSF / ATFX…	导出已加载的测量数据,参见导入与导出
打开结果文件夹	在资源管理器中打开结果包所在文件夹
打印…	打印当前文档
返回开始菜单	离开分析工作区,回到开始页
退出	关闭程序,不提示保存

键盘快捷键

文件菜单没有任何键盘快捷键:不存在 Ctrl+N、Ctrl+O 或 Ctrl+S。项目相关命令请通过菜单或工具栏图标执行。实际存在的快捷键如下:

快捷键	动作	生效范围
F5	运行流水线	主窗口内任意位置
Ctrl+Z / Ctrl+Y	撤销 / 重做 Pool 编辑	Pool
Ctrl+X / Ctrl+C / Ctrl+V	剪切、复制、粘贴节点	Pool
F2	重命名选中节点	Pool
Del	删除选中节点	Pool

注意事项与限制

项目没有自动保存,没有崩溃恢复文件,也没有"未保存更改"提示。关闭程序、点击新建按钮、打开另一个项目,都会直接丢弃未保存的修改。请主动保存,并经常保存。
流水线运行期间,保存与打开命令均不可用。
.json 扩展名未与谛耳关联,在命令行中传入项目路径也不会打开它。请先启动程序,再打开项目。
程序不为项目做版本管理。请把多个变体存为不同文件名(例如在文件名中带修订号),并用 工程另存为…来分支。
项目中保存有架构版本号,以便旧版本写出的文件仍可读取。请勿手工修改该字段。
结果永远不会存进项目。若需要保留数值,请保留 .dpres 结果包,或 Destination 节点产生的导出件。
最近列表上限为十条,且无法在界面中编辑或清空。