barracuda 24.0 用户手册中英文翻译(第十四章 运行)

barracuda课程链接：https://www.fangzhenxiu.com/course/11268766/

14。运行

如图14.1所示，Run窗口包括快捷按钮，允许用户运行求解器一个时间步，检查项目设置，运行模拟，从IC文件重新启动现有模拟，并与当前正在运行的模拟交互。

图14.1运行窗口

14.1。运行配置    

默认情况下，在新定义的barracuda项目中，不会选中CPU并行和GPU并行框，并且barracuda将在CPU串行模式下运行模拟。此模式不会使用任何CPU或GPU并行加速功能，仅在没有并行附加许可的情况下推荐使用。

14.1.1。CPU并行

具有可用并行许可证的用户可以在模拟运行期间使用多个CPU内核。启用此功能后，体积平均化学计算和选择颗粒计算将在多个CPU核心上执行。线程计数框确定barracuda求解器在CPU并行模式下运行时将利用的CPU核心数量。此框将显示检测到的可用CPU核的最大数量，默认为- 1。选择比最大可用核数少一个的原因是为了确保系统在计算过程中保持对用户的响应。如果需要，可以减少用于CPU并行计算的内核数量；例如，如果在一台机器上同时运行多个barracuda模拟，建议为每个模拟提供更少的核，使用的所有CPU并行核的总和等于可用CPU核总数的N−1。

注意：如果GPU可用，通常最好使用GPU并行选项而不是CPU并行。GPU并行将执行所有的化学计算，包括离散和体积平均，以及颗粒计算，导致最快的速度可用。

14.1.2。GPU并行

此选项启用GPU并行加速。需要Parallel附加许可证和兼容的NVIDIA硬件。对于大多数barracuda模拟，使用GPU并行将大大提高运行速度，如介绍章节所述，如图1.1所示。

对于Linux计算，使用多个GPU将大大加快模拟速度，从而减少模拟时间。然而，这种性能提升并不是线性扩展的。每个额外的GPU添加到模拟将递减收益。为了在模拟中使用多个GPU，用户必须为模拟中使用的每个GPU申请一个GPU license。    

对于Linux计算，barracuda支持GPU的超额订阅，或者通过依赖系统内存来运行超出GPU内存限制的模拟。此功能具有与多gpu模拟相同的要求。

有关GPU并行要求的更多信息，请参见系统要求。

求解器启动时提示选择此设置将使求解器在执行Run求解器后提示用户选择用于模拟的GPU。解算器终端将打开并显示有关机器上兼容的GPU的信息。然后，用户可以根据可用的许可证数量选择一个或多个GPU。

自动选择选择此设置将使求解器根据下拉菜单确定的标准选择使用的GPU。可用内存将选择具有最多可用RAM的GPU。可用内存分数将根据每个设备的最大内存容量选择具有最大可用RAM百分比的GPU。Sequential将按其设备ID号的顺序选择GPU；这个排序是基于预期的性能。带宽将选择具有最多可用带宽的GPU。GPU计数框允许用户指定求解器应该选择多少GPU。

使用指定的GPU选择此设置将允许用户通过输入逗号分隔的设备id列表（例如0,3）来指定求解器将在模拟中使用哪些GPU。输入all将选择机器中所有可用的多GPU兼容GPU，直至可用GPU许可的数量。

gpu列表

按下此按钮将启动一个终端，该终端将列出当前机器上能够与VirtualReactor一起使用的NVIDIA gpu。此外，如果某些设备不能用于多gpu计算，或者它们在不久的将来不被NVIDIA支持，则会显示警告。    

图14.2gpu终端列表

高级GPU选项

图14.3高级GPU选项对话框

CPU回退行为在GPU相关错误的情况下，求解器将自动回退到CPU模式（自动），退出模拟，或显示错误消息并等待用户交互。

分解方向此设置控制求解器如何跨多个gpu划分项目域。用户可以选择X、Y或Z，让项目被一个垂直于X、Y或Z轴的平面划分，或者用户可以选择“最大维度”或“最小维度”，让项目被一个垂直于最大或最小轴的平面划分。此外，选择Automatic设置将允许求解器选择它认为最适合该项目的划分策略。默认和推荐的设置是Automatic。    

启用多gpu负载平衡通过打开此功能，求解器将在模拟过程中动态调整多个gpu的项目。关闭此功能将迫使求解器在整个模拟过程中保持初始分配。默认和推荐的设置是启用此功能。

运行选项

此按钮启动运行选项对话框。

等效命令行

