Data Files (Tecplot Format)


Functions

Boolean_t TecUtilReadDataSet (ReadDataOption_e ReadDataOption, Boolean_t ResetStyle, StringList_pa FileNamesOrInstructions, const char *DataSetReader, PlotType_e InitialPlotType, Boolean_t IncludeText, Boolean_t IncludeGeom, Boolean_t IncludeCustomLabels, Boolean_t IncludeData, Boolean_t CollapseZonesAndVars, Set_pa ZonesToRead, VarLoadMode_e VarLoadMode, Set_pa VarPositionList, StringList_pa VarNameList, LgIndex_t ISkip, LgIndex_t JSkip, LgIndex_t KSkip)
  Read one or more data files into Tecplot to form a new data set in the current frame.
Boolean_t TecUtilDataSetWriteX (ArgList_pa ArgList)
  Write the specified components of the current frame's data set to a file.
Boolean_t TecUtilWriteDataSet (const char *FName, Boolean_t IncludeText, Boolean_t IncludeGeom, Boolean_t IncludeCustomLabels, Boolean_t IncludeData, Set_pa ZonesToWrite, Set_pa VarsToWrite, Boolean_t WriteBinary, Boolean_t UsePointFormat, SmInteger_t AsciiPrecision)
  Write the data set attached to the current frame to a file.
void TecUtilTecForeign (LgIndex_t *OutputForeignByteOrder)
  Sets the byte ordering request for subsequent calls to TecUtilTecIni().
LgIndex_t TecUtilTecIni (const char *Title, const char *Variables, const char *FName, const char *ScratchDir, LgIndex_t *Debug, LgIndex_t *VIsDouble)
  Initializes the process of writing a binary data file.
LgIndex_t TecUtilTecIniX (ArgList_pa ArgList)
  Initializes the process of writing a binary data file.
LgIndex_t TecUtilTecZne (const char *ZoneTitle, LgIndex_t *IMx, LgIndex_t *JMx, LgIndex_t *KMx, const char *ZFormat, const char *DupList)
  Writes header information about the next zone to be added to the data file.
LgIndex_t TecUtilTecZneX (ArgList_pa ArgList)
  Writes the zone to the data file.
LgIndex_t TecUtilTecDat (LgIndex_t *N, void *FieldData_Array, LgIndex_t *IsDouble)
  Writes an array of data to the data file.
LgIndex_t TecUtilTecNod (LgIndex_t *NData_Array)
  Writes an array of node data to the binary data file.
LgIndex_t TecUtilTecEnd (void)
  Must be called to close out the current data file.
LgIndex_t TecUtilTecLab (const char *S)
  Write a set of custom labels to the data file.
LgIndex_t TecUtilTecUsr (const char *S)
  Add a user-defined record, in the form of a character string, to the Tecplot data file.
LgIndex_t TecUtilTecFil (LgIndex_t *F)
  Switch output context to a different file.
LgIndex_t TecUtilTecTxt (double *XPos, double *YPos, LgIndex_t *PosCoordMode, LgIndex_t *AttachToZone, LgIndex_t *Zone, LgIndex_t *Font, LgIndex_t *FontHeightUnits, double *FontHeight, LgIndex_t *BoxType, double *BoxMargin, double *BoxLineThickness, LgIndex_t *BoxColor, LgIndex_t *BoxFillColor, double *Angle, LgIndex_t *Anchor, double *LineSpacing, LgIndex_t *TextColor, LgIndex_t *Scope, const char *Text, const char *MacroFunctionCommand)
  Write a text label to a binary tecplot data file.
LgIndex_t TecUtilTecTxtX (ArgList_pa ArgList)
  Writes the text item to the data file.
LgIndex_t TecUtilTecGeo (double *XPos, double *YPos, double *ZPos, LgIndex_t *PosCoordMode, LgIndex_t *AttachToZone, LgIndex_t *Zone, LgIndex_t *Color, LgIndex_t *FillColor, LgIndex_t *IsFilled, LgIndex_t *GeomType, LgIndex_t *LinePattern, double *PatternLength, double *LineThickness, LgIndex_t *NumEllipsePts, LgIndex_t *ArrowheadStyle, LgIndex_t *ArrowheadAttachment, double *ArrowheadSize, double *ArrowheadAngle, LgIndex_t *Scope, LgIndex_t *NumSegments, LgIndex_t *NumSegPts, float *XGeomData, float *YGeomData, float *ZGeomData, const char *MacroFunctionCommand)
  Write a geometry to a binary tecplot datafile.
LgIndex_t TecUtilTecGeoX (ArgList_pa ArgList)
  Writes the geometry item to the data file.
LgIndex_t TecUtilTecAux (char *Name, char *Value)
  Writes the name/value data set auxiliary data pair to the data file.
LgIndex_t TecUtilTecZAux (char *Name, char *Value)
  Writes the name/value zone auxiliary data pair to the data file.
LgIndex_t TecUtilTecVAux (LgIndex_t *Var, char *Name, char *Value)
  Writes the name/value variable auxiliary data pair to the data file.
LgIndex_t TecUtilTecFace (LgIndex_t *FaceConnections)
  Writes the face neighbor connections to the data file.
