命令行参考

starccm+命令可以启动任一 Simcenter STAR-CCM+客户端：

starccm+ [options] [simulation]

或服务器进程：

starccm+ -server [options] [simulation]

在没有任何参数的情况下，将启动 Simcenter STAR-CCM+GUI 客户端。不启动服务器进程，因为只有创建或加载模拟时才需要服务器进程。

如果模拟文件命名时没有任何选项，则 Simcenter STAR-CCM+客户端和服务器都启动，命名的文件加载到服务器。

如果指定了-server 参数，则仅启动 Simcenter STAR-CCM+服务器进程。还可以在命令行指定任何服务器选项以启动客户端；客户端在启动服务器进程时传递这些选项。

常规选项


参数	描述
`-info`	输出模拟文件的信息：保存该文件的 Simcenter STAR-CCM+版本（在此示例中为20.06.###）、分区数、文件大小及文件中的迭代次数： `STAR-CCM+ 20.06.### (linux-x86_64-2.5/gnu4.6) Serial 680.34 KB Iter 66`
`-ini <file>`	激活包含常规选项和客户端选项的`.ini` 文件。
`-loc`	对于客户端，此选项会关闭用来在网络上定位服务器的查询广播；它还阻止服务器响应任何定位器查询。从客户端发出的广播是针对已知主机的 UDP 多播以及 TCP ping。如果在没有模拟文件的情况下启动 Simcenter STAR-CCM+客户端，则默认情况下会启动此多播搜索。在 Windows 中，此选项可能导致从个人防火墙发出网络访问警告。
`-new`	启动 Simcenter STAR-CCM+工作区，并启动新的模拟，无需访问模拟文件。
`-printpids`	输出进程 ID。输出格式的示例如下所示： `Host ID 0 Rank 0 on marlin32 with process ID 7270 Host ID 0 Rank 1 on marlin32 with process ID 7422 Host ID 0 Rank 2 on marlin32 with process ID 7591`
`-v、-vv、-vvv`	激活详细模式，输出环境更改和子命令。
`-version`	输出 Simcenter STAR-CCM+版本信息（在此示例中为20.06.###）： `20.06.###`
`-help`	打印有关命令行选项的信息。

许可证选项


参数	描述
`-lite`	请求简化版会话许可证而非完整许可证。提供的功能集有所减少。
`-power`	启动具有无限制并行许可证功能的 Simcenter STAR-CCM+。
`-doepower`	将无限制并行许可证用于优化会话许可证。
`-nosuite`	阻止主许可证用于启用核心进行并行计算。只有并行许可证才用于启用核心进行并行计算。
`-powerpre`	使用 10 个 `DOEtoken` 许可证启动一个 Simcenter STAR-CCM+预处理和后处理会话。
`-tokensonly`	指定仅将 `DOEtoken` 许可证用于优化研究。通过此选项，还可以使用 `DOEtoken` 许可证来启动 Simcenter STAR-CCM+的常规并行计算。
`-notokens`	指定不将 `DOEtoken` 许可证用于优化研究。
`-doe-prefer-hpcdomains`	更改分配 `DOEtoken` 许可证功能的顺序。在将 `DOEtoken` 许可证功能用于优化研究之前，使用此选项分配 `hpcdomains` 许可证功能。
`-podkey <value>`	指定 PoD 许可证密钥。
`-doeuuid <value>`	指定 DOE UUID（通用独特标识符）。
`-licpath <path:...>`	指定覆盖默认许可证路径的许可证路径。当使用此选项时，Simcenter STAR-CCM+使用该路径为生成的服务器会话定义新的 `CDLMD_LICENSE_FILE` 环境变量。
`-reserve <lic1[,lic2,...]>`	用于指定可自动分配的附加许可证。
`-noreserve`	阻止分配附加许可证，除非模型操作需要附加许可证。
`-noretry`	阻止在执行重要的操作时重试附加许可证。
`-norelease`	阻止在导入几何后释放附加许可证。
`-readonly`	在不消耗 Simcenter STAR-CCM+ 许可证的情况下查看模拟。但是，必须在启动时检测到许可证管理器。

客户端选项