根据上面选择的选项，将显示启动求解器的等效命令行。如果需要从命令行启动仿真，可以将此复 制粘贴到终端中。详细信息请参见从命令行运行。

复 制到剪贴板

单击等效命令行右侧的按钮，将文本复 制到剪贴板中。

14.1.3。运行选项    

图14.4运行选项对话框

启动模拟时，有以下选项可用：

如果达到温度限制：默认情况下，如果任何计算单元遇到超出指定温度警告限制的温度，求解器将暂停模拟并以交互式提示向用户发出警告。此选项允许用户通过预先选择继续或退出模拟来避免终端交互。

如果化学质量不平衡：默认情况下，如果解算器开始运行时化学不平衡，会提示用户询问是继续还是退出。这个选项允许用户通过预先选择继续或退出模拟来避免终端交互。

如果达到最小磁盘限制：默认情况下，如果解算器检测到系统磁盘空间不足，它将暂停并提示用户采取行动。此选项允许用户通过先发制人地选择继续或退出模拟来避免终端交互。    

最小磁盘空间百分比：用户可以指定需要多少可用的空闲磁盘空间才能使解算器运行。当模拟运行时，求解器会定期检查可用的空闲磁盘空间量。如果磁盘变得太满，求解器将暂停模拟，以便用户可以采取纠正措施。一旦有更多的磁盘空间可用，在仿真终端按Enter键继续仿真。

Quit on prompt如果选择了这个选项，求解器将在任何可能导致交互提示的情况下立即退出模拟。此选项在“批处理作业”系统中很有用，其中模拟被提交给主进程，并且无法执行终端交互。

如果选择此选项，求解器将在丢失其RLM许可证时立即退出。

退出FE_INVALID如果选择此选项，求解器将在遇到浮点异常FE_INVALID时立即退出。如果未选中该选项，则解算器将暂停运行终端并提示用户。

高级命令行标志：如果用户希望传递任何高级求解器标志，则可以在此文本框中键入它们。

14.2。检查设置

总是建议用户在开始模拟之前检查Barracudabarracuda模型的设置。这对于验证模型内的边界条件、初始化颗粒、通量平面和瞬态数据点的位置是否正确非常重要。要做到这一点，求解器必须运行一个时间步骤，在这个时间步骤中，它读取项目文件并生成检查模型所需的Tecplot文件和日志文件。

14.2.1。运行求解器设置

从运行窗口（或快捷按钮栏）单击运行求解器设置按钮将打开一个命令窗口，其中barracuda求解器将运行一个时间步骤的模拟，写出第一个Tecplot文件（bvr.00000.plt），并创建所有日志，通量和附加第一个时间步骤数据的瞬态数据文件。注意，在求解器计算第一个时间步长时，求解器命令窗口必须保持打开状态；如果关闭，则计算将停止。一旦日期和时间戳显示在运行窗口的底部，计算就完成了，窗口可能会被关闭。    

14.2.2。视图设置

View Setup按钮启动Tecplot，并允许用户通过显示系统的边界条件来快速验证他们的项目设置。默认的视图设置将压力边界显示为黄色单元格，流量bc显示为红色面，热壁显示为洋红色面，点源注射显示为蓝色箭头。该视图的示例如图14.5所示，可用于验证边界是否已应用于模型中所需的细胞或面。此外，边界的表面积将被写入info.log文件或边界通量文件（如果指定了一个）。验证模型设置所需的附加信息包含在history.log和flux文件中。    

图14.5在Tecplot中检查设置

14.3。运行仿真

14.3.1。运行求解器    

完成设置后，可以通过单击Run窗口（或快捷按钮栏）中的Run求解器按钮来开始模拟。在点击这个按钮后，可能会询问用户应该如何处理项目文件夹中现有的数据文件（如果存在的话）。在这些提示之后，将自动打开求解器的命令窗口，求解器将在其中运行。在求解器执行期间，该窗口必须保持打开状态。一旦达到模拟的结束时间，将在运行窗口的底部显示日期和时间戳，窗口可能会被关闭。注意，你不能在一个目录下运行求解器的多个实例。

在模拟开始时用户提示

前两个求解器提示的目的是警告用户在当前目录下已经运行了一个仿真，并在现有仿真结果有价值且不应修改的情况下提供退出当前运行的选项。

在设置项目时，通常会多次启动求解器来检查初始条件和边界条件，并根据需要进行调整。在这种类型的迭代设置过程中，每次启动求解器时都会出现此提示，在这种情况下，回答R以允许求解器删除所有文件并在同一目录下再次运行是安全的。