LgIndex_t TecUtilTecPoly (LgIndex_t *FaceNodeCounts, LgIndex_t *FaceNodes, LgIndex_t *FaceLeftElems, LgIndex_t *FaceRightElems, LgIndex_t *FaceBndryConnectionCounts, LgIndex_t *FaceBndryConnectionElems, SmInteger_t *FaceBndryConnectionZones)
 

Function Documentation

Boolean_t TecUtilDataSetWriteX ( ArgList_pa  ArgList  ) 

Write the specified components of the current frame's data set to a file.

Parameters:
ArgList Set of Arglist entries. This is built using calls to TecUtilArgListAppendXXXX functions.

Arglist Values

SV_FNAME
Type: char *
Arg Function: TecUtilArgListAppendString()
Required: Yes
Notes: Name of the data file to write.

SV_INCLUDETEXT
Type: Boolean_t
Arg Function: TecUtilArgListAppendInt()
Default: TRUE
Required: No
Notes: Set to TRUE to write any text, geometries, or custom labels to the data files.

SV_INCLUDEGEOM
Type: Boolean_t
Arg Function: TecUtilArgListAppendInt()
Default: TRUE
Required: No

SV_INCLUDEDATA
Type: Boolean_t
Arg Function: TecUtilArgListAppendInt()
Default: TRUE
Required: No
Notes: Set to TRUE to write the data to the data files. Set to FALSE to only write text and geometries, depending on SV_INCLUDETEXT and SV_INCLUDEGEOM

SV_INCLUDEDATASHARELINKAGE
Type: Boolean_t
Arg Function: TecUtilArgListAppendInt()
Default: TRUE
Required: No
Notes: Set to TRUE to conserve space and write the variable and connectivity linkage to the data file wherever possible. Set to FALSE to write all the data to the data file and loose the variable and connectivity sharing linkage for future dataset reads of the file.

SV_INCLUDEAUTOGENFACENEIGHBORS
Type: Boolean_t
Arg Function: TecUtilArgListAppendInt()
Default: FALSE
Required: No
Notes: Set to TRUE to save the face neighbor connectivity to the data file. This may produce very large data files.

SV_USEPOINTFORMAT
Type: Boolean_t
Arg Function: TecUtilArgListAppendInt()
Default: FALSE
Required: No
Notes: Set to TRUE to write the data file in point format and FALSE for block format.

SV_BINARY
Type: Boolean_t
Arg Function: TecUtilArgListAppendInt()
Default: TRUE
Required: No
Notes: Set to TRUE to write the data in binary format and FALSE for ASCII.

SV_ASSOCIATELAYOUTWITHDATAFILE
Type: Boolean_t
Arg Function: TecUtilArgListAppendInt()
Default: TRUE
Required: No
Notes: Set to TRUE to assoicate this data file with the current layout. Set to FALSE to write the datafile without modifying Tecplot's current data file to layout association.

SV_ZONELIST
Type: Set_pa
Arg Function: TecUtilArgListAppendSet()
Default: NULL
Required: No
Notes: Set of zones to write to the data file. Use NULL to write all zones.

SV_VARLIST
Type: Set_pa
Arg Function: TecUtilArgListAppendSet()
Default: NULL
Required: No
Notes: Set of variables to write to the data file. Use NULL to write all variables.


Returns:
TRUE if the input parameters are valid and the data was successfully written, FALSE otherwise.
Fortran Syntax:
    INTEGER*4 FUNCTION TecUtilDataSetWriteX(ArgListPtr)
    POINTER (ArgListPtr, ArgList)

Python Syntax:

  Results = TecUtil.DataSetWriteX(ArgList)

  Input:
                  ArgList              dictionary
  Output:
    Results[0]    ReturnVal            boolean

Boolean_t TecUtilReadDataSet ( ReadDataOption_e  ReadDataOption,
Boolean_t  ResetStyle,
StringList_pa  FileNamesOrInstructions,
const char *  DataSetReader,
PlotType_e  InitialPlotType,
Boolean_t  IncludeText,
Boolean_t  IncludeGeom,
Boolean_t  IncludeCustomLabels,
Boolean_t  IncludeData,
Boolean_t  CollapseZonesAndVars,
Set_pa  ZonesToRead,
VarLoadMode_e  VarLoadMode,
Set_pa  VarPositionList,
StringList_pa  VarNameList,
LgIndex_t  ISkip,
LgIndex_t  JSkip,
LgIndex_t  KSkip 
)

Read one or more data files into Tecplot to form a new data set in the current frame.

