IN 表格编辑器

在 VS Code 中以表格方式查看和编辑 .in / .out 工程输入与输出文件。

IN 表格编辑器 面向体量较大、字段较多、直接阅读纯文本不方便的工程计算文件。扩展会自动识别文件中的分段、表格和典型输出报告结构，并以卡片、分组、可展开表格的方式展示，方便浏览、核对和局部修改数据。

功能亮点

• 固定格式 .in 优化显示

  • 自动识别全局参数、求解器设置、阶段调度、材料参数、节点坐标、单元连接、边界条件、水面信息等典型区块
  • 按 Stage 对阶段数据进行分组展示，减少大量分段平铺带来的阅读压力
  • 节点、单元、阶段边界等大表格默认预览，展开后继续查看和编辑

• .out 输出报告优化显示

  • 自动识别 Main.out、CHECK.out、DNACM.out 以及空输出文件
  • 对 Main.out 按输出报告结构分组展示，例如配置回显、模型定义、水面单元、施工结果等
  • 对单元应力结果、节点位移结果、水面单元等宽表使用更清晰的标题和列名
  • 空输出文件会显示友好提示，而不是空白页面

• 参数含义悬浮提示

  • 鼠标悬停到参数名、表头或相关单元格时，会显示字段含义和常见取值说明
  • 支持 .in 中的全局参数、求解器参数、阶段调度列、材料参数列、节点坐标、单元连接、位移边界、水面信息、wetting / CP 等字段
  • 支持 .out 中的应力、位移、水面单元等常见结果字段提示

• 表格化查看与编辑

  • 双击单元格即可修改数据
  • 修改后会写回原始文件对应分段
  • 支持大表格按需加载更多行

• 阅读体验优化

  • 表头固定
  • 行号和关键列固定
  • -1 填充位弱化显示
  • 支持大表格折叠、展开和继续加载
  • 未能稳定识别为表格的内容会保留为原文块显示

支持的文件类型

当前支持：

• .in
• .out

其中：

• .in 文件会启用固定格式识别、阶段分组和参数解释
• .out 文件会启用输出报告结构识别、结果分组和宽表优化显示

使用方式

打开表格视图

可以通过以下任一方式打开：

1. 在资源管理器中右键 .in 或 .out 文件，选择：

   IN 表格编辑器: 打开 .in / .out 表格编辑器
   

2. 打开 .in / .out 文件后，在编辑器标题栏点击对应命令。

3. 在命令面板中运行：

   IN 表格编辑器: 打开 .in / .out 表格编辑器
   

.in 文件显示内容

对于固定格式 .in 文件，扩展会尽量识别并优化展示以下内容：

• Global Settings / 全局参数
• Solver Settings / 求解器设置
• Stage Schedule / 阶段调度
• Material Parameters / 材料参数
• Node Coordinates / 节点坐标
• Elements / 单元连接
• Names of Out nodes
• Names of Out Elements
• Stage N / 第 N 阶段
  • Displacement Boundary / 位移边界
  • Pore Water Pressure Boundary / 孔压边界
  • Water Surface Information / 水面信息 — IUH
  • Water Surface Information / 水面信息 — IDH
• wetting
• (CP(I,J),I=1,9),J=1,NUM

.out 文件显示内容

对于输出文件，扩展会根据文件类型进行不同优化。

Main.out

Main.out 通常是主要计算输出报告。扩展会尽量识别并分组展示：

• Run Configuration Echo / 计算配置回显
  • 控制参数
  • 迭代与稳定参数
  • 模型规模统计
  • 求解器参数
  • 施工阶段表
• Model Definition / 模型定义回显
  • Soil Constants / 材料常数
  • Node Coordinates / 节点坐标
  • Elements / 单元连接
  • Boundary Conditions / 边界条件
• Water Elements N / 第 N 组水面单元
  • Upstream Water Elements / 上游水面单元
  • Downstream Water Elements / 下游水面单元
• Construction N / TOTAL TIME ... days
  • 节点优化信息
  • 迭代状态
  • 单元应力结果
  • 节点位移结果

CHECK.out

如果文件只包含类似：

Static analysis

扩展会将其显示为：

Analysis Status / 分析状态

DNACM.out

DNACM.out 会作为数值矩阵输出显示：

DNACM Numeric Output / DNACM 数值输出

空输出文件

对于空的 Inf.out、NACC.out 等文件，扩展会显示：

Empty Output / 空输出文件

并提示该输出类别可能没有生成数据。

参数提示

鼠标悬停到参数名、表头或相关单元格上，可以查看字段解释。

例如 .in 中：

• NDim：计算模型维数
• iPrcs：计算过程控制
• AllNuNd：总节点数
• StcDT：阶段时间增量
• StcCtr：阶段计算/输出控制
• Typ：材料模型类型
• kx / ky / kz：渗透系数
• Node 1 ... Node 20：单元拓扑节点槽位
• -1：填充位或未使用槽位

例如 .out 中：

• SX / SY / SZ：正应力分量
• SXY / SYZ / SZX：剪应力分量
• PS1 / PS2 / PS3：主应力
• UX / UY / UZ：节点位移分量
• WAT-HEAD：水头或水压力相关输出

编辑方式

修改单元格

• 双击单元格进入编辑
• Enter：提交修改
• Tab：提交并切换到右侧下一个单元格
• Esc：取消编辑

大表格编辑

对于节点坐标、单元连接、阶段边界、输出结果等大表格：

• 默认先显示前几行用于快速预览
• 点击展开后可以查看完整表格
• 数据量较大时可继续按需加载更多行
• 已加载的行可以直接编辑

写回说明

编辑单元格后，扩展会将修改写回原始 .in / .out 文件中的对应分段。

需要注意：

• 写回时会按扩展的空格对齐规则重新整理当前分段
• 不使用 tab 对齐
• 仅写回被修改的表格分段
• 原文块内容不会被自动改写为表格
• .out 通常是计算输出文件，建议以查看和核对为主；如需修改，请确认这是你想要的操作

适用场景

适合处理以下类型的文件：

• 文件行数较多，纯文本阅读成本高
• 数据具有明显表格结构
• 阶段、材料、节点、单元等内容需要频繁核对
• 需要快速查看 Main.out 中的施工阶段结果、应力结果和位移结果
• 希望在查看结构的同时直接修改局部数据
• 希望快速理解 .in 文件中各字段的含义

命令

扩展提供以下命令：

inTableEditor.openInTableEditor

命令标题：

IN 表格编辑器: 打开 .in / .out 表格编辑器

要求

• VS Code 1.105.0 或更高版本

已知限制

• .in 固定格式识别主要面向当前工程输入文件格式
• .out 优化主要面向当前 Main.out / CHECK.out / DNACM.out 等输出格式
• 结构非常不规则的内容可能会以原文块形式显示
• 部分材料参数槽位的含义会随材料模型类型变化，当前提示会给出通用说明
• 部分 .out 宽表字段的业务含义可能需要结合具体计算程序进一步确认
• 编辑后的表格分段会按扩展的对齐规则重新写回，格式可能与原文件空格宽度略有差异

简短描述

Render .in / .out engineering files as structured, editable tables in VS Code, with optimized .in parameter views, .out report grouping, and hover explanations.