TRACE User Guide  TRACE Version 9.6.1
FSI Commands

FSI

Activate the Fluid Structure Interaction module.

Usage
FSI <SolverInstanceName> <InputFileCalculiX> <PanelFamilyName1> <PanelFamilyName2> <PanelFamilyName>..
Parameters
InputFileStructureCalucliX input file (without file extention)
PanelFamilyNameTRACE panel family which covers the solid structure which is simulated
Domain
all
Example
all immediate FSI myStructure ccx row01_blade_ss row01_blade_ps
Since
9.1

FSIrelaxation

Activate relaxation for Fluid Structure Interaction module.

Usage
FSIrelaxation <SolverInstanceName> <Method> <relaxationParameter>
Parameters
relaxationParameterrelaxation factor for fixed point iteration
Domain
all
Example
all immediate FSIrelaxation myStructure FixedPoint 0.9
all immediate FSIrelaxation myStructure Aitken
Since
9.1

FSInPseudoTimeStepsCoupling

Set the number of pseudo time steps for the flow solver between consecutive FSI subiterations.

Usage
FSInPseudoTimeStepsCoupling <numberOfPseudoTimeSteps>
Parameters
numberOfPseudoTimeStepsnumber of pseudo time steps
Domain
all
Example
all immediate FSInPseudoTimeStepsCoupling 10
Since
9.1

FSIUnitConversion

Set the unit conversion factors for the FSI module.

Usage
FSIUnitConversion <SolverInstanceName> <conversionFactorPressure2ccx> <conversionFactorDisplacement2TRACE> <conversionFactorVelocity2TRACE>
Parameters
conversionFactorPressure2ccxconvert pressure from TRACE (Pa) to CalculiX (e.g. MPa)
conversionFactorDisplacement2TRACEconvert displacement from CalculiX (e.g. mm) to TRACE (m)
conversionFactorVelocity2TRACEconvert velocity from CalculiX (e.g. mm/s) to TRACE (m/s)
Domain
all
Example
all immediate FSIUnitConversion myStructure 1.0e-6 1.0e-3 1.0e-3
Since
9.1

FSIUnitConversionHeat

Set the unit conversion factors for conjugated heat transfer analysis.

Usage
FSIUnitConversion <SolverInstanceName> <conversionFactorHeatFlux2ccx> <conversionFactorTemperature2TRACE>
Parameters
conversionFactorHeatFlux2ccxconvert heat flux from TRACE (W/m^2) to CalculiX (e.g. W/mm^2)
conversionFactorTemperature2TRACEconvert displacement from CalculiX (e.g. K) to TRACE (K)
Domain
all
Example
all immediate FSIUnitConversionHeat myStructure 1.0e-6 1.0
Since
9.1

FSITransformationMatrix

Specify the file containing the transformation matrix for the structure to transform the CSM surface onto the CFD surface.

Usage
FSITransformationMatrix <SolverInstanceName> <transformation_matrix_file.dat>
Parameters
transformation_matrix_file.datfile containing the matrix and the translation vector
Domain
all
Example
all immediate FSITransformationMatrix myStructure mapping_transformation.dat
Since
9.1

FSIInitialDeflectionSteadyLoadFactor

Specify an initial deflection for the structure by applying a fraction of the steady pressure and letting CalculiX compute a number of timesteps.

Usage
FSIInitialDeflectionSteadyLoadFactor <SolverInstanceName> <steadyLoadFector> <nSteps>
Parameters
steadyLoadFectorfraction of the steady pressure
steadyLoadFectornumber of timesteps
Domain
all
Example
all immediate FSIInitialDeflectionSteadyLoadFactor myStructure 0.2 5
Since
9.1

FSISurfaceInterpolationPressure

Choose the surface interpolation for the interpolation of the surface pressure of the FSI module.

Usage
FSISurfaceInterpolationPressure <SolverInstanceName> <Method> <r>
Parameters
Methodinterpolation method (e.g. RadialBasisFunctionC2 or NearestNeighbour)
rsupport radius of the basis function if RadialBasisFunctions are used
Domain
all
Example
all immediate FSISurfaceInterpolationPressure myStructure RadialBasisFunctionC2 0.01
Since
9.1

FSIdummy

Active an FSI dummy motion. t: translation, off: offset, the rest: deformation gradient

Usage
FSIdummy <SolverInstanceName> <x_t> <y_t> <z_t> <x_off> <y_off> <z_off> <xx> <xy> <xz> <yx> <yy> <yz> <zx> <zy> <zz>
Parameters
manymany
Domain
all
Since
9.1

setDeformationSolverRelativeBound

Set the deformation tolerance for the GMRES deformation solver used during FSI simulations.

Usage
setDeformationSolverRelativeBound <tol>
Parameters
tolthe tolerance
Domain
all
Example
all immediate setDeformationSolverRelativeBound 1e-6
Since
9.1

FSIuseInitialSolutionPressureAsPressureOffset

Fluid-Structure Interaction: Use initial solution pressure as pressure offset.

Usage
FSIuseInitialSolutionPressureAsPressureOffset <SolverInstanceName>
Domain
all
Example
all immediate FSIuseInitialSolutionPressureAsPressureOffset myStructure
Since
9.1

FSISurfaceTecplotOutput

Fluid-Structure Interaction: Write the fluid and structural surface mesh (plus displacement and pressure) to a tecplot ascii file. A path for the output must be specified. After one period (set with GMC in TRACE unsteady settings) the data will be overwritten.