为了避免意外删除以前运行的模拟中有价值的Tecplot文件，如果有的话。

可用的回答有：

§(R) move会立即删除匹配的文件。

§(O)verwrite会将匹配文件保留在原位，但在求解器到达每个文件对应的模拟时间时覆盖它们。

§(D)isplay会列出匹配的文件。    

§(Q)uit将中止求解器的运行。

求解器提示：list_outputfiles.log中列出的输出文件存在。为了避免意外删除之前运行的模拟中的其他（非bvr*.plt）输出文件，如果在当前目录中找到list_outputfiles.log中列出的任何文件，求解器将提示用户：

Output files listed in list_outputfiles.log exist. (R)emove, (A)ppend, (D)isplay, (H)elp or (Q)uit?

可用的回答有：

§(R) move会立即删除匹配的文件。

§(A)ppend将保留匹配文件，并将新的模拟数据附加到每个文件的末尾。

§(D)isplay会列出匹配的文件。

§(Q)uit将中止求解器的运行。

速率方程质量平衡提示在有化学反应的模型中，可能会提示用户以下反应不平衡的警告。

Your chemical rate equations have a summed error of #.###e## kg/s-m3

with minimum & maximum reaction rates being #.###e## & #.###e## kg/s-m3

under certain conditions. The error could be due to molecular weights

not giving an exact mass balance. See info.log for more detailed

information.

If you think this error is acceptable, continue the calculation.

Press 'c' to continue, 'q' to quit:

如果您认为这个错误是可以接受的，请继续计算。

按“c”继续，按“q”退出：

由于这可能会由于反应而导致总质量的非物理增加或减少，因此建议修复这种类型的错误，因此用户应该通过输入q并按键盘上的Enter键来退出计算。只有在特殊情况下，用户才会希望通过输入c并按键盘上的Enter键来继续计算。

如果在反应的化学计量中没有发现错误，则有可能错误的来源可能是反应物和生成物的分子量。为了计算质量平衡，Virtual Reactor使用Base Materials库中每种物质的分子量。

解算器窗口

求解器窗口显示运行仿真的进度和状态，如图14.6所示。在每个时间步骤完成后，求解器将向窗口写入一行，以一系列列的形式表示当前求解器的状态、收敛性和颗粒打包信息。

图14.6求解器窗口    

时间(t)这一列显示当前仿真时间。仿真将一直运行，直到达到指定的结束时间。

时间步长（dt）这一列显示当前时间步长的长度。正如在时间控制中所讨论的，时间步长由用户设置，可以根据CFL数量和温度变化进行自动调整。

体积迭代（Vol itr）此列显示将体积误差减少到低于求解器高级设置对话框中指定的残差值或达到最大迭代值所需的迭代次数。

卷错误（Vol err）该列显示时间步长结束时的卷错误。

x, y， z方向速度迭代（u itr, v itr, w itr）此列显示将x， y和z方向速度误差减少到低于求解器高级设置对话框中指定的残差值或达到最大迭代值所需的迭代次数。

x-, y-， z-方向速度误差（u err, v err, w err）此列显示时间步长结束时的体积误差值。

焓迭代（h itr）这一列显示将焓误差减少到低于求解器高级设置对话框中指定的残差值或如果达到最大迭代值所需的迭代次数。此列仅为热计算的输出。

焓误差（h err）本列显示时间步长结束时的焓误差。此列仅为热计算的输出。

压力迭代（p itr）此列显示将压力误差降低到低于求解器高级设置对话框中指定的残余值或达到最大迭代值所需的迭代次数。

压力误差（p err）此列显示时间步长结束时的压力误差。

CFL数（CFL）该列显示当前时间步长内模型的最大CFL数。CFL数的计算方式为，这是对以速度为u的流体在单个时间步长内将通过多少个尺寸为xcell的单元的度量。CFL数可用于控制时间步长，以保持模型的稳定性和准确性。有关详细信息，请参阅时间控制。    

“Low”、“Med”、“Hi”表示正在经历低、中或高水平过度堆积（颗粒体积分数高于颗粒窗口中定义的紧密堆积值）的细胞数量。在启动过程中，通常会在低列或中列中看到值，但这些值应该会迅速减少。如果在模拟过程中，这些计数稳定地开始增加，这可能是潜在困难的一个指标，用户应该调查原因。一个常见的解决方法是减少时间步长，直到消除过度包装。

R这一列表示颗粒应力方程计算重复的次数。非零值可以表明解算器正在挣扎，这可能导致失败。

