STAR-CCM+

Description

From the STAR-CCM+ Home Page: Much more than just a CFD solver, STAR-CCM+ is an entire engineering process for solving problems involving flow (of fluids or solids), heat transfer and stress.

Version

  • 15.06.007

Authorized Users

  • Authorized students in Mechanical Engineering
  • Members of the Society of Automotive Engineers at USF

Platforms

  • CIRCE cluster
  • SC cluster

Modules

STAR-CCM+ requires the following module file to run:

  • apps/star-ccm/15.06.007

Running STAR-CCM+ on CIRCE/SC

The STAR-CCM+ user guide is essential to understanding the application and making the most of it. The guide and this page should help you to get started with your simulations. Please refer to the Documentation section for a link to the guide.

  • Note on CIRCE: Make sure to run your jobs from your $WORK directory!
  • Note: Scripts are provided as examples only. Your SLURM executables, tools, and options may vary from the example below. For help on submitting jobs to the queue, see our SLURM User’s Guide.

If you need more control over your workflow, keep reading below.

If you will be using a Power-on-Demand key, please contact Research Computer for additional instructions.

Interactive Execution via CIRCE/SC Desktop Environment

Establishing a GUI connection to CIRCE/SC

To use STAR-CCM+, you will need to connect to CIRCE/SC with GUI redirection, either using:

  • CIRCE/SC Desktop Environment
  • SSH with X11 redirection
    • If connecting from OSX or Linux via SSH, please ensure that you use one of the following commands to properly redirect X11:
      • [user@localhost ~]$ ssh -X circe.rc.usf.edu
        or
      • [user@localhost ~]$ ssh -X sc.rc.usf.edu

Once connected to CIRCE/SC, you can open STAR-CCM+ using the steps below:

[user@login0 ~]$ module add apps/star-ccm/15.06.007
[user@login0 ~]$ starccm+

How to Submit Jobs

Provided are batch scripts for running STAR-CCM+ as a single processor and distributed parallel job. Existing STAR-CCM+ SIM files will work in parallel mode with no modification, but only larger models and geometries will see any performance benefit. These scripts can be copied into your work directory (the folder with your input files and database files) so that you can submit batch processes to the queue.

If, for example, you have STAR-CCM+ simulation file called “test.sim”, you would set up your serial/distributed parallel submit scripts like this:

  • The scripts below (for testing, name it “starccm-serial-test.sh” or name it “starccm-parallel-test.sh”, respectively) can be copied into your job directory (the folder with your input files) and modified so that you can submit batch processes to the queue.

Serial Submit Script

#!/bin/bash
#
#SBATCH --comment=starccm-serial-test
#SBATCH --ntasks=1
#SBATCH --job-name=starccm-serial-test
#SBATCH --output=output.%j.starccm-serial-test
#SBATCH --time=08:00:00

#### SLURM 1 processor STAR-CCM+ test to run for 8 hours.

module purge
module add apps/star-ccm/15.06.007

export PATH=$TMPDIR:$PATH

starccm+ -pio -batch test.sim

Distributed Parallel Submit script

#!/bin/bash
#
#SBATCH --comment=starccm-parallel-test
#SBATCH --ntasks=32
#SBATCH --job-name=starccm-parallel-test
#SBATCH --output=output.%j.starccm-parallel-test
#SBATCH --time=08:00:00

#### SLURM 32 processor STAR-CCM+ test to run for 8 hours.

module purge
module add apps/star-ccm/15.06.007

export PATH=$TMPDIR:$PATH

# Create our hosts file ala slurm
NODEFILE="$(pwd)/slurmhosts.$SLURM_JOB_ID.txt"
srun hostname -s &> $NODEFILE

starccm+ -np $SLURM_NTASKS -machinefile $NODEFILE -mpi intel -rsh ssh -pio -batch "test.sim"

 
Next, you can change to your job’s directory, and run the sbatch command to submit the job:

[user@login0 ~]$ cd my/jobdir
[user@login0 jobdir]$ sbatch ./starccm-serial-test.sh
  • You can view the status of your job with the “squeue -u <username>” command

Documentation

Home Page, User Guides, and Manuals

More Job Information

See the following for more detailed job submission information:

Reporting Bugs

Report bugs with STAR-CCM+ to the IT Help Desk: rc-help@usf.edu