参数	描述
`-batch [command]`	在批处理模式下启动 Simcenter STAR-CCM+（无 GUI）。可以使用以下额外命令： `mesh`- 运行网格生成流程 `run` - 运行求解器，直至满足停止准则 `step`- 逐步求解 `<macro>.java`- 运行指定的 Java 宏文件如果未指定命令，则默认操作是运行求解器。在每种情况下，都通过自动保存功能自动保存模拟（除非该属性关闭）。应用模拟操作时，如果已激活一系列模拟操作，没有任何`[命令]`的`- batch` 将以批处理模式执行操作。如果没有活动的一系列模拟操作，`-batch` 将通过忽略模拟操作来逐步执行模拟。但是，一旦包含附加命令，批执行便不包括模拟操作，无论是否存在活动的操作系列。可以在 `-batch` 参数中指定多个命令。在以下示例中，在运行网格生成流程和求解器之前，三个宏按顺序运行： `-batch macro1.java,macro2.java,macro3.java,mesh,run`
`-batch-report`	生成批处理模拟的总结报告。报告以`.html` 格式显示。此报告包含有关运行模拟的计算机系统的详细信息，以及模拟本身的详细信息。
`-classpath <classpath>`	覆盖选项对话框中的用户宏类路径设置。此选项仅影响 Simcenter STAR-CCM+当前会话中的宏编译。
`-clientldlibpath <path>:<path>:<path>`	此选项可用于将目录路径显式添加到客户端运行时环境的 Simcenter STAR-CCM+客户端库搜索路径 (`LD_LIBRARY_PATH`)。
`-config <id>`	访问已保存的服务器选项配置。（这些选项也在加载模拟或创建新模拟的对话框的“保存的配置”列表中列出。）
`-save-config <id>`	保存服务器选项的配置，将其添加到加载模拟或创建新模拟的对话框中的“保存的配置”列表。
`-fontsize <size>`	调整该会话的 Simcenter STAR-CCM+客户端工作区（如对话框和对象树）中使用的字体大小。使用此命令添加所需的字体大小。例如，`starccm+ -fontsize 16`命令将字体大小设为 16 磅。
`-host <host> -port <port>`	指定客户端连接到的运行的 Simcenter STAR-CCM+服务器进程的`主机`和`端口`。如果`-host` 和`-port` 选项被占用，`模拟`文件将不能被指定。
`-locale <locale>`	覆盖操作系统的默认语言环境。可以采用以下语言运行 Simcenter STAR-CCM+：英语（美国）：`en:US` 日语：`ja` 中文（简体）：`zh` 韩语：`ko` 俄语：`ru:RU`
`-macro <file>`	客户端启动时运行宏`文件`。此选项与`-batch` 的相似点是读取宏文件，但在此情况下打开了 GUI。此选项需要指定`模拟`文件。由于无法录制包含打开模拟文件的宏，因此从不发生冲突。
`-nbuserdir <dir>`	用于指定除`$HOME` 之外的写入`.star---*`目录的位置。在客户端启动后输入此命令。此选项更改关键 Simcenter STAR-CCM+信息（包括用户设置目录和客户端日志消息）的位置。如果没有`$HOME` 目录的写入权限或者想要共享模块，可以考虑使用此选项。
`-noexit`	阻止服务器进程在批处理文件执行完成后关闭。默认情况下，客户端和服务器进程都会在宏完成后关闭。
`-on <host>`	指定启动服务器进程的`主机`。默认情况下，当创建新模拟或打开现有模拟文件时，Simcenter STAR-CCM+客户端在本地机器上启动服务器进程。但是如果指定`-on` 选项，则客户端尝试使用适当的远程 Shell 启动指定`主机`上的服务器进程。此外，此选项可以直接用作并行选项来指定并行服务器使用的主机。
`-param <global parameter name> <value>`	指定目标模拟中已存在的全局参数的值。可以使用固定值或表达式来设置标量和矢量参数值，还可以为文件参数设置文件路径。允许使用多个实例。如果任一参数（名称或值）包含空格或保留字符（如 '$'），将参数用引号（单引号或双引号，具体取决于命令外壳和目的）括起来。示例 `starccm+ -param MaxTime 10.0 demo.sim` `starccm+ -param MinWidth 2cm demo.sim` `starccm+ -param Sample [0.1,0.2,0.15] demo.sim` `starccm+ -param MaxTime 10.0 -param MinWidth 2cm demo.sim` Linux 引用示例 `starccm+ -param MaxWidth '$MinWidth * 2' demo.sim` Windows 引用示例 `starccm+ -param MaxWidth "$MinWidth * 2" demo.sim` 要为特定模拟设置文件参数： `-param <file parameter name> <path to file> <path to simulation>` 如果使用引号将 `<path to file>` 括起来，则路径可以使用任一类型的分隔符（正斜杠或反斜杠）。如果没有使用引号，则对于 Linux，`<path to file>` 必须针使用正斜杠分隔符，对于 Windows 则必须使用反斜杠分隔符。示例 `starccm+ -param demoparameter demofile.txt demo.sim`
`-reset`	恢复默认客户端布局（包括窗口位置）和设置（选项和装载的目录）。
`-time`	输出批处理运行后服务器经历的时间和 CPU 时间。具体而言，它在关机时输出服务器的计算资源使用总结。串行： `Saving: /home/ncr/sims/suprBump@00077.sim Server Elapsed Time : 5.362 (s) Server CPU Time : 0.830 (s) Closing connection to server and exiting` 并行： Auto save: /home/ncr/sims/suprBump@00077.sim Saving: /home/ncr/sims/suprBump@00077.sim \|Global Rank\|Server Elapsed Time (s)\|Server CPU Time (s)\|MPI Overhead (s)\|MPI Overhead %Elapsed Time (s)\| \| 0\| 7.120\| 1.250\| 0.461\| 6.476\| \| 1\| 7.120\| 5.150\| 2.371\| 33.302\| \| 2\| 7.120\| 5.120\| 2.425\| 34.056\| \| 3\| 7.120\| 5.160\| 2.451\| 34.421\| Maximum worker communication time on rank : 3 Minimum worker communication time on rank : 0 Average worker communication time : 1.927 Standard deviation worker communication times : 0.847 Closing connection to server and exiting
`-userdir <name>`	在 Linux 上，将用户设置目录添加到`主`目录（可以选择性地将`名称`添加到文件夹名称）。
`-nbuserdir <name>`	在 Linux 上，指定 NetBeans 目录。
`-clientcore`	在 Linux 上，保留一个核心以在批处理系统中运行客户端。如果在并行运行时执行大量后处理操作，则使用此标志。
`-clientldpreload <file:...>`	在 Linux 上，设置客户端 `LD_PRELOAD` 环境变量。

