GILTable
Last update: 09.03.2026A 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.