包含文件缺失
概述
老师！ 今天讨论的是包含文件缺失的问题，是吧？ 这是什么东西？
包含文件缺失的理论基础
包含文件的理论角色
包含文件缺失错误导致分析停止，但首先为什么CAE软件要使用包含文件呢？
主要有两个原因。第一是模型的模块化。例如，在多个分析中常用的材料特性（比如，JIS G 3101 SS400的杨氏模量
那包含文件中的内容只是文本数据吗？还是二进制？
大多数是纯文本。Abaqus的.inp文件中由`*INCLUDE`指令引用的文件，或LS-DYNA关键词文件中由`*INCLUDE`节指定的文件，都是ASCII格式。但是，Ansys Mechanical APDL使用二进制结果文件的`*VREAD`这样的特殊情况很少见。
包含文件的机制，可以认为和编译时的"复制粘贴"一样吗？
从概念上讲这是正确的。求解器读取主输入文件，当遇到`*INCLUDE`等指令时，读取指定路径的文件，并以该内容原本就写在该处的方式进行处理。此时，相对路径和绝对路径的解释经常会成为错误的原因。
包含文件缺失的数值计算方法
求解器对包含文件的处理方式
求解器在哪个阶段读取包含文件？在预处理时？还是计算中？
在输入文件的"预处理"阶段。求解器在解析输入文件时，一旦发现包含指令，就打开该文件并将内容展开到内存中。例如，Abaqus/Standard的执行流程中，首先`pre.exe`处理.inp和所有包含文件，创建内部数据库，然后启动本计算的`standard.exe`。如果包含文件缺失，在`pre.exe`阶段就会出现错误并停止。
包含文件中是否可以再写包含语句，实现"嵌套"？
许多求解器都支持，但深度有限制。LS-DYNA默认最多可以嵌套10层。但是，深层嵌套会使路径解决变得复杂，大大降低维护性。实际工作中，最多嵌套2层被认为是最佳实践。Ansys Mechanical APDL的`/INPUT`命令也可以像这样嵌套。
"路径解决变得复杂"是什么意思？
使用相对路径时，作为基准的"当前目录"会成为问题。有的求解器以运行主文件的目录为基准，有的则以各包含文件所在的目录为基准。在后者的实现中，嵌套包含文件的路径指定会变得不直观。MSC Nastran的`INCLUDE`指令通常以主文件的位置为基准来解决相对路径。
包含文件缺失的实际应用
安全运行包含文件的工作流程
为了防止包含文件缺失错误，有具体的操作步骤吗？
最重要的是要遵守"项目文件夹一体化"。将所有输入文件和包含文件放在一个根文件夹下（例如：`Project_2023_Bracket_Analysis`），用子文件夹（`/model`、`/include`、`/results`）整理。从主文件到包含文件的相对路径始终以这个根文件夹为起点。例如，`*INCLUDE, INPUT=./include/material.inc`这样写。
当需要把文件交给其他人或移到服务器时怎么办？
这就是"相对路径"的重要性。如果使用绝对路径（`C:\Users\name\project\...`或`/home/user/project/...`），环境一旦改变，所有路径都会失效。最好是将整个项目压缩为ZIP并发给他人，或使用Git等版本控制系统共享。此时要在`.gitignore`中排除结果文件等大型二进制文件。
在执行分析前，有办法确认所有包含文件都能找到吗？
有几种方法。第一，如果使用Abaqus/CAE或Ansys Workbench这样的集成环境，预处理阶段会为你管理文件的关联性。第二，使用命令行求解器的"仅检查"模式。例如，在Abaqus中执行`abaqus job=jobname datacheck`，就只做输入文件检查而不进行实际计算。此时会检测到包含文件缺失错误。
我担心会不小心覆盖包含文件的内容。
重要的做法是分离"只读文件"和"可编辑文件"。例如，将材料库`MATLIB.inc`设为只读属性，在项目中只通过`*INCLUDE`来引用。如果项目需要修改，就复制`MATLIB.inc`创建`my_material.inc`，编辑这个文件并引用。这样就能避免破坏原文件的风险。
包含文件缺失的软件比较
主要求解器中包含文件的语法和行为
Ansys、Abaqus、Nastran中包含文件的写法有什么不同？
语法和选项都不同。Abaqus使用`*INCLUDE`指令。Ansys Mechanical APDL（原Ansys参数化设计语言）使用`/INPUT`命令。MSC Nastran使用`INCLUDE`语句。更重要的是路径指定的处理方式。Abaqus的`*INCLUDE`以主文件的位置为基准解释相对路径。而APDL的`/INPUT`以命令执行时的"当前目录"为基准，所以批量运行时要注意目录。
COMSOL Multiphysics呢？我觉得.mph文件中应该包含了所有东西。
确实如此，COMSOL的原生二进制格式.mph将模型设置、网格和结果全部打包在一个文件中。但是也有引用外部文件的功能。例如，作为"外部材料数据"读取CSV文件，或使用"LiveLink™ for MATLAB®"从.m文件控制模型。在这种情况下，移动.mph文件时必须同时移动CSV和.m等参考文件，这会导致类似包含文件缺失的问题。
OpenFOAM这样的开源求解器呢？
OpenFOAM的核心是"案例目录"结构。设置文件分布在`0/`、`constant/`、`system/`目录中，使用与C++预处理器相同的`#include`语法来包含文件。例如，在`constant/turbulenceProperties`中用`#include "RAS/kEpsilon"`这样的方式。路径总是以案例目录为基准。文件缺失时会报告为`FOAM FATAL ERROR`，非常清楚。
包含文件缺失的故障排除
缺失错误的识别和解决方案
出现"找不到文件"的错误。首先应该检查什么？
一字一句地读错误消息。里面会说明是哪个求解器、在哪个目录中查找了哪个文件。例如，"Abaqus Error: The following file(s) could not be located: ./sub/model_part.inp"就表示主.inp文件所在位置的相对路径`./sub/`中没有`model_part.inp`。首先用文件浏览器或终端确认该路径中文件是否真实存在。还要检查拼写错误（`modul`和`model`）或大小写区别（Linux环境下很重要）。
文件确实在那里，但还是出错。为什么？
最常见的是"文件权限"问题和"文件路径中包含空格或日本语"。特别是在Linux集群上计算时，如果用户没有包含文件的读取权限，就会出错。用`chmod 644 include_file.inc`改变权限。另外，路径中含有空格（`My Project`）或日本语（`分析模型`）时，求解器可能无法正确解释路径。改成只用下划线（`My_Project`）或英数字名称是最保险的。
在网络驱动器（如Z驱动）上包含文件时，有时会失败。
可能是网络延迟或超时，也可能是提交批处理作业的计算服务器看不到那个网络驱动器。在HPC环境中，要在作业脚本中编写代码，将所需的包含文件复制到计算节点的本地存储（`$TMPDIR`或`$SCRATCH`）。或者将整个项目从网络驱动器移到本地驱动器再运行。这就是CAE供应商推荐"使用本地路径"的原因之一。
修改包含文件并保存后，求解器好像还在读取旧内容。
这是"缓存"问题。Ansys Workbench和Abaqus/CAE有时会为了提高性能而缓存一旦读取的外部文件。在Workbench中执行"Refresh"按钮或"Update Project"。在Abaqus/CAE中编辑.inp后重新运行时，要么关闭CAE用命令行执行`abaqus job=...`，要么在CAE中删除并重新创建作业。这样缓存就会被清除。从根本上讲，与其用集成环境，不如用文本编辑器管理输入文件，能避免这些混淆。
详细
错误