当模拟完成时，求解器窗口将停止编写时间步长线，并将显示日期和时间戳，如图14.7所示。

图14.7求解器窗口显示仿真完成

14.3.2。重启求解器

运行中的模拟将定期生成IC文件，稍后可用于从重新启动求解器对话框中重新启动模拟，如图14.8所示。该对话框可从Run窗口访问，包含用于选择要重新启动的IC文件以及重新启动时调整求解器参数、模型输入和数据输出的界面。

请注意    

在主要版本系列中可以重新启动。但是，不可能在主要发布系列之间重启，即14到15、15到16、16到17。

图14.8重新启动求解器对话框

重新启动仿真的步骤

选择一个重新启动文件（IC）通过单击Browse按钮并从出现的文件选择对话框中选择所需的IC文件，IC文件可以位于项目目录中。IC文件可以是重启文件（IC_###）或回溯IC （IC_）。这些将在时间控制中进一步讨论。

更改模拟结束时间如果模拟正在从先前指定的结束时间重新启动，则需要输入新的结束时间才能继续模拟。如果不更新此参数，则模拟将在重新启动并完成时运行单个时间步，再次达到先前指定的结束时间。    

如果需要调整其他参数，可能需要解算器重新读取边界条件或粒度分布SFF文件，更改磨损状态或重新启动时更改其他参数。这些选项将在下面进行讨论。

请注意

对于重启时不需要更改的参数，只需将字段留空即可。只有在重启对话框中专门输入值的项目才会被更改。

开始模拟重启在重启对话框中对参数进行必要的更新后，可以通过点击重启按钮重新启动模拟。这将打开一个新的求解器窗口，用户将看到与运行配置中讨论的相同的一系列提示。在这种情况下，用户可能希望以保留项目目录中现有数据的方式回答这些提示。除了常规的求解器提示外，用户还会被提示求解器是否应该在重启时重置数据的平均值。

时间参数

时间步长这是仿真中使用的当前时间步长。

结束时间这是模拟的结束时间。如果之前的结束时间和IC重启时间相同，则需要将此设置为稍后的值。

求解器残差

体积、压力和速度的求解器收敛参数可以通过在文本框中输入新的最大迭代或残差来更改。在求解器高级设置对话框中进一步讨论了求解器的收敛参数。

Reread和Reset Parameters

重新读取时变文件选中此框将指示求解器重新读取所有瞬态SFF文件。这包括与压力、流量、注入或热壁bc相关的任何SFF文件以及可视化数据输出。

重读BC粒度分布表单击此复选框将指示求解器重新读取与物种粒度分布相关的所有SFF文件。请注意，这种变化只会影响通过边界进入系统的新颗粒。    

重置磨损选中此框将重置每个颗粒的颗粒磨损模型中的“创伤”值。颗粒磨损模型在《颗粒磨损》中有进一步的讨论。

重置磨损选中此框将重置每个颗粒的壁面侵蚀模型中的“冲击”值。在《壁面侵蚀》中进一步讨论了壁面侵蚀模型。

重置平均数据变量average data用于计算细胞和颗粒数据的时间平均值，并在模拟运行时将平均值写入可视化文件。重启后，通常需要重置平均数据变量，以便模拟只考虑重启后产生的数据。选中此复选框将在重启时重置平均值。它还将允许在下面选择平均数据变量。

输出时间间隔

终端和日志文件终端和日志文件的打印间隔决定了时间步长数据写入终端和日志文件的频率。默认值为1e-07秒。

可视化文件可视化间隔是可视化文件写入之间的模拟时间间隔，如可视化数据中所述。

重新启动文件（IC_###）重新启动间隔是创建模拟时间戳Restart IC_<时间戳>文件之间的模拟时间间隔。重新启动间隔将在时间控制中进一步讨论。

回溯文件（IC_）回溯间隔是创建“紧急”重启IC_文件之间的时间间隔。在时间控制中进一步讨论了回溯间隔。

CFL控制

在最小CFL和最大CFL文本框中设置的值将被求解器用于自动调整时间步长。

模型属性    

如模拟开始选项中所述，一个模型可以被指定为热的，但最初作为一个等温模型启动。在这种情况下，通过选择此复选框，可以在重新启动时将模型从等温更改为热模型。

更改化学状态指定了化学反应的模型可以在重新启动时通过单击更改化学状态复选框来调整化学状态，如模拟开始选项中所述。这将启用以下选项：

§开启化学反应-如果模型中指定了化学反应，但初始状态为“关闭”，则可以开启化学反应。

