文件格式参考

本节详细介绍了表保存到磁盘时的文件格式以及可从中读取表的文件格式。

以下原则适用于使用采用任一内部表格式的变量：

  • 可在文件中使用所需的任何变量名作为标题行，然后将其分配给边界条件中的标量值。 请参见使用表设置值。
  • 文件可以包含任意数量的变量，且可以使用或不使用这些变量。
  • 但是，xyz 文件必须包含场 X、Y 和（如果为三维）Z，而径向文件需要场 R。
  • 变量名可包含单位指定。 单位在一组括号 () 内指定为变量名的一部分：

    "Volume (in^3)"、"Density (lb/ft^3)"

    导入的单位将根据在单位节点中指定的首选系统属性转换为尺寸的首选单位。 请参见使用单位。

    如果单位管理器无法识别所提供的单位，则输出窗口将显示无法进行单位转换。

  • 导入的表中的数据布局可能影响 Simcenter STAR-CCM+ 性能。 有关详细信息，请参见笛卡尔表和结构化表。
注要正确导入 Simcenter STAR-CCM+，包含特殊字符（包括重音字符）的输入文件需要采用 UTF-8 编码而非 ANSI。

Xyz 内部表

二维 xyz 内部表文件的示例如下所示，各个列分别对应 'X' 和 'Y' 以及场函数 'U' 和 'SaNut'。

文件格式有如下关键方面：

  • 使用的特定括号
  • 使用引号来标识文本字符串
  • 包括 'Type'、'xyz' 和 'DataSets' 的文字标识符。
括号内的列数据采用自由格式，并使用分隔符分隔各个数值。 每列数据具有的单元数必须相同。 必须存在使用 'X' 和 'Y'（在三维空间中，还有 'Z'）标识的数据列。
{’Type’: ’xyz’
’DataSets’: [ ’X’  ’Y’  ’U’  ’SaNut’]
’X’:
[-4 -4 -4 -4 -4 -4 -4 -4 -4 -4 -4]
’Y’:
[1.0 1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 2.0]
’U’:
[0.04 0.123 0.209 0.291 0.359 0.409 0.445 0.471 0.491 0.509 0.523]
’SaNut’:
[1.14e-05 3.51e-05 6.078e-05 8.84e-05 0.00012 0.00015 0.00019 0.00022 0.00026 0.00030 0.00035] }

径向内部表

径向内部表文件的示例如下。

该文件的关键方面包括使用的特定括号、使用引号来标识文本字符串以及 'Type'、'radial' 和 'DataSets' 等文字标识符。 括号内的列数据采用自由格式，并且可使用任意分隔符来分隔各个数值。 每列数据具有的单元数必须相同。 必须有一列数据标识为 'R'。
{’Type’: ’radial’
’DataSets’: [ ’R’  ’axial-vel’]
’R’: [0 0.01 0.02 0.03 0.05 0.07 0.09 0.1 0.12 0.13 0.14 0.15]
’axial-vel’: [0.9700 0.9756 0.9697 0.9878 0.9955 1.0223
1.0404 1.0519 1.059543 1.065043 1.064233 1.071543] }

.csv 表文件

.csv（逗号分隔值）表文件的简化示例如下。

可使用逗号或空白区域分隔各个数值。 每列数据具有的单元数必须相同。 顶部标签为可选，但如果某个标签包含多个字符串，则必须使用引号，例如 'Laminar Flame Speed'。
Vol   Press
0.01  458.58
0.10  417.85
0.20  286.26
0.30  278.52
0.40  267.68
0.50  254.59
0.60  239.05
 ...   ...
2.20 -204.01

要使用 SAVU 命令从 pro-STAR 调用以 ASCII 格式编写的用户数据 (.usr) 文件，此格式是最佳方式。

.tab 表文件

.tab 表文件的示例如下。

每列数据具有的单元数必须相同。

文件格式有如下关键方面：

  • 使用的特定括号。
  • 使用引号来标识文本字符串。
  • 'DataSets'、'Modified Diffusivity' 和 'Velocity: X-Component' 等文本标识符。
    {’DataSets’: [’Modified Diffusivity’, ’Velocity: X-Component’, ’Velocity: Y-Component’, ’X’, ’Y’, ’Z’], 
’Modified Diffusivity’: [0.00050444749649614095688, 0.0015556754078716039658, ...], 
’Type’: ’xyz’,
’Velocity: X-Component’: [0.55402863025665283203, 0.68478977680206298828,...],
’Velocity: Y-Component’: [-7.3806604632409289479e-06, -3.4772736398736014962e-05, ...],
’X’: [-4.0000000000000000000, -4.0000000000000000000,...],
’Y’: [8.9650001525878906250, 8.8903274536132812500,...],
’Z’: [0.0000000000000000000, 0.0000000000000000000,...]}

虽然 .csv 是用于从 Simcenter STAR-CCM+ 导出表数据的标准格式，但是仍支持 .tab 作为用于读入模拟中的旧格式。

.xy 表文件

.xy 表文件的示例如下。

每列数据具有的单元数必须相同。 必须存在标识为 'X' 和 'Y'（在三维空间中，还有 'Z'）的数据列。
Y X Z U
0.0 0.0 0.0 0.00000
0.0005 0.0 0.0 0.11408
0.001 0.0 0.0 0.22230
0.002 0.0 0.0 0.42120
0.003 0.0 0.0 0.59670
0.004 0.0 0.0 0.74880
0.005 0.0 0.0 0.87750
 ...  ...  ...  ...
0.3 0.0 0.0 0.00000

虽然 .csv 是用于从 Simcenter STAR-CCM+ 导出表数据的标准格式，但是仍支持 .xy 作为用于读入模拟中的旧格式。