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.
User Function Interface Reference (C)
This section introduces the interface between Simcenter STAR-CCM+ and C user functions.
Type Definitions (C)
The types of variables and functions that are used in C user functions are defined in the file uclib.h.

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.
    - Type Definitions (C)
      The types of variables and functions that are used in C user functions are defined in the file uclib.h.
    - Template User Function (C)
      This section provides a template that you can use when creating a user function.
    - Template Library Registration Function uclib (C)
      This section provides a template that you can use when creating a library registration function.
    - User Function Name Registration ucfunc (C)
      This section describes the initial registration of a C user function.
    - User Function Argument Registration ucarg (C)
      This section describes the user function argument registration.
  - Fortran User Interface Reference
    This section introduces the interface between Simcenter STAR-CCM+ and Fortran user functions.
  - 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.

Type Definitions (C)

The types of variables and functions that are used in C user functions are defined in the file uclib.h.

This file is not part of the standard Simcenter STAR-CCM+ installation. Create it in the same directory where you are creating your user functions. The contents of uclib.h is displayed as shown here:


#ifndef UCLIB_H
#define UCLIB_H
#ifdef DOUBLE_PRECISION
typedef double Real;
#else
typedef float Real;
#endif
typedef double CoordReal;
  
#ifdef __cplusplus
extern "C" {
#endif
#if defined(WIN32) || defined(_WINDOWS) || defined(_WINNT)
# define USERFUNCTION_EXPORT __declspec(dllexport)
# define USERFUNCTION_IMPORT __declspec(dllimport)
#else
# define USERFUNCTION_EXPORT
# define USERFUNCTION_IMPORT
#endif
  
extern void USERFUNCTION_IMPORT ucarg(void *, char *, char *, int);
extern void USERFUNCTION_IMPORT ucfunc(void *, char *, char *);
extern void USERFUNCTION_IMPORT ucfunction(void *, char *, char *, int, ...);
  
void USERFUNCTION_EXPORT uclib();
#ifdef __cplusplus
}
#endif
#endif