服务器选项


参数	描述
`-arch <architecture>`	此选项用于覆盖机器架构的自动确定。指定的架构必须存在于安装中，且必须与机器架构兼容。如果不满足这些条件，则 Simcenter STAR-CCM+退出或者发生运行时错误。例如，此参数适用于在基于 Opteron 的 64 位架构上执行 32 位 Linux 安装的情况： `-arch linux-x86-2.2.5`
`-batchsystem <system>`	此选项可用于在受支持批处理管理系统的控制下帮助启动并行 Simcenter STAR-CCM+（有关使用情况，请参见使用批处理管理系统）。当前受支持的系统包括： PBS (`<system>=pbs`)：Open PBS、PBS Pro、扭矩 SLURM (`<system>=slurm`) Grid Engine (`<system>=ge`)：Sun/Open Grid Engine 和变量 LSF (`<system>=lsf`) 流程分布遵循与 `-machinefile` 相同的逻辑。表示并行执行。不能与 `-machinefile` 或 `-on` 一起使用。
`-collab`	在服务器启动时，允许其他用户与其连接。（默认情况下，仅允许启动 Simcenter STAR-CCM+服务器的用户与其连接。）
`-cout`	消息将发送到控制台，而不是发送到 Simcenter STAR-CCM+客户端。
`-flexiblaslib`	选择 FlexiBLAS 用于 BLAS 和 LAPACK 函数的数学库。在 x86_64 系统上必须使用 AOCL 或 MKL，在 aarch64 系统上必须使用 ARMPL，并且要使用 Simcenter STAR-CCM+ 随附的库。要选择自定义数学库，也可以指定动态库文件（在 Linux 中为 .so，在 Windows 中为 .dll）的路径。有关更多详细信息，请参见手动选择数学库。
`-jobmanager <URL>`	指定用于控制 Simcenter STAR-CCM+服务器资源的资源管理器的 URL。资源管理器会自动将此选项添加到服务器。
`-ldlibpath <path>:<path>:<path>`	此选项可用于将目录路径显式添加到服务器运行时环境的 Simcenter STAR-CCM+服务器库搜索路径 (`LD_LIBRARY_PATH`)。当 Simcenter STAR-CCM+依赖于安装在自定义位置的第三方软件时，需要`-ldlibpath` 选项。此外，考虑在以下情况下将其用于用户程序：链接到数学库，如 IMSL 或 NAG。（访问这些库中的函数是编写用户程序的原因之一。）大多数可动态生成`.so` 文件的编译器会将它链接到编译器自身的运行时库。添加这些库的路径，除非它们碰巧是系统库（因为系统库在 Linux 上使用 GNU 编译器）。
`-load`	一旦服务器启动，则加载指定的`模拟`文件。如果不包含此选项，则在客户端连接到服务器时按需加载模拟数据库。
`-msjob[:<opt>]`	将集群作业提交给 Windows 服务器作业调度程序。此功能仅在 Windows Server 2012 机器上可用。
`-noconnect`	启动服务器时，可指定仅限启动该服务器的 Simcenter STAR-CCM+控制台会话。其他用户无法连接到该服务器。
`-port <port>`	指定供 Simcenter STAR-CCM+打开的服务器端口。
`-portrange <range>`	指定服务器可尝试绑定到的端口数量。
`-server`	启动具有自动生成的端口号的 Simcenter STAR-CCM+服务器。
`-rsh <option>` `-svrrsh <option>`	`-rsh <option>`选项可用于指定：用于从客户端启动远程服务器的远程 Shell 服务器中用于启动并行进程、协同仿真等的远程 Shell。 `-svrrsh <option>`仅指定服务器的远程 Shell。当使用`-server` 启动服务器时，`-rsh` 或`-svrrsh` 选项默认为 `ssh`。在新的客户端会话中，远程 Shell 设置默认为环境选项（通用远程进程启动命令和服务器远程进程启动命令）的设置。
`-taskid <pid>`	指定控制服务器资源的资源管理器的任务 ID。资源管理器会自动将此选项添加到服务器。
`-ldpreload <file:...>`	在 Linux 中，对于服务器，将共享库列表设为 `LD_PRELOAD`。