§斜坡从___ s到___ s-化学反应可以在指定的时间内斜坡“开启”，如果化学反应在模型中指定，但初始关闭。

§关闭化学反应-化学反应可以在重新启动时在模型中关闭。

更改磨损状态如果壁蚀模型已指定但已关闭，则可通过单击更改磨损状态复选框将其打开或关闭。在《壁蚀》中进一步讨论了壁面侵蚀模型。

可视化数据变量单击此选项允许在重新启动时添加或删除可视化数据输出变量。这将显示一个可视化数据输出对话框，它是可视化数据窗口的克隆。可视化数据中提供了每个变量的描述。

平均数据变量平均数据变量可以在重启后改变。单击“平均数据变量”按钮将显示一个“平均数据对话框”，该对话框是“平均数据窗口”的克隆，用于选择要平均的可视化数据。在平均数据中提供了对数据平均的描述。

原始数据变量可以在重启时通过点击原始数据变量按钮来改变原始数据输出的选择。这将显示一个原始数据输出对话框，该对话框是用于选择原始数据和输出频率的原始数据窗口的克隆。raw data中提供了对原始数据输出的描述。    

14.3.3。交互

用户可以通过点击“运行窗口”上的“交互”按钮与正在运行的模拟进行交互。如图14.9所示，交互对话框提供了一个界面，用于调整求解器时间和收敛参数，重新读取SFF文件以获取边界和psd，并在当前仿真时间创建输出数据。调整完成后，用户需要点击Submit按钮，将更改传递给求解器。

图14.9交互窗口

请注意    

对于任何不需要更改的参数，只需将字段留空即可。只有在交互对话框中专门输入值的项目才会被更改。

时间控制

交互对话框提供了用于调整运行模拟的以下与时间相关的参数的界面。有关这些参数的讨论，请参见时间控制。

时间步长这是仿真中要使用的最大时间步长。

结束时间这是模拟的结束时间。如果将此设置为小于当前模拟时间的值，则模拟将结束。这样做被认为是立即结束模拟的“安全”方法，因为求解器会在完成之前写一个重启文件。

CFL文本框表示CFL的最小值和最大值，求解器将使用这些值来自动调整时间步长。

求解器残差

通过在文本框中输入新的最大迭代或残差，可以通过交互对话框更改体积、压力和速度的求解器收敛参数。在求解器高级设置对话框中进一步讨论了求解器的收敛参数。

重置跟踪

重置磨损选中此框将重置所有壁面壁面侵蚀模型中的“冲击”值为零。在《壁面侵蚀》中进一步讨论了壁面侵蚀模型。

重置磨损选中此框将重置每个颗粒的颗粒磨损模型中的“创伤”值。颗粒磨损模型在《颗粒磨损》中有进一步的讨论。

重置bc处的颗粒质量赤字勾选此框将重置求解器在所有边界条件下的质量赤字记录为零。质量赤字警告在颗粒馈送中有进一步的讨论。    

输出时间间隔

终端和日志文件终端和日志文件的输出间隔决定了时间步长数据写入终端和日志文件的频率。默认值为1e-07秒。

可视化文件可视化间隔是可视化文件写入之间的模拟时间间隔，如可视化数据中所述。新的时间间隔将在下一次预定的可视化文件写入后开始，除非选中“start new plot intervals now”复选框。

重新启动文件（IC_###）重新启动间隔是创建模拟时间戳Restart IC_<时间戳>文件之间的模拟时间间隔。重新启动间隔将在时间控制中进一步讨论。

回溯文件（IC_）回溯间隔是创建“紧急”重启IC_文件之间的时间间隔。在时间控制中进一步讨论了回溯间隔。

力输出

重新启动（IC_###）选中此框将指示求解器在当前时间创建一个重新启动IC文件。

可视化文件选中此框将指示求解器在当前时间写出一个可视化文件。这个可视化文件将会有一个…快照。Plt文件后缀将其与主要的可视化系列分开。

Population Data选中此框将指示求解器在当前时间创建颗粒种群文件。种群文件在Population Data中进行了讨论。

原始颗粒数据选中此框将指示求解器在当前时间创建一组颗粒捕捉文件。颗粒捕捉文件在Raw Data中进行了讨论。

数据平面选中此框，指示求解器在当前时间写出所有数据平面文件。数据平面文件在数据平面中讨论。

重新读取SFF文件    

重新读取时变文件选中此框将指示求解器重新读取所有瞬态SFF文件。这包括与压力、流量、注入或热壁bc相关的任何SFF文件以及可视化数据输出。

