宏 API 更改 2402
在 Simcenter STAR-CCM+ 2402 中,针对 3D-CAD、运动、材料属性、热传递、辐射、欧拉多相流、电池建模、后处理和设计管理器更改了宏 API。
3D-CAD:用于保留原始面的新布尔合并选项
Simcenter STAR-CCM+ 2402 中添加了一个用于在布尔合并操作中保留原始面的选项。通过此新选项,可指定是否保留由合并体功能压印到任何输入体上的任何冗余边。在以前的发行版中,这些冗余压印边是通过合并体功能自动删除的。此项改进导致宏代码更改。
以下成员函数已添加到 UniteBodiesFeature 类,该类位于包 star.cadmodeler: void setKeepImprintedEdges(boolean mode); 中。
在 2402 版本中用创建默认合并体功能录制宏时,会向宏录制一个附加语句:uniteBodiesFeature_0.setKeepImprintedEdges(false);。
| 以前版本 | Simcenter STAR-CCM+ 2402 |
|---|---|
|
|
运动:旋转运动的更改
由于 Simcenter STAR-CCM+ 引入了新的旋转运动功能,因此旋转运动和叠加旋转运动的宏代码已更改。
设置旋转运动中的旋转速率
| 以前版本 | Simcenter STAR-CCM+ 2402 |
|---|---|
|
|
设置旋转运动中的旋转轴方向和原点
| 以前版本 | Simcenter STAR-CCM+ 2402 |
|---|---|
|
|
设置叠加旋转运动中的旋转轴方向和原点
| 以前版本 | Simcenter STAR-CCM+ 2402 |
|---|---|
|
|
设置旋转运动中的旋转角度
| 以前版本 | Simcenter STAR-CCM+ 2402 |
|---|---|
|
|
设置叠加旋转运动中的旋转角度
| 以前版本 | Simcenter STAR-CCM+ 2402 |
|---|---|
|
|
材料属性:弃用各向异性材料属性指定方法
材料属性指定方法各向异性和各向异性(原有)从 2210 版本开始已弃用,并计划从以后的版本中移除。有关这些方法和计划替换的详细信息,请参见 2402 发行说明“重要说明”章节中的“材料属性”。
如果任何现有宏使用已弃用的材料属性法(导热率、导电率、渗透率、介电常数的 9 个各向异性分量,或是导热率的各向异性(原有)),则搜索以下字符串的实例并更新它们,如下表中所示。
| 以前版本 | Simcenter STAR-CCM+ 2402 |
|---|---|
AnisotropicElectricalConductivityMethodWithValues |
FullTensorElectricalConductivityMethodWithValues |
AnisotropicPermeabilityMethodWithValues |
FullTensorPermeabilityMethodWithValues |
AnisotropicPermittivityMethodWithValues |
FullTensorPermittivityMethodWithValues |
AnisotropicThermalConductivityMethodWithValues |
FullTensorThermalConductivityMethodWithValues |
AnisotropicThermalConductivityMethod |
FullTensorLegacyThermalConductivityMethod |
辐射:光子蒙特卡洛建模的更改
由于引入了体积光子蒙特卡洛建模,光子蒙特卡洛求解器的宏代码已更改。
| 以前版本 | Simcenter STAR-CCM+ 2402 |
|---|---|
|
|
欧拉多相流 (EMP):颗粒引发湍流的更改
在 2402 版本中,欧拉多相混合物湍流现在与颗粒引发湍流兼容,导致宏代码发生更改。
| 以前版本 | Simcenter STAR-CCM+ 2402 |
|---|---|
|
|
|
|
|
|
|
|
电池建模:热失控的更改
由于在热失控建模中引入了 Q 表,相关宏代码已更改。
| 以前版本 | Simcenter STAR-CCM+ 2402 |
|---|---|
|
|
后处理:计划从 Java Framework 中移除 ChartStyle 类 (2406)
ChartStyle 类当前计划在版本 2406 中从绘图框架中移除,以进一步更改为准。
以下类结构不再受支持,它们可能存在于导入 .plt 文件的较旧 Java 宏中:
star.common.graph.ChartStylestar.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.setLinePatternChartStyle.setLineColorChartStyle.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.setSymbolShapeChartStyle.setSymbolSizeChartStyle.setSymbolStrokeWidthChartStyle.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.setFillPatternChartStyle.setFillColorChartStyle.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.setLineCapChartStyle.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+ 2402 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
线样式:import star.common.LinePatternOption;
| 以前版本 | Simcenter STAR-CCM+ 2402 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
填充风格:import star.common.FillPatternOption;
| 以前版本 | Simcenter STAR-CCM+ 2402 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
样式 API 移除和替换
线样式
移除以下内容:
LineStyle.setVisible(boolean)LineStyle.getJoin()LineStyle.setJoin(int)LineStyle.getCap()LineStyle.setCap(int)
如下替换代码:
| 以前版本 | Simcenter STAR-CCM+ 2402 |
|---|---|
|
|
|
|
标记样式
Remove SymbolStyle.setVisible(boolean)。
如下替换代码:
| 以前版本 | Simcenter STAR-CCM+ 2402 |
|---|---|
|
|
|
|
填充风格
Remove FillStyle.setVisible(boolean)。
| 以前版本 | Simcenter STAR-CCM+ 2402 |
|---|---|
|
|
|
|
设计管理器:输出表和默认视图的更改
在设计管理器中,输出表已重构,现在运行研究时仪表板是默认视图。这些修改导致宏代码发生更改。
输出表有一个新类,并且 openTableView 类现已弃用。
| 以前版本 | Simcenter STAR-CCM+ 2402 |
|---|---|
|
|
2402 版本中引入了设计管理器仪表板。运行研究时,将显示仪表板而不是输出表。仪表板也可以手动打开。
您可能想要打开仪表板而不是输出表。以下代码将打开仪表板:
MdxDesignStudy mdxDesignStudy_0 =
mdxProject_0.getDesignStudyManager().getDesignStudy("Test");
LayoutView layoutView_0 =
mdxDesignStudy_0.openStudyDashboard();
下表显示在先前发行版和 2402 版本中运行设计研究过程中录制的宏代码。
| 以前版本 | Simcenter STAR-CCM+ 2402 |
|---|---|
|
|