Parameters:
ReadDataOption Determine how to handle the situation where a data set already exists in the current frame. The possible values are: ReadDataOption_NewData (Remove the data set from the current frame before loading the new data set), ReadDataOption_AppendData (Append the new data to the current data set), and ReadDataOption_ReplaceData (Replace the data set in the current frame and in all frames which share the data set with the new data).
ResetStyle TRUE if you want to reset the style of the current frame, FALSE if you want to keep the same style. Only used if ReadDataOption is ReadDataOption_NewData or ReadDataOption_ReplaceData.FileNamesOr
FileNamesOrInstructions A string list containing the file names to load or the instructions to send to the data set reader (converter or loader)
DataSetReader Name of the data set reader (converter or loader). To let Tecplot load the data, use "TECPLOT."
InitialPlotType Initial PlotType for the data. Only used if ResetStyle is TRUE. To have Tecplot determine the most appropriate frame mode for the data, use Frame_Empty. The possible values are: PlotType_Automatic: PlotType_Cartesian3D, PlotType_Cartesian2D, PlotType_XYLine, PlotType_PolarLine, and PlotType_Sketch. PlotType_Automatic instructs Tecplot to choose the best frame mode.
IncludeText Set to TRUE to load any text in the data files.
IncludeGeom Set to TRUE to load any geometries in the data files.
IncludeCustomLabels Set to TRUE to load any custom labels in the data files
IncludeData Set to TRUE to load the data from the data files. Set to FALSE to only load text, geometries and/or custom labels, depending on IncludeText, IncludeGeom, and IncludeCustomLabels
CollapseZonesAndVars Set to TRUE to renumber zones and variables if any are disabled. For more information on collapsing zones and variables, see Section 5.1.1.7, "Zone and Variable List Collapsing," in the Tecplot User's Manual
ZonesToRead Set of zones to load from the data files. Use NULL to load all zones
VarLoadMode Choose to load variables by name or by their position in the data file. See Section 5.1.1.6, "Variable Loading by Position," in the Tecplot User's Manual for more information about loading variables by name or by position. If ReadDataOption is ReadDataOption_AppendData, this must be same as the mode of the data set in the current frame. Use TecUtilDataSetGetVarLoadMode() to get this information. The possible values are: VarLoadMode_ByName and VarLoadMode_ByPosition.
VarPositionList Set of variables to load from the data files. Use NULL to load all variables. Ignored if VarLoadMode is VarLoadMode_ByName
VarNameList Set of variable names to load from the data files. Use NULL to load only variable names common to all data files. Must be NULL if VarLoadMode is VarLoadMode_ByPosition. When appending to the existing data set you must supply a new VarNameList where the new VarNameList is a superset of the existing one. A VarNameList that is a superset is one that contains all the variable names currently in use Tecplot. They must be in the same position. You can add new names either at the end of the list, or as aliases in the already established positions. Use a newline character to separate aliased names.If you do not create a VarNameList that is a superset then it is indeterminant which variable is in which position for the original data
ISkip Set to 1 to load every data point in the I-direction; 2 to load every other data point, and so forth.
JSkip Same as ISkip but for J-direction.
KSkip Same as ISkip but for K-direction.
Returns:
TRUE if the input parameters are valid and the data was successfully loaded, FALSE otherwise.
Fortran Syntax:
    INTEGER*4 FUNCTION TecUtilReadDataSet(
   &                   ReadDataOption,
   &                   ResetStyle,
   &                   FileNamesOrInstructionsPtr,
   &                   DataSetReader,
   &                   InitialPlotType,
   &                   IncludeText,
   &                   IncludeGeom,
   &                   IncludeCustomLabels,
   &                   IncludeData,
   &                   CollapseZonesAndVars,
   &                   ZonesToReadPtr,
   &                   VarLoadMode,
   &                   VarPositionListPtr,
   &                   VarNameListPtr,
   &                   ISkip,
   &                   JSkip,
   &                   KSkip)
    INTEGER*4       ReadDataOption
    INTEGER*4       ResetStyle
    POINTER         (FileNamesOrInstructionsPtr, FileNamesOrInstructions)
    CHARACTER*(*)   DataSetReader
    INTEGER*4       InitialPlotType
    INTEGER*4       IncludeText
    INTEGER*4       IncludeGeom
    INTEGER*4       IncludeCustomLabels
    INTEGER*4       IncludeData
    INTEGER*4       CollapseZonesAndVars
    POINTER         (ZonesToReadPtr, ZonesToRead)
    INTEGER*4       VarLoadMode
    POINTER         (VarPositionListPtr, VarPositionList)
    POINTER         (VarNameListPtr, VarNameList)
    INTEGER*4       ISkip
    INTEGER*4       JSkip
    INTEGER*4       KSkip

Python Syntax:

  Results = TecUtil.ReadDataSet(ReadDataOption, ResetStyle, FileNamesOrInstructions, DataSetReader, InitialPlotType, IncludeText, IncludeGeom, IncludeCustomLabels, IncludeData, CollapseZonesAndVars, ZonesToRead, VarLoadMode, VarPositionList, VarNameList, ISkip, JSkip, KSkip)

  Input:
                  ReadDataOption       ReadDataOption_e  (defined in TecVals.py)
                  ResetStyle           boolean
                  FileNamesOrInstructions sequence of strings
                  DataSetReader        string
                  InitialPlotType      PlotType_e  (defined in TecVals.py)
                  IncludeText          boolean
                  IncludeGeom          boolean
                  IncludeCustomLabels  boolean
                  IncludeData          boolean
                  CollapseZonesAndVars boolean
                  ZonesToRead          sequence of ints
                  VarLoadMode          VarLoadMode_e  (defined in TecVals.py)
                  VarPositionList      sequence of ints
                  VarNameList          sequence of strings
                  ISkip                int
                  JSkip                int
                  KSkip                int
  Output:
    Results[0]    ReturnVal            boolean