重新读取PSD输入文件选中此复选框将指示求解器重新读取与物种粒度分布相关的所有SFF文件。请注意，此更改只会影响通过边界馈送到系统中的新颗粒。

14.3.4。监视器运行

点击监视器运行按钮将打开Barracuda的Tecplot，并自动创建一组预定义的plot，这些plot通常用于监控barracuda模拟。这允许用户快速方便地绘制以下重要参数：

§从history.log

§dt

§CFL

§particle mass

§Number of numerical particles

§从runtime.log

§Elapsed real time

§Simulation speed

§Estimated time to completion

§Balance Factor

§从memory.log

§Total memory allocated    

图14.10监视器运行图

来自每个文件的信息绘制在单独的Page上，每个参数绘制在自己的Frame中。为了方便地在不同的页面之间导航，建议启用Tecplot for Barracuda中的页面侧栏，这是通过菜单视图，页面侧栏完成的。在“页面”列表中单击页面名称将切换到该页面。

当模拟活动正在运行时，监视器运行创建的Tecplot for Barracuda窗口可以保持打开状态。双击Quick Macro Panel项目Load: Refresh / Reload梭鱼数据将导致所有图更新为可用于模拟的最新数据。

14.4。从命令行运行

通常，用户将使用barracudaGUI创建一个项目文件。然而，barracuda求解器也可以在命令行上运行。

运行网格生成器

网格生成器可以通过输入以下命令行来运行：

cpfd.ggrid.i

要输出到grid.log文件，请运行以下命令：

cpfd.ggrid.i&>grid.log

然后，求解器可以在项目目录中运行，输入：

cpfd.xmy_project_file.prj

my_project_file的地方。Prj是一个示例工程文件名。

此外，可以使用——help标志将网格生成器选项的完整列表输出到终端：

cpfd.g--help

运行help命令时，会显示以下标志列表：

图14.11——cpfd.g .的帮助标志输出

求解器标志

可以在solver命令中添加标志，以运行单个时间步或自动回答用户提示。对用户提示的回答对于多个模拟的自动脚本编写可能是必要的。等价的缩短标记在括号中标注。

运行单个时间步用户可以在求解器中添加-setup （-s）标志，指示它运行单个时间步。有关运行单个时间步骤的其他信息，请参阅运行求解器设置。

cpfd.xmy_project_file.prj-setup

打印版本信息用户可以在solver命令中添加——version标志，让它打印关于solver版本的信息。这不会用于项目文件。    

cpfd.x--version

运行在试驾模式-testdrive标志允许用户在自己的系统上执行定时测试。在试驾模式下运行时，求解器执行所有仿真计算并在runtime.log中记录计时信息，但不写入任何其他输出文件（history.log、Tecplot可视化文件、通量平面文件等）。这允许在特定硬件上量化仅cpu，单gpu和/或多gpu的仿真速度，并使用您特定的Virtual Reactor项目文件。

在试驾模式下运行求解器有两种方式：

1.在“运行选项”对话框的“高级”命令行参数输入框中添加选项-testdrive。

2.如果您是从命令行运行，则添加-testdrive作为命令行参数。

在试驾模式下运行求解器的几点建议：

1.为了获得最准确的计时结果，一次只运行一个求解器实例。

2.建议在稳定状态下使用IC_文件中的Restart Solver来执行定时测试。这将在大多数情况下提供最具代表性的模拟速度数字，并允许通过运行很短的时间来收集有用的计时数据。根据CPFD的经验，在重启点后运行100或1000个时间步长后，通常可以获得可靠的仿真速度数字。

3.出于保存记录的目的，可以为每个计时情况在单独的目录中运行，或者在每次运行完成后将runtime.log文件重命名为不同的名称。

求解器在试驾模式下运行的要求：    

1.您必须拥有有效的Virtual Reactor设置许可才能运行求解器。

2.如果希望使用多个gpu执行时序测试，则必须在系统中安装多个满足多gpu系统要求的gpu。

3.您不需要有可用的GPU许可证。在测试驱动模式下运行时，求解器不检查GPU许可证。

处理速率方程质量平衡提示用户可以自动回答速率方程质量平衡提示，在运行配置中讨论，通过包含-contChem （-cc）标志来指示求解器继续或-quitChem （-qc）标志来退出计算。

cpfd.xmy_project_file.prj-contChem

或

cpfd.xmy_project_file.prj-quitChem

处理暂态数据文件提示符用户可以自动回答暂态数据文件提示符，在运行配置中讨论，包括-overWriteFile （-ow）标志来指示求解器覆盖现有的暂态数据文件，如果它们存在，或者-appendFile （-aw）标志来向现有文件追加新的暂态数据。

