Home

Welcome to the MacroUtils wiki!

Thank you for using MacroUtils. I hope this library will help you as has been helping me over the years with macros in STAR-CCM+.

Motivation

1. STAR-CCM+ User Interface (UI) registers low-level API instructions when one is recording macros interactively;
2. When I was working in projects that required automation, soon I had realized the need in sharing common methods without copying/pasting JAVA methods every time I needed to leverage something that was already written.

Brief History

1. MacroUtils was originally written using STAR-CCM+ v7.02 libraries;
2. Everything was coded in a single JAVA file and macros that were supposed to play in STAR-CCM+ were always extending the Public Class of MacroUtils;
3. The MacroUtils initiative grew a lot of over the years and releases. At some point, in STAR-CCM+ v10.04 series, I have decided to refactor MacroUtils because it was not possible to use this library when writing Simulation Assistants;
4. From STAR-CCM+ v11.02 onwards, MacroUtils is able to be used as a general library, eliminating the limitation aforementioned;
5. The very single and heavy JAVA file with ~16,500 lines was refactored from the scratch and split into several different files. Therefore, building a JAR file from the source code is extremely recommended when applying it on a real project;
6. Starting from STAR-CCM+ v14.06, or Simcenter STAR-CCM+ 2019.3, MacroUtils added support for gradle compilations.

More Information

1. Click here for the Frequently Asked Questions.
2. Want to code your Simulation Assistant using MacroUtils APIs? Click here to find more.
3. Check what are the current coding conventions used in MacroUtils here.