Good: Var names currently in Tecplot = "A" "B" "C" VarNameList is appended to read = "A" "B\nR" "C" "D"

Bad: Var names currently in Tecplot = "A" "B" "C" VarNameList is appended to read "A" "C" "B" "D"

In the good example the integrity of the original data is always maintained, that is, the new VarNameList works for the original data as well as the new data. Variable 2 can be either "B" or "R".

In the bad example, the new VarNameList states that variable 2 must contain "C" but "C" has already been assigned to variable 3 with the original data. Keep in mind that once variables are in Tecplot all style assignements are made based on variable position and not by name. Thus the variable positioning is important.

   StringList_pa FileNames, VarNames;
   FileNames = TecUtilStringListAlloc();
   TecUtilStringListAppendString(FileNames, "file1.plt");
   TecUtilStringListAppendString(FileNames, "file2.plt");
   VarNames  = TecUtilStringListAlloc();
   TecUtilStringListAppendString(VarNames,  "X");
   TecUtilStringListAppendString(VarNames,  "Y");
   TecUtilStringListAppendString(VarNames,  "P\nPress");
   IsOk = TecUtilReadDataSet(ReadDataOption_NewData,
                             TRUE,
                             FileNames,
                             "TECPLOT",
                             PlotType_Automatic,
                             TRUE, TRUE, TRUE, TRUE,
                             FALSE,
                             (Set_pa)NULL,
                             VarLoadMode_ByName,
                             (Set_pa)NULL,
                             VarNames,
                             1, 1, 1))
   TecUtilStringListDealloc(&FileNames);
   TecUtilStringListDealloc(&VarNames);

Read a data set consisting of file1.plt and file2.plt. Load the variables named "X", "Y", and either "P" or "Press."

   StringList_pa FileNames, VarNames;
   FileNames = TecUtilStringListAlloc();
   TecUtilStringListAppendString(FileNames, "file1.plt");
   TecUtilStringListAppendString(FileNames, "file2.plt");
   VarNames  = TecUtilStringListAlloc();
   TecUtilStringListAppendString(VarNames,  "X");
   TecUtilStringListAppendString(VarNames,  "Y");
   TecUtilStringListAppendString(VarNames,  "P\nPress");
   IsOk = TecUtilReadDataSet(ReadDataOption_NewData,
                             TRUE,
                             FileNames,
                             "TECPLOT",
                             PlotType_Automatic,
                             TRUE, TRUE, TRUE, TRUE,
                             FALSE,
                             (Set_pa)NULL,
                             VarLoadMode_ByName,
                             (Set_pa)NULL,
                             VarNames,
                             1, 1, 1))
   TecUtilStringListDealloc(&FileNames);
   TecUtilStringListDealloc(&VarNames);

LgIndex_t TecUtilTecAux ( char *  Name,
char *  Value 
)

Writes the name/value data set auxiliary data pair to the data file.

Parameters:
Name Name of the data set auxiliary item
Value The value associates with the named data set auxiliary data item
Returns:
0 if successful, -1 if unsuccessful.
Fortran Syntax:
    INTEGER*4 FUNCTION TecUtilTecAux(
   &                   Name,
   &                   Value)
    CHARACTER*(*)   Name
    CHARACTER*(*)   Value

Python Syntax:

  Results = TecUtil.TecAux(Name, Value)

  Input:
                  Name                 string
                  Value                string
  Output:
    Results[0]    ReturnVal            int

LgIndex_t TecUtilTecDat ( LgIndex_t N,
void *  FieldData_Array,
LgIndex_t IsDouble 
)

Writes an array of data to the data file.

If the ZoneFormat specified in TecUtilTecZneX() or TecUtilTecZne() is BLOCK, the array must be dimensioned (IMax, JMax, KMax, NumVars) (FORTRAN syntax, where the first element moves the fastest).

If the ZoneFormat is POINT, the data must be dimensioned (NumVars, IMax, JMax, KMax).

If the ZoneFormat is FEBLOCK, then the data must be dimensioned (NumPts, NumVars).

If the ZoneFormat is FEPOINT, then the data must be dimensioned (NumVars,NumPts).

TecUtilTecDat() allows you to write your data in a piecemeal fashion in case it is not contained in one contiguous block in your program. Enough calls to TECDAT must be made that the correct number of values are written for each zone and that the aggregate order for the data is correct.

In the above summary, NumVars is based on the number of variable names supplied in a previous call to TecUtilTecIni() or TecUtilTecIniX().

Parameters:
N Handle to an integer value specifying number of values to write
FieldData_Array Array of single or double precision data values
IsDouble Handle to the integer flag stating whether the array Data is single (0) or double (1) precision.
Returns:
0 if successful, -1 if unsuccessful.
Fortran Syntax:
    INTEGER*4 FUNCTION TecUtilTecDat(
   &                   N,
   &                   FieldData_Array,
   &                   IsDouble)
    INTEGER*4       N
    POINTER         (FieldData_ArrayPtr, FieldData_Array)
    INTEGER*4       IsDouble

Python Syntax:

    This function is not supported in Python.

