Macro API Changes 10.02

In Simcenter STAR-CCM+ 10.02, the macro API changed for multiphase segregated flow, meshing, and combustion.

Multiphase Segregated Flow: Changes to the Explicit URF for the Volume Fraction and for S-Gamma

For macros that work with the explicit under-relaxation factor either for Volume Fraction or for S-Gamma, the macro code has changed. The method setExplicitRelaxationFactor() has been shortened to setExplicitUrf().

Previous Release Simcenter STAR-CCM+ v10.02 
volumeFractionSolver_0.setExplicitRelaxationFactor(0.3);
 
volumeFractionSolver_0.setExplicitUrf(0.3);

Multiphase Segregated Flow: Changes to Drag Specification in Eulerian Multiphase Modeling

The macro code for Drag Correction specification has changed.

Previous Release Simcenter STAR-CCM+ v10.02 
((DragCoefficientCorrectionMethodManager) eulerianDragForceModel_0.getCcInteractionCoefficient()).setMethod(VolumeFractionExponentMethod.class);
 
((DragCoefficientCorrectionMethodManager) eulerianDragForceModel_0.getCoefficientCorrectionMethods()).setMethod(VolumeFractionExponentMethod.class);

Macros that used Linearized specification for drag now use a new method. The drag methods that were available under linearized specification were: Gidaspow, Syamlal, Arastoopour, Symmetric, Suspension, and Emulsion.

Gidaspow
Previous Release Simcenter STAR-CCM+ v10.02 
eulerianDragForceModel_0.getCoefficientOption().setSelected(DragForceCoefficientOption.LINEARIZED);
((LinearizedDragCoefficientMethodManager) eulerianDragForceModel_0.getInteractionCoefficient()).setMethod(GidaspowDragCoefficientMethod.class);
 