可视化选项


参数	描述
`-graphics <option>`	对于 Simcenter STAR-CCM+ 客户端和 Simcenter STAR-CCM+ Viewer，使用以下某个选项： `auto` -（默认）首选 Mesa OpenGL 上支持的原生 OpenGL；此选项的效果与不使用任何 `-graphics` 选项的效果一样。 `native` - 强制使用原生 OpenGL `mesa` - 强制使用 Mesa OpenGL；使用原有 Mesa 图形驱动程序 LLVMpipe。 `mesa_swr` - 强制使用 OpenSWR Mesa 驱动程序，此驱动程序的性能优于原有选项。此选项需要 AVX CPU 指令集支持（2012 年之后发布的所有 CPU 都支持此指令集）。
`-rgpu <option>`	在 Linux 系统中利用多个 GPU 进行本地交互或批处理会话，或远程服务器上的渲染。选项包括： `N` - 选择系统中要使用的特定 GPU，例如 `-rgpu 1` 或 `-rgpu 5`。 `自动` - 根据 `$TEMP` 中的文件循环使用系统中所有可用的 GPU。 `-agpu` 是特别渲染的等效参数。有关此类渲染的详细信息，请参见远程渲染的其他信息。有关更多信息，请参见使用多个 GPU（仅 Linux）。
`-rgraphics`	对于 Simcenter STAR-CCM+ 服务器（远程渲染），使用以下某个选项： `auto` -（默认）首选 Mesa OpenGL 上支持的原生 OpenGL；此选项的效果与不使用任何 `-rgraphics` 选项的效果一样。 `egl` - 强制使用 EGL（仅限 Linux）上的原生 OpenGL `native` - 强制使用原生 OpenGL `mesa` - 强制使用 Mesa OpenGL；使用原有 Mesa 图形驱动程序 LLVMpipe。 `mesa_swr` - 强制使用 OpenSWR Mesa 驱动程序，此驱动程序的性能优于原有选项。此选项需要 AVX CPU 指令集支持（2012 年之后发布的所有 CPU 都支持此指令集）。 `-agraphics` 是特别渲染的等效参数。有关此类渲染的详细信息，请参见远程渲染的其他信息。
`-rthreads N`	客户端选项。设置可视化任务（包括高级渲染）可用的线程数 `N`。使用此设置时，考虑以下内容：如果为渲染线程指定较高的值，可能会造成资源争用，干扰计算机正常运行。增加渲染线程会线性缩放性能。然而，如果超线程或多 CPU 系统上的线程计数较高，尽管性能仍可提高，但线性缩放可能会失败。场景的复杂程度也会影响性能并防止缩放。对于通过 `-rthreads` 命令行选项指定的值，其优先级高于通过工具 > 选项设定的对应设置。不能与`-batchsystem` 选项结合使用。如果结合使用，`-rthreads` 默认为值 1。如果在使用 `-batchsystem` 时，尝试指定的 `-rthreads` 值大于 1，则 Simcenter STAR-CCM+ 将生成一条警告消息。
`-rr 服务器`	客户端选项，用于告知服务器在其机器上为客户端启动渲染器。
`-rr hostname:port`	客户端选项，用于告知服务器在指定主机上启动渲染器：参数 `hostname:port` 告知服务器使用之前在其他机器上启动的渲染器（使用 `starrenderer` 启动）。
`-rr hostname`	客户端选项，用于告知服务器在特定主机上启动临时渲染器：参数 `hostname` 告知服务器在其他机器 (hostname) 上启动渲染器，然后使用它。有关特别渲染的详细信息，请参见远程渲染的其他信息。
`-rrthreads N`	服务器选项，控制服务器可以为使用`-rr` 连接的客户端生成的渲染进程使用的线程数 `N`。如果 Simcenter STAR-CCM+通过`-rr -rrthreads N` 启动，则（批处理）客户端使用远程渲染，并且启动的服务器使用 `N` 个线程进行远程渲染 `-arthreads` 是特别渲染的等效参数。请参见远程渲染的其他信息。

