Macro Files Reference

A macro is a Java program that is compiled and executed within the Design Manager workspace. Macro files are Java language files that can be recorded as a journal of your interaction with the application.

The File > Macro menu in Design Manager contains the same options for recording and running macros as the corresponding menu in Simcenter STAR-CCM+. For a full description of the available options, see Scripting the Application.

Simcenter STAR-CCM+ simulations and Design Manager projects have separate Recent Macro lists. Macros that are played when a Design Manager project is active are added to the Design Manager Recent Macro list, and macros that are played when a simulation is active are added to the Simcenter STAR-CCM+ simulation Recent Macro list.

The following properties and right-click actions are available for macros in Design Manager.

Macro File Properties

Object Properties
Macro Files None.
[macro]
Macro Insertion Point
Identifies the stage in the workflow of a design simulation where Design Manager performs the custom steps that are defined in the macro.
  • Before Update Model—if you want to perform the actions before executing the geometrical changes of the model.
  • Before Meshing—if you want to perform the actions before executing the meshing pipeline.
  • Before Running—if you want to perform the actions before running the solver.
  • Before Results—if you want to perform the actions after the Simcenter STAR-CCM+ solver completes, and before any results are returned to Design Manager.
Macro File

Specifies the path to the macro file (*.java). By default, Design Manager uses the relative path to the project root directory.

Tags
Specifies the tags for the macros. For more information, see Tagging Simulation Objects.

Macro Right-Click Actions

Object Right-Click Actions
Macro Files
New
Adds a new macro to the workflow of a design simulation.

In the Open dialog, you select the appropriate macro file (*.java) and set the macro insertion point (see Macro File Properties, above). The file must exist already: this option does not allow you to create a new macro file.

You can record macro files using the File > Macro menu or create macro files manually in a text editor.

[macro]
Set New Tag...
Creates a new tag and adds it to the selected macro. For more information, see Tagging Simulation Objects.
Set Tags > [tag]
Allows you to set a new tag or a previously created tag to the selected macro.