Home
Tutorials
Tutorials show you how to use Simcenter STAR-CCM+ for various applications in a step-by-step format with recommendations for setup, initialization and steps of the solution process specific to the application. Macro and simulation files are available for download for a large proportion of cases.
Coupling with CAE Codes
The tutorials in this set illustrate various Simcenter STAR-CCM+ features for coupling with CAE codes:
Co-Simulation API: Spindle Valve
This tutorial demonstrates how to use the Simcenter STAR-CCM+ Co-Simulation API (Application Programming Interface), in order to couple a partner program to a Simcenter STAR-CCM+ simulation. The partner simulation models the behavior of a spindle ball valve in response to a multiphase flow.
The Ball Valve Partner Code Simulation
In this tutorial, you are provided with a sample partner code that solves the equation of motion for the ball valve. Compile the code and launch the ball valve solid simulation.

Share

Link: copied

Breadcrumb: copied

Tutorials
Tutorials show you how to use Simcenter STAR-CCM+ for various applications in a step-by-step format with recommendations for setup, initialization and steps of the solution process specific to the application. Macro and simulation files are available for download for a large proportion of cases.
- Using Tutorial Macros and Files
  Macros, input files, and final simulation files for a range of tutorials are provided as an optional download package on the Support Center website. These macros and final simulation files are provided as an aid to the written tutorials, so that you can check your final results against the downloaded files, or against a simulation that is built and run using the macros.
- Introduction
  Welcome to the Simcenter STAR-CCM+ introductory tutorial. In this tutorial, you explore the important concepts and workflow. Complete this tutorial before attempting any others.
- Foundation Tutorials
  The foundation tutorials showcase the major features of Simcenter STAR-CCM+ in a series of short tutorials.
- Geometry
  The tutorials in this set illustrate various Simcenter STAR-CCM+ features for creating and working with parts and 3D-CAD.
- Mesh
  The tutorials in this set illustrate various STAR-CCM+ features for building CFD meshes.
- Incompressible Flow
  The tutorials in this set illustrate various Simcenter STAR-CCM+ features for incompressible fluid flows as well as porosity and solution recording
- Compressible Flow
  The tutorials in this set illustrate various Simcenter STAR-CCM+ features for compressible fluid flows as well as harmonic balance.
- Heat Transfer and Radiation
  The tutorials in this set illustrate various Simcenter STAR-CCM+ features for heat transfer, radiation, and thermal comfort.
- Multiphase Flow
  The tutorials in this set illustrate various Simcenter STAR-CCM+ features for simulating multiphase fluid flow problems
- Discrete Element Method
  The tutorials in this set illustrate various Simcenter STAR-CCM+ features for simulating Discrete Element Method problems
- Motion
  The tutorials in this set illustrate various STAR-CCM+ features for simulating problems with moving geometries and meshes, dynamic fluid body interaction, and rigid body motion:
- Reacting Flow
  The tutorials in this set illustrate various Simcenter STAR-CCM+ features for simulating reacting flows such as combustion.
- Solid Stress
  The tutorials in this set illustrate various Simcenter STAR-CCM+ features for computing deformation, strain, and stresses in solid regions. They also show how such computations can be coupled to the fluid behavior in an analysis of fluid-structure interaction.
- Aeroacoustics
  The tutorials in this set illustrate various Simcenter STAR-CCM+ features for solving aeroacoustic simulations.
- Electromagnetism
  The following tutorials illustrate features for solving problems that involve electromagnetic fields.
- Electrochemistry
  The following tutorial demonstrates chemical reactions induced by an electrical current.
- Battery
  The tutorials in this set illustrate various Simcenter STAR-CCM+ features for setting up a battery model:
- Automation
  The tutorials in this set illustrate various Simcenter STAR-CCM+ automation and macro features.
- Design Exploration
  The tutorials in this set illustrate various features for running design exploration studies in Design Manager.