并行选项


参数	描述
`-benchmark`	评估硬件的性能。要了解有关选项的详细信息，使用`-benchmarkhelp`。有关基准的更多信息，请参见性能基准。
`-machinefile <file>`	MPI 机器资源的`文件`名。每个主机名必须单独显示一行，并且可以附加一个冒号和主机上的进程数。以井号开头的行被解释为注释。主机负载以循环方式分配，直至满足来自 `-np` 的请求的进程计数。然后，进程将这些负载分配给主机，并填充主机的所有 CPU/内核，然后再分配给下一个主机。表示并行执行。不能与 `-on` 或 `-batchsystem` 一起使用。
`-mpi <driver>` `-mpidriver <driver>`	指定用于进程之间通信的 MPI 驱动程序。Linux 上的默认 MPI 驱动程序为 Open MPI，Windows 上为 MS MPI。请参见支持的 MPI 实现参数以获取详细信息。
`-mpiflags <options>`	MPI 驱动程序专家选项。
`-mpitest [:<options>]`	执行 MPI 测试并退出。
`-np <np>`	要使用的进程数。表示并行执行。如果省略 `-np` 选项而指定 `-machinefile`、`-on` 或 `-batchsystem`，则假定进程数是资源列表中规定的数量。
`-np <np[,npcosim]>`	用于协同仿真的处理器数，其中 `np` 是 Simcenter STAR-CCM+的进程数，`npcosim` 是其他工具的进程数。
`-on <host[:np][,host[:np]]>`	MPI 资源列表。流程分布遵循与 `-machinefile` 相同的逻辑。表示并行执行。不能与 `-machinefile` 或 `-batchsystem` 一起使用。
`-pio`	在 RAID-5 文件系统上激活并行输入/输出。包含此标志时，使用并行 I/O 恢复给定的模拟文件，且使用并行 I/O 保存所有后续的模拟文件。
`-cpubind <policy>`	指定当绑定 CPU 时要使用的绑定策略，即 `off`、`bandwidth` 或 `latency`。可以通过输入以下内容，请求报告显示绑定布局：`-cpubind v` 有关详细信息，请参见 CPU 绑定。
`-processdistribution <policy>`	在订阅不足的多节点运行中指定进程分布过程。可用选项如下： `紧凑型` - 进程先填充整个节点，然后再移至下一个节点。此模式减少了节点间通信，但每个进程的内存减少。这是仅 CPU 执行中的默认选项。 `分布型` – 进程在所有计算节点中以循环方式分布，以便尽可能平均分布。此模式增加了节点间通信，但也增加了每个进程的可用内存。这是启用 GPGPU 的执行的默认选项。 `gpgpuaware` – 进程分布在一个节点上，直到达到可用 GPGPU 的数量，然后才使用下一个节点。如果请求的 `-np` 数大于 `#nodes x #GPGPUs`，则重复分布，直到分布完所有进程。期望所有节点的硬件均质或显式指定资源，即 `-gpgpu file:file.txt` 与 `-batchsystem` / `-on` / `-machinefile`。在完全订阅的运行中，所有三个选项都会生成相同的进程分布。

