Petrel RE / ECLIPSE / tNavigator
为 Petrel RE、ECLIPSE 和 tNavigator 工作流中的模拟输入文件及 Petrel ASCII 配套数据提供语法高亮、中文释义、关键字导航、智能补全和 INCLUDE 跳转。
功能 Features
- Petrel 配套数据 — 识别井事件
.EV、井轨迹 .TRJ / .TRAJ、历史数据 .VOL、井与网格连接 .WCF 及井头 ASCII 表。按井名组织导航，显示事件、数据字段及表头的中文说明。
- 按内容识别文件 — 打开
.txt、无扩展名或自定义扩展名的纯文本时，根据 ECLIPSE 关键字、Petrel 表头及已打开文件的 INCLUDE 引用自动启用语言支持，兼容扩展名大小写混用。
- 左侧关键字导航 — 资源管理器中的“关键字导航”按文件顺序列出关键字，后附中文简要含义；单击跳转，悬停查看已有词典中的详细说明和行号。没有详细释义的条目显示所属分类。
- 自动层级 — 按 RUNSPEC、GRID、EDIT、PROPS、REGIONS、SOLUTION、SUMMARY、SCHEDULE、OPTIMIZE 分段，识别
BOX…ENDBOX、CARFIN…ENDFIN、SKIP/SKIP100/SKIP300…ENDSKIP 和嵌套的 #if/#ifdef/#ifndef…#elif/#else…#endif。未写段标题的 .inc 文件也可直接导航。
- 关键字检索与大纲 — 点击导航标题栏的搜索按钮，可按关键字、中文含义或所属层级检索；“定位当前关键字”按钮可在树中展开光标所在条目。同时支持 VS Code 原生大纲、面包屑和
Ctrl+Shift+O 符号跳转。
- 语法高亮 — 1447 个关键字,按 RUNSPEC / GRID / PROPS / REGIONS / SOLUTION /
SUMMARY / SCHEDULE 分色;支持
#if/#endif 预处理、-- 与 // 注释、'井名' 字符串。
- 可配置的中文释义 — 679 个常用关键字提供中文说明。编辑区支持“悬浮显示（默认）”“关键字后浅色显示”和“不显示”，可在原生设置页中切换。
- 智能补全 — 补全列表带中文文档;26 个常用关键字提供可 Tab 填空的代码片段。
- INCLUDE 跳转 —
INCLUDE / GDFILE / IMPORT 后的路径可 Ctrl+点击直接打开。
- 用法提示 — 悬浮模式下，空格或
Ctrl+Shift+Space 触发当前关键字的参数说明。
- 省心默认 — 自动关闭本语言拼写检查;自动把上述后缀关联到本语言。
使用 Usage
安装后打开 .data 文件即自动生效。若个别 .inc 未识别,点右下角语言名 →
Configure File Association for '.inc' → 选 tNavigator。
- 悬停关键字看中文用法;
- 打前几个字母看补全 + 文档;带"插入模板"的项回车得可填骨架;
- Ctrl+点击 INCLUDE 路径打开被引文件。
- 在左侧资源管理器展开“关键字导航”，单击关键字即可跳转；段标题和成对块可展开或折叠。编辑文件后列表自动更新，重复出现的关键字分别保留。
- 导航针对当前文件；打开 INCLUDE 引用的文件后，导航切换为该文件的内容。注释、字符串、数值数组和常见多记录关键字的数据行不列为独立关键字。
关键字释义设置
点击“关键字导航”标题栏的齿轮，或在 VS Code 设置中搜索“关键字释义”，进入 Petrel RE / ECLIPSE / tNavigator → Keyword Help: Display Mode。通过下拉框选择显示方式，修改后立即生效，可分别保存为用户设置或工作区设置。
| 显示方式 |
编辑区效果 |
| 悬浮显示（默认） |
鼠标停在关键字上时显示中文说明，支持参数用法浮窗。 |
| 关键字后浅色显示 |
中文说明紧跟关键字，以随主题适配的浅色文字显示；没有释义的关键字显示分类。 |
| 不显示 |
关闭编辑区的释义和参数用法浮窗。 |
浅色说明只用于屏幕显示，复制和保存均保留原始文件内容。导航栏说明及补全列表文档独立保留。
文件格式与扩展名
| 文件类型 |
识别方式与功能 |
| 模拟主文件与 INCLUDE 文件 |
.data、.inc、.include、.grdecl、.ecl，支持关键字高亮、分层导航、释义与引用跳转。 |
| 模拟专题文件 |
.sch、.sched、.schedule、.pvt、.vfp、.sat、.scal、.props、.faults。 |
| Petrel 井事件 |
.ev，识别 UNITS、WELLNAME 及带日期的事件记录，按井分组。 |
| Petrel 井轨迹与井网格连接 |
.trj、.traj、.wcf，识别井名、轨迹数据段和数据列。 |
| Petrel 历史数据 |
.vol，识别单位制、时间间隔、以 * 开头的数据字段和井名。 |
| 文本及无扩展名文件 |
.txt、.dat、自定义扩展名以及 FAULT 等无后缀文件，根据内容识别；井头文件支持 BEGIN HEADER / END HEADER 表头。 |
上述专用扩展名支持大写、小写和混合大小写。PVT.txt、SCAL.txt 等文本中的 ECLIPSE 关键字使用模拟文件的解析规则；Petrel 井事件、轨迹和历史数据使用各自的文本结构。表格及二进制文件（如 .xlsx、.EGRID、.UNRST）由相应的表格或专业查看器打开。
在设置中搜索 tnav.files.autoDetect 可开关自动识别。用户已明确关联其他语言的文件保留原设置；需要手动启用时，在资源管理器或编辑区右键选择“使用 Petrel RE / ECLIPSE 语言模式”，也可以从右下角语言模式菜单选择 Petrel RE / ECLIPSE。
INCLUDE 引用支持单引号、双引号和不带引号的路径，也支持路径前的换行与注释。已打开主文件中引用的纯文本可使用任意扩展名或无扩展名。
说明与致谢 Notes & Credits
- 关键字清单基于公开的 ECLIPSE 数据文件格式,并参考开源项目
OPM / opm-common 的关键字定义整理分段。
- 中文悬停说明为便于使用,依据 tNavigator 官方文档归纳整理;若将本扩展公开再分发,
请自行确认对相关厂商文档衍生文本的使用权利。
License
MIT © v
联系方式
| |