LgIndex_t TecUtilTecEnd ( void   ) 

Must be called to close out the current data file.

There must be a corresponding TecUtilTecEnd() for each TecUtilTecIni() or TecUtilTecIniX().

Returns:
0 if successful, -1 if unsuccessful.
Fortran Syntax:
    INTEGER*4 FUNCTION TecUtilTecEnd()

Python Syntax:

  Results = TecUtil.TecEnd()

  Output:
    Results[0]    ReturnVal            int

LgIndex_t TecUtilTecFace ( LgIndex_t FaceConnections  ) 

Writes the face neighbor connections to the data file.

For polygonal and polyhedral zones, use TecUtilTecPoly().

Parameters:
FaceConnections Array of face connections dimensioned by the number of face neighbor connections (supplied in the call to TecUtilTecZneX()) multiplied by the number of values needed for each connection. See the ADK reference manual for details.
Returns:
0 if successful, -1 if unsuccessful.
Fortran Syntax:
    INTEGER*4 FUNCTION TecUtilTecFace(FaceConnections)
    INTEGER*4 FaceConnections

Python Syntax:

  Results = TecUtil.TecFace(FaceConnections)

  Input:
                  FaceConnections      list of ints
  Output:
    Results[0]    ReturnVal            int

LgIndex_t TecUtilTecFil ( LgIndex_t F  ) 

Switch output context to a different file.

Each time TecUtilTecIni() or TecUtilTecIniX() iscalled, a new file "context" is switched to. This allows you to write multiple data files at the same time.

Parameters:
F Handle to integer specifying file number to switch to
Returns:
0 if successful, -1 if unsuccessful.
Fortran Syntax:
    INTEGER*4 FUNCTION TecUtilTecFil(F)
    INTEGER*4 F

Python Syntax:

  Results = TecUtil.TecFil(F)

  Input:
                  F                    list of ints
  Output:
    Results[0]    ReturnVal            int

void TecUtilTecForeign ( LgIndex_t OutputForeignByteOrder  ) 

Sets the byte ordering request for subsequent calls to TecUtilTecIni().

The byte ordering request will remain in effect until changed by another call to this function. Calling this function after a call to TecUtilTecIni() has no effect on any files opened by previous calls to TecUtilTecIni() and only effects future files created by TecUtilTecIni().

Since:
10.0-3-129
Parameters:
OutputForeignByteOrder Reference to a boolean value indicating if subsequent calls to TecUtilTecIni() should create files with foreign or native byte ordering.
Fortran Syntax:
    SUBROUTINE TecUtilTecForeign(
   &                   OutputForeignByteOrder)
    INTEGER*4       OutputForeignByteOrder

Python Syntax:

  Results = TecUtil.TecForeign(OutputForeignByteOrder)

  Input:
                  OutputForeignByteOrder list of ints
  Output:
    Results[0]    ReturnVal            NONE

LgIndex_t TecUtilTecGeo ( double *  XPos,
double *  YPos,
double *  ZPos,
LgIndex_t PosCoordMode,
LgIndex_t AttachToZone,
LgIndex_t Zone,
LgIndex_t Color,
LgIndex_t FillColor,
LgIndex_t IsFilled,
LgIndex_t GeomType,
LgIndex_t LinePattern,
double *  PatternLength,
double *  LineThickness,
LgIndex_t NumEllipsePts,
LgIndex_t ArrowheadStyle,
LgIndex_t ArrowheadAttachment,
double *  ArrowheadSize,
double *  ArrowheadAngle,
LgIndex_t Scope,
LgIndex_t NumSegments,
LgIndex_t NumSegPts,
float *  XGeomData,
float *  YGeomData,
float *  ZGeomData,
const char *  MacroFunctionCommand 
)

Write a geometry to a binary tecplot datafile.

This function mimicks the TecGeo function that is part of the TecIO library.

