Skip to main content

Command Reference for Rigid Dynamics Systems 2026 R1

GILTable

Last update: 09.03.2026

A general multi-input interpolated table based on an unstructured cloud of points.

Corresponding ID table: CS_GILTable

Member functions

CS_GILTable(sizeIn,sizeOut)

Creates a GIL table with sizeIn inputs and sizeOut outputs

CS_GILTable(sizeIn, sizeOut, filename, scale, separator, noHeader)

Creates a GIL table from a text file; filename is the name of the file containing the points (typically a .CSV file). This file must be in ASCII format, with one data point per row. Each row must contain sizeIn + sizeOut columns. The columns must be separated by a character specified by the separator argument. The default value of separator is ,. scale is an optional argument that scales all the output values. The default value, used if the optional argument is not specified, is 1.0. noHeader is a boolean, optional argument that should be true if there is no first row with labels.

Example file:

Velocity, Deflection, Force
0.,0.,10.0
100.,0.,200.0
...

AddInterpolationPoint(values)

Adds an interpolation point to the General Interpolation Table. values is a one-dimensional array of size sizeIn+sizeOut. The first sizeIn values in array values correspond to the values of the input variables. The following sizeOut values in array values correspond to the output values.

Example 1. Creation of a Nonlinear Stiffness Value That Depends on Spin Velocity (Omega) and on Deflection (dY)

VarForceY = CS_Variable();
#
# Variable 0: spin
VarForceY.AddInputMeasure(SpinMeasure )
#
# Variable 1: Y displacement
VarForceY.AddInputMeasure( TransY )
# 
# Create table with 2 input and 1 output
EvalY = CS_GILTable(2,1)

Omega = -1.0
dY = -1e-4
stiff = -9.0

values=System.Array.CreateInstance(float,3)

values[0] = Omega
values[1] = dY
values[2] = stiff
EvalY.AddInterpolationPoint( values )

Omega = 11.0
dY = -1e-4
stiff = -21.0
values[0] = Omega
values[1] = dY
values[2] = stiff
EvalY.AddInterpolationPoint( values )
…

AddInterpolationPointArray(values)

Adds a set of points to the General Interpolation Table. values is a two-dimensional array of size (numberOfPoints, sizeIn+sizeOut). On each row of the array, the first sizeIn values in array values correspond to the values of the input variables. The following sizeOut values in array values correspond to the output values. Each row contains a single interpolation point in the cloud of points.

Example 2. Creation of a Nonlinear Force Value (F) That Depends on Deflection (dX)

ForceVariable = CS_Variable()
ForceVariable.AddInputMeasure( TransX )
Evaluator = CS_GILTable( 1,1 )
values = System.Array.CreateInstance( float, 6, 2 )
dX = 0.0
F = 0.0
values[0,0] = dX
values[0,1] = F

dX = 10.0
F = 1.0
values[1,0] = dX
values[1,1] = F

dX = 30.0
F = 2.0
values[2,0] = dX
values[2,1] = F

dX = 60.0
F = 3.0
values[3,0] = dX
values[3,1] = F

dX = 90.0
F = 4.0
values[4,0] = dX
values[4,1] = F

dX = 130.0
F = 5.0
values[5,0] = dX
values[5,1] = F
Evaluator.AddInterpolationPointArray( values )   

SetVerbosity(bVerbose)

If bVerbose is set to true, the GILTable will print the output value every time it is evaluated. This can be used for debugging purposes, but it will affect the performance if used on a table in a long simulation.

Limitations

These tables can only be used to apply forces and moments, not for other joint conditions or remote displacements.

Connect with Ansys