((EulerianDragCoefficientMethodManager) eulerianDragForceModel_0.getInteractionCoefficient()).setMethod(GidaspowDragCoefficientMethod.class);
Syamlal
Previous Release Simcenter STAR-CCM+ v10.02 
eulerianDragForceModel_0.getCoefficientOption().setSelected(DragForceCoefficientOption.LINEARIZED);
(((LinearizedDragCoefficientMethodManager) eulerianDragForceModel_0.getInteractionCoefficient()).setMethod(SyamlalOBrienDragCoefficientMethod.class);
 
((EulerianDragCoefficientMethodManager) eulerianDragForceModel_0.getInteractionCoefficient()).setMethod(SyamlalOBrienDragCoefficientMethod.class);
Arastoopour
Previous Release Simcenter STAR-CCM+ v10.02 
eulerianDragForceModel_0.getCoefficientOption().setSelected(DragForceCoefficientOption.LINEARIZED);
((LinearizedDragCoefficientMethodManager) eulerianDragForceModel_0.getInteractionCoefficient()).setMethod(ArastoopourDragCoefficientMethod.class);
 
((EulerianDragCoefficientMethodManager) eulerianDragForceModel_0.getInteractionCoefficient()).setMethod(ArastoopourDragCoefficientMethod.class);
Symmetric
Previous Release Simcenter STAR-CCM+ v10.02 
eulerianDragForceModel_0.getCoefficientOption().setSelected(DragForceCoefficientOption.LINEARIZED);
((LinearizedDragCoefficientMethodManager) eulerianDragForceModel_0.getInteractionCoefficient()).setMethod(SymmetricDragCoefficientMethod.class);
 
((EulerianDragCoefficientMethodManager) eulerianDragForceModel_0.getInteractionCoefficient()).setMethod(SymmetricDragCoefficientMethod.class);
Suspension
Previous Release Simcenter STAR-CCM+ v10.02 
eulerianDragForceModel_0.getCoefficientOption().setSelected(DragForceCoefficientOption.LINEARIZED);
((LinearizedDragCoefficientMethodManager) eulerianDragForceModel_0.getInteractionCoefficient()).setMethod(SuspensionDragCoefficientMethod.class);
 
((EulerianDragCoefficientMethodManager) eulerianDragForceModel_0.getInteractionCoefficient()).setMethod(SuspensionDragCoefficientMethod.class);
Emulsion
Previous Release Simcenter STAR-CCM+ v10.02 
eulerianDragForceModel_0.getCoefficientOption().setSelected(DragForceCoefficientOption.LINEARIZED);
((LinearizedDragCoefficientMethodManager) eulerianDragForceModel_0.getInteractionCoefficient()).setMethod(EmulsionInversionDragCoefficientMethod.class);
 
((EulerianDragCoefficientMethodManager) eulerianDragForceModel_0.getInteractionCoefficient()).setMethod(EmulsionInversionDragCoefficientMethod.class);

Multiphase Segregated Flow: Changes to the Virtual Mass Coefficient

The Virtual Mass Coefficient model needs to be activated under relevant phase interactions for simulations that use any of the following:

  • Virtual Mass Force
  • Turbulent Dispersion Force
  • Tchen Particle Induced Turbulence
  • Tchen Turbulent Response (in the dispersed phase of the interaction)
Previous Release Simcenter STAR-CCM+ v10.02 
phaseInteraction_0.enable(TurbulentDispersionForceModel.class);
 
phaseInteraction_0.enable(TurbulentDispersionForceModel.class);
phaseInteraction_0.enable(VirtualMassCoefficientModel.class);

If a non-default virtual mass coefficient was previously defined under the Virtual Mass Force model, then this specification should now be applied to the Virtual Mass Coefficient model.

Previous Release Simcenter STAR-CCM+ v10.02 
VirtualMassForceModel virtualMassForceModel_0 = 
  phaseInteraction_0.getModelManager().getModel(VirtualMassForceModel.class);
virtualMassForceModel_0.getVirtualMassCoefficient().setMethod(ConstantInteractionCoefficientMethod.class);
 
VirtualMassCoefficientModel virtualMassCoefficientModel_0 = 
  phaseInteraction_0.getModelManager().getModel(VirtualMassCoefficientModel.class);
virtualMassCoefficientModel_0.getVirtualMassCoefficient().setMethod(ConstantInteractionCoefficientMethod.class);

Meshing: Changes to Part Surface Contact Location

The way in which Simcenter STAR-CCM+ handles part surface contacts has changed. Modify your existing macros accordingly.

Previous Release Simcenter STAR-CCM+ v10.02 
import star.meshing.PartSurfaceContact;
import star.meshing.PartSurfaceContactManager;
 
import star.common.PartSurfaceContact;
import star.common.PartSurfaceContactManager;

Combustion: Changes to Multiple Site Mixtures for One Surface Reaction Mechanism

A surface reaction mechanism can use detailed surface reactions with multiple sites and site species. This added capability results in new macro code.

Previous Release Simcenter STAR-CCM+ v10.02 
BulkSurfaceFractionProfile bulkSurfaceFractionProfile_0 =
boundary_0.getValues().get(BulkSurfaceFractionProfile.class);

SiteSurfaceFractionProfile siteSurfaceFractionProfile_0 =
boundary_0.getValues().get(SiteSurfaceFractionProfile.class);
 
BulkSurfaceFractionProfileManager bulkSurfaceFractionProfileManager_0 =
boundary_0.getValues().get(BulkSurfaceFractionProfileManager.class);
BulkSurfaceFractionProfile bulkSurfaceFractionProfile_0 =
bulkSurfaceFractionProfileManager_0.getProfile(0);
SiteSurfaceFractionProfileManager siteSurfaceFractionProfileManager_0 =
boundary_0.getValues().get(SiteSurfaceFractionProfileManager.class);
SiteSurfaceFractionProfile siteSurfaceFractionProfile_0 =
siteSurfaceFractionProfileManager_0.getProfile(0);

Combustion: Changes to Zone Manager for Reacting Channel

Reacting channel zones are boundaries in the CFD region where data is transferred between the Plug Flow Reactor (PFR) and Simcenter STAR-CCM+. The changes to the macros for reacting channels are extensive, so you are advised to re-record them.