Parameters:
MacroFunctionCommand Macro command to execute when user cntrl-clicks on the geometry. Set to NULL to not use
XPos X-Anchor position of the geometry
YPos Y-Anchor position of the geometry
ZPos Z-Anchor position of the geometry
PosCoordMode Position coordinate mode of the geometry. Zero=Grid, 1=Frame, 6=Grid3D
AttachToZone Flag specifying whether or not to attach the geometry to a zone. Zero=Attach, one=Don't attach
Zone Zone to attach to
Color Color of the geometry. (0-63)
FillColor Fill Color of the geometry. (0-63)
IsFilled Flag specifying whether or not to fill the geometry. 1=Fill Zero=Don't fill
GeomType Type of geometry. Zero=2D line segments, 1=Rectangle, 2=Square, 3=Circle, 4=Ellipse, 5=3D line segments
LinePattern Line pattern. Zero=Solid, 1=Dashed, 2=DashDot, 3=Dotted, 4=LongDash, 5=DashDotDot
PatternLength Line Pattern Length in frame units (0 < L <= 100.0).
LineThickness Line thickness in frame units (0 < L <= 100.0)
NumEllipsePts Number of points to use to draw ellipses or circles
ArrowheadStyle Style of arrowhead. Zero=Plain, 1=Filled, 2=Hollow
ArrowheadAttachment How to attach the arrowhead(s). Zero=None, 1=Beginning, 2=End, 3=Both.
ArrowheadSize Size of the arrowhead in frame units
ArrowheadAngle Angle of the arrowhead in degrees
Scope Scope for the geometry. Zero=Global, 1=Local
NumSegments Number of polyline segments in the geometry
NumSegPts Array of the number of points in each polyline segment
XGeomData Array of X-values for the geometry
YGeomData Array of Y-values for the geometry
ZGeomData Array of Z-values for the geometry
Returns:
Returns 0 if successful, -1 if not.
Fortran Syntax:
    INTEGER*4 FUNCTION TecUtilTecGeo(
   &                   XPos,
   &                   YPos,
   &                   ZPos,
   &                   PosCoordMode,
   &                   AttachToZone,
   &                   Zone,
   &                   Color,
   &                   FillColor,
   &                   IsFilled,
   &                   GeomType,
   &                   LinePattern,
   &                   PatternLength,
   &                   LineThickness,
   &                   NumEllipsePts,
   &                   ArrowheadStyle,
   &                   ArrowheadAttachment,
   &                   ArrowheadSize,
   &                   ArrowheadAngle,
   &                   Scope,
   &                   NumSegments,
   &                   NumSegPts,
   &                   XGeomData,
   &                   YGeomData,
   &                   ZGeomData,
   &                   MacroFunctionCommand)
    REAL*8          XPos
    REAL*8          YPos
    REAL*8          ZPos
    INTEGER*4       PosCoordMode
    INTEGER*4       AttachToZone
    INTEGER*4       Zone
    INTEGER*4       Color
    INTEGER*4       FillColor
    INTEGER*4       IsFilled
    INTEGER*4       GeomType
    INTEGER*4       LinePattern
    REAL*8          PatternLength
    REAL*8          LineThickness
    INTEGER*4       NumEllipsePts
    INTEGER*4       ArrowheadStyle
    INTEGER*4       ArrowheadAttachment
    REAL*8          ArrowheadSize
    REAL*8          ArrowheadAngle
    INTEGER*4       Scope
    INTEGER*4       NumSegments
    INTEGER*4       NumSegPts
    REAL*4          XGeomData
    REAL*4          YGeomData
    REAL*4          ZGeomData
    CHARACTER*(*)   MacroFunctionCommand

Python Syntax:

  Results = TecUtil.TecGeo(XPos, YPos, ZPos, PosCoordMode, AttachToZone, Zone, Color, FillColor, IsFilled, GeomType, LinePattern, PatternLength, LineThickness, NumEllipsePts, ArrowheadStyle, ArrowheadAttachment, ArrowheadSize, ArrowheadAngle, Scope, NumSegments, NumSegPts, XGeomData, YGeomData, ZGeomData, MacroFunctionCommand)

  Input:
                  XPos                 list of doubles
                  YPos                 list of doubles
                  ZPos                 list of doubles
                  PosCoordMode         list of ints
                  AttachToZone         list of ints
                  Zone                 list of ints
                  Color                list of ints
                  FillColor            list of ints
                  IsFilled             list of ints
                  GeomType             list of ints
                  LinePattern          list of ints
                  PatternLength        list of doubles
                  LineThickness        list of doubles
                  NumEllipsePts        list of ints
                  ArrowheadStyle       list of ints
                  ArrowheadAttachment  list of ints
                  ArrowheadSize        list of doubles
                  ArrowheadAngle       list of doubles
                  Scope                list of ints
                  NumSegments          list of ints
                  NumSegPts            list of ints
                  XGeomData            list of doubles
                  YGeomData            list of doubles
                  ZGeomData            list of doubles
                  MacroFunctionCommand string
  Output:
    Results[0]    ReturnVal            int

LgIndex_t TecUtilTecGeoX ( ArgList_pa  ArgList  ) 

Writes the geometry item to the data file.

Parameters:
ArgList Set of Arglist entries. This is built using calls to TecUtilArgListAppendXXXX functions.

Arglist Values

SV_GEOMTYPE
Type: GeomType_e
Arg Function: TecUtilArgListAppendInt()
Required: Yes
Notes: Geometry type may have any of the following values: GeomType_LineSegs, GeomType_Rectangle, GeomType_Square, GeomType_Circle, GeomType_Ellipse, GeomType_LineSegs3D,

SV_NUMGEOSEGMENTS
Type: LgIndex_t
Arg Function: TecUtilArgListAppendInt()
Required: Yes
Notes: Only applies to a geometry of type GeomType_LineSegs and is the number of geometry line segments. The value must be greater than or equal to 1

SV_NUMSEGPTS
Type: LgIndex_t *
Arg Function: TecUtilArgListAppendArray()
Required: Yes
Notes: Only applies to a geometry of type GeomType_LineSegs and is an array dimensioned by the number of geometry segments where each member of the array holds the number of points defining each geometry segment

SV_ARROWHEADSTYLE
Type: ArrowheadStyle_e
Arg Function: TecUtilArgListAppendInt()
Default: Arrowhead_Plain
Required: No
Notes: Only applies to a geometry of type GeomType_LineSegs and is the arrowhead style may have any of the following values: Arrowhead_Plain, Arrowhead_Filled, Arrowhead_Hollow.

