使用 Linux 编译和启动合作伙伴代码

在 Linux 中，可以使用 Simcenter STAR-CCM+ 安装中提供的 buildapi 和 starapi 辅助脚本编译和启动球阀模拟。要编译样本代码，需要 g++ 4.3.4 版或更高版本。

从将合作伙伴代码复制到工作目录开始：
  1. 导航至已下载教程文件的 couplingWithCaeCodes 文件夹。
  2. 将整个 CoSimAPI_Code 文件夹复制到工作目录。
    此文件夹包含的文件构成了求解球阀运动的合作伙伴程序。
要编译样本代码：
  1. 打开终端。
  2. 导航至 CoSimAPI_Code 文件夹： 
    % cd [PATH]/CoSimAPI_Code
    此处，[PATH] 是工作目录的路径。
  3. 输入以下命令： 
    % [INSTALLDIR]/star/bin/buildapi spindleValve_solid
    此处，[INSTALLDIR] 是 Simcenter STAR-CCM+ 安装目录的路径。

    此命令编译 CoSimAPI_Code 文件夹内的所有 .cpp 文件，并且创建模拟球阀运动的可执行输出文件 spindleValve_solid。

    starapi 辅助脚本启动合作伙伴代码，并允许合作伙伴代码加载协同仿真 API 库并生成合作伙伴模拟。

    您可以通过终端或 Simcenter STAR-CCM+ 流体模拟运行脚本。在本 Linux 教程中，将从终端运行脚本。此方法需要两个 Simcenter STAR-CCM+ 许可证，即一个 Simcenter STAR-CCM+ 流体模拟许可证和一个合作伙伴模拟许可证。但是，如果您不希望监视球阀模拟输出，则可以使用第二个方法共享单个 Simcenter STAR-CCM+ 许可证。有关更多信息，请参见在合作伙伴程序和 Simcenter STAR-CCM+ 之间运行协同仿真。

要启动合作方程序：
  1. 导航至工作目录： 
    % cd [PATH]/[WORKDIR_NAME]

    此处，[PATH] 是工作目录的路径，而 [WORKDIR_NAME] 是工作目录的名称。

  2. 输入以下命令，指定 spindleValve_solid 可执行文件以及您在此教程上述章节创建的输入网格文件的相对路径： 
    % [INSTALLDIR]/star/bin/starapi [FILEPATH]/spindleValve_solid [FILEPATH]/spindleball.stl

    此处，[INSTALLDIR] 是 Simcenter STAR-CCM+ 安装目录的路径。

    例如，如果您按此教程说明保存所有文件，则带有文件路径的命令是：
    % [INSTALLDIR]/star/bin/starapi CoSimAPI_Code/spindleValve_solid CoSimAPI_Mesh/spindleball.stl
    有关启动流程的信息显示在终端上。

    消息 spindleValve_solid: Simcenter STAR-CCM+ 正在等待合作伙伴连接... 告知您 Simcenter STAR-CCM+ API 服务器已启动，并且合作伙伴节点 spindleValve_solid 已就绪，可导入 Simcenter STAR-CCM+ spindleValve_fluid 模拟的场。

    注使终端保持打开。关闭终端会终止合作方程序进程。