udfGetSdData()

Return the data for a variable.

Syntax

data = udfGetSdData( udfHd, dataName ) ;

Type

AcuSolve User-Defined Subdomain Routine

Parameters

udfHd
The opaque handle (pointer) which was passed to the user function.
dataName (integer)
Symbolic name of a data variable.
UDF_SD_VELOCITY
Velocity.
UDF_SD_ACCELERATION
Acceleration.
UDF_SD_PRESSURE
Pressure.
UDF_SD_TEMPERATURE
Temperature.
UDF_SD_SPECIES
Species.
UDF_SD_EDDY_VISCOSITY
Turbulence eddy viscosity.
UDF_SD_KINETIC_ENERGY
Turbulence kinetic energy.
UDF_SD_EDDY_FREQUENCY
Turbulence eddy frequency.
UDF_SD_MESH_DISPLACEMENT
Mesh displacement.
UDF_SD_MESH_VELOCITY
Mesh velocity.
UDF_SD_TURBULENCE_Y
Distance to nearest turbulence wall.
UDF_SD_TURBULENCE_YPLUS
Turbulence y+ based on distance to nearest turbulence wall and shear at that wall.

Return Value

data (Real*)
Pointer to two dimensional real array of the requested data variable. The first (fast) dimension of the array is the number of nodes, and the second (slow) dimension is the dimension of the variable.

Description

This routine returns the data for a variable associated with the given symbolic data name. For example,
Integer nNodes, dataDim, node ;
Real u, v, w ;
Real* data ;
...
nNodes = udfGetNSdNodes( udfHd ) ;
dataDim = udfGetSdDataDim( udfHd, UDF_SD_VELOCITY ) ;
data = udfGetSdData( udfHd, UDF_SD_VELOCITY ) ;
for ( node = 0 ; node < nNodes ; node++ ) {
   u = data[0*nNodes+node] ;
   v = data[1*nNodes+node] ;
   w = data[2*nNodes+node] ;
   ...
}

Errors

  • This routine expects a valid udfHd.
  • This routine may only be called within an external code.
  • dataName must be one of the values given above.
  • The subdomain must contain the equation associated with the data variable.