- Coupling with CAE Codes
  The tutorials in this set illustrate various Simcenter STAR-CCM+ features for coupling with CAE codes:
  - Simcenter STAR-CCM+ to Simcenter STAR-CCM+ Coupling: Heat Transfer in a Chimney
    This tutorial demonstrates the process for modeling conjugate heat transfer using Simcenter STAR-CCM+ to Simcenter STAR-CCM+ thermal co-simulation.
  - Simcenter Nastran Co-Simulation: Disc Valve
    To solve fluid-structure interaction problems, you can couple Simcenter STAR-CCM+ and Simcenter Nastran in a co-simulation analysis. Simcenter STAR-CCM+ computes the flow solution and Simcenter Nastran computes the structural analysis for the solid.
  - FMU Co-Simulation with Simcenter Amesim: Check Valve
    Simcenter STAR-CCM+ can exchange data with Simcenter Amesim through imported FMU models. An FMU is a time-dependent model written in the Functional Mock-up Interface (FMI) standard.
  - FMU Co-Simulation: Temperature Controller
    Simcenter STAR-CCM+ can exchange single-value data with imported FMU models. FMU models are time-dependent models that are written according to the Functional Mock-up Interface (FMI) standard.
  - Abaqus File-Based Coupling: Exhaust Manifold
    The purpose of this tutorial is to demonstrate the typical workflow in running a thermal fluid-structure interaction case using the file-based coupling method with Abaqus.
  - Abaqus Co-Simulation: Thermal Coupling
    This tutorial demonstrates how to run a thermal co-simulation case using Simcenter STAR-CCM+ and Abaqus. Co-simulation involves a strong coupling between the two codes, in which data exchange occurs at frequent intervals, that are known as coupling steps. In this case, data is exchanged at the end of each time-step, and a relatively large time-step is used to approximate a steady-state solution.
  - Abaqus Co-Simulation: Mechanical Coupling
    This tutorial demonstrates how to carry out a mechanical co-simulation case using Simcenter STAR-CCM+ and Abaqus. Co-simulation involves a strong coupling between the two codes. Data is exchanged at frequent intervals that are called coupling steps. This level of communication between the solvers allows you to obtain a full solution across the fluid-solid interface.
  - gPROMS File Export: Spray Dryer
    Simcenter STAR-CCM+ allows for one-way coupling with gPROMS, a process modeling platform for the simulation of complex systems. In Simcenter STAR-CCM+ you reduce three-dimensional solution data to discrete values defined for clusters of cells; data from these clusters can then be exported to a network in gPROMS.
  - GT-SUITE Co-Simulation: 1D Coupling
    This tutorial demonstrates the typical workflow for co-simulation with the engine simulation code GT-SUITE from Gamma Technologies.
  - Co-Simulation API: Spindle Valve
    This tutorial demonstrates how to use the Simcenter STAR-CCM+ Co-Simulation API (Application Programming Interface), in order to couple a partner program to a Simcenter STAR-CCM+ simulation. The partner simulation models the behavior of a spindle ball valve in response to a multiphase flow.
    - Prerequisites
      The instructions in the Co-Simulation API: Spindle Ball Valve tutorial assume that you are already familiar with certain techniques in Simcenter STAR-CCM+.
    - The Simcenter STAR-CCM+ Fluid Simulation
      Prepare the Simcenter STAR-CCM+ simulation that models the fluid flow in the spindle ball valve.
    - The Ball Valve Partner Code Simulation
      In this tutorial, you are provided with a sample partner code that solves the equation of motion for the ball valve. Compile the code and launch the ball valve solid simulation.
      - Compiling and Launching the Partner Code using Linux
        On Linux, you can compile and launch the ball valve simulation using the buildapi and starapi helper scripts that are provided in the Simcenter STAR-CCM+ installation. To compile the sample code, you require g++ version 4.3.4 or greater.
      - Compiling and Launching the Partner Code Using Windows
        On Windows, you can compile and launch the ball valve simulation using Microsoft Visual Studio and the starapi.bat helper script that is included in the Simcenter STAR-CCM+ installation. You require Microsoft Visual Studio version 2019 or greater.
    - Running the Co-Simulation
      Couple the Simcenter STAR-CCM+ fluid simulation to the ball valve simulation and run the co-simulation.
    - Visualizing the Results
      Visualize the scenes and plots that are relevant to this mechanical co-simulation analysis.
    - Summary
      This tutorial demonstrated how to use the Simcenter STAR-CCM+ Co-Simulation API to couple partner code with a running Simcenter STAR-CCM+ simulation.
  - CGNS File Import: Stress Analysis with Imported Fluid Loads
    Simcenter STAR-CCM+ allows you to import external mesh and solution data in the form of a CGNS file. You can apply the solution data stored in the CGNS file to regions or boundaries within Simcenter STAR-CCM+.
  - Rotor Blade Aeroelasticity: Modeling Elastic Blade Deformation
    Simcenter STAR-CCM+ allows you to model the aeroelastic performance of elastic rotor blades using displacement and twist data from external files, which can be obtained in multi-body dynamics software such as RCAS, CAMRAD-II, DYMORE, and FLIGHTLAB.
- Analysis Methods
  The tutorials in this set illustrate various Simcenter STAR-CCM+ features for analysing and visualizing simulation data.
- Simcenter STAR-CCM+ In-cylinder
  The tutorials in this set illustrate features for simulating internal combustion engines in Simcenter STAR-CCM+ using the dedicated add-on Simcenter STAR-CCM+ In-cylinder.

The Ball Valve Partner Code Simulation

In this tutorial, you are provided with a sample partner code that solves the equation of motion for the ball valve. Compile the code and launch the ball valve solid simulation.

A spring connected to the ball valve allows the valve motion in response to the fluid forces. The ball valve is constrained to move along its axial direction, that in this tutorial corresponds to the z direction. The partner code calculates the position of the valve treating the model as a 1-DoF spring-mass-damping system, with equation of motion:

Figure 1. EQUATION_DISPLAY

m \ddot{z} (t) + c \dot{z} (t) + k z (t) = F_{z} (t)

(5316)

where $m$ is the ball valve mass, $c$ is the damping coefficient, $k$ is the spring stiffness, and $F_{z}$ is the z component of the traction field imported from the Simcenter STAR-CCM+ fluid simulation, integrated over surface. In this tutorial damping effects are neglected, so $c = 0$ . The equation of motion, Eqn. (5316), is solved using the Newmark-beta numerical integration method.

The code that is provided in this tutorial consists of several .cpp and .h files. The main file, SpindleValve.cpp, outlines the recommended workflow when using the Co-Simulation API, from loading the Co-Simulation API library to setting up the co-simulation loop. You can modify the ball valve simulation time-step and maximum physical time values in this file. You can modify the spring-mass-damping system parameters in the file, SpringMassSolver.cpp.

Compiling the code generates an executable file, that you use to launch the ball valve solid simulation.