Running Locally

For small simulation sizes, a local machine with a high number of cores and memory can give sufficient compute resource for a design study.

To run design studies on your local machine:
  1. For each design study in your Design Manager project, set the run and resource settings:
    1. Select the Design Studies > [design study] > Settings > Run Settings node, where [design study] represents the name of the design study, and set the following properties:
      • Save Simulation Files: specifies the designs whose Simcenter STAR-CCM+ simulation files you want to save.
      • Save Log files: specifies whether to save log files to the design directories or not. This option is enabled by default.
      • Output Auxiliary File Types: specifies the extensions of simulation output files that you want to preserve for each design. Output files whose extensions you do not specify are deleted.
      • Simultaneous Jobs: sets the number of design simulations to run concurrently.
      • Compute Processes: sets the number of cores to run with each design simulation. When setting the numbers for Simultaneous Jobs and Compute Processes, check that you have enough cores available (simultaneous jobs * compute processes).
      • Design Reuse: activates the initialization of new designs using results from previous successful designs. Not available for all design study types.
      • Clear History: specifies whether to delete the computational history of all designs.

      For more information, see Run Settings Reference.

    2. Select the Compute Resource node and set the following properties:
      • Type: Direct
      • STAR-CCM+ Command Line Options: Set command line options to pass to the design simulations, such as License Options or other Simcenter STAR-CCM+ options. See Command-Line Reference.

        Example: -power (Power Session licensing).

      For more information, see Compute Resource Reference.
  2. You can run design studies on your workstation directly from the Graphical User Interface (GUI) or in batch mode from the command prompt:
    MethodProcedure
    Running directly from the GUI
    • To run a specific design study, right-click the design study node and select Run Study.
    • To run all design studies sequentially from first to last, right-click the Design Studies manager node and select Run All Studies.
    • To run multiple design studies, multi-select your preferred studies, right-click on one of them and select Run Study. This executes the selected studies sequentially in the order in which they were created in the Design Manager tree.

    The design simulations are submitted in the background. The output from the Design Manager server is displayed in the Output window. The Simcenter STAR-CCM+ servers for each running design simulation are visible in the Simcenter STAR-CCM+ server list.

    Running from a batch client

    For more information, see Running the Client in Batch.

    • If you want to run specific design studies:
      1. Save the following Java code to a macro file (*.java) and name it runSpecificStudies:
        // STAR-CCM+ macro: runSpecificStudies.java
        
        package macro;
        
        import java.util.*;
        import star.common.*;
        import star.mdx.*;
        
        public class runSpecificStudies extends MdxMacro {
        
          public void execute() {
        
            MdxProject mdxProject_0 = getActiveMdxProject();
        
            String[] designStudies = {"Design Study 1", "Design Study 2", "Design Study 3"};
        
            for (int i = 0; i < designStudies.length; i++){
        
                MdxDesignStudy mdxDesignStudy_0 = mdxProject_0.getDesignStudyManager().getDesignStudy(designStudies[i]);
        
                mdxDesignStudy_0.runDesignStudy();
        
            }
          }
        }

        In the Java code above, the designStudies array defines the design studies to run. Replace the default design study names (Design Study 1, Design Study 2, and Design Study 3) with the names of the design studies that you want to run.

      2. Move the macro file to your project root directory, which contains the relevant Design Manager project file (*.dmprj).
      3. Open a command prompt and enter the following command line: [STAR-CCM+_INSTALL_DIR]\star\bin\starccm+ -batch [PROJECT_ROOT_DIR]\runSpecificStudies.java [PROJECT_ROOT_DIR]\[PROJECT].dmprj [-dmnoshare] [-passtodesign <options>]

        This command line only applies on Windows. For Linux, you must use forward slashes.

    • If you want to run all design studies sequentially from first to last:
      1. Open a command prompt and enter the following command line: [STAR-CCM+_INSTALL_DIR]\star\bin\starccm+ -batch run [PROJECT_ROOT_DIR]/[PROJECT].dmprj [-dmnoshare] [-passtodesign <options>]

    where:

    • [STAR-CCM+_INSTALL_DIR] represents the absolute path to the Simcenter STAR-CCM+ installation directory.
    • [PROJECT_ROOT_DIR] represents the path to the project root directory.
    • [PROJECT] represents the name of the Design Manager project file.
    • -dmnoshare activates the Unlicensed Design Manager Server license scheme. Omitting this option uses the Default license scheme. For more information, see Design Manager Licensing.
    • -passtodesign <options> allows you to pass additional simulation command line options, such as license options, to the design simulations. Passing simulation command line options directly from the command line is useful for machine-specific or user-specific options, which you do not want to save within your Design Manager project file (see step 1b). However, command line options that require double quotes are not supported—you must set these options in the STAR-CCM+ Command Line Options property. For more information, see Design Manager Options.
    If [PROJECT_ROOT_DIR] or [PROJECT] contains spaces, you must pass the Design Manager project file with quotes, such as:

    [STAR-CCM+_INSTALL_DIR]\star\bin\starccm+ -batch run "[PROJECT_ROOT_DIR]/[PROJECT].dmprj" [-dmnoshare] [-passtodesign <options>]