宏 API 更改 2306
在 Simcenter STAR-CCM+ 2306 中,用于 3D-CAD、材料属性、传热、反应流、固体应力、欧拉多相、电磁、后处理和 Simcenter STAR-CCM+ In-cylinder 的宏 API 已更改。
3D-CAD:与 Parasolid 自动匹配相关的更改
布尔和压印特征已改进,可用于激活 Parasolid 的自动匹配功能。这些改进已导致宏代码发生更改。
这些更改保证了使用以下内容的连续性:
- 3D-CAD 特征
UniteBodiesFeature
和IntersectBodiesFeature
以前未使用 Parasolid 的自动匹配功能,在 Simcenter STAR-CCM+ 2306 中,可以选择不对它们使用 Parasolid 的自动匹配功能。 - 3D-CAD
SubtractBodiesFeature
、Imprint
和ImprintFaces
特征以前使用 Parasolid 的自动匹配选项,此增强功能继续保持了该功能。
在 Simcenter STAR-CCM+ 2306 中,默认为新创建的属于上述五种特征类型中任一种的实例激活使用 Parasolid 的自动匹配选项。对于组合体和相交体特征,这与上一个版本不同。star.cadmodeler
包的 FeatureManager
类的以下公共成员函数已弃用:
UniteBodiesFeature createUniteBodies(List<Body> bodies);
UniteBodiesFeature createUniteBodies();
IntersectBodiesFeature createIntersectBodies(List<Body> bodies);
IntersectBodiesFeature createIntersectBodies();
这些函数已被相同类的以下公共成员函数抑制:
UniteBodiesFeature createUniteBodies2(List<Body> bodies);
UniteBodiesFeature createUniteBodies2();
IntersectBodiesFeature createIntersectBodies2(List<Body> bodies);
IntersectBodiesFeature createIntersectBodies2();
以下新的公共成员函数对已添加到 UniteBodiesFeature
、SubtractBodiesFeature
、IntersectBodiesFeature
、Imprint
和 ImprintFaces
特征类中。
void setUseAutoMatch(boolean mode);
boolean isUseAutoMatch();
上述第一个函数用于指定特征类的实例是否应使用 Parasolid 的自动匹配选项。上述第二个函数用于查询特征类的实例当前是否配置为使用 Parasolid 的自动匹配选项。
以下示例演示了如何创建和配置 UniteBodiesFeature
,使其不使用 Parasolid 的自动匹配选项。
CadModel cadModel =
getActiveSimulation().get(SolidModelManager.class).createSolidModel();
UniteBodiesFeature uniteBodiesFeature =
cadModel.getFeatureManager().createUniteBodies2();
uniteBodiesFeature.setUseAutoMatch(false);
材料属性:弃用各向异性材料属性指定方法
材料属性指定方法各向异性和各向异性(原有)从 2210 版本开始已弃用,并计划从以后的版本中移除。有关这些方法和计划替换的详细信息,请参见 2306 发行说明“重要说明”章节中的“材料属性”。
如果任何现有宏使用已弃用的材料属性法(导热率、导电率、渗透率、介电常数的 9 个各向异性分量,或是导热率的各向异性(原有)),则搜索以下字符串的实例并更新它们,如下表中所示。
以前版本 | Simcenter STAR-CCM+ 2306 |
---|---|
AnisotropicElectricalConductivityMethodWithValues |
FullTensorElectricalConductivityMethodWithValues |
AnisotropicPermeabilityMethodWithValues |
FullTensorPermeabilityMethodWithValues |
AnisotropicPermittivityMethodWithValues |
FullTensorPermittivityMethodWithValues |
AnisotropicThermalConductivityMethodWithValues |
FullTensorThermalConductivityMethodWithValues |
AnisotropicThermalConductivityMethod |
FullTensorLegacyThermalConductivityMethod |
热传递:固体能量建模的物理连续体合并
在 Simcenter STAR-CCM+ 2306 中,可以使用单个物理连续体对 3D 和壳区域中的固体能量建模。对 3D 区域和壳区域使用单独物理连续体的旧模拟文件仍可继续工作。
对于在 Simcenter STAR-CCM+ 2306 和更高版本中创建的模拟文件,建议使用单个物理连续体对 3D 和壳区域中的固体能量建模。对于域包含壳拓扑区域的连续体(对于液膜或固体壳建模),选择三维空间模型。三维壳体空间模型不再可供选择。
由于这种工作流程改进,在 Simcenter STAR-CCM+ 2306 之前版本中创建的任何宏都需要更新。搜索受影响字符串的实例并更新它们,如下表所示。
以前版本 | Simcenter STAR-CCM+ 2306 |
---|---|
|
|
|
|
|
|
反应流体:小火焰求解器的更改
由于小火焰求解器的重构,宏代码发生更改。
场函数 ScaledProgressVariable
的名称已更改为 UnnormalizedProgressVariable
。激活小火焰生成流形 (FGM) 模型时,将创建此场函数。
以前版本 | Simcenter STAR-CCM+ 2306 |
---|---|
|
|
场函数 FuelMassFraction
的名称已更改为 UnnormalizedProgressVariable
。此场函数与以下任何模型配对一起创建:拟序火焰模型 (CFM) 或湍流火焰速度封闭 (TFC),与化学平衡 (CE) 或稳态层流小火焰 (SLF) 组合。
以前版本 | Simcenter STAR-CCM+ 2306 |
---|---|
|
|
在Simcenter STAR-CCM+ 2306 中,当 FGM 与拟序火焰模型 (CFM) 或湍流火焰速度封闭 (TFC) 一起激活时,CFM 燃烧和 TFC 燃烧求解器不会出现在 UI 中。现在,在 FGM 燃烧求解器下激活单独的 URF 数后,可以在 FGM 燃烧求解器下为 CFM 燃烧或 TFC 燃烧求解器设置亚松弛因子。此重构还导致宏代码更改。
以前版本 | Simcenter STAR-CCM+ 2306 |
---|---|
|
|
|
|
固体应力
超弹性材料输入表的更改
由于 star.solidstress
包中的重构,宏代码发生更改。按下表中所示更新宏。
以前版本 | Simcenter STAR-CCM+ 2306 |
---|---|
|
|
|
|
|
|
附加质量的更改
为了帮助改进流体结构相互作用模拟的处理,star.solidstress
、star.partitionedcoupling
和 star.partitionedcoupling2
类已移至名为 star.stabilization
的新包中。
以前版本 | Simcenter STAR-CCM+ 2306 |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
已经移除 |
|
已经移除 |
接触交界面的更改
Simcenter STAR-CCM+ 中基于交界面的接触已重构,从而导致宏代码发生更改。修改了固态区域之间交界面上的两个选项的枚举值。
对于用于设置约束映射的 SolidSolidConstraintOption
,枚举值已重命名,如下所示:
SolidSolidConstraintOption | 旧值 | 新值 |
---|---|---|
节点至表面 | Node_Surface |
NODE_TO_SURFACE |
表面至表面 | Surface_Surface |
SURFACE_TO_SURFACE |
以下示例演示如何在名为 "Solid 1/Solid 2"
的交界面上设置 SolidSolidConstraintOption
:
以前版本 | Simcenter STAR-CCM+ 2306 |
---|---|
|
|
对于用于在交界面上设置机械相互作用类型的 SolidSolidContactOption
,名为 WELDED
的枚举值已重命名为 BONDED
。
以下示例演示如何在名为 "Solid 1/Solid 2"
的交界面上将 SolidSolidConstraintOption
设为 BONDED
:
以前版本 | Simcenter STAR-CCM+ 2306 |
---|---|
|
|
欧拉 (EMP):AMUSIG 报告的更改
因为重构,以下类已从 multiphase
移至 emp
:
以前版本 | Simcenter STAR-CCM+ 2306 |
---|---|
|
|
|
|
|
|
|
|
|
|
电磁:涡流抑制选项的更改
由于重构,涡流抑制选项(包括宏代码)发生更改。
以前版本 | Simcenter STAR-CCM+ 2306 |
---|---|
|
|
后处理:计划从 Java Framework 中移除 ChartStyle 类 (2402)
计划在版本 2402 中从绘图框架中移除 ChartStyle
类。
以下类结构不再受支持,它们可能存在于导入 .plt
文件的较旧 Java 宏中:
star.common.graph.ChartStyle
star.common.graph.ChartStyleManager
该类的早期使用示例在 exampleXYPlot
上显示数据集,其 ChartStyle
正在更新:
DataSet dataSet = exampleXYPlot.getYAxes().getAxisType("Y Type 1").getDataSets().getDataSet("Temperature");
dataSet.getChartStyle().setSymbolShape(JCSymbolStyle.NONE);
dataSet.getChartStyle().setLinePattern(JCLineStyle.SOLID);
dataSet.getChartStyle().setLineColor(Color.red);
dataSet.getChartStyle().setLineWidth(4);
近年来,Style
已在其自己的子对象中进行管理,ChartStyle
已变得不必要。
对于版本 2402,需要进行两项更改:
- 如果适用,直接更新
Style
,而不是通过ChartStyle
路由请求。 - 如果无法直接更改,则完全移除调用。
特定 Style
-to-Type
替换:
- 将
JCSymbolStyle
替换为SymbolShapeOption.Type
。 - 将
JCLineStyle
替换为LinePatternOption.Type
。 - 将
JCFillStyle
替换为FillPatternOption.Type
。
更新代码的详细说明,含示例
应根据需要更新以下与线样式相关的调用:
ChartStyle.setLinePattern
ChartStyle.setLineColor
ChartStyle.setLineWidth
对线样式 API 调用的更新的示例:
// At the top of the macro
import star.common.LinePatternOption;
import star.common.LineStyle;
DataSet dataSet = exampleXYPlot.getYAxes().getAxisType("Y Type 1").getDataSets().getDataSet("Temperature");
// Step 1: Replace getChartStyle() calls with their direct 'set' calls.
// dataSet.getChartStyle().setLinePattern(JCLineStyle.SOLID);
dataSet.getLineStyle().setLinePatternOptionInput(LinePatternOption.Type.SOLID); // (Step 2) replacement for JCLineStyle.SOLID
// dataSet.getChartStyle().setLineColor(Color.red);
dataSet.getLineStyle().setColor(Color.red);
// dataSet.getChartStyle().setLineWidth(4);
dataSet.getLineStyle().setLineWidth(4);
应根据需要更新以下与标记样式相关的调用:
ChartStyle.setSymbolShape
ChartStyle.setSymbolSize
ChartStyle.setSymbolStrokeWidth
ChartStyle.setSymbolColor
对标记样式 API 调用的更新的示例:
// At the top of the macro
import star.common.SymbolShapeOption;
import star.common.SymbolStyle;
DataSet dataSet = exampleXYPlot.getYAxes().getAxisType("Y Type 1").getDataSets().getDataSet("Temperature");
// Step 1: Replace getChartStyle() calls with their direct 'set' calls. Calls
// dataSet.getChartStyle().setSymbolShape(JCSymbolStyle.NONE);
dataSet.getSymbolStyle().setSymbolShapeOptionInput(SymbolShapeOption.Type.NONE); // (Step 2) replacement for JCSymbolStyle.NONE
// dataSet.getChartStyle().setSymbolSize(10);
dataSet.getSymbolStyle().setSize(10);
// dataSet.getChartStyle().setSymbolStrokeWidth(0.2);
dataSet.getSymbolStyle().setStrokeWidth(0.2);
// dataSet.getChartStyle().setSymbolColor(Color.red);
dataSet.getSymbolStyle().setColor(Color.red);
应根据需要更新以下与填充风格相关的调用:
ChartStyle.setFillPattern
ChartStyle.setFillColor
ChartStyle.setFillBackground
对填充风格 API 调用的更新的示例:
// At the top of the macro
import star.common.FillPatternOption;
import star.common.FillStyle;
DataSet dataSet = exampleXYPlot.getYAxes().getAxisType("Y Type 1").getDataSets().getDataSet("Temperature");
// Step 1: Replace getChartStyle() calls with their direct 'set' calls.
// dataSet.getChartStyle().setFillPattern(JCFillStyle.SOLID);
dataSet.getFillStyle().setLinePatternOptionInput(FillPatternOption.Type.SOLID); // (Step 2) replacement for JCFillStyle.SOLID
// dataSet.getChartStyle().setFillColor(Color.red);
dataSet.getFillStyle().setColor(Color.red);
// dataSet.getChartStyle().setFillBackground(Color.blue);
dataSet.getFillStyle().setBackgroundColor(Color.blue);
应完全移除以下 API 调用。他们的处理已中止/内部化。
ChartStyle.setLineCap
ChartStyle.setLineJoin
对线样式 API 调用的移除的示例:
DataSet dataSet = exampleXYPlot.getYAxes().getAxisType("Y Type 1").getDataSets().getDataSet("Temperature");
dataSet.getChartStyle().setLineCap(0);
dataSet.getChartStyle().setLineJoin(0);
旧标记、线样式和填充风格已替换为当前支持的类型
标记样式:import star.common.SymbolShapeOption;
以前版本 | Simcenter STAR-CCM+ 2306 |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
线样式:import star.common.LinePatternOption;
以前版本 | Simcenter STAR-CCM+ 2306 |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
填充风格:import star.common.FillPatternOption;
以前版本 | Simcenter STAR-CCM+ 2306 |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
样式 API 移除和替换
线样式
移除以下内容:
LineStyle.setVisible(boolean)
LineStyle.getJoin()
LineStyle.setJoin(int)
LineStyle.getCap()
LineStyle.setCap(int)
如下替换代码:
以前版本 | Simcenter STAR-CCM+ 2306 |
---|---|
|
|
|
|
符号样式
Remove SymbolStyle.setVisible(boolean)
。
如下替换代码:
以前版本 | Simcenter STAR-CCM+ 2306 |
---|---|
|
|
|
|
填充样式
Remove FillStyle.setVisible(boolean)
。
以前版本 | Simcenter STAR-CCM+ 2306 |
---|---|
|
|
|
|
Simcenter STAR-CCM+ In-cylinder:网格基础尺寸参数现在可用于冷流模拟
现在,启动 Simcenter STAR-CCM+
In-cylinder 时,将创建 ${Mesh Base Size}
参数,从而导致宏代码发生更改。以下示例涉及基础尺寸设置 2(喷射模型未激活时)。
以前版本 | Simcenter STAR-CCM+ 2306 |
---|---|
|
|