cpfd.xmy_project_file.prj-overWriteFile

或

cpfd.xmy_project_file.prj-appendFile

列出所有命令行选项当使用——help标志时，求解器将列出所有可用的命令行选项：

cpfd.x--help

图14.12——cpfd.x的帮助标志输出

14.5。运行命令行交互

用户还可以通过命令行与正在运行的仿真进行交互。如果系统是无头的，在与仿真交互之前，一定要将下面的环境变量设置为离屏。

export QT_QA_PLATFORM=offscreen

Interact GUI中的每个选项都由单独的命令行标志控制。

时间控制

要调整模拟的时间步长，例如调整到0.01，在命令行中输入：

act -dt 0.01

要调整模拟结束时间，以100秒为例，在命令行中输入：    

act -endTime 100

重读SFF文件

要通知解算器重新读取所有边界条件.sff文件，请在命令行中输入：

act -reread BCs

列出所有命令行选项

要查看所有可用选项的列表，请使用以下命令：

act -help console

## These options suppress GUI launch.

## Listed options correspond to the main GUI.

act_barracuda [-showGUI]    # Show populated GUI.

              [-warnAsErr]  # Warning treated as error after this flag.

              [-dt           <new              </newdt>]

              [-endTime   

              [-volumeIteration        <new              </newmax iteration>]

              [-pressureIteration   

              [-velocityIteration   

              [-volumeResidual         <new              </newconvergence tolerance>]

              [-pressureResidual       <new              </newconvergence tolerance>]

              [-velocityResidual       <new              </newconvergence tolerance>]

              [-dump < restart | graphics | population | particles >]

              [-reread < BCs | PSDs >]

              [-reset < wear | attrition | BCParticleDeficits >]

              [-minCFL   

              [-maxCFL   

              [-printInterval           <new              </newinterval>]

              [-restartInterval         <new              </newinterval>]

              [-plotInterval            <new              </newinterval>]

              [-startPlotIntervalNow]

## For 2D data options use-help 2Ddata

14.6。命令行重启

命令行也可以用来从IC文件中重新启动模拟。这是用cpfd完成的。X求解器命令；特殊重启项目文件；以及任何必要的解算器标志。不过需要说明的是，在重启时，解算器并不检查反应质量平衡。因此，暂态数据文件提示符是与从命令行重新启动模拟相关的唯一标志。

cpfd.xmy_restart_file.prj

重启项目文件

重新启动项目文件是一个文本文件，其中包含对要重新启动的IC文件的引用，并且可能包含新的结束时间、时间步长或可以通过重新启动对话框设置的任何其他参数，这些参数在重新启动求解器中讨论过。    

下面显示了一个示例重启项目文件，它指示求解器从IC_重新启动，将结束时间更改为200秒，并将时间步长更改为3毫秒。

restart IC_

endTime 200

dt 1e-3

endRestart

虽然这种类型的文件可以手动创建，但通常最简单的方法是使用重新启动对话框，在重新启动求解器中进行了讨论。当使用重新启动对话框重新启动计算时，隐藏文件. Restart。Prj文件将在项目目录中创建。该文件将包含重新启动模拟所需的语法，以及所有指定的调整。建议将隐藏的.restart.Prj文件复 制到新文件中，方便保存记录。然后，重新启动项目文件的新副本可用于从终端重新启动。

cp.restart.prjmy_restart_file.prj

14.7。数据文件参考

以下是求解器创建的文件的描述。有些文件，比如history.log，会在每次求解器运行时被写入。其他文件，例如临时数据文件，只有在模型的数据输出窗口中指定时才会创建。虽然这里列出了这些文件，但主要的参考资料在数据输出章节的相应部分。

14.7.1。history.log

history.log文件是命令窗口数据输出的增强记录。因此，history.log文件的许多列与写入求解器命令窗口的内容相同。然而，除了在求解器运行终端中显示的列之外，history.log中也存在其他列。该文件有一个sff风格的头节，其中包含列号、变量描述和度量单位，用于描述每列中的数据。此外，在history.log的最顶部，记录了求解器版本、构建日期和编译时间。一个典型的history.log头部分如下所示。    

# ...

#

#@   1  "Time"               "s"

#@   2  "dt"                 "s"

#@   3  "Volume iterations"  ""

#@   4  "Volume error"       ""

#@   5  "u iterations"       ""

#@   6  "u error"            ""

#@   7  "v iterations"       ""

#@   8  "v error"            ""

#@   9  "w iterations"       ""

#@  10  "w error"            ""

#@  11  "h iterations"  ""

#@  12  "h error"  ""

#@  13  "p iterations"  ""

#@  14  "p error"  ""

#@  15  "CFL"  ""

#@  16  "dT/dt"  "K/s"

#@  17  "particle mass"  "kg"

#@  18  "warning count"  ""

#@  19  "pVolFrac low count"  ""

#@  20  "pVolFrac medium count"  ""

#@  21  "pVolFrac high count"  ""

#@  22  "pVolFrac adjustment count"  ""

#@  23  "Chemistry ODE average iterations"  ""

#@  24  "Chemistry ODE maximum iterations"  ""

#@  25  "Chemistry ODE outloop iterations"  ""

#@  26  "Chemistry ODE number of cells failed"  ""

#@  27  "Number of numerical particles"  ""

#@  28  "Number of Tracers"  ""

上面的大部分列都在上面为求解器窗口进行了讨论。附加的列如下：

dT/ dT这一列显示给定时间步长下系统温度变化的最大速率。这个量的单位是K/s（或者你选择的任何时间单位），为了便于阅读，它会按10⁵的倍数缩小。对于非热模拟，温度变化率不是一个有用的量，只有在启用热计算时才会写入。

此列显示时间步长期间模型中颗粒的总质量。

warning count此列显示仿真中遇到的警告总数。

pVolFrac low/medium/high count这些列分别显示了低、中、高水平overpacking的单元格数量。这些分别对应于求解器窗口中的Low、Med和Hi列。    

化学ODE平均迭代和最大迭代这些列给出化学ODE求解器收敛到单元中的解所需的平均迭代和最大迭代。这一列仅为化学计算的输出。

化学ODE出循环迭代本列显示化学的ODE求解器需要重置和运行以在单元中收敛的次数。此列仅用于化学计算的输出。

化学ODE单元格数失败此列显示化学ODE求解器失败的单元格数。此列仅用于化学计算的输出。

数值颗粒数此列显示在每个时间步模拟中的数值颗粒总数。

跟 踪器数量该列显示仿真中跟踪 器的总数。

14.7.2。info.log

info.log文件由求解器创建，包含仿真初始化过程中生成的有价值的信息和消息。随着仿真的运行，额外的信息将被求解器写入文件。输出到info.log文件的信息包括对模型网格、颗粒psd、固体材料、边界条件、化学反应和模型中计算颗粒大小的分析。

14.7.3。warning.log

log文件是由求解器创建的，它包含有关模拟过程中输出的任何警告消息的有价值的信息和消息。在求解器运行终端中显示的所有警告都记录在这里。可能在warning.log中找到的一些警告是：

Wed Nov  9 15:43:30 2016 [8.968841e-01]: # Decrease dt: chemical mass production ...

Wed Nov  9 15:44:46 2016 [1.558654e+00]: # Decrease dt from CFL. Old =  1.000e-02 ...

Wed Nov  9 15:46:15 2016 [2.414654e+00]: # Decrease dt: large temperature change ...

上面的每一行都被截断，以适应可用的空间。每行包含的关键信息是：

§一个日期和时间戳，记录实时发出警告的时间。

§[方括号]中的模拟时间，用于记录模拟时间中警告发出的时间。    

§警告的文字描述。

许多警告只是简单的信息，不需要采取行动。然而，如果一个特定的警告不断出现，这可能表明模拟运行不佳。在这种情况下，进一步的调查和故障排除可能是必要的。

14.7.4。runtime.log

runtime.log文件是由求解器创建的，它包含了关于模拟是如何实时运行的信息。一个典型的runtime.log头部分如下所示。

# ...

#

#@   1  "Time"                                                        "s"

#@   2  "dt"                                                          "s"

#@   3  "Elapsed real time"                                           "s"

#@   4  "Simulation speed"                                            "s/day"

#@   5  "Estimated time to completion"                                "s"

#@   6  "Number of numerical particles"                               ""

#@   7  "Balance Factor"                                              ""

在Run Configuration中讨论求解器窗口的列Time和dt。列数值颗粒数与history.log中同名的列相同。增加的列如下：

经过的实时时间此列显示求解器运行的总时间。

仿真速度此列显示仿真运行的速度。    

预估完成时间此列显示模拟完成前的预估时间。

平衡因子这一列显示了求解器使用多个gpu的效率。该值为0和1之间的比率，其中1为理想的平衡条件。

注意，第3到第5列的单位是在Solver Output units中设置的。估计完成时间的单位与经过的实时时间的单位相同。