Usage
FSISurfaceTecplotOutput <SolverInstanceName> <interleave> <path> [subiteration]
FSISurfaceTecplotOutput <SolverInstanceName> <interleave> <path>
Parameters
interleavespecifies the interleave for the output (e.g. 10: every 10 timesteps of a period the surface data is written).
subiterationOptional flag: subiteration (the surface data is written out each pseudo time step)
Domain
all
Example
all immediate FSISurfaceTecplotOutput myStructure 10 ../output/fsisurface
all immediate FSISurfaceTecplotOutput myStructure 10 ../output/fsisurface subiteration
Since
9.1

FSIMirrorCoordinate

Fluid-Structure Interaction: Mirror the structural model at a plane normal to the specified axis in the origin.

Usage
FSIMirrorCoordinate <SolverInstanceName> <x|y|z>
Domain
all
Example
all immediate FSIMirrorCoordinate myStructure y
Since
9.1

FSICyclicSymmetricVirtualPassages

Fluid-Structure Interaction: Create virtual passages to assemble a full 360 degree blade row or part of it. The Parameter <Model no. of segments> describes the number of segments to be modeled (including the already existing one). The flag "clockwise" can be appended to the command which will rotate the virtual segments in the opposite direction (useful if only a part of a blade row should be assembled).

Usage
FSICyclicSymmetricVirtualPassages <SolverInstanceName> <Total no. of segments for full annulus> <Model no. of segments>
Domain
all
Example
all immediate FSICyclicSymmetricVirtualPassages myStructure 5 50
Since
9.1

FSIPreCalculationPerformSteps

Fluid-Structure Interaction: Specify the total number of pre-calculation steps in the CalculiX input file. The default is one step.

Usage
FSIPerformPreCalculationSteps <SolverInstanceName> <NoTotalStepsInCCXInputFile>
Domain
all
Example
all immediate FSIPerformPreCalculationSteps myStructure 3
Since
9.1

FSIPreCalculationApplyPressureAtStep

Fluid-Structure Interaction: Specify the pre-calculation step in the CalculiX input file at which the static pressure should be applied to the structural surface.

Usage
FSIPreCalculationApplyPressureAtStep <SolverInstanceName> <StepNo>
Domain
all
Example
all immediate FSIPreCalculationApplyPressureAtStep myStructure 2
Since
9.1

FSIPreCalculationReadStaticDeformationAtStep

Fluid-Structure Interaction: Specify the pre-calculation step in the CalculiX input file at which the static deformation should be read from the structural solver and saved as offset.

Usage
FSIPreCalculationReadStaticDeformationAtStep <SolverInstanceName> <StepNo> <StaticDeformationFile>
Domain
all
Example
all immediate FSIPreCalculationReadStaticDeformationAtStep myStructure 2 ../output/fsi/CalculiXStaticDeformation.dat
Since
9.1

FSIPreCalculationSaveSolverStatusAfterStep

Fluid-Structure Interaction: Specify the pre-calculation step in the CalculiX input file after which the status of the external solver should be saved as initialization for the coupled simulation.

Usage
FSIPreCalculationSaveSolverStatusAfterStep <SolverInstanceName> <StepNo>
Domain
all
Example
all immediate FSIPreCalculationSaveSolverStatusAfterStep myStructure 3
Since
9.1

FSIExternalSolverActivateNonlinearGeometricEffects

Fluid-Structure Interaction: Turn on geometric variations for e.g. modal dynamic calculations.

Usage
FSIExternalSolverActivateNonlinearGeometricEffects <SolverInstanceName>
Domain
all
Example
all immediate FSIExternalSolverActivateNonlinearGeometricEffects myStructure
Since
9.1

FSIExternalSolverOutputInterleave

Fluid-Structure Interaction: Set the output interleave for the external solver. The interleave refers to the number of time steps per TRACE period.

Usage
FSIExternalSolverOutputInterleave <SolverInstanceName> <Interleave> [subiterationFlag]
Domain
all
Example
all immediate FSIExternalSolverOutputInterleave myStructure 4
all immediate FSIExternalSolverOutputInterleave myStructure 4 subiteration
Since
9.2

FSIStructureMeshFlipSurfaceNormals

Fluid-Structure Interaction: Flips the surface normals of the structure mesh for the displacement mapping. This command is necessary if the surface normal orientation of the structure mesh points in the wrong direction causing the displacement mapping to map displacements from on side of a structure (e.g. suction side of a blade) to the opposite side of the structure (e.g. pressure side of a blade).

Usage
FSIStructureMeshFlipSurfaceNormals <SolverInstanceName>
Domain
all
Example
all immediate FSIStructureMeshFlipSurfaceNormals myStructure
Since
9.2

FSIExternalSolverSetTimeIncrement

Fluid-Structure Interaction: This command will instruct TRACE to not override the time increment setting in the external solver. Thus smaller time increments than a TRACE timestep for the external solver are possible. The unit of the time increment is the unit the external solver expects (usually seconds).

Usage
FSIExternalSolverSetTimeIncrement <SolverInstanceName> <time increment>
Domain
all
Example
all immediate FSIExternalSolverSetTimeIncrement myStructure 0.002
Since
9.2

FSIAnalysisPoint

Specify an analysis point for the FSI module which tracks the deformation of a point lying on the solid surface.

Usage
FSIAnalysisPoint <ZoneID> <I> <J> <K> <output_file.dat>
Parameters
ZoneIDzone number
Ii index of the structured mesh
Jj index of the structured mesh
Kk index of the structured mesh
output_file.datoutput filename
Domain
all
Example
all immediate FSIAnalysisPoint 9 1 1 14 displacement_corner_tip_trailingedge.dat
Since
9.1

useDGCLsimplified

Use a less accurate but faster implementation of the DGCL.

Usage
useDGCLsimplified
Domain
all, component, stage, group, blockGroup, block
Example
all immediate useDGCLsimplified
Since
9.1