GPGPU 选项


参数	描述
`-gpgpu auto[:N][:oversubscribe]`	从机器上的可用 GPGPU 卡中自动选择 GPGPU 卡。`[:N]` 是可选计数。例如： `-gpgpu auto` - 使用所有适用的 GPGPU。在多个主机上运行时，进程会在所有主机上均匀分布，以提高 GPGPU 利用率。 `-gpgpu auto:4` - 自动选择 4 个 GPGPU `-gpgpu auto:oversubscribe` - 在多个主机上运行时，进程会根据 `-machinefile <file>` 中描述的默认放置分布。此选项在 Windows 上不可用。 `-gpgpu auto` 不考虑使用 GPGPU 的其他进程（包括其他 Simcenter STAR-CCM+ 进程）。如果不将所有 GPGPU 仅用于单个作业，则考虑显式指定要使用的 GPGPU。`-gpgpu` 的其他方法允许显式选择。在 NVIDIA DGX 系统上，不得选择 DGX 显示 GPU。
`-gpgpu n[,n]+`	指定要使用的 GPGPU 的索引。例如，`-gpgpu 0,1` - 使用索引为 0 和 1 的 GPGPU。在 NVIDIA GPU 上，GPGPU 索引应等于 `nvidia-smi` 工具所报告的相应 CUDA 索引。
`-gpgpu force:n[,n]+`	指定要使用的 GPGPU 的索引，但不进行验证。例如，`-gpgpu force:2,4` 强制使用索引为 2 和 4 的 GPGPU，无需进行验证。
`-gpgpu file:file.txt`	提供指定文件中的 GPGPU 选择。此选项在 Windows 上不可用。此选项允许最精细的 GPGPU 选择，当必须在不同的主机上进行不同的选择时非常有用。文件中必须每个相关主机一行。每行包含 hostname 命令报告的主机名，后跟一个空格和适用于该主机的 -gpgpu 参数。例如： `host1 auto:2` `host2 1,2,5` `host3 force:0`
`-gpgpu <usage options>:nomps`	按照上述选项的指定来应用 `<usage options>`，但即使需要 MPS，也不启动 MPS。例如，`-gpgpu auto:4:nomps` 在机器上选择 4 个卡，但不启动 MPS。此选项对 AMD GPU 无效，在 Windows Server 中使用时对 NVIDIA GPU 也无效。
`-require-gpgpu-compatibility`	要求 GPGPU 兼容。当非 GPGPU 兼容求解器处于活动状态时，这会导致在求解器执行时发出输入错误，而不是回退到 CPU 上运行。在批量执行中，这将有效地停止作业。

某些 GPGPU 显卡由多个逻辑 GPGPU 组成。这包括 NVIDIA A16（4 个逻辑 GPGPU）和 AMD Instinct MI250/MI250X（2 个逻辑 GPGPU）。出于 -gpgpu 选项的用途，每个逻辑 GPGPU 都被视为独立的 GPGPU 卡。