Home

Tecplot Reference Manual

1. 19 Chapter 4 Macro Command Summary 20 cHaPTERS Macro Commands This chapter lists Tecplot s macro commands alphabetically Items within single angle brackets lt gt are defined in either Chapter 7 Parameter Assignment Values Expressions and Arithmetic and Logical Operators or Chapter 9 Raw Data Items within double angle brackets lt lt gt gt represent parameter sub commands that are listed and described in Chapter 6 Parameter Subcommands ACTIVEFIELDZONES Syntax ACTIVEFIELDZONES lt op gt lt set gt no parameters Description A SetValue command that changes the set of zones considered for plotting Examples Example 1 Make only zones 1 3 4 and 5 active for plotting ACTIVEFIELDZONES 1 3 5 21 Chapter 5 Macro Commands Example 2 Example 3 Syntax Description Examples Example 1 Example 2 Example 3 Syntax Description Example Add zones 33 34 35 and 36 to the set of active zones S ACTIVEFIELDZONES 33 36 Remove zones 1 2 3 9 10 and 11 from the set of active zones ACTIVEFIELDZONES 1 3 9 11 ACTIVELINEMAPS S ACTIVELINEMAPS lt op gt lt set gt no parameters A SetValue command that changes the set of line mappings considered for plotting Make only line mappings 1 3 4 and 5 active for plotting ACTIVELINEMAPS 1 3 5 Add line maps 33 34 35 and 3
2. Example Send the command Go to the add on that has registered a command processor with an add on ID of XPROC ADDONCOMMAND ADDONID XPROC COMMAND GO 23 Chapter 5 Macro Commands Syntax ALTERDATA lt set gt ALTERDATA EQUATION lt string gt optional parameters Description The ALTERDATA function operates on a data set within Tecplot using FORTRAN like equations See 24 2 Data Alteration through Equations in the Tecplot User s Manual for more information on using equations in Tecplot The lt sef gt parameter if specified represents the set of zones on which to operate If lt sef gt is omitted all zones are affected Required Parameter Parameter Syntax Notes EQUATION lt string gt This assigns the equation to use to operate on the data Optional Parameters Parameter Syntax Default Notes IRANGE See the note Range Parameters for information on specifying range index values MIN lt integer gt 1 MAX lt integer gt 0 SKIP lt integer gt I JRANGE See the note Range Parameters for information on specifying range index values MIN lt integer gt 1 MAX lt integer gt 0 SKIP lt integer gt KRANGE See the note Range Parameters for information on specifying range index values MIN lt integer gt 1 MAX lt integer gt 0 SKIP lt integer gt 1 24 Parameter Synt
3. YES RED GLOBALSLICE Syntax GLOBALSLICE optional parameters Description A SetValue command that changes global attributes associated with streamtraces Optional Parameters Parameter Syntax Notes SHOW lt boolean gt SHOWPOSITION2 lt boolean gt SHOWINTERMEDIATESLICES lt boolean gt NUMINTERMEDIATESLICES lt integer gt SLICESURFACE lt slicesurface gt POSITION1 x lt double gt Y lt double gt Z lt double gt I lt integer gt J lt integer gt K lt integer gt 110 Parameter Syntax Notes POSITION2 x lt double gt Y lt double gt Z lt double gt I lt integer gt J lt integer gt K lt integer gt MESH SHOW lt boolean gt COLOR lt color gt LINETHICKNESS lt double gt CONTOUR SHOW lt boolean gt CONTOURTYPE lt contourplottype gt CORNERCELL and AVERAGECELL COLOR lt color gt options not allowed for LINETHICKNESS lt double gt CONTOURTYPE USELIGHTINGEFFECT lt boolean gt FLOODCOLORING lt contourcoloring_e gt Default Group1 LINECONTOURGROUP lt sminteger_t gt Default 1 SHADE SHOW lt boolean gt COLOR lt color gt USELIGHTINGEFFECT lt boolean gt VECTOR SHOW lt boolean gt COLOR lt color gt ISTANGENT lt boolean gt LINETHICKNESS lt double gt VECTORTYPE lt vectorplottype gt ARROWHEADSTYLE lt arrowheadstyle gt 111
4. Parameter Syntax Notes WVAR lt integer gt Variable number for the Z vector component REFVECTOR SHOW lt boolean gt COLOR lt color gt MAGNITUDE lt op gt lt dexp gt LINETHICKNESS lt op gt lt dexp gt ANGLE lt op gt lt dexp gt XYPOS lt lt xy gt gt MAGNITUDELABEL SHOW lt boolean gt TEXTCOLOR lt color gt TEXTSHAPE lt lt textshape gt gt NUMFORMAT lt lt numberformat gt gt OFFSET lt double gt Example This example does the following Makes all vectors be uniform in size 5 percent in Y frame units Makes the arrowheads 0 2 times the size of the stems Turns off the reference vector GLOBALTHREEDVECTOR USERELATIVE FALSE UNIFORMLENGTH 5 HEADSIZEASFRACTION 2 REFVECTOR SHOW FALSE GLOBALTWODVECTOR Syntax GLOBALTWODVECTOR optional parameters Description A SetValue command that changes global attributes associated with 2 D vector plots 117 Chapter 5 Macro Commands Optional Parameters Parameter Syntax Notes RELATIVELENGTH lt op gt lt dexp gt UNIFORMLENGTH lt op gt lt dexp gt Value is in Y frame units USERELATIVE lt boolean gt If FALSE vectors are all the same size UNIFORM LENGTH RELATIVELENGTHINGRIDUNITS lt boolean gt If TRUE and USERELATIVE is TRUE then vectors are sized in Grid Units Magnitude If FALSE and USERELATIVE is TRUE then vectors are sized in
5. Parameter Syntax Notes ZONE lt integer gt Zone must be greater than or equal to one Example GETZONETYPE ZONETYPE Syntax Description ZONE 1 IF ZONETYPE FETRIANGLE PAUSE The zone is FE Triangle ENDIF GLOBALCONTOUR GLOBALCONTOUR lt contourgroup gt optional parameters A SetValue command that changes global attributes associated with contour plots or contour levels lt contourgroup gt refers to the defined contour groups C1 C4 allowed in Tecplot and takes an integer value of one through four The lt contourgroup gt parameter is optional and if omitted C1 will be treated as current The NUMBERFORMAT Setting for LABELS also controls the number format in 99 Chapter 5 Macro Commands the legend Optional Parameters Parameter Syntax Notes VAR lt integer gt Variable used for contour levels LABELS SHOW lt boolean gt GENERATEAUTOLABELS lt boolean gt If TRUE automatic labels are repositioned on each redraw ALIGNAUTOLABELS lt boolean gt If TRUE automatic labels are aligned with the contour lines otherwise they are hori zontal LABELWITHVALUE lt boolean gt If TRUE automatic labels show the contour value otherwise they show the contour level number AUTOLEVELSKIP lt op gt lt integer gt Value is in Y frame units AUTOLABELSPACING lt op gt lt dexp gt COLOR lt color gt ISFILLED lt boolean gt
6. Parameters F Pointer to integer specifying file number to switch to A value of 1 indicates a switch to the file opened by the first call to TECINI100 TECGEO100 Summary Writes a geometry to the data file FORTRAN Syntax INTEGER 4 FUNCTION TECGEO100 XPos YPos ZPOS PosCoordMode AttachToZone Zone Color FillColor IsFilled GeomType LinePattern PatternLength LineThickness NumEllipsePts ArrowheadStyle ArrowheadAttachment ArrowheadSize ArrowheadAngle Scope Clipping NumSegments NumSegPts XGeomData YGeomData ZGeomData MFC PPPOE MEO MM PPM MMM PHM HMM MM SM HM RM DOUBLE PRECISION XPos DOUBLE PRECISION YPos DOUBLE PRECISION ZPos INTEGER 4 PosCoordMode INTEGER 4 AttachToZone INTEGER 4 Zone INTEGER 4 Color INTEGER 4 FillColor INTEGER 4 I sFilled 268 Binary Data File Function Reference INTEGER 4 GeomType INTEGER 4 LinePattern DOUBLE PRECISION PatternLength DOUBLE PRECISION LineThickness INTEGER 4 NumEllipsePts INTEGER 4 ArrowheadStyle INTEGER 4 ArrowheadAttachment DOUBLE PRECISION ArrowheadSize DOUBLE PRECISION ArrowheadAngle INTEGER 4 Scope INTEGER 4 Clipping INTEGER 4 NumSegments INTEGER 4 NumSegPts REAL 4 XGeomData REAL 4 YGeomData REAL 4 ZGeomData CHARACTER MFC C Syntax include TECIO h INTEGER4 TECGEO double XPos double YPos double ZPos INTEGER4 PosCoordMode INTEGER4 AttachToZone INTEGER4 Zone INTEGER4 Color INTEGER4 FillC
7. ZONE lt integer gt VAR lt integer gt Description Returns the location of the variable in the zone as either CELLCENTERED or NODAL and saves in the macro variable 97 Chapter 5 Macro Commands Required Parameter Parameter Syntax Notes ZONE lt integer gt VAR lt integer gt Example Get the variable location for the variable three in zone 1 GETVARNLOCATION ABC ZONE 3 VAR 1 GETVARNUMBYNAME Syntax GETVARNUMBYNAME lt macrovar gt NAME lt string gt Description Given a variable name get the number for that variable This variable number can then be used to assign attributes such as what variable to use for contouring Required Parameter Parameter Syntax Notes NAME lt string gt Name of the variable If a variable has aliases the name must correspond to one of the aliases Example Get the variable number for the variable named PRESSURE and make it the contouring variable GETVARNUMBYNAME PVARNUM NAME PRESSURE GLOBALCONTOUR VAR PVARNUM 98 Syntax Description GETZONETYPE GETZONETYPE lt macrovar gt ZONE lt integer gt no optional parameters Query for the zone type of the specified zone The zone type will be assigned to lt macrovar gt The possible return values are ORDERED FETRIANGLE FEQUAD FETETRA FEBRICK Required Parameter
8. lt integer gt Valid integer value lt interpptselection gt ALLPOINTS NEARESTNPOINTS OCTANTNPOINTS lt isosurfacesselection gt ALLCOUNTOURLEVELS ONESPECIFICVALUE TWOSPECIFICVAL UES THREESPECIFICVALUES lt krigdrift gt NONE LINEAR QUAD lt labelalignment gt BYANGLE ALONGAXIS PERPENDICULARTOAXIS lt labeltype gt INDEX VARVALUE XANDYVARVALUE lt lightingeffect gt PANELED GOURAUD lt linearinterpmode gt DONTCHANGE SETTOCONST lt linepattern gt SOLID DASHED DASHDOT DOTTED LONGDASH DASHDOTDOT 233 Chapter 7 Parameter Assignment Values Expressions and Arithmetic and Logical Operators Table 7 1 Parameter Assignment Values Value Identifier Allowable Values lt linktype gt WITHINFRAME BETWEENFRAMES lt macrofunctionvar gt lt integer gt lt macrointrinsic gt IS3DV LOOP NUMVARS NUMFRAMES NUMZONES OPSYS NUMPLANES TECHOME MINB MAXB MINC MAXC MINS MAXS MINU MAXU MINV MAXV MINW MAXW MINX MAXX MINY MAXY MINZ MAXZ MAXI MAXJ MAXK NUMWIN NUMXYMAPS COLORMAPDYNAMIC TECPLOTVERSION MINVnn MAXVnn AXISMINX AXISMAXX AXISMINY AXISMAXY AXISMINZ AXISMAXZ STARTSLICEPOS ENDSLICEPOS SLICEPLANETYPE MACROFILEPATH PLATFORM FRAMEMODE lt macrointrinsicvar gt lt macrointrinsic gt lt macroparameter gt lt charactersequence gt lt string gt
9. 317 Chapter 11 Writing Binary Data for Loading into Tecplot 318 Index Symbols 231 232 235 236 13 180 ACTIVEFIELDZONES 13 21 S ACTIVELINEMAPS 13 22 ADDMACROPANELTITLE 13 22 ADDONCOMMAND 13 23 ALTERDATA 13 24 25 26 ANIMATECONTOURLEVELS 13 26 ANIMATEIJKBLANKING 13 27 S ANIMATEIJKPLANES 13 29 S ANIMATELINEMAPS 14 30 S ANIMATESLICES 14 30 S ANIMATESTREAM 14 31 32 S ANIMATEZONES 14 32 ATTACHDATASET 14 33 34 ATTACHGEOM 14 34 36 S ATTACHTEXT 14 36 38 225 AVERAGECELLCENTERDATA 14 BASICCOLOR 14 39 222 BASICSIZE 14 39 40 210 BLANKING 14 40 41 BRANCHCONNECTIVITY 42 BRANCHFIELDDATAVAR 14 43 BREAK 14 44 S COLORMAP 14 44 45 in color map files 255 COLORMAPCONTROL 14 COLORMAPCONTROL COPYSTANDARD 46 COLORMAPCONTROL REDISTRIBUTECONTROLPOINT S 45 46 COLORMAPCONTROL RESETTOFACTORY 46 47 COLORSPECTRUM 211 COMPATIBILITY 14 47 CONTINUE 14 47 CONTOURLABELS 14 48 CONTOURLABELS ADD 48 49 CONTOURLABELS DELETEALL 49 CONTOURLEVELS 14 CONTOURLEVELS ADD 50 CONTOURLEVELS DELETENEAREST 51 CONTOURLEVELS DELETERANGE 51 52 CONTOURLEVELS NEW 52 CONTOURLEVELS RESET 53 54 CONTOURLEVELS RESETTONICE 54 CREATECIRCULARZONE 14 55 CREATECONTOURLINEZONES 14 56 CREATEFEBOUNDARY 14 56 57 CREATEFESURFACEFROMIORDERED 14 57 CREATEISOZONES 14 58 CREATELINEMAP 14 58 59 CREATEMIRRORZONES 14
10. Description Add objects defined within a specified region to the list of picked objects The region is defined in terms of the paper coordinate system Optional filters can be used to restrict the objects selected The region is defined by the two corner points X1 Y1 and X2 Y2 Required Parameters Parameters Syntax Notes X1 lt dexp gt X location in inches relative to the left edge of the paper Y1 lt dexp gt Y location in inches relative to the top edge of the paper X2 lt dexp gt X location in inches relative to the left edge of the paper Y2 lt dexp gt Y location in inches relative to the top edge of the paper Optional Parameters Parameters Syntax Default Notes SELECTTEXT lt boolean gt FALSE Select all text objects in the specified region SELECTGEOMS lt boolean gt FALSE Select all geometry objects in the specified region SELECTFRAMES lt boolean gt FALSE Select all frame objects in the specified region SELECTSTREAMTRACES FALSE Select all streamtrace objects in the specified region lt boolean gt SELECTMAPS lt boolean gt FALSE Select all line map objects in the specified region SELECTZONES lt boolean gt FALSE Select all zone objects in the specified region SELECTGRIDAREA FALSE Select the grid area in specified region lt boolean gt SELECTCONTOURLABELS FALSE Select all contour label
11. FRAME lt integer gt numframes Frame to be pushed Frames are numbered 1 to numframes with frame 1 drawn first and the high est numbered frame drawn last when a Redraw All is executed FRAMECONTROL PUSHBYNAME Syntax FRAMECONTROL PUSHBYNAME NAME lt string gt Description Push the specified frame to the bottom of the view stack Example FRAMECONTROL PUSHBYNAME NAME BANANA FRAMECONTROL PUSHTOP Syntax FRAMECONTROL PUSHTOP no parameters Description Push the top active frame to the bottom Example FRAMECONTROL PUSHTOP FRAMELAYOUT Syntax FRAMELAYOUT optional parameters 90 Description A SetValue command that sets the position border and background attributes for the current frame Use the FRAMECONTROL action command to push and pop frames if you want to change the settings for a frame other than the current frame Optional Parameters Parameter Syntax Notes SHOWBORDER lt boolean gt SHOWHEADER lt boolean gt ISTRANSPARENT lt boolean gt BACKGROUNDCOLOR lt color gt Only applies if ISTRANSPARENT FALSE HEADERCOLOR lt color gt Only applies if SHOWHEADER TRUE HEADERFONT lt font gt BORDERTHICKNESS lt op gt lt dexp gt Value is in Y frame units WIDTH lt op gt lt dexp gt Value is in inches HEIGHT lt op gt lt dexp gt Value is in inches XYPOS lt lt xy gt gt Pos
12. SHOW lt boolean gt COLOR lt color gt ISFILLED lt boolean gt FILLCOLOR lt color gt LINETHICKNESS lt op gt lt dexp gt MAGNITUDE lt op gt lt dexp gt XYPOS lt lt xy gt gt SYMBOLSHAPE lt lt symbolshape gt gt DATALABELS These are text labels that can be added to a plot to show node or cell values SHOWNODELABELS lt boolean gt SHOWCELLLABELS lt boolean gt COLOR lt color gt INCLUDEBOX lt boolean gt NODELABELTYPE lt nodelabeltype gt NODELABELVAR lt op gt lt integer gt INDEXSKIP lt op gt lt integer gt DISTANCESKIP lt op gt lt dexp gt SKIPMODE lt skipmode gt TEXTSHAPE lt lt textshape gt gt Not allowed to change size units parameter NUMFORMAT lt lt numberformat gt gt CELLLABELTYPE lt labeltype_e gt CELLLABELVAR lt entindex_t gt COLORBYZONEMAP lt boolean gt SPHERESCATTERREN lt spherescatterren Takes values LOW MEDIUM or HIGH Config file only DERQUALITY derquality gt option Example This example does the following e Increases the relative size of scatter symbols that are sized by variable by ten percent e Turns on the scatter sizing legend e Turns on the reference scatter symbol and makes it red e Turns on data labels for nodes GLOBALSCATTER RELATIVESIZE 1 1 LEGEND SHOW YES 109 Chapter 5 Macro Commands REFSCATSYMBOL SHOW COLOR DATALABELS SHOWNODELABELS TRUE
13. 196 Syntax Description Example Syntax Description Example Syntax Description Example os WORKSPACEVIEW FITALLFRAMES WORKSPACEVIEW FITALLFRAMES no parameters Change the view in the workspace so all frames are fit just inside the edges of the workspace WORKSPACEVIEW FITALLFRAMES oo WORKSPACEVIEW FITPAPER WORKSPACEVIEW FITPAPER no parameters Change the view in the workspace so the entire paper is fit just inside the edges of the workspace WORKSPACEVIEW FITPAPER WORKSPACEVIEW FITSELECTEDFRAMES WORKSPACEVIEW FITSELECTEDFRAMES no parameters Change the view in the workspace so the currently selected frames that is the frames with pick handles are fit just inside the edges of the workspace WORKSPACEVIEW FITSELECTEDFRAMES 197 Chapter 5 Macro Commands Syntax Description Example Syntax Description Example Syntax Description WORKSPACEVIEW LASTVIEW WORKSPACEVIEW LASTVIEW no parameters Return to the previous workspace view WORKSPACEVIEW LASTVIEW WORKSPACEVIEW MAXIMIZE WORKSPACEVIEW MAXIMIZE no parameters Temporarily expand the work area as large as possible The maximized work area occupies the entire Tecplot process window WORKSPACEVIEW MAXIMIZE WORKSPACEVIEW TRANSLATE WORKSPACEVIEW TRANSLATE X lt dexp gt Y lt dexp gt no optional parameters Shift the view of the worksp
14. 49 Chapter 5 Macro Commands The CONTOURLEVELS compound functions are CONTOURLEVELS CONTOURLEVELS CONTOURLEVELS CONTOURLEVELS CONTOURLEVELS CONTOURLEVELS ADD NEW DELETENEAREST DELETERANGE RESET RESETTONICE CONTOURLEVELS ADD Syntax CONTOURLEVELS ADD lt contourlevelrawdata gt optional parameters Description Add a new set of contour levels to the existing set of contour levels Required Parameter Parameter Syntax Notes lt contourlevelrawdata gt Supply a list of contour levels to add Optional Parameters Parameter Syntax Default Notes CONTOURGROUP 1 Defines which contour group is changed lt integer gt Example Add contour levels 1 7 3 4 and 2 9 to the plot CONTOURLEVELS ADD RAWDATA NO WEe Ww o wo eANI 50 CONTOURLEVELS DELETENEAREST Syntax CONTOURLEVELS DELETENEAREST RANGEMIN lt dexp gt optional parameters Description Delete the contour level whose value is nearest the value supplied in the RANGEMIN parameter Required Parameter Parameter Syntax Notes RANGEMIN lt dexp gt Delete the contour level whose value is nearest to this value Optional Parameters Parameter Syntax Default Notes CONTOURGROUP 1 Defines which contour group is changed lt integer gt Example Delete the contour level whose value is nearest to 3 4
15. AYNITOC Tecplot Reference Manual Version 10 Amtec Engineering Inc Bellevue Washington September 2003 Copyright 1988 2003 Amtec Engineering Inc All rights reserved worldwide This manual may not be reproduced transmitted transcribed stored in a retrieval system or translated in any form in whole or in part without the express written permission of Amtec Engineering Inc 13920 Southeast Eastgate Way Suite 220 Bellevue Washington 98005 U S A This software and documentation are furnished under license for utilization and duplication only accord ing to the license terms Documentation is provided for information only It is subject to change without notice It should not be interpreted as a commitment by Amtec Engineering Inc Amtec assumes no lia bility or responsibility for documentation errors or innacuracies SOFTWARE COPYRIGHTS Tecplot 1988 2003 Amtec Engineering Inc All rights reserved worldwide ENCSA Hierarchical Data Format HDF Software Library and Utilities 1988 1998 The Board of Trustees of the University of Illinois All rights reserved Contributors include National Center for Super computing Applications NCSA at the University of Illinois Fortner Software Windows and Mac Unidata Program Center netCDF The Independent JPEG Group JPEG Jean loup Gailly and Mark Adler gzip Netpbm Bmptopnm 1992 David W Sanderson Ppmtopict 1990 Ken Yap TRADEMARKS Tecplo
16. Chapter 5 Macro Commands Parameter Syntax Notes BOUNDARY SHOW lt boolean gt COLOR lt color gt LINETHICKNESS lt op gt lt dexp gt SURFACEEFFECTS LIGHTINGEFFECT lt lightingeffect gt SURFACETRANSLUCENCY lt translucency gt USETRANSLUCENCY lt boolean gt Example GLOBALSLICE POSITION1 x 6 GLOBALCONTOUR VAR 4 GLOBALSLICE SHOW YES GLOBALSLICE POSITION2 X 1 GLOBALSLICE SHOWPOSITION2 YES GLOBALSLICE SHOWINTERMEDIATESLICES YES GLOBALSLICE NUMINTERMEDIATESLICES 6 REDRAW CREATESLICEZONES GLOBALSTREAM Syntax GLOBALSTREAM optional parameters Description A SetValue command that changes global attributes associated with streamtraces Optional Parameters Parameter Syntax Notes SHOW lt boolean gt ADDARROWS lt boolean gt 112 Parameter Syntax Notes CELLFRACTION lt op gt lt dexp gt Maximum fraction of the distance across a cell a streamtrace moves in one step A streamtrace adjusts its step size between CELLFRACTION and MINCELLFRAC TION depending on local curvature of the streamtrace MINCELLFRACTION lt op gt lt dexp gt Minimum fraction of the distance across a cell a streamtrace moves in one step ARROWHEADSIZE lt op gt lt dexp gt ARROWHEADSPACING lt op gt lt double gt Distance between arrowheads in frame units RODRIBBO
17. Description Add Auxilary Data in the form of name value pairs to zones frames or datasets The name must begin with an underscore or letter and may be followed bu one or more underscore period letter or digit characters Required Parameters Parameter Syntax Notes AUXDATALOCATION zone dataset frame NAME lt string gt VALUESTRING lt string gt 170 Optional Parameters Parameter Syntax Notes ZONE lt integer gt Only required if AUXDATALOCATION zone Example Set the selected Auxilary Data to Zone 2 SETAUXDATA AUXDATALOCATION zone ZONE 2 NAME VARIABLE DATA VALUESTRING WEST SECTOR SETDATASETTITLE Syntax SETDATASETTITLE lt string gt no optional parameters Description Set the title for the current data set Example SETDATASETTITLE My data set SETFIELDVALUE Syntax SETFIELDVALUE ZONE lt integer gt VAR lt integer gt INDEX lt integer gt FIELDVALUE lt dexp gt AUTOBRANCH lt boolean gt no optional parameters 171 Chapter 5 Macro Commands Description Specify a field value data set value at a specified point index If the zone referenced is IJ or IJK ordered then the point index is calculated by treating the 2 or 3 D array as a 1 D array Required Parameters Parameters Syntax Notes ZONE lt integer gt VAR lt integer gt FIELDVALUE lt dexp g
18. Description Create one or more zones out of the currently defined streamtraces The new zones have the same number of variables per data point as the other zones in the data set with all non coordinate variables interpolated at the positions along the streamtrace Optional Parameter Parameter Syntax Default Notes CONCATENATE lt boolean gt FALSE Set to TRUE to create a single zone out of all common streamtraces The cell that connects the end of one streamtrace with the beginning of the next can later be turned off using value blanking Example Syntax Description Create a single zone out of all common streamzones CREATESTREAMZONES CONCATENATE TRUE DATASETUP DATASETUP optional parameters A SetValue command that sets miscellaneous parameters related to data 64 Optional Parameters Parameter Syntax Notes SCRATCHDATAFIELDTYPE lt datatype gt Set the data type for scratch arrays used for geometries line segments and other lines The default is SINGLE for Windows and DOUBLE for UNIX This parameter can only be used in the Tecplot configuration file PREPLOTARGS lt string gt Arguments used to run the internal Preplot utility The internal version of Preplot is used to convert ASCII data files when they are read directly into Tecplot See Sec tion 4 5 ASCII Data File Conversion to Binary in the Tecplot User s Manual for more inform
19. Description Read one or more data files into Tecplot to form a new data set Optional Parameters Parameters Syntax Default Notes IJKSKIP Use values greater than to skip data points I lt integer gt 1 J lt integer gt 1 K lt integer gt L RESETSTYLE lt boolean gt TRUE Set to FALSE if you want Tecplot to keep the cur rent style This only applies if READDATA OPTION is not APPEND INCLUDETEXT lt boolean gt TRUE Set to TRUE to load in any text in the data files INCLUDEGEOM lt boolean gt TRUE Set to TRUE to load in any geometries in the data files INCLUDECUSTOMLABELS TRUE Set to TRUE to load in any custom labels in the lt boolean gt data files INCLUDEDATA lt boolean gt TRUE Set to TRUE to load in any field data in the data files INITIALPLOTFIRSTZONEONLY lt boolean gt INITIALPLOTTYPE lt plottype gt Allows faster performance for files with multiple zones DATASETREADER lt string gt None Used to specify an alternate data reader for Tec plot VARLOADMODE lt varloadmode gt BYPOSITION Set to BYPOSITION to load variables based on their position in the file Set to BYNAME to load variables based on their name If set to BYNAME then VARNAMELIST must be supplied as well VARNAMELIST lt string gt None Use this to list the names of the variables to load into Tecplot Names separated by a or a are joined together to form a s
20. NumFaceConnections amp 0 FaceNeighborMode amp VAL Zero ValueLocation amp VAL Zero ShareVarFromZone amp 0 ShareConnectivityFromZone 304 Example Programs Q Q qgqagaanaA aa c Cc Write out the field data for the ordered zone III IMax JMax I TECDAT100 III X DIsDouble I TECDAT100 III Y DIsDouble I TECDAT100 III P DIsDouble Calculate values for the I ordered zone Do 20 I 1 50 XL I I YL I sin I 20 0 20 Continue Switch to the line plt file file number 2 and write out the line plot data III 2 I TECFIL100 III Write the zone header information for the XY data IMax 50 JMax 1 KMax 1 I TECZNE100 XY Line plot NULCHAR 0 IMax JMax KMax oo0okooo r VAL Zero VAL Zero 0 PPP PP PM PP PM SM ES M Write out the line plot 305 Chapter 11 Writing Binary Data for Loading into Tecplot Cc DIsDouble 1 III IMax I TECDAT100 III XLDummy DIsDouble I TECDAT100 III YLDummy DIsDouble e C Switch back to the field plot file and write out C the finite element zone C III 1 I TECFIL100 III Cc C Write the zone header information for the finite element zone Cc NPts 20 NElm 12 KMax 1 I TECZNE100 Finite Zone NULCHAR amp 3i FEQUADRILATERAL amp NPts amp NElm amp KMax amp 0 amp 0 amp 0 amp 1 amp 0 amp
21. Optional Parameter Parameter Syntax Notes CONTLINECREATEMODE Select whether one zone per contour lever will be created ONEZONEPERCONTOURLEVEL or or whether there will be a zone for each polyline ONEZONEPERINDEPENDENTPOLYLINE Example Create a new zone for each contour line on an existing contour plot CREATECONTOURLINEZONES CONTLINECREATEMODE ONEZONEPERCONTOURLEVEL CREATEFEBOUNDARY Syntax CREATEFEBOUNDARY 56 SOURCEZONE lt integer gt optional parameters Description Zone boundaries for finite element data cannot be turned on or off using the boundary plot layer in Tecplot You can however create a separate zone which is the boundary of a finite element zone This new zone can then be turned on or off One requirement for this function to work correctly is that adjacent cells must share the same node points along their common boundary Required Parameter Parameter Syntax Notes SOURCEZONE lt integer gt Zone to extract the boundary from Optional Parameter Parameter Syntax Default Notes REMOVEBLANKEDSURFACES FALSE lt boolean gt Set to TRUE if you want the resulting zone to include only the boundary adjacent to non blanked cells Example Create an FE boundary zone from zone 3 CREATEFEBOUNDARY SOURCEZONE 3 CREATEFESURFACEFROMIORDERED Syntax CREATEFESURFACEFROMIORDERED SOURCEZONES
22. lt draworder gt BEFOREDATA AFTERDATA lt drift gt NONE LINEAR QUAD 232 Assignment Value Table Table 7 1 Parameter Assignment Values Value Identifier Allowable Values lt epspreviewimagetype gt NONE TIFF EPSIV2 FRAME lt errorbartype gt UP DOWN LEFT RIGHT VERT HORZ CROSS lt exportformat gt RASTERMETAFILE TIFF SUNRASTER XWINDOWS PSIMAGE HPGL HPGL2 PS EPS WINDOWSMETAFILE BMP PNG AVI JPEG lt expression gt See Section 7 2 lt fillmode gt NONE USESPECIFICCOLOR USEBACKGROUNDCOLOR USELINECOLOR lt font gt HELV HELVBOLD TIMES TIMESBOLD TIMESITALIC TIMESITALICBOLD COURIER COURIERBOLD GREEK MATH USERDEF lt frameaction gt DELETETOP FITALLTOPAPER POP POPATPOSITION PUSHTOP lt framecollection gt ALL PICKED lt framemode gt THREED TWOD XY SKETCH lt functiondependency gt XINDEPENDENT YINDEPENDENT THETAINDEPENDENDT RINDEPENDENT lt geomshape gt SQUARE DEL GRAD RTRI LTRI DIAMOND CIRCLE CUBE OCTAHEDRON SPHERE POINT lt geomtype gt GEOMIMAGE LINESEGS RECTANGLE SQUARE CIRCLE ELLIPSE LINESEGS3D lt ijkblankmode gt INTERIOR EXTERIOR lt ijklines gt I J K lt ijkplane gt I J K lt imagestyle gt ONEPERFRAME WORKSPACEONLY lt initialdialogplacement gt LEFT RIGHT CENTER TOPLEFT TOPCENTER BOTTOMLEFT BOTTOMRIGHT BOTTOMCENTER
23. lt integer gt G lt op gt lt integer gt B lt op gt lt integer gt Example Change the CUSTOM3 basic color to be light green BASICCOLOR CUSTOM 3 R 80 G 255 B 80 lt lt shademap gt gt Description Map colors on the screen to shades of gray for monochrome hardcopy output 222 Expands to Syntax Notes BLACKSHADE lt dexp gt Shade values can range from 0 black to 100 white REDSHADE lt dexp gt GREENSHADE lt dexp gt BLUESHADE lt dexp gt CYANSHADE lt dexp gt YELLOWSHADE lt dexp gt PURPLESHADE lt dexp gt WHITESHADE lt dexp gt CUSTOM1SHADE lt dexp gt CUSTOM2 SHADE lt dexp gt CUSTOM3 SHADE lt dexp gt CUSTOM4 SHADE lt dexp gt CUSTOM5 SHADE lt dexp gt CUSTOM6 SHADE lt dexp gt CUSTOM7 SHADE lt dexp gt CUSTOM8 SHADE lt dexp gt Example Make blue flooded regions map to 50 percent gray PRINTSETUP MONOFLOODMAP BLUESHADE 50 lt lt symbolshape gt gt Description Set a symbol shape Symbols can be a geometric shape circle square and so forth or an ASCII character 223 Chapter 6 Parameter Subcommands Expands to Syntax Notes ISASCII lt boolean gt ASCIISHAPE lt string gt lt geomshape gt USEBASEFONT lt boolean gt FONTOVERRIDE lt font gt CHAR lt string gt GEOMSHAPE lt geomshape gt Example Change
24. lt macroparameterlist gt lt macroparameter gt lt macroparameter gt lt macrouserdefvar gt lt charactersequence gt lt macrovar gt lt macrointrinsicvar gt lt macrouserdefvar gt lt macrofunctionvar gt lt meshtype gt WIREFRAME OVERLAY HIDDENLINE lt mirrorvar gt X YY 27 lt mousebuttonclick gt REDRAW REVERTTOSELECT NOOP lt mousebuttondrag gt NOOP ZOOMDATA ZOOMPAPER TTRANSLATEDATA TRANSLATE PAPER ROLLERBALLROTATE SPHERICALROTATE XROTATE YROTATE ZROTATE TWISTROTATE lt mousemode gt ADJUST SELECT lt noncurrentframedrawlevel gt FULL TRACE lt objectalign gt BOTTOM CENTER TOP LEFTJUSTIFY RIGHTJUSTIFY lt op gt Sj sey Foy FS lt originresetlocation gt DATACENTER VIEWCENTER lt palette gt MONOCHROME PENPLOTTER COLOR lt papergridspacing gt HALFCENTIMETER ONECENTIMETER TWOCENTIMETERS QUARTERINCH HALFINCH ONEINCH TENPOINTS TWENTYFOURPOINTS THIRTYSIXPOINTS FIFTYPOINTS lt paperrulerspacing gt ONECENTIMETER TWOCENTIMETERS ONEINCH FIFTYPOINTS SEVENTYTWOPOINTS lt papersize gt LETTER DOUBLE A4 A3 CUSTOM1 CUSTOM2 lt pickaction gt ADD ADDALL ADDALLINREGION CLEAR COPY CUT EDIT MAGNIFY PASTE POP PUSH SETMOUSEMODE SHIFT lt plotapproximationmode gt AUTOMATIC NONCURRENTALWAYSAPPROX ALLFRAMESALWAYSAPPROX 234
25. lt set gt optional parameters Description A FE Surface zone can be generated from two or more I Ordered zones To get the best possible output it is recomended that the source zones should have their nodes arranged in a similar manner so that the connecting lines between points are as straightforward as possible For 57 Chapter 5 Macro Commands this reason indices from source zones should increase in the same direction Required Parameter Parameter Syntax Notes SOURCEZONES lt set gt Zones whose points will be used to create the new sur face Optional Parameter Parameter Syntax Default Notes lt boolean gt CONNECTSTARTTOEND FALSE TRUE allows for closed surfaces Example Syntax Description Example Syntax Create an FE Surface zone from zones 3 and 4 CREATEFESURFACEFROMIORDERED SOURCEZONES 3 4 CREATEISOZONES CREATEISOZONES no parameters Create zones from the currently defined iso surfaces One zone will be created from each defined iso surface The iso surfaces must be active and you must have at least one active volume zone CREATEISOZONES CREA TELINEMAP CREATELINEMAP no parameters 58 Description Create a new Line mapping Example Syntax CREATELINEMAP CREATEMIRRORZONES CREATEMIRRORZONES SOURCEZONES lt set gt optional parameters Description Create new zo
26. no optional parameters Description Rename a data set zone in Tecplot Required Parameters Parameter Syntax Notes ZONE lt integer gt Specify the zone number NAME lt string gt Specify the new zone name Example Rename zone 1 to be Banana 165 Chapter 5 Macro Commands RENAMEDATASETZONE ZONE 1 NAME Banana RESET3DAXES Syntax I RESET3DAXES no parameters Description Reset the ranges on the 3 D axes Example RESET3DAXES RESET3DORIGIN Syntax RESET3DORIGIN optional parameters Description Reposition the rotation origin in 3 D to be at the specified location Optional Parameter Parameter Syntax Notes ORIGINRESETLOCATION lt originresetlocation gt Example 1 RESET3DORIGIN ORIGINRESETLOCATION DATACENTER RESET3DSCALEFACTORS Syntax RESET3DSCALEFACTORS no parameters 166 Description Recalculate the scale factors for the 3 D axes Aspect ratio limits are taken into account Example RESET3DSCALEFACTORS RESETVECTORLENGTH Syntax RESETVECTORLENGTH no parameters Description Reset the length of the vectors Tecplot will find the vector with the largest magnitude and set the scaling factor so it will appear on the screen using the length specified by FRAMESETUP VECTDEFLEN Example RESETVECTORLENGTH ROTATE2DDATA Syntax ROTATE2DDATA ANGLE lt de
27. optional parameters Description A SetValue command that turns field plot layers on or off or sets the 2 D draw order Optional Parameters Parameter Syntax Notes SHOWMESH lt boolean gt SHOWCONTOUR lt boolean gt SHOWVECTOR lt boolean gt Vector variables must be defined See GLOBALTWODVECTOR or GLOBALTHREEDVECTOR SHOWSCATTER lt boolean gt SHOWSHADE lt boolean gt SHOWBOUNDARY lt boolean gt TWODDRAWORDER lt fwoddraworder gt USETRANSLUCENCY lt boolean gt USELIGHTINGEFFECT lt boolean gt Example Turn on the scatter layer FIELDLAYERS SHOWSCATTER YES 84 Syntax FILECONFIG optional parameters FILECONFIG Description A SetValue command that sets file path information in Tecplot Optional Parameters Parameter Syntax Notes DATAFILEVARLOADMODE lt varload Set the default loading mode for variables The default mode gt is BYNAME To get Tecplot Version 7 0 behavior use BYPOSITION LAYOUTCONFIG USERELATIVEPATHS lt boolean gt If TRUE files will be referenced using relative pathis in layout files INCLUDEDATA lt boolean gt Default set to TRUE to make option to save layout packages the default INCLUDEPREVIEW lt boolean gt If TRUE option to include preview image in layout packages is turned on by default TEMPFILEPATH lt string gt Set the direct
28. 1 if unsuccessful Parameters F INTEGER FUNCTION TECFIL F INTEGER 4 F ude TECIO h Pointer to integer specifying file number to switch to Summary Writes a geometry to the data file FORTRAN Syntax INTEGER 4 FUNCTION TECGEO XPos PPMP HOME OPM HMMM OPM HM PPM MS SM DOUBLE PRECISION XPos DOUBLE PRECISION YPos TECGEO YPos ZPOS PosCoordMode AttachToZone Zone Color FillColor IsFilled GeomType LinePattern PatternLength LineThickness NumEllipsePts ArrowheadStyle ArrowheadAttachment ArrowheadSize ArrowheadAngle Scope NumSegments NumSegPts XGeomData YGeomData ZGeomData MFC 286 Binary Data File Function Reference DOUBLE PRECISION ZPos INTEGER 4 PosCoordMode INTEGER 4 AttachToZone INTEGER 4 Zone INTEGER 4 Color INTEGER 4 FillColor INTEGER 4 I sFilled INTEGER 4 GeomType INTEGER 4 LinePattern DOUBLE PRECISION PatternLength DOUBLE PRECISION LineThickness INTEGER 4 NumEllipsePts INTEGER 4 ArrowheadStyle INTEGER 4 ArrowheadAttachment DOUBLE PRECISION ArrowheadSize DOUBLE PRECISION ArrowheadAngle INTEGER 4 Scope INTEGER 4 NumSegments INTEGER 4 NumSegPts REAL 4 XGeomData REAL 4 YGeomData REAL 4 ZGeomData CHARACTER MFC C Syntax include TECIO h INTEGER4 TECGEO double XPos double YPos double ZPos INTEGER4 PosCoordMode INTEGER4 AttachToZone INTEGER4 Zone INTEGER4 Color INTEGER4 FillColor INTEGER4 sFilled
29. CONTOURLEVELS DELETENEAREST RANGEMIN 3 4 CONTOURLEVELS DELETERANGE Syntax CONTOURLEVELS DELETERANGE RANGEMIN lt dexp gt RANGEMAX lt dexp gt optional parameters Description Delete all contour levels between a minimum and maximum contour value inclusive 51 Chapter 5 Macro Commands Required Parameters Parameter Syntax Notes Minimum contour level to delete RANGEMIN lt dexp gt Maximum contour level to delete RANGEMAX lt dexp gt Optional Parameters Parameter Syntax Default Notes CONTOURGROUP 1 Defines which contour group is changed lt integer gt Example Delete all contour levels between 0 1 and 0 7 CONTOURLEVELS DELETERANGE RANGEMIN 0 1 RANGEMAX 0 7 CONTOURLEVELS NEW Syntax CONTOURLEVELS NEW lt contourlevelrawdata gt optional parameters Description Replace the current set of contour levels with a new set Required Parameter Parameter Syntax Notes lt contourlevelrawdata gt Supply a list of contour levels to add 52 Optional Parameters Parameter Syntax Default Notes CONTOURGROUP 1 Defines which contour group is changed lt integer gt Example Replace the current set of contour levels with the levels 0 5 0 75 and 1 0 CONTOURLEVELS NEW RAWDATA 3 0 5 0 75 1 0 CONTOURLEVELS RESET Syntax CONTOURLEVELS RESET NUMVALUE
30. CREATERECTANGULARZONE CREATERECTANGULARZONE optional parameters Create a rectangular zone If no data set exists when this command is executed a data set is created with variables X Y and Z if KMax gt 1 If a data set exists prior to this command the non coordinate variables for the zone created are initialized to zero 60 Optional Parameters Parameter Syntax Default Notes IMax lt integer gt 1 I dimension JMax lt integer gt 1 J dimension KMax lt integer gt 1 K dimension X1 lt dexp gt 0 X minimum Y1 lt dexp gt 0 Y minimum Z1 lt dexp gt 0 Z minimum X2 lt dexp gt 1 X maximum Y2 lt dexp gt 1 Y maximum Z2 lt dexp gt 1 Z maximum DATATYPE lt datatype gt SINGLE Example Create a rectangular IJ ordered zone dimensioned 20 by 30 where X ranges from 0 to 3 and Y from 3 to 9 CREATERECTANGULARZONE IMax 20 JMax 30 X1 0 Y1 S3 X2 3 Y2 9 CREATESIMPLEZONE Syntax CREATES IMPLEZONE optional parameters lt xyrawdata gt Description Create a new zone by specifying only a list of XY pairs of data If other zones exist prior to using this function and there are more than 2 variables then the additional variables are also created and set to zero 61 Chapter 5 Macro Commands Required Parameter Parameter Syntax Notes lt xyrawdata gt See Chapter 9 Raw Data for det
31. Description Create an HTML file displaying one or more images A linked layout with packaged data may be included You must provide the file name Optional Parameter Parameter Syntax Default Notes INCLUDELAYOUTPACKAGE lt boolean gt No Select YES to create a linked layout file IMAGESELECTION lt imagestyle gt ONEPERFRAME Selecting ONEPERFRAME will create one image per frame selecting WORK SPACEONLY creates one image which includes all your frames Example PUBLISH Cc TEC100 separate html INCLUDELAYOUTPACKAGE NO IMAGESELECTION ONEPERFRAME 159 Chapter 5 Macro Commands QUIT Syntax QUIT Description Terminate the execution of the Tecplot program Example ourT RAWCOLORMAP Syntax I RAWCOLORMAP lt colormaprawdata gt Description Assign the RGB values that define the Raw user defined color map This does not set the color map to use the Raw user defined color map Use COLORMAP to set the current color map Required Parameter Parameter Syntax Notes lt colormaprawdata gt This is a list of RGB values Example Assign the Raw user defined color map to a gray scale using 11 colors RAWCOLORMAP RAWDATA 11 0 0 0 25 25 25 50 50 50 75 75 75 100 100 100 125 125 125 150 150 150 175 175 175 200 200 200 225 225 225 255 255 255 160 READDATASET Syntax READDATASET lt string gt optional parameters
32. FALSE SHOWOPPOSITEEDGE lt boolean gt 3D only Default FALSE COLOR lt color gt LINETHICKNESS lt double gt ALIGNMENT lt axisalignment gt OPPOSINGAXISVALUE lt double gt POSITION lt double gt ANGLE lt double gt OFFSET lt double gt EDGE lt integer gt Example Change the thickness of the Theta axis line to 0 8 and the color to red POLARAXIS THETADETAIL AXISLINE COLOR RED POLARAXIS THETADETAIL AXISLINE LINETHICKNESS 0 8 lt lt axistitle gt gt Description Assign attributes for titles 208 Expands to Syntax Notes SHOWONAXISLINE lt boolean gt SHOWONGRIDBORDERMIN lt boolean gt SHOWONGRIDBORDERMAX lt boolean gt Default TRUE Non 3D only Default FALSE Non 3D only Default FALSE SHOWONOPPOSITEEDGE lt boolean gt 3D only Default FALSE SHOWONALLAXES lt boolean gt Polar R only Default TRUE SHOWONVIEWPORTTOP lt boolean gt Polar only Default TRUE SHOWONVIEWPORTBOTTOM lt boolean gt Polar only Default TRUE SHOWONVIEWPORTLEFT lt boolean gt Polar only Default TRUE SHOWONVIEWPORTRIGHT lt boolean gt Polar only Default TRUE TITLEMODE lt titlemode gt TEXT lt string gt COLOR lt color gt TEXTSHAPE lt lt textshape gt gt OFFSET lt double gt PERCENTALONGLINE lt double gt Default 50 Example Create a R axis title saying Harmonic Motion in red times size
33. LIMITS Syntax LIMITS optional parameters Description A SetValue command that sets some of the internal limits in Tecplot See Tecplot User s Manual Appendix E Limits of Tecplot Version 10 for the default values for these limits The LIMITS command can only be used in the Tecplot configuration file Optional Parameters Parameter Syntax Notes MAXPTSINALINE lt op gt lt integer gt Maximum number of points for geometry polylines MAXCHRSINTEXTLABELS lt op gt lt integer gt Maximum number of characters in text labels MAXNUMCONTOURLEVELS lt op gt lt integer gt Maximum number of contour levels MAXPREPLOTVARS lt op gt lt integer gt Maximum number of variables allowed in an ASCII data file loaded into Tecplot MAXPREPLOTZONES lt op gt lt integer gt Maximum number of zones allowed in an ASCII data file loaded into Tecplot MAXNUMPICKOBJECTS lt op gt lt integer gt Maximum number of objects to pick 130 Example Syntax Description Increase the maximum number of contour levels allowed to 1 000 LIMITS MAXNUMCONTOURLEVELS 1000 LINEARINTERPOLATE LINEARINTERPOLATE DESTINATIONZONE lt integer gt optional parameters Interpolate selected variables from a set of source zones to a destination zone using linear interpolation The source zones cannot be IJ ordered Values assigned to the destination zone are equiv
34. PositionCoordSys Clipping FontType HeightUnits Anchor BoxType IsFilled GeomType LinePattern NumEllipsePts BoxColor BoxFillColor TextColor Color FillColor ArrowheadStyle ArrowheadAttachment NumSegments NumSegPts 1 LineThickness ArrowheadSize ArrowheadAngle XGeomData 1 YGeomData 1 ZGeomData 1 NULCHAR Zero include tecio for Debug VIsDouble DIsDouble NULCHAR Zero Cc CHAR 0 C Open field plt and write the header information Cc I TECINI100 DATASET WITH 1 ORDERED ZONE 1 QUAD ZONE PP PM SM MM NULCHAR X Y P NULCHAR field plt NULCHAR NOLCHAR Debug VIsDouble C Open line plt and write the header information 303 Chapter 11 Writing Binary Data for Loading into Tecplot Cc VIsDouble 1 I TECINI100 DATASET WITH ONE I ORDERED ZONE NULCHAR amp X Y NULCHAR amp line plt NULCHAR amp NULCHAR amp Debug amp VIsDoub1le C C Calculate values for the field variables Cc Do 10 J 1 5 Do 10 I 1 4 X I J I Y I J J P I J I J 10 Continue Cc C Make sure writing to file 1 Cc III 1 I TECFIL100 III C C Write the zone header information for the ordered zone Cc IMax 4 JMax 5 KMax 1 I TECZNE100 Ordered Zone NULCHAR amp 0 ZONETYPE amp IMax amp JMax amp KMax amp 0 ICellMax amp 0 JCellMax amp 0 KCellMax amp 1 ISBLOCK amp 0
35. Set aspect ratio for the data to this value when ASPECTRATIOLIMIT is exceeded BOXASPECTRATIOLIMIT lt op gt lt dexp gt Restrict the aspect ratio of the axis box BOXASPECTRATIORESET lt op gt lt dexp gt Set aspect ratio for the axis box to this value when ASPECTRATIOLIMIT is exceeded EDGEAUTORESET lt boolean gt Make Tecplot automatically choose edges to label FRAMEAXIS SHOW lt boolean gt SIZE lt op gt lt dexp gt LINETHICKNESS lt op gt lt dexp gt COLOR lt color gt XYPOS lt lt xy gt gt GRIDAREA lt lt gridarea gt gt XDETAIL lt lt axisdetail gt gt YDETAIL lt lt axisdetail gt gt ZDETAIL lt lt axisdetail gt gt PRESERVEAXISSCALE lt boolean gt WHENRANGEI SCHANGED Example This example does the following 182 e Changes the variable assigned to the Z axis to be variable number 2 e Turns off auto edge assignment and make axis labeling for the Y axis occur on edge 2 THREEDAXIS ZVAR 2 EDGEAUTORESET FALSE YEDGE 2 THREEDVIEW Syntax THREEDVIEW optional parameters Description A SetValue command that changes global attributes associated with the 3 D view Optional Parameters Parameter Syntax Notes DRAWINPERSPECTIVE lt boolean gt PSIANGLE lt op gt lt dexp gt Angle is in degrees THETAANGLE lt op gt lt dexp gt Angle is in degrees ALPHAANGLE lt op gt lt dexp gt Angle is in degrees FIELDOFVIEW lt op gt lt dexp
36. lt boolean gt COLOR lt color gt LINETHICKNESS lt dexp gt ISFILLED lt boolean gt FILLCOLOR lt color gt MAGNITUDE lt dexp gt XYPOS lt lt xy gt gt SYMBOLSHAPE lt lt symbolshape gt gt Example Change the fill color of the reference scatter symbol to be green GLOBALSCATTER REFSCATSYMBOL FILLCOLOR GREEN lt lt renderconfig gt gt Description Set the attributes for OpenGL rendering 220 Expands to Syntax Notes POLYGONOFFSETEXTBIASFACTOR lt double gt STIPPLEALLLINES lt stipplemode gt DEPTHBUFFERSIZE lt integer gt MINBITSPERRGBPLANE lt integer gt DOEXTRADRAWFORLASTPIXEL lt boolean gt MAXSTRIPLENGTH lt integer gt CONSTANTLYUSESCISSORING lt boolean gt USEQUADSTRIPS lt boolean gt USETRIANGLESTRIPS lt boolean gt TRIANGULATEFILLEDPOLYGONS lt boolean gt USEGLCOLORMATERIALFUNCTION lt boolean gt MAXTEXTURESIZE lt integer gt FORCESMOOTHSHADINGFORLIGHT lt boolean gt ING ADJUSTRECTANGLERIGHTANDBOT lt boolean gt TOM If thin patterned lines are not drawn correctly set STIPPLEALLLINES to ALL For low memory graphics cards the depth buffer size may need to be reduced Specify the minimum number of bits used for each of the planes in the image buffer Sometimes the last pixel for stroked font char acters is not drawn If so turn DOEX TRADRAWFORLASTPIXEL on Some graphics cards ha
37. lt integer gt lt integer gt lt integer gt lt sizeunits gt GRID FRAME POINT lt skipmode gt BYINDEX BYFRAMEUNITS lt slicesource gt VOLUMEZONES SURFACEZONES SURFACESOFVOLUMEZONES LINEARZONES lt sortby gt NONE BYDEPENDENDTVAR BYINDEPENDENTVAR BYSPECIFIC VAR lt standardcolormap gt SMRAINBOW LGRAINBOW MODERN GRAYSCALE TWOCOLOR lt stipplemode gt ALL CRITICAL NONE lt streamdirection gt FORWARD REVERSE BOTH lt streamtype gt SURFACELINE VOLUMELINE VOLUMERIBBON VOLUMEROD TWODLINE 235 Chapter 7 Parameter Assignment Values Expressions and Arithmetic and Logical Operators Table 7 1 Parameter Assignment Values Value Identifier Allowable Values lt string gt lt charactersequence gt lt charactersequence gt b lt stylebase gt FACTORY CONFIG lt subboundary gt ADD ADDONLY ALL REMOVE lt sunrasterformat gt OLDFORMAT STANDARD BYTEENCODED lt surfacestoplot gt BOUNDARYFACES EXPOSEDCELLFACES IPLANES JPLANES KPLANES IJPLANES JKPLANES IKPLANES IJKPLANES ALL lt textanchor gt LEFT CENTER RIGHT MIDLEFT MIDCENTER MIDRIGHT HEADLEFT HEADCENTER HEADRIGHT lt textboxtype gt NONE FILLED HOLLOW lt threedviewchange FULL TRACE drawlevel gt lt thetamode gt DEGREES RADIANS ARBITRARY lt tickdirection gt IN OUT CENTERED lt tiffbyteorder gt INTEL MOTOROLA lt t
38. lt string gt Name of the file to write to if SENDPRINTTOFILE is TRUE PRECISION lt op gt lt integer gt Applies only if EXPORTFORMAT is HPGL2 PS EPS or RASTERMETAFILE SENDPRINTTOFILE lt boolean gt If TRUE then PRINTFNAME is name of file to write to NUMHARDCOPYCOPIES lt op gt lt integer gt Applies only when DRIVER PS LARGEPAPEROK lt boolean gt Applies only when DRIVER HPGL DRIVER lt printerdriver gt Only applies if using the Tecplot printer drivers See INTERFACE USETECPLOTPRINTDRIVERS PALETTE lt palette gt Must choose options valid for current DRIVER set ting PENSPEED lt op gt lt integer gt PLOTTERUNITSPERINCH lt op gt lt dexp gt Applies only to HPGL and HPGL2 output JOBCONTROL These strings contain characters to be sent at the beginning and ending of a print file These strings HPGLMOPUPSTR lt string gt most often contain escape sequences used to switch HPGL2MOPUPSTR lt string gt modes on the printer Non printable characters can be POSTMOPUPSTR lt string gt inserted Use nnn to insert a character with ordinal LGMOPUPSTR lt string gt value nnn Use to force the character after the to HPGLSETUPSTR lt string gt be inserted Use B for a Backspace E for Esc C HPGL2SETUPSTR lt string gt for a carriage return and X for the Delete key POSTSETUPSTR lt string gt LGSETUPSTR lt string gt SPOOLER These strings contain the system command needed to send a file t
39. lt volumeobjectstoplot gt gt Description Specifies what volume objects are to be displayed Expands to Syntax Notes SHOWISOSURFACES lt boolean gt SHOWSLICES lt boolean gt SHOWS TREAMTRACES lt boolean gt 227 Chapter 6 Parameter Subcommands Example FIELD VOLUMEMODE VOLUMEOBJECTSTOPLOT SHOWISOSURFACES NO SHOWSLICES YES SHOWSTREAMTRACES YES lt lt xy gt gt Description Change settings for an X Y position Expands to Syntax Notes x lt op gt lt dexp gt Y lt op gt lt dexp gt Example See the XYPOS parameter in the example for lt lt textshape gt gt lt lt xyz gt gt Description Change settings for an X Y Z triplet 228 Expands to Syntax Notes x lt op gt lt dexp gt Y lt op gt lt dexp gt Zz lt op gt lt dexp gt Example Change the scale factor on the Z axis to be 0 5 GLOBALTHREED AXISSCALEFACT Z 0 5 lt lt zebrashade gt gt Description Change zebra shading attributes Expands to Syntax Notes INCLUDE lt boolean gt ISTRANSPARENT lt boolean gt COLOR lt color gt Example Turn on zebra shading and make the zebra shade color to be black GLOBALCONTOUR COLORMAPFILTER ZEBRA INCLUDE TRUE COLOR BLACK 229 Chapter 6 Parameter Subcommands 230 Assignment Value Table CHAPTE
40. setting font and position 225 setting fonts 225 shape 225 subscript size 86 superscript size 86 text box 37 thickness 225 Text attributes 36 setting defaults 66 334 Text box 37 Text boxes 224 Text shape 37 textbox subcommand 224 textshape subcommand 225 Tick marks 226 axis 226 labels 226 setting attributes 227 ticklabeldetail subcommand 226 TICKLENGTHS 40 tickmarkdetail subcommand 226 Title for data set 171 TRACEREDRAWMODE details 126 Transfering control from macro to Tecplot 47 Transform 184 transforming change coordinates 184 Translate picked objects 150 Translating view 194 workspace view 198 TRANSLATION 126 TRIANGLEKEEPFACTOR 122 Triangulating 185 U Undo view only 192 UNIXHELPBROWSERCMD 126 USEAPPROXIMATEPLOTS 126 USEDISPLAYLISTS 126 USEDOUBLEBUFFERING 126 User input dialogs 156 157 User interface launching dialogs 130 set attributes 120 User defined variables 246 USETECPLOTPRINTDRIVERS 127 Using value blankings example 42 V Value blanking 40 Values display 109 macro variables 241 set field value 171 Variable lists 137 Variable location getting 97 writing to data file 283 Variables assign to 2D axis 152 186 assign to 3D axes 182 assign to 3D axis 182 assigning values 187 contours 100 environment 245 getting location 97 getting variable number 98 initializing 187 internal 242 macro functions 248 remove user defined macro variable 164 renaming 165 scatter symbol
41. 0 2 percent DEFAULTGEOM LINETHICKNESS 0 2 Syntax DEFAULTTEXT optional parameters DEFAULTTEXT Description A SetValue command that sets the attributes for the default text When text is added to a plot interactively its font color size and so forth are based on the default text This command is usually used only in the Tecplot configuration file Optional Parameters Parameter Syntax Notes ANCHORPOS lt lt xy gt gt POSITIONCOORDSYS lt coordsys gt 66 Parameter Syntax Notes SCOPE lt scope gt ZONE lt op gt lt integer gt ATTACHTOZONE lt boolean gt CLIPPING lt clipping gt COLOR lt color gt ANGLE lt op gt lt dexp gt ANCHOR lt fextanchor gt LINESPACING lt op gt lt dexp gt TEXTSHAPE lt lt textshape gt gt BOX lt lt textbox gt gt MACROFUNCTIONCOMMAND lt string gt Set the macro command to execute when you hover over the geometry and press Ctrl right click Example Make the default text font TIMESBOLD with a character height of 14 points DEFAULTTEXT TEXTSHAPE es TIMESBOLD SIZEUNITS POINT HEIGHT 14 DELAY Syntax DELAY lt integer gt no parameters Description Delay Tecplot execution for lt integer gt seconds Example Pause Tecplot for 3 seconds S IDELAY 3 67 Chapter 5 Macro Commands DELETEAUXDATA Syntax DELETEAUXDATA AUXDATA
42. 0 for no debugging or 1 to debug VIsDouble Pointer to the integer flag for specifying whether field data generated in future calls to TECDAT are to be written in single or double precision Set to 0 for single precision or for double TECLAB Summary Write a set of custom labels to the data file FORTRAN Syntax INTEGER 4 FUNCTION TECLAB Labels CHARACTER Labels C Syntax include TECIO h INTEGER4 TECLAB char Labels Return Value o if successful 1 if unsuccessful Parameters Labels Character string of custom labels Separate labels by a comma or space For example a set of custom labels for each day of the weeks is Sun Mon Tue Wed Thu Fri Sat TECNOD Summary Writes an array of node data to the binary data file This is the connectivity list for finite element zones FORTRAN Syntax INTEGER 4 FUNCTION TECNOD NData INTEGER 4 NData T M 292 Binary Data File Function Reference C Syntax include TECIO h INTEGER4 TECNOD INTEGER4 NData Return Value o if successful 1 if unsuccessful Parameters NData Array of integers This is the connectivity list dimensioned T M T moving fastest where M is the number of elements in the zone and T is set according to the following list ELEMENT TYPE Triangle Quadrilateral Tetrahedral Brick oo A A SY N TECTXT Summary Writes a text record to the data file FORTRAN Syntax INTEGER 4 FUN
43. 299 inverse distance interpolation 128 Line legend and data labels 105 line mappings attributes 134 line plot layers on or off 135 line segment geometry raw data 252 macro function file 6 making Line maps active for plotting 22 making line maps active for plotting 22 mapping monochrome hardcopy output 223 paper characteristics 141 paper size dimensions 217 path information 86 pick all in rectangle 145 positioning frame on the paper 91 326 Preplot launch command 65 print attributes 156 rectangle settings 219 removing Line maps 22 removing zones from the set of active zones 22 RGB values raw data 252 set parameters for dynamic frame attributes 92 setting X Y positions 228 setting X Y Z triplets 229 setting 3D global attributes 115 setting attributes of 2D vector plots 118 setting attributes of 3D vector plots 117 setting attributes of default font 67 setting attributes of Tecplot interface 127 setting character spacing and sizing for fonts 87 setting color map overrides 211 setting color values 222 setting grid area borders 207 setting I J and K indices 214 setting IJK blankings 41 setting numbers formats 216 setting reference scatter symbols attributes 220 setting scatter attributes 109 setting someTecplot limits 131 setting symbol shapes 224 setting text shapes 225 setting the red green and blue components 39 text box 225 turning on scatter layers 84 using value blankings 42 XY Line axis attributes 204 zebr
44. 59 CREATENEWFRAME 14 59 60 CREATERECTANGULARZONE 14 60 61 CREATESIMPLEZONE 15 61 62 CREATESLICEZONEFROMPLANE 15 62 63 CREATESLICEZONES 15 63 CREATESTREAMZONES 15 64 DATASETUP 15 64 DEFAULTGEOM 15 65 66 DEFAULTTEXT 15 66 DELAY 15 67 DELETEAUXDATA 15 68 DELETELINEMAPS 15 68 69 DELETEVARS 15 DELETEZONES 15 69 319 Index DOUBLEBUFFER 15 DOUBLEBUFFER OFF 70 DOUBLEBUFFER ON 70 71 DOUBLEBUFFER SWAP 70 DRAWGRAPHICS 15 71 DROPDIALOG 15 71 DUPLICATELINEMAP 15 72 DUPLICATEZONE 15 72 S ELSE 15 74 S ELSEIF 15 74 S ENDIF 15 119 ENDLOOP 15 137 ENDMACROFUNCTION 15 ENDWHILE 15 196 EXPORT 15 75 76 EXPORTCANCEL 15 76 EXPORTFINISH 15 76 EXPORTNEXTFRAME 15 77 EXPORTSETUP 15 77 79 EXPORTSTART 15 79 EXTRACTFROMGEOM 16 79 80 EXTRACTFROMPOLYLINE 16 80 81 S FIELD 16 81 214 215 restrictions on using 255 S FIELDLAYERS 16 84 S FILECONFIG 16 85 FONTADJUST 16 86 87 FRAMECONTROL 16 FRAMECONTROL DELETETOP 87 88 FRAMECONTROL FITALLTOPAPER 88 FRAMECONTROL POP 88 FRAMECONTROL POPATPOSITION 89 FRAMECONTROL POPBYNAME 89 FRAMECONTROL PUSH 89 FRAMECONTROL PUSHBYNAME 90 FRAMECONTROL PUSHTOP 90 FRAMELAYOUT 16 90 FRAMEMODE 16 FRAMENAME 92 S FRAMESETUP 16 92 GETAUXDATA 16 93 GETCONNECTIVITYREFCOUNT 16 GETCURFRAMENAME 16 94 GETFIELDVALUE 16 95 GETFIELDV
45. 91 136 Setting size preferences 40 Setting symbol shapes 223 Setting the red green and blue components 39 Setting zebra shading attributes 229 Settings OpenGL rendering 220 SetValue commands 13 in color map files 255 macro configuration files 255 Shade attributes 83 Shade maps 222 shademap subcommand 222 Shading 222 Shift Line mappings to bottom of list 174 to top of list 175 Shift picked objects 150 Shifting view 194 workspace view 198 SHOWCONTINUOUSSTATUS 125 SHOWCOORDINATES 125 SHOWFRAMEBORDERSWHENOFF 126 showpanel flag 6 SHOWSTATUSLINE 126 SHOWTEXTGEOMSINAPPROXVIEW 126 SHOWWAITDIALOGS 126 Simple zone create 61 Single angle brackets 205 231 Size set command in macros 39 Size limitations macro control commands 256 Size lists 209 Size preferences setting 40 Sizes setting 40 Sketch axis 175 Slice animate command 30 create slice zone command 62 Slices create zones 63 setting global attributes 110 Small Rainbow color maps 46 SMALLSTEP 125 126 SMOOTHBNDRYCOND 122 Smoothing data 176 SMOOTHWEIGHT 122 SNAPTOGRID 102 SNAPTOPAPER 102 SOFTWARE3DRENDERING 126 333 Index Source maps 72 Source zones 56 57 58 59 Square 35 raw data 251 Steps per cycle in animation 32 STEPSIZE 125 126 Stipple 235 Stop macro execution 142 Stream animate command 32 Stream dashes animating 32 Stream markers animating 32 Streamtrace commands 177 181 add 178 delete all 179 delete range 179
46. Assignment Value Table Table 7 1 Parameter Assignment Values Value Identifier Allowable Values lt plottype gt CARTESIAN3D CARTESIAN2D XYLINE POLARLINE SKETCH lt pointerstyle gt ALLDIRECTIONS BOTTOM LEFT LEFTRIGHT LOWERLEFT LOWERRIGHT RIGHT TOP UPDOWN UPPERLEFT UPPERRIGHT lt pointselection gt ALLPOINTS NEARESTNPOINTS OCTANTNPOINTS lt pointstoplot gt SURFACESONLY ALL lt printerdriver gt HPGL HPGL2 PS EPS lt printrendertype gt VECTOR IMAGE lt quickcolormode gt LINECOLOR FILLCOLOR TEXTCOLOR lt readdataoption gt NEW APPEND REPLACE lt relop gt lt gt lt gt not equalto lt gt not equal to GREATER THAN LESSTHAN EQUALTO NOTEQUALTO lt resizefilter gt TEXTUREFILTER LANCZOS2FILTER LANCZOS3FILTER BOX FILTER TRIANGLEFILTER BELLFILTER BSPLINEFILTER CUBICFILTER MITCHELFILTER GAUSSIANFILTER lt rgblegendorientation gt ORIENTRGB ORIENTGBR ORIENTBRG ORIENTRBG ORIENTBGR ORIENTGRB lt rgbmode gt SPECIFYRGB SPECIFYRG SPECIFYRB SPECIFYGB lt rotateaxis gt X Y Z ALPHA THETA PSI HORZROLLERBALL VERTROLLERBALL TWIST ABOUTVECTOR lt rotateoriginlocation gt VIEWER DEFINEDORIGIN lt rotationmode gt XYZAXIS SPHERICAL ROLLERBALL lt scope gt LOCAL GLOBAL lt set gt lt setspecifier gt lt setspecifier gt lt setspecifier gt lt integer gt
47. CONTOURCOLORMAP SMRAINBOW COLORMAPCONTROL RESETTOFACTORY COLORMAPCONTROL RESETTOFACTORY no parameters Redistribute the control points and reset the RGB values for the currently active color map This is equivalent to clicking Reset on the Color Map dialog 46 Example coLorMAPCONTROL RESETTOFACTORY COMPATIBILITY Syntax COMPATIBILITY optional parameters Description Allow datasharing access and setting without warning Optional Parameters Parameter Syntax Default Notes ALLOWDATASHARING lt boolean gt TRUE If FALSE Tecplot will not allow data sharing This may be neces sary to use older add ons that can not handle shared data USEVLOTEXTFORMATTING lt boolean gt TRUE If FALSE allows Tecplot to dis play text subscripts and super scripts created with older Tecplot versions without automatically con verting the text to the new format ting Example The following commands turn on datasharing COMPATIBILITY ALLOWDATASHARING TRUE CONTINUE Syntax I CONTINUE Description Transfer control back to nearest LOOP or WHILE Example s 1oop 10 CONTINUE 47 Chapter 5 Macro Commands ENDLOOP CONTOURLABELS Required Control Option Description The different commands in the CONTOURLABELS compound function family are described separately in the following sections The CONTOURLABELS compound functions are C
48. Change the default text settings GSV DELAY Delay execution of Tecplot Action DELETEAUXDATA Delete auxilary data attached to specified Action object DELETELINEMAPS Delete Line mappings Action DELETEVARS Delete variables Action DELETEZONES Delete zones Action DOUBLEBUFFER Enable or disable double buffering or swap Action buffers DRAWGRAPHICS Enable or disable drawing of graphics to the Action screen DROPDIALOG Drop a dialog see LAUNCHDIALOG Action DUPLICATELINEMAP Duplicate an Line mapping Action 1 DUPLICATEZONE Duplicate a zone Action ELSE Conditionally handle macro commands Action ELSEIF Conditionally handle macro commands Action ENDIF End of IF ENDIF construct Control ENDLOOP End of LOOP ENDLOOP construct Control ENDMACROFUNCTION End of MACROFUNCTION Control ENDMACROFUNCTION construct ENDWHILE End of WHILE ENDWHILE construct Control EXPORT Export the current plot to a file Action EXPORTCANCEL Cancel the current export Action EXPORTFINISH Signals completion of an animation sequence Action EXPORTNEXTFRAME Records the next frame of an animation Action EXPORTSETUP Change the file export settings GSV EXPORTSTART Signals the start of an animation sequence Action 15 Chapter 4 Macro Command Summary Command Description Ty
49. Drop a Tecplot interface dialog when lt dialogname gt can be one of COLORMAP EQUATION PLOTATTRIBUTES QUICKEDIT QUICKMACROPANEL or MACROVIEWER This command is mainly useful for the Tecplot demo To launch a dialog use LAUNCHDIALOG DROPDIALOG MACROVIEWER 71 Chapter 5 Macro Commands DUPLICA TELINEMAP Syntax DUPLICATELINEMAP SOURCEMAP lt integer gt DESTINATIONMAP lt integer gt Description Copy attributes from an existing Line mapping to another Required Parameters Parameter Syntax Notes SOURCEMAP lt integer gt Line mapping from which to copy DESTINATIONMAP lt integer gt The destination can either be the number of an existing map or greater than the current number of maps If you choose the latter a new Line mapping will be created Example Copy attributes of Line mapping 3 to Line mapping 7 DUPLICATELINEMAP SOURCEMAP 3 DESTINATIONMAP 7 DUPLICATEZONE Syntax DUPLICATEZONE SOURCEZONE lt integer gt optional parameters Description Make a copy of an existing zone You can assign index ranges to create a new zone which is a subset of the source zone Required Parameter Parameters Syntax Notes SOURCEZONE lt integer gt Zone to duplicate the source zone 72 Optional Parameters Parameters Syntax Default Notes IRANGE See notes on index ranges for ALTERDAT
50. FALSE INCLUDEGEOM FALSE REDRAW Syntax I REDRAW optional parameters 163 Chapter 5 Macro Commands Description Redraw the current frame Optional Parameter Parameter Syntax Default Notes DOFULLDRAWING lt boolean gt TRUE Set to FALSE to draw only a trace of the data in the frame Example REDRAW REDRAWALL Syntax REDRAWALL optional parameters Description Redraw all frames Optional Parameter Parameter Syntax Default Notes DOFULLDRAWING lt boolean gt TRUE Set to FALSE to draw only a trace of the data in each frame Example 1 REDRAWALL REMOVEVAR Syntax REMOVEVAR lt macrouserdefvar gt Description Remove a user defined macro variable This frees up space so another user defined macro variable can be defined Example Remove the macro variable ABC REMOVEVAR ABC 164 RENAMEDATASETVAR Syntax RENAMEDATASETVAR VAR lt integer gt NAME lt string gt no optional parameters Description Rename a data set variable in Tecplot Required Parameters Parameter Syntax Notes VAR lt integer gt Specify the variable number NAME lt string gt Specify the new variable name Example Rename variable to be Banana RENAMEDATASETVAR VAR 1 NAME Banana RENAMEDATASETZONE Syntax RENAMEDATASETZONE ZONE lt integer gt NAME lt string gt
51. FALSE SHOWONOPPOSITEEDGE lt boolean gt 3D only Default FALSE SHOWONALLAXES lt boolean gt Polar R only Default TRUE SHOWATAXISINTERSECTION lt boolean gt SKIP lt integer gt ERASEBEHINDLABELS lt boolean gt NUMFORMAT lt lt numberformat gt gt TEXTSHAPE lt lt textshape gt gt OFFSET lt op gt lt dexp gt Not allowed to change size units LABELALIGNMENT lt labelalignment gt parameter ANGLE lt op gt lt dexp gt COLOR lt color gt Example Change the color for X axis tick mark labels in a 2 D plot to be red TWODAXIS XDETAIL TICKLABEL COLOR RED lt lt tickmarkdetail gt gt Description Assign attributes for axis tick marks 226 Expands to Syntax Notes SHOWONAXISLINE lt boolean gt Default TRUE SHOWONGRIDBORDERMIN lt boolean gt Non 3D only Default FALSE SHOWONGRIDBORDERMAX lt boolean gt Non 3D only Default FALSE SHOWONOPPOSITEEDGE lt boolean gt 3D only Default FALSE SHOWONALLAXES lt boolean gt Polar R only Default TRUE TICKDIRECTION lt tickdirection gt LENGTH lt op gt lt dexp gt LINETHICKNESS lt op gt lt dexp gt NUMMINORTICKS lt integer gt MINORLENGTH lt double gt MINORLINETHICKNESS lt double gt Example Set the tick mark length to 2 percent for the second Y axis in an XY plot XYLINEAXIS YDETAIL 2 TICKS LENGTH 2 SHOWONGRIDBORDERMIN TRUE lt
52. INTEGER4 GeomType INTEGER4 LinePattern double PatternLength double LineThickness INTEGER4 NumEllipsePts INTEGER4 ArrowheadSple INTEGER4 ArrowheadAttachment double ArrowheadSize double ArrowheadAngle INTEGER4 Scope INTEGER4 NumSegments 287 Chapter 11 Writing Binary Data for Loading into Tecplot INTEGER4 NumSegPts float XGeomData float YGeomData float ZGeomData char MFC Return Value o if successful 1 if unsuccessful Parameters xPos Pointer to double value specifying the X position of the geometry YPos Pointer to double value specifying the Y position of the geometry ZPos Pointer to double value specifying the Z position of the geometry PosCoordMode Pointer to integer value specifying the position coordinate system 0 Grid 1 Frame AttachToZone Pointer to integer flag to signal that the geometry is attached to a zone Zone Pointer to integer value specifying the number of the zone to attach to Color Pointer to integer value specifying the color to assign to the geometry 0 Black 8 Custom1 1 Red 9 Custom2 2 Green 10 Custom3 3 Blue 11 Custom4 4 Cyan 12 Custom5 5 Yellow 13 Custom6 288 Binary Data File Function Reference 6 Purple 14 Custom7 7 White 15 Custom8 FillColor Pointer to integer value specifying the color used to fill the geometry See Color above IsFilled Pointer to integer flag to specify if geometry is to be filled GeomT
53. Panel Action ADDONCOMMAND Execute command in an add on Action ALTERDATA Execute an equation to alter data Action ANIMATECONTOURLEVELS Show an animation of contour levels Action ANIMATEIJKBLANKING Show an animation of IJK blanking Action ANIMATEIJKPLANES Show an animation of IJK planes Action 13 Chapter 4 Macro Command Summary 2 or 3 D Command Description Type ANIMATESLICES Show an animation of currently defined slices Action ANIMATESTREAM Show an animation of stream time marks or Action dashes ANIMATELINEMAPS Show an animation of Line mappings Action ANIMATEZONES Show an animation of zones Action ATTACHDATASET Attach a data set to the current frame Action ATTACHGEOM Attach a geometry to the current frame Action ATTACHTEXT Attach a text to the current frame Action AVERAGECELLCENTERDATA Interpolate cell centered data to cell nodes Action BASICCOLOR Change the RGB values for basic colors GSV BASICSIZE Change drop down menu size defaults for GSV things like fonts symbols line thicknesses and so forth BLANKING Change value or IJK blanking settings FSV BRANCHCONNECTIVITY Branch connectivity data from a zone FSV BRANCHFIELDDATAVAR Branch a variable from sharing in a zone FSV BREAK Break out of current LOOP or WHILE Control COLORMAP Change
54. Retrieve the previous view from the view stack Each frame mode within each frame maintains its own view stack VIEW LAST will not reverse alterations to data S VIEW LAST V TEW MAKECURRENTVIEWNICE Syntax Description Example S VIEW MAKECURRENTVIEWNICE no parameters Shifts axis to make axis line values nice without changing the extents of the window Only works in Sketch XY 2D VIEW MAKECURRENTVIEWNICE VIEW NICEFIT Syntax Description Example S VIEW NICEFIT no parameters Change view to make the extents of the frame neatly hold the plot with integer values for axis labels Only works in Sketch X Y 2D VIEW NICEFIT 192 Syntax Description Example Syntax Description Example Syntax Description Example VIEW PASTE S VIEW PASTE no parameters Retrieve the view from the view paste buffer and assign it to the current frame VIEW PASTE VIEW PUSH S VIEW PUSH no parameters Instruct Tecplot to push the current view onto the view stack A view will not be pushed if the current view is the same as the top view on the stack Note that commands VIEW AXISFIT VIEW CENTER VIEW DATAFIT VIEW FIT and VIEW ZOOM automatically push a view onto the stack Tecplot automatically pushes the current view onto the stack when a REDRAW command is issued and the current view is different from the top view on the view stack S VIEW PUSH SV TEW RESETT
55. XYPOS X 3 Y 3 WIDTH HEIGHT 9 i Koj ENDIF EXPORT Syntax EXPORT no parameters Description Export an image file from Tecplot See the EXPORTSETUP command for details on setting up the exported image type The EXPORT command is not valid for animation formats AVI and Raster Metafile Example EXPORTSETUP EXPORTFORMAT PNG 1 EXPORT 75 Chapter 5 Macro Commands EXPORTCANCEL Syntax EXPORTCANCEL no parameters Description Cancel out of the current export animation sequence The animation file Example being generated is removed EXPORTCANCEL EXPORTFINISH Syntax EXPORTFINISH no parameters Description Signals the completion of an animation sequence and causes the Example animation file to be created You must call EXPORTSTART prior to using EXPORTFINISH This command is only valid for animation formats AVI and Raster Metafile You may use the EXPORTISRECORDING intrinsic variable to make sure that an animation sequence has been initiated EXPORTSETUP EXPORTFNAMES rotate avi EXPORTFORMAT AVI EXPORTSTART LOOP 5 ROTATE3DVIEW X ANGLE 5 EXPORTNEXTFRAME ENDLOOP IF EXPORTISRECORDING s YES EXPORTFINISH ENDIF 76 Syntax Description Example Syntax Description EXPORTNEXTFRAME EXPORTNEXTFRAME no parameters Records the next frame of an animat
56. above three is not recomended although setting below 1 0 will result in the use of a faster texture algo rithm 124 Parameter Syntax Notes PERCENTAGEOFPOINTSTOKEEP lt integer gt Sets the percentage of points to keep in a frame when a frame is approximated See the Tecplot User s Manual for a complete description PICKHANDLEWIDTH lt op gt lt dexp gt Value is in inches on the screen PLOTAPPROXIMATIONMODE lt plotapproximationmode gt Specifies the mode in which you want the plots to be approximated See the Tecplot User s Manual for a complete description of each mode PRINTDEBUG lt boolean gt If TRUE debugging information is sent to the standard output QUICKCOLORMODE lt quickcolormode gt Choose objects for color changes made using the Quick Edit dialog ROTATION Settings for interactive rotations in 3 D ROTATIONMODE lt rotationmode gt CURRENTANGLE lt op gt lt dexp gt SMALLANGLE lt op gt lt dexp gt MEDIUMANGLE lt op gt lt dexp gt LARGEANGLE lt op gt lt dexp gt ROTATEDEGPERFRAMEUNIT lt integer gt SHOWGEOMS lt boolean gt ROTATEDEGPERFRAMEUNIT lt integer gt RULERPADDING lt op gt lt dexp gt Distance between workarea ruler and clipping edge for the paper and frames Units are inches RULERTHICKNESS lt op gt lt dexp gt Value is in inches on the screen SCALE Settings for interactive scaling STEPSIZ
57. and destination zones presuming that the zones are FE and have the same element type and number of nodes Required Parameters Parameter Syntax Notes SOURCEZONE lt integer gt DESTINATIONZONE lt integer gt Example Shares the conectivity of the second zone with the sixth zone SHARECONNECTIVITY SOURCEZONE 2 DESTINATIONZONE 6 o SISHAREFIELDDATAVAR Syntax SHAREFIELDDATAVAR 173 Chapter 5 Macro Commands SOURCEZONE lt integer gt VAR lt integer gt DESTINATIONZONE lt integer gt no optional parameters Description Allows sharing of the specified variable from the soure zone to the destination zone Zone must be of the same type ordered or FE and dimensions Cell centered variables in FE must have the same number of cells Sharing is not allowed if either zone has global face neighbors Required Parameters Parameter Syntax Notes SOURCEZONE lt integer gt VAR lt integer gt DESTINATIONZONE lt integer gt Example Shares the third variable from the second zone with the fifth zone SHAREFIELDDATAVAR SOURCEZONE 2 VAR 3 DESTINATIONZONE 5 SHIFTLINEMAPSTOBOTTOM Syntax SHIFTLINEMAPSTOBOTTOM lt sef gt no parameters Description Shift a list of Line mappings to the bottom of the Line mapping list This in effect causes the selected Line mappings to be drawn last Example Shift Line mappings 2 an
58. apply to all frames Optional Parameters Parameter Syntax Notes FRAMEHEADERHEIGHT lt op gt lt dexp gt Value is in inches SNAPTOGRID lt boolean gt Even if set to TRUE Tecplot may not allow snapping in some situations FRAMEHEADERFORMAT lt string gt The lt string gt contains the text that appears in each of Tec plot s frame headers This string typically contains dynamic text See Section 16 1 11 Dynamic Text of the Tecplot User s Manual The default string is amp FRAMENAME amp DATE amp DATASETTITLE SNAPTOPAPER lt boolean gt Even if set to TRUE Tecplot may not allow snapping in some situations 102 Example Customize the frame header text and set the frame header height to be 0 25 inches GLOBALFRAME FRAMEHEADERFORMAT My frame the current date is amp Date amp Time FRAMEHEADERHEIGHT 0 25 GLOBALISOSURFACE Syntax GLOBALISOSURFACE optional parameters Description A SetValue command which changes global attributes associated with iso surfaces Optional Parameters Parameter Syntax Notes SHOW lt boolean gt ISOSURFACESELECTION lt isosurfaceselection gt ISOVALUE1 lt double gt ISOVALUE2 lt double gt ISOVALUE3 lt double gt MESH SHOW lt boolean gt COLOR lt color gt LINETHICKNESS lt double gt CONTOUR SHOW lt boolean gt USELIGHTINGEFFECT l
59. are turned off Makes the middle mouse button be Redraw Makes the right mouse button revert to Selector Makes the default number of passes for smoothing 20 Turns off the status line INTERFACE SHOWFRAMEBORDERSWHENOFF TRUE MOUSEACTIONS MIDDLEBUTTON REDRAW MOUSEACTIONS RIGHTBUTTON REVERTTOSELECT DATA NUMSMOOTHPASSES 20 SHOWSTATUSLINE NO 127 Chapter 5 Macro Commands INVERSEDISTINTERPOLATE Syntax INVERSEDISTINTERPOLATE DESTINATIONZONE lt integer gt optional parameters Description Interpolate selected variables from one or more zones onto a destination zone using the inverse distance method Required Parameter Parameters Syntax Notes DESTINATIONZONE lt integer gt Zone to interpolate to Optional Parameters Parameters Syntax Default Notes SOURCEZONES lt set gt All zones except des tination zone VARLIST lt set gt All variables except Choose the variables to interpolate The spatial variables spatial variables X Y and Z if 3 D are not allowed INVDISTEXPONENT 3 5 lt dexp gt INVDISTMINRADIUS 0 0 lt dexp gt INTERPPTSELECTION OCTANTNPOINTS lt intrpptselection gt INTERPNPOINTS 8 lt integer gt Example Interpolate variables 7 10 from zone 4 to zone 2 INVERSEDISTINTERPOLATE SOURCEZONES 4 DESTINATIONZONE 2 VARLIS
60. axis to view the region defined by the rectangle with corners at X1 Y1 and X2 Y2 For 3 D orthographic plots the view is translated and scaled to fit the region For 3 D perspective plots the view is rotated about the viewer and scaled to fit the region X1 and so forth are measured in grid coordinates Required Parameters Parameters Syntax Notes X1 lt dexp gt Y1 lt dexp gt X2 lt dexp gt Y2 lt dexp gt Example Zoom so the rectangular region with corners at 1 0 and 7 9 are in view VIEW ZOOM X1 1 Yl 0 X2 7 Y2 9 195 Chapter 5 Macro Commands Syntax Description Example Description WHILE END WHILE WHILE lt conditionalexp gt ENDWHILE Continue to execute a set of commands until a conditional expression is false Execute a set of commands until the macro variable myvar is greater than 1 0 VARSET myvar 0 0 WHILE myvar lt 1 0 VARSET myvar 0 01 ENDWHILE WORKSPACEVIEW Required Control Option The different commands in the WORKSPACEVIEW compound function family are described separately in the following sections The WORKSPACEVIEW compound functions are WORKSPACEVIEW FITALLFRAMES WORKSPACEVIEW FITPAPER WORKSPACEVIEW FITSELECTEDFRAMES WORKSPACEVIEW LASTVIEW WORKSPACEVIEW MAXIMIZE WORKSPACEVIEW TRANSLATE WORKSPACEVIEW UNMAXIMIZE WORKSPACEVIEW ZOOM
61. be used with other logical operators or with the conditional operator Examples of common expressions used in the Tecplot macro language follow note that all expressions evaluate to a simple lt dexp gt value I b 2 gt 4 al e If a gt 0 0 varSet root1 b sqrt b 2 4 a c 2 al varSet root2 b sqrt b 2 4 a c 2 al EndIf EndIf VarSet area PI r 2 In addition to the more common operators mentioned above some relational and logical operators are provided to form compound expressions A relation lt relation gt may be con structed and used in conjunction with the conditional operator and to form compound expressions The conditional operator and has the following syntax lt relation gt lt expression if true gt lt expression if false gt where e lt relation gt is a conditional statement that evaluates to true or false and is formed by any two subexpressions which are compared to one another with one of the relational opera tors gt gt lt lt in combination with zero or more of the logical operators logical Not logical And amp amp and logical Or e lt expression if true gt is the lt expression gt that is evaluated if the lt relation gt condition evaluates to TRUE e lt expression if false gt is the lt expression gt that is evaluated if the lt relation gt condition evalua
62. currently assigned to X and Y as referring to R and 0 and convert them to X and Y In 3 D X Y and Z refer to R 0 and w Tecplot has addition capabilities for transforming coordinates please see TRANSFORMCOORDINATES Example Convert zones 1 2 and 3 from polar to rectangular POLARTORECTANGULAR 1 3 POLARVIEW Syntax POLARVIEW optional parameters Description Sets the viewing style for polar plots in a layout Required Parameters Parameter Syntax Notes EXTENTS lt lt rect gt gt View extents of transformed X amp Y in polar plots Numbers listed are in the form of grid units 153 Chapter 5 Macro Commands Example Syntax Description Example Syntax Description Set the view of the polar plot to view the full extents of the plot area POLARVIEW EXTENTS X1 10 Y1 10 X2 90 Y2 90 PRINT PRINT no parameters Print the current layout to a printer or send the print instructions to a file Use the PRINTSETUP SetValue command to configure printing PRINT PRINTSETUP PRINTSETUP optional parameters A SetValue command that sets the attributes for printing Use PRINT to do the actual printing See EXPORTSETUP and EXPORT if you intend to create image files destined for desktop publishing programs 154 Optional Parameters Parameter Syntax Notes PRINTFNAME
63. files configuring 85 OUTPUTASCIIDATAFILE 85 OUTPUTBINARYDATAFILE 85 OUTPUTLAYOUTFILE 85 OUTPUTLAYOUTPACKAGEFILE 85 Overrides color map 211 P Paper 216 color 141 fit within workspace view 197 set specifications 141 show grid 141 show ruler 141 papersize subcommand 216 Parameter Assignment Values 231 Parameter assignments 10 231 Parameter subcommands 10 205 Parameters data setup command 64 Parameters for dynamic frame attributes 92 Paste 149 from view paste buffer 193 Paths configuring for output 85 Pattern length 35 Pause macro execution 142 Pause Tecplot execution 67 Pen plotters 217 PERCENTAGEOFPOINTSTOKEEP 125 Pick copy picked objects 146 delete picked objects 146 global edit on picked objects 147 magnify picked objects 149 mouse mode set 150 move picked objects 150 object at given location 143 objects in rectangle 144 objects of type 144 objects to delete 146 paste picked objects from buffer 149 pop picked objects 149 push picked objects back 150 Pick commands 142 151 PICKHANDLEWIDTH 125 Placing text in center of frame 38 Planes 245 animate command 29 Plot layers field plots 84 Turning Line layers on and off 135 PLOTAPPROXIMATIONMODE 125 plotterpenmap subcommand 217 Points write to file 200 POINTTEXTSIZES 40 Polar axes setting attributes 152 Polar coordinates converting to rectangular 153 Polyline extracting data from 2D or 3D field plots 80 raw data 251 Pop frame 88 Pop frame at specified p
64. gt lt lt initialdialogplacement gt gt lt lt initialdialogplacement gt gt lt lt initialdialogplacement gt gt The INITIALDIALOGPLACMENT parameter may only appear in the tecplot config file You may specify the initial placement of the indicated dialogs Note that this applies only to the first time the dialogs are launched within a Tecplot session Subsequent launches will place the dialog at the most recent position Initial dialog placement is relative to the main Tecplot window INITIALPLOTFIRSTZONEONLY lt boolean gt If TRUE only the first enabled zone is activated Default shows all zones except from within a layout INITIALPLOTTYPE lt lt plottype gt gt Default is Automatic INTERRUPTCHECKINGFREQUENCY lt integer gt Set the number of milliseconds between checks for a key or button press by the user to interrupt process ing in Tecplot 122 Parameter Syntax Notes LISTCOMMANDSINMACROVIEWER lt boolean gt If FALSE macro commands are displayed in full one at a time LOADADDONSUSINGLAZYRELOCATE lt boolean gt If set to FALSE all add on symbols are loaded immediately MAXCUSTOMCOLORSININTERFACE lt integer gt UNIX only Valid values are 1 to 56 Some UNIX displays cannot allocate enough colors for the Tecplot inter face Use this option to limit the number of custom colors displayed in the Tecplot interface MAXTRACE
65. gt enclosed within and delimiters it expects to find the condi tional operator and and the two required expressions following the specified relation 240 cHaPTERs Macro Variables Macro variables are identified by a sequence of characters surrounded by vertical bars Some examples are myvariable Loop 1 HOME Macro variables can be placed anywhere within a macro command Upper case and lower case characters are treated the same For example ABC and aBc represent the same variable Macro variables will be expanded to their value at the time the macro statement is processed Example The following macro commands will result in a rotation of the data about the X axis by 10 degrees VARSET al 10 ROTATE X ANGLE al 241 Chapter 8 Macro Variables 8 1 Internal Variables The following table lists variables that are maintained by Tecplot which may be referenced by macro commands Variables Notes AUXDATASET Retrieve auxilary data from a data set AUXDATASET Reynolds would retrieve auxilary data Reynolds AUXFRAME Retrieve auxilary data from a frame IAUXFRAME Byronl would retrieve auxilary data Byron from the current frame AUXZONE Retrieve auxilary data from a zone AUXZONE 3 BClI would retrieve auxiliary data BC from zone 3 only AXISMAXA Maximu
66. ignored by Tecplot but may be used by add ons FORTRAN Syntax 279 Chapter 11 Writing Binary Data for Loading into Tecplot INTEGER 4 FUNCTION TECUSR100 S CHAR S C Syntax include TECIO h INTEGER4 TECUSR100 CHAR S Return Value o if successful 1 if unsuccessful Parameters s The character string to write to the data file Must be null terminated TECZAUXSTR100 Summary Writes an auxiliary data item for the current zone to the data file Must be called after TECZNE100 for the desired zone Auxiliary data may be used by text macros equations if it is numeric and add ons It may be viewed directly in the AuxData page of the Data Set Information dialog FORTRAN Syntax INTEGER 4 FUNCTION TECZAUXSTR100 Name amp Value CHARACTER Name CHARACTER Value C Syntax include TECIO h INTEGER4 TECZAUXSTR100 char Name char Value Return Value o if successful 1 if unsuccessful Parameters Name The name of the auxiliary data item If a data item with this name already exists its value will be overwritten Must be a null terminated character string Value The auxiliary data value to be written to the data file Must be a null terminated character string 280 Binary Data File Function Reference TECZNE100 Summary Writes header information about the next zone to be added to the data file After TECZNE100 is called you must call TECDAT100 one or more times and t
67. macro file and support all of the common oper ators and functions familiar to most C and FORTRAN programmers Arithmetic operators include the common multiply divide add and subtract and as well as a few others and that are worth noting The raise operator or returns the result of raising the first number by the second Expressions may also contain macro variables and an assortment of useful functions and constants Following are tables of supported functions and constants and a short explanation for each Table 7 2 Functions supported by Tecplot abs x Absolute value of x acos x Arc cosine of x between 1 and 1 Return an angle between 0 and 7 radians asin x Arc sine of x between 1 and 1 Return an angle between 7 2 and 7 2 radians atan x Arc tangent of x Return an angle between n and 7 radians atan2 y x Arc tangent of y x Return an angle between n and n radians ceil x Smallest integer larger than or equal to x cos x Cosine of x in radians cosh x Hyperbolic cosine of x exp x Exponential of x floor x Largest integer smaller than or equal to x frac x Fractional part of x int x Integer part of x log x Natural logarithm of x log10 x Logarithm to the base 10 of x max x y Larger of x or y min x y Smaller of x or y pow x y x sin x Sine of x in radians 237 Chapter
68. macro file by going to the File menu and selecting the Macro sub menu fol lowed by the Play option A dialog appears choose the macro to play If you want to debug a macro file go to the File menu and selecting the Macro sub menu fol lowed by the View option The Macro Viewer dialog appears so you can load in a macro When the macro is loaded Tecplot waits at the first macro command for you to step through the commands See Chapter 27 Macro Commands in the Tecplot User s Manual for com plete details on how to use the Macro Viewer 2 4 Running Macros from the Quick Macro Panel Macros that you use frequently or want rapid access to may be defined as macro functions within a special file called tecplot mcr in either the current directory your home directory or the Tecplot home directory When Tecplot starts it looks for this file in each of those directo ries in turn If Tecplot finds the file it loads the macro definitions and associates functions to buttons on the Quick Macro Panel in the Tools menu You can have Tecplot load your own macro function file by using the qm flag on the command line The following command runs Tecplot and installs the macro functions in the file myteccmd mcr into the Quick Macro Panel tecplot qm myteccmd mcr You can have a macro function add a button to the Quick Macro Panel By default all macro functions defined in the tecplot mer file will add a button to the Quick Macro Panel those d
69. position of the geometry PosCoordMode Pointer to integer value specifying the position coordinate system 0 Grid 1 Frame AttachToZone Pointer to integer flag for to signal that the text is attached to a zone Zone Pointer to integer value specifying the zone number to attach to Font Pointer to integer value specifying the font 0 Helvetica 6 Times Italic 1 Helvetica Bold 7 Times Bold 2 Greek 8 Times Italic Bold 3 Math 9 Courier 4 User Defined 10 Courier Bold 5 Times FontHeightUnits Pointer to integer value specifying the font height units 0 Grid 2 Point 1 Frame FontHeight Pointer to double value specifying the font height BoxType 295 Chapter 11 Writing Binary Data for Loading into Tecplot Pointer to integer value specifying the box type 0 None 2 Hollow 1 Filled BoxMargin Pointer to double value specifying the box margin in frame units BoxLineThickness Pointer to double value specifying the box line thickness in frame units BoxColor Pointer to integer value specifying the color to assign to the box 0 Black 8 Custom1 1 Red 9 Custom2 2 Green 10 Custom3 3 Blue 11 Custom4 4 Cyan 12 Custom5 5 Yellow 13 Custom6 6 Purple 14 Custom7 7 White 15 Custom8s BoxFillColor Pointer to integer value specifying the fill color to assign to the box See BoxColor Angle Pointer to double value specifying the text angle in degrees Anchor Pointer to integer value specifying where to
70. sizing 103 108 vector 116 VECTDEFLEN 92 VECTMINLEN 92 Vector attributes 82 Vector plot attributes 116 Vector variables 116 minimum maximum as variables 243 Vectors arrowhead attributes 118 length reset 167 reference vector 117 118 relative length 118 show 84 uniform length 118 Vertical bars C l s 241 View axis fit 188 189 axis nice fit 190 center 190 copy 191 data fit 191 fit 191 fit all frames 197 fit paper in workspace 197 fit selected frames 197 last 192 magnify 194 maximizing 198 199 nice fit 192 335 Index paste 193 xyz subcommand 228 return to last view 198 rotate 168 Y shift workspace 198 Yes No translate 194 prompt for 158 zooming workspace 199 View commands 188 195 196 200 Z View compound function family 188 View stack placing a view on the stack 193 retrieve last view 192 Viewer Debugger 3 volume attributes 83 Volume objects 227 Volume surfaces create FE surfaces 58 VOLUMEMODE 83 volumeobjectstoplot subcommand 227 Ww While command 196 Workspace color map dialog 46 expanding 198 frame 88 Workspace commands 196 200 Writing color map 200 data set 201 stylesheet 202 Writing current colormap to file 200 X X axis gridlines 213 XORCOLOR 127 XY raw data 252 XY Line axes attributes assigning 203 XY line plots coordinate scale 232 curve information 232 curve type 232 error bars 233 xy subcommand 228 XY vectors 228 XYZ raw data 252 vectors 228 Z clip 114 183 Zeb
71. start again A blank default frame will be Example created for you NEWLAYOUT 139 Chapter 5 Macro Commands OPENLA YOUT Syntax OPENLAYOUT lt string gt optional parameters Description Open and read in a new layout file The lt string gt is the name of the file to open Optional Parameters Parameter Syntax Default Notes ALTDATALOADINSTRUCTIONS Null Specify alternate data load instructions lt string gt Tecplot data files This is a list of filenames to use as replacements for data files referenced in the layout file Use to enclose file names that contain spaces or the symbol By default separate file names listed in the ALT DATALOADINSTRUCTIONS are assigned to successive data sets that are referenced within a layout file If you have a data set that references multiple data files use the plus symbol to group file names Non Tecplot formats including data being input via a data loader add on This is a list of instructions that are passed on to the loader APPEND lt boolean gt FALSE Set to FALSE if you want Tecplot to delete the current lay out prior to reading in the new one Examples Example 1 Open a new layout file called abc lay and replace the data file referenced in the layout file with t plt OPENLAYOUT abc lay ALTDATALOADINSTRUCTIONS t plt Example 2 Open a new layout file called multiframe lay and replace the first d
72. the I dimension M is the J dimension and N is the K dimension If the data is finite element that is the zone format is FEBLOCK or FEPOINT then L is the number of data points M is the number of elements and N is set according to the following chart ELEMENT TYPE N Triangle 0 Quadrilateral 1 Tetrahedron 2 Brick 3 ZoneFormat Must be set to one of BLOCK POINT FEBLOCK or FEPOINT Must be null terminated DupList This parameter specifies a list of variables to duplicate from the preceding zone For a complete explanation of the DupList parameter see the Tecplot User s Manual Must be null terminated The DupList parameter is a string of the following form nl n2 nn FECONNECT where nJ nn are the numbers of the variables to duplicate If the zone is finite element you may optionally include FECONNECT which will duplicate the connectivity list from the last zone Notes for using the DupList parameter 298 Example Programs e You cannot use the DupList parameter for the first zone since in that case there is nothing to duplicate e If you use FECONNECT you cannot call TECNOD for this zone since FECONNECT specifies that the entire connectivity list from the previous zone will be duplicated e For finite element zones you can pass FECONNECT to duplicate only the connectivity list e You may pass either NULL or a 0 length string if you are not using this par
73. the color used to fill the geometry See Color above IsFilled Pointer to integer flag to specify if geometry is to be filled GeomType Pointer to integer value specifying the geometry type 0 2DLineSegments 3 Circle 1 Rectangle 4 Ellipse 2 Square 5 3DLineSegments LinePattern Pointer to integer value specifying the line pattern 0 Solid 3 Dotted 1 Dashed 4 LongDash 2 DashDot 5 DashDotDot PatternLength Pointer to double value specifying the pattern length in frame units LineThickness Pointer to double value specifying the line thickness in frame units NumEllipsePts Pointer to integer value specifying the number of points to use for circles and ellipses The value must be greater than 0 ArrowheadStyle Pointer to integer value specifying the arrowhead style 0 Plain 2 Hollow 1 Filled ArrowheadAttachment Pointer to integer value specifying where to attach arrowheads 0 None 2 End 1 Beginning 3 Both 271 Chapter 11 Writing Binary Data for Loading into Tecplot ArrowheadSize Pointer to double value specifying the arrowhead size in frame units ArrowheadAngle Pointer to double value specifying the arrowhead angle in degrees Scope Pointer to integer value specifying the scope O global 1 local Clipping Specifies whether to clip the geometry that is only plot the geometry within to the viewport or the frame 0 ClipToViewport ClipToFrame NumSegments Pointer to integer value specifying t
74. the symbol shape for symbols drawn with line map 3 to use circles LINEMAP 3 SYMBOLS SYMBOLSHAPE ISASCII FALSE GEOMSHAPE CIRCLE lt lt textbox gt gt Description Change settings for the optional box around a text label Expands to Syntax Notes BOXTYPE lt textboxtype gt MARGIN lt op gt lt dexp gt LINETHICKNESS lt op gt lt dexp gt COLOR lt color gt FILLCOLOR lt color gt 224 Example See example for lt lt textshape gt gt lt lt textshape gt gt Description Change settings related to text font and character height Expands to Syntax Notes FONT lt font gt SIZEUNITS lt sizeunits gt HEIGHT lt op gt lt dexp gt Example Add a text label in the center of the frame using Times Roman font Make the text height 12 point Include a box around the text with a line thickness of one percent ATTACHTEXT xypos X 50 Y 50 TEXTSHAPE FONT TIMES BOX BOXTYPE HOLLOW LINETHICKNESS 1 TEXT Hi Mom 225 Chapter 6 Parameter Subcommands lt lt ticklabeldetail gt gt Description Change settings for the text used to label axis tick marks Expands to Syntax Notes SHOWONAXISLINE lt boolean gt Default TRUE SHOWONGRIDBORDERMIN lt boolean gt Non 3D only Default FALSE SHOWONGRIDBORDERMAX lt boolean gt Non 3D only Default
75. tion SMOOTHBNDRYCOND lt boundarycondition gt NUMSMOOTHPASSES lt op gt lt integer gt SMOOTHWEIGHT lt op gt lt dexp gt INVDISTEXPONENT lt op gt lt dexp gt INVDISTMINRADIUS lt op gt lt dexp gt LINEARINTERPCONST lt op gt lt dexp gt LINEARINTERPMODE lt linearinterpmode gt INTERPPTSELECTION lt pointselection gt INTERPNPOINTS lt op gt lt integer gt KRIGRANGE lt op gt lt dexp gt KRIGZEROVALUE lt op gt lt dexp gt KRIGDRIFT lt drift gt DERIVATIVEBOUNDARY lt derivpos gt TRIANGLEKEEPFACTOR lt op gt lt dexp gt VARIABLEDERIVATIONMETHOD lt ACCURATE or FAST gt Default ACCURATE Note that this CONTLINECREATEMODE lt ONEZONEPERCONTOUR is a config file option only LEVER or ONEZONEPER INDEPENDENTPOLYLINE gt ENABLEDELAYS lt boolean gt Enable or disable delays in macro commands ENABLEINTERRUPTS lt boolean gt Enable or disable user interrupts ENABLEPAUSES lt boolean gt Enable or disable pause ENABLEWARNINGS lt boolean gt Enable or disable warning dialogs FEBOUNDARYUSESVALUEBLANKING lt boolean gt INITIALDIALOGPLACEMENT COLORMAPDIALOG EQUATIONDIALOG MACROVIEWERDIALOG ZONEMAPDIALOG PROBEDIALOG QUICKMACRODIALOG VALUEBLANKINGDIALOG QUICKEDITDIALOG lt lt initialdialogplacement gt gt lt lt initialdialogplacement gt gt lt lt initialdialogplacement gt gt lt lt initialdialogplacement gt gt lt lt initialdialogplacement gt
76. which objects are drawn by pushing the currently picked objects back Only frames text geometries and the grid area for 2 D plots are allowed PICK PUSH PICK SETMOUSEMODE PICK SETMOUSEMODE MOUSEMODE lt mousemode gt Prepare to pick objects by setting the mouse mode to SELECT or ADJUST This command also clears the list of picked objects that is unpicks all picked objects Required Parameter Parameter Syntax Notes MOUSEMODE lt mousemode gt Set to SELECT or ADJUST Example Set the mouse mode so picked objects are adjusted Syntax PICK SETMOUSEMODE MOUSEMODE ADJUST PICK SHIFT PICK SHIFT X lt dexp gt Y lt dexp gt 150 optional parameters Description Shift the currently picked objects Objects are shifted relative to their starting position X and Y shift amounts are in paper units inches If snapping is in effect then it is applied after shifting in X and Y See the SetValue commands GLOBALFRAME SNAPTOGRID and GLOBALFRAME SNAPTOPAPER Required Parameters Parameters Syntax Notes X lt dexp gt Shift amount in the X direction Units are inches Y lt dexp gt Shift amount in the Y direction Units are inches Optional Parameter Parameters Syntax Default Notes POINTERSTYLE ALLDIRECTIONS Only frames and non 3 D grid area objects can use a lt pointerstyle gt pointer style that is not ALLDIREC
77. 0 amp VAL Zero amp VAL Zero amp 0 Cc C Write out the field data for the finite element zone Cc IMax 4 JMax 5 III IMax JMax DIsDouble 0 I TECDAT100 III X DIsDouble I TECDAT100 III Y DIsDouble I TECDAT100 III P DIsDouble Cc C Calculate and then write out the connectivity list 306 Example Programs C Note The NM array references cells starting with offset of 1 Cc Cc GA OA Do 30 Do 30 K L NM 1 K NM 2 K NM 3 K NM 4 K 30 Continue I J 1 IMax 1 1 JMax 1 I J 1 IMax 1 I J 1 IMax L L 1 L IMax 1 L IMax I TECNOD100 NM Prepare to write out text record Text is positioned at 50 50 in frame units and has a height 5 frame units PM MF KM XP YP FH Scope Clipping PositionCoordSys FontType HeightUnits AttachToZone Zone BoxTyp BoxMargin BoxLineThickness BoxColor BoxFillColor TextAngle Anchor LineSpacing TextColor III e 50 Il ul o uo Il OrRFOONWOUDOOFRFRPFRFOF UW o ul TECTXT100 XP YP 0 0d0 PositionCoordSys AttachToZone 307 Chapter 11 Writing Binary Data for Loading into Tecplot qgqagaaAaAaAAN zone FontType HeightUnits FH BoxType BoxMargin BoxLineThickness BoxColor BoxFillColor TextAngle Anchor LineSpacing TextColor Scope Clipping Hi Mom NULCHAR NULCHAR PPMP PPMP PPMP PM SE SM M S
78. 133 Chapter 5 Macro Commands Parameter Syntax Notes ERRORBARS SHOW lt boolean gt VAR lt integer gt BARTYPE lt errorbartype gt COLOR lt color gt LINETHICKNESS lt op gt lt dexp gt SKIPPING lt op gt lt dexp gt Skip can be by index or distance depending SKIPMODE lt skipmode gt on SKIPMODE SIZE lt op gt lt dexp gt INDICES The indices parameter is used to restrict the range of data plotted and which lines are IJKLINES lt ijklines gt plotted if the data is IJ or IJK ordered IRANGE lt lt indexrange gt gt JRANGE lt lt indexrange gt gt KRANGE lt lt indexrange gt gt ASSIGN SORT lt sortby gt SORTVAR lt integer gt Examples Example 1 Assign variable 1 to be on the X axis and variable 4 to be on the Y axis for Line mapping number 7 LINEMAP 7 ASSIGN XAXISVAR 1 YAXISVAR 4 Example 2 Make Error Bars red for all Line mappings LINEMAP ERRORBARS COLOR RED Example 3 Set Line mappings 3 5 to draw a polynomial curve fit of order 5 LINEMAP 3 5 134 CURVES POLYORDER 5 CURVETYPE CURVFIT LINES SHOW YES LINEPLOTLA YERS Syntax LINEPLOTLAYERS optional parameters Description A SetValue command that turns on or off Line plot layers Optional Parameters Parameter Syntax Notes SHOWLINES lt boolean gt SHOWSYMBOLS lt boolean gt SHOWBARCHARTS lt bo
79. 2 VAR 3 43 Chapter 5 Macro Commands BREAK Syntax BREAK no parameters Description Jump out of the current LOOP ENDLOOP or WHILE ENDWHILE Example rooP 5 BREAK ENDLOOP COLORMAP Syntax COLORMAP optional parameters Description A SetValue command that changes the settings for the global contour color map and the global light source shading color map in Tecplot Changes here affect all frames using these color maps See GLOBALCONTOUR COLORMAPFILTER for additional settings that can be applied on a frame by frame basis Optional Parameters Parameter Syntax Notes TWOCOLOR lt lt colormapcontrolpoints gt gt SMRAINBOW lt lt colormapcontrolpoint gt gt LGRAINBOW lt lt colormapcontrolpoint gt gt MODERN lt lt colormapcontrolpoints gt gt GRAYSCALE lt lt colormapcontrolpoints gt gt USERDEFINED lt lt colormapcontrolpoints gt gt 44 Parameter Syntax Notes USERDEFINED NUMCONTROLPOINTS lt int gt CONTOURCOLORMAP lt colormap gt Example Make the third control point for the small rainbow color map to be positioned 0 44 of the way across the color map Set the leading and trailing RGB red value to 90 COLORMAP SMRAINBOW CONTROLPOINT 3 COLORMAPFRACTION 0 44 LEADRGB R 90 TRAILRGB R 90 COLORMAPCONTROL Required Control Option Description The different com
80. 2 Hollow 1 Filled BoxMargin Pointer to double value specifying the box margin in frame units BoxLineThickness Pointer to double value specifying the box line thickness in frame units BoxColor Pointer to integer value specifying the color to assign to the box 0 Black 8 Custom1 1 Red 9 Custom2 2 Green 10 Custom3 3 Blue 11 Custom4 4 Cyan 12 Custom5 5 Yellow 13 Custom6 6 Purple 14 Custom7 7 White 15 Custom8s BoxFillColor Pointer to integer value specifying the fill color to assign to the box See BoxColor Angle 278 Binary Data File Function Reference Summary Pointer to double value specifying the text angle in degrees Anchor Pointer to integer value specifying where to anchor the text 0 Left 5 MidRight 1 Center 6 HeadLeft 2 Right 7 HeadCenter 3 MidLeft 8 HeadRight 4 MidCenter LineSpacing Pointer to double value specifying the text line spacing TextColor Pointer to integer value specifying the color to assign to the text See BoxColor Scope Pointer to integer value specifying the scope 0 Global 1 Local Clipping Specifies whether to clip the geometry that is only plot the geometry within to the viewport or the frame 0 ClipToViewport ClipToFrame Text Character string representing text to display Must be null terminated MFC Macro function command Must be null terminated TECUSR100 Writes a character string to the data file in a USERREC record USERREC records are
81. 222 set command in macros 39 setting basic 39 shading 222 zebra shading 229 Command Line 5 Command parameters 10 Concatenate zones 64 Conditional execute 196 Conditional expressions 232 Conditionally processing macro commands 119 Configuration OpenGL 220 Configuration file SetValue macro commands 255 Configuring dropdown menus 209 Constants 238 Continue command 47 Continue to execute a set of commands 196 continuouscolor subcommand 212 Contour attributes 82 global changes 99 Contour color map 44 46 324 change settings command 44 overrides 211 zebra shading 229 Contour color maps 46 Contour commands 48 54 Contour labels 48 100 232 Contour levels 26 52 232 adding 50 animate 26 animate command 26 animating 26 copy to another frame 202 delete command 51 deleting 51 new 52 raw data 251 resetting 53 54 Contour plots global changes 99 labels 100 line mode 232 plot type 232 show 84 variable 100 Control commands If Endif 119 240 Control points contour color maps 210 Coordinates converting polar to rectangular 153 Copy picked objects 146 Copying contour levels to a trace 163 geometries to a trace 163 plot style to a trace 163 text to a trace 163 view to paste buffer 191 Copying attributes from existing Line mappings 72 Copying existing zones 72 Creating movie files 26 29 30 31 32 33 Creating new Line mappings 59 Creating zones FE surface from isosurfaces 58 Creati
82. 4 218 223 PROMPTFORFILENAME 18 156 PROMPTFORTEXTSTRING 18 157 PROMPTFORYESNO 18 158 PROPAGATELINKING 18 158 PUBLISH 18 159 QUIT 18 160 RAWCOLORMAP 18 160 READDATASET 18 161 READSTYLESHEET 18 163 restrictions on using 255 REDRAW 18 163 REDRAWALL 18 164 REMOVEVAR 18 164 in stylesheets and layout files 255 RENAMEDATASETVAR 18 165 RENAMEDATASETZONE 18 165 RESET3DAXES 18 166 RESET3DORIGIN 18 166 RESET3DSCALEFACTORS 18 166 RESETVECTORLENGTH 18 167 ROTATE2DDATA 18 167 ROTATE3DVIEW 18 168 RUNMACROFUNCTION 18 169 SAVELAYOUT 18 169 SET3DEYEDISTANCE 18 170 SETAUXDATA 18 170 SETDATASETTITLE 18 171 SETFIELDVALUE 19 171 SETSTYLEBASE 19 172 SHARECONNECTIVITY 19 173 SHAREFIELDDATAVAR 19 173 SHIFTLINEMAPSTOBOTTOM 19 174 SHIFTLINEMAPSTOTOP 19 175 SHOWMOUSEPOINTER 19 175 SKETCHAXTS 19 175 SMOOTH 19 176 STREAMTRACE 19 STREAMTRACE ADD 178 179 STREAMTRACE DELETEALL 179 STREAMTRACE DELETERANGE 179 STREAMTRACE RESETDELTATIME 180 STREAMTRACE SETTERMINATIONLINE 180 181 S SYSTEM 19 181 S THREEDAXIS 19 182 213 214 THREEDVIEW 183 TRANFORMCOORDINATES 184 TRANSFORMCOORDINATES 19 TRIANGULATE 19 185 S TWODAXIS 19 186 206 207 209 216 219 226 S VARSET 19 187 241 247 in stylesheets and layout files 255 S IVIEW 19 S VIEW AXISFIT 188 189 S VIEW AXISNICEFIT 190 S VIEW CENTER 190 S VIEW COPY 191 S V
83. 54 cHaPTER 10 Macro Language Limitations The only macro control commands allowed in stylesheets and layout files are VARSET and REMOVEVAR The only SetValue command allowed in color map files is COLORMAP Layout files stylesheet files and colormap files cannot contain any of the following com mands OPENLAYOUT READSTYLESHEET LOADCOLORMAP Only SetValue macro commands are allowed in the Tecplot configuration file The LIMITS command can be used only in the Tecplot configuration file The FIELD and LINEMAP commands may be used in the configuration file but may access only zone 1 or line map 1 respectively This special use of FIELD and LINEMAP allows you to change the default attributes for zones and line mappings when they are initialized in Tecplot The file name referenced in the INCLUDEMACRO command cannot use Tecplot macro variables 255 Chapter 10 Macro Language Limitations Size limitations Maximum number of nested macro function calls 10 Maximum number of nested macro loops 10 Maximum number of nested While EndWhile loops Unlimited Maximum number of nested If EndIf loops Unlimited Maximum number of nested macro includes 5 Maximum number of macro commands 200 000 Maximum number of parameters per macro function 20 Maximum number of characters in macro variable name 31 Maximum number of characters in macro function name Unli
84. 6 font POLARAXIS RDETAIL TITLE TEXT Harmonic Motion POLARAXIS RDETAIL TITLE OFFSET 4 POLARAXIS RDETAIL TITLE COLOR RED POLARAXIS RDETAIL TITLE TEXTSHAPE FONT TIMES POLARAXIS RDETAIL TITLE TEXTSHAPE HEIGHT 6 lt lt basicsizelist gt gt Description Assign basic sizes The units for the values assigned here are dependent on the parent command Assignments here do not affect the plot These assignments are used only to configure drop down menus in the interface so the user can make quick selections 209 Chapter 6 Parameter Subcommands Expands to Syntax Notes TINY lt op gt lt dexp gt SMALL lt op gt lt dexp gt MEDIUM lt op gt lt dexp gt LARGE lt op gt lt dexp gt HUGE lt op gt lt dexp gt Example Change the medium line pattern length for drop down menus in the interface to be five percent BASICSIZE LINEPATLENGTHS MEDIUM 5 lt lt colormapcontrolpoints gt gt Description All contour color maps except the Raw user defined color map make use of control points to determine the color distribution Each control point has a position and a left and right color The lt lt colormapcontrolpoints gt gt subcommand can contain more than one CONTROLPOINT subcommand Expands to Syntax Notes CONTROLPOINT LEADRGB TRAILRGB lt integer gt COLORMAPFRACTION lt op gt
85. 6 to the set of active line mappings ACTIVELINEMAPS 33 36 Remove line maps 1 2 3 9 10 and 11 from the set of active line mappings ACTIVELINEMAPS 1 3 9 11 ADDMACROPANELTITLE ADDMACROPANELTITLE lt string gt no parameters Add a title to the Quick Macro Panel The following example adds the title Bar Charts to the Quick Macro Panel 22 ADDMACROPANELTITLE Bar Charts ADDONCOMMAND Syntax I ADDONCOMMAND ADDONID lt string gt COMMAND lt string gt optional parameters Description Send a command to an add on An add on registers the name of a function that will be called when an ADDONCOMMAND is processed Tecplot knows which registered function to call based on the ADDONID string See the function TecUtilMacroAddCommandCallback in the Tecplot ADK Reference Manual Required Parameters Parameter Syntax Notes ADDONID lt string gt String that identifies the add on This must match the published ID string for the add on COMMAND lt string gt The command to be sent to the add on Optional Parameters Parameter Syntax Default Notes lt addoncommandrawdata gt NULL If the RAWDATA section is supplied then each line of the RAWDATA section is appended to the COMMAND string A leading new line character is appended first and each line in the RAWDATA section will also be terminated with a new line except for the last line
86. 7 Parameter Assignment Values Expressions and Arithmetic and Logical Operators Table 7 2 Functions supported by Tecplot sinh x Hyperbolic sine of x sqrt x Square root of x tan x Tangent of x in radians tanh x Hyperbolic tangent of x Constants are also supported as listed in the following table Table 7 3 Constants supported by Tecplot BASEe Natural logarithm base e DEG Degrees per radian GAMMA Euler Mascheroni constant PHT Golden ratio 5 1 2 PI T RAD Radians per degree The following table shows the operator precedence and associativity Operators with higher precedence are listed in the higher rows of the table while operators that are in the same row have the same precdence The associativity describes how an operator associates with its operand Table 7 4 Operator precedence and associativity Operator Type Operators Associativity Expression Left to right Power kx Right to left Unary Right to left Multiplicative Left to right Additive Left to right Relational gt gt lt lt Ia Left to right Logical AND amp amp Left to right Logical OR Left to right Conditional Po Right to left 238 Assignment Value Expressions Unlike C relational expressions do not evaluate to 0 or 1 instead they evaluate to true or false As such they may only
87. A action command MIN lt integer gt 1 MAX lt integer gt 0 SKIP lt integer gt 1 JRANGE See notes on index ranges for ALTERDATA action command MIN lt integer gt 1 MAX lt integer gt 0 SKIP lt integer gt 1 KRANGE See notes on index ranges for ALTERDATA action command MIN lt integer gt 1 MAX lt integer gt 0 SKIP lt integer gt 1 Examples Example 1 Make a complete copy of zone 2 DUPLICATEZONE SOURCEZONE 2 Example 2 Duplicate zone 3 creating a zone which uses only the I index range from 2 to 7 from the source zone DUPLICATEZONE SOURCEZONE 3 IRANGE MIN 2 MAX 7 73 Chapter 5 Macro Commands ELSE Syntax ELSE no parameters Description Conditionally handle macro commands Used when an IF statement is FALSE Example s varset c 2 IF C CREATENEWFRAME XYPOS X 2 5 Y 1 5 WIDTH 4 HEIGHT 4 ELSE CREATENEWFRAME XYPOS X 3 Y 2 WIDTH 3 HEIGHT 3 ENDIF ELSEIF Syntax ELSEIF lt conditionalexp gt Description Conditionally handle macro commands Used to create multiple options for statements should an IF statement be FALSE Example IVARSET A 2 IF A lt 5 CREATENEWFRAME 74 X 1 Y 1 WIDTH 3 HEIGHT 3 ELSEIF A gt 5 CREATENEWFRAME XYPOS X 2 Y 1 WIDTH HEIGHT 5 i ul 1 ELSE CREATENEWFRAME
88. ALUEREFCOUNT 16 96 GETNODEINDEX 16 GETUSERINPUT replaced by PROMPTFORTEXTSTRING 157 GETVARLOCATION 16 97 GETVARNUMBYNAME 98 GETVAROFFSETBYNAME 16 GETZONETYPE 16 GLOBALCONTOUR 16 99 101 211 229 GLOBALFRAME 16 102 GLOBALISOSURFACE 16 103 GLOBALLINEPLOT 16 104 GLOBALPOLAR 16 106 GLOBALRGB 16 106 GLOBALSCATTER 16 108 220 GLOBALSLICE 17 110 GLOBALSTREAM 17 112 GLOBALTHREED 17 62 114 229 GLOBALTHREEDVECTOR 17 116 GLOBALTWODVECTOR 17 117 S IF 17 119 INCLUDEMACRO 17 119 restrictions on using 255 S INTERFACE 17 120 S INVERSEDISTINTERPOLATE 17 128 S KRIG 17 129 LAUNCHDIALOG 17 130 S LIMITS 17 130 255 LINEARINTERPOLATE 17 131 S LINEMAP 17 132 224 restrictions on using 255 LINEPLOTLAYERS 17 135 LINKING 17 135 LOADADDON 17 136 LOADCOLORMAP 17 137 restrictions on using 255 LOOP 17 137 LOOP ENDLOOP 44 MACROFUNCTION 17 138 248 NEWLAYOUT 17 139 OPENLAYOUT 17 140 restrictions on using 255 S PAPER 10 17 141 217 PAUSE 17 142 PICK 17 PICK ADD 143 PICK ADDALL 144 PICK ADDALLINRECT 144 PICK CLEAR 146 PICK COPY 146 PICK CUT 146 PICK EDIT 147 PICK MAGNIFY 149 PICK PASTE 149 PICK POP 149 PICK PUSH 150 PICK SETMOUSEMODE 150 PICK SHIFT 150 PLOTTYPE 17 151 POLARAXIS 17 POLARDAXTIS 152 POLARTORECTANGULAR 17 153 POLARVIEW 17 153 PRINT 18 154 S PRINTSETUP 18 15
89. AP PROXIMATIONMODE is NONCUR RENTALWAYSAPPROX This setting has no effect when PLOTAPPROXI MATIONMODE is set to ALLFRAME SALWAYSAPPROX OKTOEXECUTESYSTEMCOMMAND lt boolean gt Allow use of SYSTEM com mands in macros This is a security issue If set to FALSE and the macro is run intermittantly you will be asked for permission to execute the SYSTEM command If Tecplot is run in batch mode and this is FALSE an error will be generated and the macro will terminate OPENGLCONFIG RUNDISPLAYLISTSAFTERBUILDING ALLOWHWACCELERATION SCREENRENDERING IMAGERENDERING MAXFILTERMAGNIFICATION lt boolean gt lt boolean gt lt lt renderconfig gt gt lt lt renderconfig gt gt lt integer gt ll Tecplot defaults to building and run ning display lists simultaneously Turn RunDisplayListsAfter Building on if you want to run the display lists after they are built This may increase display list perfor mance on some machines The difference is often times neglegible Windows only This will disable hardware acceleration for Tecplot without having to change the Win dows Display Properties Setting ALLOWHWACCELERATION to NO may fix errors caused by hardware acceleration on buggy graphics card drivers Sets the maximum magnification by non texture resize filer before tex tures are used This keeps Tecplot from creating textures which are too large Default 2 0 Setting this
90. AT amp III amp X 0 0 amp DIsDouble I TECDAT amp III amp Y 0 0 amp DIsDouble I TECDAT amp III amp P 0 0 amp DIsDouble I TECEND 11 7 3 Complex Example FORTRAN Complex example FORTRAN program to write a binary data file for Tecplot This example does the following 1 Open a data file called field plt 2 Open a data file called line plt 3 Assign values for X Y and P These will be used in both the ordered and FE data files 4 Write out an ordered zone dimensioned 4 x 5 to field plt 5 Assign values for XL and YL arrays 6 Write out data for line plot to line plt Make the data use double precision 7 Write out a finite element zone to field plt 8 Write out a text record to field plt 9 Write out a geometry circle record to field plt NANAAAAAAAAAAAAAA 302 Example Programs c 10 Close file 1 c 11 Close file 2 6 Program ComplexTest REAL 4 REAL 8 REAL 4 EQUIVALENCE EQUIVALENCE INTEGER 4 INTEGER 4 REAL 8 REAL 8 INTEGER 4 INTEGER 4 INTEGER 4 INTEGER 4 INTEGER 4 INTEGER 4 INTEGER 4 REAL 8 REAL 4 CHARACTER 1 INTEGER 4 X 4 5 Y 4 5 P 4 5 XL 50 YL 50 XLDummy 1 YLDummy 1 XLDummy 1 XL 1 YLDummy 1 YL 1 Debug I J K L 1III NPts NElm DIsDouble VIsDouble IMax JMax KMax NM 4 12 XP YP ZP FH LineSpacing PatternLength BoxMargin BoxLineThickness TextAngle AttachToZone Zone Scope
91. Assigning basic sizes 209 Assigning parameters 10 Assigning plotter pens for hardcopy output 217 Assigning sizes of various objects 40 Assigning strings macro variables 247 Assigning values 13 macro variables 246 Assignment statements 237 Attach a frame and a data set 33 Attaching a geometry to a zone 35 Attaching text to the current frame 37 Attaching text to zones 37 Attributes assigning 81 for exporting image files 77 setting for default text 66 AUTOREDRAWISACTIVE 120 Auxilary data macro variables 242 Auxiliary data deleting 68 for data sets 263 for zones 280 getting 93 setting 170 Axes 3D attributes 182 adjust to center data 190 adjust to nice fit 192 adjust to nice view 192 assign variables 152 182 186 fit to data 188 189 in Sketch frame mode 175 minimum maximum as variables 242 nice fit 190 reset scale factors 166 resetting 166 setting 2D attributes 186 setting polar attributes 152 XY Line attributes assignments 203 Axis 189 190 207 208 assign variables 182 Axis attributes 207 Axis dependent mode 231 Axis grid area settings 206 Axis gridlines settings 213 Axis labels 216 Axis number 189 190 Axis tick marks attributes 226 label formatting 226 labels 226 Axis title mode 231 position 232 axisdetail subcommand 207 208 axisticks subcommand 226 B Back buffer swapping to front 70 Backing store 232 BACKINGSTOREMODE 120 Basic colors setting 39 basicsizelist subcommand 209 BEEPONFRAMEINTERRUP
92. COLORMAPFILTER COLORMAPDISTRIBUTION CONTINUOUS GLOBALCONTOUR COLORMAPFILTER CONTINUOUSCOLOR CMIN 0 5 CMAX 2 lt lt initialdialogplacement gt gt Description Describes the initial placement for a dialog 212 Expands to Syntax Notes XOFFSET and YOFFSET are in pixels They may DIALOGPLACEMENT lt dialogplacement gt be negative but will be truncated to the bounding XOFFSET lt integer gt rectangle of the Tecplot main window YOFFSET lt integer gt Example Set the initial position of the Colormap dialog to 10 pixels from Tecplot s bottom right corner INTERFACE INITIALDIALOGPLACEMENT COLORMAPDIALOG DIALOGPLACEMENT BOTTOMRIGHT XOFFSET 10 YOFFSET 10 lt lt gridlinedetail gt gt Description Change settings for axis gridlines Expands to Syntax Notes SHOW lt boolean gt LINEPATTERN lt linepattern gt PATTERNLENGTH lt op gt lt dexp gt LINETHICKNESS lt op gt lt dexp gt CUTTOFF lt double gt Theta only Example Set the line pattern for minor gridlines for the X axis in a 3 D plot to be dashed 213 Chapter 6 Parameter Subcommands THREEDAXIS XDETAIL MINORGRIDLINES LINEPATTERN DASHED lt lt ijk gt gt Description Set an I J or K index Expands to Syntax Notes I lt op gt lt integer gt J lt op gt lt integer gt K lt op gt
93. CTION TECTXT XPos YPos PosCoordMode AttachToZone Zone Font FontHeightUnits FontHeight BoxType BoxMargin BoxLineThickness BoxColor BoxFillColor Angle Anchor LineSpacing TextColor Scope PPP PPP PPP PPM PM PM SM HM KM 293 Chapter 11 Writing Binary Data for Loading into Tecplot C Syntax Text MFC DOUBLE PRECISION XPos DOUBLE PRECISION YPos INTEGER 4 PosCoordMode INTEGER 4 AttachToZone INTEGER 4 Zone INTEGER 4 Font INTEGER 4 FontHeightUnits DOUBLE PRECISION FontHeight INTEGER 4 BoxType DOUBLE PRECISION BoxMargin DOUBLE PRECISION BoxLineThickness INTEGER 4 BoxColor INTEGER 4 BoxFillColor DOUBLE PRECISION Angle INTEGER 4 Anchor DOUBLE PRECISION LineSpacing INTEGER 4 TextColor INTEGER 4 Scope CHARACTER Text CHARACTER MFC include TECIO h INTEGER4 TECTXT double XPos double YPos INTEGER4 PosCoordMode INTEGER4 AttachToZone INTEGER4 Zone INTEGER4 Font INTEGER4 FontHeightUnits double FontHeight INTEGER4 BoxType double BoxMargin double BoxLineThickness INTEGER4 BoxColor INTEGER4 BoxFillColor double Angle INTEGER4 Anchor double LineSpacing INTEGER4 TextColor INTEGER4 Scope char Text char MFC 294 Binary Data File Function Reference Return Value o if successful 1 if unsuccessful Parameters xPos Pointer to double value specifying the X position of the geometry YPos Pointer to double value specifying the Y
94. DSINMACROVIEWER 123 Load color map 137 Load data 161 Loading add ons 136 Loading your own macro function file 6 Log axes 232 Loop command 137 M Macro command language 1 Macro command summary 13 Macro command syntax 9 Macro commands 3 5 9 conditionally processing 119 macro variables 241 major 13 spacing 10 Macro control commands 21 allowed in stylesheets and layouts 255 Break 44 Continue 47 Delay 67 include macro 119 Loop Endloop 137 pause 142 run macro function 169 stop execution 142 system commands 181 While Endwhile 196 Macro definitions 6 Macro files 9 329 Index debugging 6 first line 9 nesting one file within another 119 Macro function execute 169 Macro function files example 6 loading your own 6 Macro functions 5 6 defining 138 retaining 5 run command 248 Macro language restrictions and limitations 255 Macro Panel 6 Macro panel 139 adding title 22 Macro syntax examples 240 Macro variable set field value 171 Macro variables assigning strings 247 assigning value or string 187 assigning values 246 function 248 get current frame name 94 get field value 95 name 246 remove user defined 164 select data variable by name 98 using formats 249 Macro viewer 6 MACROFILE 85 Macros 3 5 6 debugging 6 running from the command line 5 running from the Quick Macro Panel 6 running from the Tecplot interface 6 Macros vs macro functions vs macro commands 5 Magnification set for view 194 zoom 195
95. Description Deletes all streamtraces in the current frame If the frame mode is 2 D all 2 D streamtraces are deleted If the frame mode is 3 D all 3 D streamtraces are deleted Example STREAMTRACE DELETEALL STREAMTRACE DELETERANGE Syntax STREAMTRACE DELETERANGE optional parameters 179 Chapter 5 Macro Commands Description Delete a range of streamtraces Streamtraces are numbered sequentially in the order they were created Optional Parameters Parameters Syntax Default Notes RANGESTART lt integer gt 1 RANGEEND lt integer gt 1 Example Delete streamtraces 3 5 STREAMTRACE DELETERANGE RANGESTART RANGEEND STREAMTRACE RESETDELTATIME Syntax STREAMTRACE RESETDELTATIME no parameters Description Reset the time delta for dashed streamtraces The delta time is reset such that a stream dash in the vicinity of the maximum vector magnitude will have a length approximately equal to 10 percent of the frame width Example STREAMTRACE RESETDELTATIME STREAMTRACE SETTERMINATIONLINE Syntax STREAMTRACE SETTERMINATIONLINE lt xyrawdata gt Description Set the position of the termination line for streamtraces 180 Required Parameter Parameters Syntax Notes lt xyrawdata gt In 3 D the termination line is defined in the eye coordi nate system Example Set the termination line using 3 points STREAMTRACE SETTER
96. Description Stop execution of a macro and optionally display a dialog with a message If lt string gt is set to then no dialog is displayed and the user must click in the work area to continue Example Pause and display the message This is the first example plot PAUSE This is the first example plot PICK Required Control Option Description The different commands in the PICK compound function family are described separately in the following sections The PICK compound functions are PICK PICK PICK PICK PICK PICK PICK ADD ADDALL ADDALLINRECT CLEAR COPY CUT EDIT 142 PICK MAGNIFY PICK PASTE PICK POP PICK PUSH PICK SETMOUSEMODE PICK SHIFT Syntax PICK ADD x Y lt dexp gt lt dexp gt PICK ADD optional parameters Description Attempt to pick an object at a specific location on the paper Required Parameters Parameters Syntax Notes X lt dexp gt X location in inches relative to the left edge of the paper Y lt dexp gt Y location in inches relative to the top edge of the paper Optional Parameters lt boolean gt Parameters Syntax Default Notes COLLECTINGOBJECTS FALSE If FALSE the list of picked objects is cleared before the lt boolean gt attempt is made to add a new object DIGGINGFOROBJECTS FALSE If TRUE attempt to pick objects below any currently picked
97. E lt op gt lt dexp gt SMALLSTEP lt op gt lt dexp gt MEDIUMSTEP lt op gt lt dexp gt LARGESTEP lt op gt lt dexp gt ZOOMSCALEPERFRAMEUNIT lt op gt lt double gt SCRBACKGROUNDCOLOR lt color gt Set the workspace background color SECURES POOLCOMMANDS lt boolean gt Set to FALSE to allow SPOOLER commands outside the configuration file SHOWCONTINUOUSSTATUS lt boolean gt SHOWCOORDINATES lt boolean gt 125 Chapter 5 Macro Commands Parameter Syntax Notes SHOWFRAMEBORDERSWHENOFF lt boolean gt If TRUE frame borders are drawn using a dashed line when they are turned off This applies only to the screen and does not effect the hard copy SHOWSTATUSLINE lt boolean gt SHOWTEXTGEOMSINAPPROXVIEWS lt boolean gt Set to TRUE if you want text and geometries to show up in frames using approximated plots SHOWWAITDIALOGS lt boolean gt If FALSE all Please Wait and Percent Done dialogs will be dis abled SOFTWARE3 DRENDERING lt boolean gt TRACEREDRAWMODE lt traceredrawmode gt TRANSLATION Settings for interactive translation STEPSIZE lt op gt lt dexp gt SMALLSTEP lt op gt lt dexp gt MEDIUMSTEP lt op gt lt dexp gt LARGESTEP lt op gt lt dexp gt UNIXHELPBROWSERCMD lt string gt Sets the command used to launch a browser for add ons that use HTML for their help file UNIX only Win dows automatically
98. EGER 4 N REAL or DOUBLE PRECISION Data 1 INTEGER 4 I sDouble C Syntax include TECIO h long TECDAT100 INTEGER4 N void Data INTEGER4 sDouble Return Value o if successful 1 if unsuccessful Parameters N Pointer to an integer value specifying number of values to write Data Array of single or double precision data values IsDouble Pointer to the integer flag stating whether the array Data is single 0 or double 1 precision TECEND100 Summary Must be called to close out the current data file There must be a corresponding TECEND100 for each TECINI100 FORTRAN Syntax 265 Chapter 11 Writing Binary Data for Loading into Tecplot INTEGER 4 FUNCTION TECEND100 C Syntax include TECIO h INTEGER4 TECEND100 Return Value o if successful 1 if unsuccessful Parameters None TECFACE100 Summary Writes face connections for the current zone to the file This function must be called after TECNOD100 and may only be called if a non zero value of NumFaceConnections was used in the previous call to TECZNE100 FORTRAN Syntax INTEGER 4 FUNCTION TECFACE100 FaceConnections INTEGER 4 FACECONNECTIONS C Syntax include TECIO h INTEGER4 TECFACE100 INTEGER4 FaceConnections Return Value o if successful 1 if unsuccessful Parameters FaceConnections The array that specifies the face connections The array must be dimensioned L Num FaceConnections where L is determined by the t
99. FILLCOLOR lt color gt MARGIN lt op gt lt dexp gt TEXTSHAPE lt lt textshape gt gt Not allowed to change size units parameter NUMFORMAT lt lt numberformat gt gt LEGEND LABELLOCATION lt lt contlabellocation gt gt LABELINCREMENT lt double gt ANCHORALIGNMENT lt anchoralignment gt SHOW lt boolean gt SHOWHEADER lt boolean gt ROWSPACING lt op gt lt dexp gt ISVERTICAL lt boolean gt OVERLAYBARGRID lt boolean gt Thin line around each band in the color bar TEXTCOLOR lt color gt XYPOS lt lt xy gt gt BOX lt lt textbox gt gt HEADERTEXTSHAPE lt lt textshape gt gt NUMBERTEXTSHAPE lt lt textshape gt gt AUTORESIZE lt boolean gt AUTOSIZEMAXLIMIT lt double gt Set only via config file CONTCOLORLABELDELTA lt double gt INCLUDECUTOFFLEVELS lt boolean gt 100 Parameter Syntax Notes GLOBALCONTOUR 1 LEGEND a YES PES aan 3 RANGEMAX 5 COLORCUTOFF Set minimum and maximum cutoff for con tour flooding RANGEMIN lt op gt lt dexp gt RANGEMAX lt op gt lt dexp gt INCLUDEMIN lt boolean gt INCLUDEMAX lt boolean gt CONTOURLINESTYLE This is used to assign a special line pattern scheme for contour line plots CONTOURLINEMODE lt contourlinemode gt LINESKIP lt op gt lt integer gt PATTERNLENGTH lt op gt lt dexp gt COLORMAPFILTER The global color map is
100. FUNCTIONDEPENDENCY lt functiondependency gt SHOWINLEGEND ALWAYS NEVER AUTO SORT lt sortby gt SORTVAR lt integer gt 132 Parameter Syntax Notes CURVES CURVETYPE lt curvetype gt EXTENDEDNAME lt string gt Only used by the Extended Curve fit Add on EXTENDEDSETTINGS lt string gt Only used by the Extended Curve fit Add on USEWEIGHTVAR lt boolean gt NUMPTS lt op gt lt integer gt POLYORDER lt op gt lt integer gt WEIGHTVAR lt integer gt INDVARMIN lt op gt lt dexp gt INDVARMAX lt op gt lt dexp gt USEINDVARRANGE lt boolean gt CLAMPSPLINE lt boolean gt SPLINEDERIVATIVEAT lt op gt lt dexp gt START SPLINEDERIVATIVEATEND lt op gt lt dexp gt SYMBOLS SHOW lt boolean gt COLOR lt color gt FILLMODE lt fillmode gt FILLCOLOR lt color gt SIZE lt op gt lt dexp gt LINETHICKNESS lt op gt lt dexp gt SKIPPING lt op gt lt dexp gt Skip can be by index or distance depending SKIPMODE lt skipmode gt on SKIPMODE SYMBOLSHAPE lt lt symbolshape gt gt BARCHARTS SHOW lt boolean gt COLOR lt color gt FILLMODE lt fillmode gt FILLCOLOR lt color gt SIZE lt op gt lt dexp gt LINETHICKNESS lt op gt lt dexp gt LINES SHOW lt boolean gt COLOR lt color gt LINEPATTERN lt boolean gt PATTERNLENGTH lt color gt LINETHICKNESS lt op gt lt dexp gt
101. FontHeight INTEGER4 BoxType double BoxMargin double BoxLineThickness INTEGER4 BoxColor INTEGER4 BoxFillColor double Angle 276 Binary Data File Function Reference INTEGER4 Anchor double LineSpacing INTEGER4 TextColor INTEGER4 Scope INTEGER4 Cliping char Text char MFC Return Value o if successful 1 if unsuccessful Parameters XOrThetaPos Pointer to double value specifying the X position or Theta position polar plots only of the text YOrRPos Pointer to double value specifying the Y position or R position polar plots only of the text ZOrUnusedPos Pointer to double value specifying the Z position of the text PosCoordMode Pointer to integer value specifying the position coordinate system 0 Grid 1 Frame AttachToZone Pointer to integer flag for to signal that the text is attached to a zone Zone Pointer to integer value specifying the zone number to attach to Font Pointer to integer value specifying the font 0 Helvetica 6 Times Italic 1 Helvetica Bold 7 Times Bold 2 Greek 8 Times Italic Bold 3 Math 9 Courier 277 Chapter 11 Writing Binary Data for Loading into Tecplot 4 User Defined 10 Courier Bold 5 Times FontHeightUnits Pointer to integer value specifying the font height units 0 Grid 2 Point 1 Frame FontHeight Pointer to double value specifying the font height BoxType Pointer to integer value specifying the box type 0 None
102. IEW DATAFIT 191 S VIEW FIT 191 S VIEW LAST 192 S VIEW MAKECURRENTVIEWNICE 192 S VIEW NICEFIT 192 S VIEW PASTE 193 S VIEW PUSH 193 S VIEW RESETTOENTIRECIRCLE 193 S VIEW SETMAGNIFICATION 194 321 Index S VIEW TRANSLATE 194 S VIEW ZOOM 195 S WHILE 19 196 S WHILE ENDWHILE 44 WORKSPACEVIEW 19 196 WORKSPACEVIEW FITALLFRAMES 197 WORKSPACEVIEW FITPAPER 197 WORKSPACEVIEW FITSELECTEDFRAMES 197 WORKSPACEVIEW LASTVIEW 198 WORKSPACEVIEW MAXIMIZE 198 WORKSPACEVIEW TRANSLATE 198 WORKSPACEVIEW UNMAXIMIZE 199 WORKSPACEVIEW ZOOM 199 WRITECOLORMAP 19 200 WRITECURVEINFO 19 200 S WRITEDATASET 19 201 WRITESTYLESHEET 19 202 S XYLINEAXIS 19 203 227 lt addmousebuttonmode gt 231 lt addonstyle gt 231 lt arrowheadattachment gt 231 lt arrowheadstyle gt 231 lt axismode gt 231 lt axistitlemode gt 231 lt axistitleposition gt 232 lt backingstoremode gt 232 lt bitdumpregion gt 232 lt boundarycondition gt 232 lt boundarysetting gt 232 lt boxtype gt 232 lt charactersequence gt 232 lt color gt 232 lt colormap gt 232 lt colormapcontrol gt 232 lt colormapdistribution gt 232 lt conditionalexp gt 232 lt contourlabelaction gt 232 lt contourlevelaction gt 232 lt contourlinemode gt 232 lt contourtype gt 232 lt coordscale gt 232 lt coordsys gt 232 lt curve type gt 232 lt curveinfomode gt 232 lt datatype gt 232 lt deriv
103. IGHBORS FALSE ASSOCIATELAYOUTWITHDATAFILE TRUE 201 Chapter 5 Macro Commands Parameters Syntax Default Notes VARPOSITIONLIST lt set gt All vars Use this to limit the number of variables written out ZONELIST lt set gt All zones Use this to limit the number of zones written out BINARY lt boolean gt TRUE If FALSE you can include PRECISION and USEPOINTFORMAT PRECISION lt integer gt 12 Only used if ASCII that is BINARY is FALSE USEPOINTFORMAT lt boolean gt FALSE Only used if ASCII that is BINARY is FALSE Example Write out only zone 3 to a file called zone3 p1t S WRITEDATASET zone3 plt INCLUDETEXT FALSE INCLUDEGEOM FALSE INCLUDECUSTOMLABELS FALSE ZONELIST 3 WRITESTYLESHEET Syntax WRITESTYLESHEET lt string gt optional parameters Description Write the style for the current frame to a file The lt string gt is the name of the file to write to Optional Parameters Parameters Syntax Default Notes INCLUDECONTOURLEVELS TRUE lt boolean gt INCLUDETEXT lt boolean gt TRUE INCLUDEGEOM lt boolean gt TRUE INCLUDEPLOTSTYLE lt boolean gt TRUE INCLUDESTREAMPOSITIONS TRUE lt boolean gt INCLUDEFACTORYDEFAULTS lt boolean gt FALSE 202 Parameters Syntax Default Notes USERELATIVEPATHS lt boolean gt INCLUDEAUXDATA lt boolean gt T
104. ISION 3 POSITIVESUFFIX DAYS WITHOUT RAIN lt lt papersize gt gt Description Change dimensions or hardclip offsets for LETTER DOUBLE A3 A4 CUSTOM1 and CUSTOM2 paper sizes 216 Expands to Syntax Notes All values are in inches WIDTH lt op gt lt dexp gt HEIGHT lt op gt lt dexp gt LEFTHARDCLIPOFFSET lt op gt lt dexp gt RIGHTHARDCLIPOFFSET lt op gt lt dexp gt TOPHARDCLIPOFFSET lt op gt lt dexp gt BOTTOMHARDCLIPOFFSET lt op gt lt dexp gt Example Change the left hardclip offset for LETTER size paper to be 0 25 inches PAPER PAPERSIZEINFO LETTER LEFTHARDCLIPOFFSET 0 25 lt lt plotterpenmap gt gt Description Assign plotter pens to objects or colors for hardcopy output to pen plotters Some objects are assigned a pen regardless of their color All other objects are assigned a pen based on their color 217 Chapter 6 Parameter Subcommands Expands to Syntax Notes Factory default for all objects is to use pen BLACKPEN lt integer gt REDPEN lt integer gt GREENPEN lt integer gt BLUEPEN lt integer gt CYANPEN lt integer gt YELLOWPEN lt integer gt PURPLEPEN lt integer gt WHITEPEN lt integer gt CUSTOM1PEN lt integer gt CUSTOM2 PEN lt integer gt CUSTOM3 PEN lt integer gt CUSTOM4PEN lt integer gt CUSTOM5 PEN lt integer gt CUSTOM6 PEN lt int
105. LD command The FIELD command can be followed by a set If it is not followed by a set the FIELD command applies to all enabled zones A supplied set in this case is used to limit the zones to which the FIELD command applies mandatoryparameters commandparameter commandparameter optionalparameters commandparameter commandparameter commandparameter parameterassignment or parametersubcommand parameterassignment parametername op value op Or or or or parametersubcommand parametername optionalparameters commandname The name of a major command such as REDRAW parametername The name of a valid parameter for the previously named major command For example the REDRAW major com mand has an optional parameter called DOFULLDRAWING value number expression or enumeratedvalue number Any valid integer or double value representation expression Any valid infix notation expression The entire expression must itself be enclosed in parenthesis For example 3 5 enumeratedvalue A key word that is unique to the variable being assigned a value For example if the variable being assigned a value is a basic color then the enumerated value can be one of the following BLACK RED GREEN BLUE CYAN YELLOW PURPLE WHITE CUSTOM1 through CUSTOM56 Spacing and capitalization for macro commands are for the most part not important The following examples show different ways to enter the same macro comma
106. LINES lt integer gt Maximum number of lines to use when tracing data in a frame MINPIXELSFORDRAG lt integer gt Number of pixels to move the pointer before it is considered a drag MOUSEACTIONS MIDDLEBUTTON BUTTONCLICK lt mousebuttonclick gt SIMPLEDRAG lt mousebuttondrag gt CONTROLLEDDRAG lt mousebuttondrag gt ALTEDDRAG lt mousebuttondrag gt SHIFTEDDRAG lt mousebuttondrag gt CONTROLALTEDDRAG lt mousebuttondrag gt CONTROLSHIFTEDDRAG lt mousebuttondrag gt ALTSHIFTEDDRAG lt mousebuttondrag gt CONTROLALTSHIFTEDDRAG lt mousebuttondrag gt RIGHTBUTTON BUTTONCLICK lt mousebuttonclick gt SIMPLEDRAG lt mousebuttondrag gt CONTROLLEDDRAG lt mousebuttondrag gt ALTEDDRAG lt mousebuttondrag gt SHIFTEDDRAG lt mousebuttondrag gt CONTROLALTEDDRAG lt mousebuttondrag gt CONTROLSHIFTEDDRAG lt mousebuttondrag gt ALTSHIFTEDDRAG lt mousebuttondrag gt CONTROLALTSHIFTEDDRAG lt mousebuttondrag gt NUMMOUSEBUTTONS lt integer gt This option is only for UNIX users who are using MIDDLEMOUSEBUTTONMODE or RIGHTMOUSEBUTTONMODE 123 Chapter 5 Macro Commands Parameter Syntax Notes NUMPTSALLOWEDBEFOREAPPROX lt integer gt When a frame s active zones contain this many points or less the frame is not approximated but always drawn in full This applies to all frames when PLOTAPPROXIMATION MODE is AUTOMATIC and to the current frame only when PLOT
107. LOCATION zone dataset frame optional parameters Description Delete Auxilary Data in the form of name value pairs from zones frames or datasets Required Parameters Parameter Syntax Notes AUXDATALOCATION lt zone dataset frame gt Options are ZONE DATASET or FRAME Optional Parameters Parameter Syntax Notes ZONE lt integer gt Only required if AUXDATALOCATION zone NAME lt string gt Example Delete the selected Auxilary Data from Zone 2 DELETEAUXDATA AUXDATALOCATION zone ZONE 2 NAME VARIABLE DATA DELETELINEMAPS Syntax DELETEMAPS lt set gt no parameters 68 Description Example Syntax Description Example Syntax Description Example Description Delete one or more Line mappings If lt set gt is omitted then all Line mappings are deleted Delete Line mappings 2 3 4 and 8 DELETELINEMAPS 2 4 8 DELETEVARS DELETEVARS lt seft gt no parameters Delete one or more variables Delete variables 4 and 10 IDELETEZONES 4 10 DELETEZONES DELETEZONES lt set gt no parameters Delete one or more zones Delete zones 3 7 8 9 and 11 DELETEZONES 3 7 9 11 DOUBLEBUFFER Required Control Option The different commands in the DOUBLEBUFFER compound function family are described separately in the following sections The DOUBLEBUFFER compound functions are DOUBLEB
108. LTERDATA EQUATION P 0 IRANGE MIN 0 ALTERDATA EQUATION P 0 25 Chapter 5 Macro Commands Syntax JRANGE MAX 1 ALTERDATA EQUATION P 0 JRANGE MIN 0 ANIMA TECONTOURLEVELS ANIMATECONTOURLEVELS START lt integer gt END lt integer gt optional parameters Description Produce an animation of a contour line plot by showing a single level at a time The animation varies according to the currently defined contour levels and is limited by the values in the START END and SKIP parameters To create an AVI or RM file add EXPORTSETUP commands before this command Required Parameters Parameter Syntax Notes START lt integer gt Starting contour level number to animate END lt integer gt Ending contour level number to animate Optional Parameters Parameter Syntax Default Notes SKIP lt integer gt 1 Level skip CREATEMOVIEFILE lt boolean gt FALSE If TRUE must be preceded by EXPORTSETUP commands Example The following command animates the first four contour levels to an AVI file EXPORTSETUP EXPORTFORMAT AVI EXPORTSETUP EXPORTFNAME contourlevels avi ANIMATECONTOURLEVELS 26 START 1 END 4 CREATEMOVIEFILE TRUE ANIMATEIJKBLANKING Syntax ANIMATEIJKBLANKING NUMSTEPS lt integer gt optional parameters Description Produce an animation of differe
109. M KM Prepare to write out geometry record circle Circle is positioned at 25 25 in frame units and has a radius of 30 Circle is drawn using a dashed line pattern XP a 25 YP 25 ZP 0 0 IsFilled 0 Color 0 FillColor 7 GeomType a2 LinePattern 1 LineThickness 0 3 PatternLength 1 NumEllipsePts 72 ArrowheadStyle 0 ArrowheadAttachment 0 ArrowheadSize 0 0 ArrowheadAngle 15 0 NumSegments 1 NumSegPts 1 I XGeomData 1 30 YGeomData 1 0 0 308 Example Programs PPP PPMP PPP PPM PPMP MMP MM SM M HM Q Clo Q Clo ZGeomData 1 0 0 III TECGEO100 XP YP ZP PositionCoordSys AttachToZone zone Color FillColor IsFilled GeomType LinePattern PatternLength LineThickness NumEllipsePts ArrowheadStyle ArrowheadAttachment ArrowheadSize ArrowheadAngle Scope Clipping NumSegments NumSegPts XGeomData YGeomData ZGeomData r1 NULCHAR se out file 1 I TECEND100 se out file 2 III 2 I TECFIL100 III I TECEND100 STOP END 309 Chapter 11 Writing Binary Data for Loading into Tecplot 11 7 4 Complex Example C Complex example C program to write a binary data file for Tecplot This example does the following 1 Open a data file called field plt 2 Open a data file called line plt 3 Assign values for X Y and P These will be used in both the ordered and finite
110. MINATIONLINE Syntax SYSTEM lt string gt optional parameters RAWDATA uo ue w ooo ww N ooo ISYSTEM Description Instruct Tecplot to submit a command to the operating system For security reasons execution of the SYSTEM command can be disabled to prevent unauthorized execution of system commands via macros Use the OKTOEXECUTESYSTEMCOMMAND option to the INTERFACE macro command Example Submit the system command to copy the file t7 p1t toxxx plt UNIX SYSTEM cp t7 plt xxx plt Optional Parameters Parameter Syntax Default Notes WAIT lt boolean gt TRUE If TRUE Tecplot will wait until the execution of the sys tem command has completed before continuing 181 Chapter 5 Macro Commands Syntax THREEDAXIS optional parameters THREEDAXIS Description A SetValue command that assigns attributes for axes in a 3 D frame Optional Parameters Parameter Syntax Notes XYDEPXTOYRATIO lt op gt lt dexp gt AXISMODE must be XYDEPENDENT to use this DEPXTOYRATIO lt op gt lt dexp gt AXISMODE must be DEPENDENT to use this DEPXTOZRATIO lt op gt lt dexp gt AXISMODE must be DEPENDENT to use this AXISMODE lt axismode gt Set to INDEPENDENT XYDEPENDENT or XYZDEPENDENT ASPECTRATIOLIMIT lt op gt lt dexp gt Restrict the aspect ratio of the data ASPECTRATIORESET lt op gt lt dexp gt
111. Magnify picked objects 149 Major macro commands 13 Managing Tecplot macros 5 Mandatory parameters 10 Mappings delete 68 duplicate 72 MAXCHRSINTEXTLABELS 130 MAXCUSTOMCOLORSININTERFACE 123 Maximizing workspace view 198 199 Maximum values as variables 243 MAXNUMCONTOURLEVELS 130 MAXPREPLOTVARS 130 MAXPREPLOTZONES 130 MAXPTSINALINE 130 MAXTRACELINES 123 MEDIUMSTEP 125 126 Mesh attributes 82 Mesh plots show 84 Message display 142 Minimum values as variables 244 MINPIXELSFORDRAG 123 Mirror zones create 59 creating example 59 Modern color maps 44 Modifiers command specific 10 Monochrome hardcopy 222 Mouse button assignments 231 Mouse mode set for picking 150 Move picked objects 150 Moving data point 120 view 194 workspace view 198 N Name get frame name 94 Naming data set 171 Negative values 25 Number format 215 Number of cycles for animation 31 32 Number of ellipse points 35 number of planes 245 number of zones 245 330 numberformat subcommand 215 Numbers formatting in macro variables 249 NUMPTSALLOWEDBEFOREAPPROX 124 NUMSMOOTHPASSES 122 NUMSTREAMRAKEPOINTS 92 0 OKTOEXECUTESYSTEMCOMMAND 124 OpenGL rendering settings 220 OpenGL rendering 220 OPENGLCONFIG 124 Operating system using as variable 245 Operating system instructions 181 Operator associativity 238 Operator precedence 238 Optional box settings 224 Optional parameters 10 Order frames 88 Ordering frames 89 Output
112. Minimum and maximum fractions are in terms of JMINFRACT lt op gt lt dexp gt percentages 0 100 Zero represents an index of KMINFRACT lt op gt lt dexp gt one and 100 the maximum index IMAXFRACT lt op gt lt dexp gt JMAXFRACT lt op gt lt dexp gt KMAXFRACT lt op gt lt dexp gt ZONE lt integer gt Only one zone can be assigned to use IJK blank ing VALUE VALUEBLANKCELLMODE lt valueblankcellmode gt BLANKENTIRECELL lt boolean gt Set to FALSE to get precision blanking INCLUDE lt boolean gt Set to FALSE to turn off all value blanking CONSTRAINT nnn lt integer gt Use lt integer gt to specify which constraint to modify INCLUDE lt boolean gt RELOP lt valueblankrelop gt CONSTRAINTOP2MODE lt constraintop2mode gt VALUECUTOFF lt double gt VARA lt integer gt VARB lt integer gt SHOW lt boolean gt COLOR lt color gt LINEPATTERN lt linepattern gt PATTERNLENGTH lt double gt LINETHICKNESS lt double gt DEPTH If TRUE draws only those portions at the plot with depth values within the FROMFRONT and INCLUDE lt boolean gt FROMBACK limits FROMFRONT and FROM FROMFRONT lt double gt BACK are expressed as percentages of the overall FROMBACK lt double gt 3 D depth Examples Example 1 Set IJK blanking to cut away the minimum index corner BLANKING IJK 41 Chapter 5 Macro Commands INCLUDE YES IMINFRACT 0 JMINFRACT 0 KMINFRACT 0 IMAXF
113. N WIDTH lt op gt lt dexp gt Value is grid units NUMRODPOINTS lt op gt lt integer gt Number of points used to define the MESH streamrod cross section SHOW COLOR lt boolean gt LINETHICKNESS lt color gt lt op gt lt dexp gt CONTOUR SHOW USELGHTINGEFFECT lt boolean gt FLOODCOLORING lt boolean gt lt contourcoloring_e gt SHADE SHOW COLOR USELIGHTINGEFFECT lt boolean gt lt color gt SURFACEEFFECT lt boolean gt LIGHTINGEFFECT SURFACETRANSLUCENCY USETRANSLUCENCY lt lightingeffect gt lt translucency gt lt boolean gt LINETHICKNESS lt op gt lt dexp gt MAXSTEPS lt op gt lt integer gt COLOR lt color gt 113 Chapter 5 Macro Commands Parameter Syntax Notes STREAMTIMING DOTIMEMARKS lt boolean gt DOTIMEDASHES lt boolean gt DELTATIME lt op gt lt dexp gt STARTTIME lt op gt lt dexp gt ENDTIME lt op gt lt dexp gt MARKCOLOR lt color gt MARKSIZE lt op gt lt dexp gt DASHSKIP lt op gt lt integer gt MARKSYMBOL lt lt symbolshape gt gt TERMLINE Use the STREAMTRACE action com mand to define the stream termination ISACTIVE lt boolean gt polyline SHOW lt boolean gt COLOR lt color gt LINEPATTERN lt linepattern gt PATTERNLENGTH lt op gt lt dexp gt LINETHICKNESS lt op gt lt dexp gt GLOBALTHREED Syntax GLOBALTHREED optional parameters Description A SetValue co
114. N MAX BOTH lt boxtype gt NONE FILLED HOLLOW lt charactersequence gt One or more printable characters lt clipping gt CLIPTOVIEWPORT CLIPTOFRAME lt color gt BLACK RED GREEN BLUE CYAN YELLOW PURPLE WHITE CUSTOM1 to CUSTOM56 MULTI1 MULTI2 MULTI3 MULTI4 RGBCOLOR lt colormap gt lt standardcolormap gt WILD USERDEF RAWUSERDEF lt colormapcontrol gt COPYSTANDARD REDISTRIBUTECONTROLPOINTS RESETTOFACTORY lt colormapdistribution gt BANDED CONTINUOUS lt conditionalexp gt lt dexp gt lt relop gt lt dexp gt or lt string gt lt relop gt lt string gt lt contourcoloring gt RGB GROUP1 GROUP2 GROUP3 GROUP4 lt contourlabelaction gt ADD DELETEALL lt contourlevelaction gt ADD DELETENEAREST DELETERANGE NEW RESET lt contourlinemode gt USEZONELINETYPE SKIPTOSOLID DASHNEGATIVE lt contourtype gt LINES FLOOD BOTHLINESANDFLOOD AVERAGECELL PRIMARYVALUE lt coordscale gt LINEAR LOG lt coordsys gt GRID FRAME XYZGRID lt curveinfomode gt CURVEDETAILS CURVEPOINTS lt curvetype gt LINESEG CURVFIT SPLINE PARASPLINE ETORFIT POWERFIT EXTENDED lt datatype gt SINGLE DOUBLE LONGINT SHORTINT BYTE BIT lt derivpos gt SIMPLE ATPOINT COMPLEX ATPOINTB2 lt dexp gt lt double gt lt expression gt lt double gt Valid floating point value
115. NAME lt boolean gt REDCHANNELLABEL lt string gt USEGREENVARNAME lt boolean gt GREENCHANNELLABEL lt string gt USEBLUEVARNAME lt boolean gt BLUECHANNELLABEL lt string gt RGBLEGENDORIENTATION OrientRGB OrientGBR OrientBRG OrientRBG OrientBGR OrientGRB Example This example turns on RGB Coloring and defines variables for the Red and Green Channel leaving Tecplot to calculate the Blue Channel values 107 Chapter 5 Macro Commands GLOBALRGB RGBMODE SPECIFYRG REDCHANNELVAR 1 GREENCHANNELVAR 4 GLOBALSCATTER Syntax GLOBALSCATTER optional parameters Description A SetValue command that changes global attributes associated with scatter plots Optional Parameters Parameter Syntax Notes VAR lt integer gt Scatter sizing variable RELATIVESIZE lt op gt lt dexp gt Scaling factor for scatter symbols sized By Variable RELATIVESIZEINGRIDUNITS lt boolean gt If TRUE scatter sizing By Variable is in grid units magnitude otherwise centimeters magnitude BASEFONT lt font gt LEGEND SHOW lt boolean gt SHOWTEXT lt boolean gt TEXTCOLOR lt color gt ROWSPACING lt op gt lt dexp gt TEXTSHAPE lt lt textshape gt gt Not allowed to change size units parameter BOX lt lt textboxtype gt gt ANCHORPOS lt lt anchorpos gt gt 108 Parameter Syntax Notes REFSCATSYMBOL
116. NTERPNPOINTS 122 Interpolation inverse distance method 128 kriging 129 linear method 131 INTERPPTSELECTION 122 INTERRUPTCHECKINGFREQUENCY 122 INVDISTEXPONENT 122 INVDISTMINRADIUS 122 Inverse distance interpolation 128 J ordered zones 186 ISFILLED 35 Iso surfaces 103 Isosurfaces create FE surfaces 58 J J Range 24 Jumping out of a macro 44 K K Range 24 KRIGDRIFT 122 Kriging 129 Kriging Drift 232 KRIGRANGE 122 KRIGZEROVALUE 122 L Labels tick marks 226 LARGESTEP 125 126 Layout printing to paper or file 154 saving 169 Layout files macro control commands 255 Layout of frames 89 90 Layouts attach data set of another frame 33 clearing 139 new 139 opening layout file 140 Light source shading 114 183 change settings command 44 Limitations 255 Limits set in Tecplot 130 Line mappings 22 30 72 animate command 30 assigning attributes 132 create 58 default attributes 255 delete 68 draw order 174 duplicate 72 number of line mappings 245 set active mappings command 22 writing coefficients 200 writing curve information 200 line mappings show symbols 135 Line maps activating 22 see Line mappings 69 Line pattern 35 Line plot layers turning on and off 135 Line plots 30 setting global attributes 104 show lines 135 Line spacing text 37 Line thickness 35 Linear interpolation 131 LINEARINTERPCONST 122 LINEARINTERPMODE 122 LINEPATLENGTHS 40 Lines line plots 135 LINETHICKNESSES 40 LISTCOMMAN
117. NTSETUP SENDPRINTTOFILE FALSE DRIVER PS PALETTE MONOCHROME SPOOLER PSMONOSPOOLCMD lpr PROMPTFORFILENAME Syntax PROMPTFORFILENAME lt macrovar gt DIALOGTITLE lt string gt DEFAULTFNAME lt string gt FILEFILTER lt string gt Description Instruct Tecplot to launch a file selection dialog The resulting file name will be placed in lt macrovar gt If the user cancels out of the dialog then lt macrovar gt will be empty see the example below 156 Optional Parameter Parameter Syntax Default Notes DIALOGTITLE lt string gt Null Include a title at the top of the dialog DEFAULTFNAME lt string gt Null Make the dialog come up with a default file name FILEFILTER lt string gt Null Set the filter for the file selection dialog FILEMUSTEXIST lt string gt TRUE Example Prompt the user for the name of a file to delete PROMPTFORFILENAME filetodelete DIALOGTITLE Delete File FILEFILTER Wk ku IF filetodelete IF OPSys 1 System rm filetodelete UNIX S Endif IF OPSys 2 DOS System del filetodelete S Endif S Endif PROMPTFORTEXTSTRING Syntax PROMPTFORTEXTSTRING lt macrovar gt INSTRUCTIONS lt string gt Description Instruct Tecplot to launch a dialog containing a single line text field and optional instructions The user enters text into the text field and the resulting string i
118. NULL ShareVarFromZone amp ShareConnectivityFromZone Write out the field data for the finite element zone IMax 4 JMax 5 IIL IMax JMax DIsDouble 0 I TECDAT100 amp III amp X 0 0 amp DIsDouble I TECDAT100 amp III amp Y 0 0 amp DIsDouble I TECDAT100 amp III amp P 0 0 amp DIsDouble Calculate and then write out the connectivity list Note The NM array references cells starting with offset of 1 for I 1 I lt IMax I for J 1 J lt JMax J K I J 1 IMax 1 L I J 1 IMax NM K 1 0 L NM K 1 1 L 1 NM K 1 2 L IMax 1 NM K 1 3 L IMax 314 Example Programs I TECNOD100 INTEGER4 NM Prepare to write out text record Text is positioned at 0 5 0 5 in frame units and has a height of 0 05 frame units XP 50 0 YP 50 0 ZP 0 0 FH 5 0 Scope 1 Local Clipping 1 Clip to frame PositionCoordSys 1 Frame FontType 1 Helv Bold HeightUnits 1 Frame AttachToZone 0 zone 0 BoxType 0 None BoxMargin 5 0 BoxLineThickness 0 5 BoxColor 3 BoxFillColor 7 TextAngle 0 0 Anchor 0 Left LineSpacing 1 0 TextColor 0 Black III TECTXT100 amp xXP amp YP amp ZP amp PositionCoordSys amp AttachToZone amp Zone amp FontType amp HeightUnits amp FH amp BoxType a
119. NumPts For ordered zones the number of nodes in the I index direction For finite element zones the number of nodes JMxOrNumElements For ordered zones the number of nodes in the J index direction For finite element zones the number of elements KMx For ordered zones the number of nodes in the K index direction Not used for finite element zones ICellMax For zones of type FEBRICK only the number of cells logically connected in the I index direction JCellMax 282 Binary Data File Function Reference For zones of type FEBRICK only the number of cells logically connected in the J index direction KCellMax For zones of type FEBRICK only the number of cells logically connected in the K index direction IsBlock Indicates whether the data will be passed into TECDAT100 in BLOCK or POINT format O0 POINT 1 BLOCK NumFaceConnections The number of face connections that will be passed in routine TECFACE100 FaceNeighborMode The type of face connections that will be passed in routine TECFACE100 0 LocalOneToOne 1 LocalOneToMany 2 GlobalOneToOne 3 GlobalOneToMany ValueLocation The location of each variable in the data set ValueLocation I indicates the location of variable I for this zone O cell centered 1 node centered Pass null to indicate that all variables are node centered ShareVarFromZone Indicates variable sharing ShareVarFromZone I indicates the zone number wi
120. OENTIRECIRCLE S VIEW RESETTOENTIRECIRCLE no parameters Reset the Theta R Axis to inital settings For Polar plots only VIEW RESETTOENTIRECIRCLE 193 Chapter 5 Macro Commands Syntax VIEW SETMAGNIFICATION VIEW SETMAGNIFICATION MAG lt dexp gt Description Set the magnification for the data being plotted A magnification of 1 will size the plot so it can fit within the grid area Required Parameter Parameters Syntax Notes MAGNIFICATION lt dexp gt Example Syntax Description Make the plot to be drawn one half as big as when it fits within the grid area VIEW SETMAGNIFICATION MAGNIFICATION 0 5 VIEW TRANSLATE VIEW TRANSLATE X lt dexp gt Y lt dexp gt no optional parameters Shift the data being plotted in the X and or Y direction The amount translated is in frame units Required Parameters Parameters Syntax Default Notes X 0 0 Amount to translate in X frame units Y 0 0 Amount to translate in Y frame units 194 Example Syntax Description Translate the view 10 percent of the frame width to the right VIEW TRANSLATE X 10 VIEW ZOOM VIEW ZOOM X1 lt dexp gt Y1 lt dexp gt X2 lt dexp gt Y2 lt dexp gt no optional parameters Change the view by zooming into the data In Sketch XY and 2D frame mode plots Tecplot will adjust the ranges on the
121. ONTOURLABELS ADD CONTOURLABELS DELETEALL CONTOURLABELS ADD Syntax CONTOURLABELS ADD optional parameters Description Add contour labels to your plot Optional Parameters Parameter Syntax Default Notes XYZPOS X lt dexp gt 0 0 X position for contour label Y lt dexp gt 0 0 Y position for contour label Z lt dexp gt 0 0 Z position for contour label use Z only for 3 D plots ISALIGNED TRUE If TRUE then align the contour label along the contour line lt boolean gt if FALSE draw the label horizontally CONTOURGROUP 1 Defines which contour group is changed lt integer gt Example The following commands add labels at 0 5 0 25 and 0 73 0 17 in a 48 2 D field plot The labels will be aligned CONTOURLABELS ADD CONTOURGROUP 2 XYZPOS X 0 5 Y 0 25 CONTOURLABELS ADD XYZPOS X 0 73 Y 0 17 CONTOURLABELS DELETEALL Syntax CONTOURLABELS DELETEALL optional parameters Description Delete all currently defined contour labels Optional Parameters Parameter Syntax Default Notes CONTOURGROUP 1 Defines which contour group is changed lt integer gt Example CONTOURLABELS DELETEALL CONTOURGROUP 3 CONTOURLEVELS Required Control Option Description The different commands in the CONTOURLEVELS compound function family are described separately in the following sections
122. P I J I J 10 Continue Cc C Write the zone header information Cc I TecZne Simple Zone NULLCHR amp IMax amp JMax amp KMax amp BLOCK NULLCHR amp CHAR 0 Cc C Write out the field data Cc III IMax JMax I TecDat III X 0 I TecDat III Y 0 300 Example Programs I TecDat III P 0 I TecEnd Stop End 11 7 2 Simple Example C i ma Simple example C program to write a binary data file for Tecplot This example does the following 1 Open a datafile called t plt 2 Assign values for X Y and P 3 Write out a zone dimensioned 4x5 4 Close the data file nclude TECIO h in float X 5 4 Y 5 4 P 5 4 INTEGER4 Debug I J III DIsDouble VIsDouble IMax JMax KMax Debug 1 VIsDouble 0 DIsDouble 0 IMax 4 JMax 5 KMax 1 Open the file and write the Tecplot data file header information I TECINI SIMPLE DATASET ux Y p 7 t plt 3 i n amp Debug amp VIsDoub1le for J 0 J lt 5 J 301 Chapter 11 Writing Binary Data for Loading into Tecplot for I 0 I lt 4 I X J I I 1 Y J I J 1 P J I I 1 d 1 Write the zone header information I TECZNE Simple Zone amp IMax amp JMax amp KMax BLOCK NULL Write out the field data III IMax JMax I TECD
123. R 7 Parameter Assignment Values Expressions and Arithmetic and Logical Operators 7 1 Assignment Value Table Parameter assignments referenced in the previous chapters using single angle brackets lt gt are defined here Case is not important Table 7 1 Parameter Assignment Values Value Identifier Allowable Values lt addonstyle gt V7STANDARD V7ACTIVEX lt altmousebuttonmode gt REDRAW REVERTTOSELECT lt anglespec gt RADIANS DEGREES lt arrowheadattachment gt NONE ATBEGINNING ATEND ATBOTHENDS lt arrowheadstyle gt PLAIN FILLED HOLLOW lt axisalignment gt WITHVIEWPORT WITHOPPOSINGAXISVALUE WITHGRIDMIN WITHGRIDMAX WITHSPECIFICANGLE WITHGRIDAREATOP WITHGRIDAREABOTTOM WITHGRIDAREALEFT WITHGRIDAREARIGHT lt axismode gt INDEPENDENT XYDEPENDENT XYZDEPENDENT lt axistitlemode gt USEVARNAME USETEXT 231 Chapter 7 Parameter Assignment Values Expressions and Arithmetic and Logical Operators Table 7 1 Parameter Assignment Values Value Identifier Allowable Values lt axistitleposition gt LEFT CENTER RIGHT lt backingstoremode gt NOTUSED REALTIMEUPDATE PERIODICUPDATE lt bitdumpregion gt CURRENTFRAME ALLFRAMES WORKAREA lt boolean gt YES NO TRUE FALSE ON OFF lt boundarycondition gt FIXED ZEROGRADIENT ZERO2ND lt boundarysetting gt NONE MI
124. RACT 50 JMAXFRACT 50 KMAXFRACT 50 Example 2 Use value blanking to cut away all cells that have at least one node where variable 3 is less than or equal to 7 5 BLANKING VALUE INCLUDE YES CONSTRAINT 1 INCLUDE YES VARA 3 RELOP LESSTHANOREQUAL VALUECUTOFF 7 5 BRANCHCONNECTIVITY Syntax BRANCHCONNECTIVITY ZONE lt integer gt no optional parameters Description For zones where connectivity is shared this command allows for branching of connectivity information from the specified zone Required Parameters Parameter Syntax Notes ZONE lt integer gt 42 Example Suppose Zones 2 3 and 4 share connectivity This command branches the connectivity of the second zone Zones 3 and 4 will still share connectivity BRANCHCONNECTIVITY ZONE 2 BRANCHFIELDDATAVAR Syntax BRANCHF IELDDATAVAR ZONE lt integer gt VAR lt integer gt no optional parameters Description Allows for branching of specified variable in the specified zone for zones that share variables Required Parameters Parameter Syntax Notes ZONE lt integer gt VAR lt integer gt Example Assume Zones 1 2 and 4 share variables 3 and 5 This command branches the third variable from the second zone Variable 3 will still be shared by zones 1 and 4 while variable 5 will still be shared by all three zones BRANCHFIELDDATAVAR ZONE
125. RACTTHROUGHVOLUME FALSE If TRUE data is extracted from X YZ coordinates lt boolean gt in the polyline If FALSE data is extracted from the surface EXTRACTLINEPOINTSONLY FALSE If FALSE must include NUMPTS lt boolean gt INCLUDEDISTANCEVAR lt boolean gt FALSE If TRUE Tecplot includes an extra variable in the result which is the distance along the line of points extracted and EXTRACTOFILE must also be TRUE NUMPTS lt integer gt Required if EXTRACTLINEPOINTSONLY is FALSE 80 Parameters Syntax Default Notes EXTRACTTOFILE lt boolean gt FALSE If FALSE a zone is created If TRUE you must include FNAME FNAME lt string gt File name for extracted file Required if EXTRACTTOFILE is TRUE Example with the extracted data EXTRACTFROMPOLYLINE EXTRACTLINEPOINTSONLY RAWDATA H o A uF PF KP WWD FE OO ort HU PP NYD PDN OO ooooooo0o0oo o Syntax FIELD lt set gt optional parameters Extract 10 points from specific locations in a field plot Create a zone TRUE FIELD Description A SetValue command that assigns zone attributes for field plots The lt set gt parameter immediately following the FIELD command is optional If lt set gt is omitted then the assignment is applied to all zones Otherwise the assignment is applied only to the zones specified in lt sef gt 81 Chapter 5 Ma
126. RM file add EXPORTSETUP commands before this command Required Parameters Parameter Syntax Notes START lt integer gt Starting zone number END lt integer gt Ending zone number Optional Parameters Parameter Syntax Default Notes SKIP lt integer gt 1 Zone skip CREATEMOVIEFILE lt boolean gt FALSE If TRUE must be preceded by EXPORTSETUP commands Example The following example animates just the first five zones ANIMATEZONES START 1 END 5 ATTACHDATASET Syntax ATTACHDATASET optional parameter Description Attach the current frame to the data set of another frame This command is usually found only in layout files generated by Tecplot Note that the FRAMEMODE command automatically executes an ATTACHDATASET command if a frame mode is requested in a frame that does not have an attached data set Tecplot attaches the data set from the closest frame in drawing order having an attached data set 33 Chapter 5 Macro Commands Optional Parameter Parameter Syntax Default Notes FRAME lt integer gt numframes 1 Frames are numbered 1 to numframes based on the order they are drawn when a Redraw All is executed Examples Example 1 The following example attaches to the current frame the data set from the second frame drawn when doing a Redraw All ATTACHDATASET FRAME 2 Example 2 The f
127. RUE Example Write out a stylesheet for the current frame to 1 sty S WRITESTYLESHEET fl sty INCLUDEFACTORYDEFAULTS TRUE X YLINEAXIS Syntax XYLINEAXIS optional parameters Description A SetValue command that assigns attributes for axes in an XY Line plot Optional Parameters Parameter Syntax Notes DEPXTOYRATIO lt op gt lt dexp gt AXISMODE must be XYDEPENDENT to use this This applies only to the X1 and Y1 axes AXISMODE lt axismode gt Set to INDEPENDENT or XYDEPEN DENT GRIDAREA lt lt gridarea gt gt XDETAIL lt integer gt lt lt axisdetail gt gt The lt integer gt option specifies which axis to operate on 1 lt n lt 5 YDETAIL lt integer gt lt lt axisdetail gt gt The lt integer gt option specifies which axis to operate on 1 lt n lt 5 PRECISEGRID lt lt precisegrid gt gt VIEWPORTTOPSNAPTARGET lt integer gt Default 100 VIEWPORTTOPSNAPTOLER lt integer gt Default 10 ANCE VIEWPORTNICEFITBUFFER lt double gt Between 1 and 100 203 Chapter 5 Macro Commands Parameter Syntax Notes AUTOADJUSTRANGES lt boolean gt TONICEVALUES PRESERVEAXISSCALE lt boolean gt Example Set the axis mode to be independent for the XY axes note that this affects only X1 versus Y1 XYLINEAXIS AXISMODE INDEPENDENT 204 cHAPTER6 Parameter Subcommands This chapt
128. S lt integer gt optional parameters Description Reset the contour levels to a set of evenly distributed values spanning the entire range of the currently selected contouring variable Required Parameter Parameter Syntax Notes NUMVALUES lt integer gt New number of contour levels Optional Parameters Parameter Syntax Default Notes CONTOURGROUP 1 Defines which contour group is changed lt integer gt 53 Chapter 5 Macro Commands Example Syntax Description Reset the contour levels to use 150 levels CONTOURLEVELS RESET NUMVALUES 150 CONTOURLEVELS RESETTONICE CONTOURLEVELS RESETTONICE APPROXNUMVALUES lt integer gt optional parameters Reset the contour levels to a set of evenly distributed nice values spanning the entire range of the currently selected contouring variable with a specified number of entries Required Parameter Parameter Syntax Notes APPROXNUMVALUES lt integer gt Approximate number of contour levels desired Actual value may be different Optional Parameters Parameter Syntax Default Notes CONTOURGROUP 1 Defines which contour group is changed lt integer gt Example Reset the contour levels to use 150 levels CONTOURLEVELS RESETTONICE APPROXNUMVALUES 10 54 Syntax JMAX CREATECIRCULARZONE CREATECIRCULARZONE IMAX
129. T 7 10 128 KRIG Syntax KRIG DESTINATIONZONE lt integer gt optional parameters Description Interpolate selected variables from a set of source zones to a destination zone using the kriging method Required Parameter Parameters Syntax Notes DESTINATIONZONE lt integer gt Zone to interpolate to Optional Parameters Parameters Syntax _ Default Notes SOURCEZONES lt set gt All zones except the destination zone VARLIST lt set gt All variables except Choose the variables to interpolate The spatial spatial variables variables X Y and Z if 3 D are not allowed KRIGRANGE lt dexp gt 0 3 KRIGZEROVALUE lt dexp gt 0 0 KRIGDRIFT lt krigdrift gt LINEAR INTERPPTSELECTION OCTANTNPOINTS lt interpptselection gt INTERPNPOINTS lt integer gt 8 Example Krig from zones 3 and 4 onto zone 2 Only interpolate variable 7 KRIG SOURCEZONES 3 4 DESTINATIONZONE 2 VARLIST 7 129 Chapter 5 Macro Commands LAUNCHDIALOG Syntax LAUNCHDIALOG lt dialogname gt no parameters Description Launch a Tecplot interface dialog lt dialogname gt can be one of Example COLORMAP EQUATION PLOTATTRIBUTES QUICKEDIT MACROVIEWER QUICKMACROPANEL or VALUBLANKING This command is mainly useful for the Tecplot demo Launch Tecplot s Macro Viewer dialog LAUNCHDIALOG MACROVIEWER
130. T 120 Binary data files 323 Index function reference 262 Bit dump region 232 Blanking 41 animate command 27 change settings command 40 IK 40 value 40 BOLDFACTOR 87 Boundary attributes 83 Boundary condition 232 Boundary plot layer 57 Boundary plots show 84 Boundary setting 232 Box type 232 Boxed text 37 Break out command 44 Bringing up the Quick Macro Panel immediately 6 Buffer commands 69 71 Cc CACHELIGHTDISPLAYLISTSONLY 120 Case of characters 241 Cell labels 109 Center view 190 Changing sets of line maps 22 of zones 21 Changing settings axis grid areas 206 axis gridlines 213 color map overrides 211 212 for IJK or value blanking 40 paper sizes 216 rectangles 219 Character sequence 232 Circle 35 raw data 251 Circular zone 55 Clear picked objects 146 Clearing layout 139 CLIPPING 35 Color control commands 45 47 Color distribution 210 Color flooding 212 Color map color spectrum 44 control 45 dynamic 242 gray scale output 222 loading 137 reset to default 44 setting RGB values 160 writing to file 200 Color map control 232 Color map distribution 232 Color map files 255 Color map overrides setting 211 Color maps 44 45 210 211 232 assignment value options 235 contour 210 currently active 46 raw data 251 Raw User Defined 210 standard 46 Color text 37 colormapcontrolpoints subcommand 210 COLORMAPFILE 85 colormapoverrides subcommand 211 Colors 35 232 assigning RGB values 222 RGB 106
131. TIONS Example Shift the currently picked objects 1 inch to the right and 2 inches down PICK SHIFT X 1 Ye 2 PLOTTYPE Syntax PLOTTYPE lt plottype gt no parameters Description Changes plot types between valid Tecplot modes such as 151 Chapter 5 Macro Commands XYLine and Cartesian2D Valid options shown below Required Parameters Parameter Syntax Notes PLOTTYPE lt plottype gt Example Change the plot style to show a polar plot Syntax PLOTTYPE POLARLINE POLARAXIS optional parameters POLARAXIS Description A SetValue command that assigns attributes for axes in a polar frame Optional Parameters Parameter Syntax Notes THETAMODE lt thetamode gt THETAPERIOD lt double gt GRIDAREA lt lt areastyle gt gt VIEWPORTPOSITION lt lt rect gt gt VIEWPORTSTYLE lt lt areastyle gt gt THETADETAIL lt lt axisdetail gt gt RDETAIL lt lt axisdetail gt gt PRECISEGRID lt lt precisegrid gt gt PRESERVEAXISSCALE lt boolean gt 152 Example Syntax Description Set the Theta range in Radians from Pi to Pi POLARAXIS THETAMODE RADIANS POLARAXIS THETAPERIOD 6 28318530718 POLARAXIS THETADETAIL VALUEATORIGIN 0 POLARAXIS THETADETAIL RANGEMIN 3 14159265359 POLARTORECTANGULAR POLARTORECTANGULAR lt set gt no parameters Treat the variables
132. TOM1 CUSTOM56 lt lt rgb gt gt Example Set the CUSTOMS color to be brown BASICCOLOR CUSTOM8 R 165 G 42 B 42 BASICSIZE Syntax 1 BASICSIZE optional parameters 39 Chapter 5 Macro Commands Description A SetValue command that sets sizes of various objects like line thicknesses line pattern length font height and so forth Sizes can be assigned when interacting with Tecplot by either entering an exact value or by choosing from a preset list of values The BASICSIZE command allows you to change the values in the preset lists Optional Parameters Parameter Syntax Notes LINETHICKNESSES lt lt basicsizelist gt gt TICKLENGTHS lt lt basicsizelist gt gt SYMBOLSIZES lt lt basicsizelist gt gt LINEPATLENGTHS lt lt basicsizelist gt gt ARROWHEADSIZES lt lt basicsizelist gt gt POINTTEXTSIZES lt lt basicsizelist gt gt FRAMETEXTSIZES lt lt basicsizelist gt gt Example Change the medium line pattern length to be 2 5 percent BASICSIZE LINEPATLENGTHS MEDIUM 2 5 Syntax BLANKING optional parameters BLANKING Description A SetValue command that changes settings for IJK or value blanking 40 Optional Parameters Parameter Syntax Notes IJK INCLUDE lt op gt lt boolean gt IJKBLANKMODE lt ijkblankmode gt IMINFRACT lt op gt lt dexp gt
133. TSETUP EXPORTFORMAT AVI EXPORTSETUP IMAGEWIDTH 546 EXPORTSETUP EXPORTFNAME 1 AxisRotation avi 1 EXPORTSTART LOOP 2 ANGLE 3 ROTATEORIGINLOCATION DEFINEORIGIN REDRAW EXPORTNEXTFRAME ENDLOOP EXPORTFINISH ENDMACROFUNCTION RUNMACTOFUNCTION 3D Rotation Animation Theta 6 30 The following commands define a macro function that opens two layout files MACROFUNCTION NAME OL2 OPENLAYOUT 1 OPENLAYOUT 2 APPEND TRUE ENDMACROFUNCTION 248 Using Formats in Macro Variables RUNMACROFUNCTION OL2 gl lay g2 lay 8 8 Using Formats in Macro Variables When a macro variable is expanded and the macro variable is a numeric value it is expanded using a best float format It tries to make the number look as simple as possible while still retaining as much accuracy as possible If you want the number to be formatted in a specific way then you can include C style number formatting strings in the macro variable specifica tion The syntax for including a format string is Example 1 Example 2 macrovariable formatstring Suppose you want to pause a macro and display the message Maximum contour value is xxxxxx where xxxxxx only has two digits to the right of the decimal place You would use Pause Maximum contour value is MAXC 2f If MAXC currently has a value of 356 84206 then the dialog would show Maximum contour value
134. The lt string gt is the name of the add on to load See Chapter 31 Add Ons of the Tecplot User s Manual for instructions on how to specify the add on Optional Parameters Parameters Syntax Default Notes INITFUNCTION InitTecAddon Name of the function inside of the add on that is used to lt string gt initialize the add on ADDONSTYLE lt string gt V7Standard Style of the add on to load This can be either V7STANDARD or V7ACTIVEX Example Load the Circle Stream add on It is a V7STANDARD add on stored in a Syntax Description Example Syntax Description library named cstream LOADADDON cstream LOADCOLORMAP LOADCOLORMAP lt string gt no parameters Load a color map file The lt string gt is the name of the file to load LOADCOLORMAP mycolors map LOOP ENDLOOP LOOP lt integer gt ENDLOOP Process macro commands in a loop Within the loop you may access the current loop counter using the internal macro variable Loop Loops may be nested up to 10 levels deep 137 Chapter 5 Macro Commands Example Syntax Description Process macro commands 3 times over LOOP 3 ENDLOOP MACROFUNCTION ENDMACROFUNCTION MACROFUNCTION NAME lt string gt optional parameters ENDMACROFUNCTION Define a macro function All commands between a MACROFUNCTION and the ENDMACROFUNCTION are associated with
135. UFFER OFF 69 Chapter 5 Macro Commands Syntax Description Example Syntax Description Example Syntax Description Example DOUBLEBUFFER ON DOUBLEBUFFER SWAP DOUBLEBUFFER OFF DOUBLEBUFFER OFF no parameters Turn off double buffering use this command once at the end of a sequence of using the double buffer See DOUBLEBUFFER SWAP DOUBLEBUFFER ON DOUBLEBUFFER ON no parameters Turn on double buffering use this command once at the beginning of a sequence of using the double buffer While double buffering is turned on all drawing is sent to the back buffer See DOUBLEBUFFER SWAP DOUBLEBUFFER SWAP DOUBLEBUFFER SWAP no parameters Swap the back buffer to the front In other words copy the image in the back buffer to the front The following example uses the double buffer to show the rotation of a 3 D object 70 Syntax Description Example Syntax Description Example DOUBLEBUFFER ON LOOP 10 ROTATE3DVIEW X ANGLE 5 REDRAW DOUBLEBUFFER SWAP ENDLOOP DOUBLEBUFFER OFF DRAWGRAPHICS DRAWGRAPHICS lt boolean gt no parameters Turn on or off all graphics drawing Turning off all graphics during preliminary portions of a macro file can greatly increase the efficiency of the macro Turn off all graphics drawing DRAWGRAPHICS NO DROPDIALOG DROPDIALOG lt dialogname gt no parameters
136. UIT Quit Tecplot Action I RAWCOLORMAP Install a raw color map Action READDATASET Load a data set by reading in one or more data Action files READSTYLESHEET Read a stylesheet into the current frame Action REDRAW Redraw the current frame Action REDRAWALL Redraw all frames Action I REMOVEVAR Remove a user defined macro variable Control RENAMEDATASETVAR Rename a data set variable Action I RENAMEDATASETZONE Rename a data set zone Action RESET3DAXES Reset the 3 D axes Action RESET3DORIGIN Reset the 3 D origin to the centroid of the Action data 1 RESET3DSCALEFACTORS Reset the 3 D axes scale factors Action RESETVECTORLENGTH Reset the vector length Action ROTATE2DDATA Rotate 2 D data This alters the data set Action ROTATE3DVIEW Rotate a 3 D object Action RUNMACROFUNCTION Run a macro function Control SAVELAYOUT Save the layout to a file Action SET3DEYEDISTANCE Set view distance from the current center of FSV rotation SETAUXDATA Add auxilary data to an object GSV SETDATASETTITLE Set the data set title Action 18 Command Description Type SETFIELDVALUE Change the value of a field variable for a spe Action cific index and zone SETSTYLEBASE Set which attributes are used to build new Action frames SHARECONNECTIVITY Share nodemaps between zones GSV SHAREFIELDDATAVAR Shar
137. URCE BACKGROUNDLIGHT 25 GLOBALTHREED LIGHTSOURCE SURFACECOLORCONTRAST 85 GLOBALTHREED LINELIFTFRACTION 7 GLOBALTHREED SYMBOLLIFTFRACTION 0 5 GLOBALTHREED VECTORLIFTFRACTION 6 GLOBALTHREED PERFORMEXTRA3DSORTING YES 115 Chapter 5 Macro Commands GLOBALTHREEDVECTOR Syntax GLOBALTHREEDVECTOR optional parameters Description A SetValue command that changes global attributes associated with 3 D vector plots Optional Parameters Parameter Syntax Notes RELATIVELENGTH lt op gt lt dexp gt UNI FORMLENGTH lt op gt lt dexp gt Value is in Y frame units USERELATIVE lt boolean gt If FALSE vectors are all the same size UNIFORM LENGTH RELATIVELENGTHINGRIDUNITS lt boolean gt If TRUE and USERELATIVE is TRUE then vectors are sized in Grid Units Magnitude If FALSE and USERELATIVE is TRUE then vectors are sized in cm magnitude HEADSIZEASFRACTION lt op gt lt dexp gt Head is sized as a fraction of the stem length HEADSIZEINFRAMEUNITS lt op gt lt dexp gt Value is in Y frame units SIZEHEADBYFRACTION lt boolean gt If TRUE HEADSIZEASFRACTION is used to size arrowheads otherwise HEADSIZEINFRAMEUNITS is used ARROWHEADANGLE lt op gt lt dexp gt Angle is in degrees UVAR lt integer gt Variable number for the X vector component VVAR lt integer gt Variable number for the Y vector component 116
138. V changes to attributes of one frame effect all linked frames LOADADDON Load an add on Action LOADCOLORMAP Load a color map from a file Action LOOP Begin a loop in a macro Control MACROFUNCTION Begin definition of a macro function Control NEWLAYOUT Clear the current layout and start over Action OPENLAYOUT Open and read in a layout file Action PAPER Change paper settings GSV PAUSE Pause the macro and display a message Action PICK Select and operate on objects Action PLOTTYPE Change between view modes FSV POLARAXIS Control axis setings for polar plots FSV POLARTORECTANGULAR Convert coordinate variables from polar to Action rectangular POLARVIEW Set the extents of polar plots GSV 17 Chapter 4 Macro Command Summary Command Description Type PRINT Print the current layout to the system spooler Action or to a file PRINTSETUP Change printing settings GSV PROMPTFORFILENAME Launch a file selection dialog Action PROMPTFORTEXTSTRING Launch a dialog containing a text string and Action optional instructions PROMPTFORYESNO Launch a dialog containing yes and no Action buttons PROPAGATELINKING Link multiple frames FSV PUBLISH Create an HTML file displaying one or more Action images A linked layout with packaged data may be included Q
139. XPORTSETUP commands Example The following example creates an animation of 3 D slices ANIMATESLICES START 1 END 30 NUMSLICES 30 31 Chapter 5 Macro Commands ANIMATESTREAM Syntax ANIMATESTREAM optional parameters Description Produce an animation of stream markers or dashes moving along the currently defined streamtrace paths To create an AVI or RM file add EXPORTSETUP commands before this command Optional Parameters Parameter Syntax Default Notes STEPSPERCYCLE lt integer gt 10 Number of steps to use for each cycle of the animation Increase this number to produce a smoother animation NUMCYCLES lt integer gt 4 Number of cycles in the animation Each cycle shows stream markers or dashes moving along a streamtrace path If DT is the streamtrace delta time then at the end of the cycle the markers or dashes will have moved 2 DT STEPSPERCYCLE 1 STEPSPERCYCLE in time CREATEMOVIEFILE FALSE If TRUE must be preceded by lt boolean gt EXPORTSETUP commands Example The following example animates streamtraces for five cycles with each cycle using ten steps ANIMATESTREAM STEPSPERCYCLE 10 NUMCYCLES 5 ANIMATEZONES Syntax ANIMATEZONES START lt integer gt END lt integer gt optional parameters 32 Description Produce an animation showing one zone at a time To create an AVI or
140. a only must be called immediately after the TECZNE100 function call TECFACE100 where face connections were indicated in the call to TECZNE100 must be called immediately after TECNOD100 for finite 261 Chapter 11 Writing Binary Data for Loading into Tecplot element data or TECZNE100 for ordered data TECZAUXSTR100 must be called follow ing the TECZNE100 call for the zone with which the auxiliary data is associated 11 3 Writing to Multiple Binary Data Files Each time TECINI100 is called it sets up a new file context For each file context you must maintain the order of the calls as described in the previous section The TECFIL100 function is used to switch between file contexts Up to 10 files can be written to at a time TECFIL100 can be called almost anywhere after TECINI100 has been called The only parameter to TECFIL100 an integer n shifts the file context to the nth open file where the files are numbered relative to the order of the calls to TECINI100 See Section 11 7 3 Complex Example FORTRAN and 11 7 4 Complex Example C at the end of this chapter for an example of how to use the TECFIL100 function to write to multiple files 11 4 Character Strings in FORTRAN All character string parameters in FORTRAN must terminate with a null character This is done by concatenating char 0 to the end of a character string For example to send the character string Hi Mom to a function called A
141. a shading attributes 229 Executing macro function 169 Exit command 160 Exporting layout to paper or file 154 Exporting formats EPS WMF XBitdumps TIFF SunRaster 77 Exporting images 74 75 76 file types 233 formats 233 Expression 233 Extract 3D slice 62 isosurfaces 58 Extracting data 79 Extracting data from 2D or 3D field plots 79 Extracting data points line points only 79 80 through volume 80 toafile 80 81 Eye distance 170 F FE boundary 56 FE surfaces 58 Field plots 81 choosing plot layers 84 contour attributes 99 scatter attributes 108 Field value setting 171 Field variable query 95 File open data set 161 open layout 140 save data set 201 save layout 169 File name prompt for 156 File names 80 81 File paths configuring 85 Fill colors 35 Finite element create FE surface zones 58 Finite element data zone boundary creation 56 First line of macro file 9 Fitting data to axis grid area 191 Flooded contour plots 232 FNAMEFILTER 85 Fonts 37 choosing 67 spacing 86 Formats in macro variables 249 Formatting numbers 215 FORTRAN like equations 24 Frame attach to data set command 33 invisible borders 126 view last 192 Frame control commands 87 90 Frame coordinates 232 Frame modes 179 327 Index Frame style setting 172 FRAMEHEADERFORMAT 102 FRAMEHEADERHEIGHT 102 Frames 34 88 create 59 delete active frame 87 edit 90 fit frames to paper 88 fit selected frames in view 197 f
142. ace This has no effect on the local view within any frame in your layout Required Parameters Parameters Syntax Default Notes x lt dexp gt 0 Value is in inches Y lt dexp gt 0 Value is in inches 198 Example Shift the workspace view to the left by 2 inches as measured by the workspace ruler WORKSPACEVIEW TRANSLATE X 2 Y 0 WORKSPACEVIEW UNMAXIMIZE Syntax WORKSPACEVIEW UNMAXIMIZE no parameters Description Returns the workspace to its normal size after it has been expanded after WORKSPACE MAXIMIZE has been used Example 1WORKSPACEVIEW UNMAXIMIZE WORKSPACEVIEW ZOOM Syntax WORKSPACEVIEW ZOOM X1 lt dexp gt Y1 lt dexp gt X2 lt dexp gt Y2 lt dexp gt no optional parameters Description Change the view into the work area This has no effect on the local view within any frame in your layout Required Parameters Parameters Syntax Notes X1 lt dexp gt Y1 lt dexp gt 199 Chapter 5 Macro Commands Parameters Syntax Notes X2 lt dexp gt Y2 lt dexp gt Example Syntax Description Example Syntax Description Make the region in the lower left corner of an 8 5 by 11 paper be viewable in the work area The paper is in portrait orientation WORKSPACEVIEW ZOOM X1 0 Yl 5 5 X2 4 25 Y2 9 75 WRITECOLORMAP WRITECOLORMAP lt str
143. ails Optional Parameter Parameter Syntax Default Notes DATATYPE lt datatype gt SINGLE Example Create a simple XY zone that has the XY pairs 1 0 2 1 3 7 and 5 9 CREATES IMPLEZONE RAWDATA 4 1 2 3 5 wo IF Oo CREATESLICEZONEFROMPLANE Syntax CREATESLICEZONEFROMPLANE optional parameters Description Create a new zone as a slice through existing 3 D volume zones Use GLOBALTHREED to define the slicing plane orientation 62 Optional Parameters Parameter Syntax Default Notes SLICESOURCE lt slicesource gt VOLUMEZONES FORCEEXTRACTIONTOSINGLE TRUE ZONE lt boolean gt Example Create a slice zone at X 0 GLOBALTHREED SLICE ORIGIN X 0 NORMAL X 1 Y 0 Z 0 CREATESLICEZONEFROMPLANE SLICESOURCE VOLUMEZONES CREATESLICEZONES Syntax CREATESLICEZONES no parameters Description Create a new zone for each slice defined on the Slice Details dialog Only Example creates slices from volume zones GLOBALSLICE POSITION1 X 6 IGLOBALCONTOUR VAR 4 GLOBALSLICE SHOW YES GLOBALSLICE POSITION2 X 1 GLOBALSLICE SHOWPOSITION2 YES GLOBALSLICE SHOWINTERMEDIATESLICES YES GLOBALSLICE NUMINTERMEDIATESLICES 6 I REDRAW 63 Chapter 5 Macro Commands Syntax CREATESLICEZONES CREATESTREAMZONES CREATESTREAMZONES optional parameters
144. alent to the results of using the probe tool in Tecplot Required Parameter Parameters Syntax Notes DESTINATIONZONE lt integer gt Zone to interpolate to Optional Parameters Parameters Syntax Default Notes SOURCEZONES lt set gt All zones except the destination zone VARLIST lt set gt All variables except Choose the variables to interpolate The spatial variables spatial variables X Y and Z if 3 D are not allowed Example Do linear interpolation from zones 2 3 and 4 onto zone 7 Interpolate only variables 3 7 LINEARINTERPOLATE SOURCEZONES 2 4 DESTINATIONZONE 7 VARLIST 3 7 131 Chapter 5 Macro Commands LINEMAP LINEMAP lt ser gt optional parameters Syntax Description A SetValue command that assigns attributes for individual Line mappings The lt set gt parameter immediately following the LINEMAP command is optional If lt set gt is omitted then the assignment is applied to all Line mappings otherwise the assignment is applied only to the Line mappings specified in lt set gt Optional Parameters Parameter Syntax Notes NAME lt string gt ASSIGN ZONE lt integer gt XAXISVAR lt op gt lt integer gt YAXISVAR lt op gt lt integer gt THETAAXISVAR lt op gt lt integer gt RAXISVAR lt op gt lt integer gt XAXIS lt op gt lt integer gt YAXIS lt op gt lt integer gt
145. ameter Example Duplicate variables 1 and 4 and the connectivity list The DupList parameter must be set to 1 4 FECONNECT char 0 11 7 Example Programs This section lists example programs written both in FORTRAN and C which demonstrate the TECIO utility functions These example programs can be found in the util tecio directory below the Tecplot Home Directory See the file readme in that directory for instructions on how to compile these examples The first two examples use the old style of TECIO functions and the last two use the new 100 style 11 7 1 Simple Example FORTRAN Simple example FORTRAN program to write a binary datafile for Tecplot This example does the following 1 Open a data file called t plt 2 Assign values for X Y and P 3 Write out a zone dimensioned 4x5 4 Close the data file NANAANAAAAAAAAA program test 299 Chapter 11 Writing Binary Data for Loading into Tecplot character 1 NULLCHR Integer 4 Debug III NPts NElm Dimension X 4 5 Y 4 5 P 4 5 Integer 4 TecIni TecDat TecZne TecNod TecFil Integer 4 VIsDouble NULLCHR CHAR 0 Debug t vIsDouble 0 IMax 4 JMax 5 KMax SL C C Open the file and write the Tecplot data file C header information Cc I TecIni SIMPLE DATASET NULLCHR amp X Y P NULLCHR amp t plt NULLCHR amp NULLCHR amp Debug amp VIsDouble Do 10 I 1 4 Do 10 J 1 5 X I J I Y I J J
146. ameter Syntax Default Notes PSIVAR lt integer gt PSI variable number REQUIRED if the transformation is spherical to rectangular or if CREATENEWVARIABLES is FALSE XVAR lt integer gt X variable number REQUIRED if the transformation is rectangular to polar or rectangular to spherical or CRE ATENEWVARIABLES is FALSE YVAR lt integer gt Y variable number REQUIRED if the transformation is rectangular to polar or rectangular to spherical or CRE ATENEWVARIABLES is FALSE ZVAR lt integer gt Z variable number REQUIRED if the transformation or rectangular to spherical or CREATENEWVARIABLES is FALSE ANGLESPEC lt anglespec gt RADIANS Specifies whether data is in degrees or radians ZONESET lt sef gt all zones Set if zones to operate on Example Transform data from rectangular coordinates to polar coordinates specifying angles in degrees and creating new variables TRANSFORMCOORDINATES TRANSFORMATION RECTTOPOLAR ANGLESPEC DEGREES CREATENEWVARIABLES XVAR 2 YVAR 3 Syntax TRIANGULATE optional parameters YES TRIANGULATE Description Create a new zone by forming triangles from data points in existing zones 185 Chapter 5 Macro Commands Optional Parameters Parameters Syntax Default Notes SOURCEZONES lt set gt All zones USEBOUNDARY lt boolean gt FALSE Specify one or more I o
147. anchor the text 0 Left 5 MidRight 1 Center 6 HeadLeft 2 Right 7 HeadCenter 3 MidLeft 8 HeadRight 4 MidCenter LineSpacing 296 Binary Data File Function Reference Pointer to double value specifying the text line spacing TextColor Pointer to integer value specifying the color to assign to the text See BoxColor Scope Pointer to integer value specifying the scope 0 Global 1 Local Text Character string representing text to display Must be null terminated MFC Macro function command Must be null terminated TECZNE Summary Writes header information about the next zone to be added to the data file After TECZNE is called you must call TECDAT one or more times and then call TECNOD if the data format is FEBLOCK or FEPOINT FORTRAN Syntax INTEGER FUNCTION TECZNE ZoneTitle L M N ZoneFormat DupList MP MP SM RH CHARACTER ZoneTitle INTEGER 4 L INTEGER 4 M INTEGER 4 N CHARACTER ZoneFormat CHARACTER DupList C Syntax include TECIO h long TECZNE char ZoneTitle 297 Chapter 11 Writing Binary Data for Loading into Tecplot INTEGER4 L INTEGER4 M INTEGER4 N char ZoneFormat char DupList Return Value o if successful 1 if unsuccessful Parameters ZoncTitle Title of the zone Must be null terminated L M N Pointers to integers specifying size of the zone If the data is ordered that is zone format is BLOCK or POINT then L is
148. and superscript characters relative to the font height BOLDFACTOR lt op gt lt double gt Thickness of bold characters relative to normal STROKEFONTLINETHICKNESS lt op gt lt double gt Thickness in frame units of lines used to draw stroke fonts Example Make superscript and subscript characters 1 3 the font height FONTADJUST SUBSUPFRACTION 0 333 FRAMECONTROL Required Control Option Description The different commands in the FRAMECONTROL compound function family are described separately in the following sections The FRAMECONTROL compound functions are FRAMECONTROL DELETETOP FRAMECONTROL FITALLTOPAPER FRAMECONTROL POP FRAMECONTROL POPATPOSITION FRAMECONTROL PUSHTOP FRAMECONTROL POPBYNAME FRAMECONTROL PUSHBYNAME FRAMECONTROL DELETETOP Syntax FRAMECONTROL DELETETOP no parameters 87 Chapter 5 Macro Commands Description Delete the top active frame If there is only one frame when this is called a new empty frame is automatically created after this command is executed Thus you can never have a workspace without at least one frame Example 1 FRAMECONTROL DELETETOP FRAMECONTROL FITALLTOPAPER Syntax FRAMECONTROL FITALLTOPAPER no parameters Description Resize all frames so that they fit inside the hardclip limits of the paper Example FRAMECONTROL FITALLTOPAPER FRAMECONTROL POP Syntax FRAMECONTROL POP optional parame
149. ar gt lt op gt lt dexp gt no parameters or VARSET lt macrovar gt lt string gt no parameters Description Assign a value to a macro variable If the macro variable did not exist prior to this command then it is defined here A macro variable can be assigned a value or a string Examples Example 1 Set the macro variable myvar to 3 VARSET myvar 3 Example 2 Add 2 to the macro variable myvar VARSET myvar 2 Example 3 Set the macro variable File1 tobe myfile plt VARSET Filel myfile plt Example 4 Set the macro variable F1 to equal V2 V3 where V2 and 187 Chapter 5 Macro Commands V3 are predefined variables VARSET V2 4 VARSET V3 5 VARSET F1 v2 v3 VIEW Required Control Option Description The different commands in the VIEW compound function family are described separately in the following sections The VIEW compound function family is VIEW AXISFIT VIEW AXISMAKECURRENTVALUESNICE VIEW AXISNICEFIT VIEW CENTER VIEW COPY VIEW DATAFIT S VIEW FIT VIEW LAST VIEW MAKECURRENTVIEWNICE VIEW NICEFIT VIEW PASTE VIEW PUSH VIEW RESETTOENTIRECIRCLE VIEW SETMAGNIFICATION VIEW TRANSLATE VIEW ZOOM VIEW AXISFIT Syntax VIEW AXISFIT optional parameters Description Reset the range on a specific axis so that it equals the minimum and maximum of the data being p
150. arameters Syntax Notes MESH MESHTYPE lt meshplottype gt Only operates on 2 or 3 D zone objects CONTOUR SHOW lt boolean gt Only operates on 2 or 3 D zone objects CONTOUR CONTOURTYPE lt contourplottype gt Only operates on 2 or 3 D zone objects VECTOR SHOW lt boolean gt Only operates on 2 or 3 D zone objects VECTOR VECTORTYPE lt vectorplottype gt Only operates on 2 or 3 D zone objects SCATTER SHOW lt boolean gt Only operates on 2 or 3 D zone objects SCATTER FILLMODE lt fillmode gt Only operates on 2 or 3 D zone objects SHADE SHOW lt boolean gt Only operates on 2 or 3 D zone objects SHADE SHADETYPE lt shadetype gt Only operates on 2 or 3 D zone objects BOUNDARY SHOW lt boolean gt Only operates on 2 or 3 D zone objects BOUNDARY SUBBOUNDARY lt subboundary gt Only operates on 2 or 3 D zone objects ERRORBARS SHOW lt boolean gt Only operates on XY line mapping objects ERRORBARS BARTYPE lt errorbartype gt Only operates on XY line mapping objects LINES SHOW lt boolean gt Only operates on XY line mapping objects BARCHARTS SHOW lt boolean gt Only operates on XY line mapping objects BARCHARTS ISFILLED lt boolean gt Only operates on XY line mapping objects SYMBOLS SHOW lt boolean gt Only operates on line mapping objects SYMBOLS ISFILLED lt boolean gt Only operates
151. ata Array of floating point values specifying the Z coordinate MFC Macro function command Must be null terminated TECINI Summary Initializes the process of writing a binary data file This must be called first before any other TECTO calls are made You may write to multiple files by calling TECINI more than once Each time TECINT is called a 290 Binary Data File Function Reference new file is opened Use TECFIL to switch between files FORTRAN Syntax INTEGER FUNCTION TECINI Title 2 PE MP KM Variables FName ScratchDir Debug VIsDouble CHARACTER Title CHARACTER Variables CHARACTER FName CHARACTER ScratchDir INTEGER 4 Debug INTEGER 4 VIsDouble C Syntax include TECIO h long TECINI char char char char Title Variables F Name ScratchDir INTEGER4 Debug INTEGER4 VIsDouble Return Value o if successful 1 if unsuccessful Parameters Title Title of the data set Must be null terminated Variables List of variable names If a comma appears in the string it will be used as the separator between variable names otherwise a space is used 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 291 Chapter 11 Writing Binary Data for Loading into Tecplot Pointer to the integer flag for debugging Set to
152. ata set with t p1t and the second data set with the two files a plt andb plt S OPENLAYOUT multiframe lay ALTDATALOADINSTRUCTIONS t plt a plt b plt 140 Syntax PAPER optional parameters PAPER Description A SetValue command that sets the paper characteristics Optional Parameters Parameter Syntax Notes BACKGROUNDCOLOR lt color gt ISTRANSPARENT lt boolean gt ORIENTPORTRAIT lt boolean gt SHOWGRID lt boolean gt SHOWPAPER lt boolean gt SHOWRULER lt boolean gt PAPERSIZE lt papersize gt RULERSPACING lt paperrulerspacing gt PAPERGRIDSPACING lt papergridspacing gt PAPERSIZEINFO LETTER lt lt papersize gt gt DOUBLE lt lt papersize gt gt A3 lt lt papersize gt gt A4 lt lt papersize gt gt CUSTOM1 lt lt papersize gt gt CUSTOM2 lt lt papersize gt gt REGIONINWORKAREA lt lt rect gt gt Specify rectangle that must fit within the workarea Units are in inches that is in the paper coordinate sys tem Example This example does the following e Turns off the paper grid e Makes the paper size CUSTOM1 e Makes the dimensions for CUSTOM1 to be 4 by 5 inches PAPER SHOWGRID NO 141 Chapter 5 Macro Commands PAPERSIZE CUSTOM1 PAPERSIZEINFO CUSTOM1 WIDTH Ul aN HEIGHT 5 PAUSE Syntax PAUSE lt string gt no parameters
153. ation on Preplot and its options Example Change the arguments used to Preplot ASCII files so only zones 1 2 and 3 are processed DATASETUP PREPLOTARGS zonelist 1 3 DEFAULTGEOM Syntax DEFAULTGEOM optional parameters Description A SetValue command that sets the attributes for the default geometry When a geometry is created interactively its color line thickness and so forth are preset based on the default geometry This command is usually used only in the Tecplot configuration file Optional Parameters Parameter Syntax Notes ANCHORPOS lt lt xyz gt gt POSITIONCOORDSYS lt coordsys gt SCOPE lt scope gt ZONE lt integer gt ATTACHTOZONE lt boolean gt 65 Chapter 5 Macro Commands Parameter Syntax Notes COLOR lt color gt FILLCOLOR lt color gt ISFILLED lt boolean gt LINEPATTERN lt linepattern gt PATTERNLENGTH lt op gt lt dexp gt LINETHICKNESS lt op gt lt dexp gt NUMELLIPSEPTS lt op gt lt integer gt ARROWHEADSTYLE lt arrowheadstyle gt ARROWHEADATTACHMENT lt arrowheadattachment gt ARROWHEADSIZE lt op gt lt dexp gt ARROWHEADANGLE lt op gt lt dexp gt MACROFUNCTIONCOMMAND lt string gt Set the macro command to execute when you hover over the geometry and press Ctrl right click Example Make the default geometry line thickness
154. ation origin 166 Reset rotation origin 166 Resetting 3D scale factors 166 axes 166 vector length 167 Resetting contour levels 53 54 Retaining macro function 5 RGB 222 rgb subcommand 222 Rotate 2D plot 167 3D plots 114 168 183 Rotate a 3D plot example 241 ROTATION details 125 Rotation reset rotation origin 166 Ruler 141 RULERPADDING 125 RULERTHICKNESS 125 RUNDISPLAYLISTSAFTERBUILDING 124 Running macro function 169 248 Running macros from the command line 5 from the Quick Macro Panel 6 from the tecplot interface 6 332 Tecplot 5 S Saving colo rmap 200 curve information 200 data set 201 layout 169 stylesheet 202 SCALE 125 Scale factors resetting 166 Scatter attributes 82 Scatter legend 103 108 Scatter plots 82 set global attributes 108 show 84 sizing by variable 103 108 Scatter symbol attributes 220 Scatter symbols 220 Scope of geometries 35 Scope of text 35 Scratch data type 64 SCRATCHDATAFIELDTYPE 65 SCRBACKGROUNDCOLOR 125 SCREENRENDERING 124 Select objects 142 Setting X Y positions 228 Setting X Y Z triplets 228 Setting attributes for the default geometry 65 reference scatter symbols 220 Setting basic colors 39 Setting character spacing and sizing for fonts 86 Setting color values 222 Setting I J or K indices 214 Setting index ranges 214 Setting miscellaneous parameters related to data 64 Setting number formats 215 Setting position border and background attributes
155. ax Default Notes DATATYPE lt datatype gt SINGLE Assign the precision given to the destination variable that is the variable on the left hand side of the equation This only applies if the equation creates a new variable see Example 2 location gt VALUELOCATION lt value AUTO Assign the location to destination variable Range The IRANGE JRANGE and KRANGE parameters are used to limit the data altered by the Parameters equation The specification of range indices follow these rules e All indices start with 1 and go to some maximum index m e The number 0 can be used to represent the maximum index m specifying 0 tells the command to go to the very last position of the range that is the maximum index value m If the maximum index m 15 specifying 0 sets the range index to 15 e Negative values represent the offset from the maximum index If a value of 2 is speci fied and the maximum index m is 14 the value used is 14 2 or 12 Examples Example 1 Example 2 Example 3 The following example adds one to X for all zones for every data point ALTERDATA EQUATION x x 1 The following example creates a new double precision variable called DIST ALTERDATA EQUATION DIST SQRT X 2 Y 2 DATATYPE DOUBLE The following equations set a variable called P to zero along the boundary of an IJ ordered zone ALTERDATA EQUATION P 0 IRANGE MAX 1 A
156. bal edit operation on the currently picked objects Only one edit operation is allowed per PICK EDIT command Objects are edited only if the supplied parameter is relevant Actions taken using the Quick Edit dialog in Tecplot generate these commands Parameters Must select one from this table Parameters Syntax Notes ARROWHEADANGLE lt dexp gt Angle is in degrees ARROWHEADSIZE lt dexp gt Value is in Y frame units 0 100 LINETHICKNESS lt dexp gt Value is in Y frame units 0 100 PATTERNLENGTH lt dexp gt Value is in Y frame units 0 100 SIZE lt dexp gt Value is in Y frame units This applies to things like symbols TEXTHEIGHTBYPERCENT lt dexp gt Value is in Y frame units 0 100 TEXTHEIGHTBYPOINTS lt dexp gt Value is in points ARROWHEADATTACHMENT lt arrowheadattachment gt ARROWHEADSTYLE lt arrowheadstyle gt FONT lt font gt GEOMSHAPE lt geomshape gt Applies only to scatter symbols or XY plot symbols LINEPATTERN lt linepattern gt OBJECTALIGN lt objectalign gt Only allowed if selected objects are all text and or geometries TEXTCOLOR lt color gt FILLCOLOR lt color gt COLOR lt color gt ASCIICHAR lt symbolchar gt MESH SHOW lt boolean gt Only operates on 2 or 3 D zone objects 147 Chapter 5 Macro Commands P
157. blanking at the end of animation for the I index Actual I index is equal to IMINFRACT IMAX JMINFRACT2 lt dexp gt 0 8 Minimum fraction for blanking at the end of animation for the J index Actual J index is equal to JMINFRACT JMAX KMINFRACT2 lt dexp gt 0 8 Minimum fraction for blanking at the end of animation for the K index Actual K index is equal to KMINFRACT KMAX IMAXFRACT2 lt dexp gt 1 0 Maximum fraction for blanking at the end of animation for the I index Actual I index is equal to IMAXFRACT IMAX JMAXFRACT2 lt dexp gt 1 0 Maximum fraction for blanking at the end of animation for the J index Actual J index is equal to JMAXFRACT JMAX KMAXFRACT2 lt dexp gt 1 0 Maximum fraction for blanking at the end of animation for the K index Actual K index is equal to KMAXFRACT KMAX CREATEMOVIEFILE lt boolean gt FALSE If TRUE must be preceded by EXPORTSETUP commands Example The following example produces an animation showing a band of I g pte p g planes traversing the entire data field ANIMATEIJKBLANKING NUMSTEPS 6 IMINFRACT 0 1 JMINFRACT 0 0 KMINFRACT 0 0 IMAXFRACT 1 0 JMAXFRACT 1 0 KMAXFRACT 1 0 IMINFRACT2 1 0 JMINFRACT2 0 0 KMINFRACT2 0 0 IMAXFRACT2 1 0 JMAXFRACT2 1 0 KMAXFRACT2 1 0 ANIMATEIJKPLANES Syntax ANIMATEIJKPLANES START lt integer gt END lt integer gt optional parameters Descrip
158. boolean gt Only available for 3D frame mode 206 Example Turn on the grid area border for a 2 D plot and change the line thickness to be 2 percent TWODAXIS AREASTYLE DRAWBORDER YES LINETHICKNESS 2 lt lt axisdetail gt gt Description Assign attributes for axes Expands to Syntax Notes SHOWAXIS lt boolean gt AUTOGRID lt boolean gt ISREVERSED lt boolean gt GRANCHOR lt double gt GRSPACING lt double gt RANGEMIN lt double gt RANGEMAX lt double gt COORDSCALE lt coordscale gt CLIPDATA lt boolean gt VALUEATORIGIN lt double gt VARNUM lt integer gt TICKLABEL lt lt ticklabeldetail gt gt GRIDLINES lt lt gridlinedetails gt gt MINORGRIDLINES lt lt gridlinedetails gt gt TICKS lt lt tickmarkdetail gt gt TITLE lt lt axistitle gt gt AXISLINE lt lt axisline gt gt Example Turn on the axis line reverse the axis direction and set the range to go from 0 5 to 1 5 for the X axis in a 2 D plot TWODAXIS SHOWAXISLINE TRUE XDETAIL 207 Chapter 6 Parameter Subcommands ISREVERSED TRUE RANGEMIN 0 5 RANGEMAX 1 5 lt lt axisline gt gt Description Assign attributes for axis lines Expands to Syntax Notes SHOW lt boolean gt SHOWBOTHDIRECTIONS lt boolean gt Non 3D only Default FALSE SHOWPERPENDICULAR lt boolean gt Non 3D only Default
159. centimeters magnitude HEADSIZEASFRACTION lt op gt lt dexp gt Head is sized as a fraction of stem length HEADSIZEINFRAMEUNITS lt op gt lt dexp gt Value is in Y frame units SIZEHEADBYFRACTION lt boolean gt If TRUE HEADSIZEASFRACTION is used to size arrowheads other HEADSIZEINFRAMEUNITS is used ARROWHEADANGLE lt op gt lt dexp gt Angle is in degrees UVAR lt op gt lt integer gt Variable number for the X vector component VVAR lt op gt lt integer gt Variable number for the Y vector component REFVECTOR SHOW COLOR MAGNITUDE LINETHICKNESS ANGLE XYPOS MAGNITUDELABEL SHOW TEXTCOLOR TEXTSHAPE NUMFORMAT OFFSET lt boolean gt lt color gt lt op gt lt dexp gt lt op gt lt dexp gt lt op gt lt dexp gt lt lt xy gt gt lt boolean gt lt color gt lt lt textshape gt gt lt lt numberformat gt gt lt double gt Example This example does the following Doubles the vector length assume vectors currently drawn using relative length Make the vector heads uniform in size 2 percent in frame units Make the head angle 15 degrees GLOBALTWODVECTOR 118 Syntax RELATIVELENGTH 2 SIZEHEADBYFRACTION NO HEADSIZEINFRAMEUNITS 2 HEADANGLE 215 IF ENDIF IF lt conditionalexp gt ENDIF Description Conditionally process macro commands Exampl
160. connects to pri mary browser For security reasons this command can only be used in the Tecplot con figuration file USEAPPROXIMATEPLOTS lt boolean gt Set to TRUE to use approximate plots This will speed up any interac tive rotations and translations and many other actions as well USEDISPLAYLISTS lt boolean gt USEDOUBLEBUFFERING lt boolean gt USEDOUBLEFORDISPLAYLISTS lt boolean gt USEFASTAPPROXCONTINUOUSFLOOD lt boolean gt USEINITIALPLOTDIALOG lt boolean gt Default is On USESTROKEFONTSFOR3DTEXT lt boolean gt Use stroke fonts for data labels and ASCII scatter symbols in 3 D plots 126 Parameter Syntax Notes USESTROKEFONTSONSCREEN lt boolean gt Set to TRUE to use Tecplot s internal stroke fonts set to FALSE to use true type fonts This option is only avail able under Windows USETECPLOTPRINTDRIVERS lt boolean gt This applies to Windows only Set to TRUE to use Tecplot s printer driv ers Set to FALSE to use Windows printer drivers XORCOLOR lt op gt lt integer gt Color index to use for XORed lines Set to 0 to make Tecplot calculate ZONEMAPNAMECOLUMNWIDTH lt double gt Range is 10 1000 Sets the width of the Zone Map Name column under Plot Attributes CONSERVEDERIVEDVARIABLESPACE lt boolean gt Example This example does the following Makes the frame borders show on the screen when they
161. cro Commands Optional Parameters Parameter Syntax Notes MESH SHOW lt boolean gt MESHTYPE lt meshplottype gt COLOR lt color gt LINEPATTERN lt linepattern gt PATTERNLENGTH lt op gt lt dexp gt LINETHICKNESS lt op gt lt dexp gt CONTOUR SHOW lt boolean gt CONTOURTYPE lt meshplottype gt COLOR lt color gt LINEPATTERN lt linepattern gt PATTERNLENGTH lt op gt lt dexp gt LINETHICKNESS lt op gt lt dexp gt USELIGHTINGEFFECT lt boolean gt FLOODCOLORING lt contourcoloring_e gt LINECONTOURGROUP lt sminteger_t gt 2 VECTOR SHOW lt boolean gt VECTORTYPE lt vectorplottype gt ARROWHEADSTYLE lt arrowheadstyle gt COLOR lt color gt ISTANGENT lt boolean gt LINEPATTERN lt linepattern gt PATTERNLENGTH lt dexp gt LINETHICKNESS lt dexp gt SCATTER SHOW lt boolean gt COLOR lt color gt FILLMODE lt fillmode gt FILLCOLOR lt color gt SIZEBYVARIABLE lt boolean gt Scatter sizing variable must be defined before this can be set to TRUE See the GLO BALSCATTER command FRAMESIZE lt op gt lt dexp gt Size of symbols when SIZEBYVARIABLE LINETHICKNESS lt op gt lt dexp gt is FALSE SYMBOLSHAPE lt lt symbolshape gt gt 82 Parameter Syntax Notes POINTS IJKSKIP lt lt ijk gt gt POINTSTOPLOT lt pointstoplot gt Limits the number of vectors or scatter sym bols d
162. ctor component for the currently active zones MINX Minimum value for variable assigned to the X axis For 2D or 3D Cartesian plots the value is calculated from the current set of active zones For line plots the value is calculated from the zone assigned to the lowest numbered active line mapping MINY Minimum value for variable assigned to the Y axis For 2D or 3D Cartesian plots the value is calculated from the current set of active zones For line plots the value is calculated from the zone assigned to the lowest numbered active line mapping MINZ Minimum value for variable assigned to the Z axis for the currently active zones NUMFRAMES Number of frames 244 System Environment Variables Variables Notes NUMLINEMAPS Number of line maps assigned to the current frame NUMPLANES Returns number of graphics bit planes NUMVARS Number of variables in current data set NUMZONES Number of zones in current data set OPSYS Returns 1 UNIX 2 DOS PAPERHEIGHT Returns height of paper that is the white area of the Tecplot work area PAPERSIZE Returns size of paper PAPERWIDTH Returns the width of the paper PLATFORM Returns name of platform such as SGI or Windows PLOTTYPE Zero Sketch one XY two 2D three 3D four Polar line plots PRINTFNAME Returns the file name o
163. d 4 to the bottom SHIFTLINEMAPSTOBOTTOM 2 4 174 Syntax Description Example Syntax Description Example Syntax CO SISATETLINEMAPSTOTOP SHIFTLINEMAPSTOTOP lt sef gt no parameters Shift a list of Line maps to the top of the Line map list This in effect causes the selected Line maps to be drawn first Shift Line maps 2 and 4 to the top SHIFTLINEMAPSTOTOP 2 4 SO SISHOWMOUSEPOINTER SHOWMOUSEPOINTER lt boolean gt optional parameters The mouse icon may be deactived within a macro to enhance the on screen animation It must be reactivated before exiting the macro SHOWMOUSEPOINTER NO LOOP 36 ROTATE3DVIEW X ANGLE 5 I REDRAW ENDLOOP SHOWMOUSEPOINTER YES SKETCHAXIS SKETCHAXIS optional parameters 175 Chapter 5 Macro Commands Description A SetValue command that assigns attributes for axes in a sketch mode frame Axes are rarely used in sketch frames Optional Parameters Parameter Syntax Notes DEPXTOYRATIO lt op gt lt dexp gt AXISMODE must be XYDEPENDENT to use this AXISMODE lt axismode gt Set to INDEPENDENT or XYDEPENDENT GRIDAREASTYLE lt lt gridarea gt gt XDETAIL lt lt axisdetail gt gt YDETAIL lt lt axisdetail gt gt PRECISEGRID lt lt precisegrid gt gt VIEWPORTTOPSNAPTAR lt integer gt Default 100 GET VIEWPORTTOPSNAPTOL lt integer gt D
164. defined using the COLORMAP command COLORMAP REVERSECOLORMAP lt boolean gt FILTER allows each frame to make adjust COLORMAPCYCLES lt op gt lt integer gt ments to the global color map that will only COLORMAPOVERRIDEACTIVE lt boolean gt apply to the current frame COLORMAPOVERRIDE lt integer gt Use lt integer gt to choose which override to lt lt colormapoverride gt gt operate on ZEBRA lt lt zebrashade gt gt COLORMAPDISTRIBUTION lt colormapdistribution gt CONTINUOUSCOLOR lt lt continuouscolor gt gt USEFASTSPPROXCONTINU lt boolean gt Default FALSE OUSFLOOD DEFNUMLEVELS lt integer gt Sets the target number of contour levels for situations where contour levels are auto matically reset Tecplot will attempt to cre ate levels where the start end and increment values are all clipped floating point values Example This example does the following Turns on the contour legend Sets the flood cutoff to go from 3 to 5 Reverses the color map Inserts a color map override of yellow between contour level number 7 and level number 9 101 Chapter 5 Macro Commands INCLUDEMIN TRUE INCLUDEMAX TRUE COLORMAPFILTER REVERSECOLORMAP TRUE COLORMAPOVERRIDEACTIVE TRUE COLORMAPOVERRIDE 1 INCLUDE YES COLOR YELLOW STARTLEVEL 7 ENDLEVEL 9 GLOBALFRAME Syntax GLOBALFRAME optional parameters Description A SetValue command that sets attributes which
165. delabeltype gt INDEXSKIP lt op gt lt integer gt DISTANCESKIP lt op gt lt dexp gt SKIPMODE lt skipmode gt TEXTSHAPE lt lt textshape gt gt Not allowed to change size units parameter NUMFORMAT lt lt numberformat gt gt COLORBY ZONEMAP lt boolean gt LEGEND Attributes for an optional legend added to an Line plot Entries in the legend are determined dynamically by Tec SHOW lt boolean gt plot depending on which mappings are turned on SHOWTEXT lt boolean gt TEXTCOLOR lt color gt ROWSPACING lt op gt lt dexp gt TEXTSHAPE lt lt textshape gt gt Not allowed to change size units BOX lt lt textbox gt gt XYPOS lt lt xy gt gt ANCHORALIGNMENT lt anchoralignment gt Example Turn on the data labels and show the Line legend Use the TIMESBOLD font in the legend GLOBALLINEPLOT DATALABELS SHOWNODELABELS LEGEND SHOW YES TEXTSHAPE FONT TIMESBOLD YES 105 Chapter 5 Macro Commands Syntax GLOBALPOLAR GLOBALPOLAR optional parameters Description Allows polar plots to have curved lines that are interpolated along the R Axis between data points Optional Parameters Parameter Syntax Notes DRAWSTRAIGHTLINES lt boolean gt Default TRUE Alternates between straight and curved interpolated lines for polar plots ANGLE lt float gt Default 1 0 Determines the angle for which lines will be approximat
166. ds A Tecplot macro is a file containing one or more macro commands These files start with the following special comment line to notify Tecplot that what follows is a Tecplot Version 10 macro MC 1000 Any number of macro commands or comments may follow Tecplot macro functions are defined are defined in Tecplot macros by using the MACRO FUNCTION ENDMACROFUNCTION commands Between the MACROFUNCTION and ENDMACROFUNCTION commands you may use any valid macro command except MACROFUNCTION When a Tecplot macro is loaded all macro functions are extracted and the attached commands are not executed until a RUNMACROFUNCTION command is encountered see Section 8 7 Macro Function Variables for examples Macro functions may be retained if desired A retained macro function remains defined in Tecplot even if the macro in which it was defined is replaced by another macro Retained macro functions may be called by other macros that are loaded at a later time 2 2 Running Macros from the Command Line A simple way to run a Tecplot macro is to include it in the command line with the p flag The following command runs Tecplot and plays a macro called a mcr Chapter 2 Managing Macros tecplot p a mcr If you use the mer extension for the macro file name then the p flag is optional If you want to debug the macro include the z flag as well 2 3 Running Macros from the Tecplot Interface You can run a
167. e 1 Process macro commands if the macro variable myvar is less than 73 2 IF myvar lt 73 2 ENDIF Example 2 Process macro commands if the macro variable response is YES Syntax IF response YES ENDIF INCLUDEMACRO INCLUDEMACRO lt string gt Description Insert the commands from another macro file Because the Example INCLUDEMACRO command is processed when the macro is loaded and not when the macro is executed you are not allowed to reference macro variables within the lt string gt parameter Include the macro file m2 mer INCLUDEMACRO m2 mcr 119 Chapter 5 Macro Commands INTERFACE Syntax INTERFACE optional parameters Description A SetValue command that sets attributes related to the Tecplot interface Optional Parameters Parameter Syntax Notes ALLOWDATAPOINTSELECT lt boolean gt If TRUE Tecplot allows you to use the Adjustor tool to select and move data points APPROXIMATIONMODE lt boolean gt If TRUE Tecplot allows you to use the Adjustor tool to select and move data points AUTOREDRAWISACTIVE lt boolean gt Set to FALSE to turn Auto Redraw off BACKINGSTOREMODE lt backingstoremode gt BEEPONFRAMEINTERRUPT lt boolean gt CACHELIGHTDISPLAYLISTSONLY lt boolean gt When caching graphics in display lists only cache those objects which uses little memory When this is on only approx
168. e string my ile p1t to the variable FNAME Use FNAME in the READDATASET command VARSET FNAME myfile plt READDATASET FNAME Note that double quotes had to be used in the READDATASET command even though FNAME represents a string 8 6 Replacement Text Use You can assign replacement text to a macro variable This is useful for handling cases where a macro variable may be not be initialized A macro variable with AAAA XXXXX will produce XXXXX if AAAA is not defined This does not work with intrinsic variables Example Read in a data file assingned to the variable FNAME If FNAME is unassigned readin t dat READDATASET FNAME t dat FNAME t dat 247 Chapter 8 Macro Variables 8 7 Macro Function Variables Macro function variables are written using a number n surrounded by vertical bars The number represents the nth parameter from the RUNMACROFUNCTION command Examples Example 1 Example 2 The following commands define a macro function that uses two parameters and a command to run the macro function The first parameter to the macro function is the amount to rotate about the X axis and the second parameter is the amount to rotate about the Y axis The command to run the macro function will cause a rotation of 10 degrees about the X axis and 20 degrees about the Y axis MC 1000 MACROFUNCTIONNAME 3D Rotation Animation EXPOR
169. e variables between zones GSV SHIFTLINEMAPSTOBOTTOM Shift Line mappings to the bottom making Action them draw later SHIFTLINEMAPSTOTOP Shift Line mappings to the top making them Action draw earlier SHOWMOUSEPOINTER Activate mouse icon within a macro Action SKETCHAXIS Change sketch axis settings FSV SMOOTH Smooth data Action STREAMTRACE Add or delete streamtraces Define the termi Action nation line SYSTEM Execute an operating system command Action THREEDAXIS Change 3 D axis settings FSV THREEDVIEW A SetValue command that changes global FSV attributes associated with the 3 D view TRANSFORMCOORDINATES Transform coordinates from one plot style to FSV another TRIANGULATE Create a new zone by triangulating data from Action existing zones TWODAXIS Change 2 D axis settings FSV VARSET Assign a value to a user defined macro vari Control able S IVIEW Change the view in the current frame Action WHILE Begin a WHILE loop in a macro Control WORKSPACEVIEW Change the view of the frames in the work Action space WRITECOLORMAP Write the current color map to a file Action WRITECURVEINFO Write coefficients or data points for curve fits Action in XY plots to a file WRITEDATASET Write the data set for the current frame to a Action file WRITESTYLESHEET Write a stylesheet for the current frame to a Action file XYLINEAXIS Change XY plot axis settings FSV
170. ean gt Used for TIFF BMP and PNG formats ANIMATIONSPEED lt double gt Applies to AVI only Sets the animation speed in frames per second USEMULTIPLECOLORTABLES lt boolean gt Applies to AVI and Raster Metafile only TIFFBYTEORDER lt tiffbyteorder gt QUALITY lt integer gt Range is from 1 100 JPEGENCODING STANDARD or PROGRESSIVE USESUPERSAMPLEAN lt boolean gt Default FALSE TIALIASING SUPERSAMPLEFACTOR lt integer gt Default 3 This is the factor used in anti aliasing while reducing the size of an exported image A larger size can improve the quality of the image but slows perfor mance PRINTRENDERTYPE lt printrendertype gt Default PRINTRENDERTYPE_ VECTOR RESIZEFILTER lt resizefilter gt Default CUBICFILTER TEXTURE FILTER and BOXFILTER not allowed Example Set up Tecplot to export a Raster Metafile image to the file movie rm EXPORTSETUP EXPORTFNAME movie rm EXPORTFORMAT RASTERMETAFILE 78 Syntax EXPORTSTART EXPORTSTART no parameters Description Signals the start of an animation sequence and records the first frame of Example Syntax the animation This command is only valid for animation formats AVI and Raster Metafile EXPORTSETUP EXPORTFNAMES rotate avi EXPORTFORMAT AVI EXPORTSTART LOOP 5 ROTATE3DVIEW X ANGLE 5 EXPORTNEXTFRAME ENDLOOP EXPORTFINISH EXTRACTFROMGEOM EXTRACTFROMGEOM optional para
171. ed as curves Example This example turns on curved lines and defines the maximum angle to be Example Syntax Description approximated as a curved line to be 2 0 degrees GLOBALPOLAR DRAWSTRAIGHTLINES FALSE ANGLE 2 0 GLOBALRGB GLOBALRGB RGBMode lt RGBMode gt optional parameters Allows RGB coloring for plots which have RGB values specified at each vertex This coloring option is valuable for plots with entities such as Gas Oil and Water RGB Coloring can be assigned to field plot objects such as zones iso surfaces and slices 106 Required Parameter Parameter Syntax Notes RGBMODE SpecifyRGB Sets whether the user specifies all three color variables SpecifyRG for RGB Coloring or if Tecplot calculates one variable SpecifyRB while the user specifies two SpecifyGB O ptional Parameters Parameter Syntax Notes REDCHANNELVAR lt integer gt Sets variable for the red channel GREENCHANNELVAR lt integer gt Sets variable for the green channel BLUECHANNELVAR lt integer gt Sets variable for the blue channel RANGEMIN lt double gt Default 0 0 RANGEMAX lt double gt Default 1 0 LEGEND SHOW lt boolean gt SHOWLABELS lt boolean gt TEXTCOLOR lt color gt HEIGHT lt double gt XYPOS lt lt xy gt gt TEXTSHAPE lt lt textshape gt gt BOX lt lt textbox gt gt AHCHOR lt anchoralighnment gt USEREDVAR
172. efault 10 ERANCE PRESERVEAXISSCALE lt boolean gt WHENRANGEISCHANGED AUTOADJUSTRANGES lt boolean gt TONICEVALEUS VIEWPORTPOSITION lt lt rect gt gt VIEWPORTNICEFIT lt double gt BUFFER Example Change the axis mode to be INDEPENDENT for sketch mode in the current frame SKETCHAXIS AXISMODE INDEPENDENT Syntax SMOOTH ZONE lt set gt VAR lt set gt optional parameters SMOOTH 176 Description Smooth data reduce the spikes for selected variables in selected zones Required Parameters Parameter Syntax Notes ZONE lt sef gt Zones to smooth VAR lt set gt Variables to smooth These cannot be X or Y if in 2 D or Z if in 3 D and they must be a dependent variable in XY plots Optional Parameters Parameter Syntax Default Notes NUMSMOOTHPASSES lt integer gt 1 SMOOTHWEIGHT lt dexp gt 0 8 SMOOTHBNDRYCOND FIXED lt boundarycondition gt Example Smooth variables 3 and 4 in zone 2 SMOOTH ZONE 2 VAR 3 4 STREAMTRACE Required Control Option Description The different commands in the STREAMTRACE compound function family are described separately in the following sections The STREAMTRACE compound function family is STREAMTRACE ADD STREAMTRACE DELETALL STREAMTRACE DELETERANGE STREAMTRACE RESETDELTATIME STREAMTRACE SETTERMINATIONLINE 177 Cha
173. efined elsewhere will not See the MACROFUNCTION command in Chapter 5 Macro Commands for more information If you want Tecplot to display the Quick Macro Panel at starting include the showpanel flag on the command line To see an example of a macro function file look at the file tecplot mcr located in the examples mcr sub directory below the Tecplot home directory If this file is moved to the 2 4 Running Macros from the Quick Macro Panel Tecplot home directory the Quick Macro Panel will have options that include 3D Rotation Animation and Reset Center of Rotation Chapter 2 Managing Macros cHaPTER3 Macro Command Syntax A macro file consists of one or more macro commands Comments may be inserted any where in the file except within a character string Comments start with an octothorp and extend to the end of the line The first line of a macro file contains a special comment that identifies the version number of the macro file For Tecplot Version 10 this line is MC 1000 A Tecplot Version 10 macro file has the form MC 1000 lt macrocommand gt lt macrocommand gt Chapter 3 Macro Command Syntax Each macrocommand in turn has the form commandname commandspecificmodifiers mandatoryparameters optionalparameters where commandspecificmodifiers These are optional command specific modifiers An exam ple of a command that uses this is the FIE
174. eger gt CUSTOM7 PEN lt integer gt CUSTOM8 PEN lt integer gt AXISPEN lt integer gt MAJGRIDLINEPEN lt integer gt MINGRIDLINEPEN lt integer gt STREAMLINEPEN lt integer gt MULTICOLORLINEPEN lt integer gt BOUNDARYPEN lt integer gt LABELPEN lt integer gt Example Make the drawing of all axes use pen 3 PRINTSETUP PLOTTERPENMAP AXISPEN 3 Description Change settings for the precise dot grid lt lt precisegrid gt gt 218 Expands to Syntax Notes INCLUDE lt boolean gt COLOR lt color gt SIZE lt double gt Size is in centimeters Example Turn on the precise dot grid in an XY plot XYAXIS PRECISEGRID INCLUDE YES lt lt rect gt gt Description Change settings for a rectangle The rectangle is defined using two points X1 Y1 and X2 Y2 Expands to Syntax Notes Units are based on the parent command X1 lt op gt lt dexp gt Y1 lt op gt lt dexp gt X2 lt op gt lt dexp gt Y2 lt op gt lt dexp gt Example Set the 2 D axis grid area to be positioned 10 percent from all edges of the frame TWODAXIS AREASTYLE EXTENTS X1 10 219 Chapter 6 Parameter Subcommands Y1 10 X2 90 Y2 90 lt lt refscatsymbol gt gt Description Set the attributes for the reference scatter symbol Expands to Syntax Notes SHOW
175. element data files 4 Write out an ordered zone dimensioned 4 x 5 to field plt 5 Assign values for XL and YL arrays 6 Write out data for line plot to line plt Make the data use double precision 7 Write out a finite element zone to field plt 8 Write out a text record to field plt 9 Write out a geometry circle record to field plt 10 Close file 1 11 Close file 2 include lt stdio h gt include lt math h gt include TECIO h main float X 5 4 Y 5 4 P 5 4 double XL 50 YL 50 INTEGER4 Debug 1I J K L III NPts NElm DIsDouble VIsDouble INTEGER4 IMax JMax KMax INTEGER4 ICellMax JCellMax KCellMax ZoneType Clipping INTEGER4 IsBlock NumFaceConnections INTEGER4 FaceNeighborMode ShareConnectivityFromZone INTEGER4 NM 12 4 double XP YP ZP FH LineSpacing PatternLength double BoxMargin BoxLineThickness TextAngle INTEGER4 AttachToZone Zone Scope PositionCoordSys INTEGER4 FontType HeightUnits INTEGER4 IsFilled GeomType LinePattern NumEllipsePts INTEGER4 Anchor BoxType BoxColor BoxFillColor INTEGER4 TextColor Color FillColor INTEGER4 ArrowheadStyle ArrowheadAttachment 310 Example Programs INTEGER4 NumSegments NumSegPts 1 double LineThickness ArrowheadSize ArrowheadAngle float XGeomData 1 YGeomData 1 ZGeomData l1 Debug 2 VIsDouble 0 DIsDouble 0 Open order plt and write the header i
176. ellaneous global frame settings GSV GLOBALISOSURFACE Change global attributes associated with iso FSV surfaces GLOBALLINEPLOT Change global Line plot settings FSV GLOBALPOLAR Change global settings of polar plots FSV GLOBALRGB Change Global RGB coloring FSV GLOBALSCATTER Change global scatter settings FSV 16 Command Description Type GLOBALSLICE Change global attributes associated with FSV slices GLOBALSTREAM Change global streamtrace settings FSV GLOBALTHREED Change global 3 D settings FSV GLOBALTHREEDVECTOR Change global 3 D vector settings FSV GLOBALTWODVECTOR Change global 2 D vector settings FSV IF Conditionally execute macro commands Control INCLUDEMACRO Include macro commands from another file Control INTERFACE Change interface settings GSV INVERSEDISTINTERPOLATE Interpolate data using the inverse distance Action algorithm KRIG Interpolate data using kriging Action LAUNCHDIALOG Launch a dialog see DROPDIALOG Action LIMITS Change limits for lines text length and con GSV tour levels LINEARINTERPOLATE Interpolate data using linear interpolation Action LINEMAP Change plot style settings for Line maps FSV LINEPLOTLAYERS Turn Line plot layers and features on or off FSV LINKING Link attributes in two or more frames so that FS
177. epresents the maximum K value for the zone assigned to the lowest numbered active line mapping For finite element data this shows the number of nodes per element for the lowest numbered active zone MAXR Maximum value of the R variable for polar line plots calculated from the lowest numbered active polar line plot MAXS Maximum value for scatter sizing variable for the currently active zones MAXU Maximum value for variable assigned to the X vector component for the currently active zones MAXV Maximum value for variable assigned to the Y vector component for the currently active zones MAXvVnn Maximum value of variable nn MAXVAR Returns the maximum values of the specified variable It is indexed by array notation meaning that a call of IMAXVAR 2 l gives the maximum value of the second variable MAXW Maximum value for variable assigned to the Z vector component for the currently active zones 243 Chapter 8 Macro Variables Variables Notes MAXX Maximum value for variable assigned to the X axis If the plot is 2D or 3D Cartesian the value is calculated from the current set of active zones For line plots the value is calculated from the zone assigned to the lowest numbered active line mapping MAXY Maximum value for variable assigned to the Y axis For 2D or 3D Cartesian plots the value is calculated from the current set
178. er MACROFILEPATH Path to the directory containing the most recently opened macro file MAXA Maximum value for Angle variable for polar line plots calculated from the lowest numbered active polar line mapping MAXB Maximum value for blanking variable If the plot is 2D or 3D Carte sian the value is calculated from the current set of active zones For line plots the value is calculated from the zone assigned to the lowest numbered active line mapping MAXC Maximum value for contour variable If the plot is 2D or 3D Carte sian the value is calculated from the current set of active zones For line plots the value is calculated from the zone assigned to the lowest numbered active line mapping MAXI I dimension for the lowest numbered active zone for 2D or 3D Carte sian plots For line plots this represents the maximum I value for the zone assigned to the lowest numbered active line mapping For finite element data this represents the number of the nodes in the lowest order zones MAXI J dimension for the lowest numbered active zone for 2D and 3D Car tesian plots For line plots this represents the maximum J value for the zone assigned to the lowest numbered active line mapping For finite element data the number of elements in the lowest numbered active zone MAXK K dimension for the lowest numbered active zone for 2D and 3D Cartesian plots For line plots this r
179. er details secondary or common macro parameter subcommands in Tecplot These subcommands provide a means to access the lower level variables of commands defined in the previous chapter of this manual Each subcommand can expand to contain one or more parameters or subcommands All parameters within a subcommand are optional Items within single angle brackets lt gt are defined in Chapter 7 Parameter Assignment Values Expressions and Arithmetic and Logical Operators lt lt anchorpos gt gt Description Assign attributes forpositioning of objects 205 Chapter 6 Parameter Subcommands Expands to Syntax Notes x lt double gt Sets X value and THETA value Y lt double gt Sets Y value and R value Z lt double gt Sets Z value THETA lt double gt Sets THETA value and X value R lt double gt Sets R value and Y value Example Make a square geometry and place it at a certain XY location ATTACHGEOM GEOMTYPE SQUARE POSITIONCOORDSYS FRAME ANCHORPOS X 2 89124668435 Y 88 7359084881 RAWDATA 5 23430593312 lt lt areastyle gt gt Description Change settings for the axis grid area Expands to Syntax Notes DRAWGRIDLAST lt boolean gt Not available in 3D frame mode DRAWBORDER lt boolean gt LINETHICKNESS lt op gt lt dexp gt COLOR lt color gt ISFILLED lt boolean gt FILLCOLOR lt color gt USELIGHTSOURCETOFILL lt
180. et of aliases for a given variable VARPOSITIONLIST lt set gt All vars Use this to reduce the number of variables loaded 161 Chapter 5 Macro Commands lt readdataoption gt Parameters Syntax Default Notes ZONELIST lt sef gt All zones Use this to reduce the number of zones loaded READDATAOPTION NEW Set to APPEND to append the new zones to the zones in the data set that existed prior to using this command Set to NEW to remove the data set from the current frame prior to reading in the new data set If other frames use the same data set they will continue to use the old one Set to REPLACE to replace the data set attached to the current frame and to all other frames that use the same data set with the new data set lt boolean gt COLLAPSEZONESANDVARS FALSE Renumber zones and variables if zones or variables are disabled Examples Example 1 Example 2 Example 3 Example 4 Read in the data files t1 p1t and t2 pl1t to form a single data set in Tecplot READDATASET tl plt t2 plt Read in the datafile t1 p1t Only read in zones 1 and 4 Skip over every other I index READDATASET tl plt ZONELIST 1 4 IJKSKIP I 2 Read in the data files tl plt t2 pl1t and t3 pl1t Append the new data set to the current one READDATASET tl plt t2 plt t3 plt READDATAOPTION APPEND Read in the data files t1 p1t and t2 pl1t from d
181. f the last file sent for printing SLICEPLANETYPE Plane type to which slices are assigned STARTSLICEPOS Position of first slice STREAMSTARTPOS Streamtrace starting position in X Y Z coordinates given in the form of 0 5 3 2 5 6 STREAMTYPE The streamtrace type such as Surface Line or Surface Ribbon TECHOME Path to the Tecplot home directory TECPLOTVERSION Currently returns 100 TIME Returns the current time in the form of 12 15 28 VARNAME Returns the name of a specified variable This command uses array notation so VARNAME 3 I will return the name of the third vari able ZONEMESHCOLOR Returns the color of a particular zone mesh Uses array notation ZONENAME Returns the name of a specific zone Uses array notation 8 2 System Environment Variables System environment variables can be accessed directly from within Tecplot by preceding an environment variable name with a and surrounding it with vertical bars Using environment variables within Tecplot adds another degree of flexibility to macros by taking advantage of each user s customized environment 245 Chapter 8 Macro Variables If an environment variable is missing an error is generated and macro processing is termi nated 8 2 1 Example 1 To compare a macro variable with an environment variable IF SESSION COEFF DEFAULT COEFF perform some default processing here ENDIF W
182. format Windows Example This example filters all four extensions when opening a layout file FILECONFIG FNAMEFILTER INPUTLAYOUTFILE wsf dwr lay 1lpk Windows Example This example filters both extensions when writing a layout file The default extension is ws because it is the first extension presented in the list FILECONFIG FNAMEFILTER OUPUTLAYOUTFILE wsf lay Motif Example This example filters aek p1t and more FILECONFIG FNAMEFILTER INPUTDATAFILE ae el kt Motif Example This example filters dat cam and more The default extension is dat because D and T are the first letters presented within the brackets FILECONFIG FNAMEFILTER OUTPUTASCIIDATAFILE dc a tm Example Set the directory where Tecplot stores temporary files to be usr tmp FILECONFIG DATAFILEVARLOADMODE BYPOSITION TEMPFILEPATH usr tmp LAYOUTCONFIG USERELATIVEPATHS TRUE FNAMEFILTER INPUTDATAFILE pd la t COLORMAPFILE clr FONTADJUST Syntax FONTADJUST optional parameters Description A SetValue command that sets character spacing and sizing for fonts in Tecplot These parameters are rarely changed Optional Parameters Parameter Syntax Notes INTERCHARSPACING lt op gt lt integer gt Increase or decrease intercharacter spacing Units are in pixels on the screen SUBSUPFRACTION lt op gt lt double gt Size of subscript
183. gt VIEWWIDTH lt op gt lt dexp gt VIEWERPOSITION lt lt xyz gt gt Example This example does the following e Switches to perspective e Changes the field of view e Rotates around psi by 20 degrees e Changes the viewer position THREEDVIEW DRAWNINPERSPECTIVE YES FIELDOFVIEW 100 PSIANGLE 20 183 Chapter 5 Macro Commands VIEWERPOSITION X 1 26 Y 1 25 Z 0 74 TRANSFORMCOORDINATES Syntax TRANSFORMCOORDINATES TRANSFORMATION lt transformation gt optional parameters Description Transforms all points in one or more zones from one coordinate system to another Required Parameter Parameters Syntax Notes TRANSFORMATION Transformation lt transformation gt Optional Parameters Parameter Syntax Default Notes CREATENEWVARIABLES FALSE If TRUE then new variables X Y Z will be created if con lt boolean gt verting to rectangular coordinates or R THETA PHI if converting to spherical If FALSE then you must specify the output variables THETAVAR lt integer gt NONE Theta variable number REQUIRED if the transformation is polar to rectangular or spherical to rectangular or if CREATENEWVARIABLES is FALSE RVAR lt integer gt R variable number REQUIRED if the transformation is polar to rectangular or spherical to rectangular or if CREATENEWVARIABLES is FALSE 184 Par
184. he axis dependency is not independent then this action may also affect the range on another axis Optional Parameters Parameters Syntax Default Notes AXIS lt xyaxis gt Lp Default is T for polar plot type AXISNUM lt integer gt 1 Only XY frame mode allows for this to be a number greater than 1 Example Reset the range on the Y axis to fit the data being plotted with nice values on the axis line VIEW AXISNICEFIT AXIS Y VIEW CENTER Syntax VIEW CENTER no parameters Description Center the data within the axis grid area Example VIEW CENTER 190 Syntax Description Example Syntax Description Example Syntax Description Example VIEW COPY S IVIEW COPY no parameters Copy the current view to the view paste buffer See also VIEW PASTE S VIEW COPY VIEW DATAFIT S VIEW DATAFIT no parameters Fit the current set of data zones or line mappings being plotted within the grid area This does not take into consideration text or geometries VIEW DATAFIT VIEW FIT S VIEW FIT no parameters Fit the entire plot to the grid area This also takes into consideration text and geometries that are plotted using the grid coordinate system In 3 D this also includes the axes S VIEW FIT 191 Chapter 5 Macro Commands VIEW LAST Syntax Description Example S VIEW LAST no parameters
185. he number of polyline segments NumSegPts Array of integer values specifying the number of points in each of the NumSegments segments XGeomData Array of floating point values specifying the X coordinates YGeomData Array of floating point values specifying the Y coordinates ZGeomData Array of floating point values specifying the Z coordinate MFC Macro function command Must be null terminated TECINI100 Summary Initializes the process of writing a binary data file This must be called first before any other TECIO calls are made You may write to multiple files by calling TECINI100 more than once Each time TECINI100 is 272 Binary Data File Function Reference called a new file is opened Use TECFIL100 to switch between files FORTRAN Syntax INTEGER FUNCTION TECINI100 Title Variables FName ScratchDir Debug VIsDouble 2 PE MP KM CHARACTER Title CHARACTER Variables CHARACTER FName CHARACTER ScratchDir INTEGER 4 Debug INTEGER 4 VIsDouble C Syntax include TECIO h long TECINI100 char Title char Variables char FName char ScratchDir INTEGER4 Debug INTEGER4 VIsDouble Return Value o if successful 1 if unsuccessful Parameters Title Title of the data set Must be null terminated Variables List of variable names If a comma appears in the string it will be used as the separator between variable names otherwise a space is used Must be null term
186. hen call TECNOD100 if the data format is FEBLOCK or FEPOINT FORTRAN Syntax INTEGER FUNCTION TECZNE100 ZoneTitle PPP PP PP S amp P PM PM KM MK ZoneType IMxOrNumPts JMxOrNumElements KMx ICellMax JCellMax KCellMax IsBlock NumFaceConnections FaceNeighborMode ValueLocation Share VarFromZone ShareConnectivityFromZone CHARACTER ZoneTitle INTEGER 4 INTEGER 4 INTEGER 4 INTEGER 4 INTEGER 4 INTEGER 4 INTEGER 4 INTEGER 4 INTEGER 4 INTEGER 4 INTEGER 4 INTEGER 4 INTEGER 4 INTEGER 4 INTEGER 4 C Syntax include TECIO ZoneType IMxOrNumPts JMxOrNumElements KMx ICellMax JCellMax KCellMax N M IsBlock NumFaceConnections FaceNeighborMode ValueLocation Share VarFromZone ShareConnectivityFromZone h long TECZNE100 char ZoneTitle 281 Chapter 11 Writing Binary Data for Loading into Tecplot INTEGER4 ZoneType INTEGER4 MxOrNumPts INTEGER4 MxOrNumElements INTEGER4 KMx INTEGER4 CellMax INTEGER4 J CellMax INTEGER4 KCellMax INTEGER4 JsBlock INTEGER4 NumFaceConnections INTEGER4 FaceNeighborMode INTEGER4 ValueLoaction INTEGER4 ShareVarFromZone INTEGER4 ShareConnectivityFromZone Return Value o if successful 1 if unsuccessful Parameters ZoncTitle The title of the zone Must be null terminated ZoneT ype The type of the zone 0 ORDERED FELINESEG 2 FETRIANGLE 3 FEQUADRILA TERAL 4 FETETRAHEDRON 5 FEBRICK IMxOr
187. here the DEFAULT COEFF environment variable was set to some specified value of type double before starting Tecplot 8 2 2 Example 2 To create a string from an environment variable VARSET AUTHOR Author LOGNAME 8 3 User Defined Variables User defined variables are written using the macro variable name surrounded by vertical bars 1 The variable name can be up to 32 characters in length If a macro variable is defined using the VARSET command and it is named the same as an existing internal macro variable then the user defined variable takes precedence and the internal value is not effected The internal macro variable can be recovered if you remove the user defined vari able using REMOVEVAR 8 4 Assigning Values to Macro Variables The VARSET command is used to assign a value to a macro variable The VARSET command has the following syntax VARSET lt macrovar gt lt op gt lt double gt 246 Assigning a String to a Macro Variable where lt op gt can be one of or Examples Example 1 Add 2 to the macro variable ABC VARSET ABC 2 Example 2 Set ABC to be equal to 37 VARSET ABC 37 Example 3 Multiply ABC by 1 5 VARSET ABC 1 5 8 5 Assigning a String to a Macro Variable Macro variables can be assigned to strings as well as to values When using strings only the operator may be used Example Assign th
188. imated plots are saved Full plots are not saved This only has an effect if USEDISPLAYL ISTS is set to TRUE and if USEAP PROXIMATEPLOTS is TRUE 120 Parameter Syntax Notes INITIALDIALOGPLACEMENT COLORMAPDIALOG ANCHORALIGNMENT IOFFSET JOFFSET EQUATIONDIALOG ANCHORALIGNMENT IOFFSET JOFFSET MACROVIEWERDIALOG ANCHORALIGNMENT IOFFSET JOFFSET PROBEATDIALOG ANCHORALIGNMENT IOFFSET JOFFSET PROBEDIALOG ANCHORALIGNMENT IOFFSET JOFFSET QUICKEDITDIALOG ANCHORALIGNMENT IOFFSET JOFFSET QUICKMACROPANELDIALOG ANCHORALIGNMENT IOFFSET JOFFSET VALUEBLANKINGDIALOG ANCHORALIGNMENT IOFFSET JOFFSET ZONEMAPSTYLEDIALOG ANCHORALIGNMENT IOFFSET JOFFSET lt anchoralignment gt lt integer gt lt integer gt lt anchoralignment gt lt integer gt lt integer gt lt anchoralignment gt lt integer gt lt integer gt lt anchoralignment gt lt integer gt lt integer gt lt anchoralignment gt lt integer gt lt integer gt lt anchoralignment gt lt integer gt lt integer gt lt anchoralignment gt lt integer gt lt integer gt lt anchoralignment gt lt integer gt lt integer gt lt anchoralignment gt lt integer gt lt integer gt 121 Chapter 5 Macro Commands Parameter Syntax Notes DATA Settings for smoothing and interpola
189. inated 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 273 Chapter 11 Writing Binary Data for Loading into Tecplot Pointer to the integer flag for debugging Set to 0 for no debugging or 1 to debug VIsDouble Pointer to the integer flag for specifying whether field data generated in future calls to TECDAT are to be written in single or double precision Set to 0 for single precision or for double TECLAB100 Summary Write a set of custom labels to the data file FORTRAN Syntax INTEGER 4 FUNCTION TECLAB100 Labels CHARACTER Labels C Syntax include TECIO h INTEGER4 TECLAB100 char Labels Return Value o if successful 1 if unsuccessful Parameters Labels Character string of custom labels Separate labels by a comma or space For example a set of custom labels for each day of the weeks is Sun Mon Tue Wed Thu Fri Sat TECNOD100 Summary Writes an array of node data to the binary data file This is the connectivity list for finite element zones FORTRAN Syntax INTEGER 4 FUNCTION TECNOD100 NData INTEGER 4 NData T M 274 Binary Data File Function Reference C Syntax include TECIO h INTEGER4 TECNOD100 INTEGER4 NData Return Value o if successful 1 if unsuccessful Parameters NData Array of integers This is the connectivity list dimensioned T M T
190. ing gt no parameters Write the current color map to a file The lt string gt is the name of the file to write to WRITECOLORMAP mycolors map WRITECURVEINFO WRITECURVEINFO lt string gt SOURCEMAP lt integer gt optional parameters Write out the curve details or the calculated data points for the equation s used to draw the curve for a selected line mapping The lt string gt is the name of the file to write to 200 Required Parameter Parameter Syntax Notes SOURCEMAP lt integer gt This must be the number of an line mapping that does some type of curve fit or spline Optional Parameter Parameters Syntax Default Notes CURVEINFOMODE CURVE Use CURVE DETAILS or CURVEPOINTS lt curveinfomode gt DETAILS Example Write out the coefficients for XY line mapping number 3 to map3 out WRITECURVEINFO map3 out SOURCEMAP 3 CURVEINFOMODE CURVE DETAILS WRITEDATASET Syntax WRITEDATASET lt string gt optional parameters Description Write the data set attached to the current frame to a file The lt string gt is the name of the file to write to Optional Parameters Parameters Syntax Default Notes INCLUDETEXT lt boolean gt TRUE INCLUDEGEOM lt boolean gt TRUE INCLUDECUSTOMLABELS lt bool TRUE ean gt INCLUDEDATA lt boolean gt TRUE INCLUDEDATASHARELINKAGE FALSE INCLUDEAUTOGENFACENE
191. ion You must call EXPORTSTART prior to calling EXPORTNEXTFRAME This command is only valid for animation formats AVI and Raster Metafile You may use the EXPORTISRECORDING intrinsic variable to make sure that an animation sequence has been initiated EXPORTSETUP EXPORTFNAMES rotate avi EXPORTFORMAT AVI EXPORTSTART LOOP 5 ROTATE3DVIEW X ANGLE 5 EXPORTNEXTFRAME ENDLOOP EXPORTFINISH EXPORTSETUP EXPORTSETUP optional parameters A SetValue command that sets the attributes for exporting image files from Tecplot Exporting is usually intended as a means to transfer images from Tecplot to be imported by other applications See PRINTSETUP and PRINT for generating output intended for printers and plotters Optional Parameters Parameter Syntax Notes EXPORTFNAME lt string gt EXPORTFORMAT lt exportformat gt 77 Chapter 5 Macro Commands Parameter Syntax Notes GRAYSCALEDEPTH lt integer gt Valid values are 0 1 4 8 IMAGEWIDTH lt op gt lt integer gt SUNRASTERFORMAT lt sunrasterformat gt Only applies if EXPORTFORMAT is SUNRASTER BITDUMPREGION lt bitdumpregion gt EPSPREVIEWIMAGE IMAGETYPE lt epspreviewimagetype gt IMAGEWIDTH lt integer gt IMAGEHEIGHT lt integer gt GRAYSCALEDEPTH lt integer gt Valid values are 0 1 4 8 CONVERTTO256COLORS lt bool
192. irectory users john testrun7 runb VARSET BASEDIR users john testrun7 runb READDATASET basedir t1l plt basedir t2 plt 162 READSTYLESHEET Syntax READSTYLESHEET lt string gt optional parameters Description Read in a stylesheet file The lt string gt is the name of the file to read Optional Parameters Parameters Syntax Default Notes INCLUDETEXT lt boolean gt TRUE Set to TRUE to load in any text in the stylesheet file INCLUDEGEOM lt boolean gt TRUE Set to TRUE to load in any geometries in the stylesheet file INCLUDEPLOTSTYLE lt boolean gt TRUE Set to TRUE to process commands related to plot style mesh color vector type and so on INCLUDESTREAMPOSITIONS TRUE Set to TRUE to read in streamtrace starting posi lt boolean gt tions INCLUDEFRAMESIZEANDPOSITION FALSE Set to TRUE if you want the current frame to be lt boolean gt sized and positioned exactly like the frame used to create the stylesheet MERGE lt boolean gt FALSE Set to FALSE to reset all frame attributes back to their factory defaults prior to reading in the stylesheet INCLUDECONTOURLEVELS TRUE Set to TRUE to read in all contour levels lt boolean gt INCLUDEAUXDATA lt boolean gt TRUE Set to TRUE to read auxillary data Example Read the stylesheet file t sty Do not read in any text or geometries READSTYLESHEET t sty INCLUDETEXT
193. is 356 84 If in the above example you wanted to use exponential format you could use Pause Maximum contour value is MAXC 12 6e Here the result would be Maximum contour value is 3 568421e 02 249 Chapter 8 Macro Variables 250 CHAPTER 9 Raw Data Some macro commands contain a raw data section A raw data section is defined by using the keyword RAWDATA followed by the raw data values unique to the macro command Most raw data sections start with a single count value which represents the number of blocks of raw data followed by the blocks of raw data themselves The following table lists the raw data sections found in Tecplot macros Value Type s Raw Data Name per Block Notes lt addoncommandrawdata gt lt string gt Each line of the RAWDATA section contains an arbi trary text string The only requirement is that the char acter sequence a dollar sign followed by an exclamation mark cannot appear anywhere in the sec tion Comments can be inserted by using the octothorp If encountered everything to the right of the including the itself will be ignored lt colormaprawdata gt lt integer gt Red lt integer gt Green lt integer gt Blue lt contourlevelrawdata gt lt dexp gt Contour level lt geometryrawdata gt lt xyrawdata gt Each block contains a block of lt xyrawdata gt which Line segment geometry forms a si
194. ition of upper left corner of the frame in inches from left and top edge of the paper Example Place the current frame in the upper left corner of the paper offset 0 5 inches from the top and left edges make the frame dimensions 3 by 4 inches and turn off the frame border FRAMELAYOUT SHOWBORDER NO XYPOS X 0 5 Y 0 5 WIDTH 3 HEIGHT 4 91 Chapter 5 Macro Commands FRAMENAME Syntax FRAMENAME lt string gt no parameters Description Set the name for the current frame Example FRAMENAME Pressure Contours for well 33 FRAMESETUP Syntax FRAMESETUP optional parameters Description A SetValue command that sets parameters used to preset dynamic frame attributes when a frame is initialized Optional Parameters Parameter Syntax Notes ALIGNINGCONTOURLABELS lt boolean gt If TRUE the next interactively placed contour label is aligned to the contour line VECTMINLEN lt op gt lt dexp gt Minimum length in centimeters Vectors shorter than this length are not drawn VECTDEFLEN lt op gt lt dexp gt When a vector plot is drawn for the first time the vector magnitude is adjusted so the longest vector is VECTDEFLEN units long VECDEFLEN is in frame units INITIAL3DSCALE lt op gt lt dexp gt Initial scale for 3 D plots NUMSTREAMRAKEPOINTS lt op gt lt integer gt Number of points to place along streamtrace rakes Example Make the defaul
195. itting all into workspace view 197 get name 94 number of frames 244 order in stack 89 pop 88 positioning 90 push 90 setting dynamic attributes 92 setting global attributes 102 Frames with pick handles 197 FRAMETEXTSIZES 40 Functions arithmetic 237 binary data files 262 G Geometries copy to another frame 202 setting default attributes 65 Geometry attach command 34 attach to current frame 35 attaching to current frame 34 color 35 extracting data from 2D or 3D field plots 79 Geometry attributes 34 setting defaults 65 Geometry raw data 251 Geometry type 35 Global attributes 99 105 Global edit on picked objects 147 Graphics turn drawing on or off 71 Gray scale output 222 Grid precise dot 218 Grid area border 207 Grid area example 219 Grid coordinates 232 Grid lines 213 gridlinedetail subcommand 213 Group 83 l I Range 24 I J or K indices setting 214 If command 119 IJK index 214 ijk subcommand 214 IJK blanking 40 41 animation 27 IJK indices minimum maximum as variables 243 IJK planes animating 29 IMAGERENDERING 124 Including distance variables 79 80 Index ranges 214 setting 214 indexrange subcommand 214 Initial dialog placement 212 INITIAL3DSCALE 92 initialdialogplacement subcommand 212 INITIALPLOTFIRSTZONEONLY 122 INPUTDATAFILE 85 INPUTLAYOUTFILE 85 Insert another macro file 119 INTERCHARSPACING 87 Interface launching dialogs 130 set attributes 120 Internal macro variables 246 I
196. llowing hybrid approach 1 Run Tecplot and choose to record a macro to a file Perform tasks similar to those you are trying to capture in the final macro 2 Close the recording session and examine the macro file The commands generated by Tecplot should be fairly readable and easy to understand 3 Make minor modifications to the recorded macro Typical modifications involve adding loops adding variables or adding commands that for example prompt the user to enter a file name One of the main reasons for using the approach above is the large number of commands and permutations of parameters This manual provides an exhaustive listing of the available macro commands However it is often easier to have Tecplot perform the action and record the relevant command than look up individual commands and their required parameters An important feature of Tecplot s macro command language is its Viewer Debugger Often you will have a well developed macro that needs some modification You can use the Debugger to step through the macro to the point where you want the change to be made and Chapter 1 Introduction then start recording to a new file Using a text editor you can insert macro commands from a new file into an existing macro file cHapTeR2 Managing Macros Tecplot macros are stored in files These files are processed by loading them into Tecplot and running them 2 1 Macros vs Macro Functions vs Macro Comman
197. lotted If the axis dependency is not 188 independent then this action may also affect the range on another axis Optional Parameters Parameters Syntax Default Notes AXIS lt xyaxis gt xX Default is T for polar plot type AXISNUM lt integer gt 1 Only XY frame mode allows for this to be a number greater than 1 Example Reset the range on the Y axis to fit the data being plotted VIEW AXISFIT AXIS Y VIEW AXISMAKECURRENTAXISVALUESNICE Syntax VIEW AXISMAKECURRENTAXISVALUESNICE optional parameters Description Reset the axis line label values such that all currently displayed values are set to have the smallest number of significant digits possible Optional Parameters Parameters Syntax Default Notes AXIS lt xyaxis gt xX Default is T for polar plot type AXISNUM lt integer gt 1 Only XY line plots allow for this to be a number greater than 1 Example Set the range on the Z axis to have nice values for the axis labels VIEW AXISMAKECURRENTAXISVALUESNICE AXIS Z 189 Chapter 5 Macro Commands VIEW AXISNICEFIT Syntax VIEW AXISNICEFIT optional parameters Description Reset the range on a specific axis so that it equals the minimum and maximum of the data being plotted but makes the axis values nice by setting labels to have the smallest number of significant digits possible If t
198. lt boolean gt objects at this location IGNOREZONEOBJECTS FALSE If TRUE pick operations will ignore zones and pick objects such as slices iso surfaces and streamtraces Example Attempt to add to the list of picked objects by picking at paper location 1 0 7 0 Do not clear the list of picked objects before picking PICK AD X l D 0 143 Chapter 5 Macro Commands Y 7 0 COLLECTINGOBJECTS TRUE PICK ADDALL Syntax PICK ADDALL optional parameters Description Add all objects of a certain type to the list of picked objects Optional Parameters Parameters Syntax Default Notes SELECTTEXT lt boolean gt FALSE Select all text objects in the current frame SELECTGEOMS lt boolean gt FALSE Select all geometry objects in the current frame SELECTFRAMES lt boolean gt FALSE Select all frames SELECTSTREAMTRACES lt boolean gt FALSE Select all streamtrace objects in the current frame SELECTMAPS lt boolean gt FALSE Select all line map objects in the current frame SELECTZONES lt boolean gt FALSE Select all zone objects in the current frame Example Add all text and geometries in the current frame to the list of picked objects PICK ADDALL SELECTTEXT TRUE SELECTGEOMS TRUE PICK ADDALLINRECT Syntax PICK ADDALLINRECT X1 lt dexp gt Y1 lt dexp gt X2 lt dexp gt Y2 lt dexp gt optional parameters 144
199. lt dexp gt lt lt rgb gt gt lt lt rgb gt gt Use lt integer gt to specify which control point to modify Positions the control point 0 sets the position to the low est index and 1 to the highest index in the color map Example Change the lead RGB values for control point 2 in the small rainbow color map to be 100 0 0 210 COLORMAP SMRAINBOW CONTROLPOINT 2 LEADRGB wW Il 100 G 0 B 0 lt lt colormapoverride gt gt Description Change settings for a color map override Color map overrides are used to replace a specific band in a contour color map with one of the 16 basic colors Expands to Syntax Notes INCLUDE lt boolean gt COLOR lt color gt STARTLEVEL lt op gt lt integer gt ENDLEVEL lt op gt lt integer gt Example Set the color used between contour level number 1 to number 3 to be purple Use color map override number 3 GLOBALCONTOUR COLORMAPFILTER COLORMAPOVERRIDEACTIVE YES COLORMAPOVERRIDE 3 INCLUDE YES COLOR PURPLE 211 Chapter 6 Parameter Subcommands STARTLEVEL ENDLEVEL io w he lt lt continuouscolor gt gt Description Change settings for continuous color Expands to Syntax Notes CMIN lt boolean gt CMAX lt boolean gt Example Set the continuous color GLOBALCONTOUR VAR 4 FIELDLAYERS SHOWCONTOUR YES GLOBALCONTOUR
200. lt integer gt Example Set the I and J index skip for vectors to 2 for all zones FIELD VECTOR IJKSKIP I 2 J 2 lt lt indexrange gt gt Description Set an index range 214 Expands to Syntax Notes MIN lt op gt lt integer gt MAX lt op gt lt integer gt SKIP lt op gt lt integer gt Example Change the plot so the data set shows I planes 3 5 and 7 for zones to 3 FIELD 1 3 SURFACES SURFACESTOPLOT IPLANES IRANGE MIN 3 MAX 7 SKIP 2 lt lt numberformat gt gt Description Set the format used to draw a number 215 Chapter 6 Parameter Subcommands Expands to Syntax Notes FORMATTING lt valueformat gt CUSTOMLABEL lt integer gt PRECISION lt op gt lt integer gt SHOWDECIMALSONWHOLENUMBERS lt boolean gt Default FALSE REMOVELEADINGZEROS lt boolean gt Default FALSE SHOWNEGATIVESIGN lt boolean gt Default TRUE POSITIVEPREFIX lt string gt POSITIVESUFFIX lt string gt NEGATIVEPREFIX lt string gt NEGATIVESUFFIX lt string gt ZEROPREFIX lt string gt ZEROSUFFIX lt string gt a Example Set the number format for axis labels on the X axis in a 2 D field plot to use the float format with a precision of 3 and add the phrase DAYS WITHOUT RAIN after every positive value TWODAXIS XDETAIL TICKLABEL NUMFORMAT FORMATTING FIXEDFLOAT PREC
201. lt integer gt lt integer gt optional parameters Description Create a circular or cylindrical IJ or IJK ordered zone Required Parameters Parameter Syntax Notes IMax lt integer gt Radial direction JMax lt integer gt Circumferential direction must be greater than 3 O ptional Parameters Parameter Syntax Default Notes KMax lt integer gt 1 Bottom to top direction X lt dexp gt 0 X coordinate for center Y lt dexp gt 0 Y coordinate for center Z1 lt dexp gt 0 Z minimum if a cylinder is created Z2 lt dexp gt 1 Z maximum if a cylinder is created RADIUS lt dexp gt 1 DATATYPE lt datatype gt SINGLE Examples Example 1 Create a circular 10 by 20 IJ ordered zone centered at 5 5 with a radius of 2 CREATECIRCULARZONE IMax 10 JMax 20 x 5 Y 5 RADIUS 2 Example 2 Create a cylindrical 5 by 6 by 8 IJK ordered zone with the bottom 55 Chapter 5 Macro Commands centered at 4 4 0 and the top centered at 4 4 7 and a radius of 3 CREATECIRCULARZONE IMax 5 JMax KMax X Y Z1 Z2 RADIUS 3 No FP PO AH CREATECONTOURLINEZONES Syntax CREATECONTOURLINEZONES optional parameters Description Create zones from the currently defined contour lines One zone can be created from each contour level in that plot or one zone for every polyline can be generated
202. m value of current Theta axis range AXISMAXR Maximum value of current R axis range AXISMAXX Maximum value of current X axis range AXISMAXY Maximum value of current Y axis range AXISMAXZ Maximum value of current Z axis range AXISMINA Minimum value of current Theta axis range AXISMINR Minimum value of current R axis range AXISMINX Minimum value of current X axis range AXISMINY Minimum value of current Y axis range AXISMINZ Minimum value of current Z axis range BYTEORDERING Returns INTEL or MOTOROLA COLORMAPDYNAMIC Returns one if the color map is dynamic zero if static DATASETFNAME Returns data set file name DATASETTITLE The title of the data set or No Data Set if a dataset does not exist DATE Returns the date in the form of 31 Jan 1998 ENDSLICEPOS Position of end slice EXPORTISRECORDING Returns YES NO to help macros complete record commands in proper order FRAMENAME Returns the name of the current frame INBATCHMODE Returns one if Tecplot is in batch mode zero if in interactive mode ISDATASETAVAILABLE Returns 1 if a data set exists and 0 if otherwise ISOSURFACELEVEL Returns the current iso surface s iso value The intrinsic must use array notation meaning that IISOSURFACE 2 I returns the value for the second iso surface LAYOUTFNAME Returns the current layout file name 242 Internal Variables Variables Notes LOOP Innermost loop count
203. mands in the COLORMAPCONTROL compound function family are described separately in the following sections The COLORMAPCONTROL compound functions are COLORMAPCONTROL REDISTRIBUTECONTROLPOINTS COLORMAPCONTROL COPYSTANDARD COLORMAPCONTROL RESETTOFACTORY COLORMAPCONTROL REDISTRIBUTECONTROLPOINTS Syntax COLORMAPCONTROL REDISTRIBUTECONTROLPOINTS no parameters 45 Chapter 5 Macro Commands Description Example Syntax Description Redistribute the control points for the currently active color map so they are evenly spaced across the color map This is equivalent to clicking Redistribute Control Points in the Color Map dialog Note that this does not change the RGB values assigned at each control point COLORMAPCONTROL REDISTRIBUTECONTROLPOINTS COLORMAPCONTROL COPYSTANDARD COLORMAPCONTROL COPYSTANDARD CONTOURCOLORMAP lt standardcolormap gt Preset either the user defined color map or the raw user defined color map to be a copy of one of the standard color maps Tecplot must currently be using either the user defined color map or the raw user defined color map in order to use this function Required Parameter Parameter Syntax Notes CONTOURCOLORMAP lt standardcolormap gt The color map to copy Example Syntax Description The following example sets the current color map to be a copy of the small rainbow color map COLORMAPCONTROL COPYSTANDARD
204. meters Description Extract data from a 2 or 3 D field plot The locations at which to extract the data come from a polyline geometry that must be picked prior to issuing this command Optional Parameters Parameters Syntax Default Notes EXTRACTLINEPOINTSONLY FALSE If FALSE must include NUMPTS lt boolean gt INCLUDEDISTANCEVAR lt boolean gt FALSE If TRUE then Tecplot includes an extra variable in the result which is the distance along the line of points extracted and EXTRACTTOFILE must also be TRUE 79 Chapter 5 Macro Commands Parameters Syntax Default Notes NUMPTS lt integer gt Required if EXTRACTLINEPOINTSONLY is FALSE EXTRACTTOFILE lt boolean gt FALSE If FALSE a zone is created If TRUE must include FNAME FNAME lt string gt File name for extracted file Required if EXTRACTTOFILE is TRUE Example Extract 20 points from along the currently picked geometry Send the result to a file called extract dat EXTRACTFROMGEOM NUMPTS 20 EXTRACTTOFILE TRUE FNAME extract dat EXTRACTFROMPOLYLINE Syntax EXTRACTFROMPOLYLINE optional parameters lt xyzrawdata gt Description Extract data from a 2 or 3 D field plot The locations of where to extract the data from come from a supplied polyline in the form of lt xyzrawdata gt Optional Parameters Parameters Syntax Default Notes EXT
205. mited Maximum number of macro variables 400 256 PART II Binary Data 258 cHapTeR 11 Writing Binary Data for Loading into Tecplot This chapter is intended only for advanced users of Tecplot who have a solid background in UNIX or Windows and application programming Support for topics discussed in this chap ter may be limited Regular technical support is not intended to help you program your appli cation to use the direct data file capabilities of Tecplot Data files for Tecplot are commonly created as output from an application program These files are most often in ASCII format and are then converted to a binary format with Preplot Included with your distribution of Tecplot is a library that contains utility functions that you can link with your application program to create binary data files directly bypassing the use of ASCII files This allows for fewer files to manage conserves on disk space and saves the extra time required to convert the files In UNIX the utility functions discussed below are available in the library archive tecio a which is located in the 1ib sub directory of the Tecplot Home Directory Under Windows this library is called TecIO d11 and is located in the bin sub directory Instructions on 259 Chapter 11 Writing Binary Data for Loading into Tecplot compiling and linking using the TECTO library can be found in the readme doc file in the util tecio sub directory u
206. mmand that changes global attributes associated with 3 D plots Optional Parameters Parameter Syntax Notes PERFORMEXTRA3DSORTING lt boolean gt AXISBOXPADDING lt op gt lt dexp gt LINELIFTFRACTION lt op gt lt dexp gt SYMBOLLIFTFRACTION lt op gt lt dexp gt VECTORLIFTFRACTION lt op gt lt dexp gt 114 Parameter Syntax Notes SLICE ORIGIN lt lt xyz gt gt NORMAL lt lt xyz gt gt AXISSCALEFACT lt lt xyz gt gt The 3 D axis must be INDEPEN DENT for this option to work prop erly See THREEDAXIS ROTATEORIGIN lt lt xyz gt gt LIGHTSOURCE Always specify all three components here Tecplot normalizes X Y and Z XYZDIRECTION lt lt xyz gt gt after processing the Z component INTENSITY lt double gt X Y and Z represent a vector in the BACKGROUNDLIGHT lt double gt eye coordinate system SURFACECOLORCONTRAST lt double gt INCLUDESPECULAR lt boolean gt Default FALSE SPECULARINTENSITY lt integer gt Range 1 100 SPECULARSHININESS lt integer gt Range 1 100 FORCEGOURADFOR3DCONTFLOOD lt boolean gt Default TRUE FORCEPANELEDFOR3DCELLFLOOD lt boolean gt Default TRUE Example cLoBALTHREED ROTATEORIGIN X 4 36052333891 GLOBALTHREED LIGHTSOURCE XYZDIRECTION X 0 398226616447 Y 0 435028248588 Z 0 807567944438 GLOBALTHREED LIGHTSOURCE INTENSITY 80 GLOBALTHREED LIGHTSO
207. moving fastest where M is the number of elements in the zone and T is set according to the following list ELEMENT TYPE Line Segment Triangle Quadrilateral Tetrahedral Brick A A WN N TECTXT100 Summary Writes a text record to the data file FORTRAN Syntax INTEGER 4 FUNCTION TECTXT100 XOrThetaPos YOrRPos ZOrUnusedPos PosCoordMode AttachToZone Zone Font FontHeightUnits FontHeight BoxType BoxMargin BoxLineThickness BoxColor BoxFillColor Angle Anchor LineSpacing PPMP PPP PPP PM MM HM KH 275 Chapter 11 Writing Binary Data for Loading into Tecplot C Syntax TextColor Scope Clipping Text MFC 2PM PB KM DOUBLE PRECISION XOrThetaPos DOUBLE PRECISION YOrRPos DOUBLE PRECISION ZOruUnusedPos INTEGER 4 PosCoordMode INTEGER 4 AttachToZone INTEGER 4 Zone INTEGER 4 Font INTEGER 4 FontHeightUnits DOUBLE PRECISION FontHeight INTEGER 4 BoxType DOUBLE PRECISION BoxMargin DOUBLE PRECISION BoxLineThickness INTEGER 4 BoxColor INTEGER 4 BoxFillColor DOUBLE PRECISION Angle INTEGER 4 Anchor DOUBLE PRECISION LineSpacing INTEGER 4 TextColor INTEGER 4 Scope INTEGER 4 Clipping CHARACTER Text CHARACTER MFC include TECIO h INTEGER4 TECTXT100 double XOrThetaPos double YOrRPosPos double ZOruUnusedPos INTEGER4 PosCoordMode INTEGER4 AttachToZone INTEGER4 Zone INTEGER4 Font INTEGER4 FontHeightUnits double
208. mp BoxMargin amp BoxLineThickness amp BoxColor amp BoxFillColor amp TextAngle amp Anchor amp LineSpacing 315 Chapter 11 Writing Binary Data for Loading into Tecplot amp TextColor amp Scope amp Clipping Hi Mom uu Prepare to write out geometry record circle Circle is positioned at 25 25 in frame units and has a radius of 20 percent Circle is drawn using a dashed line XP 25 0 YP 25 0 ZP 0 0 IsFilled 0 Color 0 FillColor 7 GeomType 3 Circle LinePattern 1 Dashed LineThickness 0 3 PatternLength 1 5 NumE1llipsePts 23 ArrowheadStyle 0 ArrowheadAttachment 0 ArrowheadSize 0 0 ArrowheadAngle 15 0 NumSegments 1 NumSegPts 0 1 XGeomData 0 20 0 YGeomData 0 0 0 ZGeomData 0 0 0 III TECGEO100 amp xXP amp YP amp ZP amp PositionCoordSys amp AttachToZone amp Zone amp Color amp Fill1lColor amp IsFilled 316 Example Programs amp GeomType amp LinePattern amp PatternLength amp LineThickness amp NumEllipsePts amp ArrowheadStyle amp ArrowheadAttachment amp ArrowheadSize amp ArrowheadAngle amp Scope amp Clipping amp NumSegments NumSegPts amp XGeomData 0 amp YGeomData 0 amp ZGeomData 0 nu Close out file 1 I TECEND100 Close out file 2 TIT 23 I TECFIL100 amp III I TECEND100
209. nd to set the width and height for the custom1 paper Example 1 PAPER 10 PAPERSIZEINFO CUSTOM1 WIDTH 3 Example 2 PAPER PAPERSIZEINFO CUSTOM1 WIDTH 3 Example 3 paper papersizeinfo customl width 3 11 Chapter 3 Macro Command Syntax 12 cHaPTER4 Macro Command Summary This chapter presents a brief list of the major macro commands in Tecplot All major macro commands are preceded by dollar sign exclamation mark The macro commands fall into three basic categories e Control commands Control in the Type column deal with the flow of control within a Tecplot macro e Action commands Action in the Type column perform some type of visible action in Tecplot like rotating an object or redrawing a frame file input output or creating or destroying objects within Tecplot e SetValue commands FSV in the Type column refers to Frame SetValue commands GSV to General SetValue assign values to change the state of Tecplot Some values change the state of the current frame others are more general and are used to change the settings of the interface or hardcopy output from Tecplot SetValue commands are hierarchical in nature Command Description Type ACTIVEFIELDZONES Change the set of active zones FSV ACTIVELINEMAPS Change the set of active Line maps FSV ADDMACROPANELTITLE Add a title to the Quick Macro
210. nder the TECHOME directory Tecplot 10 introduces a new set of TECIO functions to take full advantage of the new capa bilities it offers Each of these functions has a suffix of 100 to differentiate it from previ ous editions Please note that all existing Version 9 TECIO functions still exist and are supported for backward compatibility 11 1 Function Summary The following functions are available from the TECTIO archive For historical reasons these functions have a FORTRAN flavor to them both in how they are named and the way in which the parameters are passed Tecplot Version 10 TECIO Functions TECINI100 Initialize the process of writing a binary data file TECZNE100 Write information about the next zone to be added to the data file TECDAT100 Write an array of data to the data file e TECNOD100 Write an array of node data to the data file e TECLAB100 Write a custom label record to the data file TECGEO100 Write a geometry record to the data file TECTXT100 Write a text record to the data file TECFIL100 Switch output context to a different file TECEND100 Close the data file TECUSR100 Write a character string to the data file in a USERREC record TECAUXSTR100 Write auxilary data for the data set to the data file e TECZAUXSTR100 Write auxilary data for the current zone to the data file TECFACE100 Write the face connections for the current zone to the data file Existing Tecplo
211. nes that are mirror images of the source zones Required Parameter Parameter Syntax Notes SOURCEZONES lt set gt Zone s to create mirror zone s from Optional Parameter Parameter Syntax Default Notes MIRRORVAR lt mirrorvar gt x This variable in the new zone is multiplied by 1 after the zone is copied Example Syntax Create a mirror of zones 2 4 across the Y axis that is mirror the X variable in 2D frame mode CREATEMIRRORZONES SOURCEZONES 2 4 MIRRORVAR xX CREATENEWFRAME CREATENEWFRAME optional parameters Description Creates a new frame 59 Chapter 5 Macro Commands Optional Parameters Parameter Syntax Default Notes XYPOS X lt dexp gt 1 0 X position inches relative to the left edge of the paper Y lt dexp gt 0 25 Y position inches relative to the top edge of the paper WIDTH lt dexp gt 9 Units are in inches HEIGHT lt dexp gt 8 Units are in inches Note The default position and size of the initial frame created when Tecplot starts up can be changed in the Tecplot configuration file Example Syntax Description The following example creates a 5 by 5 inch frame with the upper left hand corner of the frame positioned 2 inches from the left edge of the paper and 1 inch from the top CREATENEWFRAME XYPOS X 2 Y 1 WIDTH HEIGHT 5 i ul
212. nformation I TECINI100 DATASET WITH ONE ORDERED ZONE AND ONE FE QUAD ZONE ux Y P field plt n n n 7 amp Debug amp VIsDoub1e Open line plt and write the header information VIsDouble 1 I TECINI100 DATASET WITH ONE I ORDERED ZONE ny Y line plt non amp Debug amp VIsDouble Calculate values for the field variables for J for I X J I I 1 Y J I J 1 P J I I 1 J 1 0 J lt 5 J 0 I lt 4 I Make sure writing to file 1 III 1 I TECFIL100 amp III 311 Chapter 11 Writing Binary Data for Loading into Tecplot Write the zone header information for the ordered zone IMax 4 JMax 5 KMax 1 ICellMax 0 JCellMax 0 KCellMax 0 ZoneType 0 IsBlock 1 NumFaceConnections 0 FaceNeighborMode 0 ShareConnectivityFromZone 0 I TECZNE100 Ordered Zone amp ZoneType amp IMax amp JMax amp KMax amp ICellMax amp JCellMax amp KCellMax amp IsBlock amp NumFaceConnections amp FaceNeighborMode NULL ValueLocation NULL ShareVarFromZone amp ShareConnectivityFromZone Write out the field data for the ordered zone III IMax JMax I TECDAT100 amp III amp X 0 0 amp DIsDouble I TECDAT100 amp III amp Y 0 0 amp DIsDouble I TECDAT100 amp III amp P 0 0 amp DIsDouble Calculate values for
213. ng Formats in Macro Variables 249 Raw Data 251 Macro Language Limitations 255 Writing Binary Data for Loading into Tecplot 259 Function Summary 260 Binary Data File Function Calling Sequence 261 Writing to Multiple Binary Data Files 262 Character Strings in FORTRAN 262 Boolean Flags 262 Binary Data File Function Reference 262 Example Programs 299 Simple Example FORTRAN 299 Simple Example C 301 Complex Example FORTRAN 302 Complex Example C 310 iv Index 319 Contents PART Macro Command Language cHAPTER1 Introduction A Tecplot macro is a set of instructions called macro commands which perform actions in Tecplot Macro commands can be used to accomplish virtually any task that can be done via the Tecplot interface offering an easy way to automate Tecplot processes The only things you can do interactively that cannot be done with macro commands are those actions that have no effect on a final printed plot such as resizing the Tecplot process window To augment this ability there are macro commands which have no corresponding interactive control such as looping and conditional commands These commands typically go hand in hand with the execution of a macro You can create macros by recording them from the Tecplot interface using the Macro Recorder or create them from scratch using any ASCII text editor In most cases the most effective approach to creating a macro is the fo
214. ng zones out of currently defined streamtraces 63 Current frame attach text 37 attaching data 33 Curve details write to file 200 Curve equations writing 200 Cut delete picked objects 146 Cutaway views blanking 40 D DATA 122 Data adjust axes to fit 188 189 190 center in view 190 fit to axis grid area 191 read 161 rotating 167 241 smooth 176 Data alteration command 24 Data extraction 79 Data files function sequence 261 Data fit adjust view to fit data 191 Data labels 109 Data manipulation 24 polar to rectangular coordinates 153 Data set attach to frame command 33 naming 171 writing 201 Data set variable get value for macro variable 95 Data set variables set value from macro variable 171 Data sharing branching connectivity 42 branching variables 43 connectivity 173 283 field variables 173 283 get reference count 96 Data type 25 61 232 DATAFILEVARLOADMODE 85 Debugging macro files 6 Debugging macros 6 Default attributes frame style 172 geometry 65 line maps 255 325 Index text 66 zones 255 Defining macro functions 138 Delay Tecplot execution 67 Delete Line mappings 68 Delete picked objects 146 Deleting all contour levels 51 Deleting all currently defined contour labels 49 Deleting contour levels example 51 Deleting one or more zones 69 Deleting top frames 88 Derivative position 232 DERIVATIVEBOUNDARY 122 Destination map 72 zone 128 Dialog launching 130 Dialogs drop a Tecpl
215. ngle polyline within the geometry lt geometryrawdata gt lt xyzrawdata gt Each block contains a block of lt xyzrawdata gt which 3D Line segment forms a single polyline within the geometry lt geometryrawdata gt circle lt dexp gt Only one value supplied Value is the radius lt geometryrawdata gt ellipse lt dexp gt Two values supplied Values are RX and RY lt dexp gt lt geometryrawdata gt rectangle lt dexp gt Two values supplied Values are width and height lt dexp gt lt geometryrawdata gt square lt dexp gt Only one value supplied Value is the width 251 Chapter 9 Raw Data Value Type s Raw Data Name per Block Notes lt xyrawdata gt lt dexp gt lt dexp gt lt xyzrawdata gt lt dexp gt lt dexp gt lt dexp gt NKI KP a A count value does not precede the raw data in this case Examples Example 1 Example 2 Example 3 Example 4 Raw data for a circle with radius equal to 1 7 RAWDATA 1 7 Raw data for a line segment geometry with two segments Segment 1 has 4 points and segment 2 has 3 points RAWDATA WwW NNN oar N PRPRPWNPHPP AN x RoN WNE NPR own Raw data to define five contour levels RAWDATA uP WDNFE UI uwon nau Raw data to define three RGB values 252 RAWDATA 3 0 0 0 45 100 100 90 200 200 253 Chapter 9 Raw Data 2
216. nt IJK blankings in your plot The animation starts at one IJK blanking setting and marches through intermediate steps to a second setting To create an AVI or RM file add EXPORTSETUP commands before this command Required Parameter Parameter Syntax Notes NUMSTEPS lt integer gt Number of intermediate steps for the animation Optional Parameters Parameter Syntax Default Notes IMINFRACT lt dexp gt 0 1 Minimum fraction for blanking at the start of animation for the I index Actual I index is equal to IMINFRACT IMAX JMINFRACT lt dexp gt 0 1 Minimum fraction for blanking at the start of animation for the J index Actual J index is equal to JMINFRACT JMAX KMINFRACT lt dexp gt 0 1 Minimum fraction for blanking at the start of animation for the K index Actual K index is equal to KMINFRACT KMAX IMAXFRACT lt dexp gt 1 0 Maximum fraction for blanking at the start of animation for the I index Actual I index is equal to IMAXFRACT IMAX JMAXFRACT lt dexp gt 1 0 Maximum fraction for blanking at the start of animation for the J index Actual J index is equal to JMAXFRACT JMAX 27 Chapter 5 Macro Commands Parameter Syntax Default Notes KMAXFRACT lt dexp gt 1 0 Maximum fraction for blanking at the start of animation for the K index Actual K index is equal toKMAXFRACT KMAX IMINFRACT2 lt dexp gt 0 8 Minimum fraction for
217. nt frame Required Parameter Parameter Syntax Notes TEXT lt string gt Text string to draw Optional Parameters Parameter Syntax Default Notes ANCHORPOS lt lt anchorpos gt gt This assigns the anchor position for the text Units are dependent on POSITIONCOORDSYS POSITIONCOORDSYS lt coordsys gt FRAME CLIPPING lt clipping gt CLIPTO VIEWPORT ZONE lt integer gt 1 This is only used if ATTACHZONE TRUE This text is disabled if the zone assigned here is inactive ATTACHTOZONE lt boolean gt FALSE If TRUE must include ZONE COLOR lt color gt BLACK TEXTSHAPE The following combinations of SIZEUNITS and POSITIONCOORDSYS are allowed FONT lt font gt HELVBOLD FRAME FRAME POINT FRAME SIZEUNITS lt sizeunits gt POINT GRID GRID FRAME GRID HEIGHT lt dexp gt 14 BOX The margin is the space between the text and box The margin is measured in terms of the percentage BOXTYPE lt boxtype gt NONE of the text height LINETHICKNESS lt dexp gt 0 1 MARGIN lt dexp gt 20 COLOR lt color gt BLACK FILLCOLOR lt color gt WHITE ANGLE lt dexp gt 0 0 Text angle in degrees ANCHOR lt tfextanchor gt LEFT Specifies what part of the text to anchor to the frame LINESPACING lt dexp gt 1 0 Line spacing to use if text contains multiple lines 37 Chapter 5 Macro Commands Parameter Syntax Defaul
218. o the print spooler on your computer Use HPGL2MONOSPOOLCMD lt string gt the symbol as a place holder for where you nor HPGL2COLORSPOOLCMD lt string gt mally insert the name of the file to be printed HPGLSPOOLCMD lt string gt PSMONOSPOOLCMD lt string gt For security reasons these commands can only be used PSCOLORSPOOLCMD lt string gt in the Tecplot configuration file LGSPOOLCMD lt string gt PLOTTERPENMAP lt lt plotterpenmap gt gt Assign plotter pens to objects or colors See Section 21 3 2 5 Pen Plotter Configuration in the Tecplot User s Manual USEISOLATIN1FONTS Use extended ISO Latin1 fonts when generating Post INPS lt boolean gt Script output using Tecplot s internal PostScript driver FORCEEXTRA3DSORTING lt boolean gt 155 Chapter 5 Macro Commands Parameter Syntax Notes NUMLIGHTSOURCESHADES lt integer gt IMAGERESOLUTION lt integer gt PRINTRENDERTYPE lt printrendertype gt RGBLEGENDOUTPUTRESO lt integer gt Default 50 Determines the number of triangles LUTION which compose the bottom layer of the RGB Legend This option is only availble through macro language for example the config file Example This example does the following e Instruct Tecplot to send print output to the print spooler e Sets the spooler command for monochrome PostScript to be lpr e Sets the print driver to be monochrome PostScript PRI
219. of active zones For line plots the value is calculated from the zone assigned to the lowest numbered active line mapping MAXz Maximum value for variable assigned to the Z axis for the currently active zones MINA The minimum value for the Angle variable for polar line plots calcu late from the lowest numbered active polar line mapping MINB Minimum value for blanking variable For 2D or 3D Cartesian plots the value is calculated from the current set of active zones For line plots the value is calculated from the zone assigned to the lowest numbered active line mapping MINC Minimum value for contour variable For 2D or 3D Cartesian plots the value is calculated from the current set of active zones For line plots the value is calculated from the zone assigned to the lowest numbered active line mapping MINS Minimum value for scatter sizing variable for the currently active zones MINU Minimum value for variable assigned to the X vector component for the currently active zones MINV Minimum value for variable assigned to the Y vector component for the currently active zones MINVnn Minimum value of variable nn MINVAR Returns the minimum values of the specified variable It is indexed by array notation meaning that a call of IMINVAR 4 l gives the min imum value of the fourth variable MINW Minimum value for variable assigned to the Z ve
220. olean gt SHOWERRORBARS lt boolean gt Line mapping must have an error bar variable assigned for this to have an effect Example Turn on the symbols layer for Line plots LINEPLOTLAYERS SHOWSYMBOLS YES LINKING Syntax LINKING optional parameters 135 Chapter 5 Macro Commands Description Link attributes in two or more frames so that changes to attributes of one frame effect all linked frames Optional Parameters Parameter Syntax Notes WITHINFRAME LINKAXISSTYLE lt boolean gt LINKGRIDLINESTYLE lt boolean gt LINKLAYERLINECOLOR lt boolean gt LINKLAYERLINEPATTERN lt boolean gt BETWEENFRAMES LINKCONTOURLEVELS lt boolean gt LINKFRAMESIZEANDPOSITION lt boolean gt LINKXAXISRANGE lt boolean gt LINKYAXISRANGE lt boolean gt LINKPOLARVIEW lt boolean gt LINK3DVIEW lt boolean gt LINKGROUP lt sminteger_t gt LINKAXISPOSITION lt boolean gt LINKVALUEBLANKING lt boolean gt LINKSLICEPOSITIONS lt boolean gt LINKISOSURFACEVALUES lt boolean gt Example The following example will set the link attribute for all frames in the layout to LINK3DVIEW LOOP NUMFRAMES LINKING BETWEENFRAME LINK3DVIEW YES FRAMECONTROL PUSHTOP ENDLOOP LOADADDON Syntax LOADADDON lt string gt INITFUNCTION lt string gt ADDONSTYLE lt addonstyle gt 136 Description Load an add on into Tecplot
221. ollowing example attaches to the current frame the data set from the frame drawn next to last when doing a Redraw All ATTACHDATASET ATTACHGEOM Syntax ATTACHGEOM optional parameters lt geometryrawdata gt Description Attach a geometry to the current frame Required Parameter Parameter Syntax Notes lt geometryrawdata gt This is the data which defines the size and relative shape of the geometry This must be at the end of the command after any other parameters 34 Optional Parameters Parameter Syntax Default Notes POSITIONCOORDSYS lt coordsys gt GRID ANCHORPOS lt lt anchorpos gt gt This assigns the anchor position of the geometry ZONE lt integer gt 1 This is only used if ATTACHTOZONE TRUE This geometry is disabled if the zone assigned here is inactive ATTACHTOZONE lt boolean gt FALSE If TRUE must include ZONE COLOR lt color gt BLACK CLIPPING lt clipping gt CLIPTTO VIEWPORT FILLCOLOR lt color gt WHITE ISFILLED lt boolean gt GEOMTYPE lt geomtype gt LINESEGS LINEPATTERN lt linepattern gt SOLID PATTERNLENGTH lt dexp gt 2 Set the pattern length in Y frame units 0 100 LINETHICKNESS lt dexp gt 0 1 Set the line thickness in Y frame units 0 100 NUMELLIPSEPTS lt integer gt 72 Numbers of points to use when drawing ellipses and circles ARROWHEADSTYLE PLAIN lt ar
222. olor INTEGER4 sFilled INTEGER4 GeomType INTEGER4 LinePattern double PatternLength double LineThickness INTEGER4 NumEllipsePts INTEGER4 ArrowheadStyle INTEGER4 ArrowheadAttachment double ArrowheadSize double ArrowheadAngle INTEGER4 Scope INTEGER4 Clipping INTEGER4 NumSegments INTEGER4 NumSegPts float XGeomData float YGeomData float ZGeomData 269 Chapter 11 Writing Binary Data for Loading into Tecplot char MFC Return Value o if successful 1 if unsuccessful Parameters XPos Pointer to double value specifying the X position or for polar line plots the Theta position of the geometry YPos Pointer to double value specifying the Y position or for polar line plots the R position of the geometry ZPos Pointer to double value specifying the Z position of the geometry PosCoordMode Pointer to integer value specifying the position coordinate system 0 Grid 1 Frame AttachToZone Pointer to integer flag to signal that the geometry is attached to a zone Zone Pointer to integer value specifying the number of the zone to attach to Color Pointer to integer value specifying the color to assign to the geometry 0 Black 8 Custom1 1 Red 9 Custom2 2 Green 10 Custom3 3 Blue 11 Custom4 4 Cyan 12 Custom5 5 Yellow 13 Custom6 6 Purple 14 Custom7 7 White 15 Custom8 270 Binary Data File Function Reference FillColor Pointer to integer value specifying
223. on mapping objects CURVES CURVETYPE lt curvetype gt Only operates on XY line mapping objects SHOWBORDER lt boolean gt Only operates on frame objects Examples Example 1 Set all picked objects to use the color yellow PICK EDIT COLOR YELLOW Example 2 Set all picked objects to use the dashed line pattern PICK EDIT LINEPATTERN DASHED Example 3 Set all picked objects which are zones to use the contour plot type of flooding PICK EDIT CONTOUR CONTOURTYPE FLOOD 148 Syntax Description Example Syntax Description Example Syntax Description Example PICK MAGNIFY PICK MAGNIFY MAG lt dexp gt Magnify all picked objects The objects will also be translated proportional to the distance between their anchor position and the anchor position of the first object picked Magnify all objects by 1 5 PICK MAGNIFY MAG 1 5 PICK PASTE PICK PASTE no parameters Paste the currently picked objects from the paste buffer to the work area PICK PASTE PICK POP PICK POP no parameters Change the order in which objects are drawn by popping the currently picked objects to the front Only frames text geometries and the grid area for 2 D plots are allowed PICK POP 149 Chapter 5 Macro Commands Syntax Description Example Syntax Description PICK PUSH PICK PUSH no parameters Change the order in
224. one Required Parameters Parameter Syntax Notes ZONE lt integer gt VAR lt integer gt Example A data set contains 5 zones and 3 variables Zones 1 2 and 4 share variable 3 and zones 3 and 5 share variable three GETFIELDVALUEREFCOUNT ABC ZONE 2 VAR 3 This returns IABCI 3 while GETFIELDVALUEREFCOUNT DEF ZONE 5 VAR 3 returns IDEFI 2 because the variable is not shared across all five zones GETNODEINDEX Syntax GETNODEINDEX lt macrovar gt ZONE lt integer gt ELEMENT lt integer gt CORNER lt integer gt no optional parameters 96 Description This function only works for finite element zones Query for the node index in the specified location as described by the ZONE ELEMENT and CORNER parameters Required Parameter Parameter Syntax Notes ZONE lt integer gt Zone must be greater than or equal to one ELEMENT lt integer gt Must be greater than or equal to one and less than or equal to MAX CORNER lt integer gt Possible values are 1 3 1 4 or 1 8 depending upon the element type Example Get the index for the node at corner 3 of the last element in zone number 1 GETZONETYPE ZONETYPE ZONE 1 IF ZONETYPE ORDERED GETNODEINDEX INDEX ZONE 1 ELEMENT MAXJ CORNER 3 Do something with INDEX ENDIF GETVARLOCATION Syntax GETVARLOCATION lt macrovar gt
225. one Type Ordered Ordered Ordered Ordered Finite Element Finite Element Finite Element Finite Element Variable Location Nodal Nodal Cell Cen tered Cell Cen tered Nodal Nodal Cell Cen tered Cell Cen tered IsBlock 1 Number of Values Supplied IMax JMax KMax NumVars IMax JMax KMax NumVars IMax 1 JMax 1 KMax 1 NumVars Not allowed IMax i e NumPts NumVars IMax i e NumPts NumVars JMax i e NumElements NumVars Not allowed Order I varies fastest then J then K then V V varies fastest then I then J then K I varies fastest then J then K then V N varies fastest then V V varies fastest then N E varies fastest then V Note that if any variables are cell centered then the data must be supplied in block format thus the IsBlock parameter in TECZONE100 MUST be set to 1 TECDAT100 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 264 Binary Data File Function Reference to TECDAT100 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 TECINI100 FORTRAN Syntax INTEGER FUNCTION TECDAT100 N amp Data amp IsDouble INT
226. ory where you want Tecplot to store tem porary files FNAMEFILTER OUTPUTLAYOUTFILE lt string gt Default extension for saving linked layout files OUTPUTLAYOUTPACKAGEFILE lt string gt Default extension for saving layout package files INPUTDATAFILE lt string gt Default extension for Tecplot input data files OUTPUTASCIIDATAFILE lt string gt Default extension for ASCH output data files OUTPUTBINARYDATAFILE lt string gt Default extension for binary output data files INPUTLAYOUTFILE lt string gt Default extension for loading layout files STYLEFILE lt string gt Default extension for style files MACROFILE lt string gt Default extension for macro files EQUATIONFILE lt string gt Default extension for equation files COLORMAPFILE lt string gt Default extension for color map files IMPORTIMAGEFILE lt string gt Default extension for image files DOAUTOFNAMEEXTENSION lt boolean gt DOAUTOFNAMEEXTENSIONWARNING lt boolean gt If TRUE a warning is displayed when attempting to save with an extension other than the default extension File Name Filters Valid chracters are upper or lowercase A Z and 0 9 Each filter should be preceded by or it will not filter properly On Windows to allow more than one 85 Chapter 5 Macro Commands extension separate them with a semicolon On UNIX multiple extensions will not filter correctly unless they follow the standard UNIX shell filter
227. osition 89 Popping picked objects 149 Position text example 225 Positioning frames 89 90 Precise dot grid 218 precisegrid subcommand 218 Preferences 331 Index basic color 39 basic size 39 show coordinates 120 PREPLOTARGS 65 Presetting raw user defined color maps 46 Presetting user defined color maps 46 PRINTDEBUG 125 Printing attributes setup 154 to paper or file 154 Prompt commands 156 158 Push picked objects 150 placing a view on the view stack 193 Push frames 90 Push top frame to bottom 90 Q Query dialogs 157 Query functions 94 99 Quick Macro Panel 6 139 adding title 22 QUICKCOLORMODE 125 Quit command 160 R Range Parameters 24 25 Raster Metafile 78 Raw data 62 81 181 addoncommandrawdata 251 circle 252 color map 251 contour level 251 contour levels 252 geometry 251 line segment geometry 252 RGB values 252 section of macro commands 251 values 251 XY 252 XYZ 252 Raw User Defined color maps 210 RAWDATA example 252 253 Read data 161 rect subcommand 219 Rectangle 35 raw data 251 Rectangles 219 settings 219 Rectangular zones create 60 Redistributing control points 46 Redraw 163 Redraw All 164 Reference scatter sybols 220 Reference scatter symbol 109 attributes 220 refscatsymbol subcommand 220 Remove user defined macro variable 164 Removing blanked surfaces 57 58 Renaming variables 165 zones 165 rendconfig subcommand 220 Rendering with OpenGL 220 Reposition rot
228. ot dialog 71 Directories configuring 85 Display message 142 DOAUTOFNAMEEXTENSION 85 DOAUTOFNAMEEXTENSIONWARNING 85 Double 232 Double buffering compound functions 69 turning off 70 turning on 70 Double expression 232 Draw order Line mappings 174 sort level 114 183 Dropdown menus 209 Dropping Tecplot interface dialogs 71 Duplicate zones 72 Duplicating zones 73 E Edit global edit on picked objects 147 Ellipse 35 raw data 251 ENABLEDELAYS 122 ENABLEINTERRUPTS 122 ENABLEPAUSES 122 ENABLEWARNINGS 122 Encapsulated PostScript preview image 233 EndLoop command 137 Environment variables 245 EQUATIONFILE 85 Equations 24 Error bars plot types 233 Examples 2D axes attributes 153 187 3D axis attributes 183 activating field zones for plotting 21 adding Line maps 22 adding zones to the set of active zones 22 assigning attributes for field plots 83 assigning axes attributes 207 assigning control point for small rainbow color map 45 assigning plotter pens for hardcopy output 218 assigning the medium line pattern length 40 attributes applied to all frames 103 attributes for default geometry 66 attributes for exporting image files 78 axis grid area borders 207 axis gridlines settings 213 axis modes 176 axis tick mark attributes 227 axis tick mark labels 226 basic size values 210 circle raw data 252 color map control points 210 contour attributes 101 contour levels raw data 252 edit picked objects 140 148 FORTRAN program
229. owing example creates an animation showing plots of Line maps 2 4 6 8 and 10 ANIMATELINEMAPS START END SKIP 2 10 2 Syntax ANIMATESLICES START lt integer gt ANIMATESLICES 30 END lt integer gt optional parameters Description The macro command ANIMATESLICES uses the currently defined start and end slice position Use GLOBALSLICE to set these positions ANIMATESLICES then redefines how many intermediate slices are to be used then animates a sub set of those slices To create an AVI or RM file add EXPORTSETUP commands before this command Required Parameters Parameter Syntax Default Notes START lt integer gt Start and end indices are based on the set of slices generated by NUMSLICES All slices between start and end are animated There is no skipping To obtain the effect of skipping change the value for NUMSLICES lt integer gt Start and end indices are based on the set of slices generated by NUMSLICES All slices between start and end are animated There is no skipping To obtain the effect of skipping change the value for NUMSLICES NUMSLICES lt integer gt 2 Number of slices to distribute between the start and end slice locations as defined by POSITION1 and POSITION2 in GLOBALSLICE Optional Parameters Parameter Syntax Default Notes CREATEMOVIEFILE FALSE If TRUE must be preceded by lt boolean gt E
230. pe EXTRACTFROMGEOM Extract data from points along a polyline Action geometry EXTRACTFROMPOLYLINE Extract data from a supplied polyline Action FIELD Change the plot style settings for zones FSV FIELDLAYERS Change the active layers for field plots FSV FILECONFIG Change miscellaneous file path configuration GSV settings FONTADJUST Change intercharacter spacing subscript and GSV superscript sizing and so forth FRAMECONTROL Push pop or delete frames Action FRAMELAYOUT Change size position and so forth of the cur FSV rent frame FRAMENAME Change the frame name FSV FRAMESETUP Change miscellaneous default frame style set GSV tings GETAUXDATA Retrieve auxilary data from an object Action GETCONNECTIVITYREFCOUNT Get the number of zone shared with a zone Action GETCURFRAMENAME Get the name of the current frame Action 1GETFIELDVALUE Get the field value at a specified point index Action and assign it to lt macrovar gt GETFIELDVALUEREFCOUNT Get the count of how many places a variable is Action shared GETNODEINDEX Get the specified node index for finite element Action zones GETVARLOCATION Returns the variable locaction Node or Cell Action Centered GETVARNUMBYNAME Get the position of a variable Action GETZONETYPE Get the zone type of specified zone Action GLOBALCONTOUR Change global contour settings FSV GLOBALFRAME Change misc
231. pos gt 232 lt dexp gt 232 lt double gt 232 lt drift gt 232 lt epspreviewimagetype gt 233 lt errorbartype gt 233 lt exportformat gt 233 lt expression gt 233 lt standardcolormap gt 235 lt stipplemode gt 235 243 Numerics 2D axes setting attributes 186 2D field plots 49 2D vector plots setting global attributes 117 3D axes attributes settings 182 resetting 166 3D plots setting global attributes 114 183 3D resetting axes 166 rotation origin 166 scale factors 166 3D vector plot attributes 116 A Action commands 21 Active zones 22 Adding contour labels to your plot 47 48 Adding contour levels example 50 Adding titles to Quick Macro Panel 22 Add on commands send to add on 23 Add on loading 136 Add on style 231 Adjust view to fit data 191 ALIGNINGCONTOURLABELS 92 ALLOWDATAPOINTSELECT 120 ALLOWHWACCELERATION 124 Altering data command 24 Anchor 205 Anchor text 37 anchorpos subcommand 205 Angle 322 rotate 3D 114 168 183 Angle text 37 Animate commands 26 33 Animating contour levels 26 frames 30 IJK planes 29 IJK blanking 27 line mappings 30 stream markers 32 streamtraces 32 zones 33 Animating IJK blanking 27 APPROXIMATIONMODE 120 Area style 206 areastyle subcommand 206 Arithmetic functions 237 Arranging frames 89 90 Arrowhead angle 35 attachment 35 231 size 35 style 35 231 ARROWHEADSIZES 40 Assigning attributes axes 205 207 208 axis tick marks 226
232. pter 5 Macro Commands Syntax STREAMTRACE ADD optional parameters STREAMTRACE ADD Description Add a single streamtrace or a rake of streamtraces to the current frame The frame must be a 2 D or 3 D field plot Optional Parameters Parameters Syntax Default Notes NUMPTS lt integer gt 1 Use 1 to add a single streamtrace Use n n gt 1 for a rake of streamtraces STREAMTYPE lt streamtype gt a DIRECTION lt streamdirection gt FORWARD STARTPOS Z is necessary only if dealing with a 3 D streamtrace X lt dexp gt 0 0 Y lt dexp gt 0 0 Z lt dexp gt 0 0 ALTSTARTPOS This is required if NUMPTS is greater than 1 or if the streamtype is a volume rod or volume ribbon X lt dexp gt Y lt dexp gt Z lt dexp gt a Tecplot determines the default streamtype based on a number of factors It is best to always supply this parameter Example 1 Add a rake of 5 streamtraces in a 2 D field plot STREAMTRACE NUMPTS STREAMTYPE STARTPOS X 0 5 Y 0 5 ALTSTARTPOS ADD 5 TWODLINE 178 X Y Example 2 Add a single volume ribbon Start the ribbon oriented parallel to the Z axis ro uu STREAMTRACE ADD STREAMTYPE VOLUMERIBBON STARTPOS X 3 0 Y 4 0 Z 1 0 ALTSTARTPOS X 3 0 Y 4 0 Z 8 0 STREAMTRACE DELETEALL Syntax STREAMTRACE DELETEALL no parameters
233. r 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 TECINI FORTRAN Syntax C Syntax INTEGER FUNCTION TECDAT N amp Data amp IsDouble INTEGER 4 N REAL or DOUBLE PRECISION Data 1 INTEGER 4 I sDouble include TECIO h long TECDAT INTEGER4 N void Data INTEGER4 I sDouble 284 Binary Data File Function Reference Return Value o if successful 1 if unsuccessful Parameters N Pointer to an integer value specifying number of values to write Data Array of single or double precision data values IsDouble Pointer to the integer flag stating whether the array Data is single 0 or double 1 precision TECEND Summary Must be called to close out the current data file There must be a corresponding TECEND for each TECINI FORTRAN Syntax INTEGER 4 FUNCTION TECEND C Syntax include TECIO h INTEGER4 TECEND Return Value o if successful 1 if unsuccessful Parameters None TECFIL Summary Switch output context to a different file Each time TECINT is called a new file context is switched to This allows you to write multiple data files at the same time FORTRAN Syntax 285 Chapter 11 Writing Binary Data for Loading into Tecplot C Syntax incl INTEGER4 TECFIL INTEGER4 F Return Value o if successful
234. ra shading 229 attributes 229 zebrashade subcommand 229 Zone attributes assigning 81 Zone boundaries finite element data 56 for finite element data 57 Zone Group 83 Zones 35 245 activating 21 animate command 32 create 55 64 create by triangulation 185 create isozones command 58 create mirrors 59 create rectangular 60 creating new 61 default attributes 255 delete 69 duplicate 72 renaming 165 set active zones command 21 Zoom picked objects 149 Zooming view 195 workspace view 199 336
235. ransformation gt POLARTORECT SPHERICALTORECT RECTTOPOLAR RECTTOSPHERICAL lt translucency gt Valid integer from one to 99 lt twoddraworder gt BYZONE BYLAYER lt valueblankcellmode gt ALLCORNERS ANYCORNER PRIMARYCORNER lt valueblankrelop gt LESSTHANOREQUAL GREATERTHANOREQUAL NOTEQUALTO GREATERTHAN LESSTHAN EQUALTO lt valueformat gt INTEGER FLOAT EXPONENT BESTFLOAT RANGEBESTFLOAT SUPERSCRIPT CUSTOMLABEL lt valuelocation gt AUTO NODAL CELLCENTERED lt varloadmode gt BYNAME BYPOSITION lt vectortype gt TAILATPOINT HEADATPOINT MIDATPOINT HEADONLY lt viewmode gt FIT ZOOM DATAFIT AXISFIT SETMAGNIFICATION CENTER TRANSLATE LAST COPY PASTE PUSH lt workspaceviewmode gt FITSELECTEDFRAMES FITALLFRAMES FITPAPER MAXIMIZE LASTVIEW ZOOM TRANSLATE lt xyaxis gt x Y a Available in XY plots only The only difference in using single quotes vs double quotes for strings is that single quotes prevent the processing of the backslash character that is n inserts a newline inserts the backslash itself 236 Assignment Value Expressions 7 2 Assignment Value Expressions Simple values are literal constants such as 1 3 3 5 2 5e17 Complex expressions are identi fied by an equation surrounded by and delimiters Expressions can be used within any layout or
236. rawn SHADE SHOW lt boolean gt COLOR lt color gt USELIGHTINGEFFECT lt boolean gt BOUNDARY SHOW lt boolean gt IBOUNDARY lt boundarysetting gt Applies for IJ IK and IJK ordered zones JBOUNDARY lt boundarysetting gt Applies for IJ JK and IJK ordered zones KBOUNDARY lt boundarysetting gt Applies for IK JK and IJK ordered zones COLOR lt color gt LINETHICKNESS lt dexp gt SURFACEEFFECTS When reading in older layouts FLOOD TRANSLUCENCY is ignored if SHADE layer SURFACETRANSLUCENCY lt translucency gt is on for that zone otherwise it is converted to USETRANSLUCENCY lt boolean gt SURFACETRANSLUCENCY In a macro this LIGHTINGEFFECT lt lightingeffect gt is ignored SURFACETRANSLUCENCY range is one to 99 SURFACES VOLUMEMODE applies to volume zones with the exception that POINTSTOPLOT also SURFACESTOPLOT lt surfacestoplot gt applies to finite element surface zones IRANGE lt lt indexrange gt gt JRANGE lt lt indexrange gt gt KRANGE lt lt indexrange gt gt VOLUMEMODE VOLUMEOBJECTSTOPLOT lt lt volumeobjectstoplot gt gt GROUP lt integer gt Examples Example 1 Change the contour plot type to flood for zones 1 12 FIELD 1 12 CONTOUR CONTOURTYPE FLOOD 83 Chapter 5 Macro Commands Example 2 Change the mesh color to red for all zones 1 FIELD MESH COLOR RED FIELDLAYERS Syntax FIELDLAYERS
237. rdered zones that define boundaries across which no triangles can be created BOUNDARYZONES lt set gt Required if USEBOUNDARY is TRUE INCLUDEBOUNDARYPTS lt boolean gt FALSE Set to TRUE if you also want the boundary points to be used to create triangles TRIANGLEKEEPFACTOR lt dexp gt 0 25 Example Create a zone by triangulating data points from zones 1 and 2 TRIANGULATE SOURCEZONES 1 2 TWODAXIS Syntax TWODAXIS optional parameters Description A SetValue command that assigns attributes for axes in a 2 D frame Optional Parameters Parameter Syntax Notes DEPXTOYRATIO lt op gt lt dexp gt AXISMODE must be XYDEPENDENT to use this AXISMODE lt axismode gt Set to INDEPENDENT or XYDEPENDENT GRIDAREA lt lt gridarea gt gt XDETAIL lt lt axisdetail gt gt YDETAIL lt lt axisdetail gt gt PRECISEGRID lt lt precisegrid gt gt VIEWPORTTOPSNAPTARGET lt integer gt Default 100 VIEWPORTTOPSNAPTOLER lt integer gt Default 10 ANCE VIEWPORTPOSTITION lt lt rect gt gt 186 Parameter Syntax Notes VIEWPORTNICEFITBUFFER lt double gt AUTOADJUSTRANGES lt boolean gt TONICEVALUES PRESERVEAXISSCALEWHEN lt boolean gt RANGEISCHANGED Example Set the X axis to use variable 3 for a 2 D plot TWODAXIS XDETAIL VARNUM 3 VARSET Syntax VARSET lt macrov
238. reset time increments 180 set termination line 180 Streamtrace paths 32 Streamtraces animating as dashes or markers 32 create zones 64 deleting all 179 setting global attributes 112 Strings assigning 247 STROKEFONTLINETHICKNESS 87 STYLEFILE 85 Stylesheet read 163 writing to file 202 Stylesheets macro control commands 255 Subscript size 86 SUBSUPFRACTION 87 Superscript size 86 Surface Effects 83 Symbol shape 223 Symbol shapes setting 223 Symbols line plots 135 symbolshape subcommand 223 SYMBOLSIZES 40 Syntax example macros 240 System command instructions 181 System environment variables 245 T TECDAT binary data file function TECEND binary data file function TECFIL binary data file function TECGEO binary data file function TECHOME using as variable 245 TECINI binary data file function 290 TECLAB binary data file function TECNOD binary data file function Tecplot Interface 6 Tecplot interface set attributes 120 Tecplot macro 3 tecplot mcr 6 TECTXT binary data file function tecutil a 259 260 TECZNE binary data file function TEMPFILEPATH 85 260 260 261 260 261 260 261 260 272 260 261 260 261 260 261 260 Terminating execution of the Tecplot program 160 Text 224 angle 37 attach command 36 attach to zone 37 character height 225 color 37 copy to another frame 202 display 142 font 37 fonts 225 height 225 label box 224 label details 226 prompt for 157 setting defaults 66
239. ription Query Tecplot for the name of the current frame The lt macrovar gt represents the macro variable to receive the results Example Put the name of the current frame into the macro variable CFRAME GETCURFRAMENAME CFRAME 94 GETFIELDVALUE Syntax GETFIELDVALUE lt macrovar gt ZONE lt integer gt VAR lt integer gt INDEX lt integer gt Description Fetch the field value data set value at the specified point index and assign the value to lt macrovar gt If the zone referenced is IJ or IJK ordered then the point index is calculated by treating the 2 or 3 dimensional array as a 1 D array Required Parameters Parameter Syntax Notes ZONE lt integer gt VAR lt integer gt INDEX lt integer gt Example A data set contains 2 zones and 3 variables Zone 2 is dimensioned 5 by 3 Fetch the value from variable 3 at I J location 2 2 and store it in the macro variable ABC GETFIELDVALUE ABC ZONE 2 VAR 3 INDEX 7 Note INDEX was calculated using INDEX I J 1 MAXI K 1 MAXI MAXJ 5 2 1 2 7 95 Chapter 5 Macro Commands GETFIELDVALUEREFCOUNT Syntax GETFIELDVALUEREFCOUNT lt macrovar gt ZONE lt integer gt VAR lt integer gt no optional parameters Description Get the count of how zones many share the indicated variable with the specified zone Count includes the specified z
240. rowheadstyle gt ARROWHEADATTACHMENT NONE lt arrowheadattachment gt ARROWHEADSIZE lt dexp gt 5 Set the arrowhead size in Y frame units 0 100 ARROWHEADANGLE lt dexp gt 12 Set the angle for arrowheads in degrees SCOPE lt scope gt LOCAL Set the scope to GLOBAL to draw this geometry in all like frames MACROFUNCTIONCOMMAND Null Set the macro command to execute when you hover lt string gt over the geometry and press Ctrl right click For security reasons this command can only be used in the Tecplot configuration file DRAWORDER lt draworder gt AFTERDATA IMAGEFILENAME lt string gt MAINTAINASPECTRATIO lt bool TRUE ean gt RESIZEFILTER lt resizefilter gt TEXTURE Default CUBIC FILTER 35 Chapter 5 Macro Commands Examples Example 1 The following example creates a red circle with a radius equal to 25 percent of the height of the frame in the center of the frame ATTACHGEOM POSITIONCOORDSYS FRAME ANCHORPOS X 50 Y 50 GEOMTYPE CIRCLE COLOR RED RAWDATA 25 Example 2 The following example creates an L shaped polyline with an arrowhead at the end ATTACHGEOM POSITIONCOORDSYS FRAME ANCHORPOS X 20 Y 80 GEOMTYPE LINESEGS ARROWHEADATTACHMENT ATEND RAWDATA 1 3 00 0 60 40 0 ATTACHTEXT Syntax ATTACHTEXT TEXT lt string gt optional parameters Description Attach text to the curre
241. s assigned to lt macrovar gt Optional Parameter Parameter Syntax Default Notes INSTRUCTIONS lt string gt Null Include text at the top of the dialog to instruct the user regarding the value to enter In Windows this is limited to three lines of text 157 Chapter 5 Macro Commands Example pRoMPTFORTEXTSTRING timestring INSTRUCTIONS Enter the time of the experiment PROMPTFORYESNO Syntax PROMPTFORYESNO lt macrovar gt INSTRUCTIONS lt string gt Description Instruct Tecplot to launch a dialog containing two buttons one labeled Yes and the other No The lt macrovar gt is assigned the string Yes or No depending on the selection Optional Parameter Parameter Syntax Default Notes INSTRUCTIONS lt string gt Null Include text at the top of the dialog with instructions Example PROMPTFORYESNO goforit INSTRUCTIONS Do you want to go for it IF goforit YES code that goes for it l ENDIF PROPAGA TELINKING Syntax PROPAGATELINKING optional parameters Description Link multiple frames ether within frame or between frames 158 Optional Parameter Parameter Syntax Notes LINKTYPE WITHINFRAME or BETWEEN FRAMES FRAMECOLLECTION ALL or PICKED Example pRropAGATELINKING LINKTYPE BETWEENFRAMES FRAMECOLLECTION ALL PUBLISH Syntax PUBLISH lt string gt
242. s in specified region lt boolean gt COLORFILTER lt color gt Not used 2 Only objects of this color will be selected LINEPATTERNFILTER Not used 2 Only geometry objects with this line pattern will be lt linepattern gt selected FONTFILTER lt font gt Not used 2 Only text objects with this font will be selected GEOMFILTER lt geomtype gt Not used 4 Only geometry objects of this type will be selected Example a There is no default for this parameter If this parameter is omitted then the corresponding filter is not used Pick all circles using a dashed line pattern within the rectangle bounded by the points 0 0 and 3 5 145 Chapter 5 Macro Commands Syntax Description Example Syntax Description Example Syntax Description PICK ADDALLINRECT SELECTGEOMS TRUE LINEPATTERNFILTER DASHED GEOMFILTER CIRCLE X1 0 Y1 0 X2 3 Y2 5 PICK CLEAR PICK CLEAR no parameters Delete all objects that are currently picked These objects cannot be retrieved PICK CLEAR PICK COPY PICK COPY no parameters Copy all objects that are currently picked to the paste buffer PICK COPY PICK CUT PICK CUT no parameters Copy all objects that are currently picked to the paste buffer and then delete them 146 Example picx cur Syntax PICK EDIT parameters PICK EDIT Description Perform a glo
243. sclosure by the U S Government is subject to restrictions as set forth in subpara graphs a through d of the Commercial Computer Restricted Rights clause at FAR 52 227 19 when applicable or in subparagraph c 1 ii of the Rights in Technical Data and Computer Software clause at DFARS 252 227 7013 and or in similar or successor clauses in the DOD or NASA FAR Supplement Contractor manufacturer is Amtec Engineering Inc Post Office Box 3633 Bellevue WA 98009 3633 Contents Contents iii Macro Command Language 1 CHAPTER 1 CHAPTER 2 CHAPTER 3 CHAPTER 4 CHAPTER 5 CHAPTER 6 CHAPTER 7 Introduction 3 Managing Macros 5 Macros vs Macro Functions vs Macro Commands 5 Running Macros from the Command Line 5 Running Macros from the Tecplot Interface 6 Running Macros from the Quick Macro Panel 6 Macro Command Syntax 9 Macro Command Summary 13 Macro Commands 21 Parameter Subcommands 205 Parameter Assignment Values Expressions and Arithmetic and Logical Operators 231 Assignment Value Table 231 Assignment Value Expressions 237 iii Contents CHAPTER 8 CHAPTER 9 CHAPTER 10 Binary Data 257 CHAPTER 11 Macro Variables 241 Internal Variables 242 System Environment Variables 245 Example 1 246 Example 2 246 User Defined Variables 246 Assigning Values to Macro Variables 246 Assigning a String to a Macro Variable 247 Replacement Text Use 247 Macro Function Variables 248 Usi
244. t AUTOBRANCH lt boolean gt Affects shared variables only If true the specified zone will no longer share that variable with the other zones If false the variable will still be shared and the change to the variable will be shown for all zones where it is shared INDEX lt integer gt Example A data set contains 2 zones and 3 variables Zone 2 is dimensioned 5 by 3 Set the value for variable 3 at I J location 2 2 to be 37 5 SETFIELDVALUE ZONE 2 VAR S53 INDEX A FIELDVALUE 37 5 AUTOBRANCH TRUE Note that the INDEX value was calculated using INDEX I J 1 MAXI K 1 MAXI MAXJ 5 2 1 2 7 SETSTYLEBASE Syntax SETSTYLEBASE lt stylebase gt no parameters Description Instruct Tecplot on how to initialize frame style values when a new frame is created During normal operation Tecplot bases the style of a new frame on the factory defaults plus any changes assigned in the Tecplot 172 configuration file Layout files and stylesheet files however rely on Tecplot basing new frames only on the factory defaults This command is typically not used by the casual user Example Set the style base for frames to use the factory defaults SETSTYLEBASE FACTORY SHARECONNECTIVITY Syntax SHARECONNECTIVITY SOURCEZONE lt integer gt DESTINATIONZONE lt integer gt no optional parameters Description Share the nodemap between the source
245. t Notes SCOPE lt scope gt LOCAL Set the scope to GLOBAL to include this text in all like frames MACROFUNCTIONCOMMAND Null Set the macro command to execute when you lt string gt hover over the geometry and press Ctrl right click For security reasons this command can only be used in the Tecplot configuration file Examples Example 1 Example 2 Example 3 The following example creates the text ABC and positions it in the lower left corner of the frame ATTACHTEXT TEXT ABC The following example creates the text TEXT AT AN ANGLE and places it in the center of the frame The text is drawn at an angle of 45 degrees ATTACHTEXT TEXT TEXT AT AN ANGLE ANGLE 45 XYPOS xX 50 Y 50 The following example creates the text TIMES ROMAN using the Times Roman font This text includes a text box ATTACHTEXT TEXT TIMES ROMAN FONT TIMES BOX BOXTYPE MARGIN XYPOS X 20 Y 20 PLAIN 20 38 BASICCOLOR Syntax BASICCOLOR optional parameters Description A SetValue command that sets the red green and blue components for any of the basic colors in Tecplot Optional Parameters Parameter Syntax Notes BLACK lt lt rgb gt gt RED lt lt rgb gt gt GREEN lt lt rgb gt gt BLUE lt lt rgb gt gt CYAN lt lt rgb gt gt YELLOW lt lt rgb gt gt PURPLE lt lt rgb gt gt WHITE lt lt rgb gt gt CUS
246. t Preplot Framer and Amtec are registered trademarks or trademarks of Amtec Engineering Inc Encapsulated PostScript FrameMaker PageMaker PostScript Premier Adobe Systems Incorporated Ghostscript Aladdin Enterprises Linotronic Helvetica Times Allied Corporation LaserWriter Mac OS X Apple Computers Incorporated AutoCAD DXF Autodesk Incorporated Alpha DEC Digital Compaq Computer Corporation Elan License Manager is a trademark of Elan Computer Group Incorporated LaserJet HP GL HP GL 2 PaintJet Hewlett Packard Company X Designer Imperial Software Technology Builder Xcessory Integrated Computer Solutions Incorporated IBM RS6000 PC DOS International Business Machines Corporation Bookman ITC Corporation X Windows Massachusetts Institute of Technology MGI VideoWave MGI Software Corporation ActiveX Excel MS DOS Microsoft Visual Basic Visual C Visual J Visual Studio Windows Windows Metafile Microsoft Corporation HDF NCSA National Center for Supercomputing Appli cations UNIX OPEN LOOK Novell Incorporated Motif Open Software Foundation Incorporated Gridgen Pointwise Incorporated IRIS IRIX OpenGL Silicon Graphics Incorporated Open Win dows Solaris Sun Sun Raster Sun MicroSystems Incorporated All other product names mentioned herein are trademarks or registered trademarks of their respective owners NOTICE TO U S GOVERNMENT END USERS Use duplication or di
247. t TECIO Functions TECINTI Initialize the process of writing a binary data file TECZNE Write information about the next zone to be added to the data file TECDAT Write an array of data to the data file 260 Binary Data File Function Calling Sequence TECNOD Write an array of node data to the data file TECLAB Write a custom label record to the data file TECGEO Write a geometry record to the data file TECTXT Write a text record to the data file TECFIL Switch output context to a different file TECEND Close the data file 11 2 Binary Data File Function Calling Sequence Multiple data files can be written to at the same time For a given file the binary data file functions must be called in a specific order The correct order is as follows TECINI100 TECAUXSTR100 TECZNE100 One or more to create multiple zones TECDAT100 One or more to fill each zone TECNOD100 One for each finite element zone TECFACE100 One for each zone with face connections TECZAUXSTR100 TECLAB100 TECGEO100 TECTXT100 TECUSR100 TECEND Section 11 3 Writing to Multiple Binary Data Files explains how you can use the TECFIL100 function along with the above functions to write to multiple files at the same time The TECZNE100 TECLAB100 TECGEO100 TECAUXSTR100 and TECTXT100 func tions can be called anywhere between the TECINI100 and TECEND100 functions TECDAT100 and TECNOD100 for finite element dat
248. t boolean gt CONTOURTYPE lt contourtype gt Default FLOOD PRIMARYVALUE and AVERAGECELL not allowed FLOODCOLORING lt contourcoloring gt Default Group1 LINECONTOURGROUP lt sminteger gt COLOR lt color gt LINETHICKNESS lt double gt 103 Chapter 5 Macro Commands Parameter Syntax Notes SHADE SHOW lt boolean gt COLOR lt color gt USELIGHTINGEFFECT lt boolean gt SURFACEEFFECTS LIGHTINGEFFECT lt lightingeffect gt SURFACETRANSLUCENCY lt translucency gt USETRANSLUCENCY lt boolean gt DEFINITIONCONTOUR lt sminteger gt Contour group from which iso surfaces are GROUP based Default 1 MARCHINGCUBEALGORITHM classic or classicplus sExample GLOBALISOSURFACE ISOSURFACESELECTION ONESPECIFICVALUE ISOVALUE1 113 626812744 MESH SHOW YES MESH COLOR BLUE MESH LINETHICKNESS 0 4 CONTOUR SHOW YES SURFACEEFFECTS LIGHTINGEFFECT PANELED SURFACEEFFECTS SURFACETRANSLUCENCY 60 GLOBALLINEPLOT Syntax GLOBALLINEPLOT optional parameters Description A SetValue command that changes global attributes associated with Line plots 104 Optional Parameters Parameter Syntax Notes DATALABELS These are text values that can be added to a plot to show the indices or values for the data points SHOWNODELABELS lt boolean gt COLOR lt color gt INCLUDEBOX lt boolean gt NODELABELTYPE lt no
249. t length for the longest vector five percent FRAMESETUP VECTDEFLEN 5 92 GETAUXDATA Syntax GETAUXDATA lt macrovar gt AUXDATALOCATION zone dataset frame NAME lt string gt optional parameters Description Retrieve Auxiliary Data in the form of name value pairs and save it to the macrovariable Required Parameters Parameter Syntax Notes AUXDATALOCATION zone dataset frame NAME lt string gt Name of existing auxiliary data Optional Parameters Parameter Syntax Notes ZONE lt integer gt Only required if AUXDATALOCATION zone Example Get the Auxiliary Data from Zone 2 and store it in the macro variable ABC GETAUXDATA ABC AUXDATALOCATION zone NAME ABC Aux Data ZONE 2 GETCONNECTIVITYREFCOUNT Syntax GETCONNECTIVITYREFCOUNT lt macrovar gt 93 Chapter 5 Macro Commands ZONE lt integer gt no optional parameters Description Fetch the count of how many zones share connectivity with the specified zone Count includes specified zone Required Parameters Parameter Syntax Notes ZONE lt integer gt Example Fetch the connectivity count from Zone 2 and store it in the macro variable ABC If zones 2 5 and 6 share connectivity ABC 3 GETCONNECTIVITYREFCOUNT ABC ZONE 2 GETCURFRAMENAME Syntax GETCURFRAMENAME lt macrovar gt no parameters Desc
250. ters Description Pop a frame to the top make it the active frame Optional Parameter Parameter Syntax Default Notes FRAME lt integer gt 1 Frame to be popped Frames are numbered 1 to num frames with frame 1 drawn first when a Redraw All is executed and the highest numbered frame drawn last Example Pop frame number 2 FRAMECONTROL POP FRAME 2 88 Syntax FRAMECONTROL POPATPOSITION FRAMECONTROL POPATPOSITION X lt dexp gt Y lt dexp gt Description Pop the top most frame at a specified position on the paper Required Parameters Parameter Syntax Notes X lt dexp gt X is in inches from the left edge of the paper Y lt dexp gt Y is in inches from the top edge of the paper Example Pop the frame beneath the location 2 inches from the top edge of the paper and 3 inches from the left edge of the paper FRAMECONTROL POPATPOSITION X 3 Y 2 FRAMECONTROL POPBYNAME Syntax FRAMECONTROL POPBYNAME NAME lt string gt Description Pop the specified frame to the top of the view stack Example Syntax FRAMECONTROL POPBYNAME NAME BANANA FRAMECONTROL PUSH FRAMECONTROL PUSH optional parameters 89 Chapter 5 Macro Commands Description Push a frame to the bottom of the frame stack it is given the frame number 1 and therefore drawn first Optional Parameter Parameter Syntax Default Notes
251. tes to FALSE Examples of compound expressions used in the Tecplot macro language follow note that all compound expressions evaluate to a simple lt dexp gt value varSet value stress gt cutoff cutoff stress varSet value x lt 1 5 amp amp y lt 5 5 x 6 x y 3 2 varSet root b 2 gt 4 a c amp amp a gt 0 0 b sqrt b 2 4 a c 2 a 0 239 Chapter 7 Parameter Assignment Values Expressions and Arithmetic and Logical Operators It is important not to confuse an expression s relation lt relation gt that controls the evalua tion of a compound expression with the conditional expression lt conditionalexp gt that con trols the execution of control commands such as IF and WHILE For example the following is a valid macro command since it has a valid expression syntax and a valid control command syntax If a gt PI r 2 EndIf The following is also a valid macro command because like the last example it has a valid expression syntax and a valid control command syntax If a 2 b gt 5 1 0 EndIf The following is not a valid macro command since it has an invalid expression syntax and consequently an invalid control command syntax If a gt PI r 2 EndIf As with the invalid example above if Tecplot encounters a relation lt relation gt within an expression lt expression
252. th which variable I will be shared This reduces the amount of data to be passed via TECDAT100 A value of 0 indicates that the variable is not shared Pass null to indicate no variable sharing for this zone You must pass null for the first zone in a data set there is no data available to share ShareConnectivity From Zone For finite element zones only Indicates the zone number with which connectivity is shared Pass 0 to indicate no connectivity sharing You must pass 0 for the first zone in a data set 283 Chapter 11 Writing Binary Data for Loading into Tecplot The commands below are the old TECIO commands which still work for purposes of backwards compatibility Note that in many cases these functions take the same inputs as their Version 10 counterparts Summary TECDAT Writes an array of data to the data file If the ZoneFormat specified in TECZNE is BLOCK the array must be dimensioned JMax 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 TECDAT 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 numbe
253. the I ordered zone for I 0 I lt 50 I XL I I 1 YL I sin double I 1 20 0 312 Example Programs Switch to the line plt file file number 2 and write out the line plot data III 2 I TECFIL100 amp III Write the zone header information for the XY data IMax 50 JMax 1 KMax 1 I TECZNE100 XY Line plot amp ZoneType amp IMax amp JMax amp KMax amp ICellMax amp JCellMax amp KCellMax amp IsBlock amp NumFaceConnections amp FaceNeighborMode NULL ValueLocation NULL ShareVarFromZone amp ShareConnectivityFromZone Write out the line plot DIsDouble 1 III IMax I TECDAT100 amp III float amp XL 0 amp DIsDouble I TECDAT100 amp III float amp YL 0 amp DIsDouble Switch back to the field plot file and write out the finite element zone III 1 I TECFIL100 amp III Write the zone header information for the finite element zone ZoneType 3 FEQuad 313 Chapter 11 Writing Binary Data for Loading into Tecplot NPts 20 Number of points NElm 12 Number of elements KMax 0 Unused I TECZNE100 Finite Zone amp ZoneType amp NPts amp NE1m amp KMax amp ICellMax amp JCellMax amp KCellMax amp IsBlock amp NumFaceConnections amp FaceNeighborMode NULL ValueLocation
254. the color map settings GSV COLORMAPCONTROL Perform operations on the color map Action COMPATIBILITY Backward compatibility settings GSV CONTINUE Continue to end of current LOOP or Control WHILE CONTOURLABELS Add or delete contour labels Action CONTOURLEVELS Add delete or reset the contour levels Action CREATECIRCULARZONE Create a circular or cylindrical zone 2 Action or 3 D CREATECONTOURLINEZONES Create a zone or zones from contour lines Action CREATEFEBOUNDARY Create an FE boundary zone Action CREATEFESURFACEFROMIORDERED Create an FE surface from two or more I Action Ordered zones CREATEISOZONES Create iso surface zones Action CREATELINEMAP Create a Line mapping Action CREATEMIRRORZONES Create mirror image zones Action CREATENEWFRAME Create a new frame Action CREATERECTANGULARZONE Create a rectangular or cubical zone Action 14 Command Description Type CREATES IMPLEZONE Create a simple zone Action CREATESLICEZONEFROMPLANE Create a zone by slicing a volume zone Action CREATESLICEZONES Create a new zone for each slice defined on Action the Slice Details dialog CREATESTREAMZONES Create streamtrace zones Action DATASETUP Miscellaneous scratch data and Preplot setup GSV DEFAULTGEOM Change the default geometry settings GSV DEFAULTTEXT
255. the macro function NAME These commands are not executed when they are defined but are executed when a RUNMACROFUNCTION command is processed Parameters can be passed to a macro function Use n to reference the nth parameter See RUNMACROFUNCTION To use the KEYSTROKE option lt Crtl gt M must be pressed initially Required Parameter Parameter Syntax Notes NAME lt string gt Name of the macro function 138 Optional Parameter Parameter Syntax Default Notes RETAIN lt boolean gt FALSE Set this to TRUE if you want Tecplot to retain this macro function when the macro in which this macro function was defined terminates If the macro function is retained then it can be called when another macro is loaded at a later time SHOWINMACROPANEL TRUE Used only for macro functions within the tecplot mcr lt boolean gt file Set this to FALSE if you do not want Tecplot to include the macro function in Tecplot s Quick Macro Panel KEYSTROKE lt char gt Allows keyboard shortcuts Example Define a macro function that redraws the current frame n times when Syntax lt Crtl gt M is hit and then the R key is pressed where n is passed to the macro function MACROFUNCTION NAME ABC KEYSTROKE R LOOP n REDRAW ENDLOOP ENDMACROFUNCTION NEWLAYOUT NEWLAYOUT no parameters Description Clear the current layout and
256. the syntax would be I A Hi Mom char 0 11 5 Boolean Flags Integer parameters identified as flags indicate boolean values Pass 1 for true and 0 for false 11 6 Binary Data File Function Reference This section describes each of the TECIO functions in detail 262 Binary Data File Function Reference TECAUXSTR100 Summary Writes auxiliary data for the data set to the data file The function may be called any time between TECINI100 and TECEND100 Auxiliary data may be used by text macros equations if it is numeric and add ons It may be viewed directly in the AuxData page of the Data Set Information dialog FORTRAN Syntax INTEGER FUNCTION TECAUXSTR100 Name amp Value CHARACTER Name CHARACTER Value C Syntax include TECIO h long TECAUXSTR100 char Name char Value Return Value o if successful 1 if unsuccessful Parameters Name The name of the auxiliary data If this duplicates an existing name the value will overwrite the existing value Must be a null terminated character string Value The value to assign to the named auxiliary data Must be a null terminated character string TECDAT100 Summary Writes an array of data to the data file 263 Chapter 11 Writing Binary Data for Loading into Tecplot The following table describes the order the data must be supplied given different zone types IsBlock is a parameter supplied to TECZONE100 Z
257. tion Produce an animation that cycles through I J or K planes in an IJK ordered data set To create an AVI or RM file add EXPORTSETUP commands before this command Required Parameters Parameter Syntax Notes START lt integer gt Starting plane index END lt integer gt Ending plane index Optional Parameters Parameter Syntax Default Notes PLANES lt ijkplane gt I Specify I J or K SKIP lt integer gt 1 Index skip CREATEMOVIEFILE lt boolean gt FALSE If TRUE must be preceded by EXPORTSETUP commands Example The following example generates an animation of the I planes 1 3 5 7 and 9 ANIMATEIJKPLANES PLANES I START 1 END 9 SKIP 2 29 Chapter 5 Macro Commands Syntax ANIMATELINEMAPS START lt integer gt END lt integer gt optional parameters ANIMATELINEMAPS Description Produce an animation of one Line mapping at a time To create an AVI or RM file add EXPORTSETUP commands before this command Required Parameters Parameter Syntax Notes START lt integer gt Starting Line map number END lt integer gt Ending Line map number Optional Parameters Parameter Syntax Default Notes SKIP lt integer gt 1 Line map skip CREATEMOVIEFILE lt boolean gt FALSE If TRUE must be preceded by EXPORTSETUP commands Example The foll
258. tion The lt string gt references Example Syntax the name of the macro function to run If the macro requires parameters then include them within parentheses after the macro name Run macro function XYZ and pass the value 7 as the first parameter and the value 3 5 as the second parameter RUNMACROFUNCTION XYZ 7 3 5 Also see the example in Section 8 7 Macro Function Variables SA VELAYOUT SAVELAYOUT lt string gt optional parameters Description Save the current layout to a file You must supply the file name Optional Parameter Parameters Syntax Default Notes USERELATIVEPATHS lt boolean gt FALSE If TRUE all files referenced in the layout file will use relative paths INCLUDEDATA lt boolean gt FALSE If TRUE a layout package file will be created The extension lpk is recommended INCLUDEPREVIEW lt boolean gt TRUE Applies only if INCLUDEDATA is TRUE Example Save the current layout to a file called ex1 lay SAVELAYOUT exl lay 169 Chapter 5 Macro Commands SET3DEYEDISTANCE Syntax SET3DEYEDISTANCE EYEDISTANCE lt dexp gt Description Sets the distance from the viewer to the plane of the current center of rotation Example seT3pEYEDISTANCE EYEDISTANCE 13 5 SETAUXDATA Syntax I SETAUXDATA AUXDATALOCATION zone dataset frame NAME lt string gt VALUESTRING lt string gt optional parameters
259. ve problems with long strips Use MAXSTRIPLENGTH to reduce the strip length Turn ConstantlyUseScissoring on if you see lines extending outside the borders of the frame There is a slight performance pen alty when using this option If some shaded or contour flooded quads or tri angles do not appear or are black try turning this off As with USEQUADSTRIPS try turning off USEQUADSTRIPS before turning USETRI ANGLESTIPS off Turning off both options will result in reduced performance but may help fix errors caused by buggy graphics card drivers As with USEQUADSTRIPS try turning on TRIANGULATEFILLEDPOLYGONS if you are still experiencing problems even after turn ing off USETRIANGLESTRIPS and USE QUADSTRIPS Some graphics cards have problems with an OpenGL s g1ColorMaterial function Higher performance especially for continuous contour flooded plots can be achieved when it is used However it may need to be turned off if you are experiencing problems Example Force all line drawing to include the last point in the line Also make the size of the depth buffer to be at least 32 bits 221 Chapter 6 Parameter Subcommands INTERFACE OPENGLCONFIG SCREENRENDERING DOEXTRADRAWFORLASTPIXEL TRUE DEPTHBUFFERSIZE 32 lt lt rgb gt gt Description Set a color value by assigning values to its red green and blue components Expands to Syntax Notes R lt op gt
260. xp gt optional parameters Description Rotate field data in 2 D about any point Required Parameter Parameter Syntax Notes ANGLE lt dexp gt Specify angle of rotation in degrees Optional Parameters Parameter Syntax Default Notes ZONELIST lt set gt All zones Zones to rotate 167 Chapter 5 Macro Commands Parameter Syntax Default Notes X lt dexp gt 0 X origin to rotate about Y lt dexp gt 0 Y origin to rotate about Example Rotate zone 3 30 degrees about the point 7 2 ROTATE2DDATA ANGLE 30 ZONELIST 3 X 7 Y SZ ROTATE3DVIEW Syntax ROTATE3DVIEW lt rotateaxis gt ANGLE lt dexp gt optional parameters Description Do a 3 D rotation about a given axis The lt rotateaxis gt must be supplied Required Parameter Parameter Syntax Notes ANGLE lt dexp gt Angle to rotate in degrees Optional Parameter Parameter Syntax Notes ROTATEORIGINLOCATION lt rotateoriginlocation gt VECTORX lt dexp gt Required when rotate axis is ABOUTVECTOR VECTORY lt dexp gt Required when rotate axis is ABOUTVECTOR VECTORZ lt dexp gt Required when rotate axis is ABOUTVECTOR 168 Example Syntax ROTATE3DVIEW PSI ANGLE 10 RUNMACROFUNCTION RUNMACROFUNCTION lt string gt lt macroparameterlist gt Description Execute commands defined in a macro func
261. ype Pointer to integer value specifying the geometry type 0 2DLineSegments 3 Circle 1 Rectangle 4 Ellipse 2 Square 5 3DLineSegments LinePattern Pointer to integer value specifying the line pattern 0 Solid 3 Dotted 1 Dashed 4 LongDash 2 DashDot 5 DashDotDot PatternLength Pointer to double value specifying the pattern length in frame units LineThickness Pointer to double value specifying the line thickness in frame units NumEllipsePts Pointer to integer value specifying the number of points to use for circles and ellipses The value must be greater than 0 ArrowheadStyle Pointer to integer value specifying the arrowhead style 0 Plain 2 Hollow 1 Filled ArrowheadAttachment 289 Chapter 11 Writing Binary Data for Loading into Tecplot Pointer to integer value specifying where to attach arrowheads 0 None 2 End 1 Beginning 3 Both ArrowheadSize Pointer to double value specifying the arrowhead size in frame units ArrowheadAngle Pointer to double value specifying the arrowhead angle in degrees Scope Pointer to integer value specifying the scope O0 global 1 local NumSegments Pointer to integer value specifying the number of polyline segments NumSegPts Array of integer values specifying the number of points in each of the NumSegments segments XGeomData Array of floating point values specifying the X coordinates YGeomData Array of floating point values specifying the Y coordinates ZGeomD
262. ype of face connection specified by the FaceNeighborMode parameter to TECZNE100 FaceNeighbor Mode Values Data LocalOneToOne 3 cz fz cz LocalOneToMany nz 4 cz fz oz nz czZ1 cz2 czn GlobalOneToOne 4 cz fz ZZ CZ GlobalOneToMany 2 nz 4 cz fz oz nz ZZ1 CZ1 ZZ2 CZ2 ZZn CZn 266 Binary Data File Function Reference Where cz cell in current zone fz face of cell in current zone oz face obscuration flag only applies to one to many 0 face partially obscured 1 face entirely obscured nz number of cell or zone cell associations only applies to one to many ZZ remote Zone CZ cell in remote zone cz fz combinations must be unique Additionally Tecplot assumes that with the one to one face neighbor modes a supplied cell face is entirely obscured by its neighbor With one to many the obscuration flag must be supplied Faces that are not supplied with neighbors are run through Tecplot s auto face neighbor generator FE only TECFIL100 Summary Switch output context to a different file Each time TECINI100 is called a new file context is switched to This allows you to write multiple data files at the same time FORTRAN Syntax INTEGER FUNCTION TECFIL100 F INTEGER 4 F C Syntax include TECIO h INTEGER4 TECFIL100 INTEGER4 F Return Value o if successful 1 if unsuccessful 267 Chapter 11 Writing Binary Data for Loading into Tecplot

Tecplot Reference Manual

Contents

Download Pdf Manuals

Related Search

Related Contents