Modelica.Mechanics.MultiBody.Visualizers.Advanced.SurfaceCharacteristics

Information

This package contains functions that are used to define parameterized surfaces for use with the Surface model.

Package Content

Name	Description
torus	Function defining the surface characteristic of a torus
pipeWithScalarField	Function defining the surface characteristic of a pipe where a scalar field value is displayed with color along the pipe axis

Modelica.Mechanics.MultiBody.Visualizers.Advanced.SurfaceCharacteristics.torus

Information

Function torus computes the X,Y,Z arrays to visualize a torus with model Torus. The left image below shows a torus with ri=0.5 m and ro = 0.2 m. The right images below shows the torus with the additional parameter settings:

  opening    =   45 degree
  startAngle = -135 degree
  stopAngle  =  135 degree

Inputs

Name	Description
nu	Number of points in u-Dimension
nv	Number of points in v-Dimension
multiColoredSurface	= true: Color is defined for each surface point
ri	Inner radius of torus [m]
ro	Outer radius of torus (=width/2) [m]
opening	Opening angle of torus [rad]
startAngle	Start angle of torus slice [rad]
stopAngle	End angle of torus slice [rad]

Outputs

Name	Description
X[nu, nv]	[nu,nv] positions of points in x-Direction resolved in surface frame [m]
Y[nu, nv]	[nu,nv] positions of points in y-Direction resolved in surface frame [m]
Z[nu, nv]	[nu,nv] positions of points in z-Direction resolved in surface frame [m]
C[if multiColoredSurface then nu else 0, if multiColoredSurface then nv else 0, 3]	[nu,nv,3] Color array, defining the color for each surface point

Modelica.Mechanics.MultiBody.Visualizers.Advanced.SurfaceCharacteristics.pipeWithScalarField

Information

Function pipeWithScalarField computes the X,Y,Z,C arrays in order to visualize a pipe and a scalar field along the pipe axis with model PipeWithScalarField. The latter is shown by mapping scalar field to color values with a color map and utilizing this color at the perimeter associated with the corresponding axis location. Typically the scalar field value is a temperature, but might be also another quantity. Predefined color maps are available from MultiBody.Visualizers.Colors.ColorMaps and can be selected via input argument "colorMap". A color map with the corresponding scalar field values can be exported as vector-graphics in svg-format with function MultiBody.Visualizers.Colors.colorMapToSvg. An example is shown in the next figure:

The color coding is shown in the next figure. It was generated with Mechanics.MultiBody.Visualizers.Colors.colorMapToSvg using the following call:

colorMapToSvg(Modelica.Mechanics.MultiBody.Visualizer.Colors.ColorMap.jet(),
              height=50, nScalars=6, T_max=100, heading="Temperature in C");

Inputs

Name	Description
nu	Number of points in u-Dimension
nv	Number of points in v-Dimension
multiColoredSurface	= true: Color is defined for each surface point
rOuter	Outer radius of cylinder [m]
length	Length of cylinder [m]
xsi[:]	Relative position along the pipe with x[1] = 0, x[end] = 1 [m]
T[size(xsi, 1)]	Scalar field value at position xsi*length
T_min	T <= T_min is mapped to colorMap[1,:]
T_max	T >= T_max is mapped to colorMap[end,:]
colorMap[:, 3]	Color map to map scalar T to a corresponding color

Outputs

Name	Description
X[nu, nv]	[nu,nv] positions of points in x-Direction resolved in surface frame [m]
Y[nu, nv]	[nu,nv] positions of points in y-Direction resolved in surface frame [m]
Z[nu, nv]	[nu,nv] positions of points in z-Direction resolved in surface frame [m]
C[if multiColoredSurface then nu else 0, if multiColoredSurface then nv else 0, 3]	[nu,nv,3] Color array, defining the color for each surface point