SV_ARROHEADATTACHMENT
Type: ArroheadAttachment_e
Arg Function: TecUtilArgListAppendInt()
Default: ArrowheadAttach_None
Required: No
Notes: Only applies to a geometry of type GeomType_LineSegs and is the arrowhead attachment may have any of the following values: ArrowheadAttach_None, ArrowheadAttach_AtBeginning, ArrowheadAttach_AtEnd, ArrowheadAttach_AtBothEnds,

SV_ARROWHEADSIZE
Type: double
Arg Function: TecUtilArgListAppendDouble()
Default: 5.0
Required: No
Notes: Only applies to a geometry of type GeomType_LineSegs and is the arrowhead size if assigned. The value must be greater than or equal to zero and less than or equal to 50

SV_ARROWHEADANGLE
Type: double
Arg Function: TecUtilArgListAppendDouble()
Default: 12.0
Required: No
Notes: Only applies to a geometry of type GeomType_LineSegs and is the arrowhead angle must be greater than or equal to 1 and less than or equal to 90

SV_NUMELLIPSEPTS
Type: LgIndex_t
Arg Function: TecUtilArgListAppendInt()
Default: 72.0
Required: No
Notes: Only applies to a geometry of type GeomType_Ellipse and is the number of points used to define an ellipse. The value must be greater than or equal to 3 and less than or equal to 720

SV_XGEOMDATA
Type: float *
Arg Function: TecUtilArgListAppendArray()
Required: Yes
Notes: Floating point arrays containing the point data for the specific geometry

SV_YGEOMDATA
Type: float *
Arg Function: TecUtilArgListAppendArray()
Required: Yes

SV_ZGEOMDATA
Type: float *
Arg Function: TecUtilArgListAppendArray()
Required: Yes

SV_XPOS
Type: double
Arg Function: TecUtilArgListAppendDouble()
Default: 0.0
Required: No
Notes: Anchor position for the geometry

SV_YPOS
Type: double
Arg Function: TecUtilArgListAppendDouble()
Default: 0.0
Required: No

SV_ZPOS
Type: double
Arg Function: TecUtilArgListAppendDouble()
Default: 0.0
Required: No

SV_POSITIONCOORDSYS
Type: CoordSys_e
Arg Function: TecUtilArgListAppendInt()
Default: CoordSys_Grid
Required: No
Notes: Coordinate system to which the geometry belongs and may have any of the following values: CoordSys_Grid, CoordSys_Frame, CoordSys_Grid3D,

SV_ATTACHTOZONE
Type: Boolean_t
Arg Function: TecUtilArgListAppendInt()
Default: FALSE
Required: No
Notes: A value of TRUE indicates that the geometry is attached to the specified zone or map. A value of FALSE indicates that the geometry is not attached to a specific zone or map

SV_ZONE
Type: EntIndex_t
Arg Function: TecUtilArgListAppendInt()
Default: 1
Required: No
Notes: Zone or map number to which the geometry is attached

SV_COLOR
Type: ColorIndex_t
Arg Function: TecUtilArgListAppendInt()
Default: Black_C
Required: No
Notes: Line color for the geometry may be a value greater than or equal to zero

SV_FILLCOLOR
Type: ColorIndex_t
Arg Function: TecUtilArgListAppendInt()
Default: White_C
Required: No
Notes: Fill color for the geometry may be a value greater than or equal to zero

SV_ISFILLED
Type: Boolean_t
Arg Function: TecUtilArgListAppendInt()
Default: FALSE
Required: No
Notes: If applicable a value of TRUE indicates the geometry is filled.

SV_LINEPATTERN
Type: LinePattern_e
Arg Function: TecUtilArgListAppendInt()
Default: LinePattern_Solid
Required: No
Notes: Line pattern to use for the drawing the lines and may have any ofthe following values: LinePattern_Solid, LinePattern_Dashed, LinePattern_DashDot, LinePattern_Dotted, LinePattern_LongDash, LinePattern_DashDotDot.

SV_PATTERNLENGTH
Type: double
Arg Function: TecUtilArgListAppendDouble()
Default: 2.0
Required: No
Notes: Pattern length may be a value greater than or equal to zero and less than or equal to 100

SV_LINETHICKNESS
Type: double
Arg Function: TecUtilArgListAppendDouble()
Default: 0.1
Required: No
Notes: Line thickness may be a value greater than or equal to zero and less than or equal to 100

SV_SCOPE
Type: Scope_e
Arg Function: TecUtilArgListAppendInt()
Default: Scope_Local
Required: No
Notes: A geometry with local scope is displayed only in the frame in which it is created. If the geometry is defined as having global scope it will appear in all "like" frames, that is, those frames using the same data set as the one in which the geometry was created. Scope may be either Scope_Global or Scope_Local.

SV_CLIPPING
Type: Clipping_e
Arg Function: TecUtilArgListAppendInt()
Default: Clipping_ClipToViewport
Required: No
Notes: Clipping applied to the geometry may be either Clipping_ClipToViewport or Clipping_ClipToFrame.

SV_MACROFUNCTIONCOMMAND
Type: char *
Arg Function: TecUtilArgListAppendString()
Default: NULL
Required: No
Notes: Macro function command associated with the geometry


