调查导入问题
修复 PetroBench 中的定向调查导入问题。解决无法上传的文件、解析失败、列映射错误、单位不匹配和无序测量点的问题。
您的定向调查无法上传，或者导入后数据看起来不正确。定向测量定义了井眼的 3D 路径（测量的深度、倾斜度、方位角），PetroBench 使用它来计算每个有杆泵模拟背后的几何形状。如果调查失败，您的结果也会失败。以下是如何诊断和解决常见问题。
支持的格式
您可以通过 Directional Surveys 选项卡导入电子表格调查（井详细信息 > 定向调查 > 导入调查），而不是旧井导入器。
| 格式 | 扩展 | 笔记 |
|---|---|---|
| CSV | .csv | 逗号分隔，UTF-8 编码 |
| Excel | .xlsx、.xls | 使用的第一个工作表（首选名为“调查”或“定向”的工作表） |
| 文字 | .txt | 空格或制表符分隔 |
PetroBench 预计深度为feet，角度为degrees。
RodStar (.rsdx、.rsvx) 和 SRod (.inp6e、.inp7) 文件携带自己的调查并通过井导入器进行代替。请参见导入井。
列映射
导入期间，PetroBench 会自动读取标题行并匹配列。它识别每个字段的几个通用名称：
| 专栏 | 已识别的标头 |
|---|---|
| Measured Depth | MD、测量深度、深度、M.D. |
| Inclination | Inc、Incl、倾角、角度 |
| Azimuth | Az、Azim、方位角、方向 |
如果无法识别某列，请将其标题重命名为上述标准名称之一，然后重新保存文件。在确认导入之前查看预览，以确保每列都到达您期望的位置。
文件无法上传
###“文件格式无效”错误
- 确认文件具有受支持的扩展名（
.csv、.xlsx、.xls、.txt）。 - 如果您从其他调查工具导出，请将其重新保存为 CSV 并重试。
###“解析失败”错误
文件已上传，但 PetroBench 无法读取。常见原因：
- Blank rows at the top. 标题行必须是第一行。删除其上方的任何空行或标题横幅。
- Special characters in headers. 标题行中的符号、合并单元格或杂散字符可能会破坏检测。将标题保留为纯文本，例如
MD、Inclination、Azimuth。 - Text in numeric columns. 单元格中的单位（例如
1500 ft）、注释或页脚注释混合到数字列中将会失败。保持深度和角度列纯数字。
如有疑问，请在 Excel 中打开文件，清理标题行，删除数据上方或下方的所有内容，然后重新另存为 CSV (UTF-8)。这解决了大多数解析失败的问题。
导入后数据看起来错误
深度已关闭
- Unit mismatch. PetroBench 将深度读取为英尺。如果您的文件以米为单位，则这些值大约会浅三倍。导入前转换为英尺。
- Wrong columns mapped. 如果深度看起来混乱，则可能在导入过程中选择了错误的列。重新检查预览并确认 MD、倾角和方位角映射到右列。
调查是颠倒的
PetroBench 预计shallowest MD first，测量深度沿着文件逐渐增加。一些调查输出首先列出最深点。
- 导入前按 MD 升序对文件进行排序。
- 如果您看到“MD 值必须增加”消息，这就是原因。
缺失数据点
- 导入过程中会跳过具有空白MD、倾角或方位角的行。
- 如果导入的调查的点数少于源文件，请查找空单元格并填充或删除这些行。
- 倾角应在 0 到 90 度之间，方位角应在 0 到 360 度之间（从北顺时针测量）。超出这些范围的值通常意味着映射或数据输入错误。
必填列与可选列
| 必填 | 可选 |
|---|---|
| 测量深度（MD） | 真实垂直深度 (TVD) |
| 倾角 | 北/南 |
| 方位角 | 东/西 |
PetroBench 根据 MD、倾角和方位角自动计算 TVD、狗腿严重程度、北距和东距，因此不需要可选列。如果您包含它们，它们将按提供的情况使用。
如果您的测量没有一直延伸到泵送深度，PetroBench 会推断出最后一点以外的轨迹。推断的剖面可能与您的实际井眼几何形状不匹配。为了获得准确的结果，请导入至少达到泵设置深度的测量。
导入后验证
导入后，打开 Well Details > Directional Surveys 并确认：
- Point count. 测量点的数量与您的源文件匹配（没有静默跳过的行）。
- Depth range. 最深 MD 至少达到您的泵设置深度。
- Start and end. 测量从近地表（最浅MD）开始并向下增加。
- 3D 井眼。 3D 可视化与您期望的形状相匹配。旋转和缩放以检查路径。垂直井应呈直线向下；斜井应该像现实生活中那样弯曲。
- Primary survey. 如果该井之前有过测量，则将新的井设置为主要井。每口井只能进行一项调查。
何时联系支持人员
如果出现以下情况，请联系 support@petrobench.com：
- 该文件在 Excel 中解析清晰，但 PetroBench 仍然不会导入它。
- 即使在检查单位、列映射和排序顺序后，导入的调查看起来也是错误的。
- 尽管使用标准名称，但未检测到列标题。
包括：
- 井名。
- 您正在导入的调查文件（或前几行的屏幕截图，包括标题）。
- 确切的错误消息或看起来错误的屏幕截图。