Home
User Interface
Simcenter STAR-CCM+ provides a Graphical User Interface generally known as the client workspace. This interface appears when you launch Simcenter STAR-CCM+ interactively.
Working with User Code
User code allows Simcenter STAR-CCM+ to be customized with functions written in a compiled language such as C, C++ or Fortran.
Fortran User Interface Reference
This section introduces the interface between Simcenter STAR-CCM+ and Fortran user functions.
User Function Argument Registration ufarg (Fortran)
This section describes user function argument registration.

Share

Link: copied

Breadcrumb: copied

User Interface
Simcenter STAR-CCM+ provides a Graphical User Interface generally known as the client workspace. This interface appears when you launch Simcenter STAR-CCM+ interactively.
- Using the Simcenter STAR-CCM+ Workspace
  This chapter shows you how to use the various components of Simcenter STAR-CCM+, with a focus on the user interface.
- What Are the Important Concepts?
  This section presents the key concepts you come across when using Simcenter STAR-CCM+.
- Working with Simulation Objects
  Objects are the key components of Simcenter STAR-CCM+. They represent various aspects of a simulation and have properties that you can set as required for your particular problem.
- Automation
  The Automation node provides easy access to a number of frequently used automated processes.
- Expressions
  In Simcenter STAR-CCM+, you can define property values using expressions, which you write using a function language that is a subset of the C programming language. Expressions can define mathematical expressions or perform other operations, such as interpolating tabular data from XY tables in the simulation.
- Global Parameters
  Global parameters include scalar and vector physical quantities (for example, 120.0 K or [0.0, 1.0, 0.0] m) that can be defined once and used in multiple objects. Another type of global parameter is a file, currently used for the Replace Parts operation in Geometry > Operations and in Design Manager.
- Field Functions
  Field functions allow you to access fields (scalar or vector data that are evaluated at cells, vertices, or boundary faces) in Simcenter STAR-CCM+. You can use field functions to visualize the computed fields, to specify boundary and region values, or to define initial conditions.
- Engineering Units
  Simcenter STAR-CCM+ has flexible and customizable support for engineering units. The standard SI and USCS systems are built in, and you can add new units as desired. Physical quantities can be specified and displayed in any of these units. Individual quantities can be specified with new units on the fly by simply typing something like “80 mph”.
- Simulation Operations
  Simulation operations allow you to automate the solution processes in Simcenter STAR-CCM+ without using Java macros. Condition and loop operations provide the basic logic control common to many programming languages.
- Staged Physics
  In Simcenter STAR-CCM+, staged physics allows you to store multiple configurations of physics settings and apply them in sequence during a simulation. Simulation operations provide the framework in which physics stages are applied.
- Working with Volume Shapes
  A volume shape is a closed geometric figure that can be shaped as a block, cone, cylinder, or sphere.
- Simulation Guide
  The simulation guide is a single embedded document that you can edit within a simulation file. This document can contain formatted text, tables, images, and hyperlinks to nodes in the Simcenter STAR-CCM+ object tree or external web resources.
- Template Simulation Files
  Template simulation files allow you to define pre-configured setups for use in new simulations. When used in conjunction with query-based selection, template files present a powerful technique for automating repeat analyses on similar geometries.
- Scripting the Application
  Scripting allows you to work more efficiently by automating repetitive tasks.
- Working with User Code
  User code allows Simcenter STAR-CCM+ to be customized with functions written in a compiled language such as C, C++ or Fortran.
  - What Are User Libraries?
    User libraries are shared-object libraries (files with the platform-dependent extension .so, .sl or .dll) containing one or more user functions and a library registration function.
  - Working With User Functions
    User functions are functions or subroutines that are written in a compiled language such as C, C++ or Fortran.
  - Creating a New User Library
    This section provides information about creating a user library on Linux or Windows.
  - Accessing a User Library
    This section describes how to load or reload a user library in a Simcenter STAR-CCM+ simulation.
  - User Function Interface Reference (C)
    This section introduces the interface between Simcenter STAR-CCM+ and C user functions.
  - Fortran User Interface Reference
    This section introduces the interface between Simcenter STAR-CCM+ and Fortran user functions.
    - Type Definitions (Fortran)
      The types of variables and functions that are used in Fortran user functions are defined in the file StarReal.f.
    - Template User Function (Fortran)
      This section provides a template to help you create a user function.
    - Template Library Registration Function uflib (Fortran)
      This section describes how to register each user function in the library.
    - User Function Name Registration uffunc (Fortran)
      This section describes the initial registration of a Fortran user function.
    - User Function Argument Registration ufarg (Fortran)
      This section describes user function argument registration.
  - Variables Available to User Functions
    This section introduces the variables that are available to user functions.
  - User Code Examples
    This section provides some examples of user functions.
  - Using User Code on Particles and Parcels
    This section gives examples of cases where user coding applies to particles and parcels in multiphase modeling.
- Working with the Plugins Manager
  The Plugins Manager makes it possible to install and manage NetBeans modules for Simcenter STAR-CCM+.
- Simulation Assistants
  A Simulation Assistant provides a visual workflow within the Simcenter STAR-CCM+ user interface (UI).
- Wizard Guide
  This part of the documentation illustrates how Simcenter STAR-CCM+ is used for special application tools and projects.

User Function Argument Registration ufarg (Fortran)

This section describes user function argument registration.

Each argument of a Fortran user function which has been initially registered with uffunc is requested with a call in uflib to ufarg:

external func
integer size
call ufarg(func, type, variable, size)

func: a reference to the user function (called func in this case).

type: a character string giving the type of the argument, either of the following:

’Cell’ for a cell field
’Face’ for a face field

variable: a character string naming the requested argument, which must be a valid Simcenter STAR-CCM+ variable.

size: the storage in bytes required for one element of the variable array. This value is used to ensure that the precision of the user function matches the precision of Simcenter STAR-CCM+. Examples are:

StarRealSize if variable is a real(StarReal) scalar per element
3*CoordRealSize if variable is a real(CoordReal) vector per element
2*StarIntSize if variable is a pair of integers per element

The StarReal and CoordReal types define the precision of floating-point variables, together with StarRealSize, CoordRealSize, and StarIntSize, and are defined in the StarReal.f file.

Calls to ufarg must be made in the order the user function requires the arguments.