Returns:
0 if successful, -1 if unsuccessful.
Fortran Syntax:
    INTEGER*4 FUNCTION TecUtilTecGeoX(ArgListPtr)
    POINTER (ArgListPtr, ArgList)

Python Syntax:

  Results = TecUtil.TecGeoX(ArgList)

  Input:
                  ArgList              dictionary
  Output:
    Results[0]    ReturnVal            int

LgIndex_t TecUtilTecIni ( const char *  Title,
const char *  Variables,
const char *  FName,
const char *  ScratchDir,
LgIndex_t Debug,
LgIndex_t VIsDouble 
)

Initializes the process of writing a binary data file.

This must be called first before any other TecUtilTecXxx calls are made. You may write to multiple files by calling TecUtilTecIni() more than once. Each time TecUtilTecIni() is called, a new file is opened. Use TecUtilTecFil() to switch between files.

Parameters:
Title Title of the data set. Must be NULL terminated
Variables List of variable names. Separate variable names with a newline, comma or space. If a newline is detected anywhere in the string it is used as the separator otherwise if a comma is detected then the comma is the separator otherwise a space is used. The string must be NULL terminated
FName Name of the file to create. Must be NULL terminated
ScratchDir Name of the directory to put the scratch file. Must be NULL terminated
Debug Handle to the integer flag for debugging. Set to 0 for no debugging or 1 to debug
VIsDouble Handle to the integer flag for specifying whether field data generated in future calls to TecUtilTecIni() are to be written in single or double precision. Set to 0 for single precision or 1 for double
Returns:
0 if successful, -1 if unsuccessful.
Fortran Syntax:
    INTEGER*4 FUNCTION TecUtilTecIni(
   &                   Title,
   &                   Variables,
   &                   FName,
   &                   ScratchDir,
   &                   Debug,
   &                   VIsDouble)
    CHARACTER*(*)   Title
    CHARACTER*(*)   Variables
    CHARACTER*(*)   FName
    CHARACTER*(*)   ScratchDir
    INTEGER*4       FileType
    INTEGER*4       Debug
    INTEGER*4       VIsDouble

Python Syntax:

  Results = TecUtil.TecIni(Title, Variables, FName, ScratchDir, Debug, VIsDouble)

  Input:
                  Title                string
                  Variables            string
                  FName                string
                  ScratchDir           string
                  Debug                list of ints
                  VIsDouble            list of ints
  Output:
    Results[0]    ReturnVal            int

LgIndex_t TecUtilTecIniX ( ArgList_pa  ArgList  ) 

Initializes the process of writing a binary data file.

This must be called first before any other TecUtilTecXxx calls are made. You may write to multiple files by calling TecUtilTecIniX() more than once. Each time TecUtilTecIniX() is called, a new file is opened. Use TecUtilTecFil() to switch between files.

Parameters:
ArgList Set of Arglist entries. This is built using calls to TecUtilArgListAppendXXXX functions.

Arglist Values

SV_DATASETTITLE
Type: char *
Arg Function: TecUtilArgListAppendString()
Default: ""
Required: No
Notes: Data set title

SV_VARIABLES
Type: char *
Arg Function: TecUtilArgListAppendString()
Default: ""
Required: No
Notes: Only optional for files with DataFileType_Grid file type. Required for file types DataFileType_Full and DataFileType_Solution. See TecUtilTecIni() for more details

SV_FILENAME
Type: char *
Arg Function: TecUtilArgListAppendString()
Required: Yes
Notes: Name of the file to create. Must be NULL terminated

SV_SCRATCHDIR
Type: char *
Arg Function: TecUtilArgListAppendString()
Default: NULL
Required: No
Notes: Name of the directory to put the scratch file. Must be NULL terminated

SV_DATAFILETYPE
Type: DataFileType_e
Arg Function: TecUtilArgListAppendInt()
Default: DataFileType_Full
Required: No
Notes: Must be set to one of DataFileType_Full, DataFileType_Grid, or DataFileType_Solution. Use DataFileType_Full for a classic Tecplot data file. Use DataFileType_Grid for data files that will share all data with files marked DataFileType_Solution to make complete zones

SV_DEBUG
Type: Boolean_t
Arg Function: TecUtilArgListAppendInt()
Default: FALSE
Required: No
Notes: Handle to the integer flag for debugging. Set to 0 for no debugging or 1 to debug

SV_VISDOUBLE
Type: Boolean_t
Arg Function: TecUtilArgListAppendInt()
Default: FALSE
Required: No
Notes: Handle to the integer flag for specifying whether field data generated in future calls to TecUtilTecIni() or TecUtilTecIniX() are to be written in single or double precision. Set to 0 for single precision or 1 for double.


Returns:
0 if successful, -1 if unsuccessful.
Fortran Syntax:
    INTEGER*4 FUNCTION TecUtilTecIniX(ArgListPtr)
    POINTER (ArgListPtr, ArgList)

Python Syntax:

  Results = TecUtil.TecIniX(ArgList)

  Input:
                  ArgList              dictionary
  Output:
    Results[0]    ReturnVal            int

LgIndex_t TecUt